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.9 required=5.0 tests=BAYES_00,MAILING_LIST_MULTI autolearn=unavailable autolearn_force=no version=3.4.4 X-Google-Thread: 103376,81054609038e88e3 X-Google-Attributes: gid103376,public X-Google-Language: ENGLISH,ASCII-7-bit Path: g2news1.google.com!news2.google.com!proxad.net!freenix!enst.fr!melchior!cuivre.fr.eu.org!melchior.frmug.org!not-for-mail From: Stephen Leake Newsgroups: comp.lang.ada Subject: Re: Literate Programming in Ada, AdaDoc, AdaBrowse Date: 10 Oct 2004 11:20:03 -0400 Organization: Cuivre, Argent, Or Message-ID: References: <2sqmccF1oit5sU1@uni-berlin.de> NNTP-Posting-Host: lovelace.ada-france.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: melchior.cuivre.fr.eu.org 1097421647 95938 212.85.156.195 (10 Oct 2004 15:20:47 GMT) X-Complaints-To: usenet@melchior.cuivre.fr.eu.org NNTP-Posting-Date: Sun, 10 Oct 2004 15:20:47 +0000 (UTC) To: comp.lang.ada@ada-france.org Return-Path: In-Reply-To: User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.3 X-Virus-Scanned: by amavisd-new-20030616-p10 (Debian) at ada-france.org X-BeenThere: comp.lang.ada@ada-france.org X-Mailman-Version: 2.1.4 Precedence: list List-Id: "Gateway to the comp.lang.ada Usenet newsgroup" List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Xref: g2news1.google.com comp.lang.ada:4995 Date: 2004-10-10T11:20:03-04:00 "Steve" writes: > Just to share another hairbrained scheme regarding documentation. > > What I would like to see is a fancy programming editor that allows you to > include text, graphics, spreadsheets, etc., in comments. I would find that hard to read. This is what hyperlinks are for; put the URL in the code, an have your IDE bring up the referenced document at a keystroke (or mouseclick if you insist :). Works quite well for me. > A way to do this is to maintain the source code as text with special > markers IE, URLs. > referencing the comments, and maintain the comments in a separate > file or database. Whatever format your IDE supports. In my case, that's whatever format Windows supports, since it's easy for Emacs to start an external tool to show any Windows format known to the Windows registry. > The approach has the advantage that the compiler doesn't have to > deal with the comments Yes > and the source may be viewed without the comments using a different > editor. Yes. > It has the disadvantage that a special editor is required to edit > the code along with the comments, and since the code and comments > are in separate files, there is always potential of losing the > comment files. The editor could be made to output the source with > comments in a standard format: html, pdf, etc. Nothing special here, just URLs and MS Windows. I assume there is something similar for X Windows; I haven't tried. > I'm one of those guys that likes to draw a lot of diagrams > describing code. Good. > It is often hard to assemble comments in code that do the diagram > justice. Try URLs. -- -- Stephe