From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 16682 invoked from network); 1 Mar 2004 11:35:54 -0000 Received: from sunsite.dk (130.225.247.90) by ns1.primenet.com.au with SMTP; 1 Mar 2004 11:35:54 -0000 Received: (qmail 18357 invoked by alias); 1 Mar 2004 11:35:45 -0000 Mailing-List: contact zsh-workers-help@sunsite.dk; run by ezmlm Precedence: bulk X-No-Archive: yes X-Seq: 19503 Received: (qmail 18346 invoked from network); 1 Mar 2004 11:35:44 -0000 Received: from localhost (HELO sunsite.dk) (127.0.0.1) by localhost with SMTP; 1 Mar 2004 11:35:44 -0000 X-MessageWall-Score: 0 (sunsite.dk) Received: from [193.109.254.211] by sunsite.dk (MessageWall 1.0.8) with SMTP; 1 Mar 2004 11:35:44 -0000 X-VirusChecked: Checked X-Env-Sender: okiddle@yahoo.co.uk X-Msg-Ref: server-12.tower-36.messagelabs.com!1078140943!4227677 X-StarScan-Version: 5.2.5; banners=-,-,- X-Originating-IP: [158.234.9.163] Received: (qmail 17403 invoked from network); 1 Mar 2004 11:35:43 -0000 Received: from iris.logica.co.uk (158.234.9.163) by server-12.tower-36.messagelabs.com with SMTP; 1 Mar 2004 11:35:43 -0000 Received: from trentino.logica.co.uk ([158.234.142.61]) by iris.logica.co.uk (8.12.3/8.12.3/Debian -4) with ESMTP id i21BZhCk027771; Mon, 1 Mar 2004 11:35:43 GMT Received: from trentino.logica.co.uk (localhost [127.0.0.1]) by trentino.logica.co.uk (Postfix) with ESMTP id 288627858477; Mon, 1 Mar 2004 12:34:59 +0100 (CET) Cc: Felix Rosencrantz X-VirusChecked: Checked X-StarScan-Version: 5.0.7; banners=.,-,- In-reply-to: <20040228064044.GA484@scowler.net> From: Oliver Kiddle References: <20040227153333.59378.qmail@web10409.mail.yahoo.com> <20040228064044.GA484@scowler.net> To: zw Subject: Re: yodl discontinued. Date: Mon, 01 Mar 2004 12:34:59 +0100 Message-ID: <3845.1078140899@trentino.logica.co.uk> Clint Adams wrote: > > The yodl home page suggests using texinfo. It's not clear to me why we use > > yodl over texinfo. I'm guessing texinfo doesn't create man pages, but yodl can > > create texinfo and man pages. > > I would suggest that if anyone is going to expend any effort in > converting from yodl, he should go to DocBook rather than texinfo. I agree with this. I did a bit of investigation into DocBook before. We can get an initial conversion using makeinfo's --docbook option. The output of that still needs significant editing, however. From docbook, we'd get decent HTML output and better PDF output. Once there's a complete open source XSL-FO implementation, PDF would get better still (currently, it goes via TeX). Texinfo output seems to require some extra tool and would be potentially less good. How attached are people to having decent texinfo output? Though docbook can produce man pages, we'd probably need to use a bit of XSLT to get something like our current man pages. It isn't particularly setup for getting man pages and PDF from the same sources. There could be other advantages. For exmaple, XSLT could do a much better job of extracting documentation for builtins for use with the run-help script. The main advantage, however, is that we wouldn't be using yodl when yodl is unmaintained. Oliver