Re: API documentation from introspection data

2012-02-19 Thread Jasper St. Pierre
On Sun, Feb 19, 2012 at 1:25 PM, Alberto Ruiz wrote: > I think that a tool to convert the doc string into something > C/Python/Vala/GJS friendly (with links to each node) would be nice. If it > had some sort of integration with the AST it would be nice so that we could > somehow dynamically assign

Re: API documentation from introspection data

2012-02-19 Thread Alberto Ruiz
2012/2/19 Tomeu Vizoso > On Sun, Feb 19, 2012 at 16:22, Alberto Ruiz wrote: > > > > > > 2012/2/19 Shaun McCance > >> > >> On Sat, 2012-02-18 at 15:00 +, Alberto Ruiz wrote: > >> > > >> > I am interested in the dynamic features like doing complicated queries > >> > to show the result and bei

Re: API documentation from introspection data

2012-02-19 Thread Jasper St. Pierre
On Sun, Feb 19, 2012 at 10:22 AM, Alberto Ruiz wrote: > Django has its own comments app, that problem is already solved. And it's terrible. Speaking as someone who wrote the rating/comment system using the Django comments app, it's terrible. Don't think of adding any feature remotely modern, like

Re: API documentation from introspection data

2012-02-19 Thread Tomeu Vizoso
On Sun, Feb 19, 2012 at 16:22, Alberto Ruiz wrote: > > > 2012/2/19 Shaun McCance >> >> On Sat, 2012-02-18 at 15:00 +, Alberto Ruiz wrote: >> > >> > I am interested in the dynamic features like doing complicated queries >> > to show the result and being able to add comments and code examples t

Re: API documentation from introspection data

2012-02-19 Thread Alberto Ruiz
2012/2/19 Shaun McCance > On Sat, 2012-02-18 at 15:00 +, Alberto Ruiz wrote: > > > > I am interested in the dynamic features like doing complicated queries > > to show the result and being able to add comments and code examples to > > specific API items, writing code to output Mallard only he

Re: API documentation from introspection data

2012-02-19 Thread Shaun McCance
On Sun, 2012-02-19 at 12:48 +0100, Stefan Sauer wrote: > > Just one thought. If people work on a next generation doc tool to take > over from gtk-doc, please consider to do it without docbook xml at > all. > Just go from an intermediate representation to html *without* xslt. > libxslt is literally

Re: API documentation from introspection data

2012-02-19 Thread Stefan Sauer
On 01/13/2012 02:17 PM, Tomeu Vizoso wrote: > Hi, > > in a bit less than a month from now there will be a hackfest on > documentation in Brno [0]. Has anybody done any further work since > Berlin in generating API documentation in the Mallard format from the > GIR files? > > I plan to spend my time

Re: API documentation from introspection data

2012-02-19 Thread Shaun McCance
On Sat, 2012-02-18 at 15:00 +, Alberto Ruiz wrote: > > I am interested in the dynamic features like doing complicated queries > to show the result and being able to add comments and code examples to > specific API items, writing code to output Mallard only helps if you > want to still produce