Debian Bug report logs - #922654
debian-policy: Section 9.1.2 points to a wrong FHS section?

Toggle useless messages

Message #5 received at submit@bugs.debian.org (full text, mbox, reply):

From: Linda Lapinlampi <linda@lindalap.fi>

To: Debian Bug Tracking System <submit@bugs.debian.org>

Subject: debian-policy: Section 9.1.2 points to a wrong FHS section?

Date: Mon, 18 Feb 2019 23:54:08 +0000

Source: debian-policy
Version: 4.3.0.2
Severity: normal

The policy says in section § 9.1.2. "Site-specific programs":

> Packages must not create sub-directories in the directory /usr/local
> itself, except those listed in FHS, section 4.5. However, you may
> create directories below them as you wish. You must not remove any of
> the directories listed in 4.5, even if you created them.

FHS 3.0's section 4.5 is about a completely irrelevant /usr/include
directory, not about /usr/local. I think this should point to section
4.9 in the FHS?

In FHS 2.3, this "section 4.5" might have been right. But as said in
policy 9.1.1:

> The location of all files and directories must comply with the Filesystem
> Hierarchy Standard (FHS), version 3.0, [...].

No other exception is noted below that.

Message #16 received at 922654@bugs.debian.org (full text, mbox, reply):

From: Sean Whitton <spwhitton@spwhitton.name>

To: Linda Lapinlampi <linda@lindalap.fi>, 922654@bugs.debian.org

Subject: Re: Bug#922654: debian-policy: Section 9.1.2 points to a wrong FHS section?

Date: Fri, 22 Feb 2019 17:45:29 -0700

[Message part 1 (text/plain, inline)]

Hello,

On Mon 18 Feb 2019 at 11:54PM +00, Linda Lapinlampi wrote:

> The policy says in section § 9.1.2. "Site-specific programs":
>
>> Packages must not create sub-directories in the directory /usr/local
>> itself, except those listed in FHS, section 4.5. However, you may
>> create directories below them as you wish. You must not remove any of
>> the directories listed in 4.5, even if you created them.
>
> FHS 3.0's section 4.5 is about a completely irrelevant /usr/include
> directory, not about /usr/local. I think this should point to section
> 4.9 in the FHS?
>
> In FHS 2.3, this "section 4.5" might have been right. But as said in
> policy 9.1.1:
>
>> The location of all files and directories must comply with the Filesystem
>> Hierarchy Standard (FHS), version 3.0, [...].
>
> No other exception is noted below that.

Thanks.  A patch would be welcome.

-- 
Sean Whitton

[signature.asc (application/pgp-signature, inline)]

Message #21 received at 922654@bugs.debian.org (full text, mbox, reply):

From: Linda Lapinlampi <linda@lindalap.fi>

To: Debian Bug Tracking System <922654@bugs.debian.org>

Cc: Sean Whitton <spwhitton@spwhitton.name>

Subject: Re: Bug#922654: debian-policy: Section 9.1.2 points to a wrong FHS section?

Date: Mon, 8 Apr 2019 23:13:36 +0000

[Message part 1 (text/plain, inline)]

control: tags -1 + patch

On Fri, Feb 22, 2019 at 05:45:29PM -0700, Sean Whitton wrote:
> On Mon 18 Feb 2019 at 11:54PM +00, Linda Lapinlampi wrote:
> > FHS 3.0's section 4.5 is about a completely irrelevant /usr/include
> > directory, not about /usr/local. I think this should point to section
> > 4.9 in the FHS?
> 
> Thanks.  A patch would be welcome.

