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]     [EMAIL PROTECTED]:~> du -sS /mirror/sunsite/HOWTO/
        1482    /mirror/sunsite/HOWTO    

is already smaller than 

        [EMAIL PROTECTED]:~> du -sS /mirror/sunsite/HOWTO/other-formats/html/
        1694    /mirror/sunsite/HOWTO/other-formats/html    

which we will have to untar and gunzip:

        [EMAIL PROTECTED]:/tmp/howtos> for i in 
/mirror/sunsite/HOWTO/other-formats/html/*tar.gz; do tar xfz $i; done
        [EMAIL PROTECTED]:/tmp/howtos> du -sS .
        5730    .            
                
        [EMAIL PROTECTED]:/tmp/howtos> echo 5730/1482 | bc -l
        3.86639676113360323886       


--
 [EMAIL PROTECTED]  [EMAIL PROTECTED]  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
[EMAIL PROTECTED] . 
Trouble?  e-mail to [EMAIL PROTECTED] .

Reply via email to