diff --git a/man/file-hierarchy.xml b/man/file-hierarchy.xml index 4b92d596cb..06f8fecf89 100644 --- a/man/file-hierarchy.xml +++ b/man/file-hierarchy.xml @@ -24,17 +24,21 @@ Description Operating systems using the - systemd1 system and service - manager are organized based on a file system hierarchy inspired by UNIX, more specifically the hierarchy described - in the File System Hierarchy - specification and hier7, with various - extensions, partially documented in the systemd1 system and + service manager are organized based on a file system hierarchy inspired by UNIX, more specifically the + hierarchy described in the File + System Hierarchy specification and hier7, with + various extensions, partially documented in the XDG Base Directory Specification and XDG User - Directories. This manual page describes a more generalized, though minimal and modernized subset of these - specifications that defines more strictly the suggestions and restrictions systemd makes on the file system - hierarchy. + Directories. This manual page describes a more generalized, though minimal and modernized subset + of these specifications that defines more strictly the suggestions and restrictions systemd makes on the + file system hierarchy. Note that this document makes no attempt to define the directory structure + comprehensively, it only documents a skeleton of a directory tree, that downstreams can extend. Because + of that traditional directories such as /usr/include/ or + /var/spool/ are not covered, even though it might (or might not) make a lot of sense + to include them in the structure of an actually deployed OS. Many of the paths described here can be queried with the