> The text that you quote has a single purpose: to recommend authors
> against using tabs in @example. Since this is what it wants to
> convey, why is it important that some tabs are left intact and some
> aren't? It should be enough to know that some tabs could in some
> cases be treated as spaces, no?
I had to correct documentation that put a Makefile with leading tabs
into an `@example` environment, and I was surprised to see that the
leading tabs completely vanished. This is not the behaviour I'm used
to from LaTeX (within a 'verbatim' environment, for example).
> IOW, a warning not to do something doesn't have to be pedantically
> rigorous about where and how the danger can bite you.
I'm a fan of pedantically correct documentation.
>> Note that I actually don't care about TeX's behaviour with respect
>> to tabs in `@example` environments. I just want to point out that
>> the implementation is not in sync with the documentation.
>
> To turn the table, what would you want to see the text say instead?
> that some tabs can be treated as single spaces? or something else?
For example this:
Caution: Do not use tabs in the lines of an example! (Or anywhere
else in Texinfo, except in verbatim environments.)
'texinfo.tex' ignores tabs or treats them as single spaces,
which is not what they look like.
Werner
