[PATCH] doc: Removed extra indentation from wl_list code sample

Pekka Paalanen ppaalanen at gmail.com
Wed Nov 26 22:48:27 PST 2014


On Wed, 26 Nov 2014 10:44:40 -0800
Bill Spitzak <spitzak at gmail.com> wrote:

> On 11/26/2014 03:37 AM, Pekka Paalanen wrote:
> 
> > I see the asterisks at
> > $WLD/share/doc/wayland/Wayland/en-US/html/ch05.html#structwl__list
> > after 'make install'. Looks like the C comment asterisks we use for
> > style reasons get copied to the output. They appeared when you replaced
> > ~~~ with \code.
> >
> > My Doxygen is version 1.8.5.
> 
> Works for me but the version is different. Can you try the following patch?

The patch doesn't seem to change anything.

For the record, this is what I see in the final HTML (with the patch):

<p>The following code will initialize a list:</p><p>
            </p><pre class="programlisting">* struct <a class="link" href="ch05.html#structwl__list">wl_list</a> foo_list;
*
* struct item_t {
*       int foo;

And this is how it looks like in
doc/publican/en-US/WaylandClientAPI.xml:

          <para>The following code will initialize a list:</para>
          <para>
            <programlisting>* struct <link linkend="structwl__list">wl_list</link> foo_list;
*
* struct item_t {
*       int foo;

So yes, it is a Doxygen thing, I think.

Was there a reason you got rid of the ~~~ markings?


Thanks,
pq


More information about the wayland-devel mailing list