Bug#913295: debian-policy: Update location of example init.d script

[Sean Whitton]

control: tag -1 +pending

Hello,

On Thu 15 Nov 2018 at 10:37AM GMT, Dmitry Bogatov wrote:

> [2018-11-12 12:53] Sean Whitton 
>> > Sorry, I do not understand. Why? Currently, there is no such thing as
>> > `/usr/share/doc/initscripts/examples'.
>>
>> The first message in #913154 suggests moving /etc/init.d/skeleton into
>> /usr/share/doc/initscripts/examples.  And /etc/init.d/skeleton is more
>> detailed than the example in init-d-scripts(5).  So it seems that the
>> best solution is for initscripts to add the examples/ directory, and
>> Policy to refer to that.  Please correct me if I'm wrong!
>
> No, `skeleton' is not more detailed. It just contains wierd construct we
> are working to make unnecessery.  See #913247

Applied, thank you.

-- 
Sean Whitton


signature.asc
Description: PGP signature

Bug#913295: debian-policy: Update location of example init.d script

[Dmitry Bogatov]

[2018-11-12 12:53] Sean Whitton 
> > Sorry, I do not understand. Why? Currently, there is no such thing as
> > `/usr/share/doc/initscripts/examples'.
> 
> The first message in #913154 suggests moving /etc/init.d/skeleton into
> /usr/share/doc/initscripts/examples.  And /etc/init.d/skeleton is more
> detailed than the example in init-d-scripts(5).  So it seems that the
> best solution is for initscripts to add the examples/ directory, and
> Policy to refer to that.  Please correct me if I'm wrong!

No, `skeleton' is not more detailed. It just contains wierd construct we
are working to make unnecessery.  See #913247

Bug#913295: debian-policy: Update location of example init.d script

[Sean Whitton]

Hello,

On Sun 11 Nov 2018 at 09:08PM GMT, Dmitry Bogatov wrote:

> [2018-11-10 17:02] Sean Whitton 
>>
>> Reading #913154, I note that the example in init-d-script(5) is shorter
>> than the old file /etc/init.d/skeleton.  So shouldn't Policy refer to
>> the new file in /usr/share/doc/initscripts/examples, instead?
>
> Sorry, I do not understand. Why? Currently, there is no such thing as
> `/usr/share/doc/initscripts/examples'.

The first message in #913154 suggests moving /etc/init.d/skeleton into
/usr/share/doc/initscripts/examples.  And /etc/init.d/skeleton is more
detailed than the example in init-d-scripts(5).  So it seems that the
best solution is for initscripts to add the examples/ directory, and
Policy to refer to that.  Please correct me if I'm wrong!

-- 
Sean Whitton


signature.asc
Description: PGP signature

Bug#913295: debian-policy: Update location of example init.d script

[Dmitry Bogatov]

[2018-11-10 17:02] Sean Whitton 
> Hello Dmitry,
> 
> On Fri 09 Nov 2018 at 08:17AM GMT, Dmitry Bogatov wrote:
> 
> >  Examples on which you can base your systemd integration on is available in
> >  the man page systemd.unit(8). An example on which you can base your
> > -``/etc/init.d`` scripts is found in ``/etc/init.d/skeleton``.
> > +``/etc/init.d`` scripts is available in the man page init-d-script(5).
> 
> Reading #913154, I note that the example in init-d-script(5) is shorter
> than the old file /etc/init.d/skeleton.  So shouldn't Policy refer to
> the new file in /usr/share/doc/initscripts/examples, instead?

Sorry, I do not understand. Why? Currently, there is no such thing as
`/usr/share/doc/initscripts/examples'.

Bug#913295: debian-policy: Update location of example init.d script

[Russ Allbery]

Sean Whitton  writes:
> On Fri 09 Nov 2018 at 05:39PM -0800, Russ Allbery wrote:

>> Thank you!  Seconded.

> This change seems to be purely informative; could you say why you think
> it needs seconding, please?

Oh, sorry, I didn't even double-check whether there was normative
language, just made a bad assumption.  You're completely correct; this is
just informative.

-- 
Russ Allbery (r...@debian.org)   

Bug#913295: debian-policy: Update location of example init.d script

[Sean Whitton]

Hello Dmitry,

On Fri 09 Nov 2018 at 08:17AM GMT, Dmitry Bogatov wrote:

