Re: [gnuspeech-contact] Document formats & repository

[David Hill]

Hi Paul,

Many thanks. Go for it.

The Monet manual source on SVN is the same as the one on my university web site 
and reflects the NeXT version, of course.

I am moving to putting relevant documentation in all three trunks (NeXT, OS X 
and GNUStep). I should get the "Synthesizer" manual and other stuff in there, 
most appropriately in the NeXT trunk, since that is what the manual currently 
reflects.

Feel free to send your finished revised Monet manual to me if you'd like it 
proofed before we put it in the repository. It will be interesting to see 
"Docbook" ("docbook" ?) in action.

All good wishes.

david

On Apr 5, 2011, at 6:19 PM, Paul Tyson wrote:

> I volunteer to take a crack at putting the Monet manual into docbook
> XML.  We can use the standard docbook xsl stylesheets at first, then I
> can tweak them to get closer to your preferred output--both HTML and
> PDF.  I could also convert the Synthesizer manual.
> 
> If we get these into shape they could serve also as design documents for
> the remaining porting effort and for unifying the osx and gnustep
> codebases as much as possible.
> 
> David, should I use the Monet manual sources from SVN, or is your
> website more current?  The Synthesizer manual appears to be only on your
> website, not in SVN.
> 
> Regards,
> --Paul
> 
> On Tue, 2011-04-05 at 11:28 -0700, David Hill wrote:
>> Hi Tobias and Paul,
>> 
>> 
>> Having given this a little more thought,  I shall (we should) continue
>> to use HTML --> XML as the basis for producing future documentation,
>> which means I probably need to give docbook a good hard look as the
>> actual vehicle. I usually write HTML directly, rather than using some
>> package that generates it. It usually produces excellent results with
>> smaller files that load really fast.
>> 
>> 
>> Many thanks for all the input.
>> 
>> 
>> All good wishes.
>> 
>> 
>> david
>> ---------
>> David Hill
>> address@hidden
>> http://savannah.gnu.org/projects/gnuspeech
>> --------
>> The only function of economic forecasting is to make astrology look
>> respectable. (J.K. Galbraith)
>> --------
>> 
>> On Apr 4, 2011, at 10:54 PM, Tobias Schrank wrote:
>> 
>>> Hi!
>>> 
>>> Am Montag, den 04.04.2011, 19:21 -0500 schrieb Paul Tyson:
>>>> A lot of docbook-based
>>>> pages are plain-looking, but they can be dressed up quite a bit
>>>> with
>>>> custom stylesheets.  Nevertheless there are limits, and it is
>>>> difficult
>>>> to have total layout control.
>>> 
>>> Due to being xml docbook can be easily converted to other systems
>>> like
>>> tex.  So aesthetics shouldn't be a problem.
>>> 
>>> Am Montag, den 04.04.2011, 18:09 -0700 schrieb David Hill:
>>>> If I were producing mathematical text books I probably would have
>>>> to
>>>> use TeX
>>> 
>>> I wouldn't consider tex inappropriate for documentation but I argued
>>> in
>>> favour of docbook because it's easier to process (different output
>>> formats, etc.).
>>> 
>>> Am Montag, den 04.04.2011, 18:09 -0700 schrieb David Hill:
>>>> Your feedback and suggestions are much appreciated, but I haven't
>>>> seen
>>>> anything to change my view
>>> 
>>> Probably it depends on your way of life.  By using markup-based
>>> things
>>> all the time maybe I've just lost my sense for doing it any other
>>> way.
>>> 
>>> Regards, Tobias
>>> _______________________________________________
>>> gnuspeech-contact mailing list
>>> address@hidden
>>> http://lists.gnu.org/mailman/listinfo/gnuspeech-contact
>>> 
>> 
>> 
>