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=0.7 required=5.0 tests=BAYES_00,MSGID_RANDY autolearn=no autolearn_force=no version=3.4.4 X-Google-Language: ENGLISH,ASCII-7-bit X-Google-Thread: 103376,c6e6cdf6ff50e684 X-Google-Attributes: gid103376,public X-Google-ArrivalTime: 2001-02-11 16:38:01 PST Path: supernews.google.com!sn-xit-03!supernews.com!nntp2.deja.com!nnrp1.deja.com!not-for-mail From: Robert Dewar Newsgroups: comp.lang.ada Subject: Re: Representation clause for enumeratives Date: Mon, 12 Feb 2001 00:24:40 GMT Organization: Deja.com Message-ID: <967ag2$sd6$1@nnrp1.deja.com> References: <95tqbh$ag7$1@nnrp1.deja.com> <962n4v$fmg$1@nnrp1.deja.com> <27eh6.3787$y03.254014@news.flash.net> <963tos$atu$1@nnrp1.deja.com> <9Dlh6.4497$y03.296626@news.flash.net> <9657rb$biv$1@nnrp1.deja.com> <86pugpbct5.fsf@acm.org> NNTP-Posting-Host: 205.232.38.14 X-Article-Creation-Date: Mon Feb 12 00:24:40 2001 GMT X-Http-User-Agent: Mozilla/4.61 [en] (OS/2; U) X-Http-Proxy: 1.0 x70.deja.com:80 (Squid/1.1.22) for client 205.232.38.14 X-MyDeja-Info: XMYDJUIDrobert_dewar Xref: supernews.google.com comp.lang.ada:5134 Date: 2001-02-12T00:24:40+00:00 List-Id: In article <86pugpbct5.fsf@acm.org>, Laurent Guerby wrote: > May be more users would update and reread documentation if > each new manual had a "new and updated" section. (I already > made this remark has a customer BTW, so this is not only > "free user" wishlist ;-) The features file is intended to exactly satisfy this need. What we see most customers doing is to read through the features file (it's pretty long, but that's because there are a lot of new features :-) Each feature has a few line description, and if you are interested in finding more, then you can look in the manual for details. > You can't expect users to reread a few hundred (boring even > if well-written) pages they've already mostly read every six > monthes and do the mental diff (if it's even possible). Exactly, that's why we provide the features file. > The release notes for the technical part is very good, why > not do the same for the documentation? > > I really hope the GNAT 3.14 documentation will have such a > section, otherwise I probably won't read it, and this will > nullify GNAT people work on it (at least for me). You should read through the features file. That ends up being a guide for new documentation features as well as new technical features in the compiler. For example, here is one of several entries in the 3.14 features file relating to documentation: NF-314-7718-001 Linker_Options extensions now documented The documentation (GNAT Reference Manual) has been enhanced to contain full documentation of the GNAT implementation of the Linker_Options pragma. GNAT allows multiple arguments, and also allows the use of ASCII.NUL to separate arguments in a single string. Robert Dewar Ada Core Technologies Sent via Deja.com http://www.deja.com/