Bug#549289: [maint-guide] Example rules file no longer mat..

Jason Heeris · External Since: Apr 10, 2009 Posts: 3

Package: maint-guide
Version: 1.2.14
Severity: normal

Looking at:

http://www.debian.org/doc/maint-guide/ch-dreq.en.html#s-rules

The rules file it displays as an example no longer matches the output
from dh_make, which has been significantly simplified. (At least, I
think this is the case. The changelog mentions some simplification,
and when I run it on a familiar source tree, I get two non-comment
lines.)

— Jason Heeris

--
To UNSUBSCRIBE, email to debian-bugs-dist-REQUEST RemoveThis @lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster RemoveThis @lists.debian.org

Josip Rodin · External Since: Oct 13, 2006 Posts: 118

On Fri, Oct 02, 2009 at 02:29:19PM +0800, Jason Heeris wrote:
> Package: maint-guide
> Version: 1.2.14
> Severity: normal
>
> Looking at:
>
> http://www.debian.org/doc/maint-guide/ch-dreq.en.html#s-rules
>
> The rules file it displays as an example no longer matches the output
> from dh_make, which has been significantly simplified. (At least, I
> think this is the case. The changelog mentions some simplification,
> and when I run it on a familiar source tree, I get two non-comment
> lines.)

This makes much of that maint-guide section redundant, but still, the dh(1)
syntax helps overall readability. I think we should adjust to this by
explaining the new syntax and overrides. Osamu, do you agree?

--
2. That which causes joy or happiness.

--
To UNSUBSCRIBE, email to debian-bugs-dist-REQUEST.RemoveThis@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster.RemoveThis@lists.debian.org

Osamu Aoki · External Since: Nov 10, 2004 Posts: 409

Hi,

On Sat, Nov 07, 2009 at 01:44:13PM +0100, Josip Rodin wrote:
> On Fri, Oct 02, 2009 at 02:29:19PM +0800, Jason Heeris wrote:
....
> This makes much of that maint-guide section redundant, but still, the dh(1)
> syntax helps overall readability. I think we should adjust to this by
> explaining the new syntax and overrides. Osamu, do you agree?

Hmmm... Clearly, I have not packaged new packages recently nor checked
debhelper changelog to realize dh(1).

I thought it is one of CDBS which hides too much for novice to learn how
system works.

I was wrong.

Anyway, maint-guide needs good rewrite by someone with time, skill and
energy to do it. I do not think I can do it now.

Osamu

--
To UNSUBSCRIBE, email to debian-bugs-dist-REQUEST RemoveThis @lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster RemoveThis @lists.debian.org

Josip Rodin · External Since: Oct 13, 2006 Posts: 118

On Tue, Nov 10, 2009 at 01:16:45AM +0900, Osamu Aoki wrote:
> On Sat, Nov 07, 2009 at 01:44:13PM +0100, Josip Rodin wrote:
> > On Fri, Oct 02, 2009 at 02:29:19PM +0800, Jason Heeris wrote:
> ...
> > This makes much of that maint-guide section redundant, but still, the dh(1)
> > syntax helps overall readability. I think we should adjust to this by
> > explaining the new syntax and overrides. Osamu, do you agree?
>
> Hmmm... Clearly, I have not packaged new packages recently nor checked
> debhelper changelog to realize dh(1).
>
> I thought it is one of CDBS which hides too much for novice to learn how
> system works.
>
> I was wrong.
>
> Anyway, maint-guide needs good rewrite by someone with time, skill and
> energy to do it. I do not think I can do it now.

It just hides it by default, but if we just tell the novice to use
DH_VERBOSE=1, which is good for its educational value Smile

it looks pretty
much the same. I'll see if I can find some time to update it.

--
2. That which causes joy or happiness.

--
To UNSUBSCRIBE, email to debian-bugs-dist-REQUEST RemoveThis @lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster RemoveThis @lists.debian.org