[tz] [PATCH] Give title lines to many files lacking them

[Paul Eggert]

---
 Makefile        | 2 ++
 africa          | 2 ++
 antarctica      | 2 ++
 asia            | 2 ++
 australasia     | 2 ++
 backward        | 2 ++
 difftime.c      | 2 ++
 etcetera        | 2 ++
 europe          | 2 ++
 factory         | 2 ++
 localtime.c     | 2 ++
 newstrftime.3   | 2 ++
 northamerica    | 2 ++
 pacificnew      | 2 ++
 private.h       | 2 ++
 southamerica    | 2 ++
 systemv         | 2 ++
 tzfile.h        | 2 ++
 tzselect.ksh    | 5 ++---
 workman.sh      | 1 +
 yearistype.sh   | 1 +
 zdump.c         | 2 ++
 zic.c           | 2 ++
 zoneinfo2tdf.pl | 1 +
 24 files changed, 45 insertions(+), 3 deletions(-)

diff --git a/Makefile b/Makefile
index 9e3b8f9..d01bb9a 100644
--- a/Makefile
+++ b/Makefile
@@ -1,3 +1,5 @@
+# Make and install tzdb code and data.
+
 # This file is in the public domain, so clarified as of
 # 2009-05-17 by Arthur David Olson.
 
diff --git a/africa b/africa
index eb7f8ae..131330e 100644
--- a/africa
+++ b/africa
@@ -1,3 +1,5 @@
+# tzdb data for Africa and environs
+
 # This file is in the public domain, so clarified as of
 # 2009-05-17 by Arthur David Olson.
 
diff --git a/antarctica b/antarctica
index 866cf4f..1dd9b00 100644
--- a/antarctica
+++ b/antarctica
@@ -1,3 +1,5 @@
+# tzdb data for Antarctica and environs
+
 # This file is in the public domain, so clarified as of
 # 2009-05-17 by Arthur David Olson.
 
diff --git a/asia b/asia
index 810ef47..7166380 100644
--- a/asia
+++ b/asia
@@ -1,3 +1,5 @@
+# tzdb data for Asia and environs
+
 # This file is in the public domain, so clarified as of
 # 2009-05-17 by Arthur David Olson.
 
diff --git a/australasia b/australasia
index 938c591..87ba620 100644
--- a/australasia
+++ b/australasia
@@ -1,3 +1,5 @@
+# tzdb data for Australasia and environs, and for much of the Pacific
+
 # This file is in the public domain, so clarified as of
 # 2009-05-17 by Arthur David Olson.
 
diff --git a/backward b/backward
index a455044..51e10f4 100644
--- a/backward
+++ b/backward
@@ -1,3 +1,5 @@
+# tzdb links for backward compatibility
+
 # This file is in the public domain, so clarified as of
 # 2009-05-17 by Arthur David Olson.
 
diff --git a/difftime.c b/difftime.c
index 856234a..7b96927 100644
--- a/difftime.c
+++ b/difftime.c
@@ -1,3 +1,5 @@
+/* Return the difference between two timestamps.  */
+
 /*
 ** This file is in the public domain, so clarified as of
 ** 1996-06-05 by Arthur David Olson.
diff --git a/etcetera b/etcetera
index 1a59630..91ded93 100644
--- a/etcetera
+++ b/etcetera
@@ -1,3 +1,5 @@
+# tzdb data for ships at sea and other miscellany
+
 # This file is in the public domain, so clarified as of
 # 2009-05-17 by Arthur David Olson.
 
diff --git a/europe b/europe
index 8a8f8f9..a5feb59 100644
--- a/europe
+++ b/europe
@@ -1,3 +1,5 @@
+# tzdb data for Europe and environs
+
 # This file is in the public domain, so clarified as of
 # 2009-05-17 by Arthur David Olson.
 
diff --git a/factory b/factory
index 5f0573d..d4e7659 100644
--- a/factory
+++ b/factory
@@ -1,3 +1,5 @@
+# tzdb data for noncommittal factory settings
+
 # This file is in the public domain, so clarified as of
 # 2009-05-17 by Arthur David Olson.
 
diff --git a/localtime.c b/localtime.c
index b217865..6b45254 100644
--- a/localtime.c
+++ b/localtime.c
@@ -1,3 +1,5 @@
+/* Convert timestamp from time_t to struct tm.  */
+
 /*
 ** This file is in the public domain, so clarified as of
 ** 1996-06-05 by Arthur David Olson.
diff --git a/newstrftime.3 b/newstrftime.3
index 1fd80df..eee503e 100644
--- a/newstrftime.3
+++ b/newstrftime.3
@@ -1,3 +1,5 @@
+.\" strftime man page
+.\"
 .\" Based on the UCB file whose corrected copyright information appears below.
 .\" Copyright 1989, 1991 The Regents of the University of California.
 .\" All rights reserved.
diff --git a/northamerica b/northamerica
index 06db1a8..ffbda74 100644
--- a/northamerica
+++ b/northamerica
@@ -1,3 +1,5 @@
+# tzdb data for North and Central America and environs
+
 # This file is in the public domain, so clarified as of
 # 2009-05-17 by Arthur David Olson.
 
diff --git a/pacificnew b/pacificnew
index 7349434..0e6cf07 100644
--- a/pacificnew
+++ b/pacificnew
@@ -1,3 +1,5 @@
+# tzdb data for proposed US election time (this file is obsolete)
+
 # This file is in the public domain, so clarified as of
 # 2009-05-17 by Arthur David Olson.
 
diff --git a/private.h b/private.h
index 641f905..1ead147 100644
--- a/private.h
+++ b/private.h
@@ -1,3 +1,5 @@
+/* Private header for tzdb code.  */
+
 #ifndef PRIVATE_H
 
 #define PRIVATE_H
