[Top][All Lists]

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

Re: doc snarfing

From: Peter S. Christopher
Subject: Re: doc snarfing
Date: Fri, 31 Oct 2003 13:09:27 -0600 (CST)

Hi Bruce,

        Thanks for the feedback. I have two questions for you:

a) I couldn't find any google hits for JavaDoc and C/C++; does JavaDoc
work with C-syntax?

b) Given that snarfing is ugly-ish, how does the libguile team strip
the documentation out of the source code? Particularly, how does one fetch
the SCM_SNARF_DOCS data from source file?

Thanks again,

On Fri, 31 Oct 2003, Bruce Korb wrote:

> "Peter S. Christopher" wrote:
> > 
> > Hi listers,
> > 
> >         I'm wondering if somebody could please give me some suggestions on
> > how to snarf out the documentation for some of my own code. I'd really
> > like to include documentation with the code and strip it out of the code
> > using the same method that is used for the libguile code. Thanks for the
> > help.
> Don't.  It is really kludgy.  Use Java doc, there are a lot of tools
> that support it.  Snarfing is ugly and used because it is also used
> to extract code.  If that is what you want (both code and doc extraction),
> then try my tool.  You can pull the strings, massage them and insert
> them whereever and however you want to string them together:
> Good luck.

reply via email to

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