[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#1118763: debian-policy: Don't mention doc-base any more



For comparison, GNOME has long had an app named Devhelp for reading
API documentation with a sidebar allowing easy access to any installed
docs that have registered themselves with a .devhelp2 file. GNOME has
recently archived the Devhelp app in favor of a new app named Manuals
which still supports the .devhelp2 files. (This app is currently in
Debian's NEW queue.)

I count about 366 .devhelp2 files on my system. It is heavily weighted
towards library used by app or system developers for GTK desktops
(GNOME, Xfce, etc.).

There are a few packages that provide the older .devhelp or
.devhelp.gz format but Manuals does not support that format.

I count about 4757 files in /usr/share/doc-base/

The devhelp app has a popcon of 1426 installs, larger than all the
doc-base clients combined. The gnome-builder app has a popcon of 680
and gnome-builder has integrated devhelp2 support similar to the
Manuals app.

The .devhelp2 files are part of the upstream projects. I don't think
anyone is writing those files downstream specifically for Debian.

I'm not really suggesting now that devhelp be mentioned in Debian
Policy, but this is just a contrast with an alternate way of solving
this problem.

Thank you,
Jeremy Bícha


Reply to: