Re: Feature request: generate documentation from C files

[Eli Zaretskii]

> From: Simon Josefsson <address@hidden>
> Date: Sun, 02 Nov 2003 14:52:42 +0100
> >
> > We still need some markup for references to other parts of the docs,
> > and for references to symbols: names of functions, variables, and
> > arguments/meta-syntactic elements.
> 
> Yes, although I think %NULL, strlen(), @string etc is less obtrusive
> than the texinfo/SGML/whatever markup, within a C source comment.

They might be less obtrusive, but they are not enough to express an
xref to another document.

They _may_ be enough for @code, @var, and the like, but we need to
define and agree upon replacements.  xrefs require more complex
markup.

Btw, using "strlen()" is simply a bad habit: it looks like a call to
`strlen' with no arguments, which is not what you want.