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

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

[Thomas Piekarski]

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>

---

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),
-- 
2.20.1

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

[Michael Kerrisk (man-pages)]

Hi Thomas,

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?

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/

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

[Thomas Piekarski]

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.

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?


Thanks for your time and effort,
Thomas

>> ---
>>
>> 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),

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

[Michael Kerrisk (man-pages)]

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/

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

[Thomas Piekarski]

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@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?


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),

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

[Michael Kerrisk (man-pages)]

>>> 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.

Okay.

-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/

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

[Thomas Piekarski]

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@lit.edu>
Signed-off-by: Thomas Piekarski <t.piekarski@deloquencia.de>

---

  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

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

[Michael Kerrisk (man-pages)]

Hello Thomas,

On 5/19/20 5:34 PM, Thomas Piekarski wrote:
> 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@lit.edu>
> Signed-off-by: Thomas Piekarski <t.piekarski@deloquencia.de>
> 

Nice work! Patch applied.

I don't where you came from :-), but if you want to tackle 
something else in man-pages, I'm happy to get more input from you!

Cheers,

Michael

> ---
> 
>   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),
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/