[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Problem with autogsdoc and GSFusedSilica.h
From: |
Chris B. Vetter |
Subject: |
Re: Problem with autogsdoc and GSFusedSilica.h |
Date: |
Thu, 19 Dec 2002 09:29:13 -0800 |
On Thu, 19 Dec 2002 17:07:32 +0000
Richard Frith-Macdonald <address@hidden> wrote:
> Nicola's tutorials are kept in TeX by his personal preference. I'm in
> sympathy with the approach of using TeX for non-automated
> documentation, as it does permit you to get a very good effect.
> Other stuff uses texinfo to produce pretty printed output as well as
> info output ... because info is the official FSF documentation format,
> but is too ugly for most people to read. This is mostly used for
> 'official' release notes and suchlike.
> And of course autogsdoc is good for reference documentation ...
I'll leave that open to discussion, but personally, I like autogsdoc.
> Frankly, it's so hard to get people to contribute documentation that
> I'm not likely to complain about any format they do it in (I'll make
> an exception for ms-word).
Heh, very true. I'm _not_ complaining about the usage of TeX, though I
can imagine long faces if/when people (especially those new to GNUstep)
try to create the documenation and see it fail because TeX isn't
installed... I made a quick check, and as far as I can see, TeX isn't
even mentioned anywhere as a requirement to create the docu. It should
be at least in GNUstep-HOWTO, even a side-note would be fine.
--
Chris
- Re: removing the 'make install'-->'make all' dependency, (continued)
- Re: Header cleanliness [was: removing the 'make install'-->'makeall' dependency], Alexander Malmberg, 2002/12/11
- Re: removing the 'make install'-->'make all' dependency, Alexander Malmberg, 2002/12/11
- Re: removing the 'make install'-->'make all' dependency, Alexander Malmberg, 2002/12/16
- Re: removing the 'make install'-->'make all' dependency, David Ayers, 2002/12/17
- Re: removing the 'make install'-->'make all' dependency, Nicola Pero, 2002/12/19
- Problem with autogsdoc and GSFusedSilica.h, Chris B. Vetter, 2002/12/19
- Re: Problem with autogsdoc and GSFusedSilica.h, Richard Frith-Macdonald, 2002/12/19
- Re: Problem with autogsdoc and GSFusedSilica.h,
Chris B. Vetter <=
- Re: Problem with autogsdoc and GSFusedSilica.h, Nicola Pero, 2002/12/19
- Re: Problem with autogsdoc and GSFusedSilica.h, Chris B. Vetter, 2002/12/19
- Re: Problem with autogsdoc and GSFusedSilica.h, Nicola Pero, 2002/12/20
- Re: Problem with autogsdoc and GSFusedSilica.h, Chris B. Vetter, 2002/12/20
- Re: Header cleanliness [was: removing the 'make install'-->'makeall' dependency], Alexander Malmberg, 2002/12/16
- Re: Header cleanliness [was: removing the 'makeinstall'-->'makeall' dependency], David Ayers, 2002/12/17
- Re: Header cleanliness [was: removing the 'makeinstall'-->'makeall'dependency], Alexander Malmberg, 2002/12/17
- Re: Header cleanliness [was: removing the 'makeinstall'-->'makeall'dependency], David Ayers, 2002/12/17
- Re: Header cleanliness [was: removing the 'makeinstall'-->'makeall' dependency], Nicola Pero, 2002/12/19
- Re: Header cleanliness [was: removing the 'make install'-->'makeall'dependency], Alexander Malmberg, 2002/12/22