Skip to content

Commit

Permalink
docs: Update supported usage tables (#2256)
Browse files Browse the repository at this point in the history 
- 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
  • Loading branch information
@taratatach
taratatach authored Jul 25, 2023
1 parent eb1d431 commit 2682ac2
Show file tree
Hide file tree
Showing 3 changed files with 64 additions and 48 deletions.
57 changes: 30 additions & 27 deletions doc/usage/linux.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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**
>
Expand Down
32 changes: 20 additions & 12 deletions doc/usage/macos.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
23 changes: 14 additions & 9 deletions doc/usage/windows.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -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 |

0 comments on commit 2682ac2

Please sign in to comment.