Hello Thomas, On Tue, 19 May 2020 at 14:24, Thomas Piekarski <t.piekarski@xxxxxxxxxxxxxx> wrote: > > Hello Michael, > > > On 19.05.20 11:50 AM, Michael Kerrisk (man-pages) wrote: > > On 5/18/20 8:07 PM, Thomas Piekarski wrote: > >> Adding description of new directories (/run, /usr/libexec, > >> /usr/share/color,/usr/share/ppd, /var/lib/color), stating > >> /usr/X11R6 as obsolete and updating URL to and version of > >> FHS. > >> > >> See https://bugzilla.kernel.org/show_bug.cgi?id=206693 > >> > >> Reported-by: Gary Perkins <glperkins@xxxxxxx> > >> Signed-off-by: Thomas Piekarski <t.piekarski@xxxxxxxxxxxxxx> > > > > The patch looks good overall, though I have not checked the details > > in FHS 3.0. Are the changes in the patch the sum total of the > > differences between FHS 2.3 and 3.0? > > Yes, the patch contains the differences between FHS 2.3 and 3.0. > A few directories have been added and the directory /usr/X11R6 is not > listed anymore. Thanks for the clarification. > On second thought now I am not so sure about the way how this un-listing > of /usr/X11R6 is mentioned in the patch. > > At the moment it is 'obsolete since FHS 3.0', we could write 'dropped > since FHS 3.0' or 'not mentioned in FHS 3.0 anymore' instead. > > What do you think about such rephrasing? Or should it be just deleted > from the manual page? How have been such updates (where something in > documentation is silently not mentioned anymore) handled in the past? I think it would be sufficient to say something like "present in FHS 2.3, removed in FHS 3.0". Shall I make that change, or do you want to revise youe patch? Thanks, Michael > >> --- > >> > >> man7/hier.7 | 28 ++++++++++++++++++++++++---- > >> 1 file changed, 24 insertions(+), 4 deletions(-) > >> > >> diff --git a/man7/hier.7 b/man7/hier.7 > >> index dab9483d7..03fe61c71 100644 > >> --- a/man7/hier.7 > >> +++ b/man7/hier.7 > >> @@ -161,6 +161,12 @@ This pseudo-filesystem is described in more detail in > >> .I /root > >> This directory is usually the home directory for the root user (optional). > >> .TP > >> +.I /run > >> +This directory contains information which describes the system since it > >> was booted. > >> +Once this purpose was served by > >> +.IR /var/run > >> +and programs may continue to use it. > >> +.TP > >> .I /sbin > >> Like > >> .IR /bin , > >> @@ -186,7 +192,7 @@ It should hold only shareable, read-only data, so > >> that it can be mounted > >> by various machines running Linux. > >> .TP > >> .I /usr/X11R6 > >> -The X\-Window system, version 11 release 6 (optional). > >> +The X\-Window system, version 11 release 6 (obsolete since FHS 3.0). > >> .TP > >> .I /usr/X11R6/bin > >> Binaries which belong to the X\-Window system; often, there is a > >> @@ -296,6 +302,10 @@ which usually are not invoked directly. > >> More complicated programs may > >> have whole subdirectories there. > >> .TP > >> +.I /usr/libexec > >> +Directory contains binaries for internal use only and they are not meant > >> +to be executed directly by users shell or scripts. > >> +.TP > >> .I /usr/lib<qual> > >> These directories are variants of > >> .I /usr/lib > >> @@ -385,6 +395,10 @@ or > >> or > >> .IR /usr/man . > >> .TP > >> +.I /usr/share/color > >> +Contains color management information, like International Color > >> Consortium (ICC) > >> +Color profiles (optional). > >> +.TP > >> .I /usr/share/dict > >> Contains the word lists used by spell checkers (optional). > >> .TP > >> @@ -421,6 +435,9 @@ same OS. > >> .I /usr/share/nls > >> The message catalogs for native language support go here (optional). > >> .TP > >> +.I /usr/share/ppd > >> +Postscript Printer Definition (PPD) files (optional). > >> +.TP > >> .I /usr/share/sgml > >> Files for SGML (optional). > >> .TP > >> @@ -523,6 +540,9 @@ Variable game data (optional). > >> .I /var/lib > >> Variable state information for programs. > >> .TP > >> +.I /var/lib/color > >> +Variable files containing color management information (optional). > >> +.TP > >> .I /var/lib/hwclock > >> State directory for hwclock (optional). > >> .TP > >> @@ -635,11 +655,11 @@ this directory holds temporary files stored for an > >> unspecified duration. > >> Database files for NIS, > >> formerly known as the Sun Yellow Pages (YP). > >> .SH CONFORMING TO > >> -The Filesystem Hierarchy Standard, Version 2.3 > >> -.UR http://www.pathname.com\:/fhs/ > >> +The Filesystem Hierarchy Standard (FHS), Version 3.0, published March > >> 19, 2015 > >> +.UR https://refspecs.linuxfoundation.org/fhs.shtml > >> .UE . > >> .SH BUGS > >> -This list is not exhaustive; different systems may be configured > >> +This list is not exhaustive; different distributions and systems may be > >> configured > >> differently. > >> .SH SEE ALSO > >> .BR find (1), > -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/
