[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

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

 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: