Hi Ingo,
Thanks for the quick feedback. Sorry for the wrong assumption.
Regarding the styling documentation, I believe it should stay in,
but maybe also add a small note describing it's hardcoded? That
might however make the over-documentation situation even worse.
Greetings,
Sascha
On 18.09.2018 08:13, Ingo Schwarze wrote:
Hi Sascha,
Sascha Paunovic wrote on Tue, Sep 18, 2018 at 06:39:51AM +0200:
while reading mandoc(1), I noticed that under the PostScript output
section, it said the line-height was 1.4m, while it is 1.4em. I doubt
the line-height is approximately as tall as a 5th grader, so let's
clarify this:
No, "1.4m" is a roff scaling width, see the roff(7) manual:
https://man.openbsd.org/roff.7#Scaling_Widths
So the patch is not OK.
I wonder whether this is over-documented, though. Font family, point
size, line height, and margins are hard-coded and cannot be changed by
the user, so i wonder why they are even mentioned. Well, maybe it
occasionally helps to understand why the output looks as it does -
though people who care about such details should probably use a real
typesetter like groff to generate PostScript and not rely on the
mandoc -Tps output...
Yours,
Ingo
diff --git usr.bin/mandoc/mandoc.1 usr.bin/mandoc/mandoc.1
index aa19c49d6..e180145ee 100644
--- usr.bin/mandoc/mandoc.1
+++ usr.bin/mandoc/mandoc.1
@@ -459,7 +459,7 @@ Level-2 pages may be generated by
Output pages default to letter sized and are rendered in the Times
font
family, 11-point.
Margins are calculated as 1/9 the page length and width.
-Line-height is 1.4m.
+Line-height is 1.4em.
.Pp
Special characters are rendered as in
.Sx ASCII Output .