diff options
author | wlemb <wlemb> | 2004-03-22 06:20:10 +0000 |
---|---|---|
committer | wlemb <wlemb> | 2004-03-22 06:20:10 +0000 |
commit | 587f0a6d7ddc9625c8a80f869eb1a196efe997a5 (patch) | |
tree | fbc88918318b87beed4ba3de64dcd78badc76bad | |
parent | 51646f56dfdfd1dbf19cd7b5016116bb9ab78345 (diff) | |
download | groff-587f0a6d7ddc9625c8a80f869eb1a196efe997a5.tar.gz |
o Added color support
o Adjusted vertical placement of hyphens around page numbering
so that they are better centered on the height of the page
number.
o Re-wrote portions of the document processing macros so that tabs
behave in a consistent and intuitive manner. Tab structures are
now properly preserved from page to page and column to column.
-rw-r--r-- | contrib/mom/BUGS | 33 | ||||
-rw-r--r-- | contrib/mom/ChangeLog | 16 | ||||
-rw-r--r-- | contrib/mom/NEWS | 18 | ||||
-rw-r--r-- | contrib/mom/TODO | 6 | ||||
-rw-r--r-- | contrib/mom/examples/elvis_syntax.new | 1 | ||||
-rw-r--r-- | contrib/mom/momdoc/color.html | 337 | ||||
-rw-r--r-- | contrib/mom/momdoc/docelement.html | 147 | ||||
-rw-r--r-- | contrib/mom/momdoc/docprocessing.html | 196 | ||||
-rw-r--r-- | contrib/mom/momdoc/goodies.html | 13 | ||||
-rw-r--r-- | contrib/mom/momdoc/headfootpage.html | 120 | ||||
-rw-r--r-- | contrib/mom/momdoc/inlines.html | 34 | ||||
-rw-r--r-- | contrib/mom/momdoc/reserved.html | 124 | ||||
-rw-r--r-- | contrib/mom/momdoc/toc.html | 10 | ||||
-rw-r--r-- | contrib/mom/momdoc/typemacdoc.html | 17 | ||||
-rw-r--r-- | contrib/mom/momdoc/typesetting.html | 60 | ||||
-rw-r--r-- | contrib/mom/om.tmac | 1158 |
16 files changed, 1967 insertions, 323 deletions
diff --git a/contrib/mom/BUGS b/contrib/mom/BUGS index 66cd839f..7af6d4e8 100644 --- a/contrib/mom/BUGS +++ b/contrib/mom/BUGS @@ -15,6 +15,39 @@ Also, please--no html email. That, too, gets nuked. ======================================================================== +Version 1.1.7-a +=============== + +Suite number in DOCTYPE LETTER not printing. +---Fixed--- + +Footer elements not always vertically aligning. +---Fixed--- + +Footer rule gap not always correctly observed. +---Fixed--- + +Page numbering, when at top of page, not always falling on +HDRFTR_MARGIN. +---Fixed--- + +Default page numbering style for COPYSTYLE draft is DIGIT instead +of roman. +---Fixed--- + +Hyphens around page numbering when style is DIGIT, ROMAN or ALPHA +not vertically centered. +---Fixed--- + +EXT arg not working with DROPCAP. +---Fixed--- + +DOC_QUAD not automatically set immediately after START +---Fixed-- + +Tabs behaving erratically during document processing. +---Fixed--- + Version 1.1.7 ============= diff --git a/contrib/mom/ChangeLog b/contrib/mom/ChangeLog index c2898adb..8107f7cc 100644 --- a/contrib/mom/ChangeLog +++ b/contrib/mom/ChangeLog @@ -1,3 +1,15 @@ +*Mar 15 2004 + +o Added color support + +o Adjusted vertical placement of hyphens around page numbering + so that they are better centered on the height of the page + number. + +o Re-wrote portions of the document processing macros so that tabs + behave in a consistent and intuitive manner. Tab structures are + now properly preserved from page to page and column to column. + *Feb 20 2004 o Rewrote the macros associated with DOCTYPE LETTER so that the @@ -15,8 +27,8 @@ o Added a selection of iso 639 two-letter language codes as optional arguments to SMARTQUOTES, so that the use can enter her/his language code to get language specific quoting styles -o Changed the way the strings for \*[ST<n>], \*[ST<n>X], \*[FU<n> - and \*[BU<n> are read. Formerly, they were entered literally. +o Changed the way the strings for \*[ST<n>], \*[ST<n>X], \*[FU<n>] + and \*[BU<n>] are read. Formerly, they were entered literally. Now they're entered as an array. *Jan 24 2004 diff --git a/contrib/mom/NEWS b/contrib/mom/NEWS index 04ce9abb..ea41de07 100644 --- a/contrib/mom/NEWS +++ b/contrib/mom/NEWS @@ -1,3 +1,21 @@ +Release 1.1.8 +------------- + +Added text color support. Users can now define or initialize a color, +and afterwards change text color with an inline of the form +\*[<colorname>], or with the macro .COLOR. In document processing, +the docelement tag control macros have been expanded to include +_COLOR, e.g. .HEAD_COLOR <predefined colorname> will colorize +heads, PAGENUM_COLOR <predefined colorname) will colorize page +numbering, etc. + +Adjusted vertical placement of hyphens around page numbering when +PAGENUM_STYLE is DIGIT, ROMAN or ALPHA so that the hyphens appear +properly centered on the page numbering character. + +Changed tab handling in document processing so that tab structures +are preserved from page to page and column to column. + Release 1.1.7-a --------------- diff --git a/contrib/mom/TODO b/contrib/mom/TODO index 75e1ac09..e1d995a8 100644 --- a/contrib/mom/TODO +++ b/contrib/mom/TODO @@ -12,6 +12,12 @@ FOOTNOTES In columnar docs, maybe give user the choice of gathering all footnotes at the bottom of the last column? +Figure out a way to bypass the \c requirement before .FOOTNOTE. + +Figure out a way to process blockquotes and quotes that contain +footnotes so that the user doesn't have to use the awful kludge +.BREAKQUOTE. + CONTROL MACROS -- _INDENT -------------- Let user be able to enter decimal fractions as the argument to _INDENT diff --git a/contrib/mom/examples/elvis_syntax.new b/contrib/mom/examples/elvis_syntax.new index 29726da2..777c0915 100644 --- a/contrib/mom/examples/elvis_syntax.new +++ b/contrib/mom/examples/elvis_syntax.new @@ -47,6 +47,7 @@ font args 10x14 A3 A4 A5 B4 B5 font args SINGLESPACE font args FACTOR font args DASH BULLET ALPHA DIGIT USER +font args RGB CYM CMYK GRAY GREY prefix \/ \/. \/? \/! \/, \/; \/: font escapes \/ \/. \/? \/! \/, \/; \/: prefix \, \,. \,? \,! \,, \,; \,: diff --git a/contrib/mom/momdoc/color.html b/contrib/mom/momdoc/color.html new file mode 100644 index 00000000..f0dc7a32 --- /dev/null +++ b/contrib/mom/momdoc/color.html @@ -0,0 +1,337 @@ +<html> +<head> +<meta http-equiv="content-type" content="text/html;charset=iso-8859-1"> +<title>Mom -- Colour</title> +</head> +<body bgcolor="#dfdfdf"> + +<!====================================================================> + +<a href="docprocessing.html#TOP">Next</a> +<a href="inlines.html#TOP">Prev</a> +<a href="toc.html">Back to Table of Contents</a> + +<a name="TOP"></a> +<h1 align="center"> + <a name="COLOR_INTRO"><u>Coloured text</u></a> +</h1> +<p> +<a href="#INTRO_COLOR">Introduction to coloured text</a> +<br> +<a href="#MACROS_COLOR">Index of colour macros</a> +<p> + +<a name="INTRO_COLOR"> + <h2><u>Introduction to coloured text</u></h2> +</a> + +<strong>Mom</strong>'s support for coloured text is straightforward. +You begin by telling <strong>mom</strong> about the colours you want +to with +<a href="#NEWCOLOR">NEWCOLOR</a> +or +<a href="#XCOLOR">XCOLOR</a>. +Afterward, any time you want text to be coloured, you either colour +it with an +<a href="definitions.html#TERMS_INLINES">inline escape</a> +that contains the colour name (e.g. <kbd>\*[red]</kbd> or +<kbd>\*[blue]</kbd>) or invoke the macro, +<a href="#COLOR">COLOR</a>, +with the name of the colour you want. +<a name="COLOR_EXAMPLE"></a> +<p> +For example, say you want to have the name "Jack" in the +sentence "All work and no play makes Jack a dull boy" +appear in yellow. You'd begin by telling <strong>mom</strong> about +the colour, yellow. There are two ways of doing this; see +<a href="#NEWCOLOR">NEWCOLOR</a> +and +<a href="#XCOLOR">XCOLOR</a> +for a full explanation of the difference between the two. If you +use <strong>XCOLOR</strong>, you'd enter this: +<p> +<pre> + .XCOLOR yellow +</pre> + +If you use <strong>NEWCOLOR</strong>, you might enter +<p> +<pre> + .NEWCOLOR yellow RGB #FFFF00 +</pre> + +<a name="COLOR_EXAMPLE2"></a> +After "defining" (or "initializing") the colour +"yellow", you'd colourize the name, Jack, either with an +inline escape +<p> +<pre> + All work and no play makes \*[yellow]Jack\*[black] a dull boy. +</pre> + +or with the <strong>COLOR</strong> macro +<p> +<pre> + All work and no play makes + .COLOR yellow + Jack + .COLOR black + a dull boy. +</pre> + +Notice, in both examples, that a) you have to set the colour back to +black after "Jack", and b) you don't have to define or +intialize the colour, black. <strong>Mom</strong> predefines +"black", "BLACK", "white" and +"WHITE" for you. +<p> +For information on using colour during +<a href="docprocessing.html#INTRO_MACROS_DOCPROCESSING">document processing</a>, +see +<a href="docprocessing.html#COLOR">Colour support in document processing</a>. +<p> +<strong>Please note: Mom</strong>'s colour support is for text only. +She doesn't support "fill" (or "background") +colour for drawn objects. Please also note that if you're +accustomed to using groff's <kbd>.defcolor</kbd> to define colours, +and groff's inline <kbd>\m[<colorname>]</kbd> to call them, you may +continue to do so without confusing <strong>mom</strong>. + +<p> +<a name="MACROS_COLOR"><h3><u>Index of colour macros</u></h3></a> +<ul> + <li><a href="#NEWCOLOR">NEWCOLOR</a> + <li><a href="#XCOLOR">XCOLOR</a> + <li><a href="#COLOR">COLOR</a> + <li><a href="#COLOR_INLINE">\*[<colorname></a> inline escape +</ul> +<p> + +<!---NEWCOLOR---> + +<hr width="66%" align="left"> +<a name="NEWCOLOR"><h3><u>Creating (initializing) a colour with NEWCOLOR</u></h3></a> +<br> +Macro: <strong>NEWCOLOR</strong> <var><colour name> [<colour scheme>] <colour components></var> + +<p> +<strong>NEWCOLOR</strong> lets you create a colour, rather like an +artist mixing paint on a palette. The colour isn't used +immediately; <strong>NEWCOLOR</strong> merely tells +<strong>mom</strong> how to mix the colour when you need it. If +you haven't invoked <strong>NEWCOLOR</strong> (or +<a href="#XCOLOR">XCOLOR</a>), +<strong>mom</strong> doesn't have a clue what you mean when you +reference a colour (with +<a href="#COLOR">COLOR</a> +or +<a href="#COLOR_INLINE">\*[<color name>]</a>). +<p> +The first argument to <strong>NEWCOLOR</strong> is a name for your +colour. It can be anything you like--provided it's just one word +long--and can be caps, lower case, or any combination of the two. +<p> +The second argument, which is entirely optional, is the "colour +scheme" you want <strong>mom</strong> to use when mixing the +colour. Valid arguments are <strong>RGB</strong> (3 components, +red green blue), <strong>CYM</strong> (3 components cyan yellow +magenta), <strong>CMYK</strong> (4 components cyan magenta yellow +black) or <strong>GRAY</strong> (1 component). If you omit the +second argument, <strong>mom</strong> assumes you want RGB. +<p> +The final argument is the components of your colour. This can be +hexadecimal string starting with a pound sign (#) (for colour values +in the 0-255 range) or two pound signs (##) (for colour values +in the 0-65535 range), or it can be a series of decimal digits, +separated by spaces, one digit per component, with the argument +enclosed in double quotes. (If this is all gibberish to you, see +<a href="#COLOR_TIP">Tips for newbies</a>.) +<p> +Thus, to tell <strong>mom</strong> about a colour named +"YELLOW", you could enter one of the following: +<p> +<pre> + .NEWCOLOR YELLOW #FFFF00 \"or ##FFFFFFFF0000 or "1 1 0" + .NEWCOLOR YELLOW RGB #FFFF00 \"or ##FFFFFFFF0000 or "1 1 0" + .NEWCOLOR YELLOW CYM #00FF00 \"or ##0000FFFF0000 or "0 1 0" + .NEWCOLOR YELLOW CYMK #00FF0000 \"or ##0000FFFF00000000 or "1 1 0" +</pre> + +After you've told <strong>mom</strong> about a colour, you can then get +her to set text in that colour either with the inline escape +<a href="#COLOR_INLINE">\*[<colorname>]</a> +or the macro +<a href="#COLOR">COLOR</a>. +(See the +<a href="#COLOR_EXAMPLE">example</a>, +above.) +<br> +<h3><u>Tips for newbies</u></h3> +Colour manipulation can be tremendously confusing if you don't have +a background in graphic arts or computing. My advice, if color +intimidates you, is to stick to using <strong>mom</strong>'s +default RGB colour scheme, and to fire up a color chooser that +gives you the RGB values you want for the colour you select. Plug +those values into the components argument to +<strong>NEWCOLOR</strong>, and you'll get the colour you want. +Both the KDE and gnome desktops have colour selectors that provide +you with the shorter RGB hexadecimal string. If you're not running +KDE or gnome, the X utility, xcolorsel, provides you with a similar +functionality, although it only provides RGB values for 256 +pre-defined colours. If you use xcolorsel, be sure to click the +button "Display format" and select "8 bit truncated +rgb". +<p> +Alternatively, you can use <strong>mom</strong>'s simpler +<a href="#XCOLOR">XCOLOR</a> +macro to initialize one of the 256 pre-defined X colours by +supplying the name of the color as an argument. +<br> + +<!---XCOLOR---> + +<hr width="33%" align="left"> +<a name="XCOLOR"><h3><u>Initializing a colour with XCOLOR</u></h3> +<br> +Macro: <strong>XCOLOR</strong> <var><X color name> [<alias>]</var> +<br> +<em>*<X color name> must be all one word, all lower case. +<br> +(See +<a href="#XCOLOR_NAMES">Finding X color names</a> +for how to get a list of valid colour names.) +</em> +<p> +<strong>XCOLOR</strong> is similar to <strong>NEWCOLOR</strong> in +that it tells <strong>mom</strong> to initialize a colour, but it's +easier to use. All you have to do is pass it, as an argument, the +legal name of one of the 256 pre-defined X colours. The name must +be all one word, and, breaking with <strong>mom</strong> policy, it +must be entered in lower case. +<p> +For example, if you want to intialize the X colour, coral, all you +have to do is enter +<br> +<pre> + .XCOLOR coral +</pre> + +Afterwards +<p> +<pre> + .COLOR coral +</pre> + +will colourize subsequent text coral until you instruct +<strong>mom</strong> to return to black, or some other pre-defined +initialized colour. (The +<a href="definitions.html#TERMS_INLINES">inline escape</a> +<kbd>\*[coral]</kbd> will equally colourize text coral after you've +initialized the colour with <strong>XCOLOR</strong>.) +<p> +The downside of <strong>XCOLOR</strong> is that you can't create +custom colours. This restriction, however, is mitigated by the +fact that for many users, 256 colours is more than enough to play +around with. +<p> +While some X colours have fanciful names (peachpuff, papayawhip, +thistle, snow), many are self-explanatory and self-descriptive in +ordinary colour terms. "blue" is pure (rgb) blue, +"green" is pure (rgb) green, and so on. Furthermore, for +many X colors, there exist four variants, each representing +increasingly darker shades of the same colour. For example, +"blue" (and "blue1") are the brightest forms of +(rgb) blue; "blue2", "blue3" and "blue4" +are increasingly darker shades of the same blue. For that reason, +you may find <strong>XCOLOR</strong> is a better choice than +<strong>NEWCOLOR</strong> when it comes to initializing common +colors. +<p> +The whimsical nature of X colour names sometimes makes for names +that are long to type in, e.g. "mediumspringgreen". +The optional second argument to <strong>XCOLOR</strong> allows you +to come up with more convenient name by which to reference the +colour. For example, you could enter +<p> +<pre> + .XCOLOR mediumspringgreen mygreen + or + .XCOLOR mediumspringgreen MYGREEN +</pre> + +so that whenever you want text mediumspringgreen-ed, you can use +either <kbd>.COLOR mygreen</kbd> (or <kbd>.COLOR MYGREEN</kbd>) or +the inline escape <kbd>\*[mygreen]</kbd> (or +<kbd>\*[MYGREEN]</kbd>.) +<p> +<a name="XCOLOR_NAMES"><h3><u>Finding X color names</u></h3></a> +<br> +There are two ways of finding the names of the pre-defined X +colours. One is to consult the file, rgb.txt, included with +all X11 installations. The location of the file on a Debian +GNU/Linux distribution is typically /etc/X11/rgb.txt. Other +distributions and other X installations may have the file in +another location. The file lists the colour names, but doesn't +show you what the colours actually look like. +<p> +A better way to get the colour names, as well as to see what the +colours look like, is to fire up a colour chooser (like xcolorsel) +that both lists the colour names and shows a swatch of the colour +as well. +<p> +Whichever method you use to find X color names, remember that the +names, passed as arguments to <strong>XCOLOR</strong>, <em>must</em> +be all one word, all in lower case. +<br> + +<!---COLOR---> + +<hr width="33%" align="left"> +<a name="COLOR"><h3><u>Invoking a color</u></h3> +<br> +Macro: <strong>COLOR</strong> <var><colorname></var> +<br> +<a name="COLOR_INLINE">Inline: <strong>\*[<colorname></strong></a> +<p> +<a name="COLOR_INLINE"></a> +Once you've told <strong>mom</strong> about a colour (via +<strong>NEWCOLOR</strong> or <strong>XCOLOR</strong>), you use either +the macro, <strong>COLOR</strong>, or the +<a href="definitions.html#TERMS_INLINES">inline escape</a>, +<kbd>\*[<colorname>]</kbd>, to cause <strong>mom</strong> to +set subsequent text in that colour. See the +<a href="#COLOR_EXAMPLE2">example</a>, +above, which shows both in action. +<p> +<strong>NOTE:</strong> You can use the +<kbd>\*[<colorname>]</kbd> inline escape in any +<a href="docprocessing.html#TOP">document processing</a> +macro that takes a +<a href="definitions.html#TERMS_STRINGARGUMENT">string argument</a>. +However, you must remember to reset the colour at the end of the +argument (typically with <kbd>\*[black]</kbd>) unless you want all +subsequent invocations of that particular macro to be colourized. +<p> +Furthermore, if you use <kbd>\*[<colorname>]</kbd> in the +string argument passed to +<a href="docelement.html#HEAD">.HEAD</a>, +<a href="docelement.html#SUBHEAD">.SUBHEAD</a> +or +<a href="docelement.html#PARAHEAD">.PARAHEAD</a>, +and you've requested that any of these types of heads be numbered, +the numbers themselves will not be coloured, only the text you +passed the macro. If you wish the numbers to be colourized as +well, you must explicitly tell <strong>mom</strong> that you wish +all of the head(s), subhead(s) or parahead(s), including the +numbers, colourized by invoking the appropriate +<a href="docelement.html#DOCELEMENT_CONTROL">control macro</a>. + +<br> + +<hr> +<a href="docprocessing.html#TOP">Next</a> +<a href="inlines.html#TOP">Prev</a> +<a href="#TOP">Top</a> +<a href="toc.html">Back to Table of Contents</a> +</body> +</html> diff --git a/contrib/mom/momdoc/docelement.html b/contrib/mom/momdoc/docelement.html index 988963ff..0ad01b22 100644 --- a/contrib/mom/momdoc/docelement.html +++ b/contrib/mom/momdoc/docelement.html @@ -89,8 +89,8 @@ Equally, can be used in tags that take <a href="definitions.html#TERMS_STRINGARGUMENT">string arguments.</a> <p> -<strong>IMPORTANT NOTE:</strong> The family, font, point size and -leading control macros have no effect in +<strong>IMPORTANT NOTE:</strong> The family, font, point size, +colour and leading control macros have no effect in <a href="docprocessing.html#PRINTSTYLE">PRINTSTYLE TYPEWRITE</a>, which sets EVERYTHING in Courier roman, 12/24 (i.e. 12-point type on a linespace of 24 points). @@ -139,6 +139,22 @@ There's no need for a <a href="definitions.html#TERMS_UNITOFMEASURE">unit of measure</a> with the <strong>_SIZE</strong> control macros; points is assumed. +<h3>Colour</h3> +Control macros that end in <strong>_COLOR</strong> take as their +argument a colour name pre-defined (or "initialized") +with +<a href="color.html#NEWCOLOR">NEWCOLOR</a> +or +<a href="color.html#XCOLOR">XCOLOR</a>. +For example, if you want your heads to be red, once you've defined +or initialized the color, red, +<p> +<pre> + .HEAD_COLOR red +</pre> + +will turn your heads red. + <h3>Lead/linespacing</h3> Control macros that end in <strong>_AUTOLEAD</strong> take the same argument as @@ -208,6 +224,7 @@ arguments as <ul> <li><a href="#LINEBREAK">LINEBREAK</a> <li><a href="#LINEBREAK_CHAR">Linebreak character</a> + <li><a href="#LINEBREAK_COLOR">Linebreak colour</a> </ul> <li><a href="#QUOTE_INTRO">Quotes (line for line)</a> <ul> @@ -235,7 +252,10 @@ arguments as <li><a href="#FINIS_INTRO">Document termination</a> <ul> <li><a href="#FINIS">FINIS</a> - <li><a href="#FINIS_STRING">Finis control</a> -- changing the FINIS string + <ul> + <li><a href="#FINIS_STRING">Changing the FINIS string</a> + <li><a href="#FINIS_COLOR">Changing the FINIS colour</a> + </ul> </ul> <li><a href="#ENDNOTE_INTRO">Endnotes</a> <ul> @@ -326,6 +346,7 @@ See .EPIGRAPH_FAMILY default = prevailing document family; default is Times Roman .EPIGRAPH_FONT default = roman .EPIGRAPH_SIZE default = -1.5 (points) +.EPIGRAPH_COLOR default = black .EPIGRAPH_AUTOLEAD default = 2 points (The next two apply to "block" style epigraphs only) @@ -434,6 +455,7 @@ element tags. <ol> <li><a href="#PP_FAMILY">Family control</a> <li><a href="#PP_FONT">Font control</a> + <li><a href="#PP_COLOR">Paragraph colour</a> <li><a href="#PP_LEADING">Leading/linespacing control</a> <li><a href="#PP_JUST_QUAD">Justification/quad control</a> <li><a href="#PARA_INDENT">First-line indent control</a> @@ -483,7 +505,57 @@ with the appropriate control macros. <strong>Mom</strong>'s default paragraph font is medium roman. <p> -<a name="PP_LEADING"><h3><u>3. Leading</u></h3></a> +<a name="PP_COLOR"><h3><u>3. Paragraph colour</u></h3></a> +<p> +<strong>Mom</strong> has no special control macro for colourizing +paragraphs. If you wish a colourized paragraph, you must use the +macro, +<a href="color.html#COLOR">COLOR</a>, +or the +<a href="definitions.html#TERMS_INLINE">inline escape</a>, +<a href="color.html#COLOR_INLINE">\*[<colorname>]</a>, +<em>after</em> <strong>.PP</strong>. The colour must be one +pre-defined (or "initialized") with +<a href="color.html#NEWCOLOR">NEWCOLOR</a> +or +<a href="color.html#XCOLOR">XCOLOR</a>. +<p> +Please note that unless you change the colour back to it's default +(usually black) at the end of the paragraph, all subsequent +paragraphs will be set in the new colour, although most other +elements of your document will continue to be set in the default +colour (usually black). +<p> +For example, assuming you have defined the colour, blue, +<p> +<pre> + .PP + .COLOR blue + <first paragraph> + .HEAD "Monty Python" + .SUBHEAD "The Origins of Spam" + .PP + <second paragraph> +</pre> + +the first paragraph will be blue, the head and subhead will be in +the document's default colour (usually black), and the second +paragraph will be in blue. +<p> +The one document element that is affected by changing the colour +of paragraphs are +<a href="#PARAHEAD">paraheads</a>, +since they are attached directly to the body of paragraphs. In +other words, if you change the colour of a paragraph and do not +reset the paragraph colour back to its default, subsequent paraheads +will appear in the same colour as your paragraphs unless you have +explicitly told <strong>mom</strong> you want a pre-defined (or +"initialized") color (usually black) for your paraheads. +<p> +See the footnote to +<a href="#PARAHEAD_COLOR">.PARAHEAD_COLOR</a>. + +<a name="PP_LEADING"><h3><u>4. Leading</u></h3></a> <p> The paragraph <a href="definitions.html#TERMS_LEADING">leading</a> @@ -516,7 +588,7 @@ macro. is 16 points, adjusted to fill the page. <p> -<a name="PP_JUST_QUAD"><h3><u>4. Justification/quad</u></h3></a> +<a name="PP_JUST_QUAD"><h3><u>5. Justification/quad</u></h3></a> <p> The justification/quad-direction of regular text paragraphs (i.e. <a href="definitions.html#TERMS_JUST">justified</a>, @@ -562,7 +634,7 @@ paragraphs is <a href="docprocessing.html#PRINTSTYLE">PRINTSTYLE_TYPEWRITE</a> </ul> <p> -<a name="PARA_INDENT"><h3><u>5. First-line indent -- PARA_INDENT</u></h3></a> +<a name="PARA_INDENT"><h3><u>6. First-line indent -- PARA_INDENT</u></h3></a> <p> The first-line indent of paragraphs is controlled by <strong>PARA_INDENT</strong>, which takes one argument: the size @@ -598,7 +670,7 @@ and 3 picas (1/2 inch) for <a href="docprocessing.html#PRINTSTYLE">PRINTSTYLE_TYPEWRITE</a>. <p> -<a name="PARA_INDENT_FIRST"><h3><u>6. Indenting initial paragraphs -- INDENT_FIRST_PARAS</u></h3></a> +<a name="PARA_INDENT_FIRST"><h3><u>7. Indenting initial paragraphs -- INDENT_FIRST_PARAS</u></h3></a> <p> By default, <strong>mom</strong> does not indent the first paragraph of a document, nor the first paragraph after a head or @@ -620,7 +692,7 @@ its effect, meaning that first paragraphs will once again NOT be indented. <p> -<a name="PP_SPACE"><h3><u>7. Spacing paragraphs -- PARA_SPACE</u></h3></a> +<a name="PP_SPACE"><h3><u>8. Spacing paragraphs -- PARA_SPACE</u></h3></a> <p> By default, <strong>mom</strong> does not insert a blank line between paragraphs. If you would like her to do so, invoke the @@ -631,7 +703,8 @@ before or after it any argument (<strong>OFF, QUIT, Q, X</strong>...) cancels its effect, meaning that paragraphs will once again NOT be separated by a blank line. -<p> + +<br> <hr> <!====================================================================> @@ -713,7 +786,7 @@ underlining, and so on. Check them out if you're unhappy with <strong>mom</strong>'s defaults. <p> <ol> - <li><a href="#HEAD_GENERAL">Family/font/size/quad</a> + <li><a href="#HEAD_GENERAL">Family/font/size/colour/quad</a> <li><a href="#HEAD_CAPS">Caps</a> <li><a href="#HEAD_SPACE">Pre-head space</a> <li><a href="#HEAD_UNDERLINE">Underlining</a> @@ -731,6 +804,7 @@ See .HEAD_FAMILY default = prevailing document family; default is Times Roman .HEAD_FONT default = bold .HEAD_SIZE default = +1 (point) +.HEAD_COLOR default = black .HEAD_QUAD default = CENTER </pre> @@ -907,7 +981,7 @@ In addition to the usual family/font/size/quad control macros, there are macros to manage subhead numbering. <p> <ol> - <li><a href="#SUBHEAD_GENERAL">Family/font/size/quad</a> + <li><a href="#SUBHEAD_GENERAL">Family/font/size/colour/quad</a> <li><a href="#NUMBER_SUBHEADS">Numbering</a> <li><a href="#RESET_SUBHEAD_NUMBER">Reset subhead numbering</a> <li><a href="#SUBHEAD_INLINES">Vertical inline escapes inside subheads</a> @@ -922,6 +996,7 @@ See .SUBHEAD_FAMILY default = prevailing document family; default is Times Roman .SUBHEAD_FONT default = bold .SUBHEAD_SIZE default = +.5 (point) +.SUBHEAD_COLOR default = black .SUBHEAD_QUAD default = LEFT </pre> @@ -1013,17 +1088,17 @@ and <a name="PARAHEAD_CONTROL"><h3><u>Parahead control macros</u></h3></a> <p> -In addition to the family/font/size/indent control macros, there are -macros to manage parahead numbering. +In addition to the family/font/size/colour/indent control macros, +there are macros to manage parahead numbering. <p> <ol> - <li><a href="#PARAHEAD_GENERAL">Family/font/size</a> + <li><a href="#PARAHEAD_GENERAL">Family/font/colour/size</a> <li><a href="#PARAHEAD_INDENT">Indent</a> <li><a href="#NUMBER_PARAHEADS">Numbering</a> <li><a href="#RESET_PARAHEAD_NUMBER">Reset parahead numbering</a> </ol> <p> -<a name="PARAHEAD_GENERAL"><h3><u>1. Family/font/size</u></h3></a> +<a name="PARAHEAD_GENERAL"><h3><u>1. Family/font/size/colour</u></h3></a> <p> See <a href="#CONTROL_MACRO_ARGS">Arguments to the control macros</a>. @@ -1032,6 +1107,14 @@ See .PARAHEAD_FAMILY default = prevailing document family; default is Times Roman .PARAHEAD_FONT default = bold italic .PARAHEAD_SIZE default = +.5 (point) +<a name="PARAHEAD_COLOR">.PARAHEAD_COLOR default = black*</a> + +*If you colourize paragraph text, paraheads will appear in the same +colour as the text unless you explicitly tell mom to colour them +otherwise by invoking .PARAHEAD_COLOR. If you do want paraheads +that are coloured the same as paragraph text, it's generally a good +idea to invoke .PARAHEAD_COLOR anyway (with the same colour used +for paragraph text), just to let mom know. </pre> <a name="PARAHEAD_INDENT"><h3><u>2. Indent</u></h3></a> @@ -1180,7 +1263,17 @@ position (for <a href="docprocessing.html#PRINTSTYLE">PRINTSTYLE TYPESET</a>; the vertical adjustment is -2 points for <a href="docprocessing.html#PRINTSTYLE">PRINTSTYLE TYPEWRITE</a>). + +<h3><u>Linebreak colour control macro</u></h3> +<p> +<a name="LINEBREAK_COLOR"> + Macro: <strong>LINEBREAK_COLOR</strong> <var><color name></var> +</a> <p> +To change the colour of the linebreak character(s), simply invoke +<strong>LINBREAK_COLOR</strong> with the name of a pre-defined (or +"initialized") colour. +<br> <hr> <!====================================================================> @@ -1244,7 +1337,7 @@ as does the control macro <p> <a name="QUOTE_TIP"><strong>TIP:</strong></a> If you want to include snippets of programming code in -<strong>mom</strong> documents, you may come a cropper of the fact +<strong>mom</strong> documents, you may come acropper of the fact that groff (and <strong>mom</strong>'s) escape character is the backslash. In order for <strong>mom</strong> not to interpret backslashes that occur in code snippets as escapes, you have to @@ -1311,7 +1404,7 @@ argument (e.g. OFF, END, X, Q...) to turn it off. Example: <a name="QUOTE_CONTROL"><h3><u>Quote control macros</u></h3></a> <ol> - <li><a href="#QUOTE_GENERAL">Family/font/size/indent</a> + <li><a href="#QUOTE_GENERAL">Family/font/size/colour/indent</a> <li><a href="#ALWAYS_FULLSPACE_QUOTES">Spacing above and below (typeset only)</a> <li><a href="#UNDERLINE_QUOTES">Underline quotes (typewrite only)</a> <li><a href="#BREAK_QUOTE">Manually break a footnoted quote that crosses pages/columns</a> @@ -1326,6 +1419,7 @@ See .QUOTE_FAMILY default = prevailing document family; default is Times Roman .QUOTE_FONT default = italic .QUOTE_SIZE default = +0 (i.e. same size as paragraph text) +.QUOTE_COLOR default = black <a name="QUOTE_INDENT">.QUOTE_INDENT default = paragraph indent x 3 (typeset); x 2 (typewrite)</a> (note that this macro also sets the indents (left and right) for blockquotes) @@ -1465,7 +1559,7 @@ in any of the tag's control macros. <a name="BLOCKQUOTE_CONTROL"><h3><u>Blockquote control macros</u></h3></a> <ol> - <li><a href="#BLOCKQUOTE_GENERAL">Family/font/size/indent</a> + <li><a href="#BLOCKQUOTE_GENERAL">Family/font/size/colour/indent</a> <li><a href="#ALWAYS_FULLSPACE_QUOTES">Spacing above and below (typeset only)</a> <li><a href="#BREAK_QUOTE">Manually break a footnoted blockquote that crosses pages/columns</a> </ol> @@ -1479,6 +1573,7 @@ See .BLOCKQUOTE_FAMILY default = prevailing document family; default is Times Roman .BLOCKQUOTE_FONT default = italic .BLOCKQUOTE_SIZE default = -1 (point) +.BLOCKQUOTE_COLOR default = black .QUOTE_INDENT default = paragraph indent x 3 (typeset); x 2 (typewrite)</a> (note that this macro also sets the left indent for quotes) </pre> @@ -1625,7 +1720,6 @@ example, if you want a list enumerated with <strong>=></strong>, </pre> will produce - <p> <pre> => A list item @@ -2003,7 +2097,7 @@ above. <p> <a name="FOOTNOTE_CONTROL"><h3><u>Footnote control macros</u></h3></a> <ol> - <li><a href="#FOOTNOTE_GENERAL">Family/font/size/lead/quad</a> + <li><a href="#FOOTNOTE_GENERAL">Family/font/size/colour/lead/quad</a> <li><a href="#FOOTNOTE_MARKERS">Footnote markers</a> -- on or off <li><a href="#FOOTNOTE_MARKER_STYLE">Footnote marker style</a> -- star+dagger or numbered <li><a href="#RESET_FOOTNOTE_NUMBER">Reset footnote number</a> -- set footnote marker number to 1 @@ -2021,6 +2115,7 @@ See .FOOTNOTE_FAMILY default = prevailing document family; default is Times Roman .FOOTNOTE_FONT default = roman .FOOTNOTE_SIZE default = -2 (points) +.FOOTNOTE_COLOR default = black .FOOTNOTE_AUTOLEAD default = 2 points (typeset); single-spaced (typewrite) .FOOTNOTE_QUAD default = same as paragraphs </pre> @@ -2204,6 +2299,18 @@ short, centred horizontal rule that terminates the document. (In <a href="docprocessing.html.#PRINTSTYLE">PRINTSTYLE TYPEWRITE</a>, it's a short, dashed line composed of four hyphens.) + +<a name="FINIS_COLOR"><h3><u>Changing the FINIS colour</u></h3></a> +<p> +Invoking <strong>FINIS_COLOR</strong> with a pre-defined (or +"initalized") color changes the colour of both the FINIS +string and the em-dashes that surround it. If you use the +<a href="definitions.html#TERMS_INLINE">inline escape</a>, +<a href="color.html#COLOR_INLINE">\*[<colorname>]</a>, +in the argument passed to <strong>FINIS</strong>, only the text +will be in the new colour; the em-dashes will be in the default +document colour (usually black). + <p> <hr> diff --git a/contrib/mom/momdoc/docprocessing.html b/contrib/mom/momdoc/docprocessing.html index 98b2af51..41d58b83 100644 --- a/contrib/mom/momdoc/docprocessing.html +++ b/contrib/mom/momdoc/docprocessing.html @@ -8,7 +8,7 @@ <!====================================================================> <a href="docelement.html#TOP">Next</a> -<a href="inlines.html#TOP">Prev</a> +<a href="color.html#TOP">Prev</a> <a href="toc.html">Back to Table of Contents</a> <p> <a name="TOP"></a> @@ -50,6 +50,9 @@ <li><a href="#STYLE_BEFORE_START"><strong>Changing type/style parameters prior to START</strong></a> <ul> <li><a href="#TYPE_BEFORE_START">Using typesetting macros prior to START</a> + <ul> + <li><a href="#COLOR">Colour</a> + </ul> <li><a href="#DOC_LEAD_ADJUST">Adjusting document leading to fill pages -- DOC_LEAD_ADJUST</a> <li><a href="#DOCHEADER">Managing the document header</a> <ul> @@ -1087,6 +1090,23 @@ as well as in page headers. <a href="headfootpage.html#HEADER_STYLE">Default specs for headers</a> for how <strong>mom</strong> outputs each part of the page header.) <p> +Additionally, if you wish the name of this particular kind of +document to be coloured, you can pass <strong>DOCTYPE NAMED</strong> +a third (optional) argument: the name of a colour pre-defined (or +"initialized") with +<a href="color.html#NEWCOLOR">NEWCOLOR</a> +or +<a href="color.html#XCOLOR">XCOLOR</a>. +For example, if you have a doctype named "Warning", and +you'd like "Warning" to be in red, assuming you've +pre-defined (or "initialized") the color, red, this is +what the <strong>DOCTYPE</strong> entry would look like: +<p> +<pre> + .DOCTYPE NAME "Warning" red +</pre> + +<p> <strong>LETTER</strong> tells mom you're writing a letter. See the section <a href="letters.html#INTRO">Writing Letters</a> @@ -1394,29 +1414,34 @@ the (below) have the following meanings: <p> <pre> - L_MARGIN Left margin of pages, including headers/footers - R_MARGIN Right margin of pages, including headers/footers - T_MARGIN The point at which running text (i.e. not - headers/footers or page numbers) starts on each page - *B_MARGIN The point at which running text (i.e. not - (see note) headers/footers or page numbers) ends on each page - - PAGE If you use PAGE, its final four arguments have the - same meaning as L_ R_ T_ and B_MARGIN above.) - - LL The line length for everything on the page; - equivalent to setting the right margin with R_MARGIN - FAMILY The family of all type in the document - PT_SIZE The point size of type in paragraphs; mom uses this - calculate automatic point size changes (e.g. for heads, - footnotes, quotes, headers, etc) - **LS/AUTOLEAD The leading used in paragraphs; all leading and spacing - of running text is calculated from this - QUAD Affects paragraphs only + L_MARGIN Left margin of pages, including headers/footers + R_MARGIN Right margin of pages, including headers/footers + T_MARGIN The point at which running text (i.e. not + headers/footers or page numbers) starts on each page + B_MARGIN* The point at which running text (i.e. not + (see note) headers/footers or page numbers) ends on each page + + PAGE If you use PAGE, its final four arguments have the + same meaning as L_ R_ T_ and B_MARGIN above.) + + LL The line length for everything on the page; + equivalent to setting the right margin with R_MARGIN + FAMILY The family of all type in the document + PT_SIZE The point size of type in paragraphs; mom uses this + calculate automatic point size changes (e.g. for heads, + footnotes, quotes, headers, etc) + LS/AUTOLEAD** The leading used in paragraphs; all leading and spacing + of running text is calculated from this + + QUAD/JUSTIFY Affects paragraphs only + LEFT No effect*** + RIGHT No effect*** + CENTER No effect*** ------ - *See <a href="headfootpage.html#FOOTER_MARGIN">FOOTER MARGIN AND BOTTOM MARGIN</a> for an important warning -**See <a href="#DOC_LEAD_ADJUST">DOC_LEAD_ADJUST</a> + *See <a href="headfootpage.html#FOOTER_MARGIN">FOOTER MARGIN AND BOTTOM MARGIN</a> for an important warning + **See <a href="#DOC_LEAD_ADJUST">DOC_LEAD_ADJUST</a> +***See <a href="#LRC_NOTE">Special note</a> </pre> Other macros that deal with type style, or refinements thereof @@ -1429,7 +1454,55 @@ If you want to change any of the basic parameters (above) document globally (as if you'd entered them <em>before</em> <strong>START</strong>), you must use the macros listed in <a href="#DOC_PARAM_MACROS">Changing document-wide style parameters after START</a>. + +<a name="LRC_NOTE"></a> +<h3><u>Special note on .LEFT, .RIGHT and .CENTER prior to START</u></h3> +<p> +In a word, these three macros have no effect on document processing +when invoked prior to <strong>START</strong>. +<p> +All <strong>mom</strong>'s document element tags +(<strong>PP</strong>, <strong>HEAD</strong>, +<strong>BLOCKQUOTE</strong>, <strong>FOOTNOTE</strong>, etc.) +except +<a href="docelement.html#QUOTE">QUOTE</a> +set a +<a href="definitions.html#TERMS_FILLED">fill mode</a> +as soon as they're invoked. If you wish to turn fill mode off for +the duration of any tag (with +<a href="typesetting.html#LRC">.LEFT, .RIGHT or .CENTER</a>) +you must do so immediately after invoking the tag. Furthermore, +the change affects <em>only</em> the current invocation of the tag. +Subsequent invocations of the same tag for which you want the same +change require that you invoke <strong>LEFT</strong>, +<strong>RIGHT</strong> or <strong>CENTER</strong> immediately after +every invocation of the tag. + +<!---COLOR---> +<a name="COLOR"><h2><u>Colour</u></h2></a> + +Although it doesn't really matter where you define/initialize +colours for use in document processing (see +<a href="color.html#NEWCOLOR">NEWCOLOR</a> +and +<a href="color.html#XCOLOR">XCOLOR</a> +in the section +<a href="color.html#COLOR_INTRO">Coloured text</a>), +I recommend doing so before you begin document processing with +<a href="#START">START</a>. <p> +The macro, +<a href="color.html#COLOR">COLOR</a>, +and the +<a href="definitions.html#TERMS_INLINES">inline escape</a>, +<a href="color.html#COLOR_INLINE">\[<colorname>]</a>, +can be used at any time during document processing for occasional +colour effects. However, consistent and reliable colourizing of +various document elements (the docheader, heads, linebreaks, +footnotes, pagenumbers, and so on) must be managed through the use +of the +<a href="docelement.html#DOCELEMENT_CONTROL">document element control macros</a>. +<br> <!---DOC_LEAD_ADJUST---> @@ -1602,6 +1675,25 @@ is CHAPTER, The <a href="definitions.html#TERMS_FAMILY">family</a> is the prevailing family of the whole document. +<p> +<strong>NOTE:</strong> If your <strong>DOCTYPE</strong> is +<strong>CHAPTER</strong> and you have both "Chapter #" +and a "Chapter Title" (as above), you may find the +<a href="definitions.html#TERMS_LEADING">leading</a> +a bit cramped (owing to <strong>mom</strong>'s default docheader +leading. If this is the case, you can adjust the leading either +with +<a href="#ADJUST_LEADING">DOCHEADER_LEAD</a> +or by including the +<a name="definitions.html#TERMS_INLINES">inline escape</a>, +<a href="inlines.html#DOWN">\*[DOWN]</a>, +in the argument you pass to +<a href="#CHAPTER_TITLE">CHAPTER_TITLE</a>, like this: +<p> +<pre> + .CHAPTER_TITLE "\*[DOWN 2p]Why Not Patent Calculus?" +</pre> + <h3><u>The docheader macros to:</u></h3> <ol> @@ -1609,6 +1701,7 @@ is the prevailing family of the whole document. <li><a href="#ADJUST_LEADING">Adjust the docheader leading</a> <li><a href="#CHANGE_FAMILY">Change the family of docheader elements</a> <li><a href="#CHANGE_FONT">Change the font of docheader elements</a> + <li><a href="#CHANGE_COLOR">Change the colour of the docheader</a> <li><a href="#CHANGE_SIZE">Adjust the size of docheader elements</a> <li><a href="#CHANGE_ATTRIBUTE">Change the attribution string ("by")</a> </ol> @@ -1713,7 +1806,47 @@ they do for <a href="typesetting.html#FONT">FT</a>. <p> -<a name="CHANGE_SIZE"><h3><u>5. Adjust the size of docheader elements</u></h3></a> +<a name="CHANGE_COLOR"><h3><u>5. Change the colour of the docheader</u></h3></a> +<p> +The following macros let you change the color of each docheader +element separately. You must pre-define (or +"initialize") the color with +<a href="color.html#NEWCOLOR">NEWCOLOR</a> +or +<a href="color.html#XCOLOR">XCOLOR</a>. +<p> +<ul> +<li><strong>TITLE_COLOR</strong> <var><colorname></var> +<li><strong>SUBTITLE_COLOR</strong> <var><colorname></var> +<li><strong>ATTRIBUTE_COLOR</strong> <var><colorname></var> +(the "by" string that precedes the author[s] name[s]) +<li><strong>AUTHOR_COLOR</strong> <var><colorname></var> +<li><strong>DOCTYPE_COLOR</strong> <var><colorname></var> (if +<a href="#DOCTYPE">DOCTYPE</a> is NAMED) +</ul> +<p> +It is not recommended that you embed colour (with the +<a href="definitions.html#TERMS_INLINES">inline escape</a>, +<a href="color.html#COLOR_INLINE">\*[<colorname>]</a>) +in the strings passed to +<strong>TITLE</strong>, <strong>SUBTITLE</strong>, +<strong>AUTHOR</strong> or the name you give <strong>DOCTYPE +NAMED</strong>. The strings passed to these macros are used to +generate page +<a href="definitions.html#TERMS_HEADER">headers</a> +and +<a href="definitions.html#TERMS_FOOTER">footers</a>. +An embedded colour will cause the string to be colourized any time +it appears in headers or footers. (If you want headers or footers +colourized, or parts thereof, use the header/footer control macros +<p> +If you want to colourize the entire docheader, use the macro +<p> +<ul> +<li><strong>DOCHEADER_COLOR</strong> <var><color name></var>. +</ul> + +<a name="CHANGE_SIZE"><h3><u>6. Adjust the size of docheader elements</u></h3></a> <p> The following macros let you adjust the point size of each docheader element separately. @@ -1748,7 +1881,7 @@ default = +3 Simply pass the appropriate macro the size adjustment you want. <p> -<a name="CHANGE_ATTRIBUTE"><h3><u>6. Change the attribution string ("by")</u></h3></a> +<a name="CHANGE_ATTRIBUTE"><h3><u>7. Change the attribution string ("by")</u></h3></a> <p> If you're not writing in English, you can change what <strong>mom</strong> prints where "by" appears in @@ -1856,6 +1989,19 @@ when the is <strong>TYPEWRITE</strong>. The notion of typewriter-style output in columns is just too ghastly for her to bear. +<h3><u>Using tabs when COLUMNS are enabled</u></h3> +<strong>Mom</strong>'s tabs +(both +<a href="typesetting.html#TYPESETTING_TABS">typesetting tabs</a> +and +<a href="typesetting.html#STRING_TABS">string tabs</a>) +behave normally during document processing EXCEPT when +<strong>COLUMNS</strong> are enabled. Your tabs will work in the +document column in which they were originally set, but not across +columns. When <strong>mom</strong> (or you) breaks to a new column, +you must redefine your tabs to make them function properly in the +new column. + <a name="BREAKING_COLUMNS"></a> <h3><u>Breaking columns manually</u></h3> <strong>Mom</strong> takes care of breaking columns when they reach @@ -2115,7 +2261,7 @@ for an explanation of how to disable this default behaviour. <hr> <a href="docelement.html#TOP">Next</a> -<a href="inlines.html#TOP">Prev</a> +<a href="color.html#TOP">Prev</a> <a href="#TOP">Top</a> <a href="toc.html">Back to Table of Contents</a> </body> diff --git a/contrib/mom/momdoc/goodies.html b/contrib/mom/momdoc/goodies.html index b152b50b..d1abd4cc 100644 --- a/contrib/mom/momdoc/goodies.html +++ b/contrib/mom/momdoc/goodies.html @@ -252,7 +252,7 @@ Macro: <strong>SMARTQUOTES</strong> <var>[<off>] [ ,, | >> | << <br> or <br> -Macro: <strong>SMARTQUOTES</strong> <var>DA | DE | EN | ES | FR | IT | NL | NO | PT | SV</var> +Macro: <strong>SMARTQUOTES</strong> <var>DA | DE | ES | FR | IT | NL | NO | PT | SV</var> <p> If you invoke <strong>SMARTQUOTES</strong> without an argument, @@ -672,23 +672,20 @@ Basically, what the example does is: <ol> <li>Pads the Date/Signature line (using the pad marker #), encloses the padded space with two string tabs markers, - and outputs the line + and outputs the line. <br> <li>Sets the two string tabs (notice the use of <a href="#EL">EL</a> beforehand; you don't want <strong>mom</strong> - to advance a line at this point) + to advance a line at this point). <br> <li>Calls the first string tab and draws a rule to its full - length (<kbd>\l'\n(.lu'</kbd>; for an easier way to draw a rule - that fills a tab, see - <a href="inlines.html#INLINE_RULE_MOM">Full measure - rules</a>). + length. <br> <li>Calls the second tab with <a href="#TN">TN</a> (which moves to tab 2 and stays on the same baseline) - then draws a rule to the full length of string tab 2 + then draws a rule to the full length of string tab 2. </ol> <br> Often, when setting up string tabs this way, you don't want the diff --git a/contrib/mom/momdoc/headfootpage.html b/contrib/mom/momdoc/headfootpage.html index 5ac3c083..291a28f7 100644 --- a/contrib/mom/momdoc/headfootpage.html +++ b/contrib/mom/momdoc/headfootpage.html @@ -57,6 +57,7 @@ <ul> <li><a href="#HDRFTR_RULE">HEADER_RULE</a> -- on or off <li><a href="#HDRFTR_RULE_GAP">HEADER_RULE_GAP</a> -- distance of rule from header/footer + <li><a href="#HDRFTR_RULE_COLOR">HEADER_RULE_COLOR</a> -- colour of the header/footer rule </ul> </ul> <li><a href="#PAGINATION">Pagination</a> @@ -167,6 +168,7 @@ TYPE SPEC HEADER LEFT HEADER CENTER HEADER RIGHT --------- ----------- ------------- ------------ Family document default document default document default Font roman italic roman +Colour (black) (black) (black) All caps no no yes Size* -.5 (points) -.5 (points) -2 (points) (-2 if all caps) (-2 if all caps) (-.5 if not all caps) @@ -463,7 +465,10 @@ place of <strong>LEFT, CENTER</strong> and surrounded by double-quotes, containing what you want in the header. <strong>HEADER_RECTO</strong> disables <strong>mom</strong>'s normal 3-part headers, therefore anything you want in the -headers must be entered by hand in the string. +headers must be entered by hand in the string, including colours +(via the +<a href="definitions.html#TERMS_INLINES">inline escape</a> +<a href="color.html#COLOR_INLINE">\*[<colorname>]</a>). <p> By default, <strong>HEADER_RECTO</strong> is set at the same size, and in the same family and font, as paragraph text. The @@ -548,8 +553,8 @@ macro, which changes the default pad marker (<kbd>#</kbd>) used by has no effect on the pad marker used in the <strong>HEADER_RECTO</strong> string. If you absolutely must have a literal pound sign in your <strong>HEADER_RECTO</strong> -string, use the escape sequence <kbd>\N'35'</kbd> where you want -the pound sign to go. +string, use the escape sequence for the pound sign +(<kbd>\[sh]</kbd>) where you want the pound sign to go. <p> <hr> @@ -584,7 +589,8 @@ can be designed to your own specifications. <li><a href="#HDRFTR_STYLE_GLOBAL"><strong>Global changes</strong></a> <li><a href="#HDRFTR_GLOBAL_FAMILY">HEADER_FAMILY</a> -- family for entire header <li><a href="#HDRFTR_GLOBAL_SIZE">HEADER_SIZE</a> -- size for entire header - <li><a href="HDRFTR_PLAIN">HDRFTR_PLAIN</a> -- disable default adjustments to header parts + <li><a href="#HDRFTR_PLAIN">HEADER_PLAIN</a> -- disable default adjustments to header parts + <li><a href="#HDRFTR_COLOR">HEADER_COLOR</a> -- colourize the header </ul> <ul> <li><a href="#HDRFTR_STYLE_PART"><strong>Part-by-part changes</strong></a> @@ -592,6 +598,7 @@ can be designed to your own specifications. <li><a href="#_FONT">_FONT</a> -- left, centre or right font <li><a href="#_SIZE">_SIZE</a> -- left, centre or right size <li><a href="#_CAPS">_CAPS</a> -- left, centre or right all caps + <li><a href="#_COLOR">_COLOR</a> -- left, centre or right colour </ul> <li><a href="#HDRFTR_VERTICAL"><strong>VERTICAL PLACEMENT AND SPACING</strong></a> <ul> @@ -602,6 +609,7 @@ can be designed to your own specifications. <ul> <li><a href="#HDRFTR_RULE">HEADER_RULE</a> <li><a href="#HDRFTR_RULE_GAP">HEADER_RULE_GAP</a> + <li><a href="#HDRFTR_RULE_COLOR">HEADER_RULE_COLOR</a> </ul> </ul> @@ -789,8 +797,9 @@ position. <a name="PAGE_NUMBER_SYMBOL"> <h3><u>*Replacing header-left, -CENTER or -right with the page number</u></h3> </a> +<p> If you would like to have the current page number to appear -header-left, -CENTER, or -right <em>instead</em> of a text +header-left, -center, or -right <em>instead</em> of a text string, invoke the appropriate macro, above, with the single argument <code>#</code> (the "number" or "pound" sign). Do <strong>NOT</strong> use @@ -807,6 +816,7 @@ headers. <a name="PAGE_NUMBER_INCL"> <h3><u>*Including the page number in header-left, -CENTER or -right</u></h3> </a> +<p> If you would like to <em>include</em> the current page number in the string you pass to <strong>HEADER_LEFT, _CENTER,</strong> or <strong>_RIGHT</strong>, use the special @@ -845,6 +855,7 @@ Please note that <strong>HEADER_FAMILY</strong> and <li><a href="#HDRFTR_GLOBAL_FAMILY">HEADER_FAMILY</a> <li><a href="#HDRFTR_GLOBAL_SIZE">HEADER_SIZE</a> <li><a href="#HDRFTR_PLAIN">HEADER_PLAIN</a> + <li><a href="#HDRFTR_COLOR">HEADER_COLOR</a> </ul> <hr width="33%" align="left"> @@ -935,6 +946,32 @@ with <strong>FOOTER_</strong> to disable <strong>mom</strong>'s default behaviour for the various elements of footer style. <p> +<hr width="33%" align="left"> +<p> +<a name="HDRFTR_COLOR"> + Macro: <strong>HEADER_COLOR</strong> <var><colorname></var> +</a> + +<p> +If you want your headers in a colour different from the document +default (usually black), invoke <strong>HEADER_COLOR</strong> with +the name of a colour pre-defined (or "initialized") with +<a href="color.html#NEWCOLOR">NEWCOLOR</a> +or +<a href="color.html#XCOLOR">XCOLOR</a>. +<p> +<strong>HEADER_COLOR</strong> will set all the parts of the header +AND the header rule in the colour you give it as an argument. If +you wish finer control over colour in headers, you can use +<a href="#_COLOR">HEADER_<POSITION>_COLOR</a> +to colourize each part of the header separately, as well as +<a href="#HDRFTR_RULE_COLOR">HEADER_RULE_COLOR</a> +to change the colour of the header rule. +<p> +<strong>NOTE:</strong> Replace <strong>HEADER_</strong>, above, +with <strong>FOOTER_</strong> to colourize footers. +<p> + <hr width="66%" align="left"> <p> <a name="HDRFTR_STYLE_PART"><strong>Part by part changes</strong></a> @@ -948,6 +985,7 @@ or <strong>RIGHT</strong> as appropriate. <li><a href="#_FONT">HEADER_<POSITION>_FONT</a> <li><a href="#_SIZE">HEADER_<POSITION>_SIZE</a> <li><a href="#_CAPS">HEADER_<POSITION>_CAPS</a> + <li><a href="#_COLOR">HEADER_<POSITION>_COLOR</a> </ul> <hr width="33%" align="left"> @@ -1024,6 +1062,49 @@ QUIT, END, X...</strong>). <strong>NOTE:</strong> Replace <strong>HEADER_</strong>, above, with <strong>FOOTER_</strong> to change a footer part's capitalization style. + +<p> +<hr width="33%" align="left"> +<p> +<a name="_COLOR"> + Macro: <strong>HEADER_<POSITION>_COLOR</strong> <var><colorname></var> +</a> +<p> +<strong>HEADER_<POSITION>_COLOR</strong> allows you to set a +colour for each of the three possible parts of a page header +separately. For example, say you want the right part of the header +(by default, the document title) in red, this is how you'd get it: +<p> +<pre> + .HEADER_RIGHT_COLOR red +</pre> + +The other parts of the header will be in the default header colour +(usually black, but that can be changed with +<a href="#HDRFTR_COLOR">HEADER_COLOR</a>). +<p> +Remember that you have to define (or "initialize") a +colour with +<a href="color.html#NEWCOLOR">NEWCOLOR</a> +or +<a href="color.html#XCOLOR">XCOLOR</a> +before you can use the colour. +<p> +If you create a +<a href="#USERDEF_HDRFTR">user-defined header</a> +with +<a href="#HDRFTR_RECTO">HEADER_RECTO</a> +or +<a href="#HDRFTR_VERSO">HEADER_VERSO</a>, +and you want various elements within the header to be colourized, +embed the colours in the string passed to <strong>HEADER_RECTO</strong> +or <strong>HEADER_VERSO</strong> with the +<a href="color.html#COLOR_INLINE">\*[<colorname>]</a> +<a href="definitions.html#TERMS_INLINES">inline escape</a>. +<p> +<strong>NOTE:</strong> Replace <strong>HEADER_</strong>, above, +with <strong>FOOTER_</strong> to set the colours for the various +elements of footers. <p> <hr> @@ -1090,7 +1171,7 @@ and the margin's too close to <strong>mom</strong>'s default footer margin (or a footer margin you set yourself with <strong>FOOTER_MARGIN</strong>), <strong>mom</strong> will not print your footers; additionally, she'll give you a warning -on and some advice on standard error. When this happens, you must +and some advice on standard error. When this happens, you must reset either <strong>B_MARGIN</strong> or <strong>FOOTER_MARGIN</strong> so there's an adequate amount of space for <strong>mom</strong> to print the bottom line of running @@ -1308,6 +1389,33 @@ Inline changes to the size of type in <strong>FOOTER_RECTO</strong> and <strong>FOOTER_VERSO</strong> should always be negative (smaller) than the default. <p> + +<!---HDRFTR_RULE_COLOR---> + +<hr width="66%" align="left"> +<p> +<a name="HDRFTR_RULE_COLOR"></a> +Macro: <strong>HEADER_RULE_COLOR</strong> <var><colorname></var> + +<p> +If you wish to change the colour of the header rule, invoke +<strong>HEADER_RULE_COLOR</strong> with the name of a colour +pre-defined (or "initialized") with +<a href="color.html#NEWCOLOR">NEWCOLOR</a> +or +<a href="color.html#XCOLOR">XCOLOR</a>. +<p> +Please note that <strong>HEADER_RULE_COLOR</strong> overrides the +colour set with +<a href="#HDRFTR_COLOR">HDRFTR_COLOR</a>, +so that it's possible to have the heads entirely in, say, blue (set +with <strong>HEADER_COLOR</strong>), and the header rule in, say, +red. +<p> +<strong>NOTE:</strong> Replace <strong>HEADER_</strong>, above, +with <strong>FOOTER_</strong> to change the colour of the footer +rule. +<p> <hr> <a name="PAGINATION"> diff --git a/contrib/mom/momdoc/inlines.html b/contrib/mom/momdoc/inlines.html index dd486e45..7302529f 100644 --- a/contrib/mom/momdoc/inlines.html +++ b/contrib/mom/momdoc/inlines.html @@ -7,7 +7,7 @@ <!====================================================================> -<a href="docprocessing.html#TOP">Next</a> +<a href="color.html#TOP">Next</a> <a href="goodies.html#TOP">Prev</a> <a href="toc.html">Back to Table of Contents</a> @@ -361,10 +361,27 @@ example: </pre> The above draws a rule the full measure of the 6-pica line length. -Please note that <strong>\*[$RULE]</strong> should appear on a line by -itself and that it draws the rule to the full measure, hence it -<em>cannot</em> be used to fill the remainder of a partial line with -a rule in this way: +<p> +<strong>\*[$RULE]</strong> should appear on a line by itself. In +<a href="definitions.html#TERMS_FILLED">fill modes</a>, +(i.e. +<a href="typesetting.html#QUAD">QUAD</a> +or +<a href="typesetting.html#JUSTIFY">JUSTIFY</a>), +it requires a +<a href="typesetting.html#BR">.BR</a> +on the line immediately before it; in +<a href="definitions.html#TERMS_NOFILL">nofill modes</a> +(i.e +<a href="typesetting.html#LRC">LEFT</a>, +<a href="typesetting.html#LRC">RIGHT</a> +or +<a href="typesetting.html#LRC">CENTER</a>), +the <strong>.BR</strong> is not required. +<p> +Please note that <strong>\*[$RULE]</strong> draws the rule to the +full measure, hence it <em>cannot</em> be used to fill the remainder +of a partial line with a rule in this way: <p> <pre> Signature__________________________________________ @@ -375,8 +392,9 @@ If you wish to accomplish this effect, you have to use <a href="goodies.html#PAD"><strong>PAD</strong></a> macro and <a href="typesetting.html#STRING_TABS">string tabs</a>. -(See the example provided with -<a href="goodies.html#PAD_EXAMPLE">.PAD</a>. +(See the +<a href="goodies.html#PAD_EXAMPLE">example</a> +provided with <strong>PAD</strong>.) <p> See groff's <a href="#INLINE_LINEDRAWING_GROFF">Horizontal line drawing function</a> @@ -620,7 +638,7 @@ the groff <strong>info</strong> documentation, or man groff_char. </pre> <hr> -<a href="docprocessing.html#TOP">Next</a> +<a href="color.html#TOP">Next</a> <a href="goodies.html#TOP">Prev</a> <a href="#TOP">Top</a> <a href="toc.html">Back to Table of Contents</a> diff --git a/contrib/mom/momdoc/reserved.html b/contrib/mom/momdoc/reserved.html index 70202351..423661c5 100644 --- a/contrib/mom/momdoc/reserved.html +++ b/contrib/mom/momdoc/reserved.html @@ -49,11 +49,12 @@ T_MARGIN Advance lead from page top Page control ------------ -DO_B_MARGIN Margin at bottom of page -DO_T_MARGIN Margin at top of page +DO_B_MARGIN Margin at bottom of page; trap-invoked +DO_T_MARGIN Margin at top of page; trap-invoked Style ----- +COLOR Change color of text to predefined value CONDENSE Set percentage of pseudo-condense (alias of CONDENSE_OR_EXTEND) EXTEND Set percentage of pseudo-extend (alias of @@ -62,9 +63,11 @@ FAMILY Family FT Font LL Line length LS Leading (.vs) +NEWCOLOR Define a text color PT_SIZE Point size SETBOLDER Set degree of emboldening (pseudo-bold) in units SETSLANT Set degree of pseudo-italic +XCOLOR Initialize a color from rgb.txt Autolead -------- @@ -308,6 +311,7 @@ u Horiz position of start of underscore +++STRINGS+++ $COND_PERCENT Percentage by which to pseudo-condense type +$COLOR_SCHEME Color scheme used in NEWCOLOR $CURRENT_QUAD Restores current quad value in RULE $CURRENT_TAB Current tab number $DC_ADJUST +|- # of points to subtract from dropcap @@ -337,6 +341,10 @@ $WS_CONSTANT 12; used to hold groff default wordspace $WS Holds WS value; concatenation of WS_CONSTANT and WS_VAR $WS_VAR + or - value to add to $WS_CONSTANT +BLACK Pre-defined black color +black Pre-defined black color +WHITE Pre-defined white color +white Pre-defined white color +++ALIASES+++ @@ -344,6 +352,7 @@ ALIAS als ALIASN aln BR br CENTRE CENTER +COLOUR COLOR COMMENT SILENT CONDENSE CONDENSE_OR_EXTEND EXTEND CONDENSE_OR_EXTEND @@ -355,6 +364,7 @@ LIG LIGATURES LL LINE_LENGTH MAC de NEW_PAGE bp +NEWCOLOUR NEWCOLOR NEWPAGE NEW_PAGE PAGELENGTH PAGE_LENGTH PAGE_LENGTH pl @@ -366,6 +376,7 @@ TABSET TAB_SET TB TAB TI IT UNDERSCORE_2 UNDERSCORE2 +XCOLOUR XCOLOR +++ALIASES FOR NUMBER REGISTERS+++ @@ -491,6 +502,7 @@ ATTRIBUTE_STRING What to print before author (default is "by") AUTHOR_FAMILY Family to use for author in doc header AUTHOR_FONT Font to use for author in doc header AUTHOR_SIZE ps to use for author in doc header +BLOCKQUOTE_COLOR Blockquote color BLOCKQUOTE_FAMILY Family to use in blockquotes BLOCKQUOTE_FONT Font to use in blockquotes BLOCKQUOTE_QUAD How to quad blockquotes @@ -503,11 +515,12 @@ CHAPTER_TITLE_SIZE ps in/decrease of chapter title (relative to size of running text) COLUMNS Print in columns DOC_FAMILY Overall doc family +DOCHEADER Print doc header? DOCHEADER_ADVANCE Start position of docheader (relative to top of page) +DOCHEADER_COLOR Color of docheader DOCHEADER_LEAD +|- value applied to #DOC_LEAD to in/decrease leading of doc header -DOC_HEADER Print doc header? DOC_LEAD_ADJUST Adjust #DOC_LEAD to fill page to #B_MARGIN DOC_LEAD Overall doc leading DOC_LEFT_MARGIN Doc left margin @@ -523,60 +536,65 @@ DOCTYPE_FAMILY Family to use for doctype string in doc header DOCTYPE_FONT Font to use for doctype string in doc header DOCTYPE_SIZE ps to use for doctype string in doc header DOCTYPE Type of doc (DEFAULT, CHAPTER, NAMED, LETTER) -DO_QUOTE Print quote (invoked from QUOTE or BLOCKQUOTE) +DO_QUOTE Print quote (invoked internally from QUOTE or + BLOCKQUOTE) DRAFT_STRING What to print whenever the word "draft" is required DRAFT_WITH_PAGENUMBER Attach draft/revision info to page number (instead of putting it HEADER centre) -ENDNOTE_FAMILY Family for endnotes -ENDNOTE_FONT Font for endnotes -ENDNOTE_LEAD Leading for endnotes page -ENDNOTE_PARA_INDENT First line indent of paras in multi-para - endnotes -ENDNOTE_PARA_SPACE Whether to space paras in multi-para endnotes -ENDNOTE_PT_SIZE Base point size for endnotes page -ENDNOTE_QUAD Endnote quad -ENDNOTE_STRING Endnotes page head -ENDNOTE_STRING_CAPS Capitalize the endnotes string -ENDNOTE_STRING_FAMILY Family for endnotes page head -ENDNOTE_STRING_FONT Font for endnotes page head -ENDNOTE_STRING_QUAD Quad direction for endnotes page head -ENDNOTE_STRING_SIZE Size for endnotes page head*** -ENDNOTE_STRING_UNDERSCORE Underscoring of endnotes page head -ENDNOTE_TITLE Endnotes identifying title -ENDNOTE_TITLE_FAMILY Family for endnotes identifying title -ENDNOTE_TITLE_FONT Font for endnotes identifying title -ENDNOTE_TITLE_QUAD Quad direction for endnotes identifying title -ENDNOTE_TITLE_SIZE Size for endnotes identifying title*** -ENDNOTE_TITLE_UNDERSCORE Underscoring of endnotes identifying title -ENDNOTE_NUMBER_FAMILY Family of endnote numbers -ENDNOTE_NUMBER_FONT Font of endnote numbers -ENDNOTE_NUMBER_SIZE Size of endnote numbers*** +ENDNOTE_FAMILY Family for endnotes +ENDNOTE_FONT Font for endnotes +ENDNOTE_LEAD Leading for endnotes page +ENDNOTE_PARA_INDENT First line indent of paras in multi-para + endnotes +ENDNOTE_PARA_SPACE Whether to space paras in multi-para endnotes +ENDNOTE_PT_SIZE Base point size for endnotes page +ENDNOTE_QUAD Endnote quad +ENDNOTE_STRING Endnotes page head +ENDNOTE_STRING_CAPS Capitalize the endnotes string +ENDNOTE_STRING_FAMILY Family for endnotes page head +ENDNOTE_STRING_FONT Font for endnotes page head +ENDNOTE_STRING_QUAD Quad direction for endnotes page head +ENDNOTE_STRING_SIZE Size for endnotes page head*** +ENDNOTE_STRING_UNDERSCORE Underscoring of endnotes page head +ENDNOTE_TITLE Endnotes identifying title +ENDNOTE_TITLE_FAMILY Family for endnotes identifying title +ENDNOTE_TITLE_FONT Font for endnotes identifying title +ENDNOTE_TITLE_QUAD Quad direction for endnotes identifying title +ENDNOTE_TITLE_SIZE Size for endnotes identifying title*** +ENDNOTE_TITLE_UNDERSCORE Underscoring of endnotes identifying title +ENDNOTE_NUMBER_FAMILY Family of endnote numbers +ENDNOTE_NUMBER_FONT Font of endnote numbers +ENDNOTE_NUMBER_SIZE Size of endnote numbers*** ENDNOTE_NUMBERS_ALIGN_RIGHT Hang endnote numbers and align right ENDNOTE_NUMBERS_ALIGN_LEFT Don't hang endnote numbers and align left -ENDNOTES_ALLOWS_HEADERS Page headers on endnotes pages? (toggle) +ENDNOTES_ALLOWS_HEADERS Page headers on endnotes pages? (toggle) ENDNOTES_FIRST_PAGENUMBER Page number to appear on page 1 of endnotes pages -ENDNOTES_HDRFTR_CENTER Print header/footer centre string on endnotes - pages? -ENDNOTES_HEADER_CENTER Print header centre string on endnotes pages? -ENDNOTES_FOOTER_CENTER Print footer centre string on endnotes pages? -ENDNOTES_NO_COLUMNS Turn columnar mode off for endnotes pages +ENDNOTES_HDRFTR_CENTER Print header/footer centre string on endnotes + pages? +ENDNOTES_HEADER_CENTER Print header centre string on endnotes pages? +ENDNOTES_FOOTER_CENTER Print footer centre string on endnotes pages? +ENDNOTES_NO_COLUMNS Turn columnar mode off for endnotes pages ENDNOTES_NO_FIRST_PAGENUM Don't print a pagenumber on page 1 of endnotes. -ENDNOTES_PAGENUM_STYLE Set numbering style for endnotes pages page - numbers +ENDNOTES_PAGENUM_STYLE Set numbering style for endnotes pages page + numbers EPIGRAPH_AUTOLEAD Autolead value for epigraphs +EPIGRAPH_COLOR Epigraph color EPIGRAPH_FAMILY Family to use in epigraphs EPIGRAPH_FONT Font to use in epigraphs EPIGRAPH_INDENT Value by which to multiply PP_INDENT for block epigraphs EPIGRAPH_QUAD Quad value of block style epigraphs EPIGRAPH_SIZE ps de/increase of epigraphs* +FINIS_COLOR Finis string color FINIS_STRING What to print when FINIS is invoked +FOOTER_COLOR Footer color FOOTER_GAP Distance between running text and footer FOOTER_MARGIN Distance from footer to bottom of page FOOTERS Turns footers on or off +FOOTNOTE_COLOR Footnote color FOOTNOTE_AUTOLEAD Autolead to use in footnotes FOOTNOTE_FAMILY Family to use in footnotes FOOTNOTE_FONT Font to use in footnotes @@ -597,6 +615,7 @@ HDRFTR_CENTER_FONT Font of centre part of header/footer HDRFTR_CENTER_PAD Pad hdrftr CENTER left or right by specified amount HDRFTR_CENTER_SIZE ps in/decrease of CENTER part of header/footer** +HDRFTR_COLOR Header/footer color HDRFTR_FAMILY Family to use in the headers/footers HDRFTR_GAP Distance from header/footer to running text HDRFTR_LEFT_CAPS Left part of header/footer in caps? (toggle) @@ -617,6 +636,7 @@ HDRFTR_RIGHT_FAMILY Family of right part of headers/footers HDRFTR_RIGHT_FONT Font of right part of headers/footers HDRFTR_RIGHT_SIZE Size of right part of headers/footers HDRFTR_RIGHT The header/footer right string +HDRFTR_RULE_COLOR Header/footer rule color HDRFTR_RULE_GAP Space between header/footer and header/footer rule HDRFTR_RULE_INTERNAL Prints the header/footer rule @@ -627,6 +647,7 @@ HDRFTR_SIZE ps in/decrease of headers/footers* HDRFTR_VERSO User-defined, single string verso header/footer HEAD_CAPS Print section titles in caps? (toggle) +HEAD_COLOR Head color HEADER_GAP Space between header and running text HEADER_MARGIN Space from top of page to header HEADERS Turns headers on or off @@ -640,9 +661,12 @@ HEAD_SPACE Give HEADs 2 line-spaces before. If OFF, HEAD_UNDERLINE Underline section titles? (toggle) INDENT_FIRST_PARAS Indent 1st paras? (doc default=not indented) ITALIC_MEANS_ITALIC For TYPEWRITE; render .FT I in italic. +LINEBREAK_CHAR Linebreak character, iterations and positioning +LINEBREAK_COLOR Linebreak color NUMBER_HEADS Print head numbers NUMBER_PARAHEADS Print parahead numbers NUMBER_SUBHEADS Print subhead numbers +PAGENUM_COLOR Page number color PAGENUM_FAMILY Family to use in footers PAGENUM_FONT Font to use for page numbers PAGENUM_HYPHENS Turns on/off hyphens surrounding page numbers @@ -653,6 +677,7 @@ PAGENUM_POS Controls placement of page numbers; PAGENUM_SIZE How much to in/decrease point size of page numbers* PAGENUM_STYLE Page # in roman, Arabic, or alphabetic +PARAHEAD_COLOR Parahead color PARAHEAD_FAMILY Family to use for paraheads PARAHEAD_FONT Font to use for paraheads PARAHEAD_INDENT How much to indent paraheads @@ -662,6 +687,7 @@ PARA_SPACE Put a line space before paras PP_FONT Overall doc font PROCESS_SHIM Calculates #SHIM when \n(.d is lower on the page than #T_MARGIN +QUOTE_COLOR Quote (poetic) color QUOTE_FAMILY Family to use in pquotes QUOTE_FONT Font to use in pquotes QUOTE_INDENT Value by which to multiply PP_INDENT for @@ -680,6 +706,7 @@ REVISION_STRING What to print whenever the word "revision" SHIM Advance to next "legal" baseline SINGLESPACE_ENDNOTES Single space TYPEWRITE endnotes SLANT_MEANS_SLANT In TYPEWRITE, render \*[SLANT] as slant +SUBHEAD_COLOR Subhead color SUBHEAD_FAMILY Family to use in subheads SUBHEAD_FONT Font to use in subheads SUBHEAD_SIZE How much to in/decrease point size of @@ -805,6 +832,7 @@ TRAPS Sets hdrftr traps; optionally adjusts #DOC_LEAD AUTHOR_<#> in AUTHOR #AUTHORS Equals final value of AUTHOR_NUM; used for authors in doc header +#BQUOTE_COLOR Colored blockquotes? (toggle) #BROKEN_QUOTE Did we invoke BREAK_QUOTE? (toggle) #CAP_HEIGHT_ADJUST Tallest cap height of strings LEFT, CENTER, and RIGHT in footers; used to place rule @@ -840,6 +868,7 @@ dc "mark" register for document columns #DEPTH_TO_B_MARGIN Page length minus #B_MARGIN #DOCHEADER_ADVANCE Distance from top-of-page to baseline of docheader +#DOCHEADER_COLOR Colored docheader? (toggle) #DOCHEADER_LEAD Lead of doc header (#DOC_LEAD + #DOCHEADER_LEAD_ADJ) #DOCHEADER_SPACE_ADJ Lead difference between #DEPTH_1 and @@ -897,6 +926,7 @@ dc "mark" register for document columns #EN_HDRFTR_CENTER Should we print centre string of headers/footers on endnotes pages? (toggle) #EPI_ACTIVE Are we in an epigraph? (toggle) +#EPI_COLOR Colored epigraphs? (toggle) #EPI_DEPTH Depth of epigraph from first baseline to last #EPI_FITS Does epigraph fit on page/column? (toggle) @@ -953,10 +983,12 @@ dc "mark" register for document columns #FOOTERS_ON Are we using footers? (toggle) #FOOTERS_WERE_ON Were footers on? - used in FINIS and BLANKPAGE (toggle) +#FOOTNOTE_COLOR Colored footnotes? (toggle) #FULLSPACE_QUOTES Should we fullspace quotes? (toggle) #GUTTER Width of gutter between columns #HDRFTR_CENTER_CAPS CENTER part of header/footer in caps? (toggle; default=off) +#HDRFTR_COLOR Colored headers/footers? (toggle) #HDRFTR_CTR_PAD_LEFT Amount of hdrftr CENTER padding on the left #HDRFTR_CTR_PAD_RIGHT Amount of hdrftr CENTER padding on the right #HDRFTR_CTR_PAD_TMP Temp storage of left hdrftr CENTER padding @@ -967,6 +999,7 @@ dc "mark" register for document columns (toggle; default=off) #HDRFTR_RIGHT_CAPS Right part of header/footer in caps? (toggle; default=on) +#HDRFTR_RULE_COLOR Colored header/footer rule? (toggle) #HDRFTR_RULE_GAP Space between header/footer and header/footer rule #HDRFTR_RULE Print head/footer rule? (toggle) @@ -974,6 +1007,7 @@ dc "mark" register for document columns #SWITCH_HDRFTR=1 #HEAD 1=main/section head 2=subhead #HEAD_CAPS Print section titles in caps? (toggle) +#HEAD_COLOR Colored heads? (toggle) #HEADER_GAP Distance from header to running text #HEADER_MARGIN Distance from top of page to header #HEADERS_ON Headers on? (toggle) @@ -1030,6 +1064,7 @@ dc "mark" register for document columns #PAGE_NUMS Print page numbers? (toggle) #PAGE_NUM_V_POS 1=top 2=bottom; default=2 #PAGE_TOP \n(nl after HEADER completes itself +#PH_COLOR Colored paraheads? (toggle) #PH_NUM Parahead number #PAGINATE_TOC Is toc pagination on? (toggle) #PAGINATE_WAS_ON Keeps track of pagination state while @@ -1062,6 +1097,7 @@ dc "mark" register for document columns ENDQUOTE. #Q_TOP Vertical place on page that a quote starts #QUOTE 1=PQUOTE, 2=BQUOTE +#QUOTE_COLOR Color quotes (poetic)? (toggle) #RECTO_VERSO Switch HEADER_LEFT and HEADER_RIGHT on alternate pages? (toggle); default=0 #REPEAT Number of times to repeat linebreak @@ -1146,6 +1182,7 @@ dc "mark" register for document columns #VARIABLE_FOOTER_POS Wandering trap position for processing footnotes and footers; pos depends on footnotes +y Vertical position stored with mk in hdrftrs. +++STRINGS+++ @@ -1155,6 +1192,7 @@ $AUTHOR_FAM Family to use for author in doc header $AUTHOR_FT Font to use for author in doc header $AUTHOR_SIZE_CHANGE ps in/decrease of author in doc header* $AUTHOR_PT_SIZE Absolute ps of authors +$BQUOTE_COLOR Blockquote color $BQUOTE_FAM Family to use for blockquotes $BQUOTE_FT Font to use for blockquotes $BQUOTE_QUAD Quad value for blockquotes @@ -1180,6 +1218,7 @@ $DOC_TITLE Overall doc title that gets printed in article with a different title $DOC_TYPE Document type (default, chapter, named, letter) +$DOCHEADER_COLOR Color of docheader $DOCHEADER_LEAD_ADJ +|- value applied to #DOC_LEAD to in/decrease leading of doc header $DOCTYPE_FAM Family to use for DOCTYPE string in @@ -1212,11 +1251,13 @@ $EN_NUMBER_FT Endnote numbering font $EN_NUMBER_SIZE_CHANGE Endnote numbering size*** $EPI_AUTOLEAD Autolead value (decimals ok) of epigraphs +$EPI_COLOR Color of epigraphs $EPI_FAM Family to use in epigraphs $EPI_FT Font to use in epigraphs $EPI_QUAD Quad in block-style epigraphs (justified or left) $EPI_SIZE_CHANGE ps in/decrease of epigraphs* +$FINIS_COLOR Color of FINIS string $FINIS_STRING What to print when FINIS macro is invoked $FIRST_DOC_TITLE 1st doc's title captured in COLLATE @@ -1224,6 +1265,7 @@ $FN_FAM Family used in footnotes $FN_FT Font used in footnotes $FN_QUAD Quad used in footnotes $FN_SIZE_CHANGE ps in/decrease of footnotes* +$FOOTNOTE_COLOR Footnote color $HDRFTR_CENTER What to put in CENTER part of headers; default doctype $HDRFTR_CENTER_FAM Family of CENTER part of headers @@ -1238,6 +1280,7 @@ $HDRFTR_CENTER_OLD HDRFTR_CENTER just prior to start of FOOTER_CENTER $HDRFTR_CENTER_SIZE_CHANGE ps in/decrease of centre title in headers** +$HDRFTR_COLOR Color of headers/footers $HDRFTR_FAM Family to use in headers $HDRFTR_LEFT_FAM Family of left part of headers $HDRFTR_LEFT_FT Font of left part of headers @@ -1256,6 +1299,7 @@ $HDRFTR_TMP_SIZE_CHANGE_SWITCH Temporarily holds #SWITCH_HDRFTRS=1 $HDRFTR_TMP_SWITCH Temporarily holds HDRFTR_LEFT if #SWITCH_HDRFTRS=1 +$HEAD_COLOR Head color $HEAD_FAM Family to use for section titles $HEAD_FT Font to use for section titles $HEAD_QUAD Quad value of section titles @@ -1263,15 +1307,19 @@ $HEAD_SIZE_CHANGE ps in/decrease of section titles* $LINEBREAK_CHAR Character that marks line breaks $LINEBREAK_CHAR_V_ADJ +|- amount by which to raise/lower linebreak character +$LINEBREAK_COLOR Linebreak color PAGE# For use in hdrftr strings where page # is needed; \*[PAGE] +$PAGENUM_COLOR Page number color $PAGENUM_STYLE String passed to PAGENUM_STYLE $PAGE_NUM_FAM Family of page numbers $PAGE_NUM_FT Font of page numbers $PAGE_NUM_SIZE_CHANGE ps in/decrease of page numbers $PAPER Paper size (LETTER, A4, LEGAL); default=LETTER +$PH_COLOR Parahead color $PP_FT Font used in paragraphs +$QUOTE_COLOR Quote (poetic) color $QUOTE_FAM Family to use for pquotes $QUOTE_FT Font to use for pquotes $QUOTE_SIZE_CHANGE ps in/decrease of pquotes* @@ -1281,6 +1329,7 @@ $REVISION_STRING What to print whenever the word $SH_FAM Family to use in subheads $SH_FT Font to use in subheads $SH_SIZE_CHANGE ps in/decrease of subheads* +$SH_COLOR Subhead color $SUBTITLE Document subtitle $SUBTITLE_FAM Family to use for subtitle in doc header @@ -1372,6 +1421,9 @@ cend +++ALIASES+++ +All macros that include the word COLOR have aliases that use COLOUR instead, +e.g. NEWCOLOUR, XCOLOUR, COLOUR, HEAD_COLOUR, SUBHEAD_COLOUR, etc. + BREAK_BLOCKQUOTE BREAK_QUOTE BREAK_CITATION BREAK_QUOTE BREAK_CITE BREAK_QUOTE diff --git a/contrib/mom/momdoc/toc.html b/contrib/mom/momdoc/toc.html index 420f2c97..ff4d653a 100644 --- a/contrib/mom/momdoc/toc.html +++ b/contrib/mom/momdoc/toc.html @@ -32,6 +32,7 @@ <li><a href="#IND">Indents</a> <li><a href="#GOODIES">Goodies</a> <li><a href="#ESCAPES">Inline escapes</a> + <li><a href="#COLOR">Coloured text</a> </ul> <a href="#DOCPROC"><strong>DOCUMENT PROCESSING WITH MOM</strong></a> <ul> @@ -155,6 +156,12 @@ <li><a href="inlines.html#INLINES_GROFF">4.12.3 Groff inlines</a> <li><a href="inlines.html#INLINE_CHARACTERS_GROFF">4.12.3.1 Inlines for special characters and symbols</a> </ul> +<a name="COLOR"></a> + <li><a href="color.html#TOP"><strong>4.13 Coloured text</strong></a> + <ul> + <li><a href="color.html#INTRO_COLOR">4.13.1 Introduction to coloured text</a> + <li><a href="color.html#MACROS_COLOR">4.13.2 Macro list</a> + </ul> </ul> <a name="DOCPROC"></a> <a name="DOCPROC_INTRO"></a> @@ -191,6 +198,9 @@ <li><a href="docprocessing.html#STYLE_BEFORE_START"><strong>5.3.4 Changing Type and Style Parameters <em>before</em> START</strong></a> <ul> <li><a href="docprocessing.html#TYPE_BEFORE_START">5.3.4.1 Typesetting macros</a> -- usage + <ul> + <li><a href="docprocessing.html#COLOR">Colour</a> + </ul> <li><a href="docprocessing.html#DOC_LEAD_ADJUST">5.3.4.2 DOC_LEAD_ADJUST</a> -- adjust document leading to fill pages <li><a href="docprocessing.html#DOCHEADER">5.3.4.3 DOCHEADER</a> -- managing the docheader <li><a href="docprocessing.html#COLUMNS_INTRO">5.3.4.4 COLUMNS</a> -- setting documents in columns diff --git a/contrib/mom/momdoc/typemacdoc.html b/contrib/mom/momdoc/typemacdoc.html index d4dbbe68..5ded8517 100644 --- a/contrib/mom/momdoc/typemacdoc.html +++ b/contrib/mom/momdoc/typemacdoc.html @@ -30,10 +30,21 @@ alone. (To indent footnotes, see the full explanation of the <a href="docelement.html#FOOTNOTE">FOOTNOTE</a> macro.) <p> -There are, however, some typesetting macros that, used during document +<strong>Mom</strong>'s tabs +(both +<a href="typesetting.html#TYPESETTING_TABS">typesetting tabs</a> +and +<a href="typesetting.html#STRING_TABS">string tabs</a>) +behave as expected in running text during document processing. Tab +structures that do not exceed the line length of running text are +preserved sensibly from page to page, and, if +<a href="docprocessing.html#COLUMNS">COLUMNS</a> +are enabled, from column to column. +<p> +Some typesetting macros, however, when used during document processing, behave in special ways. These are the macros that deal -with the basic parameters of type style: horizontal and vertical margins, -line length, +with the basic parameters of type style: horizontal and vertical +margins, line length, <a href="definitions.html#TERMS_FAMILY">family</a>, <a href="definitions.html#TERMS_FONT">font</a>, <a href="definitions.html#TERMS_PS">point size</a>, diff --git a/contrib/mom/momdoc/typesetting.html b/contrib/mom/momdoc/typesetting.html index 32f9d91d..0e129c02 100644 --- a/contrib/mom/momdoc/typesetting.html +++ b/contrib/mom/momdoc/typesetting.html @@ -2336,26 +2336,32 @@ divorced from groff's notion of tabs. I recommend reading this section carefully in order to understand how <strong>mom</strong> handles tabs. <p> +<strong>NOTE:</strong> see the section +<a href="typemacdoc.html#TYPESETTING">Using typesetting macros during document processing</a> +for re-assuring information on the use of tabs during +<a href="docprocessing.html#DOCPROCESSING">document processing</a>. +<p> + <a name="TYPESETTING_TABS"><h3><u>Typesetting tabs</u></h3></a> <p> Typesetting tabs are defined by both an indent from the left margin and a line length. This is quite different from typewriter-style tab stops (the groff norm) that only define the left indent. In conjunction -with the multi-column macros, typesetting tabs significantly facilitate +with the +<a href="#MULTI_COLUMNS">multi-column macros</a>, +typesetting tabs significantly facilitate tabular and columnar work. <p> -Typesetting tabs are created with the <strong>TAB_SET</strong> +Typesetting tabs are created with the +<a href="#TAB_SET">TAB_SET</a> macro. <strong>TAB_SET</strong> identifies the tab (by number), establishes its left indent and line length, and optionally sets a quad direction and fill mode. After tabs have been created with <strong>TAB_SET</strong>, they can be called at any time with the -<strong>TAB</strong> macro. -<p> -<strong>NOTE:</strong> see the section -<a href="typemacdoc.html#TYPESETTING">Typesetting Macros in Document Processing</a> -for information and advice on using tabs with the -<a href="docprocessing.html#DOCPROCESSING">document processing macros</a>. +<a href="#TAB">TAB</a> +macro. <p> + <a name="TYPESETTING_TABS_TUT"><h3><u>Quickie tutorial on typesetting tabs</u></h3></a> <p> Say you want to set up three tabs to produce an employee evaluation @@ -2516,10 +2522,14 @@ the tab and sets the type flush left. <p> <a name="STRING_TABS"><h3><u>String tabs (autotabs)</u></h3></a> <p> -String tabs let you mark off tab positions inline. Left indents -and line lengths are calculated from the beginning and end positions of -the marks. This is especially useful when tab indents and lengths -need to be determined from the text that goes in each tab. +String tabs let you mark off tab positions with +<a href="definitions.html#TERMS_INLINES">inline escapes</a> +embedded in +<a href="definitions.html#TERMS_INPUTLINE">input lines</a>. +Left indents and line lengths are calculated from the beginning and +end positions of the marks. This is especially useful when tab +indents and lengths need to be determined from the text that goes in +each tab. <p> Setting up string tabs is a two-step procedure. First, you enter an input line in which you mark off where you want tabs to begin and end. @@ -2567,8 +2577,12 @@ The first thing you need for string tabs is an <a href="definitions.html#TERMS_INPUTLINE">input line</a> with tab positions marked on it. Tabs are marked with the <a href="definitions.html#TERMS_INLINES">inline escapes</a> -<strong>\*[ST#]</strong> and <strong>\*[ST#X]</strong>. (In this -example, we enclose the input line with the +<a href="#ST_INLINE">\*[ST<n>]</a> +and +<a href="#ST_INLINE">\*[ST<n>X]</a>, +where <strong><n></strong> +is the number you want the tab to have. (In this example, we +enclose the input line with the <a href="goodies.html#SILENT">SILENT</a> macro so the line doesn't print. We also use the <a href="goodies.html#PAD">PAD</a> @@ -2579,7 +2593,7 @@ The setup looks like this: <p> <pre> .SILENT - .PAD "\*[ST1]CRITERION\*[ST1X]\*[FP12]\*[ST2]EVALUATION\*[ST2X]\*[FP12]\*[ST3]#\*[ST3X]" + .PAD "\*[ST1]CRITERION\*[ST1X]\*[FWD 12p]\*[ST2]EVALUATION\*[ST2X]\*[FWD 12p]\*[ST3]#\*[ST3X]" .SILENT OFF </pre> @@ -2593,10 +2607,10 @@ Here's what it means when broken down into its component parts: <kbd>\*[ST1]CRITERION\*[ST1X]</kbd> <br> <li>We want a 1 pica (12 points) gutter between tab 1 and 2, - so we insert 12 points of space with \*[FP12] - (<strong>F</strong>orward <strong>P</strong>oints 12): + so we insert 12 points of space with \*[FWD 12p] + (<strong>F</strong>or<strong>W</strong>ar<strong>D</strong> 12 points): <p> - <kbd>\*[FP12]</kbd> + <kbd>\*[FWD 12p]</kbd> <br> <li>The longest line in tab 2 is "EVALUATION", so we enclose EVALUATION with begin/end markers for string @@ -2605,9 +2619,9 @@ Here's what it means when broken down into its component parts: <kbd>\*[ST2]EVALUATION\*[ST2X]</kbd> <br> <li>We want 1 pica (12 points) between tab 2 and 3, so we - insert 12 points of space with another \*[FP12]: + insert 12 points of space with another \*[FWD 12p]: <p> - <kbd>\*[FP12]</kbd> + <kbd>\*[FWD 12p]</kbd> <br> <li>We want tab 3 to be as long as whatever space remains on the current line length, so we enclose the @@ -2659,7 +2673,7 @@ evaluation form utilizing string tabs. .HY OFF .SS 0 .SILENT - .PAD "\*[ST1]CRITERION\*[ST1X]\*[FP12]\*[ST2]EVALUATION\*[ST2X]\*[FP12]\*[ST3]#\*[ST3X]" + .PAD "\*[ST1]CRITERION\*[ST1X]\*[FWD 12p]\*[ST2]EVALUATION\*[ST2X]\*[FWD 12p]\*[ST3]#\*[ST3X]" .SILENT OFF .ST 1 L .ST 2 L @@ -2707,8 +2721,8 @@ it again. You'll see that the tab structure remains identical (tab between tabs is still 1 pica), while the position and length of the tabs have altered because of the new point size. <p> -Now try increasing the gutters to 2 picas (put an additional -<kbd>\*[FP12]</kbd> after each <kbd>\*[FP12]</kbd>). Preview the +Now try increasing the gutters to 2 picas (<kbd>\*[FWD 24p]</kbd> or +<kbd>\*[FWD 2P]</kbd> instead of <kbd>\*[FWD 12p]</kbd>). Preview the file again, and notice how the tab structure remains the same, but the gutters are wider. <p> diff --git a/contrib/mom/om.tmac b/contrib/mom/om.tmac index bcbccccc..68050697 100644 --- a/contrib/mom/om.tmac +++ b/contrib/mom/om.tmac @@ -23,8 +23,8 @@ .\" .\" .\" -\# Version 1.1.7-1 -\# --------------- +\# Version 1.1.8 +\# ------------- \# .if (\n[.x]\n[.y] < 118) \ . ab You need GNU troff version 1.18 or higher to run this version of mom! @@ -971,7 +971,7 @@ \# *Arguments: \# [ ,, ] | [ << ] | [ >> ] | <anything> \# or -\# [ DA | DE | EN | ES | FR | IT | NL | NO | PT | SV ] | <anything> +\# [ DA | DE | ES | FR | IT | NL | NO | PT | SV ] | <anything> \# *Function: \# Turns smartquotes on (optionally with a quoting style from the \# argument list, or off). @@ -1380,9 +1380,10 @@ . in 0 . nr #TAB_ACTIVE 1 . nr #CURRENT_TAB \\n[#TAB_NUMBER] -. po \\n[#L_MARGIN]u+\\n[#TAB_OFFSET]u -. nr #ST_OFFSET \\n[#TAB_OFFSET] +. ds $CURRENT_TAB \\*[$CURRENT_TAB] . nr #TAB_OFFSET\\*[$CURRENT_TAB] \\n[#TAB_OFFSET] +. nr #ST_OFFSET \\n[#TAB_OFFSET] +. po \\\\n[#L_MARGIN]u+\\\\n[#TAB_OFFSET\\\\*[$CURRENT_TAB]]u . ll \\n[#TAB_LENGTH]u . ta \En(.lu . ie '\\$5'QUAD' \{\ @@ -1414,7 +1415,6 @@ . ds $TAB_NUMBER \\$1 . TAB\\*[$TAB_NUMBER] . nr #IN_TAB 1 -. po \\n[#L_MARGIN]u+\\n[#TAB_OFFSET\\*[$TAB_NUMBER]]u .END \# \# @@ -1473,6 +1473,85 @@ . \} .END \# +\# ==================================================================== +\# +\# COLOR HANDLING +\# ============== +\# +\# COLOR +\# ----- +\# *Arguments: +\# <pre-defined NEWCOLOR or XCOLOR> +\# *Function: +\# Allows the inline escape for setting color to be called +\# as a macro. +\# +.MAC COLOR END +.ie \\n(.u=1 \{\ +\c +\\*[\\$1]\c +. \} +.el \{ \\*[\\$1] \} +.END +\# +\# +\# NEWCOLOR +\# -------- +\# *Arguments: +\# <color name> [<color scheme>] <color definition> +\# *Function: +\# Based on .defcolor, allows users to name and define colors using +\# one of the four color schemes rgb, cmy, cmyk and grey. The new +\# color is then defined as a string so that it can be called inline +\# with \*[COLORNAME] or with .COLOR. +\# *Notes: +\# With only two args, the default color scheme is rgb. +\# +\# It is highly recommended that users define new colors as +\# all-cap strings, to differentiate them from x colors, which must +\# be in lower case. +\# +.MAC NEWCOLOR END +. if \\n[#NUM_ARGS]=2 \{\ +. defcolor \\$1 rgb \\$2 +. \} +. if \\n[#NUM_ARGS]=3 \{\ +. if '\\$2'RGB' .ds $COLOR_SCHEME rgb +. if '\\$2'CYM' .ds $COLOR_SCHEME cym +. if '\\$2'CMYK' .ds $COLOR_SCHEME cmyk +. if '\\$2'GRAY' .ds $COLOR_SCHEME gray +. if '\\$2'GREY' .ds $COLOR_SCHEME gray +. defcolor \\$1 \\*[$COLOR_SCHEME] \\$3 +. \} +. ds \\$1 \\m[\\$1] +.END +\# +\# +\# XCOLOR +\# ------ +\# *Arguments: +\# <x color name> [<alias>] +\# *Function: +\# Defines a string of x color name (i.e. a predefined x +\# color). If <alias> is given, creates a string of <alias name> +\# that references the x color name of the first argument. +\# *Notes: +\# The color name must be a legal color name from rgb.txt, and +\# must be given entirely in lower case, all one word. +\# +.MAC XCOLOR END +. ds \\$1 \m[\\$1] +. if \\n[#NUM_ARGS]=2 .ds \\$2 \m[\\$1] +.END +\# +\# +\# Pre-define xcolors black and white +\# +.ds black \m[black] +.ds BLACK \m[black] +.ds white \m[white] +.ds WHITE \m[WHITE] +\# \# ===================================================================== \# \# +++MISCELLANEOUS USEFUL MACROS AND STRINGS+++ @@ -2156,6 +2235,23 @@ .END \# \# +\# DROPCAP COLOR +\# ------------- +\# *Arguments: +\# <pre-defined XCOLOR or NEWCOLOR> +\# *Function: +\# Defines string $DC_COLOR to argument. +\# *Notes: +\# User must define an XCOLOR or NEWCOLOR before using +\# DC_COLOR. +\# +.MAC DROPCAP_COLOR END +. if \\n[#PRINT_STYLE]=1 \{ .return \} +. nr #DC_COLOR 1 +. ds $DC_COLOR \\$1 +.END +\# +\# \# DROP CAP GUTTER \# --------------- \# *Argument: @@ -2247,8 +2343,20 @@ . if d$DC_ADJUST \{ .ps \\*[$DC_ADJUST]p \} . mk x . sp \\n[#DC_LINES]v -. ie '\\$3'COND' \{ .PRINT \\*[COND]\\*[$DROPCAP]\\*[CONDX] \} -. el \{ .PRINT \\*[$DROPCAP] \} +. ie \\n[#DC_COLOR]=1 \{\ +. ie !'\\$3'' \{\ +. ie '\\$3'COND' \{ .PRINT \m[\\*[$DC_COLOR]]\\*[COND]\\*[$DROPCAP]\\*[CONDX]\m[] \} +. el \{ .PRINT \m[\\*[$DC_COLOR]]\\*[EXT]\\*[$DROPCAP]\\*[EXTX]\m[] \} +. \} +. el \{ .PRINT \m[\\*[$DC_COLOR]]\\*[$DROPCAP]\m[] \} +. \} +. el \{\ +. ie !'\\$3'' \{\ +. ie '\\$3'COND' \{ .PRINT \\*[COND]\\*[$DROPCAP]\\*[CONDX] \} +. el \{ .PRINT \\*[EXT]\\*[$DROPCAP]\\*[EXTX] \} +. \} +. el \{ .PRINT \m[\\*[$DC_COLOR]]\\*[$DROPCAP]\m[] \} +. \} . if '\\$3'COND' \{ \E*[COND] \} . if '\\$3'EXT' \{ \E*[EXT] \} . ie \\n(.i \{ .in +\w'\\*[$DROPCAP]'u+\\n[#DC_GUT]u \} @@ -2290,7 +2398,9 @@ \# *Notes: \# .MAC RULE END -. if \\n(.j=1 \{\ +\c +. EL +. if \\n(.u=1 \{\ . ds $CURRENT_QUAD \\*[$QUAD_VALUE] . nf . \} @@ -2300,7 +2410,7 @@ . if \\n[#INDENT_LEFT_ACTIVE] \{ .ll \\n(.lu-\\n[#L_INDENT]u \} . PRINT \El'\En(.lu' . ll \\n[#RESTORE_L_LENGTH]u -. rr #RESTORE_L_LENGTH]u +. rr #RESTORE_L_LENGTH . \} . el \{\ . PRINT \El'\En(.lu' @@ -2941,6 +3051,7 @@ y\\R'#DESCENDER \\n[.cdp]' \# +++TYPESETTING ALIASES+++ \# .ALIAS CENTRE CENTER +.ALIAS COLOUR COLOR .ALIAS COMMENT SILENT .ALIAS CONDENSE CONDENSE_OR_EXTEND .ALIAS EXTEND CONDENSE_OR_EXTEND @@ -2948,15 +3059,17 @@ y\\R'#DESCENDER \\n[.cdp]' .ALIAS HYPHENATE HY .ALIAS HYPHENATION HY .ALIAS HYSET HY_SET -.ALIAS LIG LIGATURES .ALIAS IBQ IBX .ALIAS ILQ ILX .ALIAS IQ IX .ALIAS IRQ IRX +.ALIAS LIG LIGATURES +.ALIAS NEWCOLOUR NEWCOLOR .ALIAS PADMARKER PAD_MARKER .ALIAS TABSET TAB_SET .ALIAS TB TAB .ALIAS UNDERSCORE_2 UNDERSCORE2 +.ALIAS XCOLOUR XCOLOUR \# \# \# ==================================================================== @@ -3058,6 +3171,7 @@ y\\R'#DESCENDER \\n[.cdp]' . fam C . ft R . ps 12 +. color 0 . ie '\\$2'SINGLESPACE' \{\ . nr #SINGLE_SPACE 1 . vs 12 @@ -3578,7 +3692,7 @@ y\\R'#DESCENDER \\n[.cdp]' . FOOTER_LEFT "" . FOOTER_CENTER "" . FOOTER_RIGHT_SIZE +0 -. FOOTER_RIGHT ".../\E*[$SUITE] +. FOOTER_RIGHT "\&.../\E*[$SUITE] . FOOTER_ON_FIRST_PAGE . em ALL_DONE . \} @@ -3677,7 +3791,7 @@ y\\R'#DESCENDER \\n[.cdp]' \# *Arguments: \# <none> \# *Function: -\# Redefines $SUITE to blank so that a suite number doesn't +\# Redefines $FOOTER_RIGHT to blank so that a suite number doesn't \# appear at the bottom of letter pages. \# .MAC NO_SUITE END @@ -3960,7 +4074,7 @@ y\\R'#DESCENDER \\n[.cdp]' . if !d$EN_TITLE_FT \{ .ENDNOTE_TITLE_FONT B \} . if !d$EN_TITLE_SIZE_CHANGE \{ .ENDNOTE_TITLE_SIZE +0 \} . if !d$EN_NUMBER_FT \{ .ENDNOTE_NUMBER_FONT B \} -. if !$EN_NUMBER_SIZE_CHANGE \{ .ENDNOTE_NUMBER_SIZE +0 \} +. if !d$EN_NUMBER_SIZE_CHANGE \{ .ENDNOTE_NUMBER_SIZE +0 \} . if !r#EN_PP_INDENT \{ .ENDNOTE_PARA_INDENT 1.5m \} . if !d$TOC_FAM \{ .TOC_FAMILY \\*[$DOC_FAM] \} . if !r#TOC_PS \{ .TOC_PT_SIZE \\n[#DOC_PT_SIZE]u \} @@ -3980,7 +4094,7 @@ y\\R'#DESCENDER \\n[.cdp]' . if !d$TOC_PH_FT \{ .TOC_PARAHEAD_FONT I \} . if !d$TOC_TITLE_SIZE_CHANGE \{ .TOC_TITLE_SIZE +.5 \} . if !d$TOC_PN_SIZE_CHANGE \{ .TOC_PN_SIZE +0 \} -. if !d$TOC_HEAD_SIZE_CHANGE \{ .TOC_HEAD_SIZE +.5 \} +. if !d$TOC_HEAD_SIZE_CHANGE \{ .TOC_HEAD_SIZE +.5 \} . if !d$TOC_SH_SIZE_CHANGE \{ .TOC_SUBHEAD_SIZE +0 \} . if !d$TOC_PH_SIZE_CHANGE \{ .TOC_PARAHEAD_SIZE +0 \} . \} @@ -4051,7 +4165,10 @@ y\\R'#DESCENDER \\n[.cdp]' . nr #AUTHORS \\n[#AUTHOR_NUM] . nr #NEXT_AUTHOR 0 1 . while \\n[#AUTHORS]>\\n[#NEXT_AUTHOR] \{\ -. PRINT \\*[$AUTHOR_\\n+[#NEXT_AUTHOR]] +. ie \\n[#AUTHOR_COLOR]=1 \{\ +. PRINT \m[\\*[$AUTHOR_COLOR]]\\*[$AUTHOR_\\n+[#NEXT_AUTHOR]]\m[] +. \} +. el \{ .PRINT \\*[$AUTHOR_\\n+[#NEXT_AUTHOR]] \} . \} .END \# @@ -4061,18 +4178,29 @@ y\\R'#DESCENDER \\n[.cdp]' . FT \\*[$TITLE_FT] . PT_SIZE \\*[$TITLE_PT_SIZE] . LS \\n[#DOCHEADER_LEAD]u -. PRINT \\*[$TITLE] +. ie \\n[#TITLE_COLOR]=1 \{\ +. PRINT \m[\\*[$TITLE_COLOR]]\\*[$TITLE]\m[] +. \} +. el \{ .PRINT \\*[$TITLE] \} . if !'\\*[$SUBTITLE]'' \{\ . FAMILY \\*[$SUBTITLE_FAM] . FT \\*[$SUBTITLE_FT] . PT_SIZE \\*[$SUBTITLE_PT_SIZE] -. PRINT \\*[$SUBTITLE] +. ie \\n[#SUBTITLE_COLOR]=1 \{\ +. PRINT \m[\\*[$SUBTITLE_COLOR]]\\*[$TITLE]\m[] +. \} +. el \{ .PRINT \\*[$SUBTITLE] \} . \} . if !'\\*[$AUTHOR_1]'' \{\ . FAMILY \\*[$AUTHOR_FAM] . FT \\*[$AUTHOR_FT] . PT_SIZE \\*[$AUTHOR_PT_SIZE] -. if !'\\*[$ATTRIBUTE_STRING]'' \{ .PRINT \\*[$ATTRIBUTE_STRING] \} +. if !'\\*[$ATTRIBUTE_STRING]'' \{\ +. ie \\n[#ATTRIBUTE_COLOR]=1 \{\ +. PRINT \m[\\*[$ATTRIBUTE_COLOR]]\\*[$ATTRIBUTE_STRING]\m[] +. \} +. el \{ .PRINT \\*[$ATTRIBUTE_STRING] \} +. \} . PRINT_AUTHORS . \} .END @@ -4084,6 +4212,7 @@ y\\R'#DESCENDER \\n[.cdp]' . FT \\*[$TITLE_FT] . PT_SIZE \\*[$TITLE_PT_SIZE] . LS \\n[#DOCHEADER_LEAD]u +\# Chapter title only . ie '\\*[$CHAPTER]'' \{\ . ie !'\\*[$CHAPTER_TITLE]'' \{\ . if \\n[#PRINT_STYLE]=2 \{\ @@ -4092,22 +4221,35 @@ y\\R'#DESCENDER \\n[.cdp]' . PT_SIZE \\*[$CHAPTER_TITLE_PT_SIZE] . LS \\n[#DOCHEADER_LEAD]u . \} -. PRINT \\*[$CHAPTER_TITLE] +. ie \\n[#TITLE_COLOR]=1 \{\ +. PRINT \m[\\*[$TITLE_COLOR]]\\*[$CHAPTER_TITLE]\m[] +. \} +. el \{ .PRINT \\*[$CHAPTER_TITLE] \} . \} . el \{\ -. PRINT \\*[$CHAPTER_STRING] +. ie \\n[#TITLE_COLOR]=1 \{\ +. PRINT \m[\\*[$TITLE_COLOR]]\\*[$CHAPTER_STRING]\m[] +. \} +. el \{ .PRINT \\*[$CHAPTER_STRING] \} . \} . \} +\# Chapter string, possibly with a chapter title . el \{\ -. PRINT \\*[$CHAPTER_STRING] \\*[$CHAPTER] +. ie \\n[#TITLE_COLOR]=1 \{\ +. PRINT \m[\\*[$TITLE_COLOR]]\\*[$CHAPTER_STRING] \\*[$CHAPTER]\m[] +. \} +. el \{ .PRINT \\*[$CHAPTER_STRING] \\*[$CHAPTER] \} . if !'\\*[$CHAPTER_TITLE]'' \{\ -. if \\n[#PRINT_STYLE]=1 \{ .PRINT \\*[$CHAPTER_TITLE] \} +. if \\n[#PRINT_STYLE]=1 \{ .PRINT \\*[$CHAPTER_TITLE] \} . if \\n[#PRINT_STYLE]=2 \{\ . FAMILY \\*[$CHAPTER_TITLE_FAM] . FT \\*[$CHAPTER_TITLE_FT] . PT_SIZE \\*[$CHAPTER_TITLE_PT_SIZE] . LS \\n[#DOCHEADER_LEAD]u -. PRINT \\*[$CHAPTER_TITLE] +. ie \\n[#TITLE_COLOR]=1 \{\ +. PRINT \m[\\*[$TITLE_COLOR]]\\*[$CHAPTER_TITLE]\m[] +. \} +. el \{ .PRINT \\*[$CHAPTER_TITLE] \} . RLD \\n[#DOC_LEAD]u \" Just looks better this way . \} . \} @@ -4121,18 +4263,30 @@ y\\R'#DESCENDER \\n[.cdp]' . FT \\*[$TITLE_FT] . PT_SIZE \\*[$TITLE_PT_SIZE] . LS \\n[#DOCHEADER_LEAD]u -. PRINT \\*[$TITLE] +. ie \\n[#TITLE_COLOR]=1 \{\ +. PRINT \m[\\*[$TITLE_COLOR]]\\*[$TITLE]\m[] +. \} +. el \{ .PRINT \\*[$TITLE] \} . if !'\\*[$SUBTITLE]'' \{\ . FAMILY \\*[$SUBTITLE_FAM] . FT \\*[$SUBTITLE_FT] . PT_SIZE \\*[$SUBTITLE_PT_SIZE] -. PRINT \\*[$SUBTITLE] +. ie \\n[#SUBTITLE_COLOR]=1 \{\ +. PRINT \m[\\*[$SUBTITLE_COLOR]]\\*[$TITLE]\m[] +. \} +. el \{ .PRINT \\*[$SUBTITLE] \} . \} . if !'\\*[$AUTHOR_1]'' \{\ . FAMILY \\*[$AUTHOR_FAM] . FT \\*[$AUTHOR_FT] . PT_SIZE \\*[$AUTHOR_PT_SIZE] -. if !'\\*[$ATTRIBUTE_STRING]'' \{ .PRINT \\*[$ATTRIBUTE_STRING] \} +. if !'\\*[$ATTRIBUTE_STRING]'' \{\ +. ie \\n[#ATTRIBUTE_COLOR]=1 \{\ +. PRINT \m[\\*[$ATTRIBUTE_COLOR]]\\*[$ATTRIBUTE_STRING]\m[] +. \} +. el \{ .PRINT \\*[$ATTRIBUTE_STRING] \} +. \} +. \} . PRINT_AUTHORS . \} . FAMILY \\*[$DOCTYPE_FAM] @@ -4140,7 +4294,11 @@ y\\R'#DESCENDER \\n[.cdp]' . PT_SIZE \\*[$DOCTYPE_PT_SIZE] . LS \\n[#DOCHEADER_LEAD]u . ALD \\n[#DOCHEADER_LEAD]u -. UNDERSCORE "\\*[$DOC_TYPE] +. ie \\n[#DOCTYPE_COLOR]=1 \{\ +. COLOR \\*[$DOCTYPE_COLOR] +. UNDERSCORE "\\*[$DOC_TYPE] +. \} +. el .UNDERSCORE "\\*[$DOC_TYPE] .END \# \# @@ -4278,6 +4436,7 @@ y\\R'#DESCENDER \\n[.cdp]' . mk dc . nr #COL_NUM 0 1 . po \\n[#COL_\\n+[#COL_NUM]_L_MARGIN]u +. nr #L_MARGIN \\n(.o . ll \\n[#COL_L_LENGTH]u . \} . nr #PP 0 @@ -4291,7 +4450,12 @@ y\\R'#DESCENDER \\n[.cdp]' . if \\n[#DOC_TYPE]=1 \{\ . PRINT \& . sp |\\n[#DOCHEADER_ADVANCE]u-1v -. ev TITLE +. ev DOCHEADER +. if \\n[#DOCHEADER_COLOR]=1 \{\ +. nf +\m[\\*[$DOCHEADER_COLOR]] +. EL +. \} . L_MARGIN \\n[#DOC_L_MARGIN]u . LL \\n[#DOC_L_LENGTH]u . ta \\n(.lu @@ -4359,7 +4523,12 @@ y\\R'#DESCENDER \\n[.cdp]' . if \\n[#DOC_TYPE]=2 \{\ . PRINT \& . sp |\\n[#DOCHEADER_ADVANCE]u-1v -. ev TITLE +. ev DOCHEADER +. if \\n[#DOCHEADER_COLOR]=1 \{\ +. nf +\m[\\*[$DOCHEADER_COLOR]] +. EL +. \} . L_MARGIN \\n[#DOC_L_MARGIN]u . LL \\n[#DOC_L_LENGTH]u . ta \\n(.lu @@ -4408,7 +4577,12 @@ y\\R'#DESCENDER \\n[.cdp]' . if \\n[#DOC_TYPE]=3 \{\ . PRINT \& . sp |\\n[#DOCHEADER_ADVANCE]u-1v -. ev NAMED +. ev DOCHEADER +. if \\n[#DOCHEADER_COLOR]=1 \{\ +. nf +\m[\\*[$DOCHEADER_COLOR]] +. EL +. \} . L_MARGIN \\n[#DOC_L_MARGIN]u . LL \\n[#DOC_L_LENGTH]u . ta \\n(.lu @@ -4487,12 +4661,14 @@ y\\R'#DESCENDER \\n[.cdp]' . nr #COL_NUM 0 1 . nr #L_LENGTH_FOR_EPI \\n[#L_LENGTH] . po \\n[#COL_\\n+[#COL_NUM]_L_MARGIN]u +. nr #L_MARGIN \\n(.o . LL \\n[#COL_L_LENGTH]u . ta \\n(.lu . mk dc . \} . \} . \} +. QUAD \\*[$DOC_QUAD] . rr #DOCHEADER_LEAD . rr #DOCHEADER_LEAD_ADJ . rr #DEPTH_1 @@ -4566,6 +4742,24 @@ y\\R'#DESCENDER \\n[.cdp]' .END \# \# +\# DOCHEADER COLOR +\# --------------- +\# *Arguments: +\# <pre-defined XCOLOR or NEWCOLOR> +\# *Function: +\# Sets register #DOCHEADER_COLOR to 1; defines string +\# $DOCHEADER_COLOR to argument. +\# *Notes: +\# User must define an XCOLOR or NEWCOLOR before using +\# DOCHEADER_COLOR. +\# +.MAC DOCHEADER_COLOR END +. if \\n[#PRINT_STYLE]=1 \{ .return \} +. nr #DOCHEADER_COLOR 1 +. ds $DOCHEADER_COLOR \\$1 +.END +\# +\# \# TITLE FAMILY \# ------------ \# *Argument: @@ -4612,6 +4806,21 @@ y\\R'#DESCENDER \\n[.cdp]' .END \# \# +\# TITLE COLOR +\# ----------- +\# *Argument: +\# <pre-defined color name> +\# *Function: +\# Sets register #TITLE_COLOR to 1; creates string $TITLE_COLOR +\# *Notes: +\# The color name must be pre-defined with NEWCOLOR or XCOLOR. +\# +.MAC TITLE_COLOR END +. nr #TITLE_COLOR 1 +. ds $TITLE_COLOR \\$1 +.END +\# +\# \# CHAPTER TITLE FAMILY \# -------------------- \# *Argument: @@ -4704,6 +4913,37 @@ y\\R'#DESCENDER \\n[.cdp]' .END \# \# +\# SUBTITLE COLOR +\# -------------- +\# *Argument: +\# <pre-defined color name> +\# *Function: +\# Sets register #SUBTITLE_COLOR to 1; creates string +\# $SUBTITLE_COLOR. +\# *Notes: +\# The color name must be pre-defined with NEWCOLOR or XCOLOR. +\# +.MAC SUBTITLE_COLOR END +. nr #SUBTITLE_COLOR 1 +. ds $SUBTITLE_COLOR \\$1 +.END +\# +\# +\# ATTRIBUTE COLOR +\# --------------- +\# *Argument: +\# <pre-defined color name> +\# *Function: +\# Sets register #ATTRIBUTE_COLOR to 1; creates string $ATTRIBUTE_COLOR +\# *Notes: +\# The color name must be pre-defined with NEWCOLOR or XCOLOR. +\# +.MAC ATTRIBUTE_COLOR END +. nr #ATTRIBUTE_COLOR 1 +. ds $ATTRIBUTE_COLOR \\$1 +.END +\# +\# \# AUTHOR FAMILY \# ------------- \# *Argument: @@ -4749,6 +4989,21 @@ y\\R'#DESCENDER \\n[.cdp]' .END \# \# +\# AUTHOR COLOR +\# ------------ +\# *Argument: +\# <pre-defined color name> +\# *Function: +\# Sets register #AUTHOR_COLOR to 1; creates string $AUTHOR_COLOR +\# *Notes: +\# The color name must be pre-defined with NEWCOLOR or XCOLOR. +\# +.MAC AUTHOR_COLOR END +. nr #AUTHOR_COLOR 1 +. ds $AUTHOR_COLOR \\$1 +.END +\# +\# \# DOCTYPE FAMILY \# -------------- \# *Argument: @@ -4794,6 +5049,21 @@ y\\R'#DESCENDER \\n[.cdp]' .END \# \# +\# DOCTYPE COLOR +\# ------------- +\# *Argument: +\# <pre-defined color name> +\# *Function: +\# Sets register #DOCTYPE_COLOR to 1; creates string $DOCTYPE_COLOR +\# *Notes: +\# The color name must be pre-defined with NEWCOLOR or XCOLOR. +\# +.MAC DOCTYPE_COLOR END +. nr #DOCTYPE_COLOR 1 +. ds $DOCTYPE_COLOR \\$1 +.END +\# +\# \# DOCUMENT LEFT MARGIN \# -------------------- \# *Argument: @@ -4915,6 +5185,7 @@ y\\R'#DESCENDER \\n[.cdp]' . if '\\$2'ADJUST' \{ .TRAPS \} .END \# +\# \# ADJUST DOCUMENT LEAD \# -------------------- \# *Arguments: @@ -5068,6 +5339,22 @@ y\\R'#DESCENDER \\n[.cdp]' . CAPS OFF .END \# +\# FINIS COLOR +\# ----------- +\# *Arguments: +\# <pre-defined XCOLOR or NEWCOLOR> +\# *Function: +\# Defines string $FINIS_COLOR to argument. +\# *Notes: +\# User must define an XCOLOR or NEWCOLOR before using +\# FINIS_COLOR. +\# +.MAC FINIS_COLOR END +. if \\n[#PRINT_STYLE]=1 \{ .return \} +. ds $FINIS_COLOR \\$1 +.END +\# +\# \# ==================================================================== \# \# +++RECTO/VERSO+++ @@ -5138,6 +5425,24 @@ y\\R'#DESCENDER \\n[.cdp]' .END \# \# +\# EPIGRAPH COLOR +\# -------------- +\# *Arguments: +\# <pre-defined XCOLOR or NEWCOLOR> +\# *Function: +\# Sets register #EPI_COLOR to 1; defines string +\# $EPI_COLOR to argument. +\# *Notes: +\# User must define an XCOLOR or NEWCOLOR before using +\# EPI_COLOR. +\# +.MAC EPIGRAPH_COLOR END +. if \\n[#PRINT_STYLE]=1 \{ .return \} +. nr #EPI_COLOR 1 +. ds $EPI_COLOR \\$1 +.END +\# +\# \# EPIGRAPH QUAD \# ------------- \# *Arguments: @@ -5239,6 +5544,11 @@ y\\R'#DESCENDER \\n[.cdp]' . FAMILY \\*[$EPI_FAM] . FT \\*[$EPI_FT] . PT_SIZE \\n[#DOC_PT_SIZE]u\\*[$EPI_SIZE_CHANGE] +. if \\n[#EPI_COLOR]=1 \{\ +. nf +\m[\\*[$EPI_COLOR]] +. EL +. \} . AUTOLEAD \\n[#EPI_AUTOLEAD] . nr #EPI_LEAD \\n[#LEAD] . nr #EPI_LEAD_DIFF \\n[#DOC_LEAD]-\\n[#EPI_LEAD] @@ -5289,6 +5599,11 @@ y\\R'#DESCENDER \\n[.cdp]' . FAMILY \\*[$EPI_FAM] . FT \\*[$EPI_FT] . PT_SIZE \\n[#DOC_PT_SIZE]u\\*[$EPI_SIZE_CHANGE] +. if \\n[#EPI_COLOR]=1 \{\ +. nf +\m[\\*[$EPI_COLOR]] +. EL +. \} . AUTOLEAD \\n[#EPI_AUTOLEAD] . QUAD \\*[$EPI_QUAD] . HY @@ -5375,7 +5690,10 @@ y\\R'#DESCENDER \\n[.cdp]' . \} . if \\n[#EPIGRAPH]=1 \{\ . po \\n[#L_MARGIN]u -. if \\n[#COLUMNS] \{ .po \\n[#COL_\\n[#COL_NUM]_L_MARGIN]u \} +. if \\n[#COLUMNS] \{\ +. po \\n[#COL_\\n[#COL_NUM]_L_MARGIN]u +. nr #L_MARGIN \\n(.o +. \} . \} . if \\n[#EPIGRAPH]=2 \{\ . nr #EPI_OFFSET \\n[#L_MARGIN]+(\\n[#PP_INDENT]*\\n[#EPI_OFFSET_VALUE]) @@ -5453,10 +5771,14 @@ y\\R'#DESCENDER \\n[.cdp]' . ALD \\n[#DOC_LEAD]u . QUAD \\*[$DOC_QUAD] . po \\n[#L_MARGIN]u -. if \\n[#COLUMNS] \{ .po \\n[#COL_\\n[#COL_NUM]_L_MARGIN]u \} +. if \\n[#COLUMNS] \{\ +. po \\n[#COL_\\n[#COL_NUM]_L_MARGIN]u +. nr #L_MARGIN \\n(.o +. \} . if \\n[#START] \{\ . if \\n[#COLUMNS] \{\ . po \\n[#COL_\\n[#COL_NUM]_L_MARGIN]u +. nr #L_MARGIN \\n(.o . mk dc . \} . \} @@ -5474,6 +5796,8 @@ y\\R'#DESCENDER \\n[.cdp]' \# Deposits --END-- at the end of a document. \# .MAC FINIS END +. ev FINIS +. evc 0 . nr #FINIS 1 . if \\n[#TAB_ACTIVE] \{ .TQ \} . if \\n[#INDENT_ACTIVE] \{ .IQ CLEAR \} @@ -5488,13 +5812,17 @@ y\\R'#DESCENDER \\n[.cdp]' . \} . \} . nr #EM_ADJUST (1m/8) -. if \\n[#COLUMNS] \{ .po \\n[#COL_\\n[#COL_NUM]_L_MARGIN]u \} +. if \\n[#COLUMNS] \{\ +. po \\n[#COL_\\n[#COL_NUM]_L_MARGIN]u +. nr #L_MARGIN \\n(.o +. \} . ALD \\n[#DOC_LEAD]u . CENTER . if \\n[#PRINT_STYLE]=1 \{ .PRINT "--\\*[$FINIS_STRING]--\} . if \\n[#PRINT_STYLE]=2 \{\ -. PRINT "\v'-\\n[#EM_ADJUST]u'\(em\v'+\\n[#EM_ADJUST]u'\\*[$FINIS_STRING]\v'-\\n[#EM_ADJUST]u'\*[FU1]\(em +. PRINT "\m[\\*[$FINIS_COLOR]]\v'-\\n[#EM_ADJUST]u'\(em\v'+\\n[#EM_ADJUST]u'\\*[$FINIS_STRING]\v'-\\n[#EM_ADJUST]u'\*[FU1]\(em\m[] . \} +. ev .END \# \# ==================================================================== @@ -5549,6 +5877,24 @@ y\\R'#DESCENDER \\n[.cdp]' .END \# \# +\# HDRFTR COLOR +\# ------------ +\# *Arguments: +\# <pre-defined XCOLOR or NEWCOLOR> +\# *Function: +\# Sets register #HDRFTR_COLOR to 1; defines string $HDRFTR_COLOR to +\# argument. +\# *Notes: +\# User must define an XCOLOR or NEWCOLOR before using +\# HDRFTR_COLOR. +\# +.MAC HDRFTR_COLOR END +. if \\n[#PRINT_STYLE]=1 \{ .return \} +. nr #HDRFTR_COLOR 1 +. ds $HDRFTR_COLOR \\$1 +.END +\# +\# \# HDRFTR RULE GAP \# --------------- \# *Argument: @@ -5634,6 +5980,22 @@ y\\R'#DESCENDER \\n[.cdp]' .END \# \# +\# HDRFTR LEFT COLOR +\# ----------------- +\# *Argument: +\# <pre-defined color name> +\# *Function: +\# Sets register #HDRFTR_LEFT_COLOR to 1; creates string +\# $HDRFTR_LEFT_COLOR +\# *Notes: +\# The color name must be pre-defined with NEWCOLOR or XCOLOR. +\# +.MAC HDRFTR_LEFT_COLOR END +. nr #HDRFTR_LEFT_COLOR 1 +. ds $HDRFTR_LEFT_COLOR \\$1 +.END +\# +\# \# HDRFTR LEFT CAPS \# ---------------- \# *Argument: @@ -5650,7 +6012,7 @@ y\\R'#DESCENDER \\n[.cdp]' . \} . el \{\ . nr #HDRFTR_LEFT_CAPS 0 -. ds $HDRFTR_RIGHT_SIZE_CHANGE +0 +. ds $HDRFTR_LEFT_SIZE_CHANGE +0 . \} .END \# @@ -5732,6 +6094,22 @@ y\\R'#DESCENDER \\n[.cdp]' .END \# \# +\# HDRFTR CENTER COLOR +\# ------------------- +\# *Argument: +\# <pre-defined color name> +\# *Function: +\# Sets register #HDRFTR_CENTER_COLOR to 1; creates string +\# $HDRFTR_CENTER_COLOR +\# *Notes: +\# The color name must be pre-defined with NEWCOLOR or XCOLOR. +\# +.MAC HDRFTR_CENTER_COLOR END +. nr #HDRFTR_CENTER_COLOR 1 +. ds $HDRFTR_CENTER_COLOR \\$1 +.END +\# +\# \# HDRFTR CENTER CAPS \# ------------------ \# *Argument: @@ -5865,6 +6243,22 @@ y\\R'#DESCENDER \\n[.cdp]' .END \# \# +\# HDRFTR RIGHT COLOR +\# ------------------ +\# *Argument: +\# <pre-defined color name> +\# *Function: +\# Sets register #HDRFTR_RIGHT_COLOR to 1; creates string +\# $HDRFTR_RIGHT_COLOR +\# *Notes: +\# The color name must be pre-defined with NEWCOLOR or XCOLOR. +\# +.MAC HDRFTR_RIGHT_COLOR END +. nr #HDRFTR_RIGHT_COLOR 1 +. ds $HDRFTR_RIGHT_COLOR \\$1 +.END +\# +\# \# HDRFTR RIGHT CAPS \# ----------------- \# *Argument: @@ -5885,6 +6279,25 @@ y\\R'#DESCENDER \\n[.cdp]' . \} .END \# +\# +\# HDRFTR RULE COLOR +\# ----------------- +\# *Arguments: +\# <pre-defined XCOLOR or NEWCOLOR> +\# *Function: +\# Sets register #HDRFTR_COLOR to 1; defines string +\# $HDRFTR_RULE_COLOR to argument. +\# *Notes: +\# User must define an XCOLOR or NEWCOLOR before using +\# HDRFTR_RULE_COLOR. +\# +.MAC HDRFTR_RULE_COLOR END +. if \\n[#PRINT_STYLE]=1 \{ .return \} +. nr #HDRFTR_RULE_COLOR 1 +. ds $HDRFTR_RULE_COLOR \\$1 +.END +\# +\# \# HDRFTR RULE \# ----------- \# *Arguments: @@ -5897,12 +6310,21 @@ y\\R'#DESCENDER \\n[.cdp]' . ie '\\$0'HDRFTR_RULE_INTERNAL' \{\ . ie \\n[#USERDEF_HDRFTR] \{\ . nr #CAP_HEIGHT_ADJUST \\n[#HDRFTR_HEIGHT] -. PT_SIZE 12 -. if \\n[#HEADERS_ON] \{ .ALD \\n[#HDRFTR_RULE_GAP]u \} +. ps 12 +. if \\n[#HEADERS_ON] \{\ +. rt \\nyu +. ALD \\n[#HDRFTR_RULE_GAP]u +. \} . if \\n[#FOOTERS_ON] \{\ +. rt \\nyu . RLD \\n[#HDRFTR_RULE_GAP]u+\\n[#CAP_HEIGHT_ADJUST]u+1p . \} -. PRINT \\l'\\n[#DOC_L_LENGTH]u' +. ie \\n[#HDRFTR_RULE_COLOR]=1 \{\ +. PRINT \m[\\*[$HDRFTR_RULE_COLOR]]\\l'\\n[#DOC_L_LENGTH]u'\m[] +. \} +. el \{\ +. PRINT \\l'\\n[#DOC_L_LENGTH]u' +. \} . br . \} . el \{\ @@ -5919,12 +6341,21 @@ y\\R'#DESCENDER \\n[.cdp]' . \} . el \{ .nr #CAP_HEIGHT_ADJUST \\n[#RIGHT_CAP_HEIGHT] \} . \} -. PT_SIZE 12 -. if \\n[#HEADERS_ON] \{ .ALD \\n[#HDRFTR_RULE_GAP]u \} +. ps 12 +. if \\n[#HEADERS_ON] \{\ +. rt \\nyu +. ALD \\n[#HDRFTR_RULE_GAP]u +. \} . if \\n[#FOOTERS_ON] \{\ -. RLD \\n[#LEAD]u*3u+\\n[#HDRFTR_RULE_GAP]u+\\n[#CAP_HEIGHT_ADJUST]u+1p +. rt \\nyu +. RLD \\n[#HDRFTR_RULE_GAP]u+\\n[#CAP_HEIGHT_ADJUST]u+1p +. \} +. ie \\n[#HDRFTR_RULE_COLOR]=1 \{\ +. PRINT \m[\\*[$HDRFTR_RULE_COLOR]]\\l'\\n[#DOC_L_LENGTH]u'\m[] +. \} +. el \{\ +. PRINT \\l'\\n[#DOC_L_LENGTH]u' . \} -. PRINT \\l'\\n[#DOC_L_LENGTH]u' . br . \} . \} @@ -6100,7 +6531,6 @@ y\\R'#DESCENDER \\n[.cdp]' . if !\\n[#PRINT_FOOTER_ON_PAGE_1] \{ .return \} . \} . \} -. if \\n[#HEADERS_ON] \{ .vs 0 \} . if \\n[#USERDEF_HDRFTR] \{\ . PRINT_USERDEF_HDRFTR . return @@ -6115,9 +6545,13 @@ y\\R'#DESCENDER \\n[.cdp]' . nr #HDRFTR_TMP_CAPS_SWITCH \\n[#HDRFTR_LEFT_CAPS] . nr #HDRFTR_LEFT_CAPS \\n[#HDRFTR_RIGHT_CAPS] . nr #HDRFTR_RIGHT_CAPS \\n[#HDRFTR_TMP_CAPS_SWITCH] +. ds $HDRFTR_TMP_COLOR_SWITCH \\*[$HDRFTR_LEFT_COLOR] +. ds $HDRFTR_LEFT_COLOR \\*[$HDRFTR_RIGHT_COLOR] +. ds $HDRFTR_RIGHT_COLOR \\*[$HDRFTR_TMP_COLOR_SWITCH] . rr #HDRFTR_TMP_CAPS_SWITCH . rm $HDRFTR_TMP_SWITCH . rm $HDRFTR_TMP_SIZE_CHANGE_SWITCH +. rm $HDRFTR_TMP_COLOR_SWITCH . nr #SWITCH_HDRFTR 0 . \} . nr #PAGENUMBER \\n%+\\n[#PAGE_NUM_ADJ] @@ -6143,11 +6577,12 @@ y\\R'#DESCENDER \\n[.cdp]' . if \\n[#HDRFTR_LEFT_CAPS] \{ .CAPS OFF \} . CENTER . if \\n[#HDRFTR_CENTER_CAPS] \{ .CAPS \} +. rt \\nyu . ie '\\*[$HDRFTR_CENTER]'#' \{\ -. PRINT \\v'-(\\n[#LEAD]u*1u)'\\h'\\n[#HDRFTR_CTR_PAD_LEFT]u'\\n[#PAGENUMBER]\\h'\\n[#HDRFTR_CTR_PAD_RIGHT]u' +. PRINT \\h'\\n[#HDRFTR_CTR_PAD_LEFT]u'\\n[#PAGENUMBER]\\h'\\n[#HDRFTR_CTR_PAD_RIGHT]u' . \} . el \{\ -. ie !'\\*[$HDRFTR_CENTER]'' \{ .PRINT \\v'-(\\n[#LEAD]u*1u)'\\h'\\n[#HDRFTR_CTR_PAD_LEFT]u'\\*[$HDRFTR_CENTER]\\h'\\n[#HDRFTR_CTR_PAD_RIGHT]u' \} +. ie !'\\*[$HDRFTR_CENTER]'' \{ .PRINT \\h'\\n[#HDRFTR_CTR_PAD_LEFT]u'\\*[$HDRFTR_CENTER]\\h'\\n[#HDRFTR_CTR_PAD_RIGHT]u' \} . el \{ .PRINT \& \} . \} . if \\n[#HDRFTR_CENTER_CAPS] \{ .CAPS OFF \} @@ -6155,19 +6590,26 @@ y\\R'#DESCENDER \\n[.cdp]' . if e \{ .RIGHT \} . if \\n[#RECTO_VERSO]=0 \{ .RIGHT \} . if \\n[#HDRFTR_RIGHT_CAPS] \{ .CAPS \} +. rt \\nyu . ie '\\*[$HDRFTR_RIGHT]'#' \{\ -. PRINT \\v'-(\\n[#LEAD]u*2u)'\\n[#PAGENUMBER] +. PRINT \\n[#PAGENUMBER] . \} . el \{\ -. ie !'\\*[$HDRFTR_RIGHT]'' \{ .PRINT \\v'-(\\n[#LEAD]u*2u)'\\*[$HDRFTR_RIGHT] \} +. ie !'\\*[$HDRFTR_RIGHT]'' \{ .PRINT \\*[$HDRFTR_RIGHT] \} . el \{ .PRINT \& \} . \} . if \\n[#HDRFTR_RIGHT_CAPS] \{ .CAPS OFF \} . \} . if \\n[#PRINT_STYLE]=2 \{\ -. FAMILY \\*[$HDRFTR_LEFT_FAM] -. FT \\*[$HDRFTR_LEFT_FT] -. PT_SIZE \\n[#HDRFTR_PT_SIZE]u\\*[$HDRFTR_LEFT_SIZE_CHANGE] +. if \\n[#HDRFTR_COLOR]=1 \{\ +. nf +\m[\\*[$HDRFTR_COLOR]] +. EL +. \} +. fam \\*[$HDRFTR_LEFT_FAM] +. ft \\*[$HDRFTR_LEFT_FT] +. ps \\n[#HDRFTR_PT_SIZE]u\\*[$HDRFTR_LEFT_SIZE_CHANGE] +. vs 12 . if \\n[#FOOTERS_ON] \{\ . di NULL . SIZESPECS @@ -6178,15 +6620,30 @@ y\\R'#DESCENDER \\n[.cdp]' . if e \{ .RIGHT \} . if \\n[#RECTO_VERSO]=0 \{ .LEFT \} . if \\n[#HDRFTR_LEFT_CAPS] \{ .CAPS \} -. ie '\\*[$HDRFTR_LEFT]'#' \{ .PRINT \\n[#PAGENUMBER] \} +. ie '\\*[$HDRFTR_LEFT]'#' \{\ +. ie \\n[#HDRFTR_LEFT_COLOR]=1 \{\ +. PRINT \m[\\*[$HDRFTR_LEFT_COLOR]]\\n[#PAGENUMBER]\m[] +. \} +. el \{\ +. PRINT \\n[#PAGENUMBER] +. \} +. \} . el \{\ -. ie !'\\*[$HDRFTR_LEFT]'' \{ . PRINT \\*[$HDRFTR_LEFT] \} +. ie !'\\*[$HDRFTR_LEFT]'' \{\ +. ie \\n[#HDRFTR_LEFT_COLOR]=1 \{\ +. PRINT \m[\\*[$HDRFTR_LEFT_COLOR]]\\*[$HDRFTR_LEFT]\m[] +. \} +. el \{\ +. PRINT \\*[$HDRFTR_LEFT] +. \} +. \} . el \{ .PRINT \& \} . \} . if \\n[#HDRFTR_LEFT_CAPS] \{ .CAPS OFF \} -. FAMILY \\*[$HDRFTR_CENTER_FAM] -. FT \\*[$HDRFTR_CENTER_FT] -. PT_SIZE \\n[#HDRFTR_PT_SIZE]u\\*[$HDRFTR_CENTER_SIZE_CHANGE] +. fam \\*[$HDRFTR_CENTER_FAM] +. ft \\*[$HDRFTR_CENTER_FT] +. ps \\n[#HDRFTR_PT_SIZE]u\\*[$HDRFTR_CENTER_SIZE_CHANGE] +. vs 12 . if \\n[#FOOTERS_ON] \{\ . di NULL . SIZESPECS @@ -6195,17 +6652,31 @@ y\\R'#DESCENDER \\n[.cdp]' . \} . CENTER . if \\n[#HDRFTR_CENTER_CAPS] \{ .CAPS \} +. rt \\nyu . ie '\\*[$HDRFTR_CENTER]'#' \{\ -. PRINT \\v'-(\\n[#LEAD]u*1u)'\\h'\\n[#HDRFTR_CTR_PAD_LEFT]u'\\n[#PAGENUMBER]\\h'\\n[#HDRFTR_CTR_PAD_RIGHT]u' +. ie \\n[#HDRFTR_CENTER_COLOR]=1 \{\ +. PRINT \\h'\\n[#HDRFTR_CTR_PAD_LEFT]u'\m[\\*[$HDRFTR_CENTER_COLOR]]\\n[#PAGENUMBER]\\h'\\n[#HDRFTR_CTR_PAD_RIGHT]u'\m[] +. \} +. el \{\ +. PRINT \\h'\\n[#HDRFTR_CTR_PAD_LEFT]u'\\n[#PAGENUMBER]\\h'\\n[#HDRFTR_CTR_PAD_RIGHT]u' +. \} . \} . el \{\ -. ie !'\\*[$HDRFTR_CENTER]'' \{ .PRINT \\v'-(\\n[#LEAD]u*1u)'\\h'\\n[#HDRFTR_CTR_PAD_LEFT]u'\\*[$HDRFTR_CENTER]\\h'\\n[#HDRFTR_CTR_PAD_RIGHT]u' \} +. ie !'\\*[$HDRFTR_CENTER]'' \{\ +. ie \\n[#HDRFTR_CENTER_COLOR]=1 \{\ +. PRINT \\h'\\n[#HDRFTR_CTR_PAD_LEFT]u'\m[\\*[$HDRFTR_CENTER_COLOR]]\\*[$HDRFTR_CENTER]\\h'\\n[#HDRFTR_CTR_PAD_RIGHT]u'\m[] +. \} +. el \{\ +. PRINT \\h'\\n[#HDRFTR_CTR_PAD_LEFT]u'\\*[$HDRFTR_CENTER]\\h'\\n[#HDRFTR_CTR_PAD_RIGHT]u' +. \} +. \} . el \{ .PRINT \& \} . \} . if \\n[#HDRFTR_CENTER_CAPS] \{ .CAPS OFF \} -. FAMILY \\*[$HDRFTR_RIGHT_FAM] -. FT \\*[$HDRFTR_RIGHT_FT] -. PT_SIZE \\n[#HDRFTR_PT_SIZE]u\\*[$HDRFTR_RIGHT_SIZE_CHANGE] +. fam \\*[$HDRFTR_RIGHT_FAM] +. ft \\*[$HDRFTR_RIGHT_FT] +. ps \\n[#HDRFTR_PT_SIZE]u\\*[$HDRFTR_RIGHT_SIZE_CHANGE] +. vs 12 . if \\n[#FOOTERS_ON] \{\ . di NULL . SIZESPECS @@ -6216,11 +6687,24 @@ y\\R'#DESCENDER \\n[.cdp]' . if e \{ .LEFT \} . if \\n[#RECTO_VERSO]=0 \{ .RIGHT \} . if \\n[#HDRFTR_RIGHT_CAPS] \{ .CAPS \} +. rt \\nyu . ie '\\*[$HDRFTR_RIGHT]'#' \{\ -. PRINT \\v'-(\\n[#LEAD]u*2u)'\\n[#PAGENUMBER] +. ie \\n[#HDRFTR_RIGHT_COLOR]=1 \{\ +. PRINT \m[\\*[$HDRFTR_RIGHT_COLOR]]\\n[#PAGENUMBER]\m[] +. \} +. el \{\ +. PRINT \\n[#PAGENUMBER] +. \} . \} . el \{\ -. ie !'\\*[$HDRFTR_RIGHT]'' \{ .PRINT \\v'-(\\n[#LEAD]u*2u)'\\*[$HDRFTR_RIGHT] \} +. ie !'\\*[$HDRFTR_RIGHT]'' \{\ +. ie \\n[#HDRFTR_RIGHT_COLOR]=1 \{\ +. PRINT \m[\\*[$HDRFTR_RIGHT_COLOR]]\\*[$HDRFTR_RIGHT]\m[] +. \} +. el \{\ +. PRINT \\*[$HDRFTR_RIGHT] +. \} +. \} . el \{ .PRINT \& \} . \} . if \\n[#HDRFTR_RIGHT_CAPS] \{ .CAPS OFF \} @@ -6248,6 +6732,10 @@ y\\R'#DESCENDER \\n[.cdp]' . FAMILY \\*[$HDRFTR_FAM] . FT R . PT_SIZE \\n[#HDRFTR_PT_SIZE]u +. if \\n[#HDRFTR_COLOR]=1 \{\ +. nf +. COLOR \\*[$HDRFTR_COLOR] +. \} . \} . ie \\n[#RECTO_VERSO] \{\ . if o \{\ @@ -6306,6 +6794,10 @@ y\\R'#DESCENDER \\n[.cdp]' . \} . \} . fc +. if \\n[#PRINT_STYLE]=2 \{\ +. ie \\n[#HDRFTR_COLOR]=1 \m[\\*[$HDRFTR_COLOR]] +. el \m[black] +. \} . if \\n[#HDRFTR_RULE] \{\ . HDRFTR_RULE_INTERNAL . \} @@ -6391,9 +6883,9 @@ y\\R'#DESCENDER \\n[.cdp]' . rr #TOC_RV_SWITCH . \} . ev HEADER -. if \\n[#PRINT_STYLE]=1 \{ .vs 0 \} -. if \\n[#PRINT_STYLE]=2 \{ .LS 0 \} +. if \\n[#PAGE_NUM_V_POS]=1 \{ .vs 0 \} . sp |\\n[#HEADER_MARGIN]u-1v +. mk y . ll \\n[#DOC_L_LENGTH]u . ta \\n(.lu . if \\n[#PRINT_STYLE]=1 \{\ @@ -6402,9 +6894,10 @@ y\\R'#DESCENDER \\n[.cdp]' . ps 12\\*[$HDRFTR_SIZE_CHANGE] . \} . if \\n[#PRINT_STYLE]=2 \{\ -. FAMILY \\*[$HDRFTR_FAM] -. FT R -. PT_SIZE \\n[#DOC_PT_SIZE]u\\*[$HDRFTR_SIZE_CHANGE] +. fam \\*[$HDRFTR_FAM] +. ft R +. ps \\n[#DOC_PT_SIZE]u\\*[$HDRFTR_SIZE_CHANGE] +. vs 12 . \} . nr #HDRFTR_PT_SIZE \\n[#PT_SIZE] . if \\n[#CAPS_ON] \{\ @@ -6482,15 +6975,18 @@ y\\R'#DESCENDER \\n[.cdp]' . el \{\ . ie \\n[#EPI_FITS] \{ .ns \} . el \{ .ALD \\n[#DOC_LEAD]u-\\n[#EPI_LEAD]u \} -. \} +. \} . \} . el \{ .ns \} . ns . if \\n[#COLUMNS] \{\ +. nr #L_MARGIN \\n[#DOC_L_MARGIN] . if \\n[#RECTO_VERSO] \{ .COLUMNS \\n[#NUM_COLS] \\n[#GUTTER]u \} . nr #COL_NUM 0 1 . mk dc . po \\n[#COL_\\n+[#COL_NUM]_L_MARGIN]u +. nr #L_MARGIN \\n(.o +. if \\n[#TAB_ACTIVE] \{ .TAB \\n[#CURRENT_TAB] \} . ll \\n[#COL_L_LENGTH]u . ta \\n(.lu . if \\n[#QUOTE] \{\ @@ -6582,18 +7078,23 @@ y\\R'#DESCENDER \\n[.cdp]' \# .MAC FOOTER END . ev PAGE_BOTTOM -. if \\n[#START]=1 \{\ -. bp -. ev -. return -. \} +\# Removed this next bit; can't figure out why I needed it. +\#. if \\n[#START]=1 \{\ +\#. bp +\#. ev +\#. rr #START +\#. return +\#. \} . nr #L_MARGIN_DIFF \\n[#L_MARGIN]-\\n[#DOC_L_MARGIN] . if !\\n[#FN_DEFER] \{\ . nr #DIVER_DEPTH 0 . if \\n[#FN_COUNT] \{\ . sp |\\n[#PAGE_LENGTH]u-(\\n[#B_MARGIN]u+\\n[#FN_DEPTH]u) . po \\n[#DOC_L_MARGIN]u -. if \\n[#COLUMNS] \{ .po \\n[#COL_\\n[#COL_NUM]_L_MARGIN]u \} +. if \\n[#COLUMNS] \{\ +. po \\n[#COL_\\n[#COL_NUM]_L_MARGIN]u +. nr #L_MARGIN \\n(.o +. \} . nf . FOOTNOTES . rm FOOTNOTES @@ -6611,18 +7112,26 @@ y\\R'#DESCENDER \\n[.cdp]' . ie \\n[#ENDNOTES] \{ .sp |\\n(ecu-\\n[#EN_LEAD]u \} . el \{ .sp |\\n(dcu \} . po \\n[#COL_\\n+[#COL_NUM]_L_MARGIN]u +. nr #L_MARGIN \\n(.o . PROCESS_FN_LEFTOVER . if !\\n[#EPIGRAPH] \{ .rr #COL_NEXT \} . if !\\n[#QUOTE] \{ .rr #COL_NEXT \} +. if \\n[#TAB_ACTIVE] \{ .TAB \\n[#CURRENT_TAB] \} . if \\n[#QUOTE] \{\ -. nr #Q_OFFSET \\n[#L_MARGIN]+(\\n[#PP_INDENT]*\\n[#Q_OFFSET_VALUE]) -. if \\n[#COLUMNS] \{ .nr #Q_OFFSET \\n[#COL_\\n[#COL_NUM]_L_MARGIN]+(\\n[#PP_INDENT]*\\n[#Q_OFFSET_VALUE]) \} -. po \\n[#Q_OFFSET]u +. ie \\n[#TAB_ACTIVE] \{ .TAB \\n[#CURRENT_TAB] \} +. el \{\ +. nr #Q_OFFSET \\n[#L_MARGIN]+(\\n[#PP_INDENT]*\\n[#Q_OFFSET_VALUE]) +. if \\n[#COLUMNS] \{ .nr #Q_OFFSET \\n[#COL_\\n[#COL_NUM]_L_MARGIN]+(\\n[#PP_INDENT]*\\n[#Q_OFFSET_VALUE]) \} +. po \\n[#Q_OFFSET]u +. \} . \} . if \\n[#EPIGRAPH] \{\ -. nr #EPI_OFFSET \\n[#L_MARGIN]+(\\n[#PP_INDENT]*\\n[#EPI_OFFSET_VALUE]) -. if \\n[#COLUMNS] \{ .nr #EPI_OFFSET \\n[#COL_\\n[#COL_NUM]_L_MARGIN]+(\\n[#PP_INDENT]*\\n[#EPI_OFFSET_VALUE]) \} -. po \\n[#EPI_OFFSET]u +. ie \\n[#TAB_ACTIVE] \{ .TAB \\n[#CURRENT_TAB] \} +. el \{\ +. nr #EPI_OFFSET \\n[#L_MARGIN]+(\\n[#PP_INDENT]*\\n[#EPI_OFFSET_VALUE]) +. if \\n[#COLUMNS] \{ .nr #EPI_OFFSET \\n[#COL_\\n[#COL_NUM]_L_MARGIN]+(\\n[#PP_INDENT]*\\n[#EPI_OFFSET_VALUE]) \} +. po \\n[#EPI_OFFSET]u +. \} . \} . ie \\n[#EPIGRAPH] \{\ . ie !\\n[#EPI_ACTIVE] \{\ @@ -6656,7 +7165,9 @@ y\\R'#DESCENDER \\n[.cdp]' . nr #SKIP_FOOTER 1 . \} . el \{\ +. vs 12 . sp |\\n[#PAGE_LENGTH]u-\\n[#FOOTER_MARGIN]u-1v +. mk y . \} . ev FOOTER . po \\n[#DOC_L_MARGIN]u @@ -6902,6 +7413,23 @@ y\\R'#DESCENDER \\n[.cdp]' .END \# \# +\# HEAD COLOR +\# ---------- +\# *Arguments: +\# <pre-defined XCOLOR or NEWCOLOR> +\# *Function: +\# Defines string $HEAD_COLOR to argument. +\# *Notes: +\# User must define an XCOLOR or NEWCOLOR before using +\# HEAD_COLOR. +\# +.MAC HEAD_COLOR END +. if \\n[#PRINT_STYLE]=1 \{ .return \} +. nr #HEAD_COLOR 1 +. ds $HEAD_COLOR \\$1 +.END +\# +\# \# HEAD SPACE \# ---------- \# *Arguments: @@ -7084,6 +7612,14 @@ y\\R'#DESCENDER \\n[.cdp]' \# Print head . nr #ARG_NUM 0 1 . if \\n[#HEAD_CAPS] \{ .CAPS \} +. if \\n[#PRINT_STYLE]=2 \{\ +. if \\n[#HEAD_COLOR]=1 \{\ +. TRAP OFF +. COLOR \\*[$HEAD_COLOR] +. EL +. TRAP +. \} +. \} . while \\n[#ARG_NUM]<\\n[#NUM_ARGS] \{\ . ie \\n[#NUMBER_HEAD] \{\ . ie \\n[#ARG_NUM]=0 \{\ @@ -7173,6 +7709,23 @@ y\\R'#DESCENDER \\n[.cdp]' .END \# \# +\# SUBHEAD COLOR +\# ------------- +\# *Arguments: +\# <pre-defined XCOLOR or NEWCOLOR> +\# *Function: +\# Defines string $SH_COLOR to argument. +\# *Notes: +\# User must define an XCOLOR or NEWCOLOR before using +\# SUBHEAD_COLOR. +\# +.MAC SUBHEAD_COLOR END +. if \\n[#PRINT_STYLE]=1 \{ .return \} +. nr #SH_COLOR 1 +. ds $SH_COLOR \\$1 +.END +\# +\# \# SUBHEAD QUAD \# ------------ \# *Argument: @@ -7353,6 +7906,7 @@ y\\R'#DESCENDER \\n[.cdp]' . if \\n[#SINGLE_SPACE] \{ .ALD \\n[#DOC_LEAD]u \} . \} . if \\n[#PRINT_STYLE]=2 \{\ +. if \\n[#SH_COLOR]=1 \{ .COLOR \\*[$SH_COLOR] \} . ie \\n[#PP_SPACE]=0 \{\ . while \\n[#ARG_NUM]<\\n[#NUM_ARGS] \{\ . ie \\n[#NUMBER_SH] \{\ @@ -7452,6 +8006,23 @@ y\\R'#DESCENDER \\n[.cdp]' .END \# \# +\# PARAHEAD COLOR +\# -------------- +\# *Arguments: +\# <pre-defined XCOLOR or NEWCOLOR> +\# *Function: +\# Defines string $PH_COLOR to argument. +\# *Notes: +\# User must define an XCOLOR or NEWCOLOR before using +\# PARAHEAD_COLOR. +\# +.MAC PARAHEAD_COLOR END +. if \\n[#PRINT_STYLE]=1 \{ .return \} +. nr #PH_COLOR 1 +. ds $PH_COLOR \\$1 +.END +\# +\# \# PARAHEAD INDENT \# --------------- \# *Argument: @@ -7578,32 +8149,35 @@ y\\R'#DESCENDER \\n[.cdp]' . FAM \\*[$PH_FAM] . FT \\*[$PH_FT] . PT_SIZE \\*[$PH_SIZE_CHANGE] -. ie \\n[#NUMBER_PH] \{\ -. if \\n[#NUMBER_HEAD] \{\ +. if \\n[#PH_COLOR]=1 \{ .COLOR \\*[$PH_COLOR] \} +. ie \\n[#NUMBER_PH] \{\ +. if \\n[#NUMBER_HEAD] \{\ +. ie \\n[#NUMBER_SH] \{\ +. PRINT "\R'#NUMBERED 1'\\n[#HEAD_NUM].\\n[#SH_NUM].\\n+[#PH_NUM].\0\\$1\h'.6m'\c" +. \} +. el \{\ +. PRINT "\R'#NUMBERED 1'\\n[#HEAD_NUM].\\n+[#PH_NUM].\0\\$1\h'.6m'\c" +. \} +. \} . ie \\n[#NUMBER_SH] \{\ -. PRINT "\R'#NUMBERED 1'\\n[#HEAD_NUM].\\n[#SH_NUM].\\n+[#PH_NUM].\0\\$1\h'.6m'\c" +. if !\\n[#NUMBERED] \{\ +. PRINT "\\n[#SH_NUM].\\n+[#PH_NUM].\0\\$1\h'.6m'\c" +. \} . \} . el \{\ -. PRINT "\R'#NUMBERED 1'\\n[#HEAD_NUM].\\n+[#PH_NUM].\0\\$1\h'.6m'\c" -. \} -. \} -. ie \\n[#NUMBER_SH] \{\ -. if !\\n[#NUMBERED] \{\ -. PRINT "\\n[#SH_NUM].\\n+[#PH_NUM].\0\\$1\h'.6m'\c" +. if !\\n[#NUMBERED] \{\ +. PRINT "\\n+[#PH_NUM].\0\\$1\h'.6m'\c" +. \} . \} . \} . el \{\ -. if !\\n[#NUMBERED] \{\ -. PRINT "\\n+[#PH_NUM].\0\\$1\h'.6m'\c" -. \} +. PRINT "\\$1\h'.6m'\c" . \} . \} -. el \{\ -. PRINT "\\$1\h'.6m'\c" -. \} . FAMILY \\*[$DOC_FAM] . FT \\*[$PP_FT] . PT_SIZE \\n[#DOC_PT_SIZE]u +. if \\n[#PH_COLOR]=1 \m[]\c . if \\n[#SLANT_WAS_ON] \{\ . rr #SLANT_WAS_ON 1 \E*[SLANT]\c @@ -7646,6 +8220,22 @@ y\\R'#DESCENDER \\n[.cdp]' .END \# \# +\# LINEBREAK COLOR +\# --------------- +\# *Arguments: +\# <pre-defined XCOLOR or NEWCOLOR> +\# *Function: +\# Defines string $LINEBREAK_COLOR to argument. +\# *Notes: +\# User must define an XCOLOR or NEWCOLOR before using +\# LINEBREAK_COLOR. +\# +.MAC LINEBREAK_COLOR END +. if \\n[#PRINT_STYLE]=1 \{ .return \} +. ds $LINEBREAK_COLOR \\$1 +.END +\# +\# \# LINE BREAK \# ---------- \# *Arguments: @@ -7668,10 +8258,13 @@ y\\R'#DESCENDER \\n[.cdp]' . ie \\n[#END_QUOTE] \{ . \} . el \{ .ALD \\n[#DOC_LEAD]u \} . \} +. ev LINEBREAK +. evc 0 . CENTER -. PRINT \\v'\\*[$LINEBREAK_CHAR_V_ADJ]'\\*[$LINEBREAK_CHAR]\\v'\\*[$LINEBREAK_CHAR_V_ADJ]' +. PRINT \m[\\*[$LINEBREAK_COLOR]]\\v'\\*[$LINEBREAK_CHAR_V_ADJ]'\\*[$LINEBREAK_CHAR]\\v'\\*[$LINEBREAK_CHAR_V_ADJ]'\m[] . if \\n[#PRINT_STYLE]=1 \{ .ALD \\n[#DOC_LEAD]u \} . if \\n[#PRINT_STYLE]=2 \{ .ALD \\n[#DOC_LEAD]u \} +. ev . QUAD \\*[$DOC_QUAD] . \} . nr #LINEBREAK 1 @@ -7803,7 +8396,10 @@ y\\R'#DESCENDER \\n[.cdp]' . br . if !\\n[#ENDNOTE] \{ .po \\n[#L_MARGIN]u \} . if \\n[#COLUMNS] \{\ -. if !\\n[#ENDNOTE] \{ .po \\n[#COL_\\n[#COL_NUM]_L_MARGIN]u \} +. if !\\n[#ENDNOTE] \{\ +. po \\n[#COL_\\n[#COL_NUM]_L_MARGIN]u +. nr #L_MARGIN \\n(.o +. \} . \} . if \\n[#TAB_ACTIVE] \{ .TAB \\n[#CURRENT_TAB] \} . ie \\n[#PRINT_STYLE]=1 \{\ @@ -7970,6 +8566,24 @@ y\\R'#DESCENDER \\n[.cdp]' .END \# \# +\# QUOTE COLOR +\# ----------- +\# *Arguments: +\# <pre-defined XCOLOR or NEWCOLOR> +\# *Function: +\# Sets register #QUOTE_COLOR to 1; defines string $QUOTE_COLOR to +\# argument. +\# *Notes: +\# User must define an XCOLOR or NEWCOLOR before using +\# QUOTE_COLOR. +\# +.MAC QUOTE_COLOR END +. if \\n[#PRINT_STYLE]=1 \{ .return \} +. nr #QUOTE_COLOR 1 +. ds $QUOTE_COLOR \\$1 +.END +\# +\# \# UNDERLINE QUOTES \# ---------------- \# *Arguments: @@ -8055,6 +8669,11 @@ y\\R'#DESCENDER \\n[.cdp]' . PT_SIZE \\n[#DOC_PT_SIZE]u\\*[$QUOTE_SIZE_CHANGE] . LS \\n[#DOC_LEAD]u . LEFT +. if \\n[#QUOTE_COLOR]=1 \{\ +. nf +\m[\\*[$QUOTE_COLOR]] +. EL +. \} . \} . nr #Q_TOP \\n(nl . if \\n[#PRINT_STYLE]=1 \{\ @@ -8114,6 +8733,24 @@ y\\R'#DESCENDER \\n[.cdp]' .END \# \# +\# BLOCKQUOTE COLOR +\# ---------------- +\# *Arguments: +\# <pre-defined XCOLOR or NEWCOLOR> +\# *Function: +\# Sets register #BQUOTE_COLOR to 1; defines string +\# $BQUOTE_COLOR to argument. +\# *Notes: +\# User must define an XCOLOR or NEWCOLOR before using +\# BLOCKQUOTE_COLOR. +\# +.MAC BLOCKQUOTE_COLOR END +. if \\n[#PRINT_STYLE]=1 \{ .return \} +. nr #BQUOTE_COLOR 1 +. ds $BQUOTE_COLOR \\$1 +.END +\# +\# \# BLOCKQUOTE QUAD \# --------------- \# *Arguments: @@ -8190,7 +8827,12 @@ y\\R'#DESCENDER \\n[.cdp]' . if \\n[#ENDNOTE] \{\ . PT_SIZE \\n[#EN_PS]u\\*[$BQUOTE_SIZE_CHANGE] . \} -. QUAD \\*[$BQUOTE_QUAD] +. if \\n[#BQUOTE_COLOR]=1 \{\ +. nf +\m[\\*[$BQUOTE_COLOR]] +. EL +. \} +. QUAD \\*[$BQUOTE_QUAD] . HY . \} . nr #Q_TOP \\n(nl @@ -8217,7 +8859,7 @@ y\\R'#DESCENDER \\n[.cdp]' \# <none> \# *Function: \# Ends the diversion P_QUOTE or B_QUOTE. Spaces them according to -\# PRINT_STYLE, whether there's inter-paragraph spacing, and page +\# PRINTSTYLE, whether there's inter-paragraph spacing, and page \# position. TYPEWRITE treats spacing the same way in all circumstance \# (viz. an extra line space). TYPESET puts in only half \# line spaces if the entire quote plus 1 line of body under the quote @@ -8342,7 +8984,10 @@ y\\R'#DESCENDER \\n[.cdp]' . in \\n[#EN_TEXT_INDENT]u . \} . if \\n[#COLUMNS] \{\ -. if !\\n[#ENDNOTE] \{ .po \\n[#COL_\\n[#COL_NUM]_L_MARGIN]u \} +. if !\\n[#ENDNOTE] \{\ +. po \\n[#COL_\\n[#COL_NUM]_L_MARGIN]u +. nr #L_MARGIN \\n(.o +. \} . if \\n[#ENDNOTE] \{\ . in \\n[#EN_TEXT_INDENT]u . \} @@ -8386,7 +9031,7 @@ y\\R'#DESCENDER \\n[.cdp]' . nr #BROKEN_QUOTE 1 . REMOVE_INDENT . ev -. nr #Q_DEPTH \\n[#DIVER_DEPTH]+(\\n[#LEAD]*1) +. nr #Q_DEPTH \\n[#DIVER_DEPTH]+\\n[#LEAD] . if \\n[#PRINT_STYLE]=1 \{\ . if !\\n[#LINEBREAK] \{ .ALD \\n[#DOC_LEAD]u \} . if \\n[#HEAD] \{\ @@ -8432,7 +9077,10 @@ y\\R'#DESCENDER \\n[.cdp]' . \} . \} . po \\n[#L_MARGIN]u -. if \\n[#COLUMNS] \{ .po \\n[#COL_\\n[#COL_NUM]_L_MARGIN]u \} +. if \\n[#COLUMNS] \{\ +. po \\n[#COL_\\n[#COL_NUM]_L_MARGIN]u +. nr #L_MARGIN \\n(.o +. \} . QUAD \\*[$DOC_QUAD] . sp |\\n[#PAGE_LENGTH]u \" To trip footer/header . BLOCKQUOTE @@ -8447,9 +9095,8 @@ y\\R'#DESCENDER \\n[.cdp]' \# *Arguments: \# <none> | <anything> \# *Function: -\# Turns page numbering off or on. +\# Turns page numbering off or on during document processing. \# *Notes: -\# Page numbering is on by default with .PAPER. \# Default is on. \# .MAC PAGINATE END @@ -8533,6 +9180,22 @@ y\\R'#DESCENDER \\n[.cdp]' .END \# \# +\# PAGNUMBER COLOR +\# --------------- +\# *Arguments: +\# <pre-defined XCOLOR or NEWCOLOR> +\# *Function: +\# Defines string $PAGENUM_COLOR to argument. +\# *Notes: +\# User must define an XCOLOR or NEWCOLOR before using +\# PAGENUM_COLOR. +\# +.MAC PAGENUM_COLOR END +. if \\n[#PRINT_STYLE]=1 \{ .return \} +. ds $PAGENUM_COLOR \\$1 +.END +\# +\# \# PAGE NUMBER FORMAT \# ------------------ \# *Arguments: @@ -8603,15 +9266,24 @@ y\\R'#DESCENDER \\n[.cdp]' .END \# \# +.MAC PN_WITH_HYPHENS END +. nr #HYPHEN_ADJ \\n[#CAP_HEIGHT]/12 +. ds $HYPHEN \v'-\En[#HYPHEN_ADJ]u'-\v'\En[#HYPHEN_ADJ]u' +. PRINT \m[\\*[$PAGENUM_COLOR]]\\*[$HYPHEN]\|\\n[#PAGENUMBER]\|\\*[$HYPHEN] +.END +\# +\# \# PRINT PAGE NUMBER \# ----------------- \# *Arguments: \# <none> \# *Function: -\# Prints page number if PAGEINATE=1. +\# Prints page number if PAGINATE=1. \# .MAC PRINT_PAGE_NUMBER END . ev PAGENUMBER +. nf +. na . po \\n[#DOC_L_MARGIN]u . ll \\n[#DOC_L_LENGTH]u . ta \\n(.lu @@ -8623,16 +9295,16 @@ y\\R'#DESCENDER \\n[.cdp]' . ft R . ps 12 . \} -. if \\n[#PAGE_NUM_V_POS]=1 \{ .vs 0 \} +. if \\n[#PAGE_NUM_V_POS]=1 \{ .EL \} . if o \{\ . ie \\n[#PAGE_NUM_H_POS]=1 \{ .LEFT \} . el \{ .RIGHT \} . \} . if e \{\ -. ie \\n[#PAGE_NUM_H_POS]=1 \{ .RIGHT \} -. el \{ .LEFT \} +. ie \\n[#PAGE_NUM_H_POS]=1 \{ .RIGHT \} +. el \{ .LEFT \} . \} -. if \\n[#PAGE_NUM_H_POS]=2 \{.CENTER \} +. if \\n[#PAGE_NUM_H_POS]=2 \{ .CENTER \} . if \\n[#RECTO_VERSO]=0 \{\ . if \\n[#PAGE_NUM_H_POS]=1 \{ .LEFT \} . if \\n[#PAGE_NUM_H_POS]=2 \{ .CENTER \} @@ -8661,8 +9333,33 @@ y\\R'#DESCENDER \\n[.cdp]' . \} . \} . el \{\ -. ie \\n[#PAGE_NUM_HYPHENS] \{ .PRINT "- \\n[#PAGENUMBER] -" \} -. el \{ .PRINT "\\n[#PAGENUMBER]" \} +. ie \\n[#PAGE_NUM_HYPHENS] \{\ +. if '\\*[$PAGENUM_STYLE]'DIGIT' \{\ +. di NULL +1\\R'#CAP_HEIGHT \\n[.cht]' +. di +. PN_WITH_HYPHENS +. \} +. if '\\*[$PAGENUM_STYLE]'ROMAN' \{\ +. di NULL +I\\R'#CAP_HEIGHT \\n[.cht]' +. di +. PN_WITH_HYPHENS +. \} +. if '\\*[$PAGENUM_STYLE]'ALPHA' \{\ +. di NULL +E\\R'#CAP_HEIGHT \\n[.cht]' +. di +. PN_WITH_HYPHENS +. \} +. if '\\*[$PAGENUM_STYLE]'roman' \{\ +. PRINT \m[\\*[$PAGENUM_COLOR]]-\|\\n[#PAGENUMBER]\|- +. \} +. if '\\*[$PAGENUM_STYLE]'alpha' \{\ +. PRINT "\m[\\*[$PAGENUM_COLOR]]-\|\\n[#PAGENUMBER]\|-" +. \} +. \} +. el \{ .PRINT "\m[\\*[$PAGENUM_COLOR]]\\n[#PAGENUMBER]" \} . \} . ev .END @@ -8716,6 +9413,24 @@ y\\R'#DESCENDER \\n[.cdp]' .END \# \# +\# FOOTNOTE COLOR +\# -------------- +\# *Arguments: +\# <pre-defined XCOLOR or NEWCOLOR> +\# *Function: +\# Sets register #FOOTNOTE_COLOR to 1; defines string +\# $FOOTNOTE_COLOR to argument. +\# *Notes: +\# User must define an XCOLOR or NEWCOLOR before using +\# FOOTNOTE_COLOR. +\# +.MAC FOOTNOTE_COLOR END +. if \\n[#PRINT_STYLE]=1 \{ .return \} +. nr #FOOTNOTE_COLOR 1 +. ds $FOOTNOTE_COLOR \\$1 +.END +\# +\# \# FOOTNOTE AUTOLEAD \# ----------------- \# *Arguments: @@ -8953,6 +9668,14 @@ y\\R'#DESCENDER \\n[.cdp]' . \} . nr #FN_LEAD \\n[#LEAD] . da FOOTNOTES +. if \\n[#FOOTNOTE_COLOR]=1 \{\ +. TRAP OFF +. nf +\m[\\*[$FOOTNOTE_COLOR]] +. EL +. fi +. TRAP +. \} . if \\n[#EPIGRAPH] \{ .nr #FN_FOR_EPI 1 \} . if \\n[#FN_DEFER_SPACE] \{\ . if \\n[#FN_MARKER_STYLE]=1 \{ .ALD 1v \} @@ -9616,7 +10339,7 @@ y\\R'#DESCENDER \\n[.cdp]' \# \# \# ENDNOTES PAGES PAGE NUMBERING STYLE -\# ---- +\# ----------------------------------- \# *Argument: \# DIGIT | ROMAN | roman | ALPHA | alpha \# *Function: @@ -11036,6 +11759,7 @@ y\\R'#DESCENDER \\n[.cdp]' . rm $RESTORE_PAGENUM_STYLE . \} . rm $EN_TITLE +. rr #PAGENUM_STYLE_SET .END \# \# @@ -11095,7 +11819,7 @@ y\\R'#DESCENDER \\n[.cdp]' \# Sets header/footer/footnotes/etc... traps. \# Calculates the number of lines that actually fit on a \# page based on #B_MARGIN and resets page bottom trap to coincide -\# with the depth of that number of lines , or, if #ADJ_DOC_LEAD=1, +\# with the depth of that number of lines, or, if #ADJ_DOC_LEAD=1, \# adjusts #DOC_LEAD so that the last line of text on a page falls \# exactly on #B_MARGIN. \# @@ -11218,6 +11942,10 @@ y\\R'#DESCENDER \\n[.cdp]' .END \# \# +\# Set up a default papersize of US letter +\# +.PAPER LETTER +\# \# ==================================================================== \# \# +++DOCUMENT PROCESSING ALIASES+++ @@ -11227,11 +11955,24 @@ y\\R'#DESCENDER \\n[.cdp]' \# \# Macros \# ------ +.ALIAS BLOCKQUOTE_COLOUR BLOCKQUOTE_COLOR .ALIAS BREAK_BLOCKQUOTE BREAK_QUOTE .ALIAS BREAK_CITATION BREAK_QUOTE .ALIAS BREAK_CITE BREAK_QUOTE .ALIAS CITATION BLOCKQUOTE +.ALIAS CITATION_COLOUR CITATION_COLOR +.ALIAS CITATION_FAMILY BLOCKQUOTE_FAMILY +.ALIAS CITATION_FONT BLOCKQUOTE_FONT +.ALIAS CITATION_SIZE BLOCKQUOTE_SIZE +.ALIAS CITATION_COLOR BLOCKQUOTE_COLOR +.ALIAS CITATION_QUAD BLOCKQUOTE_QUAD .ALIAS CITE BLOCKQUOTE +.ALIAS CITE_COLOUR CITE_COLOR +.ALIAS CITE_FAMILY BLOCKQUOTE_FAMILY +.ALIAS CITE_FONT BLOCKQUOTE_FONT +.ALIAS CITE_SIZE BLOCKQUOTE_SIZE +.ALIAS CITE_COLOR BLOCKQUOTE_COLOR +.ALIAS CITE_QUAD BLOCKQUOTE_QUAD .ALIAS DOC_R_MARGIN DOC_RIGHT_MARGIN .ALIAS DOC_L_MARGIN DOC_LEFT_MARGIN .ALIAS DOC_L_LENGTH DOC_LINE_LENGTH @@ -11239,105 +11980,138 @@ y\\R'#DESCENDER \\n[.cdp]' .ALIAS DOC_LMARGIN DOC_LEFT_MARGIN .ALIAS DOC_LLENGTH DOC_LINE_LENGTH .ALIAS DOC_FAM DOC_FAMILY -.ALIAS FILL QUAD -.ALIAS PP_FT PP_FONT -.ALIAS DOC_PS DOC_PT_SIZE .ALIAS DOC_LS DOC_LEAD +.ALIAS DOC_PS DOC_PT_SIZE +.ALIAS DOCHEADER_COLOUR DOCHEADER_COLOUR +.ALIAS EPIGRAPH_COLOUR EPIGRAPH_COLOR +.ALIAS FILL QUAD +.ALIAS FINIS_COLOUR FINIS_COLOR +.ALIAS HEAD_COLOUR HEAD_COLOR +.ALIAS LINEBREAK_COLOUR LINEBREAK_COLOR .ALIAS PAGENUM PAGENUMBER +.ALIAS PAGENUM_COLOUR PAGENUM_COLOR .ALIAS PAGINATION PAGINATE +.ALIAS PARAHEAD_COLOUR PARAHEAD_COLOR +.ALIAS PP_FT PP_FONT +.ALIAS QUOTE_COLOUR QUOTE_COLOR +.ALIAS SUBHEAD_COLOUR SUBHEAD_COLOR .ALIAS TOC_FAM TOC_FAM .ALIAS TOC_PS TOC_PT_SIZE \# \# HEADER and FOOTER aliases for HDRFTR macros. \# -.ALIAS ENDNOTES_HEADER_CENTER ENDNOTES_HDRFTR_CENTER -.ALIAS HEADER_FAMILY HDRFTR_FAMILY -.ALIAS HEADER_FAM HDRFTR_FAMILY -.ALIAS HEADER_SIZE HDRFTR_SIZE -.ALIAS HEADER_PLAIN HDRFTR_PLAIN -.ALIAS HEADER_RULE_GAP HDRFTR_RULE_GAP -.ALIAS HEADER_RULE HDRFTR_RULE -.ALIAS HEADER_LEFT HDRFTR_LEFT -.ALIAS HEADER_LEFT_FAMILY HDRFTR_LEFT_FAMILY -.ALIAS HEADER_LEFT_FAM HDRFTR_LEFT_FAMILY -.ALIAS HEADER_LEFT_FONT HDRFTR_LEFT_FONT -.ALIAS HEADER_LEFT_FT HDRFTR_LEFT_FONT -.ALIAS HEADER_LEFT_SIZE HDRFTR_LEFT_SIZE -.ALIAS HEADER_LEFT_PS HDRFTR_LEFT_SIZE -.ALIAS HEADER_LEFT_CAPS HDRFTR_LEFT_CAPS -.ALIAS HEADER_CENTER HDRFTR_CENTER -.ALIAS HEADER_CENTRE HDRFTR_CENTER -.ALIAS HEADER_CENTER_FAMILY HDRFTR_CENTER_FAMILY -.ALIAS HEADER_CENTRE_FAMILY HDRFTR_CENTER_FAMILY -.ALIAS HEADER_CENTER_FAM HDRFTR_CENTER_FAMILY -.ALIAS HEADER_CENTRE_FAM HDRFTR_CENTER_FAMILY -.ALIAS HEADER_CENTER_FONT HDRFTR_CENTER_FONT -.ALIAS HEADER_CENTRE_FONT HDRFTR_CENTER_FONT -.ALIAS HEADER_CENTER_FT HDRFTR_CENTER_FONT -.ALIAS HEADER_CENTRE_FT HDRFTR_CENTER_FONT -.ALIAS HEADER_CENTER_SIZE HDRFTR_CENTER_SIZE -.ALIAS HEADER_CENTRE_SIZE HDRFTR_CENTER_SIZE -.ALIAS HEADER_CENTER_PS HDRFTR_CENTER_SIZE -.ALIAS HEADER_CENTRE_PS HDRFTR_CENTER_SIZE -.ALIAS HEADER_CENTER_PAD HDRFTR_CENTER_PAD -.ALIAS HEADER_CENTRE_PAD HDRFTR_CENTER_PAD -.ALIAS HEADER_CENTER_CAPS HDRFTR_CENTER_CAPS -.ALIAS HEADER_CENTRE_CAPS HDRFTR_CENTER_CAPS -.ALIAS HEADER_RIGHT HDRFTR_RIGHT -.ALIAS HEADER_RIGHT_FAMILY HDRFTR_RIGHT_FAMILY -.ALIAS HEADER_RIGHT_FAM HDRFTR_RIGHT_FAMILY -.ALIAS HEADER_RIGHT_FONT HDRFTR_RIGHT_FONT -.ALIAS HEADER_RIGHT_FT HDRFTR_RIGHT_FONT -.ALIAS HEADER_RIGHT_SIZE HDRFTR_RIGHT_SIZE -.ALIAS HEADER_RIGHT_PS HDRFTR_RIGHT_SIZE -.ALIAS HEADER_RIGHT_CAPS HDRFTR_RIGHT_CAPS -.ALIAS HEADER_RECTO HDRFTR_RECTO -.ALIAS HEADER_VERSO HDRFTR_VERSO .ALIAS ENDNOTES_FOOTER_CENTER ENDNOTES_HDRFTR_CENTER -.ALIAS FOOTER_FAMILY HDRFTR_FAMILY -.ALIAS FOOTER_FAM HDRFTR_FAMILY -.ALIAS FOOTER_SIZE HDRFTR_SIZE -.ALIAS FOOTER_PLAIN HDRFTR_PLAIN -.ALIAS FOOTER_RULE_GAP HDRFTR_RULE_GAP -.ALIAS FOOTER_RULE HDRFTR_RULE -.ALIAS FOOTER_LEFT HDRFTR_LEFT -.ALIAS FOOTER_LEFT_FAMILY HDRFTR_LEFT_FAMILY -.ALIAS FOOTER_LEFT_FAM HDRFTR_LEFT_FAMILY -.ALIAS FOOTER_LEFT_FONT HDRFTR_LEFT_FONT -.ALIAS FOOTER_LEFT_FT HDRFTR_LEFT_FONT -.ALIAS FOOTER_LEFT_SIZE HDRFTR_LEFT_SIZE -.ALIAS FOOTER_LEFT_PS HDRFTR_LEFT_SIZE -.ALIAS FOOTER_LEFT_CAPS HDRFTR_LEFT_CAPS -.ALIAS FOOTER_CENTER HDRFTR_CENTER -.ALIAS FOOTER_CENTRE HDRFTR_CENTER -.ALIAS FOOTER_CENTER_FAMILY HDRFTR_CENTER_FAMILY -.ALIAS FOOTER_CENTRE_FAMILY HDRFTR_CENTER_FAMILY +.ALIAS ENDNOTES_HEADER_CENTER ENDNOTES_HDRFTR_CENTER +.ALIAS ENDNOTES_FOOTER_CENTRE ENDNOTES_HDRFTR_CENTRE +.ALIAS ENDNOTES_HEADER_CENTRE ENDNOTES_HDRFTR_CENTRE +.ALIAS FOOTER_CENTER_CAPS HDRFTR_CENTER_CAPS +.ALIAS FOOTER_CENTER_COLOR HDRFTR_CENTER_COLOR +.ALIAS FOOTER_CENTER_COLOUR HDRFTR_CENTER_COLOUR .ALIAS FOOTER_CENTER_FAM HDRFTR_CENTER_FAMILY -.ALIAS FOOTER_CENTRE_FAM HDRFTR_CENTER_FAMILY +.ALIAS FOOTER_CENTER_FAMILY HDRFTR_CENTER_FAMILY .ALIAS FOOTER_CENTER_FONT HDRFTR_CENTER_FONT -.ALIAS FOOTER_CENTRE_FONT HDRFTR_CENTER_FONT .ALIAS FOOTER_CENTER_FT HDRFTR_CENTER_FONT -.ALIAS FOOTER_CENTRE_FT HDRFTR_CENTER_FONT -.ALIAS FOOTER_CENTER_SIZE HDRFTR_CENTER_SIZE -.ALIAS FOOTER_CENTRE_SIZE HDRFTR_CENTER_SIZE +.ALIAS FOOTER_CENTER HDRFTR_CENTER .ALIAS FOOTER_CENTER_PAD HDRFTR_CENTER_PAD -.ALIAS FOOTER_CENTRE_PAD HDRFTR_CENTER_PAD .ALIAS FOOTER_CENTER_PS HDRFTR_CENTER_SIZE -.ALIAS FOOTER_CENTRE_PS HDRFTR_CENTER_SIZE -.ALIAS FOOTER_CENTER_CAPS HDRFTR_CENTER_CAPS +.ALIAS FOOTER_CENTER_SIZE HDRFTR_CENTER_SIZE .ALIAS FOOTER_CENTRE_CAPS HDRFTR_CENTER_CAPS -.ALIAS FOOTER_RIGHT HDRFTR_RIGHT -.ALIAS FOOTER_RIGHT_FAMILY HDRFTR_RIGHT_FAMILY +.ALIAS FOOTER_CENTRE_COLOR HDRFTR_CENTRE_COLOR +.ALIAS FOOTER_CENTRE_COLOUR HDRFTR_CENTRE_COLOUR +.ALIAS FOOTER_CENTRE_FAM HDRFTR_CENTER_FAMILY +.ALIAS FOOTER_CENTRE_FAMILY HDRFTR_CENTER_FAMILY +.ALIAS FOOTER_CENTRE_FONT HDRFTR_CENTER_FONT +.ALIAS FOOTER_CENTRE_FT HDRFTR_CENTER_FONT +.ALIAS FOOTER_CENTRE HDRFTR_CENTER +.ALIAS FOOTER_CENTRE_PAD HDRFTR_CENTER_PAD +.ALIAS FOOTER_CENTRE_PS HDRFTR_CENTER_SIZE +.ALIAS FOOTER_CENTRE_SIZE HDRFTR_CENTER_SIZE +.ALIAS FOOTER_COLOR HDRFTR_COLOR +.ALIAS FOOTER_COLOUR HDRFTR_COLOR +.ALIAS FOOTER_FAM HDRFTR_FAMILY +.ALIAS FOOTER_FAMILY HDRFTR_FAMILY +.ALIAS FOOTER_LEFT_CAPS HDRFTR_LEFT_CAPS +.ALIAS FOOTER_LEFT_COLOR HDRFTR_LEFT_COLOR +.ALIAS FOOTER_LEFT_COLOUR HDRFTR_LEFT_COLOUR +.ALIAS FOOTER_LEFT_FAM HDRFTR_LEFT_FAMILY +.ALIAS FOOTER_LEFT_FAMILY HDRFTR_LEFT_FAMILY +.ALIAS FOOTER_LEFT_FONT HDRFTR_LEFT_FONT +.ALIAS FOOTER_LEFT_FT HDRFTR_LEFT_FONT +.ALIAS FOOTER_LEFT HDRFTR_LEFT +.ALIAS FOOTER_LEFT_PS HDRFTR_LEFT_SIZE +.ALIAS FOOTER_LEFT_SIZE HDRFTR_LEFT_SIZE +.ALIAS FOOTER_PLAIN HDRFTR_PLAIN +.ALIAS FOOTER_RECTO HDRFTR_RECTO +.ALIAS FOOTER_RIGHT_CAPS HDRFTR_RIGHT_CAPS +.ALIAS FOOTER_RIGHT_COLOR HDRFTR_RIGHT_COLOR +.ALIAS FOOTER_RIGHT_COLOUR HDRFTR_RIGHT_COLOUR .ALIAS FOOTER_RIGHT_FAM HDRFTR_RIGHT_FAMILY +.ALIAS FOOTER_RIGHT_FAMILY HDRFTR_RIGHT_FAMILY .ALIAS FOOTER_RIGHT_FONT HDRFTR_RIGHT_FONT .ALIAS FOOTER_RIGHT_FT HDRFTR_RIGHT_FONT -.ALIAS FOOTER_RIGHT_SIZE HDRFTR_RIGHT_SIZE +.ALIAS FOOTER_RIGHT HDRFTR_RIGHT .ALIAS FOOTER_RIGHT_PS HDRFTR_RIGHT_SIZE -.ALIAS FOOTER_RIGHT_CAPS HDRFTR_RIGHT_CAPS -.ALIAS FOOTER_RECTO HDRFTR_RECTO +.ALIAS FOOTER_RIGHT_SIZE HDRFTR_RIGHT_SIZE +.ALIAS FOOTER_RULE_COLOR HDRFTR_RULE_COLOR +.ALIAS FOOTER_RULE_GAP HDRFTR_RULE_GAP +.ALIAS FOOTER_RULE HDRFTR_RULE +.ALIAS FOOTER_SIZE HDRFTR_SIZE .ALIAS FOOTER_VERSO HDRFTR_VERSO -.ALIAS SWITCH_HEADERS SWITCH_HDRFTR +.ALIAS HEADER_CENTER_CAPS HDRFTR_CENTER_CAPS +.ALIAS HEADER_CENTER_COLOR HDRFTR_CENTER_COLOR +.ALIAS HEADER_CENTER_COLOUR HDRFTR_CENTER_COLOUR +.ALIAS HEADER_CENTER_FAM HDRFTR_CENTER_FAMILY +.ALIAS HEADER_CENTER_FAMILY HDRFTR_CENTER_FAMILY +.ALIAS HEADER_CENTER_FONT HDRFTR_CENTER_FONT +.ALIAS HEADER_CENTER_FT HDRFTR_CENTER_FONT +.ALIAS HEADER_CENTER HDRFTR_CENTER +.ALIAS HEADER_CENTER_PAD HDRFTR_CENTER_PAD +.ALIAS HEADER_CENTER_PS HDRFTR_CENTER_SIZE +.ALIAS HEADER_CENTER_SIZE HDRFTR_CENTER_SIZE +.ALIAS HEADER_CENTRE_CAPS HDRFTR_CENTER_CAPS +.ALIAS HEADER_CENTRE_COLOR HDRFTR_CENTRE_COLOR +.ALIAS HEADER_CENTRE_COLOUR HDRFTR_CENTRE_COLOUR +.ALIAS HEADER_CENTRE_FAM HDRFTR_CENTER_FAMILY +.ALIAS HEADER_CENTRE_FAMILY HDRFTR_CENTER_FAMILY +.ALIAS HEADER_CENTRE_FONT HDRFTR_CENTER_FONT +.ALIAS HEADER_CENTRE_FT HDRFTR_CENTER_FONT +.ALIAS HEADER_CENTRE HDRFTR_CENTER +.ALIAS HEADER_CENTRE_PAD HDRFTR_CENTER_PAD +.ALIAS HEADER_CENTRE_PS HDRFTR_CENTER_SIZE +.ALIAS HEADER_CENTRE_SIZE HDRFTR_CENTER_SIZE +.ALIAS HEADER_COLOR HDRFTR_COLOR +.ALIAS HEADER_COLOUR HDRFTR_COLOR +.ALIAS HEADER_FAM HDRFTR_FAMILY +.ALIAS HEADER_FAMILY HDRFTR_FAMILY +.ALIAS HEADER_LEFT_CAPS HDRFTR_LEFT_CAPS +.ALIAS HEADER_LEFT_COLOR HDRFTR_LEFT_COLOR +.ALIAS HEADER_LEFT_COLOUR HDRFTR_LEFT_COLOUR +.ALIAS HEADER_LEFT_FAM HDRFTR_LEFT_FAMILY +.ALIAS HEADER_LEFT_FAMILY HDRFTR_LEFT_FAMILY +.ALIAS HEADER_LEFT_FONT HDRFTR_LEFT_FONT +.ALIAS HEADER_LEFT_FT HDRFTR_LEFT_FONT +.ALIAS HEADER_LEFT HDRFTR_LEFT +.ALIAS HEADER_LEFT_PS HDRFTR_LEFT_SIZE +.ALIAS HEADER_LEFT_SIZE HDRFTR_LEFT_SIZE +.ALIAS HEADER_PLAIN HDRFTR_PLAIN +.ALIAS HEADER_RECTO HDRFTR_RECTO +.ALIAS HEADER_RIGHT_CAPS HDRFTR_RIGHT_CAPS +.ALIAS HEADER_RIGHT_COLOR HDRFTR_RIGHT_COLOR +.ALIAS HEADER_RIGHT_COLOUR HDRFTR_RIGHT_COLOUR +.ALIAS HEADER_RIGHT_FAM HDRFTR_RIGHT_FAMILY +.ALIAS HEADER_RIGHT_FAMILY HDRFTR_RIGHT_FAMILY +.ALIAS HEADER_RIGHT_FONT HDRFTR_RIGHT_FONT +.ALIAS HEADER_RIGHT_FT HDRFTR_RIGHT_FONT +.ALIAS HEADER_RIGHT HDRFTR_RIGHT +.ALIAS HEADER_RIGHT_PS HDRFTR_RIGHT_SIZE +.ALIAS HEADER_RIGHT_SIZE HDRFTR_RIGHT_SIZE +.ALIAS HEADER_RULE_COLOR HDRFTR_RULE_COLOR +.ALIAS HEADER_RULE_GAP HDRFTR_RULE_GAP +.ALIAS HEADER_RULE HDRFTR_RULE +.ALIAS HEADER_SIZE HDRFTR_SIZE +.ALIAS HEADER_VERSO HDRFTR_VERSO .ALIAS SWITCH_FOOTERS SWITCH_HDRFTR +.ALIAS SWITCH_HEADERS SWITCH_HDRFTR \# \# Support aliases \# |