Linux-man Archive on lore.kernel.org
 help / color / Atom feed
From: Thomas Piekarski <t.piekarski@deloquencia.de>
To: "Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com>
Cc: linux-man <linux-man@vger.kernel.org>, glperkins@lit.edu
Subject: Re: [PATCH-v2] hier.7: Updating from FHS 2.3 to 3.0
Date: Tue, 19 May 2020 17:34:33 +0200
Message-ID: <c1c52c68-5fa1-246f-06c6-2bbe647c65ca@deloquencia.de> (raw)
In-Reply-To: <99ae2d82-e5a5-6511-a324-ee59da9642b3@gmail.com>

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


  reply index

Thread overview: 8+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2020-05-18 18:07 [PATCH] " 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)
2020-05-19 12:53       ` Thomas Piekarski
2020-05-19 12:55         ` Michael Kerrisk (man-pages)
2020-05-19 15:34           ` Thomas Piekarski [this message]
2020-05-19 19:51             ` [PATCH-v2] " 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=c1c52c68-5fa1-246f-06c6-2bbe647c65ca@deloquencia.de \
    --to=t.piekarski@deloquencia.de \
    --cc=glperkins@lit.edu \
    --cc=linux-man@vger.kernel.org \
    --cc=mtk.manpages@gmail.com \
    /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

Linux-man Archive on lore.kernel.org

Archives are clonable:
	git clone --mirror https://lore.kernel.org/linux-man/0 linux-man/git/0.git

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V2 linux-man linux-man/ https://lore.kernel.org/linux-man \
		linux-man@vger.kernel.org
	public-inbox-index linux-man

Example config snippet for mirrors

Newsgroup available over NNTP:
	nntp://nntp.lore.kernel.org/org.kernel.vger.linux-man


AGPL code for this site: git clone https://public-inbox.org/public-inbox.git