texinfo documentation? bug

[Mahlon]

14 Nov. 2014

RE: '@indent' and '@noindent' commands

Version: makeinfo 5.2 (built from source on Fedora 20 x86_64)

Bug:

The documentation is ambiguous at best, so my interpretation may not be the one intended by the author. Note: This discussion assumes that the global @paragraphindent allows first-line indentation.

As I read it these commands are defined to work outside any block environment; however, the documentation says (indirectly) that these two commands should ALSO work inside environments which they do not. Either the commands are broken inside environment blocks OR the documentation is wrong.

Actually, I think it is the documentation that is wrong.

Documentation:

See Chapter 10.14 'noindent': It shows an example where the @indent and @noindent are used inside a @display (actually a @verbatim) environment which is preformatted and therefore logically, should not be affected anyway. This example is ridiculously illogical (in my opinion) because it equates an @example block with first-line indentation. Of course the output for the example has no first-line indent because first-line indentation does not happen inside any environment block.

For a more reasonable test, try pasting the attached into an empty node.

Cheers,

Mahlon

--

Software Sam - software and tools for GNU/Linux

Mahlon Smith,
The Software Samurai
On the Web: http://www.SoftwareSam.us/

noindent_documentation_error.texi
Description: Text Data