>  Examples on which you can base your systemd integration on is available in
>  the man page systemd.unit(8). An example on which you can base your
> -``/etc/init.d`` scripts is found in ``/etc/init.d/skeleton``.
> +``/etc/init.d`` scripts is available in the man page init-d-script(5).

Reading #913154, I note that the example in init-d-script(5) is shorter
than the old file /etc/init.d/skeleton.  So shouldn't Policy refer to
the new file in /usr/share/doc/initscripts/examples, instead?

-- 
Sean Whitton


signature.asc
Description: PGP signature

Bug#913295: debian-policy: Update location of example init.d script

[Sean Whitton]

Hello,

On Fri 09 Nov 2018 at 05:39PM -0800, Russ Allbery wrote:

> Thank you!  Seconded.

This change seems to be purely informative; could you say why you think
it needs seconding, please?

-- 
Sean Whitton


signature.asc
Description: PGP signature

Bug#913295: debian-policy: Update location of example init.d script

[Holger Levsen]

On Fri, Nov 09, 2018 at 08:17:42AM +, Dmitry Bogatov wrote:
> From e3457ee94e7293dbd59c9651d82d0c07fda50b33 Mon Sep 17 00:00:00 2001
> From: Dmitry Bogatov 
> Date: Fri, 9 Nov 2018 08:02:01 +
> Subject: [PATCH] Update information about example init.d script
> 
> According to #913154, there is consensus, that `/etc/init.d/skeleton'
> is not suitable location for example init.d script, and actually
> duplicates information, provided by init-d-script(5) manpage.
> ---
>  policy/ch-opersys.rst | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
> 
> diff --git a/policy/ch-opersys.rst b/policy/ch-opersys.rst
> index ffd19d3..59c92ec 100644
> --- a/policy/ch-opersys.rst
> +++ b/policy/ch-opersys.rst
> @@ -628,7 +628,7 @@ Example
>  
>  Examples on which you can base your systemd integration on is available in
>  the man page systemd.unit(8). An example on which you can base your
> -``/etc/init.d`` scripts is found in ``/etc/init.d/skeleton``.
> +``/etc/init.d`` scripts is available in the man page init-d-script(5).

seconded. (while I'm actually not convinced this needs seconding, esp.
if reality changed.)


-- 
cheers,
Holger

---
   holger@(debian|reproducible-builds|layer-acht).org
   PGP fingerprint: B8BF 5413 7B09 D35C F026 FE9D 091A B856 069A AA1C


signature.asc
Description: PGP signature

Bug#913295: debian-policy: Update location of example init.d script

[Russ Allbery]

Dmitry Bogatov  writes:

> According to #913154, there is consensus, that `/etc/init.d/skeleton' is
> not suitable location for example init.d script, and actually duplicates
> information, provided by init-d-script(5) manpage.

> I attach tiny patch, that changes Policy.

Thank you!  Seconded.

-- 
Russ Allbery (r...@debian.org)   

Bug#913295: debian-policy: Update location of example init.d script

[Dmitry Bogatov]

Package: debian-policy
Version: 4.2.1.4
Severity: normal

According to #913154, there is consensus, that `/etc/init.d/skeleton'
is not suitable location for example init.d script, and actually
duplicates information, provided by init-d-script(5) manpage.

I attach tiny patch, that changes Policy.
>From e3457ee94e7293dbd59c9651d82d0c07fda50b33 Mon Sep 17 00:00:00 2001
From: Dmitry Bogatov 
Date: Fri, 9 Nov 2018 08:02:01 +
Subject: [PATCH] Update information about example init.d script

According to #913154, there is consensus, that `/etc/init.d/skeleton'
is not suitable location for example init.d script, and actually
duplicates information, provided by init-d-script(5) manpage.
---
 policy/ch-opersys.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/policy/ch-opersys.rst b/policy/ch-opersys.rst
index ffd19d3..59c92ec 100644
--- a/policy/ch-opersys.rst
+++ b/policy/ch-opersys.rst
@@ -628,7 +628,7 @@ Example
 
 Examples on which you can base your systemd integration on is available in
 the man page systemd.unit(8). An example on which you can base your
-``/etc/init.d`` scripts is found in ``/etc/init.d/skeleton``.
+``/etc/init.d`` scripts is available in the man page init-d-script(5).
 
 .. _s9.4: