gbranden pushed a commit to branch master
in repository groff.
commit f79425056fafcf9db06bc4db6d6278dff315c4fd
Author: G. Branden Robinson <[email protected]>
Date: Sun Nov 4 06:32:02 2018 -0500
Clarify meaning of .H and .V registers.
* doc/groff.texi: Clarify meaning of .[HV] registers. Thanks to
Dave Kemper for the patch. Place the new language in the
Measurements section, and slightly expand descriptions of .H
and .V registers.
* man/groff.7.man: Synchronize descriptions of .H and .V with
foregoing.
Fixes <https://savannah.gnu.org/bugs/index.php?54884>.
Signed-off-by: G. Branden Robinson <[email protected]>
---
doc/groff.texi | 12 ++++++++++--
man/groff.7.man | 4 ++--
2 files changed, 12 insertions(+), 4 deletions(-)
diff --git a/doc/groff.texi b/doc/groff.texi
index 9677e34..0b7b2f7 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -5052,6 +5052,12 @@ fractional basic units are always rounded to integers.
Some of the measurement units are completely independent of any of the
current settings (e.g.@: type size) of @code{gtroff}.
+Although groff's basic unit is device-dependent, it may still be smaller
+than the smallest unit the device is capable of producing. The register
+@code{.H} specifies how many groff basic units constitute the current
+device's basic unit horizontally, and the register @code{.V} specifies
+this value vertically.
+
@table @code
@item i
@cindex inch unit (@code{i})
@@ -6479,7 +6485,8 @@ This string-valued register returns the current input
file name.
@cindex horizontal resolution register (@code{.H})
@cindex resolution, horizontal, register (@code{.H})
@vindex .H
-Horizontal resolution in basic units.
+Number of basic units per horizontal unit of output device resolution.
+@xref{Measurements}.
@item \n[.R]
@cindex number of registers register (@code{.R})
@@ -6502,7 +6509,8 @@ and to zero otherwise. @xref{Groff Options}.
@cindex vertical resolution register (@code{.V})
@cindex resolution, vertical, register (@code{.V})
@vindex .V
-Vertical resolution in basic units.
+Number of basic units per vertical unit of output device resolution.
+@xref{Measurements}.
@item \n[seconds]
@cindex seconds, current time (@code{seconds})
diff --git a/man/groff.7.man b/man/groff.7.man
index 6fd5969..f362d28 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -3860,7 +3860,7 @@ Text base-line high-water mark on current page or
diversion.
.
.TPx
.REG .H
-Available horizontal resolution in basic units.
+Number of basic units per horizontal unit of output device resolution.
.
.TPx
.REG .height
@@ -4117,7 +4117,7 @@ Current vertical line spacing.
.
.TPx
.REG .V
-Available vertical resolution in basic units.
+Number of basic units per vertical unit of output device resolution.
.
.TPx
.REG .vpt
_______________________________________________
Groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
