From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.emacs.gnus.general/36889 Path: main.gmane.org!not-for-mail From: Kai.Grossjohann@CS.Uni-Dortmund.DE (Kai =?iso-8859-1?q?Gro=DFjohann?=) Newsgroups: gmane.emacs.gnus.general Subject: Re: gnus-faq.texi: very old? Date: Thu, 12 Jul 2001 19:25:25 +0200 Message-ID: References: NNTP-Posting-Host: coloc-standby.netfonds.no Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: main.gmane.org 1035172399 10973 80.91.224.250 (21 Oct 2002 03:53:19 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Mon, 21 Oct 2002 03:53:19 +0000 (UTC) Cc: ding@gnus.org Return-Path: Return-Path: Original-Received: (qmail 8373 invoked from network); 12 Jul 2001 17:25:55 -0000 Original-Received: from waldorf.cs.uni-dortmund.de (129.217.4.42) by gnus.org with SMTP; 12 Jul 2001 17:25:55 -0000 Original-Received: from lothlorien.cs.uni-dortmund.de (lothlorien.cs.uni-dortmund.de [129.217.19.67]) by waldorf.cs.uni-dortmund.de with ESMTP id TAA14192; Thu, 12 Jul 2001 19:25:26 +0200 (MES) Original-Received: from lucy.cs.uni-dortmund.de (lucy [129.217.19.80]) by lothlorien.cs.uni-dortmund.de id TAA29740; Thu, 12 Jul 2001 19:25:26 +0200 (MET DST) Original-Received: (from grossjoh@localhost) by lucy.cs.uni-dortmund.de (8.9.3/8.9.3/Debian 8.9.3-21) id TAA13123; Thu, 12 Jul 2001 19:25:25 +0200 Original-To: Justin Sheehy In-Reply-To: (Justin Sheehy's message of "Thu, 12 Jul 2001 12:12:40 -0400") User-Agent: Gnus/5.090004 (Oort Gnus v0.04) Emacs/21.0.104 Original-Lines: 37 Xref: main.gmane.org gmane.emacs.gnus.general:36889 X-Report-Spam: http://spam.gmane.org/gmane.emacs.gnus.general:36889 On Thu, 12 Jul 2001, Justin Sheehy wrote: > That said, if it became trivial for me to generate the HTML and text > formats that I need from the *.texi files, I would certainly > consider switching to that form for the maintainance of the FAQ. Caveat: I like Texinfo as a format, and I also like the Info reader that comes with Emacs. It supports searching quite nicely. So I might be biased. Using just one *.texi file is the easiest way to maintain Texinfo documentation, so the `one file' requirement is fulfilled. It is easy to create HTML from *.texi (makeinfo --help foo.texi). If you want to see what that looks like, you might want to look at the Tramp manual at the following URL: http://ls6-www.cs.uni-dortmund.de/~grossjoh/emacs/tramp.html As you can see, I created just a single HTML file, but it's also possible to split the result into several HTML files. For example, by splitting at every @chapter command. I'm not quite sure how to generate text from that. I personally like the Info format which is nearly text, but I guess you won't like it. How about converting the HTML into text, then? And Texinfo is a very simple format. About the same complexity as HTML 1.0, I'd say. Just a few tags, all well documented. The biggest problem I've had with it so far is that some of the @-commands expect their argument in {...} whereas others dislike the braces and just read to end of line. But `makeinfo' produces very nice error messages, so these problems are easy to find. kai -- ~/.signature: No such file or directory