Control: tag -1 + patch
Lintian's manual was converted to reStructuredText format. This MR uses
rst2html to generate the HTML version.
https://salsa.debian.org/lintian/lintian/merge_requests/245
This RST file was generated from the existing manual in Docbook format
using:
pandoc -f docbook -t rst doc/lintian.xml > doc/lintian.rst
The resulting file showed the following three errors when used to generate
HTML with rst2html from python3-docutils:
lintian.rst:366: (ERROR/3) Unexpected indentation.
lintian.rst:363: (WARNING/2) Inline literal start-string without
end-string.
lintian.rst:367: (WARNING/2) Block quote ends without a blank line;
unexpected unindent.
The errors disappeared after a single, multi-space indent in line 366 was
removed manually using an editor.
RST does not have a facility to split documents into multiple output files
(although a 'toctree' directive could link multiple documents.) For now,
the HTML manual is one large, contiguous file.
Installs the single HTML file and the reStructuredText file in the user
package. Sets a link to the RST version with the ending *.txt in hope of
avoiding breakage.
Updates doc-base entries to point to the single HTML file and to the RST
file in lieu of plain text documentation.
