Bug#485776: debian-policy: Adding graphical flowcharts for maintainer scripts invocation would help understand the process

[Olivier Berger]

Package: debian-policy
Version: 3.7.3.0
Severity: wishlist

Hello.

The "Package maintainer scripts and installation procedure" chapter of the Debian policy describes in details the process of packages' scripts, but in a non-formal way, which makes it difficult to understand.

I think that adding figures with flowcharts would be great.

Reuse of http://women.debian.org/wiki/English/MaintainerScripts should help a great deal, I suppose.

Hope this will happen.

Best regards,


-- System Information:
Debian Release: lenny/sid
  APT prefers testing
  APT policy: (500, 'testing')
Architecture: i386 (i686)

Kernel: Linux 2.6.24-openvz-24-004.1d1-686 (SMP w/2 CPU cores)
Locale: LANG=fr_FR.UTF-8, LC_CTYPE=fr_FR.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/bash

-- no debconf information



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

[Ian Jackson]

Olivier Berger writes ("Bug#485776: debian-policy: Adding graphical flowcharts for maintainer scripts invocation would help understand the process"):
> I think that adding figures with flowcharts would be great.

I agree.

> Reuse of http://women.debian.org/wiki/English/MaintainerScripts
> should help a great deal, I suppose.

However I think these flowcharts are at a rather higher level than is
ideal because they fail to deal with a few corner cases.  The one I
provided in the triggers specification is more in the right style I
think.

What format would the policy maintainers prefer ?

Ian.



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

[Russ Allbery-2]

Ian Jackson <ian@...> writes:

> However I think these flowcharts are at a rather higher level than is
> ideal because they fail to deal with a few corner cases.  The one I
> provided in the triggers specification is more in the right style I
> think.
>
> What format would the policy maintainers prefer ?

Personally, it makes little difference to me as long as it can be edited
by reasonable free software packages, is preferrably a standardized
format, and can be rendered into PNG files for distributing with the
package and on the web.

I think diagrams would be an excellent idea.

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



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

[Ian Jackson]

Russ Allbery writes ("Re: Bug#485776: debian-policy: Adding graphical flowcharts for maintainer scripts invocation would help understand the process"):
> Personally, it makes little difference to me as long as it can be edited
> by reasonable free software packages, is preferrably a standardized
> format, and can be rendered into PNG files for distributing with the
> package and on the web.
>
> I think diagrams would be an excellent idea.

OK, I'll get out xfig, which is my personal least un-favourite :-).

Ian.



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