[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Feature request: generate documentation from C files
From: |
Eli Zaretskii |
Subject: |
Re: Feature request: generate documentation from C files |
Date: |
Sun, 02 Nov 2003 18:49:07 +0200 |
> From: Simon Josefsson <address@hidden>
> Date: Sun, 02 Nov 2003 16:41:13 +0100
> >
> > Oops, sorry, I meant "C-h S".
>
> The docstring says it only looks in 'the relevant manuals', which
> appear to depend on which major mode I'm in.
True. Is that a problem?
> How can I add, e.g., the
> libidn manual, to the list of 'relevant manuals' for c-mode?
Use `info-lookup-maybe-add-help' for that. See its doc string and the
examples of usage near the end of info-look.el in the Emacs distro.
> Yes, although I'm not sure I see the need to express @xrefs within a C
> source comment, what meaning would it have when you output man pages,
> HTML, docbook etc?
You typically want to refer to other functions' docs. Man pages have
the "SEE ALSO" section for that; in HTML, simply produce a link; in
Texinfo, generate an @xref. I don't know docbook, so I cannot help
there.
Re: Feature request: generate documentation from C files, Karl Berry, 2003/11/02