[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[SCM] gawk branch, gawk-5.2-stable, updated. gawk-4.1.0-5066-gb4b0b04b
|
From: |
Arnold Robbins |
|
Subject: |
[SCM] gawk branch, gawk-5.2-stable, updated. gawk-4.1.0-5066-gb4b0b04b |
|
Date: |
Fri, 2 Jun 2023 04:25:58 -0400 (EDT) |
This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "gawk".
The branch, gawk-5.2-stable has been updated
via b4b0b04b82cd63313a04963def3cf8fa5f010369 (commit)
from f36f9655397606d614f132add22768d12238b3ef (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
- Log -----------------------------------------------------------------
http://git.sv.gnu.org/cgit/gawk.git/commit/?id=b4b0b04b82cd63313a04963def3cf8fa5f010369
commit b4b0b04b82cd63313a04963def3cf8fa5f010369
Author: Arnold D. Robbins <arnold@skeeve.com>
Date: Fri Jun 2 11:25:35 2023 +0300
Lots of doc fixes and updates.
diff --git a/ChangeLog b/ChangeLog
index ff8b13c9..6e8e52d1 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2023-06-02 Arnold D. Robbins <arnold@skeeve.com>
+
+ * NEWS: Updated.
+
2023-05-07 Arnold D. Robbins <arnold@skeeve.com>
* 5.2.2: Release tar ball made.
diff --git a/NEWS b/NEWS
index ab6d0425..9e31a87e 100644
--- a/NEWS
+++ b/NEWS
@@ -4,6 +4,13 @@
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.
+Changes from 5.2.2 to 5.2.x
+---------------------------
+
+1. The readdir extension has been updated with additonal code and
+ features, see the manual or its man page. As a result, the
+ readdir_test.c extension has been removed.
+
Changes from 5.2.1 to 5.2.2
---------------------------
diff --git a/doc/ChangeLog b/doc/ChangeLog
index d112b5e4..23a6bb6b 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,17 @@
+2023-06-02 Arnold D. Robbins <arnold@skeeve.com>
+
+ * gawk.1: Remove last use of \c and fix a typo reported by
+ Bjarni Ingi Gislasson.
+ * gawkbug.1: Fix up formatting of `--'. Also reported by
+ Bjarni Ingi Gislasson.
+ * gawktexi.in (Extension Sample Readdir): Added more info
+ to sync with the readdir.3am man page.
+
+2023-06-02 Bjarni Ingi Gislason <bjarniig@simnet.is>
+
+ * gawk.1: Remove most uses of \c to help with po4a.
+ Original issue reported by Helge Kreutzmann <debian@helgefjell.de>.
+
2023-05-28 Arnold D. Robbins <arnold@skeeve.com>
* gawktexi.in (Extension Sample Readdir): Updated.
diff --git a/doc/gawk.1 b/doc/gawk.1
index c5cbe87d..27fcff2e 100644
--- a/doc/gawk.1
+++ b/doc/gawk.1
@@ -94,8 +94,7 @@ Standard options are listed first, followed by options for
.I gawk
extensions, listed alphabetically by short option.
.TP
-.BI \-f " program-file\fR,\fP "\c
-.BI \-\^\-file " program-file"
+.BI \-f " program-file\fR,\fP " \-\^\-file " program-file"
Read the \*(AK program source from the file
.IR program-file ,
instead of from the first command line argument.
@@ -106,8 +105,7 @@ Files read with
.B \-f
are treated as if they begin with an implicit \fB@namespace "awk"\fR statement.
.TP
-.BI \-F " fs\fR, \fP"\c
-.BI \-\^\-field-separator " fs"
+.BI \-F " fs\fR, \fP" \-\^\-field-separator " fs"
Use
.I fs
for the input field separator (the value of the
@@ -125,15 +123,13 @@ Such variable values are available to the
.B BEGIN
rule of an \*(AK program.
.TP
-.BR \-b ", "\c
-.B \-\^\-characters\-as\-bytes
+.BR \-b ", " \-\^\-characters\-as\-bytes
Treat all input data as single-byte characters.
The
.B \-\^\-posix
option overrides this one.
.TP
-.BR \-c ", "\c
-.B \-\^\-traditional
+.BR \-c ", " \-\^\-traditional
Run in
.I compatibility
mode. In compatibility mode,
@@ -142,8 +138,7 @@ behaves identically to Brian Kernighan's
.IR awk ;
none of the \*(GN-specific extensions are recognized.
.TP
-.BR \-C ", "\c
-.B \-\^\-copyright
+.BR \-C ", " \-\^\-copyright
Print the short version of the \*(GN copyright information message on
the standard output and exit successfully.
.TP
@@ -176,8 +171,7 @@ options.
The debugger is documented in \*(EP; see
.IR https://www.gnu.org/software/gawk/manual/html_node/Debugger.html#Debugger .
.TP
-.BI \-e " program-text\fR, \fP"\c
-.BI \-\^\-source " program-text"
+.BI \-e " program-text\fR, \fP" \-\^\-source " program-text"
Use
.I program-text
as \*(AK program source code.
@@ -188,7 +182,7 @@ is treated as if it begins with an implicit \fB@namespace
"awk"\fR statement.
\fB\-E \fIfile\fR, \fB\-\^\-exec \fIfile\fR
Similar to
.BR \-f ,
-however, this is option is the last one processed.
+however, this option is the last one processed.
This should be used with
.B #!
scripts, particularly for CGI applications, to avoid
@@ -196,16 +190,14 @@ passing in options or source code (!) on the command line
from a URL.
This option disables command-line variable assignments.
.TP
-.BR \-g ", "\c
-.B \-\^\-gen\-pot
+.BR \-g ", " \-\^\-gen\-pot
Scan and parse the \*(AK program, and generate a \*(GN
.B \&.pot
(Portable Object Template)
format file on standard output with entries for all localizable
strings in the program. The program itself is not executed.
.TP
-.BR \-h ", "\c
-.B \-\^\-help
+.BR \-h ", " \-\^\-help
Print a relatively short summary of the available options on
the standard output.
Per the
@@ -226,16 +218,14 @@ Files read with
.B \-\^\-include
are treated as if they begin with an implicit \fB@namespace "awk"\fR statement.
.TP
-.BR \-I ", "\c
-.B \-\^\-trace
+.BR \-I ", " \-\^\-trace
Print the internal byte code names as they are executed when running
the program. The trace is printed to standard error. Each ``op code''
is preceded by a
.B +
sign in the output.
.TP
-.BI \-l " lib\fR, "\c
-.BI \-\^\-load " lib"
+.BI \-l " lib\fR, " \-\^\-load " lib"
Load a
.I gawk
extension from the shared library
@@ -255,8 +245,7 @@ See
for the list of possible values for
.IR value .
.TP
-.BR \-M ", "\c
-.B \-\^\-bignum
+.BR \-M ", " \-\^\-bignum
Force arbitrary precision arithmetic on numbers. This option has
no effect if
.I gawk
@@ -281,21 +270,18 @@ Set
in the environment to silence the warning.
..
.TP
-.BR \-n ", "\c
-.B \-\^\-non\-decimal\-data
+.BR \-n ", " \-\^\-non\-decimal\-data
Recognize octal and hexadecimal values in input data.
.I "Use this option with great caution!"
.TP
-.BR \-N ", "\c
-.B \-\^\-use\-lc\-numeric
+.BR \-N ", " \-\^\-use\-lc\-numeric
Force
.I gawk
to use the locale's decimal point character when parsing input data.
.ig
.\" This option is left undocumented, on purpose.
.TP
-.BR "\-W nostalgia" ", "\c
-.B \-\^\-nostalgia
+.BR "\-W nostalgia" ", " \-\^\-nostalgia
Provide a moment of nostalgia for long time
.I awk
users.
@@ -310,8 +296,7 @@ in the current directory.
This option implies
.BR \-\^\-no\-optimize .
.TP
-.BR \-O ", "\c
-.B \-\^\-optimize
+.BR \-O ", " \-\^\-optimize
Enable
.IR gawk 's
default optimizations upon the internal representation of the program.
@@ -330,28 +315,24 @@ runs more slowly in this mode.
This option implies
.BR \-\^\-no\-optimize .
.TP
-.BR \-P ", "\c
-.B \-\^\-posix
+.BR \-P ", " \-\^\-posix
This turns on
.I compatibility
mode, and disables a number of common extensions.
.TP
-.BR \-r ", "\c
-.B \-\^\-re\-interval
+.BR \-r ", " \-\^\-re\-interval
Enable the use of
.I "interval expressions"
in regular expression matching.
Interval expressions
are enabled by default, but this option remains for backwards compatibility.
.TP
-.BR \-s ", "\c
-.B \-\^\-no\-optimize
+.BR \-s ", " \-\^\-no\-optimize
Disable
.IR gawk 's
default optimizations upon the internal representation of the program.
.TP
-.BR \-S ", "\c
-.B \-\^\-sandbox
+.BR \-S ", " \-\^\-sandbox
Run
.I gawk
in sandbox mode, disabling the
@@ -363,14 +344,12 @@ output redirection with
and loading dynamic extensions.
Command execution (through pipelines) is also disabled.
.TP
-.BR \-t ", "\c
-.B \-\^\-lint\-old
+.BR \-t ", " \-\^\-lint\-old
Provide warnings about constructs that are
not portable to the original version of \*(UX
.IR awk .
.TP
-.BR \-V ", "\c
-.B \-\^\-version
+.BR \-V ", " \-\^\-version
Print version information for this particular copy of
.I gawk
on the standard output.
@@ -1228,8 +1207,7 @@ Logical OR.
.TP
.B ?:
The C conditional expression. This has the form
-.IB expr1 " ? " expr2 " : " expr3\c
-\&.
+.IB expr1 " ? " expr2 " : " expr3\/\fR.
If
.I expr1
is true, the value of the expression is
diff --git a/doc/gawk.info b/doc/gawk.info
index dd8550f7..56f6002f 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -29477,6 +29477,12 @@ file type information, the extension falls back to
calling the âstat()â
system call in order to provide the information. Thus the third field
should never be âuâ (for âunknownâ).
+ Normally, when reading directories, you should set âFSâ equal to
+â"/"â. However, you may instead chose to create
+âPROCINFO["readdir_override"]â (with any value). If this element exists
+when the directory is opened, then the extension automatically sets the
+fields in each record for you.
+
By default, if a directory cannot be opened (due to permission
problems, for example), âgawkâ will exit. As with regular files, this
situation can be handled using a âBEGINFILEâ rule that checks âERRNOâ
@@ -39915,95 +39921,95 @@ Node: Extension Sample Inplace1230829
Node: Extension Sample Ord1234501
Node: Extension Sample Readdir1235377
Ref: table-readdir-file-types1236166
-Node: Extension Sample Revout1237221
-Node: Extension Sample Rev2way1237818
-Node: Extension Sample Read write array1238570
-Node: Extension Sample Readfile1241844
-Node: Extension Sample Time1242975
-Node: Extension Sample API Tests1245265
-Node: gawkextlib1245773
-Node: Extension summary1248809
-Node: Extension Exercises1252667
-Node: Language History1253945
-Node: V7/SVR3.11255659
-Node: SVR41258009
-Node: POSIX1259541
-Node: BTL1260966
-Node: POSIX/GNU1261735
-Node: Feature History1268266
-Node: Common Extensions1287384
-Node: Ranges and Locales1288753
-Ref: Ranges and Locales-Footnote-11293554
-Ref: Ranges and Locales-Footnote-21293581
-Ref: Ranges and Locales-Footnote-31293820
-Node: Contributors1294043
-Node: History summary1300248
-Node: Installation1301694
-Node: Gawk Distribution1302658
-Node: Getting1303150
-Node: Extracting1304149
-Node: Distribution contents1305861
-Node: Unix Installation1313941
-Node: Quick Installation1314763
-Node: Compiling with MPFR1317309
-Node: Shell Startup Files1318015
-Node: Additional Configuration Options1319172
-Node: Configuration Philosophy1321559
-Node: Compiling from Git1324061
-Node: Building the Documentation1324620
-Node: Non-Unix Installation1326032
-Node: PC Installation1326508
-Node: PC Binary Installation1327381
-Node: PC Compiling1328286
-Node: PC Using1329464
-Node: Cygwin1333192
-Node: MSYS1334448
-Node: OpenVMS Installation1335080
-Node: OpenVMS Compilation1335761
-Ref: OpenVMS Compilation-Footnote-11337244
-Node: OpenVMS Dynamic Extensions1337306
-Node: OpenVMS Installation Details1338942
-Node: OpenVMS Running1341377
-Node: OpenVMS GNV1345514
-Node: Bugs1346269
-Node: Bug definition1347193
-Node: Bug address1350844
-Node: Usenet1354435
-Node: Performance bugs1355666
-Node: Asking for help1358684
-Node: Maintainers1360675
-Node: Other Versions1361702
-Node: Installation summary1371045
-Node: Notes1372429
-Node: Compatibility Mode1373239
-Node: Additions1374061
-Node: Accessing The Source1375006
-Node: Adding Code1376541
-Node: New Ports1383677
-Node: Derived Files1388187
-Ref: Derived Files-Footnote-11394034
-Ref: Derived Files-Footnote-21394069
-Ref: Derived Files-Footnote-31394686
-Node: Future Extensions1394800
-Node: Implementation Limitations1395472
-Node: Extension Design1396714
-Node: Old Extension Problems1397878
-Ref: Old Extension Problems-Footnote-11399454
-Node: Extension New Mechanism Goals1399515
-Ref: Extension New Mechanism Goals-Footnote-11403011
-Node: Extension Other Design Decisions1403212
-Node: Extension Future Growth1405411
-Node: Notes summary1406035
-Node: Basic Concepts1407248
-Node: Basic High Level1407933
-Ref: figure-general-flow1408215
-Ref: figure-process-flow1408922
-Ref: Basic High Level-Footnote-11412323
-Node: Basic Data Typing1412512
-Node: Glossary1415930
-Node: Copying1449052
-Node: GNU Free Documentation License1486813
-Node: Index1512136
+Node: Extension Sample Revout1237527
+Node: Extension Sample Rev2way1238124
+Node: Extension Sample Read write array1238876
+Node: Extension Sample Readfile1242150
+Node: Extension Sample Time1243281
+Node: Extension Sample API Tests1245571
+Node: gawkextlib1246079
+Node: Extension summary1249115
+Node: Extension Exercises1252973
+Node: Language History1254251
+Node: V7/SVR3.11255965
+Node: SVR41258315
+Node: POSIX1259847
+Node: BTL1261272
+Node: POSIX/GNU1262041
+Node: Feature History1268572
+Node: Common Extensions1287690
+Node: Ranges and Locales1289059
+Ref: Ranges and Locales-Footnote-11293860
+Ref: Ranges and Locales-Footnote-21293887
+Ref: Ranges and Locales-Footnote-31294126
+Node: Contributors1294349
+Node: History summary1300554
+Node: Installation1302000
+Node: Gawk Distribution1302964
+Node: Getting1303456
+Node: Extracting1304455
+Node: Distribution contents1306167
+Node: Unix Installation1314247
+Node: Quick Installation1315069
+Node: Compiling with MPFR1317615
+Node: Shell Startup Files1318321
+Node: Additional Configuration Options1319478
+Node: Configuration Philosophy1321865
+Node: Compiling from Git1324367
+Node: Building the Documentation1324926
+Node: Non-Unix Installation1326338
+Node: PC Installation1326814
+Node: PC Binary Installation1327687
+Node: PC Compiling1328592
+Node: PC Using1329770
+Node: Cygwin1333498
+Node: MSYS1334754
+Node: OpenVMS Installation1335386
+Node: OpenVMS Compilation1336067
+Ref: OpenVMS Compilation-Footnote-11337550
+Node: OpenVMS Dynamic Extensions1337612
+Node: OpenVMS Installation Details1339248
+Node: OpenVMS Running1341683
+Node: OpenVMS GNV1345820
+Node: Bugs1346575
+Node: Bug definition1347499
+Node: Bug address1351150
+Node: Usenet1354741
+Node: Performance bugs1355972
+Node: Asking for help1358990
+Node: Maintainers1360981
+Node: Other Versions1362008
+Node: Installation summary1371351
+Node: Notes1372735
+Node: Compatibility Mode1373545
+Node: Additions1374367
+Node: Accessing The Source1375312
+Node: Adding Code1376847
+Node: New Ports1383983
+Node: Derived Files1388493
+Ref: Derived Files-Footnote-11394340
+Ref: Derived Files-Footnote-21394375
+Ref: Derived Files-Footnote-31394992
+Node: Future Extensions1395106
+Node: Implementation Limitations1395778
+Node: Extension Design1397020
+Node: Old Extension Problems1398184
+Ref: Old Extension Problems-Footnote-11399760
+Node: Extension New Mechanism Goals1399821
+Ref: Extension New Mechanism Goals-Footnote-11403317
+Node: Extension Other Design Decisions1403518
+Node: Extension Future Growth1405717
+Node: Notes summary1406341
+Node: Basic Concepts1407554
+Node: Basic High Level1408239
+Ref: figure-general-flow1408521
+Ref: figure-process-flow1409228
+Ref: Basic High Level-Footnote-11412629
+Node: Basic Data Typing1412818
+Node: Glossary1416236
+Node: Copying1449358
+Node: GNU Free Documentation License1487119
+Node: Index1512442
End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 883118cf..854b85e1 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -40195,6 +40195,12 @@ to calling the @code{stat()} system call
in order to provide the information.
Thus the third field should never be @samp{u} (for ``unknown'').
+Normally, when reading directories, you should set @code{FS}
+equal to @code{"/"}. However, you may instead chose to create
+@code{PROCINFO["readdir_override"]} (with any value). If this element
+exists when the directory is opened, then the extension automatically
+sets the fields in each record for you.
+
By default, if a directory cannot be opened (due to permission problems,
for example), @command{gawk} will exit. As with regular files, this
situation can be handled using a @code{BEGINFILE} rule that checks
diff --git a/doc/gawkbug.1 b/doc/gawkbug.1
index c9fa4283..29cb7084 100644
--- a/doc/gawkbug.1
+++ b/doc/gawkbug.1
@@ -6,11 +6,11 @@
.\"
.\" Last Change: Mon Apr 18 16:21:25 IDT 2022
.\"
-.TH GAWKBUG 1 "2022 Apr 18" "GNU Awk 5.2"
+.TH GAWKBUG 1 "2023 June 02" "GNU Awk 5.2"
.SH NAME
gawkbug \- report a bug in gawk
.SH SYNOPSIS
-\fBgawkbug\fP [\fI--version\fP] [\fI--help\fP] [\fIemail-address\fP]
+\fBgawkbug\fP [\fI\-\^\-version\fP] [\fI\-\^\-help\fP] [\fIemail-address\fP]
.SH DESCRIPTION
.B gawkbug
is a shell script to help the user compose and mail bug reports
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index ef2be684..65f7aa48 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -39111,6 +39111,12 @@ to calling the @code{stat()} system call
in order to provide the information.
Thus the third field should never be @samp{u} (for ``unknown'').
+Normally, when reading directories, you should set @code{FS}
+equal to @code{"/"}. However, you may instead chose to create
+@code{PROCINFO["readdir_override"]} (with any value). If this element
+exists when the directory is opened, then the extension automatically
+sets the fields in each record for you.
+
By default, if a directory cannot be opened (due to permission problems,
for example), @command{gawk} will exit. As with regular files, this
situation can be handled using a @code{BEGINFILE} rule that checks
diff --git a/extension/ChangeLog b/extension/ChangeLog
index ed88effa..47c4b3c2 100644
--- a/extension/ChangeLog
+++ b/extension/ChangeLog
@@ -1,3 +1,7 @@
+2023-06-02 Arnold D. Robbins <arnold@skeeve.com>
+
+ * readdir.3am: Very small fix.
+
2023-05-28 Arnold D. Robbins <arnold@skeeve.com>
* readdir.c: Add checking of PROCINFO["readdir_override"].
diff --git a/extension/readdir.3am b/extension/readdir.3am
index 3a2a4170..a5635471 100644
--- a/extension/readdir.3am
+++ b/extension/readdir.3am
@@ -1,4 +1,4 @@
-.TH READDIR 3am "May 28 2023" "Free Software Foundation" "GNU Awk Extension
Modules"
+.TH READDIR 3am "June 02 2023" "Free Software Foundation" "GNU Awk Extension
Modules"
.SH NAME
readdir \- directory input parser for gawk
.SH SYNOPSIS
@@ -52,7 +52,7 @@ Normally, when reading directories, you should set
.B FS
equal to \fB"/"\fP. However, you may instead chose to create
\fBPROCINFO["readdir_override"]\fP (with any value). If this element
-exists, when the directory is opened, then the extension automatically
+exists when the directory is opened, then the extension automatically
sets the fields in each record for you.
.PP
By default, if a directory cannot be opened (due to permission problems,
-----------------------------------------------------------------------
Summary of changes:
ChangeLog | 4 ++
NEWS | 7 ++
doc/ChangeLog | 14 ++++
doc/gawk.1 | 68 +++++++------------
doc/gawk.info | 184 ++++++++++++++++++++++++++------------------------
doc/gawk.texi | 6 ++
doc/gawkbug.1 | 4 +-
doc/gawktexi.in | 6 ++
extension/ChangeLog | 4 ++
extension/readdir.3am | 4 +-
10 files changed, 163 insertions(+), 138 deletions(-)
hooks/post-receive
--
gawk
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- [SCM] gawk branch, gawk-5.2-stable, updated. gawk-4.1.0-5066-gb4b0b04b,
Arnold Robbins <=