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-Language: ENGLISH,ASCII-7-bit X-Google-Thread: 103376,ce4dce67fc9f3cc4 X-Google-Attributes: gid103376,public X-Google-ArrivalTime: 2003-09-03 03:12:02 PST Path: archiver1.google.com!news1.google.com!newsfeed.stanford.edu!headwall.stanford.edu!newshub.sdsu.edu!elnk-nf2-pas!elnk-pas-nf1!newsfeed.earthlink.net!west.cox.net!east.cox.net!peer01.cox.net!cox.net!news-hub.cableinet.net!blueyonder!btnet-peer!btnet-peer0!btnet-feed5!btnet!news.btopenworld.com!not-for-mail From: "Martin Dowie" Newsgroups: comp.lang.ada Subject: Re: Adabrowse: What config setup do people use? Date: Wed, 3 Sep 2003 10:11:58 +0000 (UTC) Organization: BT Openworld Message-ID: References: NNTP-Posting-Host: host81-129-24-23.in-addr.btopenworld.com X-Trace: hercules.btinternet.com 1062583918 6860 81.129.24.23 (3 Sep 2003 10:11:58 GMT) X-Complaints-To: news-complaints@lists.btinternet.com NNTP-Posting-Date: Wed, 3 Sep 2003 10:11:58 +0000 (UTC) X-Newsreader: Microsoft Outlook Express 6.00.2800.1158 X-MSMail-Priority: Normal X-Priority: 3 X-MIMEOLE: Produced By Microsoft MimeOLE V6.00.2800.1165 Xref: archiver1.google.com comp.lang.ada:42094 Date: 2003-09-03T10:11:58+00:00 List-Id: "chris" wrote in message news:bC75b.4578$bC1.3733@newsfep4-winn.server.ntli.net... > Hi, > > I'm toying with Adabrowse just now and am trying to make a cfg file for > project documentation. Does anyone have samples of the markup they use > and the cfg they use with it? It'd be helpful to help understand how it > works. > > I'm looking to document exceptions thrown by subprograms and output > something a bit closer to javadoc (with summaries and more detailed > sections)... but am not sure where to start. (I'm not asking for help > specifically to generate this sort of thing, just a prod to get started). I use a config file containing: Format."--!" = pre Index.Constants.Title = Constant Index Index.Constants.Rule = constant Index.Exceptions.Title = Exception Index Index.Exceptions.Rule = exception but there is nothing in AdaBrowse that will let you list where each exception is raised.