diff --git a/southamerica b/southamerica
index aab355c..67562f2 100644
--- a/southamerica
+++ b/southamerica
@@ -1,3 +1,5 @@
+# tzdb data for South America and environs
+
 # This file is in the public domain, so clarified as of
 # 2009-05-17 by Arthur David Olson.
 
diff --git a/systemv b/systemv
index d9e2995..24c8f64 100644
--- a/systemv
+++ b/systemv
@@ -1,3 +1,5 @@
+# tzdb data for System V rules (this file is obsolete)
+
 # This file is in the public domain, so clarified as of
 # 2009-05-17 by Arthur David Olson.
 
diff --git a/tzfile.h b/tzfile.h
index f7f5caf..27a38cc 100644
--- a/tzfile.h
+++ b/tzfile.h
@@ -1,3 +1,5 @@
+/* Layout and location of TZif files.  */
+
 #ifndef TZFILE_H
 
 #define TZFILE_H
diff --git a/tzselect.ksh b/tzselect.ksh
index f7d8154..18fce27 100644
--- a/tzselect.ksh
+++ b/tzselect.ksh
@@ -1,12 +1,11 @@
 #!/bin/bash
+# Ask the user about the time zone, and output the resulting TZ value to stdout.
+# Interact with the user via stderr and stdin.
 
 PKGVERSION='(tzcode) '
 TZVERSION=see_Makefile
 REPORT_BUGS_TO=tz at iana.org
 
-# Ask the user about the time zone, and output the resulting TZ value to stdout.
-# Interact with the user via stderr and stdin.
-
 # Contributed by Paul Eggert.  This file is in the public domain.
 
 # Porting notes:
diff --git a/workman.sh b/workman.sh
index 4b3b64a..8fb18a4 100644
--- a/workman.sh
+++ b/workman.sh
@@ -1,4 +1,5 @@
 #! /bin/sh
+# Convert manual page troff stdin to formatted .txt stdout.
 
 # This file is in the public domain, so clarified as of
 # 2009-05-17 by Arthur David Olson.
diff --git a/yearistype.sh b/yearistype.sh
index dfdcdf0..d674175 100644
--- a/yearistype.sh
+++ b/yearistype.sh
@@ -1,4 +1,5 @@
 #! /bin/sh
+: 'Determine whether year is of appropriate type (this file is obsolete).'
 
 : 'This file is in the public domain, so clarified as of'
 : '2006-07-17 by Arthur David Olson.'
diff --git a/zdump.c b/zdump.c
index 4c61f58..608f288 100644
--- a/zdump.c
+++ b/zdump.c
@@ -1,3 +1,5 @@
+/* Dump time zone data in a textual format.  */
+
 /*
 ** This file is in the public domain, so clarified as of
 ** 2009-05-17 by Arthur David Olson.
diff --git a/zic.c b/zic.c
index 88153db..9d455b5 100644
--- a/zic.c
+++ b/zic.c
@@ -1,3 +1,5 @@
+/* Compile .zi time zone data into TZif binary files.  */
+
 /*
 ** This file is in the public domain, so clarified as of
 ** 2006-07-17 by Arthur David Olson.
diff --git a/zoneinfo2tdf.pl b/zoneinfo2tdf.pl
index e05ec01..c8c5591 100755
--- a/zoneinfo2tdf.pl
+++ b/zoneinfo2tdf.pl
@@ -1,4 +1,5 @@
 #! /usr/bin/perl -w
+# Summarize .zi input in a .zi-like format.
 
 # Courtesy Ken Pizzini.
 
-- 
2.7.4