Re: [Mesa-dev] Documenting with Sphinx

2016-12-15 Thread Jason Ekstrand
On Dec 15, 2016 6:40 AM, "Jani Nikula" wrote: On Thu, 15 Dec 2016, Robert Bragg wrote: > On Wed, Dec 14, 2016 at 7:17 PM, Jani Nikula > wrote: >> On Wed, 14 Dec 2016, Robert Bragg wrote: >> The AST does include comments right above each cursor, but it falls >> short for comments not attached t

Re: [Mesa-dev] Documenting with Sphinx

2016-12-15 Thread Jani Nikula
On Thu, 15 Dec 2016, Robert Bragg wrote: > On Wed, Dec 14, 2016 at 7:17 PM, Jani Nikula > wrote: >> On Wed, 14 Dec 2016, Robert Bragg wrote: >> The AST does include comments right above each cursor, but it falls >> short for comments not attached to cursors. You have to walk the tokens >> for th

Re: [Mesa-dev] Documenting with Sphinx

2016-12-15 Thread Robert Bragg
On Wed, Dec 14, 2016 at 7:17 PM, Jani Nikula wrote: > On Wed, 14 Dec 2016, Robert Bragg wrote: >> On Tue, Dec 13, 2016 at 11:08 PM, Rob Clark wrote: >>> On Tue, Dec 13, 2016 at 5:47 PM, Eric Anholt wrote: Jason Ekstrand writes: > Hey All, > I don't figure this will be terribl

Re: [Mesa-dev] Documenting with Sphinx

2016-12-14 Thread Jani Nikula
On Wed, 14 Dec 2016, Robert Bragg wrote: > On Tue, Dec 13, 2016 at 11:08 PM, Rob Clark wrote: >> On Tue, Dec 13, 2016 at 5:47 PM, Eric Anholt wrote: >>> Jason Ekstrand writes: >>> Hey All, I don't figure this will be terribly controversial (I'm about to be wrong, aren't I?) but h

Re: [Mesa-dev] Documenting with Sphinx

2016-12-14 Thread Robert Bragg
On Tue, Dec 13, 2016 at 11:08 PM, Rob Clark wrote: > On Tue, Dec 13, 2016 at 5:47 PM, Eric Anholt wrote: >> Jason Ekstrand writes: >> >>> Hey All, >>> I don't figure this will be terribly controversial (I'm about to be wrong, >>> aren't I?) but how do people feel about switching our "primary" >>

Re: [Mesa-dev] Documenting with Sphinx

2016-12-14 Thread Vedran Miletić
On 12/13/2016 09:46 PM, Jason Ekstrand wrote: > Hey All, > I don't figure this will be terribly controversial (I'm about to be > wrong, aren't I?) but how do people feel about switching our "primary" > documentation focus, as far as we have one, to sphinx? Right now, > Gallium uses sphinx for docu

Re: [Mesa-dev] Documenting with Sphinx

2016-12-13 Thread Rob Clark
On Tue, Dec 13, 2016 at 5:47 PM, Eric Anholt wrote: > Jason Ekstrand writes: > >> Hey All, >> I don't figure this will be terribly controversial (I'm about to be wrong, >> aren't I?) but how do people feel about switching our "primary" >> documentation focus, as far as we have one, to sphinx? Ri

Re: [Mesa-dev] Documenting with Sphinx

2016-12-13 Thread Kenneth Graunke
On Tuesday, December 13, 2016 2:47:27 PM PST Eric Anholt wrote: > Jason Ekstrand writes: > > > Hey All, > > I don't figure this will be terribly controversial (I'm about to be wrong, > > aren't I?) but how do people feel about switching our "primary" > > documentation focus, as far as we have one

Re: [Mesa-dev] Documenting with Sphinx

2016-12-13 Thread Jason Ekstrand
On Tue, Dec 13, 2016 at 2:47 PM, Eric Anholt wrote: > Jason Ekstrand writes: > > > Hey All, > > I don't figure this will be terribly controversial (I'm about to be > wrong, > > aren't I?) but how do people feel about switching our "primary" > > documentation focus, as far as we have one, to sphi

Re: [Mesa-dev] Documenting with Sphinx

2016-12-13 Thread Dylan Baker
Quoting Jason Ekstrand (2016-12-13 12:46:17) > Hey All, > I don't figure this will be terribly controversial (I'm about to be wrong, > aren't I?) but how do people feel about switching our "primary" documentation > focus, as far as we have one, to sphinx?  Right now, Gallium uses sphinx for > docum

Re: [Mesa-dev] Documenting with Sphinx

2016-12-13 Thread Eric Anholt
Jason Ekstrand writes: > Hey All, > I don't figure this will be terribly controversial (I'm about to be wrong, > aren't I?) but how do people feel about switching our "primary" > documentation focus, as far as we have one, to sphinx? Right now, Gallium > uses sphinx for documenting all of it's "

[Mesa-dev] Documenting with Sphinx

2016-12-13 Thread Jason Ekstrand
Hey All, I don't figure this will be terribly controversial (I'm about to be wrong, aren't I?) but how do people feel about switching our "primary" documentation focus, as far as we have one, to sphinx? Right now, Gallium uses sphinx for documenting all of it's "public" interfaces. A while ago, C