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.9 required=5.0 tests=BAYES_00 autolearn=unavailable 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!weretis.net!feeder1.news.weretis.net!news.roellig-ltd.de!open-news-network.org!news.muarf.org!nntpfeed.proxad.net!proxad.net!feeder1-2.proxad.net!usenet-fr.net!nerim.net!novso.com!newsfeed.xs4all.nl!newsfeed4.news.xs4all.nl!xs4all!newspeer1.nac.net!border2.nntp.dca1.giganews.com!Xl.tags.giganews.com!border1.nntp.dca1.giganews.com!nntp.giganews.com!buffer1.nntp.dca1.giganews.com!local2.nntp.dca.giganews.com!nntp.posted.internetamerica!news.posted.internetamerica.POSTED!not-for-mail NNTP-Posting-Date: Sat, 03 Jan 2015 11:55:18 -0600 From: Robert Love Newsgroups: comp.lang.ada Date: Sat, 3 Jan 2015 11:55:19 -0600 Message-ID: <2015010311551989521-rblove@airmailnet> References: <131i5ys2ld33h.zw6rkkzrikjp.dlg@40tude.net> <2015010217513268738-rblove@airmailnet> <1j936uueq0hsi.1lid0tcufi8no$.dlg@40tude.net> MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1; format=flowed Content-Transfer-Encoding: 8bit Subject: Re: I Have a problem with GPS documentation generation User-Agent: Unison/2.1.10 X-Usenet-Provider: http://www.giganews.com NNTP-Posting-Host: 98.194.39.33 X-Trace: sv3-zzkCdI6NlhODveiUCKQ8k8wJjJeUH1gg6SryUbzT90hF+zeNcrg7sPLPd5Wq1MDjtNDAg8z8sSiVprz!coGis9wKpM0RtzE/vOfnlhraiZbuXVOttSGarPX/DMMy2rDVNWlDvwsB64hIEzc9Pnd3Va9lAB6B!rw== X-Complaints-To: abuse@airmail.net X-DMCA-Complaints-To: abuse@airmail.net X-Abuse-and-DMCA-Info: Please be sure to forward a copy of ALL headers X-Abuse-and-DMCA-Info: Otherwise we will be unable to process your complaint properly X-Postfilter: 1.3.40 X-Original-Bytes: 2198 Xref: news.eternal-september.org comp.lang.ada:24328 Date: 2015-01-03T11:55:19-06:00 List-Id: 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?