[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[dev-serveez] Re: Serveez Documentation Review

From: stefan
Subject: [dev-serveez] Re: Serveez Documentation Review
Date: Thu, 18 Oct 2001 13:57:10 +0200 (CEST)

On Thu, 18 Oct 2001, J C Fitzgerald wrote:

> > One more hint: Most of the serveez API documentation gets automatically
> > created from the source code comments. If you have a specific question
> > about this process you are welcome to ask.
> > 
> Ah, I hadn't realised this.  I guess some of the changes will be further
> afield than just the documentation directory.  Where is the code which
> builds the documentation from the comments?

Ok. There are two main documentation files. These are `serveez.texi' and
`' in the doc/ directory.

The `serveez.texi' file is plain texi format. But it includes a file named
`guile-api.texi' which stems from `'.

The `*' files ( and go
through an AWK script named `serveez-api.awk' which produces an SED script
from a set of input *.c and/or *.h files (source code). The resulting SED
files contain simple replacement statements. When piping the `*'
files through these kind of SED files you get `*.texi' files.

e.g. if you write something like SVZ_MALLOC_DEFUN in a `*' file
and have a function named svz_malloc() in a `*.c' file you will get the
function definition including the corresponding comment in the `*.texi'

$ awk -f serveez-api.awk ../src/libserveez/alloc.c > alloc.sed
$ sed -f alloc.sed < > alloc.texi

Anyway, this is mainly used in the API documentation, not in the user
manual (except some guile functionality).

Were I able to clarify it a bit ?


reply via email to

[Prev in Thread] Current Thread [Next in Thread]