Package: debiandoc-sgml
Severity: wishlist
I notice that the HTML version of new-maint[1], and presumably other
Debian documentation, lacks LINK[2] tags in the HEAD header. These tags
make it a little easier to read large documents in some browsers, such
as emacs-w3m or firefox (with the Link Widgets extension).
Here is an extensive example from an XHTML document:
<head>
<title>The Elements of Programming</title>
<link rel="stylesheet" type="text/css" href="book-Z-C.css"
title="default" />
<link rel="Start" href="book.xhtml" title="Cover Page" />
<link rel="First" href="book.xhtml" title="Cover Page" />
<link rel="Copyright" href="book-Z-H-02.xhtml" title="Copyright" />
<link rel="Contents" href="book-Z-H-04.xhtml" title="Table of Contents" />
<link rel="End" href="book-Z-H-36.xhtml" title="References" />
<link rel="Index" href="book-Z-H-37.xhtml" title="List of Exercises" />
<link rel="Index" href="book-Z-H-38.xhtml" title="Index" />
<link rel="Up" href="book-Z-H-09.xhtml" title="Building Abstractions with
Procedures" />
<link rel="Subsection" href="#sec_1.1.1" title="Expressions" />
<link rel="Subsection" href="#sec_1.1.2" title="Naming and the
Environment" />
<link rel="Subsection" href="#sec_1.1.3" title="Evaluating Combinations"
/>
<link rel="Subsection" href="#sec_1.1.4" title="Compound Procedures" />
<link rel="Subsection" href="#sec_1.1.5" title="The Substitution Model
for Procedure Application" />
<link rel="Subsection" href="#sec_1.1.6" title="Conditional Expression
and Predicates" />
<link rel="Subsection" href="#sec_1.1.7" title="Example: Square Roots by
Newton's Method" />
<link rel="Subsection" href="#sec_1.1.8" title="Procedures as Black-box
Abstractions" />
<link rel="Next" href="book-Z-H-11.xhtml" title="Procedures and the
Processes They Generate" />
<link rel="Prev" href="book-Z-H-09.xhtml" title="Building Abstractions
with Procedures" />
<meta name="robots" content="noindex,follow" />
<meta name="generator" content="tex2page 4o" />
</head>
Particularly desirable are the Next and Prev relations.
I assume that debiandoc-sgml is responsible for generating HTML output
from debiandoc sources. If this is not the case, this bug should be
reassigned.
[1] http://www.us.debian.org/doc/manuals/maint-guide/ch-start.en.html
[2] http://www.w3.org/TR/html4/struct/links.html#h-12.3
--
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
