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,FREEMAIL_FROM autolearn=ham autolearn_force=no version=3.4.4 X-Google-Thread: 103376,666bab5bfbdf30c2 X-Google-NewGroupId: yes X-Google-Attributes: gida07f3367d7,domainid0,public,usenet X-Google-Language: ENGLISH,UTF8 Path: g2news2.google.com!news4.google.com!feeder.news-service.com!94.75.214.39.MISMATCH!aioe.org!not-for-mail From: =?utf-8?Q?Yannick_Duch=C3=AAne_=28Hibou57?= =?utf-8?Q?=29?= Newsgroups: comp.lang.ada Subject: Re: Generating PDFs with Ada Date: Sun, 16 Jan 2011 03:49:02 +0100 Organization: Ada @ Home Message-ID: References: <4d2908c7$0$22120$742ec2ed@news.sonic.net> <9f23e50a-2c2c-4ccc-bd56-f6ffdc6c7ee7@37g2000prx.googlegroups.com> <82aaj73jsr.fsf@stephe-leake.org> <7a048419-1126-45b2-bfa9-26f3ad6e480e@fu15g2000vbb.googlegroups.com> <4d32496c$0$7669$9b4e6d93@newsspool1.arcor-online.net> NNTP-Posting-Host: m8zK+9y7Rqh7XDLhpHPwQw.user.speranza.aioe.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed; delsp=yes Content-Transfer-Encoding: Quoted-Printable X-Complaints-To: abuse@aioe.org X-Notice: Filtered by postfilter v. 0.8.2 User-Agent: Opera Mail/11.00 (Win32) Xref: g2news2.google.com comp.lang.ada:17414 Date: 2011-01-16T03:49:02+01:00 List-Id: Le Sun, 16 Jan 2011 02:27:07 +0100, Georg Bauhaus = a =C3=A9crit: > [=E2=80=A6] Interesting to see how document authoring and publishing is a so hot top= ic = for Ada novelists. For any people interested in some specific points of the topic; about = DITA, DocBook and XML and narrative documents (XML focused for narrative= = representation rather than data) : http://www.oreillynet.com/xml/blog/2008/05/dita_docbook_and_the_art_of_t= h.html That said, about documenting and to come back a bit to an old topic open= ed = in this usenet (2009, I believe), I wonder if someone know some standard= s = for token based folding (not syntax based) in program source as well as = = standards for linking to external entities, like another part of the = source providing file name and line number or to any other document; all= = of that embedded in comments (obviously). We already talked here in this usenet, about some Java world annotation = = conventions in comments which could be worth applied as a standard = convention in many other places, like Ada source (these conventions are = = already become famous in C, Python, JavaScript and others worlds). But I= = don't believe this could be enough, as this provide nothing dedicated to= = token based folding or links to external entities (the question is in so= me = way related to a kind of derivative interpretation of literate = programming). If any one know any track, =E2=80=A6 welcome -- = Si les chats miaulent et font autant de vocalises bizarres, c=E2=80=99es= t pas pour = les chiens. =E2=80=9CI am fluent in ASCII=E2=80=9D [Warren 2010]