comp.lang.ada
 help / color / mirror / Atom feed
From: Robert Love <rblove@airmail.net>
Subject: Re: I Have a problem with GPS documentation generation
Date: Sat, 3 Jan 2015 11:55:19 -0600
Date: 2015-01-03T11:55:19-06:00	[thread overview]
Message-ID: <2015010311551989521-rblove@airmailnet> (raw)
In-Reply-To: 1j936uueq0hsi.1lid0tcufi8no$.dlg@40tude.net

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 believe the Ada Core 
documentation was written in Texinfo at one time.

> 
>> - Gnu Texinfo
>> - Sphinx
> 
> HTML?

Is anybody using org-mode for project documenation other than org-mode itself?

  reply	other threads:[~2015-01-03 17:55 UTC|newest]

Thread overview: 10+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2014-12-30  8:25 I Have a problem with GPS documentation generation Hubert
2014-12-30  9:09 ` Dmitry A. Kazakov
2015-01-02 23:51   ` Robert Love
2015-01-03  6:54     ` Dmitry A. Kazakov
2015-01-03 17:55       ` Robert Love [this message]
2015-01-03 18:13         ` Dmitry A. Kazakov
2014-12-30 10:41 ` Hubert
2014-12-30 10:48 ` Hubert
2015-01-01 11:31   ` Blady
2015-01-03  2:19     ` Hubert
replies disabled

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox