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 <[email protected]> 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: [email protected]

Reply via email to