Re: TexInfo -> Doxygen

[Ben Abbott]

On Jan 23, 2011, at 7:33 PM, Jordi Gutiérrez Hermoso wrote:

> On 23 January 2011 16:53, Sean Young <address@hidden> wrote:
> 
>> Jordi has suggested that the current TexInfo documentation be moved
>> to Doxygen format inside the c++ files
> 
> Before someone kills me for suggesting to a newcomer that we drop
> TeXinfo, I didn't quite mean that. I only said that probably the
> incomplete documentation currently under doc/liboctave should probably
> be inlined into the C++ sources with Doxygen. We already publish
> bare-bones Doxygen output in octave.sf.net, and having the docstrings
> next to the source will probably motivate us to write more (and also
> get rid of my personal beef with "undocumented internal function").
> 
> - Jordi G. H.

I've never used Doxygen, but I'd like the idea of a systemic approach to 
documenting how the source code works.

Which is entirely different that what the texinfo stuff does. Which is to 
document Octave's syntax. 

is the idea to have the texinfo stuff present in the doxygen output?

Ben