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 towork _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:
SeeChapter 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 examplehas no first-line indent because first-line
indentation does not happen inside any environment block.
For a more reasonable test, try pasting the attached intoan empty node.
Cheers,
Mahlon
--
Software Sam - software and tools for GNU/Linux
Mahlon Smith,
/The Software Samurai/
On the Web: /http://www.SoftwareSam.us/
<http://www.SoftwareSam.us/home.html>/
@subheading The '@@indent' and '@@noindent' Commands
These are pairs of paragraphs representing each block type. The first
paragraph of the pair is preceed by @@indent, and the second of the pair
is preceeded by @@noindent.
@noindent
@code{1. outside any block}
@indent
Heroes are seldom born. Instead, they spring to life when circumstances
demand it and recede into the background when the crisis has passed.
@noindent
Heroes are seldom born. Instead, they spring to life when circumstances
demand it and recede into the background when the crisis has passed.
@noindent
@code{2. @@quotation block}@*
@quotation
@indent
Heroes are seldom born. Instead, they spring to life when circumstances
demand it and recede into the background when the crisis has passed.
@noindent
Heroes are seldom born. Instead, they spring to life when circumstances
demand it and recede into the background when the crisis has passed.
@end quotation
@noindent
@code{3. @@indentedblock block}@*
@indentedblock
@indent
Heroes are seldom born. Instead, they spring to life when circumstances
demand it and recede into the background when the crisis has passed.
@noindent
Heroes are seldom born. Instead, they spring to life when circumstances
demand it and recede into the background when the crisis has passed.
@end indentedblock
@noindent
@code{4. @@example block}@*
@example
@indent
Heroes are seldom born. Instead, they spring to life when circumstances
demand it and recede into the background when the crisis has passed.
@noindent
Heroes are seldom born. Instead, they spring to life when circumstances
demand it and recede into the background when the crisis has passed.
@end example
@noindent
@code{5. @@display block}@*
@display
@indent
Heroes are seldom born. Instead, they spring to life when circumstances
demand it and recede into the background when the crisis has passed.
@noindent
Heroes are seldom born. Instead, they spring to life when circumstances
demand it and recede into the background when the crisis has passed.
@end display
@noindent
@code{6. @@format block}@*
@format
@indent
Heroes are seldom born. Instead, they spring to life when circumstances
demand it and recede into the background when the crisis has passed.
@noindent
Heroes are seldom born. Instead, they spring to life when circumstances
demand it and recede into the background when the crisis has passed.
@end format
@noindent
@code{7. @@verbatim block}@*
@verbatim
@indent
Heroes are seldom born. Instead, they spring to life when circumstances
demand it and recede into the background when the crisis has passed.
@noindent
Heroes are seldom born. Instead, they spring to life when circumstances
demand it and recede into the background when the crisis has passed.
@end verbatim
