Re: @exampleindent macro does not seem to have effect

Patrice Dumas <[email protected]>
Newsgroups gmane.comp.tex.texinfo.bugs
Message-ID <[email protected]>
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
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.