* Documentation
@ 2010-07-06 7:59 Michael Lucy
2010-07-06 9:21 ` Documentation Klaus Schilling
0 siblings, 1 reply; 3+ messages in thread
From: Michael Lucy @ 2010-07-06 7:59 UTC (permalink / raw)
To: guile-devel
What form should I be writing external documentation in? The guile
manual on the website is in fairly straightforward html; should I be
writing in that?
^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: Documentation
2010-07-06 7:59 Documentation Michael Lucy
@ 2010-07-06 9:21 ` Klaus Schilling
2010-07-06 21:40 ` Documentation Ludovic Courtès
0 siblings, 1 reply; 3+ messages in thread
From: Klaus Schilling @ 2010-07-06 9:21 UTC (permalink / raw)
To: MichaelGLucy; +Cc: guile-devel
From: Michael Lucy <MichaelGLucy@Gmail.com>
Subject: Documentation
Date: Tue, 6 Jul 2010 02:59:18 -0500
> What form should I be writing external documentation in? The guile
> manual on the website is in fairly straightforward html; should I be
> writing in that?
>
Skribilo would be nice.
Klaus Schilling
^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: Documentation
2010-07-06 9:21 ` Documentation Klaus Schilling
@ 2010-07-06 21:40 ` Ludovic Courtès
0 siblings, 0 replies; 3+ messages in thread
From: Ludovic Courtès @ 2010-07-06 21:40 UTC (permalink / raw)
To: guile-devel
Hi,
Klaus Schilling <schilling.klaus@web.de> writes:
> From: Michael Lucy <MichaelGLucy@Gmail.com>
> Subject: Documentation
> Date: Tue, 6 Jul 2010 02:59:18 -0500
>
>> What form should I be writing external documentation in? The guile
>> manual on the website is in fairly straightforward html; should I be
>> writing in that?
>>
> Skribilo would be nice.
Indeed. ;-)
But Guile’s manual, as for the rest of GNU, is written in Texinfo: see
doc/ref/guile.texi and siblings. The HTML and PDF files on the web site
are generated from Texinfo.
You should use Texinfo for the PEG manual, e.g., write a section for PEG
that would become part of Guile’s manual (assuming it’s not too large).
Texinfo’s syntax is relatively simple. Try “info texinfo” for the
manual.
Thanks,
Ludo’.
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2010-07-06 21:40 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2010-07-06 7:59 Documentation Michael Lucy
2010-07-06 9:21 ` Documentation Klaus Schilling
2010-07-06 21:40 ` Documentation Ludovic Courtès
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).