Filesystem permissions could elaborate on meaning of xdg- variables

[sudoshindo]

https://github.com/flatpak/flatpak-docs/blob/master/docs/sandbox-permissions-reference.rst#filesystem-permissions

I have a question.
Why does this document not specify the exact paths under Filesystem permissions?

I understand that there may be distros that are outliers that place these directories elsewhere.
But can't you specify the commonly used paths and just add a note that tells the user that obscure OSes may use different paths?

Don't assume everyone has read the xdg specification. It's more convenient if you don't make them look for a separate web page for this information.

[bbhtt]

What do you mean by exact paths? Which ones? The various xdg-foo-s are values the filesystem argument takes.

For example, --filesystem=xdg-desktop will make Flatpak use the path defined in XDG_DESKTOP_DIR first, if not fallback to $HOME/Desktop. You don't need to read anything for this.

[TingPing]

Don't assume everyone has read the xdg specification.

Distributing software for the freedesktop means the distributor should have a basic understanding of the XDG specs. That said I'm all for adding more convenient links and brief explanations for it when relevant.

[sudoshindo]

Distributing software for the freedesktop means the distributor should have a basic understanding of the XDG specs

End-users such as me may seek this information when overriding permissions on Flatpaks they install.

[TingPing]

That is fair. That page could expand on what those refer to.

[sudoshindo]

I was reading a script someone made before I used it on my system.
It had references to xdg-config and xdg-data.
The Flatpak command reference doesn't explicitly state these paths so I had to go through Reddit posts and search the messages of specific Discord servers to find the answer.

[hfiguiere]

https://specifications.freedesktop.org/basedir-spec/latest/ar01s02.html

[sudoshindo]

That is fair. That page could expand on what those refer to.

Yeah, just list the paths that major distros like Ubuntu and Fedora use. Then, add a note that says that these paths might not apply to every single distro under the sun.