aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--example.t94
1 files changed, 69 insertions, 25 deletions
diff --git a/example.t b/example.t
index 8546f4a..63db743 100644
--- a/example.t
+++ b/example.t
@@ -1,5 +1,18 @@
.so g.tmac
.
+. \" configure environments
+._e p
+. nr sq \n(sp
+. nr sp 0
+._e l
+. fam M
+. vs +1p
+._e e
+. _ec p
+. ta 3n +3n +3n +3n
+._e
+.
+. \" define macros
.eo
.de e
. if !'\$1'' \{\
@@ -17,22 +30,12 @@
..
.ec
.
-._e p
-._e l
-. fam M
-. vs +1p
-._e e
-. _ec p
-. nr sq \n(sp
-. nr sp 0
-. ta 3n +3n +3n +3n
-._e
.
+. \" start document
.t
.x Mg ,
a simple macro package for troff
-.n
-John Ankarstr\[u00F6]m
+.d "John Ankarstr\[u00F6]m"
.d
.
.
@@ -80,6 +83,7 @@ are explained.
The reader is encouraged to inspect the document's source code
in order to see how the macro package is used in practice.
.
+.
.h
Environments
.p
@@ -87,27 +91,30 @@ Environments
makes heavy use of named environments,
supported by implementations such as GNU troff and Neatroff.
Environments obliviate the need for many special registers
-that a macro package (and its user) would need to keep track of.
+that a macro package (and its user) would otherwise need to keep track of.
For example,
.i ms
keeps track of the document's font size in the
.c PS
register.
-.i Mg ,
-on the other hand,
-simply sets the font size inside the environment named
-.c p
-(for paragraph).
+For the font size of headings,
+it has yet another register.
+.i Mg
+has no such registers.
If the user wishes to modify the default font size,
-he or she can simply switch to the
-.c p
-environment and set the font size as desired:
+he or she can simply switch to the relevant environment
+and set the font size as desired
+using regular troff requests:
.l
\&.\\" set heading font
\&.h
\&.fam H
\&.ps +1p
.p
+Troff saves the font settings in the environment,
+so that the next time the environment is invoked,
+the desired font family and point size are automatically restored.
+.p
The environments are initialized
as soon as the first
.q block-level
@@ -165,9 +172,9 @@ the margin at the top of the page
.c mb ,
the margin at the bottom of the page
.
+.
.h
External macros
-.
.p
.i Mg
defines a number of macros.
@@ -228,9 +235,6 @@ heading
.c l ,
literal display (for source code)
.e
-.c n ,
-centered name of author
-.e
.c p ,
paragraph
.e
@@ -296,6 +300,7 @@ In such cases, the reference will simply appear on the page
following the footnote.
When this happens, the user must account for it manually.
.
+.
.h
Internal macros
.p
@@ -310,3 +315,42 @@ and
which are a group of macros controlling the environment,
as it may be desirable to define custom environments
for advanced documents.
+.
+.
+.h
+Frequently anticipated questions
+.
+.s
+How do I set the default font family, point size, indentation etc.
+of a document?
+.p
+All environment settings\c
+.(
+For a complete list of settings that are associated with the environment,
+see 5.26\ Environments in the full GNU troff manual
+.nh
+.c "info '(groff.\:info)Environments'" ). (
+.hy
+.)
+such as these
+are configured with the standard troff requests.
+If you set the point size at the beginning of the document,
+before any
+.i mg
+macros have been called,
+it will be correctly set for the entire document.
+This works because
+.i mg 's
+environments initially copy all their settings from 0,
+the default environment.
+.p
+For example, if you wanted to write a document
+with the New Century Schoolbook font
+at 9 points
+and a vertical spacing of 12 points,
+you would start the document like this:
+.l
+\&.so g.tmac \\" include mg
+\&.fam N
+\&.ps 9p
+\&.vs 12p