diff options
| author | Lennart Poettering <lennart@poettering.net> | 2024-07-03 10:10:07 +0200 |
|---|---|---|
| committer | Lennart Poettering <lennart@poettering.net> | 2024-07-04 15:26:17 +0200 |
| commit | 39aafbd42ac3d9675098c8212261fa56261d9066 (patch) | |
| tree | 93f97120ba84f6b73af12c1b9a4a9d473c9d7d1a /man/file-hierarchy.xml | |
| parent | man: drop version info from file hiearchy man page (diff) | |
| download | systemd-39aafbd42ac3d9675098c8212261fa56261d9066.tar.xz systemd-39aafbd42ac3d9675098c8212261fa56261d9066.zip | |
man: mention that distinction between /usr/lib/ and /usr/share/ is really about shared *ownership*
Diffstat (limited to 'man/file-hierarchy.xml')
| -rw-r--r-- | man/file-hierarchy.xml | 19 |
1 files changed, 12 insertions, 7 deletions
diff --git a/man/file-hierarchy.xml b/man/file-hierarchy.xml index 6f3a5b8ce4..57ab3ee8da 100644 --- a/man/file-hierarchy.xml +++ b/man/file-hierarchy.xml @@ -212,7 +212,12 @@ <term><filename>/usr/share/</filename></term> <listitem><para>Resources shared between multiple packages, such as documentation, man pages, time zone information, fonts and other resources. Usually, the precise location and format of files stored - below this directory is subject to specifications that ensure interoperability.</para></listitem> + below this directory is subject to specifications that ensure interoperability.</para> + + <para>Note that resources placed in this directory typically are under shared ownership, + i.e. multiple different packages have provide and consume these resources, on equal footing, without + any obvious primary owner. This makes makes things systematically different from + <filename>/usr/lib/</filename>, where ownership is generally not shared.</para></listitem> </varlistentry> <varlistentry> @@ -618,9 +623,9 @@ </tgroup> </table> - <para>Additional static vendor files may be installed in the - <filename>/usr/share/</filename> hierarchy to the locations - defined by the various relevant specifications.</para> + <para>Additional static vendor files with shared ownership may be installed in the + <filename>/usr/share/</filename> hierarchy to the locations defined by the various relevant + specifications.</para> <para>The following directories shall be used by the package for local configuration and files created during runtime:</para> @@ -710,9 +715,9 @@ </tgroup> </table> - <para>Additional static vendor files may be installed in the <filename>~/.local/share/</filename> - hierarchy, mirroring the subdirectories specified in the section "Vendor-supplied operating system - resources" above.</para> + <para>Additional static vendor files with shared ownership may be installed in the + <filename>~/.local/share/</filename> hierarchy, mirroring the subdirectories specified in the section + "Vendor-supplied operating system resources" above.</para> <para>The following directories shall be used by the package for per-user local configuration and files created during runtime:</para> |