Package: lifelines-doc
Version: 3.0.37.2-3
Severity: important
The package's file /usr/share/doc-base/lifelines-doc contains errors.
(1) The abstract is wrong, so the documentation is installed with a badly
misleading description.
(2) The control fields are wrong for non-html; each format should only have
one "Files" section.
(3) The control fields for html only enter one of the two manuals into the
doc-base index. It would be better if both manuals were entered.
Details:
(1) The abstract is wrong. It currently says:
Abstract: This manual describes what lifelines is
and how it can be used to
manage online manuals on Debian systems.
Surely lifelines is for managing genealogy data, not for managing online
manuals. :-)
So shouldn't the abstract say something like this?
Abstract: User guide and full programmer's manual for the
lifelines genealogy software
(2) Installation of lifelines-doc generates these warnings:
Setting up lifelines-doc (3.0.37.2-3) ...
warning: files: overwriting previous setting of control field at
/usr/sbin/install-docs line 592, <IN> line 11.
warning: files: overwriting previous setting of control field at
/usr/sbin/install-docs line 592, <IN> line 15.
warning: files: overwriting previous setting of control field at
/usr/sbin/install-docs line 592, <IN> line 19.
This is because having two "Files" sections for one "Format" is not
supported. Here is the relevant part of the doc-base manual, at
file:/usr/share/doc/doc-base/doc-base.html/ch2.html#s2.3
Files
A filename or shell glob representing the files which
constitute the in this format of the document. Required field.
So /usr/share/doc-base/lifelines-doc should have lines something like this
Files: /usr/share/doc/lifelines-doc/ll-*.xml.gz
(3) The html section is unhelpful, because it only adds one of the two
manuals to the doc-base index. Here is what it currently says:
Format: HTML
Files: /usr/share/doc/lifelines-doc/ll-userguide.html
Index: /usr/share/doc/lifelines-doc/ll-userguide.html
Since the manual is in two parts (user guide, programmer's guide) it
would be better to ship a small ll-index.html something like this
<html>
<head><title>Lifelines manuals</title></head>
<body>
<a href="ll-userguide.html">Lifelines user guide</a>
<a href="ll-reportmanual.html">Report programming subsystem</a>
</body>
</html>
and try something like
Format: HTML
Index: /usr/share/doc/lifelines-doc/ll-index.html
Files: /usr/share/doc/lifelines-doc/ll-*.html
-- System Information:
Debian Release: 3.1
Architecture: i386 (i686)
Kernel: Linux 2.4.27-2-686
Locale: LANG=en_GB, LC_CTYPE=en_GB (charmap=ISO-8859-1)
-- no debconf information
--
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
