man: mention that distinction between /usr/lib/ and /usr/share/ is really about share...

diff --git a/man/file-hierarchy.xml b/man/file-hierarchy.xml
index 6f3a5b8ce4fead87366145835c63783b951309de..57ab3ee8da5cd1517bed3851b59ac65b7de0e4b3 100644 (file)
--- 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>