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=-1.9 required=5.0 tests=BAYES_00 autolearn=ham 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 wh2mr1764759pbc.7.1336644630869; Thu, 10 May 2012 03:10:30 -0700 (PDT) Path: pr3ni9525pbb.0!nntp.google.com!news2.google.com!npeer01.iad.highwinds-media.com!news.highwinds-media.com!feed-me.highwinds-media.com!post02.iad.highwinds-media.com!news.flashnewsgroups.com-b7.4zTQh5tI3A!not-for-mail From: Stephen Leake Newsgroups: comp.lang.ada Subject: Re: Ada Reference Manual 2012 in info format References: <82aa1ud0l3.fsf@stephe-leake.org> <20120509131736.63c924c8@vostro> Date: Thu, 10 May 2012 11:11:25 +0100 Message-ID: <82lil0gxbm.fsf@stephe-leake.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.2 (windows-nt) Cancel-Lock: sha1:gT+tXv0U+Rmcimbhnojk353qXsg= MIME-Version: 1.0 X-Complaints-To: abuse@flashnewsgroups.com Organization: FlashNewsgroups.com X-Trace: ad0414fab9416e029e66117195 X-Received-Bytes: 3721 Content-Type: text/plain; charset=us-ascii Date: 2012-05-10T11:11:25+01:00 List-Id: Oliver Kleinke writes: > I am writing an XML extension to the formatter. Excellent! > 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). Sounds like a good idea; I'd really like to have a PDF with full hyperlinks. > A major problem of the formatter/RM sources is that they only provide > partial semantic information about the contents, that IS 1995-style. What, exactly, is missing? Can you give an example? If you are trying to translate the Scheme into XML so that the XML contains _all_ of the information in the Scheme, and saying that arm_form does not provide the facilities to do that, then you are probably right; arm_form was not designed to do that. arm_form was designed to produce readable output formats from the Scheme; the output formats contain far less information than the Scheme. If you are saying the Scheme does not have all the information you want, then I don't understand what is missing. > Honestly, you should consider converting the sources to a more > appropriate format. There are a _lot_ of requirements on the format. A big one is "don't lose any history". That's _very_ hard to satisfy in a totally new format! Another big one is "don't waste Randy's time"; it takes time to learn any new format. It takes _far_ more time to verify that the translation is _perfect_. You have not provided any solid rationale for considering such a major change. Just be glad the source is machine readable; it might have been in Word, or Adobe Framemaker! > 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. Yes, but that's why I provide a .tar.gz of the full source: http://www.stephe-leake.org/ada/arm_info-20120428-src.tar.gz http://www.stephe-leake.org/ada/arm.html In Randy's defense, any more sophisticated access would require a hole in his firewall. I much prefer that Randy spend his time working on ARG stuff, and maintaining AdaIC.org, than chasing problems due to holes in firewalls! Anyone doing this work should be able to cope, or build on my work. It's not like there are hundreds of us! > Providing a modern HTML version does not exclude the possibility to > provide a more 'compatible' version, You have yet to define what you mean by either "modern" or "compatible", either by example or description. It's getting hard to be patient! > so don't be so obstinate. :-) I'm seeing far more obstinate behavior from you than from Randy. -- -- Stephe