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.3 required=5.0 tests=BAYES_00,
	REPLYTO_WITHOUT_TO_CC autolearn=no autolearn_force=no version=3.4.4
Path: 
 eternal-september.org!reader01.eternal-september.org!reader02.eternal-september.org!news.eternal-september.org!mx02.eternal-september.org!feeder.eternal-september.org!aioe.org!.POSTED!not-for-mail
From: "Dmitry A. Kazakov" <mailbox@dmitry-kazakov.de>
Newsgroups: comp.lang.ada
Subject: Re: I Have a problem with GPS documentation generation
Date: Sat, 3 Jan 2015 19:13:41 +0100
Organization: cbb software GmbH
Message-ID: <1dusw0lwscgp9$.6faty551u696$.dlg@40tude.net>
References: <Wjtow.147331$5r4.118698@fx31.iad>
 <131i5ys2ld33h.zw6rkkzrikjp.dlg@40tude.net>
 <2015010217513268738-rblove@airmailnet>
 <1j936uueq0hsi.1lid0tcufi8no$.dlg@40tude.net>
 <2015010311551989521-rblove@airmailnet>
Reply-To: mailbox@dmitry-kazakov.de
NNTP-Posting-Host: F0bZVcKBguFJO8b9hCfgbw.user.speranza.aioe.org
Mime-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
X-Complaints-To: abuse@aioe.org
User-Agent: 40tude_Dialog/2.0.15.1
X-Notice: Filtered by postfilter v. 0.8.2
Xref: news.eternal-september.org comp.lang.ada:24329
Date: 2015-01-03T19:13:41+01:00
List-Id: <comp.lang.ada>

On Sat, 3 Jan 2015 11:55:19 -0600, Robert Love wrote:

> On 2015-01-03 06:54:38 +0000, Dmitry A. Kazakov said:
> 
>> On Fri, 2 Jan 2015 17:51:32 -0600, Robert Love wrote:
>> 
>>> On 2014-12-30 09:09:51 +0000, Dmitry A. Kazakov said:
>>> 
>>>> On Tue, 30 Dec 2014 00:25:37 -0800, Hubert wrote:
>>>> 
>>>>> Generating documentation for my project doesn't quite work from GPS for
>>>>> me.
>>>> 
>>>> Generated documentation is not documentation, IMO.
>>> 
>>> So do you have a prefererred documentation writing system?
>> 
>> I prefer human written documentation. [Anything that can be generated
>> should be done by the IDE on the fly]
> 
> The two I mentioned are human written.  And they produce HTML output 
> among other formats.   If you go the official python documentation site 
> you can see Sphinx produced HTML.

I use FrontPage 2003.

>  I believe the Ada Core documentation was written in Texinfo at one time.

I don't know. At some point they seem switched documentation tools for
GtkAda documentation with a great quality loss.

-- 
Regards,
Dmitry A. Kazakov
http://www.dmitry-kazakov.de