[gawk-diffs] [SCM] gawk branch, feature/api-parser, updated. gawk-4.1.0-2462-g19bebf5

[Andrew J. Schorr]

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, feature/api-parser has been updated
       via  19bebf51939d4c24d261c5720b3e54333d441fa6 (commit)
      from  1a417d68f71b18525c572b903086f451ed75902b (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=19bebf51939d4c24d261c5720b3e54333d441fa6

commit 19bebf51939d4c24d261c5720b3e54333d441fa6
Author: Andrew J. Schorr <address@hidden>
Date:   Wed Mar 22 20:26:03 2017 -0400

    Start to document new FIELDWIDTHS and API input parser capabilities.

diff --git a/ChangeLog b/ChangeLog
index 54b7663..7c10c12 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,10 @@
 2017-03-22         Andrew J. Schorr     <address@hidden>
 
+       * NEWS: Document new FIELDWIDTHS skip capability and API input parser
+       field parsing enhancement.
+
+2017-03-22         Andrew J. Schorr     <address@hidden>
+
        * gawkapi.h (awk_input_buf_t): Update get_record comment regarding the
        new field_width argument.
 
diff --git a/NEWS b/NEWS
index 3ddc96e..9905a70 100644
--- a/NEWS
+++ b/NEWS
@@ -104,6 +104,13 @@ Changes from 4.1.x to 4.2.0
     argument is present and is non-zero or non-null, the time will be converted
     from UTC instead of from the local timezone.
 
+26. The FIELDWIDTHS parsing syntax has been enhanced to allow specifying
+    how many characters to skip before a field starts.
+
+27. An API input parser now has the ability to override the default field
+    parsing mechanism by specifying the locations of each field in the input
+    record.
+
 Changes from 4.1.3 to 4.1.4
 ---------------------------
 
diff --git a/doc/ChangeLog b/doc/ChangeLog
index 142f035..898cfa4 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,9 @@
+2017-03-22         Andrew J. Schorr     <address@hidden>
+
+       * awkcard.in: Document FIELDWIDTHS enhancement to support an optional
+       field skip prefix.
+       * gawk.1: Ditto.
+
 2017-03-17         Arnold D. Robbins     <address@hidden>
 
        * gawktexi.in: Improve the discussion of quoting on
diff --git a/doc/awkcard.in b/doc/awkcard.in
index 418cc8d..86aeee2 100644
--- a/doc/awkcard.in
+++ b/doc/awkcard.in
@@ -556,8 +556,10 @@ fails, or if
 \*(FCclose()\*(FR fails.
 T}
 \*(FCFIELDWIDTHS\fP    T{
-Whitespace separated list of field widths. Used
-to parse the input into fields of fixed width,
+Whitespace-separated list of field widths.
+Each field width may optionally be preceded by a colon-separated
+value specifying the number of characters to skip before the field starts.
+Used to parse the input into fields of fixed width,
 instead of the value of \*(FCFS\fP.\*(CD
 T}
 \*(FCFILENAME\fP       T{
@@ -1017,6 +1019,8 @@ also affects how fields are split when
 variable is set to a space-separated list of numbers, each field is
 expected to have a fixed width, and \*(GK
 splits up the record using the specified widths.
+Each field width may optionally be preceded by a colon-separated
+value specifying the number of characters to skip before the field starts.
 The value of \*(FCFS\fP is ignored.
 Assigning a new value to \*(FCFS\fP or \*(FCFPAT\fP
 overrides the use of \*(FCFIELDWIDTHS\*(FR.
diff --git a/doc/gawk.1 b/doc/gawk.1
index 2460a68..f135e95 100644
--- a/doc/gawk.1
+++ b/doc/gawk.1
@@ -805,10 +805,13 @@ is a regular expression.
 .PP
 If the
 .B FIELDWIDTHS
-variable is set to a space separated list of numbers, each field is
+variable is set to a space-separated list of numbers, each field is
 expected to have fixed width, and
 .I gawk
-splits up the record using the specified widths.  The value of
+splits up the record using the specified widths. 
+Each field width may optionally be preceded by a colon-separated
+value specifying the number of characters to skip before the field starts.
+The value of
 .B FS
 is ignored.
 Assigning a new value to
@@ -959,12 +962,14 @@ For non-system errors,
 will be zero.
 .TP
 .B FIELDWIDTHS
-A whitespace separated list of field widths.  When set,
+A whitespace-separated list of field widths.  When set,
 .I gawk
 parses the input into fields of fixed width, instead of using the
 value of the
 .B FS
 variable as the field separator.
+Each field width may optionally be preceded by a colon-separated
+value specifying the number of characters to skip before the field starts.
 See
 .BR Fields ,
 above.

-----------------------------------------------------------------------

Summary of changes:
 ChangeLog      |  5 +++++
 NEWS           |  7 +++++++
 doc/ChangeLog  |  6 ++++++
 doc/awkcard.in |  8 ++++++--
 doc/gawk.1     | 11 ++++++++---
 5 files changed, 32 insertions(+), 5 deletions(-)


hooks/post-receive
-- 
gawk