From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-8.3 required=3.0 tests=HEADER_FROM_DIFFERENT_DOMAINS, INCLUDES_PATCH,MAILING_LIST_MULTI,SIGNED_OFF_BY,SPF_HELO_NONE,SPF_PASS, USER_AGENT_SANE_1 autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 050DEC433DF for ; Tue, 19 May 2020 12:53:24 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id D65212081A for ; Tue, 19 May 2020 12:53:23 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726196AbgESMxX (ORCPT ); Tue, 19 May 2020 08:53:23 -0400 Received: from smtprelay06.ispgateway.de ([80.67.31.96]:31995 "EHLO smtprelay06.ispgateway.de" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726169AbgESMxX (ORCPT ); Tue, 19 May 2020 08:53:23 -0400 Received: from [149.233.153.81] (helo=[192.168.178.25]) by smtprelay06.ispgateway.de with esmtpsa (TLSv1.2:ECDHE-RSA-AES128-GCM-SHA256:128) (Exim 4.92.3) (envelope-from ) id 1jb1kE-0005Ew-Tl; Tue, 19 May 2020 14:53:18 +0200 Subject: Re: [PATCH] hier.7: Updating from FHS 2.3 to 3.0 To: mtk.manpages@gmail.com Cc: linux-man , glperkins@lit.edu References: <33544f6a-5983-ed08-b2f1-a7a348c411f6@deloquencia.de> <8bbe0eae-b4a0-3b49-84a7-245b46eb9eff@gmail.com> <69e7cf2a-e0d3-bc1d-0bc7-81111cf80bbc@deloquencia.de> From: Thomas Piekarski Message-ID: <9ebe073b-0e66-3ccd-a815-974eae0f9318@deloquencia.de> Date: Tue, 19 May 2020 14:53:18 +0200 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.7.0 MIME-Version: 1.0 In-Reply-To: Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 7bit X-Df-Sender: dC5waWVrYXJza2lAZGVsb3F1ZW5jaWEuZGU= Sender: linux-man-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-man@vger.kernel.org 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 >>>> Signed-off-by: Thomas Piekarski >>> >>> 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 >>>> 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),