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.9 required=5.0 tests=BAYES_00,FORGED_GMAIL_RCVD, FREEMAIL_FROM autolearn=no autolearn_force=no version=3.4.4 X-Google-Thread: a07f3367d7,887292c91e10d3fd X-Google-Attributes: gida07f3367d7,public,usenet X-Google-NewGroupId: yes X-Google-Language: ENGLISH,ASCII-7-bit Path: g2news2.google.com!postnews.google.com!j9g2000vbr.googlegroups.com!not-for-mail From: Maciej Sobczak Newsgroups: comp.lang.ada Subject: Re: Ada documentation tools. Date: Mon, 15 Nov 2010 05:06:54 -0800 (PST) Organization: http://groups.google.com Message-ID: <8cdfee44-a675-46a3-b850-77661400dbc8@j9g2000vbr.googlegroups.com> References: <6f234690-e21d-4d78-8dba-c017976029e9@z17g2000prz.googlegroups.com> <80dacf60-a610-4004-9298-69751bbfcaea@j12g2000prm.googlegroups.com> NNTP-Posting-Host: 137.138.182.236 Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 X-Trace: posting.google.com 1289826414 6028 127.0.0.1 (15 Nov 2010 13:06:54 GMT) X-Complaints-To: groups-abuse@google.com NNTP-Posting-Date: Mon, 15 Nov 2010 13:06:54 +0000 (UTC) Complaints-To: groups-abuse@google.com Injection-Info: j9g2000vbr.googlegroups.com; posting-host=137.138.182.236; posting-account=bMuEOQoAAACUUr_ghL3RBIi5neBZ5w_S User-Agent: G2/1.0 X-HTTP-UserAgent: Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US; rv:1.9.2.10) Gecko/20100914 Firefox/3.6.10,gzip(gfe) Xref: g2news2.google.com comp.lang.ada:16477 Date: 2010-11-15T05:06:54-08:00 List-Id: On 15 Lis, 13:29, AdaMagica wrote: > > Formatting. Presentation is not only about content. > > Hm. How can a tool improve bad formatting in the code? Every reasonable code editor does it without any problem. Some people actually never format their code by hand and rely on tools to do that for them. > Format the code > correctly in the first place. Can I use a tool to do it? And, while we're at it, what does it mean "correctly"? Correctly according to your preferences or to mine? Tools can also automate the transition between different conventions. But formatting is not only about whitespace. It is also about colors, fonts, text flow, and so on. Code can be also printed or rendered in HTML browser - not necessarily as standalone content, but also as part of wiki pages, docs, etc. There are plenty of ways to "consume" the source code outside of the IDE and visualizing its content in many different ways is an important part of delivering the source code to users. Raw spec is not enough. -- Maciej Sobczak * http://www.inspirel.com