On Fri, Mar 13, 2026 at 09:13:29AM +0100, Rik wrote:
> On 3/13/26 00:57, Patrice Dumas wrote:
> > On Thu, Mar 12, 2026 at 08:42:07AM +0100, Rik wrote:
> > > Summary: Using @exampleindent does not change indent of @example blocks 
> > > for
> > > "plain text" and Info output
> > 
> > This is implemented:
> > https://cgit.git.savannah.gnu.org/cgit/texinfo.git/commit/?id=3446435f5717aa202a3e874e53e504fb47c958bd
> > 
> > Thanks for the report!
> > 
> > This is probably broken since 2013, which means that this is not
> > something often sought after, at least in Info and plaintext output.
> > 
> Super!  Thanks for the very quick action.  I cloned the Texinfo repo and
> verified that the macro is working just as it should now.
> 
> I agree, this probably isn't a commonly used feature.  It will, however, be
> very useful for GNU Octave documentation.  We use @example blocks within
> @deftypefn blocks and the overall indentation really starts to stack up.
> Maybe there is a different structure, but we have @deftypefn blocks to
> document functions, and within those blocks we use @example, and within
> those blocks we use @result with our own indentation to align columns.

This looks relevant to me.
> 
>      For example:
> 
>           t = 0.1;
>           n = 4;
>           [num, den] = padecoef (t, n)
>           ⇒ num =
> 
>                 1.0000e-04  -2.0000e-02   1.8000e+00  -8.4000e+01   1.6800e+03
> 
>           ⇒ den =
> 
>                 1.0000e-04   2.0000e-02   1.8000e+00   8.4000e+01   1.6800e+03
> ------------------------------------------------
> 
> It's the last part of the documentation where the stacking really starts to
> add up.

Indeed, in that case @exampleindent really makes sense.  And it would
also make sense to change back to the default for @example outside of
other environments.

-- 
Pat

Reply via email to