octave-maintainers
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: @example's as doctests


From: Julien Bect
Subject: Re: @example's as doctests
Date: Sat, 28 Mar 2015 14:40:47 +0100
User-agent: Mozilla/5.0 (X11; Linux i686; rv:31.0) Gecko/20100101 Thunderbird/31.5.0

Le 28/03/2015 14:17, Oliver Heimlich a écrit :
Am 28.03.2015 um 13:52 schrieb Julien Bect:
Le 28/03/2015 13:34, Oliver Heimlich a écrit :
I'd prefer this solution. However, the current generate-html adds
additional margins between @group blocks. They are smaller than the
margins between @example + @group blocks, but still very big.
According to texinfo the @group blocks should not add margins and only
affect pagination. Can we fix this in the generate-html package?

Hello Oliver,

Is it a problem with the HTML generated by the generate_html package, or
simply a problem with the CSS ?

Can you provide a patch ? Otherwise, can you point me to a specific
example of this problem (in the interval package, for example) ?

@++
Julien

Julien,

each @group block within an @example block will be converted into a <pre class="example"> block.

## @end group
## @group
Such a group change introduces an additional <pre> block between the groups, which contains a single space.

However, when I omit the spaces, there is no additional <pre> block and I am happy. ;-)
address@hidden group
address@hidden

I investigated this further and found more unintentional <pre> blocks. Probably, the generate-html package should strip the spaces in front of @ macros at the beginning of lines. What do you think?

I though I had solved this problem :

http://sourceforge.net/p/octave/generate_html/ci/c0ad0267e85bd1ec876469de30d7587c8aed8547/

Which generate_html are you using ? 0.1.6 or hg's tip ?

The patch deals with @group and @end keywords, are there other keywords that should be handled similarly ?

I am preparing a release of generate_html these days, it should be ready very very soon...

@++
Julien




reply via email to

[Prev in Thread] Current Thread [Next in Thread]