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 |