Hello Michael
On 19.05.20 2:40 PM, Michael Kerrisk (man-pages) wrote:
On Tue, 19 May 2020 at 14:24, Thomas Piekarski wrote:
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?
That is a good idea.
Being new to the process I would like to revise, make the change and
update the patch.
---
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),
