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 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@xxxxxxx>
> Signed-off-by: Thomas Piekarski <t.piekarski@xxxxxxxxxxxxxx>
> 

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/



[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