From 2682ac2259a73def698ade603079cb43f3de9a0a Mon Sep 17 00:00:00 2001 From: Erwan Guyader <erwan.guyader@cozycloud.cc> Date: Tue, 25 Jul 2023 17:22:52 +0200 Subject: [PATCH] docs: Update supported usage tables (#2256) - macOS and Windows were streamlined to only the latest 2 versions - Linux distributions were streamlined to only the latest version of each distribution already present in the table --- doc/usage/linux.md | 57 +++++++++++++++++++++++--------------------- doc/usage/macos.md | 32 +++++++++++++++---------- doc/usage/windows.md | 23 +++++++++++------- 3 files changed, 64 insertions(+), 48 deletions(-) diff --git a/doc/usage/linux.md b/doc/usage/linux.md index e35bd0380..b0718504f 100644 --- a/doc/usage/linux.md +++ b/doc/usage/linux.md @@ -27,37 +27,39 @@ nightly builds for Debian and Ubuntu are already being tested internally). ## Supported distributions -The current AppImage needs a relatively recent version of `GLIBCXX >= 3.4.21`. - -| Distribution | supported | `GLIBCXX` | comment | -| ----------------------------------------- | --------- | --------- | --------------------- | -| **Archlinux (Gnome 3)** | **yes** | 3.4.24 | WORK with topicons | -| **Archlinux (Cinnamon)** | **yes** | 3.4.24 | WORK | -| **Archlinux (KDE PLASMA)** | **yes** | 3.4.24 | WORK | -| **Archlinux (Deepin)** | **yes** | 3.4.24 | WORK | -| Debian 9 (Stretch) | ? | 3.4.22 | **should work** | -| **Debian 10 (Buster)** | yes | 3.14.0 | with TopIcons-Plus | -| Fedora 30 | **yes** | 3.4.24 | with TopIcons-Plus | -| **Fedora 31** | **yes** | 3.4.27 | with TopIcons-Plus | -| Linux Mint 17.1 LTS (Rebecca) | no | | | -| Linux Mint 17.3 | no | 3.4.19 | | -| **Linux Mint 18.3 (Sylvia)** | **yes** | 3.4.2 | | -| **Linux Mint 18.3 (Sylvia) XFCE Edition** | **yes** | | | -| **Mageia 6 KDE Edition** | **yes** | | | -| **openSUSE Leap 15.0** | **yes** | 3.4.24 | | -| openSUSE Tumbleweed | **yes** | 3.4.25 | | -| Ubuntu 14.04 (Trusty Tahr) | no | 3.4.19 | | -| **Ubuntu 16.04 (Xenial Xerus)** | **yes** | 3.4.21 | some issues on Unity | -| **Ubuntu 17.10 (Artful Aardvark)** | **yes** | 3.4.24 | GNOME 3 | -| **Ubuntu 19.10 (Eoan Ermine)** | **yes** | 3.4.28 | | -| [Add your distribution][Edit] (see below) | ... | ... | | +A few things to know: +- The current AppImage needs a relatively recent versions of : + - `GLIBC >= 2.32` + - `GLIBCXX >= 3.4.21` +- The application should work with most desktop manager but is actively tested on Gnome 3 +- The systray icon might only show up on some desktop managers if you use a third-party software like the TopIcons-Plus Gnome extension or libappindicator; it is up to you to install the third-party software if needed + +We only support the latest version of each distribution although the app could work on older versions. The table below can be outdated. + +| Distribution | supported | comment | +| --- | --- | --- | +| Fedora 38 | yes | | +| Debian 12 (Bookworm) | yes | | +| Ubuntu 23.04 (Lunar Lobster) | yes | | +| Linux Mint 21.2 (Victoria) | yes | | +| Archlinux | yes | if up-to-date | +| Add your distribution (see below) | ... | | +| --- | --- | --- | +| Fedora 37 | no | should work | +| Debian 11 (Bullseye) | no | should work | +| Ubuntu 22.10 (Kinetic Kudu) | no | should work | +| Ubuntu 22.04 (Jammy Jellyfish) | no | should work after installing FUSE (`sudo apt install libfuse2`) | +| Linux Mint 21.1 (Vera) | no | should work | +| Mageia 8 | no | should work | +| openSUSE Leap 15.4 | no | should work | **Before** requesting for your distribution to be added to the list, please: - Include the exact name and version of your distribution -- Retrieve your *GLIBCXX* version by running the following command in a +- Retrieve your *GLIBC* and *GLIBCXX* versions by running the following commands in a terminal: - `strings $(locate -b '\libstdc++.so.6') | grep '^GLIBCXX_[0-9.]*$' | sort -V | tail -n 1` + - `strings $(locate -b '\libstdc++.so.6') | grep '^GLIBCXX_[0-9.]*$' | sort -V | tail -n 1` + - `strings $(locate -b '\libstdc++.so.6') | grep '^GLIBC_[0-9.]*$' | sort -V | tail -n 1` (and include the output in your request) - Install the app, run it and make sure it actually works @@ -145,7 +147,8 @@ effects so you need to do a right-click on the icon then select the > From 3.26 onwards, GNOME removed the systray which is the only interface for > *Cozy Drive*. It should be replaced in the future by `libcloudprovider`, which > we will implement when it spreads. In the meantime, you need to install an -> extension such as [TopIcons][TopIcons] or [TopIcons Plus][TopIconsPlus]. +> extension providing support for appindicator. You can find and install one +> from https://extensions.gnome.org/ by searching for `appindicator`. > **Note for i3wm Users** > diff --git a/doc/usage/macos.md b/doc/usage/macos.md index 1f37c02e3..cf13bb9b5 100644 --- a/doc/usage/macos.md +++ b/doc/usage/macos.md @@ -2,18 +2,26 @@ ## Supported versions -| macOS version | supported | comment | -| --- | --- | --- | -| 10.15 "Catalina" | yes | actively tested | -| 10.14 "Mojave" | yes | should work | -| 10.13 "High Sierra" | | should work | -| 10.12 "Sierra" | | should work | -| 10.11 "El Capitan" | | should work | -| 10.10 "Yosemite" | | should work | -| 10.9 "Mavericks" | no | | -| 10.8 "Mountain Lion" | no | | -| 10.7 "Lion" | no | | -| 10.6 "Snow Leopard" | no | | +We only support the latest 2 versions of macOS although the app could work on older versions. The table below can be outdated. + +**We do not support M1 and M2 processors natively yet but Cozy Desktop should work fine with the emulation.** + +| macOS version | supported | comment | +| --- | --- | --- | +| 13 "Ventura" | yes | | +| 12 "Monterey" | yes | | +| --- | --- | --- | +| 11 "Big Sur" | no | should work | +| 10.15 "Catalina" | no | end of life reached | +| 10.14 "Mojave" | no | end of life reached | +| 10.13 "High Sierra" | no | end of life reached | +| 10.12 "Sierra" | no | end of life reached | +| 10.11 "El Capitan" | no | end of life reached | +| 10.10 "Yosemite" | no | end of life reached | +| 10.9 "Mavericks" | no | end of life reached | +| 10.8 "Mountain Lion" | no | end of life reached | +| 10.7 "Lion" | no | end of life reached | +| 10.6 "Snow Leopard" | no | end of life reached | ## Slash (`/`) vs colon (`:`) on macOS diff --git a/doc/usage/windows.md b/doc/usage/windows.md index 9f5e785d3..57d0058ba 100644 --- a/doc/usage/windows.md +++ b/doc/usage/windows.md @@ -2,12 +2,17 @@ ## Supported versions -| Windows version | supported | comment | -| --- | --- | --- | -| Windows 10 (64 bits) | yes | actively tested | -| Windows 10 (32 bits) | | 32 bits achritecture is not supported anymore | -| Windows 8.1 | | should work | -| Windows 8 | | has security flaws, please upgrade to 8.1 | -| Windows 7 | | should work | -| Windows Vista | no | | -| Windows XP | no | | +We only support the latest 2 versions of Windows although the app could work on older versions. The table below can be outdated. + +| Windows version | supported | comment | +| --- | --- | --- | +| Windows 11 (64 bits) | yes | should work | +| Windows 10 (64 bits) | yes | actively tested | +| --- | --- | --- | +| Windows 10 (32 bits) | no | | +| --- | --- | --- | +| Windows 8.1 | no | end of life reached | +| Windows 8 | no | end of life reached | +| Windows 7 | no | end of life reached | +| Windows Vista | no | end of life reached | +| Windows XP | no | end of life reached |