Re: [dev] suckless document generator for C code

2012-05-11 Thread Amit Uttamchandani
On Fri, May 11, 2012 at 06:34:53PM +, Bjartur Thorlacius wrote: > On 5/11/12, Amit Uttamchandani wrote: > > The problem right now is the APIs are kept in a MS Word Office 2010 > > .docx file, which doesn't work right with LibreOffice. > > > I smiled - `til I realized you weren't joking. > Ye

Re: [dev] suckless document generator for C code

2012-05-11 Thread Christoph Lohmann
Greetings. On Fri, 11 May 2012 22:10:56 +0200 Luis Anaya wrote: > X-Mailer: Apple Mail (2.1257) > > I'm working on a document generation project in share point to create .docx > files from share point lists. There are moments that I've wished for a root > canal without anesthetic during develop

Re: [dev] suckless document generator for C code

2012-05-11 Thread Luis Anaya
FWIW: On May 11, 2012, at 2:29 PM, Galos, David wrote: >> I guess I like the idea of keeping all the information in the C header >> file. This makes it clean. > > Less clean than troff files for the docs, I think. And retrieval is > definitely uglier than "man header name" As an idea. Keep a

Re: [dev] suckless document generator for C code

2012-05-11 Thread Connor Lane Smith
On 11 May 2012 19:29, Galos, David wrote: > Less clean than troff files for the docs, I think. And retrieval is > definitely uglier than "man headername" For the record, I do agree. My suggestion involving C header files was meant as a kind of compromise between the two. cls

Re: [dev] suckless document generator for C code

2012-05-11 Thread Bjartur Thorlacius
On 5/11/12, Amit Uttamchandani wrote: > The problem right now is the APIs are kept in a MS Word Office 2010 > .docx file, which doesn't work right with LibreOffice. > I smiled - `til I realized you weren't joking.

Re: [dev] suckless document generator for C code

2012-05-11 Thread Galos, David
> I guess I like the idea of keeping all the information in the C header > file. This makes it clean. Less clean than troff files for the docs, I think. And retrieval is definitely uglier than "man headername" > The problem right now is the APIs are kept in a MS Word Office 2010 > .docx file, whi

Re: [dev] suckless document generator for C code

2012-05-11 Thread Amit Uttamchandani
On Fri, May 11, 2012 at 06:34:00PM +0100, Connor Lane Smith wrote: > On 11 May 2012 17:45, Amit Uttamchandani > wrote: > > I'm looking for a document generator for C code. Mainly to document APIs > > to give to UI developers. > > I'm of the belief that documentation generators vary between usele

Re: [dev] suckless document generator for C code

2012-05-11 Thread Connor Lane Smith
Hey, On 11 May 2012 17:45, Amit Uttamchandani wrote: > I'm looking for a document generator for C code. Mainly to document APIs > to give to UI developers. I'm of the belief that documentation generators vary between useless and harmful. When you embed documentation into the program source itsel

Re: [dev] suckless document generator for C code

2012-05-11 Thread Luis Anaya
I'm fond of RoboDoc. Being that it is fairly code agnostic. It may require more tagging than other options, but it works well for me Luis On May 11, 2012, at 12:45 PM, Amit Uttamchandani wrote: > Hello, > > I'm looking for a document generator for C code. Mainly to document APIs > to give to U

[dev] suckless document generator for C code

2012-05-11 Thread Amit Uttamchandani
Hello, I'm looking for a document generator for C code. Mainly to document APIs to give to UI developers. Looked at quite a few options and it seems gtk-doc is suitable. A couple of kernel projects use it (libudev) and it doesn't have a huge dependency list. What do you all think? What do you us