@@ -506,26 +506,21 @@ Print version.
506506\f[B]\f[CB]-h\f[B]\f[R], \f[B]\f[CB]--help\f[B]\f[R]
507507Show usage message.
508508.SS Reader options
509−.PP
510−\f[C]--shift-heading-level-by=\f[R]\f[I]NUMBER\f[R]
511−.IP
512−.nf
513−\f[C]
509+.TP
510+\f[B]\f[CB]--shift-heading-level-by=\f[B]\f[R]\f[I]NUMBER\f[R]
514511Shift heading levels by a positive or negative integer.
515−For example, with \[ga]--shift-heading-level-by=-1\[ga], level 2
516−headings become level 1 headings, and level 3 headings
517−become level 2 headings. Headings cannot have a level
518−less than 1, so a heading that would be shifted below level 1
519−becomes a regular paragraph. Exception: with a shift of -1,
520−a level-1 heading at the beginning of the document
521−replaces the metadata title. Conversely, with a shift
522−of +1, a nonempty metadata title becomes a level-1 heading at
523−the beginning of the document. \[ga]--shift-heading-level-by=-1\[ga]
524−is a good choice when converting HTML or Markdown documents that
525−use an initial level-1 heading for the document title and
526−level-2+ headings for sections.
527−\f[R]
528−.fi
512+For example, with \f[C]--shift-heading-level-by=-1\f[R], level 2
513+headings become level 1 headings, and level 3 headings become level 2
514+headings.
515+Headings cannot have a level less than 1, so a heading that would be
516+shifted below level 1 becomes a regular paragraph.
517+Exception: with a shift of -1, a level-1 heading at the beginning of the
518+document replaces the metadata title.
519+Conversely, with a shift of +1, a nonempty metadata title becomes a
520+level-1 heading at the beginning of the document.
521+\f[C]--shift-heading-level-by=-1\f[R] is a good choice when converting
522+HTML or Markdown documents that use an initial level-1 heading for the
523+document title and level-2+ headings for sections.
529524.TP
530525\f[B]\f[CB]--base-header-level=\f[B]\f[R]\f[I]NUMBER\f[R]
531526\f[I]Deprecated. Use \f[CI]--shift-heading-level-by\f[I] instead.\f[R]