[Ns-developers] some ns-3 documentation proposals

[Mathieu Lacage]

On Thu, 2007-12-13 at 17:00 -0800, craigdo at ee.washington.edu wrote:
> > I think that it would be probably much easier to 
> > just move everything to doxygen, including the 
> > tutorial.
> 
> I'm in the process of converting the remaining tutorial pieces to .texi and
> adding a bunch more content *now*, so I would hate to see another change of
> direction while I'm still in the middle of changing from the old direction.
> ;-)

pain :/

> In the long run, I'd be fine moving everything to Doxygen if it can do what
> we want.  Having a single model for documentation appeals to my internal

I believe it can. If you can point me to the texi source you have, I can
verify that dox has the matching tags.

> need for logic, consistency, and a simple book of instructions.  I'll be
> perfectly happy to go with whatever markup language we want -- I have no
> religious constraints.  However, as someone I know has said in the past,
> "let's just make a decision and stick with it."  :-/

Agreed. I am clearly to blame for not answering tom's emails about this
and suggesting we stick to a single tool before :/ 

Mathieu