Re: Re^2: Status of Debian Policy
Lars> It was decided many moons ago that Debian would use HTML as its
Lars> primary on-line documentation format. HTML should be the default.
Marco> That's right. But a lot of important packages like doc-linux don't
Marco> use HTML.
Well, the maintainer (that's me) prefers info as the basis format, and dwww
(thanks to Lars and Jim !) to render the documentation into hypertext.
However, Christian Schwarz asked me to do html as well. That will be some
work as HOWTO packages comes as tar.gz files with no surcompassing
index.html. I'll have to do some perl hacking. No promises for the June
release, maybe for July.
But let me say it again: info files are better because they are more
versatile as a base format. And they are much smaller. Much smaller. [1]
Finally, I can also search an entire HOWTO at once in my preferred editor
(which happens to uncompress the gzipped text on the fly).
[1] edd@miles:~> du -sS /mirror/sunsite/HOWTO/
1482 /mirror/sunsite/HOWTO
is already smaller than
edd@miles:~> du -sS /mirror/sunsite/HOWTO/other-formats/html/
1694 /mirror/sunsite/HOWTO/other-formats/html
which we will have to untar and gunzip:
edd@miles:/tmp/howtos> for i in /mirror/sunsite/HOWTO/other-formats/html/*tar.gz; do tar xfz $i; done
edd@miles:/tmp/howtos> du -sS .
5730 .
edd@miles:/tmp/howtos> echo 5730/1482 | bc -l
3.86639676113360323886
--
edd@debian.org edd@rosebud.sps.queensu.ca http://rosebud.sps.queensu.ca/~edd
PGP key fingerprint = B2 49 75 BF 44 2C B7 AA 50 CB 19 7D 80 F7 CB DC
--
By US Code Title 47, Sec.227(a)(2)(B), a computer/modem/printer meets the
definition of a telephone fax machine. By Sec.227(b)(1)(C), it is unlawful to
send any unsolicited advertisement to such equipment. By Sec.227(b)(3)(C), a
violation of the aforementioned section is punishable by action to recover
actual monetary loss, or $500, whichever is greater, for each violation.
Please read the full text at http://www.law.cornell.edu/uscode/47/227.html.
--
TO UNSUBSCRIBE FROM THIS MAILING LIST: e-mail the word "unsubscribe" to
debian-devel-request@lists.debian.org .
Trouble? e-mail to templin@bucknell.edu .
Reply to: