Re: makeinfo bug

[马伦]

Hi Pat,

You are right that @section, @subsection and @subsubsection can be reserved for the top level only.
 
However, @heading, @subheading and @subsubheading are explicitly defined in the documentation as: "You may use the '@heading' command anywhere you wish for a section-style heading that will not appear in the table of contents." This allows for a consistently-formatted heading line anywhere in the document.

Mahlon

On Mon, Aug 25, 2014 at 4:37 PM, Patrice Dumas <address@hidden> wrote:

On Mon, Aug 25, 2014 at 09:42:16AM +0800, Mahlon Smith ( 马伦 ) wrote:
> Good Morning,

>
> There is a formatting error for the: @heading, @subheading and
> @subsubheading commands.
>
> These commands generate underlining similar to the @section commands, but
> can be used
>
> anywhere and don't show up in the table of contents.
>
> These commands work fine when they are at the top level, but when used
> inside an indented structure, the underlining begins at the left margin
> instead of at the beginning of the heading text.
>
> You might want to also check any other commands which are allowed inside
> indents and which generate underlining to verify that the underlining
> begins in the right place.

I think that the sectionning and headings commands are the only commands
generating underlining.  Maybe in title page too.

I think that we agreed that @*heading commands should only appear at the
top level.  texi2pdf gives the following error message:
./bug_report.texi:109: This command can appear only outside of any
environment,  not in environment @indentedblock.

Do we document that @*heading are only at the toplevel or should I try
to fix the issue?

--
Pat

--

“You will do foolish things,
  but do them with enthusiasm.”
--Sidonie Gabrielle Colette

Mahlon R. Smith (马伦 )

Associate Professor, Foreign Languages Department
Beijing University of Technology
Email: address@hidden