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,81054609038e88e3
X-Google-Attributes: gid103376,public
X-Google-Language: ENGLISH,ASCII-7-bit
Path: 
 g2news1.google.com!news1.google.com!news.glorb.com!wns13feed!worldnet.att.net!attbi_s52.POSTED!53ab2750!not-for-mail
From: "Steve" <nospam_steved94@comcast.net>
Newsgroups: comp.lang.ada
References: <2sqmccF1oit5sU1@uni-berlin.de> <C02ad.336517$mD.328199@attbi_s02>
 <VdOdnQV68tGu3_TcRVn-rQ@gbronline.com>
Subject: Re: Literate Programming in Ada, AdaDoc, AdaBrowse
X-Priority: 3
X-MSMail-Priority: Normal
X-Newsreader: Microsoft Outlook Express 6.00.2800.1437
X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2800.1441
Message-ID: <decad.215955$MQ5.86558@attbi_s52>
NNTP-Posting-Host: 24.21.42.251
X-Complaints-To: abuse@comcast.net
X-Trace: attbi_s52 1097420809 24.21.42.251 (Sun, 10 Oct 2004 15:06:49 GMT)
NNTP-Posting-Date: Sun, 10 Oct 2004 15:06:49 GMT
Organization: Comcast Online
Date: Sun, 10 Oct 2004 15:06:49 GMT
Xref: g2news1.google.com comp.lang.ada:4994
Date: 2004-10-10T15:06:49+00:00
List-Id: <comp.lang.ada>


"Wes Groleau" <groleau+news@freeshell.org> wrote in message
news:VdOdnQV68tGu3_TcRVn-rQ@gbronline.com...
> Steve wrote:
>
> > 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.
> >
> > A way to do this is to maintain the source code as text with special
markers
> > referencing the comments, and maintain the comments in a separate file
or
> > database.  The approach has the advantage that the compiler doesn't have
to
> > deal with the comments and the source may be viewed without the comments
> > using a different editor.  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.
>
> Already available:
>

Great!
Where can I find it?
I'm running on Windows 2000.

Steve
(The Duck)

> fancy editor    = WYSIWYG HTML or XML editor
> viewer          = web browser
> special markers = XML tags
>
> This can be done in the style I earlier proposed,
> where the code is extracted from the file for compiling.
> But it can also be done where the HTML/XML appears ONLY
> in the code comments.  In the latter, however, it may be
> difficult to make right margins (indents) look right.
>
> -- 
> Wes Groleau
>
> A pessimist says the glass is half empty.
>
> An optimist says the glass is half full.
>
> An engineer says somebody made the glass
>         twice as big as it needed to be.