/[groff]/groff/doc/groff.texinfo
ViewVC logotype

Diff of /groff/doc/groff.texinfo

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.215 by wl, Mon Sep 20 09:08:34 2004 UTC revision 1.216 by wl, Thu Sep 23 11:54:25 2004 UTC
# Line 2860  Effective: next paragraph. Line 2860  Effective: next paragraph.
2860  Default: 12@dmn{p}.  Default: 12@dmn{p}.
2861  @endDefmpreg  @endDefmpreg
2862    
2863    @Defmpreg {PSINCR, ms}
2864    Defines an increment in point size, which will be applied to section
2865    headings at nesting levels below the value specified in @code{GROWPS}.  The
2866    value of @code{PSINCR} should be specified in points, with the @dmn{p}
2867    scaling factor, and may include a fractional component; for example,
2868    @w{@samp{.nr PSINCR 1.5p}} sets a point size increment of 1.5@dmn{p}.
2869    
2870    Effective: next section heading.
2871    
2872    Default: 1@dmn{p}.
2873    @endDefmpreg
2874    
2875    @Defmpreg {GROWPS, ms}
2876    Defines the heading level below which the point size increment set by
2877    @code{PSINCR} becomes effective.  Section headings at and above the level
2878    specified by @code{GROWPS} will be printed at the point size set by @code{PS};
2879    for each level below the value of @code{GROWPS}, the point size will be
2880    increased in steps equal to the value of @code{PSINCR}.  Setting @code{GROWPS}
2881    to any value less than@tie{}2 disables the incremental heading size feature.
2882    
2883    Effective: next section heading.
2884    
2885    Default: 0.
2886    @endDefmpreg
2887    
2888  @unnumberedsubsubsec Paragraph Settings  @unnumberedsubsubsec Paragraph Settings
2889    
2890  @Defmpreg {PI, ms}  @Defmpreg {PI, ms}
# Line 2886  Effective: next paragraph. Line 2911  Effective: next paragraph.
2911  Default: 5@dmn{n}.  Default: 5@dmn{n}.
2912  @endDefmpreg  @endDefmpreg
2913    
2914    @Defmpreg {PORPHANS, ms}
2915    Defines the minimum number of initial lines of any paragraph which should
2916    be kept together, to avoid orphan lines at the bottom of a page.  If a new
2917    paragraph is started close to the bottom of a page, and there is insufficient
2918    space to accommodate @code{PORPHANS} lines before an automatic page break,
2919    then the page break will be forced, before the start of the paragraph.
2920    
2921    Effective: next paragraph.
2922    
2923    Default: 1.
2924    @endDefmpreg
2925    
2926    @Defmpreg {HORPHANS, ms}
2927    Defines the minimum number of lines of the following paragraph which should
2928    be kept together with any section heading introduced by the @code{NH} or
2929    @code{SH} macros.  If a section heading is placed close to the bottom of a
2930    page, and there is insufficient space to accommodate both the heading and
2931    at least @code{HORPHANS} lines of the following paragraph, before an
2932    automatic page break, then the page break will be forced before the heading.
2933    
2934    Effective: next paragraph.
2935    
2936    Default: 1.
2937    @endDefmpreg
2938    
2939  @unnumberedsubsubsec Footnote Settings  @unnumberedsubsubsec Footnote Settings
2940    
2941  @Defmpreg {FL, ms}  @Defmpreg {FL, ms}
# Line 3162  free software. Line 3212  free software.
3212  @end cartouche  @end cartouche
3213  @endExample  @endExample
3214    
3215    The @code{PORPHANS} register (@pxref{ms Document Control Registers})
3216    operates in conjunction with each of these macros, to inhibit the
3217    printing of orphan lines at the bottom of any page.
3218    
3219  @c ---------------------------------------------------------------------  @c ---------------------------------------------------------------------
3220    
3221  @node Headings in ms, Highlighting in ms, Paragraphs in ms, ms Body Text  @node Headings in ms, Highlighting in ms, Paragraphs in ms, ms Body Text
# Line 3186  If you specify heading levels out of seq Line 3240  If you specify heading levels out of seq
3240  prints a warning on standard error.  prints a warning on standard error.
3241  @endDefmac  @endDefmac
3242    
3243  @Defmac {SH, , ms}  @DefstrList {SN, ms}
3244    @DefstrItem {SN-DOT, ms}
3245    @DefstrListEnd {SN-NO-DOT, ms}
3246    After invocation of @code{NH}, the assigned section number is made
3247    available in the strings @code{SN-DOT} (exactly as it appears in the
3248    printed section heading) and @code{SN-NO-DOT} (with the final period
3249    omitted).  The string @code{SN} is also defined, as an alias for
3250    @code{SN-DOT}; if preferred, you may redefine it as an alias for
3251    @code{SN-NO-DOT}, by including the initialization
3252    
3253    @Example
3254    .ds SN-NO-DOT
3255    .als SN SN-NO-DOT
3256    @endExample
3257    
3258    @noindent
3259    @strong{before} your first use of @code{NH}, or simply
3260    
3261    @Example
3262    .als SN SN-NO-DOT
3263    @endExample
3264    
3265    @noindent
3266    @strong{after} your first use of @code{NH}.
3267    @endDefstr
3268    
3269    @Defmac {SH, [@Var{match-level}], ms}
3270  Unnumbered subheading.  Unnumbered subheading.
3271    
3272    The optional @code{match-level} argument is a GNU extension.  It is a
3273    number indicating the level of the heading, in a manner analogous to
3274    the @code{curr-level} argument to @code{.NH}.  Its purpose is to match
3275    the point size, at which the heading is printed, to the size of a
3276    numbered heading at the same level, when the @code{GROWPS}/@code{PSINCR}
3277    heading size adjustment mechanism is in effect.
3278    @xref{ms Document Control Registers}.
3279  @endDefmac  @endDefmac
3280    
3281    The @code{HORPHANS} register (@pxref{ms Document Control Registers})
3282    operates in conjunction with the @code{NH} and @code{SH} macros, to
3283    inhibit the printing of orphaned section headings at the bottom of any
3284    page.
3285    
3286  @c ---------------------------------------------------------------------  @c ---------------------------------------------------------------------
3287    
3288  @node Highlighting in ms, Lists in ms, Headings in ms, ms Body Text  @node Highlighting in ms, Lists in ms, Headings in ms, ms Body Text
# Line 3292  The @var{width} specifies the indent for Line 3385  The @var{width} specifies the indent for
3385  its default unit is @samp{n}.  its default unit is @samp{n}.
3386  Once specified, the indent remains the same for all  Once specified, the indent remains the same for all
3387  list items in the document until specified again.  list items in the document until specified again.
3388    
3389    The @code{PORPHANS} register (@pxref{ms Document Control Registers})
3390    operates in conjunction with the @code{IP} macro, to inhibit the
3391    printing of orphaned list markers at the bottom of any page.
3392  @endDefmac  @endDefmac
3393    
3394  The following is an example of a bulleted list.  The following is an example of a bulleted list.

Legend:
Removed from v.1.215  
changed lines
  Added in v.1.216

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26