Chapter 4. TODO List

Table of Contents

4.1. Roadmap for 0.9.* releases
4.2. Old TODO entries

4.1. Roadmap for 0.9.* releases

  • Internationalisation and po-debconf support. Unfortunately this would require merging Abstract and Title fields into one Description field. See Bug#171363, Bug#171375, and Bug#171378.

  • Introduce some new fields, like Package (Bug#71955), or SortSkip (Bug#187590).

  • Possibly allow documents to appear in multiple sections; see Steve M. Robbins' mail.

  • Possibly index documentation with swish++ that could be used by frontends like dhelp or dwww.

4.2. Old TODO entries

  • Policy: document the doc-base document registration file format separately (or SUBDOC it) as a proposed Debian documentation system policy.

  • Policy: define a first-cut standard as the document hierarchy.

  • Documentation update: show clean and minimal use of install-docs from a maintainer script.

  • It is extremely difficult to deal coherently with a misnamed control file, or a mismatch between a control file and the document field. This hit me in the transition between doc-base 0.4 to 0.5 (in 0.4 I had added, in a file install-docs-man, a document ID named install-doc-man). Something needs to be done about that.

  • Automated format conversion, including user preferences. (For example, convert Texinfo source to GNU info or PostScript, optionally compress or remove HTML manuals which are also available in GNU info format, etc. etc.)