Re: [PATCH 1/4] doc: use markdown tildes for code blocks

2014-12-09 Thread Pekka Paalanen
On Mon, 08 Dec 2014 11:06:00 -0800 Bill Spitzak wrote: > However I think the decision was to only require Doxygen 1.6 and > therefore the tildes don't work, and you must use \code. Is this > correct? This is what is currently in git head. There is no tilde mark-up in upstream at the moment. I

Re: [PATCH 1/4] doc: use markdown tildes for code blocks

2014-12-08 Thread Bill Spitzak
However I think the decision was to only require Doxygen 1.6 and therefore the tildes don't work, and you must use \code. Is this correct? This is what is currently in git head. On 12/08/2014 01:35 AM, Pekka Paalanen wrote: On Fri, 05 Dec 2014 12:53:28 -0800 Bill Spitzak wrote: On 12/05/201

Re: [PATCH 1/4] doc: use markdown tildes for code blocks

2014-12-08 Thread Pekka Paalanen
On Fri, 05 Dec 2014 12:53:28 -0800 Bill Spitzak wrote: > On 12/05/2014 06:44 AM, Pekka Paalanen wrote: > > > do you have any suggestions on how to get rid of the asterisks in front > > of code examples? > > All I can say is that this appears to be a Doxygen bug, and it depends > both on the ve

Re: [PATCH 1/4] doc: use markdown tildes for code blocks

2014-12-08 Thread Peter Hutterer
On Fri, Dec 05, 2014 at 12:53:28PM -0800, Bill Spitzak wrote: > On 12/05/2014 06:44 AM, Pekka Paalanen wrote: > > >do you have any suggestions on how to get rid of the asterisks in front > >of code examples? > > All I can say is that this appears to be a Doxygen bug, and it depends both > on the

Re: [PATCH 1/4] doc: use markdown tildes for code blocks

2014-12-05 Thread Bill Spitzak
On 12/05/2014 06:44 AM, Pekka Paalanen wrote: do you have any suggestions on how to get rid of the asterisks in front of code examples? All I can say is that this appears to be a Doxygen bug, and it depends both on the version of Doxygen and on what commands have been processed by Doxygen be

Re: [PATCH 1/4] doc: use markdown tildes for code blocks

2014-12-05 Thread Pekka Paalanen
On Thu, 4 Dec 2014 07:49:59 +1000 Peter Hutterer wrote: > On Wed, Dec 03, 2014 at 12:37:40PM -0800, Bill Spitzak wrote: > > > > > > On 12/02/2014 07:45 PM, Peter Hutterer wrote: > > >On Tue, Dec 02, 2014 at 06:29:33PM -0800, Bill Spitzak wrote: > > >>This requires doxygen 1.8 or newer. > > >>I

Re: [PATCH 1/4] doc: use markdown tildes for code blocks

2014-12-05 Thread Pekka Paalanen
On Tue, 02 Dec 2014 19:02:12 -0800 "Jon A. Cruz" wrote: > On 12/02/2014 06:29 PM, Bill Spitzak wrote: > > This requires doxygen 1.8 or newer. > > FYI this will cut off support for RHEL6 and corresponding distros such > as CentOS and Scientific Linux (I had to track this for my prior day job). >

Re: [PATCH 1/4] doc: use markdown tildes for code blocks

2014-12-03 Thread Bill Spitzak
On 12/03/2014 02:37 PM, Peter Hutterer wrote: I did some web searches, and the consensus is that Doxygen has done a great job of making it impossible to put a C-style comment into a code sample. doxygen is designed for source file commenting. you couldn't compile a nested C-style comment, doxy

Re: [PATCH 1/4] doc: use markdown tildes for code blocks

2014-12-03 Thread Peter Hutterer
On Wed, Dec 03, 2014 at 02:20:50PM -0800, Bill Spitzak wrote: > On 12/03/2014 01:49 PM, Peter Hutterer wrote: > > >what is \comment? I can't find it in the doxygen tag list. > > That stumped me for a while, too. It's an "alias" defined in the > wayland.doxygen file. As far as I can tell aliases a

Re: [PATCH 1/4] doc: use markdown tildes for code blocks

2014-12-03 Thread Bill Spitzak
On 12/03/2014 01:49 PM, Peter Hutterer wrote: what is \comment? I can't find it in the doxygen tag list. That stumped me for a while, too. It's an "alias" defined in the wayland.doxygen file. As far as I can tell aliases are not really commands, they are instead more like macros. This explai

Re: [PATCH 1/4] doc: use markdown tildes for code blocks

2014-12-03 Thread Peter Hutterer
On Wed, Dec 03, 2014 at 12:37:40PM -0800, Bill Spitzak wrote: > > > On 12/02/2014 07:45 PM, Peter Hutterer wrote: > >On Tue, Dec 02, 2014 at 06:29:33PM -0800, Bill Spitzak wrote: > >>This requires doxygen 1.8 or newer. > >>I could not figure out how to make configure.ac test the doxygen > >>versi

Re: [PATCH 1/4] doc: use markdown tildes for code blocks

2014-12-03 Thread Bill Spitzak
On 12/02/2014 07:45 PM, Peter Hutterer wrote: On Tue, Dec 02, 2014 at 06:29:33PM -0800, Bill Spitzak wrote: This requires doxygen 1.8 or newer. I could not figure out how to make configure.ac test the doxygen version number. It appears to be really complex. So it will run with any version of d

Re: [PATCH 1/4] doc: use markdown tildes for code blocks

2014-12-02 Thread Peter Hutterer
On Tue, Dec 02, 2014 at 06:29:33PM -0800, Bill Spitzak wrote: > This requires doxygen 1.8 or newer. > I could not figure out how to make configure.ac test the doxygen > version number. It appears to be really complex. So it will run with > any version of doxygen and the doc output is somewhat mangl

Re: [PATCH 1/4] doc: use markdown tildes for code blocks

2014-12-02 Thread Jon A. Cruz
On 12/02/2014 06:29 PM, Bill Spitzak wrote: > This requires doxygen 1.8 or newer. FYI this will cut off support for RHEL6 and corresponding distros such as CentOS and Scientific Linux (I had to track this for my prior day job). On the other hand, RHEL7 is up to Doxygen 1.8.5 so we're good in that

[PATCH 1/4] doc: use markdown tildes for code blocks

2014-12-02 Thread Bill Spitzak
This requires doxygen 1.8 or newer. I could not figure out how to make configure.ac test the doxygen version number. It appears to be really complex. So it will run with any version of doxygen and the doc output is somewhat mangled. --- src/wayland-client.c | 14 +++--- src/wayland-serve