Re: mandoc(1) warning in tzfile(5) regarding //

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On 3/8/23 14:15, Alejandro Colomar wrote:

That patch looks good to me.  If you use these:

Reviewed-by: Alejandro Colomar <alx@xxxxxxxxxx>

Oh, we don't use those in tzdb; instead your name is mentioned in the commit message. I installed it that way.


I suggest using the project name without a
version.  How about the following?

.TH tzfile 5 "" tzdb

(or alternatively:)

.TH tzfile 5 "" "Time Zone Database"

Yes, that should work. I installed the attached proposed patch into the tzdb development repository. Feel free to migrate this into man-pages at your convenience. No rush of course.


I've been reluctant to do that upstream since I expect each
downstream user has its own format for comments regarding licensing,
SBOM, SSDF, SCA, and so forth (and if you don't know what those acronyms
mean then I envy you :-).

I don't :-)

https://www.nist.gov/itl/executive-order-14028-improving-nations-cybersecurity/software-security-supply-chains-open
From 27148539e699d9abe50df84371a077fdf2bc13de Mon Sep 17 00:00:00 2001
From: Paul Eggert <eggert@xxxxxxxxxxx>
Date: Wed, 8 Mar 2023 14:40:58 -0800
Subject: [PROPOSED] Append tzdb arg 4 to .TH lines

Suggested by Alejandro Colomar in:
https://lore.kernel.org/linux-man/08a72d2c-e7cb-4390-2cb1-7601b344ce9e@xxxxxxxxx/T/#t
---
 date.1        | 2 +-
 newctime.3    | 2 +-
 newstrftime.3 | 2 +-
 newtzset.3    | 2 +-
 time2posix.3  | 2 +-
 tzfile.5      | 2 +-
 tzselect.8    | 2 +-
 zdump.8       | 2 +-
 zic.8         | 2 +-
 9 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/date.1 b/date.1
index 8670ff1..e810721 100644
--- a/date.1
+++ b/date.1
@@ -1,6 +1,6 @@
 .\" This file is in the public domain, so clarified as of
 .\" 2009-05-17 by Arthur David Olson.
-.TH date 1
+.TH date 1 "" "Time Zone Database"
 .SH NAME
 date \- show and set date and time
 .SH SYNOPSIS
diff --git a/newctime.3 b/newctime.3
index 70d8e54..05bb7de 100644
--- a/newctime.3
+++ b/newctime.3
@@ -1,6 +1,6 @@
 .\" This file is in the public domain, so clarified as of
 .\" 2009-05-17 by Arthur David Olson.
-.TH newctime 3
+.TH newctime 3 "" "Time Zone Database"
 .SH NAME
 asctime, ctime, difftime, gmtime, localtime, mktime \- convert date and time
 .SH SYNOPSIS
diff --git a/newstrftime.3 b/newstrftime.3
index 75d88c8..432c3e8 100644
--- a/newstrftime.3
+++ b/newstrftime.3
@@ -35,7 +35,7 @@
 .\"     from: @(#)strftime.3	5.12 (Berkeley) 6/29/91
 .\"	$Id: strftime.3,v 1.4 1993/12/15 20:33:00 jtc Exp $
 .\"
-.TH newstrftime 3
+.TH newstrftime 3 "" "Time Zone Database"
 .SH NAME
 strftime \- format date and time
 .SH SYNOPSIS
diff --git a/newtzset.3 b/newtzset.3
index e16ae6b..78b6b6c 100644
--- a/newtzset.3
+++ b/newtzset.3
@@ -1,6 +1,6 @@
 .\" This file is in the public domain, so clarified as of
 .\" 2009-05-17 by Arthur David Olson.
-.TH newtzset 3
+.TH newtzset 3 "" "Time Zone Database"
 .SH NAME
 tzset \- initialize time conversion information
 .SH SYNOPSIS
diff --git a/time2posix.3 b/time2posix.3
index e13c431..f48402b 100644
--- a/time2posix.3
+++ b/time2posix.3
@@ -1,6 +1,6 @@
 .\" This file is in the public domain, so clarified as of
 .\" 1996-06-05 by Arthur David Olson.
-.TH time2posix 3
+.TH time2posix 3 "" "Time Zone Database"
 .SH NAME
 time2posix, posix2time \- convert seconds since the Epoch
 .SH SYNOPSIS
diff --git a/tzfile.5 b/tzfile.5
index eb5d4e8..59d9f6b 100644
--- a/tzfile.5
+++ b/tzfile.5
@@ -1,6 +1,6 @@
 .\" This file is in the public domain, so clarified as of
 .\" 1996-06-05 by Arthur David Olson.
-.TH tzfile 5
+.TH tzfile 5 "" "Time Zone Database"
 .SH NAME
 tzfile \- timezone information
 .SH DESCRIPTION
diff --git a/tzselect.8 b/tzselect.8
index 9828848..4578090 100644
--- a/tzselect.8
+++ b/tzselect.8
@@ -1,6 +1,6 @@
 .\" This file is in the public domain, so clarified as of
 .\" 2009-05-17 by Arthur David Olson.
-.TH tzselect 8
+.TH tzselect 8 "" "Time Zone Database"
 .SH NAME
 tzselect \- select a timezone
 .SH SYNOPSIS
diff --git a/zdump.8 b/zdump.8
index 170e18d..f77c0c7 100644
--- a/zdump.8
+++ b/zdump.8
@@ -1,6 +1,6 @@
 .\" This file is in the public domain, so clarified as of
 .\" 2009-05-17 by Arthur David Olson.
-.TH zdump 8
+.TH zdump 8 "" "Time Zone Database"
 .SH NAME
 zdump \- timezone dumper
 .SH SYNOPSIS
diff --git a/zic.8 b/zic.8
index e9fccfe..c467efe 100644
--- a/zic.8
+++ b/zic.8
@@ -1,6 +1,6 @@
 .\" This file is in the public domain, so clarified as of
 .\" 2009-05-17 by Arthur David Olson.
-.TH zic 8
+.TH zic 8 "" "Time Zone Database"
 .SH NAME
 zic \- timezone compiler
 .SH SYNOPSIS
-- 
2.39.2


[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux