[PATCH 1/2] time.7: tfix

[PATCH 1/2] time.7: tfix

[наб]

[-- Attachment #1: Type: text/plain, Size: 761 bytes --]

"HZ" is the constant, and has nothing to do with the 50Hz PAL/60Hz NTSC
field/mains frequencies

Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
---
 man7/time.7 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man7/time.7 b/man7/time.7
index 830da7ea8..95573796c 100644
--- a/man7/time.7
+++ b/man7/time.7
@@ -92,7 +92,7 @@ configuration parameter and can be 100, 250 (the default) or 1000,
 yielding a jiffies value of, respectively, 0.01, 0.004, or 0.001 seconds.
 Since kernel 2.6.20, a further frequency is available:
 300, a number that divides evenly for the common video
-frame rates (PAL, 25 HZ; NTSC, 30 HZ).
+frame rates (PAL, 25Hz; NTSC, 30Hz).
 .PP
 The
 .BR times (2)
-- 
2.30.2


[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

[PATCH 2/2] time.7: tfix

[наб]

[-- Attachment #1: Type: text/plain, Size: 634 bytes --]

Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
---
 man7/time.7 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man7/time.7 b/man7/time.7
index 95573796c..72395ee5b 100644
--- a/man7/time.7
+++ b/man7/time.7
@@ -132,7 +132,7 @@ or looking at the "resolution" entries in
 .IR /proc/timer_list .
 .PP
 HRTs are not supported on all hardware architectures.
-(Support is provided on x86, arm, and powerpc, among others.)
+(Support is provided on x86, ARM, and PowerPC, among others.)
 .SS The Epoch
 UNIX systems represent time in seconds since the
 .IR Epoch ,
-- 
2.30.2

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: [PATCH 1/2] time.7: tfix

[Alejandro Colomar (man-pages)]

Hi наб,


On 1/29/22 20:10, наб wrote:
> "HZ" is the constant, and has nothing to do with the 50Hz PAL/60Hz NTSC
> field/mains frequencies
> 
> Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
> ---
>  man7/time.7 | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
> 
> diff --git a/man7/time.7 b/man7/time.7
> index 830da7ea8..95573796c 100644
> --- a/man7/time.7
> +++ b/man7/time.7
> @@ -92,7 +92,7 @@ configuration parameter and can be 100, 250 (the default) or 1000,
>  yielding a jiffies value of, respectively, 0.01, 0.004, or 0.001 seconds.
>  Since kernel 2.6.20, a further frequency is available:
>  300, a number that divides evenly for the common video
> -frame rates (PAL, 25 HZ; NTSC, 30 HZ).
> +frame rates (PAL, 25Hz; NTSC, 30Hz).

The change to lowercase is correct, but I'm not convinced by the removal
of the space.  The SI says that there should be a space, and while there
are some cases where readability is considerably improved by removing
the space, I think this is not one of those.

See the SI draft (2006):

5.3.3 Formatting the value of a quantity
       The numerical value always precedes the unit, and a space
       is  always  used  to  separate  the unit from the number.
       Thus the value of the quantity is the product of the num‐
       ber and the unit, the space being regarded as a multipli‐
       cation sign (just as a space between units implies multi‐
       plication).  The only exceptions to this rule are for the
       unit symbols for degree, minute, and second for plane an‐
       gle, °, ′, and ′′, respectively, for which  no  space  is
       left between the numerical value and the unit symbol.

       This rule means that the symbol °C for the degree Celsius
       is  preceded by a space when one expresses values of Cel‐
       sius temperature t.

       Even when the value of a quantity is used  as  an  adjec‐
       tive, a space is left between the numerical value and the
       unit  symbol.   Only when the name of the unit is spelled
       out would the ordinary rules of grammar apply, so that in
       English a hyphen would be used  to  separate  the  number
       from the unit.

       In  any one expression, only one unit is used.  An excep‐
       tion to this rule is in expressing the values of time and
       of plane angles using non-SI units.  However,  for  plane
       angles  it  is  generally preferable to divide the degree
       decimally.  Thus one would write 22.20° rather  than  22°
       12′,  except  in  fields such as navigation, cartography,
       astronomy, and in the measurement of very small angles.

<https://www.bipm.org/documents/20126/41483022/si_brochure_8.pdf>

Cheers,

Alex

>  .PP
>  The
>  .BR times (2)

-- 
Alejandro Colomar
Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/
http://www.alejandro-colomar.es/

Re: [PATCH 1/2] time.7: tfix

[Alejandro Colomar (man-pages)]

On 1/29/22 23:40, Alejandro Colomar (man-pages) wrote:
> See the SI draft (2006):

s/draft/brochure/

-- 
Alejandro Colomar
Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/
http://www.alejandro-colomar.es/

Re: [PATCH 1/2] time.7: tfix

[Alejandro Colomar (man-pages)]

On 1/29/22 23:40, Alejandro Colomar (man-pages) wrote:
> The change to lowercase is correct, but I'm not convinced by the removal
> of the space.  The SI says that there should be a space, and while there
> are some cases where readability is considerably improved by removing
> the space, I think this is not one of those.
> 

I just found there's a newer SI version than the one I quoted.  It
doesn't change very much for what we want, but I'll quote the current
one here for the sake of completeness/correctness:

5.3 Unit names
       Unit  names are normally printed in upright type and they
       are treated like ordinary nouns.  In English,  the  names
       of  units  start  with a lower-case letter (even when the
       symbol for the unit begins with a capital letter), except
       at the beginning of a sentence or in capitali zed  mater‐
       ial such as a title.  In keeping with this rule, the cor‐
       rect  spelling of the name of the unit with the symbol °C
       is “degree Celsius” (the unit degree begins with a lower-
       case d and the modifier Celsius begins with an upper-case
       C because it is a proper name).

       Although the values of quantities are normally  expressed
       using  symbols  for numbers and symbols for units, if for
       some reason the unit name is more  appropriate  than  the
       unit symbol, the unit name should be spelled out in full.

       When  the  name  of a unit is combined with the name of a
       multiple or sub-multiple prefix, no space  or  hyphen  is
       used between the prefix name and the unit name.  The com‐
       bination  of  prefix  name and unit name is a single word
       (see chapter 3).

       When the name of a derived unit is formed from the  names
       of individual units by juxtaposition, either a space or a
       hyphen  is  used  to separate the names of the individual
       units.

<https://www.bipm.org/documents/20126/41483022/SI-Brochure-9.pdf>

I'll add this link to the SEE ALSO section of units(7).

Cheers,

Alex

-- 
Alejandro Colomar
Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/
http://www.alejandro-colomar.es/

[PATCH v2 1/2] time.7: tfix

[наб]

[-- Attachment #1: Type: text/plain, Size: 1486 bytes --]

"HZ" is the constant, and has nothing to do with the
50 Hz PAL/60 Hz NTSC mains frequencies

Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
---
Without doubt the frenchest thing I've read this year, and, IMO,
a really untoward moral high horse from a document that double-spaces
compound punctuation and calls the English Index "Index English";

(Also, hilariously, Annexe 2. Réalisation pratique des définitions des
 principales unités est publiée uniquement sous forme électronique sur
 le site Web du BIPM, but it's 404ing just 16 short years after
 publication, which is very cool considering it's an /internal link/.)

Nevertheless, I find it difficult to disagree in this case,
spaces before the Hz do work better in this parenthetical
(but I want to note that this is becasuse you pointed it out,
 not because the French talked sense into me).

 man7/time.7 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man7/time.7 b/man7/time.7
index 830da7ea8..69d72af04 100644
--- a/man7/time.7
+++ b/man7/time.7
@@ -92,7 +92,7 @@ configuration parameter and can be 100, 250 (the default) or 1000,
 yielding a jiffies value of, respectively, 0.01, 0.004, or 0.001 seconds.
 Since kernel 2.6.20, a further frequency is available:
 300, a number that divides evenly for the common video
-frame rates (PAL, 25 HZ; NTSC, 30 HZ).
+frame rates (PAL, 25 Hz; NTSC, 30 Hz).
 .PP
 The
 .BR times (2)
-- 
2.30.2


[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

[PATCH v2 2/2] time.7: tfix

[наб]

[-- Attachment #1: Type: text/plain, Size: 634 bytes --]

Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
---
 man7/time.7 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man7/time.7 b/man7/time.7
index 69d72af04..713b8959c 100644
--- a/man7/time.7
+++ b/man7/time.7
@@ -132,7 +132,7 @@ or looking at the "resolution" entries in
 .IR /proc/timer_list .
 .PP
 HRTs are not supported on all hardware architectures.
-(Support is provided on x86, arm, and powerpc, among others.)
+(Support is provided on x86, ARM, and PowerPC, among others.)
 .SS The Epoch
 UNIX systems represent time in seconds since the
 .IR Epoch ,
-- 
2.30.2

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: [PATCH v2 1/2] time.7: tfix

[Alejandro Colomar (man-pages)]

On 1/29/22 23:59, наб wrote:
> "HZ" is the constant, and has nothing to do with the
> 50 Hz PAL/60 Hz NTSC mains frequencies
> 
> Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
> ---

Patch set applied.

> Without doubt the frenchest thing I've read this year, and, IMO,
> a really untoward moral high horse from a document that double-spaces
> compound punctuation and calls the English Index "Index English";

I hadn't noticed the double-spaced thingy; quite weird, this document
is!  xD

> 
> (Also, hilariously, Annexe 2. Réalisation pratique des définitions des
>  principales unités est publiée uniquement sous forme électronique sur
>  le site Web du BIPM, but it's 404ing just 16 short years after
>  publication, which is very cool considering it's an /internal link/.)

Yup.  In version 9, they opted for a simpler thing (for the editor, not
for the reader): remove the link, and say it's somewhere on their
website :/.

> Nevertheless, I find it difficult to disagree in this case,
> spaces before the Hz do work better in this parenthetical
> (but I want to note that this is becasuse you pointed it out,
>  not because the French talked sense into me).

:-)

Cheers,

Alex

> 
>  man7/time.7 | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
> 
> diff --git a/man7/time.7 b/man7/time.7
> index 830da7ea8..69d72af04 100644
> --- a/man7/time.7
> +++ b/man7/time.7
> @@ -92,7 +92,7 @@ configuration parameter and can be 100, 250 (the default) or 1000,
>  yielding a jiffies value of, respectively, 0.01, 0.004, or 0.001 seconds.
>  Since kernel 2.6.20, a further frequency is available:
>  300, a number that divides evenly for the common video
> -frame rates (PAL, 25 HZ; NTSC, 30 HZ).
> +frame rates (PAL, 25 Hz; NTSC, 30 Hz).
>  .PP
>  The
>  .BR times (2)

-- 
Alejandro Colomar
Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/
http://www.alejandro-colomar.es/