Bug#169399: handling of additional documentation with doc-base
As the doc-base maintainer, some comments on the progress of this bug.
On Sun, Nov 17, 2002 at 02:01:29AM +0000, Colin Watson wrote:
> It would be cool if somebody could figure out how to fix #114692
> first. :( Packages with many distinct pieces of additional
> documentation can't practicably use doc-base otherwise. I don't know
> if it might require significant design work ...
This bug has been mitigated, although not fixed. I do allow simple
command-line switcher to allow for registering slews of documentation
orders of magnitude faster. That should hold us until the redesign is
ready (v2).
On Sat, Nov 16, 2002 at 08:26:19PM -0600, Manoj Srivastava wrote:
> If doc-base is really stable and working now, and if it is
> deemed desirable to work it into policy, shouldn't the interface
> be, umm legalized as well? If all packages that are installing
> documentation are supposed to register with doc-base, then the
> registration API should be in policy.
I'm happy to tweeze out the documentation for the existing "docreg" or
document registration file, if you guys want me to, and submit it as a
standalone document for inclusion in policy.
I am planning also to extend the document registration. Most critical
are i18n issues, both in the presentation of the registered document
descriptions and the documents themselves. Previous attempts to
address these issues suffered from rampant "overdesignitus" which I am
trying to remedy.
If you guys have any other suggestions for critical issues, feel free
to respond to me or debian-doc list with comments or file bugs on
doc-base!
--
...Adam Di Carlo..<adam@onshore-devel.com>...<URL:http://www.onshored.com/>
Reply to: