A standard hierarchy for both bins and docs (Was: Bug#19076)
Marco Budde writes:
> Yann Dirson wrote:
> > As examples, the following dhelp-generated pages feature this problem:
> > http://bylbo/doc/HTML/Apps/index.html
> > http://bylbo/doc/HTML/Apps/Programming/index.html
> Ok, but that's a bug of doc-base, the section should be apps
> and not Apps. Maybe we could introduce some new sections.
I'd rather say it's a conflict between doc-base and dhelp.
> > Given that "menu" already provides a quite good hiearchy, and that
> > doc-base seem to encourage its use, I think we'd better use/translate
> > these items for dhelp too.
> We should use the same sections, right, but it's not a good idea
> to have apps (native dhelp) and Apps (dhelp with doc-base).
> Christian should convert the sections to lowercase for .dhelp.
As there are far more packages using menu/dwww than dhelp, I'd rather
suggest we use the hierarchy suggested by the menu package. It also
more nicely structured, with sub-levels. dhelp AFAIK only suggests a
one-level deep structure, which is not sufficient for the number of
doc we currently have. Think about the info dir file, as an example.
OTOH, use of menu is policy. Though use of doc-base is not yet, I
expect it to become policy for 2.1. For consistency, I think it would
be necessary to use the same menu structure for binaries and their
As menu is now standard, it seems clear to me that we would use this
one, rather than the flat one suggested by dhelp.
OTTH, dhelp provides a translation mechanism, which menu doesn't
(yet). We should probably setup a mechanism to use the same
translation repository. I suggest standard message catalogs for this.
Any comments ?
Yann Dirson <firstname.lastname@example.org> | Stop making M$-Bill richer & richer,
alt-email: <email@example.com> | support Debian GNU/Linux:
debian-email: <firstname.lastname@example.org> | more powerful, more stable !
http://www.a2points.com/homepage/3475232 | Check <http://www.debian.org/>
E-mail the word "unsubscribe" to email@example.com
TO UNSUBSCRIBE FROM THIS MAILING LIST. Trouble? E-mail to firstname.lastname@example.org .