From 34dbc6d3ba665918ff7f7c0c2f85e05013fbb7b5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?John=20Ankarstr=C3=B6m?= <john@ankarstrom.se>
Date: Sun, 20 Jun 2021 16:38:02 +0200
Subject: example.t: Expand FAQ

---
 example.pdf | Bin 80058 -> 81600 bytes
 example.t   |  57 ++++++++++++++++++++++++++++++++++++++++++++++++++-------
 2 files changed, 50 insertions(+), 7 deletions(-)

diff --git a/example.pdf b/example.pdf
index 65874ea..7f8683f 100644
Binary files a/example.pdf and b/example.pdf differ
diff --git a/example.t b/example.t
index 09607b6..650808d 100644
--- a/example.t
+++ b/example.t
@@ -35,7 +35,7 @@
 .t
 .x Mg ,
 a simple macro package for troff
-.d "John Ankarstr\[u00F6]m"
+.d John\ Ankarstr\(:om
 .d
 .
 .
@@ -362,18 +362,17 @@ for advanced documents.
 Frequently anticipated questions
 .
 .s
-How do I set the default font family, point size, indentation
-of a document?
+How do I customize the default appearance of a document?
 .p
-All environment settings\c
+All environment settings,
+like point size, font family and indentation\c
 .(
 For a complete list of settings that are associated with the environment,
-see 5.26\ Environments in the full GNU troff manual
+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
@@ -397,6 +396,36 @@ you would start the document like this:
 \&.vs 12p
 .
 .s
+How do I customize the default appearance of a given environment?
+.p
+To configure the layout and font settings of a specific environment,
+you can switch to that environment and use the relevant troff requests:
+.l
+\&.q
+\&.ps +1p
+.p
+If you are merely configuring the environment
+without printing anything in it,
+you can also use the
+.c _e
+macro:
+.l
+\&._e q
+\&.ps +1p
+.
+.s
+How do I customize the default appearance of the margin text?
+.l
+\&._E _m \\" margin environment
+\&.ps +1p
+.
+.s
+How do I customize the default appearance of footnotes?
+.l
+\&._E _f \\" footnote environment
+\&.ps +1p
+.
+.s
 How do I prevent a section from being broken up by a page break?
 .p
 Some macro packages have a concept of
@@ -452,8 +481,22 @@ copy environment (same as
 .p
 The
 .c _e
+macro
 can be used to activate any environment that supports
 .i mg 's
 extensions (see
 .i Environments
 above).
+The following code configures an environment called
+.c n
+and defines a corresponding macro:
+.l
+\&._e n
+\&. _ec 0 \\" copy default environment
+\&. ps -1p
+\&._e
+\&.
+\&.de n
+\&. br \\" finish current environment
+\&. _e n \\" activate new environment
+\&..
-- 
cgit v1.2.3