From: "Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com>
To: Thomas Piekarski <t.piekarski@deloquencia.de>
Cc: linux-man <linux-man@vger.kernel.org>, glperkins@lit.edu
Subject: Re: [PATCH] hier.7: Updating from FHS 2.3 to 3.0
Date: Tue, 19 May 2020 14:40:26 +0200 [thread overview]
Message-ID: <CAKgNAkhnRiowDQmjuqLrgHbgTbR-EkjokZLJPP-+7PrHtTDirA@mail.gmail.com> (raw)
In-Reply-To: <69e7cf2a-e0d3-bc1d-0bc7-81111cf80bbc@deloquencia.de>
Hello Thomas,
On Tue, 19 May 2020 at 14:24, Thomas Piekarski
<t.piekarski@deloquencia.de> 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@lit.edu>
> >> Signed-off-by: Thomas Piekarski <t.piekarski@deloquencia.de>
> >
> > 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/
next prev parent reply other threads:[~2020-05-19 12:40 UTC|newest]
Thread overview: 8+ messages / expand[flat|nested] mbox.gz Atom feed top
2020-05-18 18:07 [PATCH] hier.7: Updating from FHS 2.3 to 3.0 Thomas Piekarski
2020-05-19 9:50 ` Michael Kerrisk (man-pages)
2020-05-19 12:24 ` Thomas Piekarski
2020-05-19 12:40 ` Michael Kerrisk (man-pages) [this message]
2020-05-19 12:53 ` Thomas Piekarski
2020-05-19 12:55 ` Michael Kerrisk (man-pages)
2020-05-19 15:34 ` [PATCH-v2] " Thomas Piekarski
2020-05-19 19:51 ` Michael Kerrisk (man-pages)
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=CAKgNAkhnRiowDQmjuqLrgHbgTbR-EkjokZLJPP-+7PrHtTDirA@mail.gmail.com \
--to=mtk.manpages@gmail.com \
--cc=glperkins@lit.edu \
--cc=linux-man@vger.kernel.org \
--cc=t.piekarski@deloquencia.de \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).