Bug#251996: acknowledged by developer (Re: Bug#251995: gnome-applets: no manpages supplied)

[Karsten M. Self]

--J5MfuwkIyy7RmF4Q
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

on Sat, Jun 05, 2004 at 06:23:59PM +0200, Marc Dequ??nes (Duck@DuckCorp.org=
) wrote:
>=20
> "Karsten M. Self" <kmself@ix.netcom.com> writes:
>=20
> > There are numerous apps not in the path which have manpages.
>=20
>=20
> that's right, but this is not sufficient to make it a good thing for all
> packages.

Irrelevant.

Policy is sufficient.
=20
> > Moreover:  there are numerous _system_ features which have manpages
> > though they're only accessible through programming interfaces.  The
> > manual isn't strictly a user resource, it's a system documentation
> > resource.  Memory is hazy, but IIRC the original UNIX system manual was
> > for programming interfaces, shell commands were added later.
>=20
> I agree, but here there is NO sysinfo/interface/... to documente on in
> this case.

Sorry?  Unclear.
=20
> > Because among the places I go for system information on features is the
> > man and apropos systems.   The GNOME applets have identifiable
> > execuatables and show in the process table.  This is sufficient
> > indication IMO that they should have manpages.
> >
> > A stub page describing the applet, how it's to be invoked, and where the
> > extended docs live, would be good.  References as a URL, file ref, or
> > GNOME docs ref, would be sufficient.   I may craft same time permitting.
>=20
> Applets are described in the pkg descrition and in yelp, what else to
> say it was not already ?

Irrelevant.

Policy requires this.
=20
> > Specific interest:  I wanted to know how to fix issues with several
> > applets which weren't functioning properly.
>=20
> Applets are not libraries, if you need information about how to make
> one, use materials in libpanel-applet2-doc, and if you want to patch
> one, UTSL.

Irrelevant.

Policy requires this.
=20
> I disagree to write a manpage on everything if it does not bring real
> information.=20

Irrelevant, policy requires this.

> Nevertheless, as you think links to more detailed information for
> developpers are lacking, i could add a note in README.Debian, which is
> more appropriate for this kind of information, as it is related to the
> entire package and not to a specific part of him.

Irrelevant, policy requires this.


Again:  the bug doesn't hold the package or prevent it from making
stable.  It indicates that a manpage, required by policy, is missing.

All else is equivocation, and wholly unnecessary.


Peace.

--=20
Karsten M. Self <kmself@ix.netcom.com>        http://kmself.home.netcom.com/
 What Part of "Gestalt" don't you understand?
    Music makes one feel so romantic - at least it always gets on one's
    nerves - which is the same thing nowadays.
    - Oscar Wilde

--J5MfuwkIyy7RmF4Q
Content-Type: application/pgp-signature; name="signature.asc"
Content-Description: Digital signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.4 (GNU/Linux)

iD8DBQFAw6u3efG8443k044RAnh5AKCCcPJ5Sty1iDYmHEFJU0SGCm3zBACcCFM/
KrJjkZ6DbUruTOaBGATF/l4=
=37Po
-----END PGP SIGNATURE-----

--J5MfuwkIyy7RmF4Q--