gbranden pushed a commit to branch master
in repository groff.
commit 70b75da11a415c82bc6382afecb67c71864f5391
Author: G. Branden Robinson <[email protected]>
AuthorDate: Tue Jul 30 21:35:10 2024 -0500
[docs]: Discuss header/footer measurement matters.
Thanks to Dave Kemper for the suggestion.
---
doc/groff.texi.in | 13 +++++++++++++
1 file changed, 13 insertions(+)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index b82c19866..2882d0db0 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -14822,6 +14822,19 @@ the @code{tl} request.
.wh -1i fo \" trap 1 inch from bottom
@endExample
+@strong{Caution:@:} A word about measurements is in order. Recall that
+the @code{sp} request vertically spaces such that the next text baseline
+(of one vee in height by definition) sets with the amount of space given
+to @code{sp}'s argument @emph{above} it. Thus in the example above,
+when the @samp{hd} trap springs at vertical position @samp{0},
+invoking @samp{sp .5i}, we get the desired half-inch of top margin.
+With the @samp{ft} trap, we space after the body text by one half-inch
+@emph{minus one vee} to leave a half-inch bottom margin. The footer
+title, if anything taller than a baseline rule, thus ``encroaches'' into
+the half-inch margin between the body text and the bottom margin, just
+as the header title symmetrically intruded into the half-inch of space
+between its own cap-height and that of the top of the body text.
+
To use these traps, copy the above (or load it from a file with the
@code{so} or @code{mso} requests), then set up the strings it uses.
_______________________________________________
Groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
