From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on polar.synack.me X-Spam-Level: * X-Spam-Status: No, score=2.0 required=5.0 tests=BAYES_00,FORGED_MUA_MOZILLA, REPLYTO_WITHOUT_TO_CC autolearn=no autolearn_force=no version=3.4.4 X-Google-Thread: 103376,6487f59679c615d8 X-Google-NewGroupId: yes X-Google-Attributes: gida07f3367d7,domainid0,public,usenet X-Google-Language: ENGLISH,ASCII-7-bit Received: by 10.68.241.98 with SMTP id wh2mr2736211pbc.7.1336565169874; Wed, 09 May 2012 05:06:09 -0700 (PDT) Path: pr3ni6051pbb.0!nntp.google.com!news1.google.com!goblin2!goblin.stu.neva.ru!aioe.org!.POSTED!not-for-mail From: "Nasser M. Abbasi" Newsgroups: comp.lang.ada Subject: Re: Ada Reference Manual 2012 in info format Date: Wed, 09 May 2012 07:06:06 -0500 Organization: Aioe.org NNTP Server Message-ID: References: <82aa1ud0l3.fsf@stephe-leake.org> <20120509131736.63c924c8@vostro> Reply-To: nma@12000.org NNTP-Posting-Host: JFgm6aMVwmC/YQNQyUTYRQ.user.speranza.aioe.org Mime-Version: 1.0 X-Complaints-To: abuse@aioe.org User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:12.0) Gecko/20120428 Thunderbird/12.0.1 X-Notice: Filtered by postfilter v. 0.8.2 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Date: 2012-05-09T07:06:06-05:00 List-Id: On 5/9/2012 6:17 AM, Oliver Kleinke wrote: > > I am writing an XML extension to the formatter. It's not finished yet > but does already look promising. Why XML? Because it's easily > transformable into nearly every other format (Original Source format, > plain-text, HTML, PDF, DocBook, DITA, info, SQL inserts, you name it..) > using XSL (I'm talking XSLT + XSL-FO). A major problem of the > formatter/RM sources is that they only provide partial semantic > information about the contents, that IS 1995-style. Honestly, you should > consider converting the sources to a more appropriate format. Also, the > way the Formatter sources are provided sucks major -- cvsweb, you have > to click around a lot until you have a complete set of files plus some > of the HEAD versions have been broken. > > Providing a modern HTML version does not exclude the possibility to > provide a more 'compatible' version, so don't be so obstinate. :-) > > Cheers, > Oliver hi, I do not know much about XML (other than using it to make some Ant script to build some Java program I have). I use Latex for all my documents, and use Latex2html to convert to HTML and pdflatex to convert to PDF. It works pretty well. If there are some math in the document, I think Latex is the best choice to use. I think XML is not good for math. Now, on a different angle, I've just read Oracle made its latest Java language reference (Java SE7) using DocBook. http://docs.oracle.com/javase/specs/jls/se7/html/jls-0-preface7.html "This edition is the first to be written in the DocBook format. Metadata in the XML markup forms a kind of static type system" Which seems to support what you are saying about XML. It seems DocBook is XML based also. I'd use XML, except that my documents and reports (for school) are full of math, and Latex is the best for that. I like Latex, and I find it very easy to use. Any way, just thought to mention this on the side. --Nasser