Re: mandoc: typo fix (?) in mandoc.1
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 .
Re: mandoc: typo fix (?) in mandoc.1
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 .
mandoc: typo fix (?) in mandoc.1
Hi, 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: 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 . -- Sascha Paunovic