Re: [PATCH-v2] hier.7: Updating from FHS 2.3 to 3.0

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Hello Michael,


On 19.05.20 2:55 PM, Michael Kerrisk (man-pages) wrote:
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.

Okay.
Updated patch and description.


Adding description of new directories (/run, /usr/libexec,
/usr/share/color,/usr/share/ppd, /var/lib/color), stating
/usr/X11R6 as removed 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>

---

 man7/hier.7 | 29 +++++++++++++++++++++++++----
 1 file changed, 25 insertions(+), 4 deletions(-)

diff --git a/man7/hier.7 b/man7/hier.7
index dab9483d7..44c3139f5 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,8 @@ 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 (present in FHS 2.3, removed
+in FHS 3.0).
 .TP
 .I /usr/X11R6/bin
 Binaries which belong to the X\-Window system; often, there is a
@@ -296,6 +303,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 +396,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 +436,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 +541,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 +656,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),
--
2.20.1




[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux