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.3 required=5.0 tests=BAYES_00,MAILING_LIST_MULTI, REPLYTO_WITHOUT_TO_CC autolearn=no autolearn_force=no version=3.4.4 X-Google-Language: ENGLISH,ASCII-7-bit X-Google-Thread: 103376,2a5467dded7223af X-Google-Attributes: gid103376,public X-Google-ArrivalTime: 2002-11-07 15:55:03 PST Path: archiver1.google.com!news1.google.com!newsfeed.stanford.edu!logbridge.uoregon.edu!fr.usenet-edu.net!usenet-edu.net!enst.fr!not-for-mail From: "Robert C. Leif" Newsgroups: comp.lang.ada Subject: RE: Building documentation from comments Date: Thu, 7 Nov 2002 15:54:09 -0800 Organization: ENST, France Sender: comp.lang.ada-admin@ada.eu.org Message-ID: Reply-To: comp.lang.ada@ada.eu.org NNTP-Posting-Host: marvin.enst.fr Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: avanie.enst.fr 1036713303 83175 137.194.161.2 (7 Nov 2002 23:55:03 GMT) X-Complaints-To: usenet@enst.fr NNTP-Posting-Date: Thu, 7 Nov 2002 23:55:03 +0000 (UTC) Return-Path: X-Envelope-From: rleif@rleif.com X-Envelope-To: X-Priority: 3 (Normal) X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook, Build 10.0.4024 Importance: Normal In-Reply-To: X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2600.0000 Errors-To: comp.lang.ada-admin@ada.eu.org X-BeenThere: comp.lang.ada@ada.eu.org X-Mailman-Version: 2.0.13 Precedence: bulk List-Unsubscribe: , List-Id: comp.lang.ada mail<->news gateway List-Post: List-Help: List-Subscribe: , Errors-To: comp.lang.ada-admin@ada.eu.org X-BeenThere: comp.lang.ada@ada.eu.org Xref: archiver1.google.com comp.lang.ada:30561 Date: 2002-11-07T15:54:09-08:00 Returning to the title of this thread, "Building documentation from comments", one might wish to replace the comment with the equivalent of an XML Annotation or Annotations.Documentation. The Ada translation of the XML model would be to create an Annotations Package and a Documentation child package. These packages would included an instantiation of a bounded string type of the appropriate size to be a Copyright(Copyright_Bd). Each package then can have a group of annotations that include the Copyright_Bd, Author(s) Revision_Dates etc. These can even have default values or when appropriate point to a URL. The use of a URL has the advantage of permitting direct access to the text of large legal documents without cluttering the code. Bob Leif