Hi, apologies for the delay especially now that Buster is already in
full-freeze. :(

I'm attaching a patch, seems trivial. Here's the word-diff=plain to
resolve typos. Hoping this is okay to merge as is, but more feedback is
welcome.

diff --git a/policy/ch-opersys.rst b/policy/ch-opersys.rst
index 59c92ec..6e0c020 100644
--- a/policy/ch-opersys.rst
+++ b/policy/ch-opersys.rst
@@ -127,8 +127,8 @@ empty.
Note that this applies only to directories *below* ``/usr/local``, not
*in* ``/usr/local``. Packages must not create sub-directories in the
directory ``/usr/local`` itself, except those listed in FHS, section
[-4.5.-]{+4.9.+} However, you may create directories below them as you wish. You
must not remove any of the directories listed in [-4.5,-]{+4.9,+} even if you
created them.

If ``/etc/staff-group-for-usr-local`` does not exist, ``/usr/local``

[0001-ch-opersys-Update-referenced-sections-to-FHS-3.0.patch (text/x-diff, attachment)]

Message #28 received at 922654@bugs.debian.org (full text, mbox, reply):

From: Sean Whitton <spwhitton@spwhitton.name>

To: Linda Lapinlampi <linda@lindalap.fi>, 922654@bugs.debian.org

Subject: Re: Bug#922654: debian-policy: Section 9.1.2 points to a wrong FHS section?

Date: Tue, 09 Apr 2019 10:21:29 -0700

control: tag -1 +pending

Hello,

On Mon 08 Apr 2019 at 11:13PM +00, Linda Lapinlampi wrote:

> I'm attaching a patch, seems trivial. Here's the word-diff=plain to
> resolve typos. Hoping this is okay to merge as is, but more feedback is
> welcome.

Thanks, applied.

> This fixes those references to the new numbers found in the FHS 3.0
> document, **and thus fixes the typos.**

I dropped the final clause because the problem was not a typographical
error, at least how I understand that term.

-- 
Sean Whitton

Message #35 received at 922654@bugs.debian.org (full text, mbox, reply):

From: Linda Lapinlampi <linda@lindalap.fi>

To: Sean Whitton <spwhitton@spwhitton.name>

Cc: Debian Bug Tracking System <922654@bugs.debian.org>

Subject: Re: Bug#922654: debian-policy: Section 9.1.2 points to a wrong FHS section?

Date: Thu, 11 Apr 2019 14:35:26 +0000

On Tue, Apr 09, 2019 at 10:21:29AM -0700, Sean Whitton wrote:
> On Mon 08 Apr 2019 at 11:13PM +00, Linda Lapinlampi wrote:
> 
> > I'm attaching a patch, seems trivial. Here's the word-diff=plain to
> > resolve typos. Hoping this is okay to merge as is, but more feedback is
> > welcome.
> 
> Thanks, applied.

Just fyi: The debian/changelog file references section 9.11 incorrectly
for UNRELEASED 4.3.0.4 version; the section should be 9.1.1. The commit
has it correct.

Message #40 received at 922654@bugs.debian.org (full text, mbox, reply):

From: Linda Lapinlampi <linda@lindalap.fi>

To: Sean Whitton <spwhitton@spwhitton.name>

Cc: Debian Bug Tracking System <922654@bugs.debian.org>

Subject: Re: Bug#922654: debian-policy: Section 9.1.2 points to a wrong FHS section?

Date: Thu, 11 Apr 2019 14:37:35 +0000

On Thu, Apr 11, 2019 at 02:35:26PM +0000, Linda Lapinlampi wrote:
> Just fyi: The debian/changelog file references section 9.11 incorrectly
> for UNRELEASED 4.3.0.4 version; the section should be 9.1.1. The commit
> has it correct.

Actually, I think I was meant to say 9.1.2 for the changelog.

Message #45 received at 922654@bugs.debian.org (full text, mbox, reply):

From: Sean Whitton <spwhitton@spwhitton.name>

To: Linda Lapinlampi <linda@lindalap.fi>

Cc: Debian Bug Tracking System <922654@bugs.debian.org>

Subject: Re: Bug#922654: debian-policy: Section 9.1.2 points to a wrong FHS section?

Date: Fri, 12 Apr 2019 14:27:29 -0700

[Message part 1 (text/plain, inline)]

Hello,

On Thu 11 Apr 2019 at 02:37PM +00, Linda Lapinlampi wrote:

> On Thu, Apr 11, 2019 at 02:35:26PM +0000, Linda Lapinlampi wrote:
>> Just fyi: The debian/changelog file references section 9.11 incorrectly
>> for UNRELEASED 4.3.0.4 version; the section should be 9.1.1. The commit
>> has it correct.
>
> Actually, I think I was meant to say 9.1.2 for the changelog.

Fixed, thanks.

-- 
Sean Whitton

[signature.asc (application/pgp-signature, inline)]

Message #50 received at 922654-done@bugs.debian.org (full text, mbox, reply):

From: Russ Allbery <rra@debian.org>

To: 922654-done@bugs.debian.org

Subject: Re: Bug#922654: debian-policy: Section 9.1.2 points to a wrong FHS section?

Date: Sat, 20 Jul 2019 20:55:28 -0700

Version: 4.4.0.0

This was closed in 4.4.0.0 but the bug closer was missing from
debian/changelog.  I've added it now for the historical record.

-- 
Russ Allbery (rra@debian.org)               <http://www.eyrie.org/~eagle/>

Send a report that this bug log contains spam.