"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "doc/awkcard.in" between
gawk-5.0.1.tar.xz and gawk-5.1.0.tar.xz

About: GNU awk - pattern scanning and processing language.

awkcard.in  (gawk-5.0.1.tar.xz):awkcard.in  (gawk-5.1.0.tar.xz)
.\" AWK Reference Card --- Arnold Robbins, arnold@skeeve.com .\" AWK Reference Card --- Arnold Robbins, arnold@skeeve.com
.\" .\"
.\" Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, .\" Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
.\" 2005, 2007, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, .\" 2005, 2007, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018,
.\" 2019 .\" 2019, 2020
.\" Free Software Foundation, Inc. .\" Free Software Foundation, Inc.
.\" .\"
.\" Permission is granted to make and distribute verbatim copies of .\" Permission is granted to make and distribute verbatim copies of
.\" this reference card provided the copyright notice and this permission .\" this reference card provided the copyright notice and this permission
.\" notice are preserved on all copies. .\" notice are preserved on all copies.
.\" .\"
.\" Permission is granted to process this file through troff and print the .\" Permission is granted to process this file through troff and print the
.\" results, provided the printed document carries copying permission .\" results, provided the printed document carries copying permission
.\" notice identical to this one except for the removal of this paragraph .\" notice identical to this one except for the removal of this paragraph
.\" (this paragraph not being relevant to the printed reference card). .\" (this paragraph not being relevant to the printed reference card).
skipping to change at line 103 skipping to change at line 103
.fi .fi
.sp .4 .sp .4
.SL .SL
.sp .4 .sp .4
.so SRCDIR/ad.block .so SRCDIR/ad.block
.\" a subtlety here; this line changes color. We rely on it .\" a subtlety here; this line changes color. We rely on it
.\" also to provide a empty line. .\" also to provide a empty line.
\*(CD \*(CD
.SL .SL
.nf .nf
\*(FRCopyright \(co 1996\(en2005, 2007, 2009\(en2019 \*(FRCopyright \(co 1996\(en2005, 2007, 2009\(en2020
Free Software Foundation, Inc. Free Software Foundation, Inc.
.nf .nf
.BT .BT
.\" .\"
.\" .\"
.\" --- Definitions .\" --- Definitions
.fi .fi
.ES .ES
\*(CDThis card describes POSIX AWK, as well as three \*(CDThis card describes POSIX AWK, as well as three
skipping to change at line 279 skipping to change at line 279
.TI "\*(FC\-h\*(FR, \*(FC\-\^\-help\*(FR .TI "\*(FC\-h\*(FR, \*(FC\-\^\-help\*(FR
Print a short summary of the available Print a short summary of the available
options on \*(FCstdout\*(FR, then exit zero. options on \*(FCstdout\*(FR, then exit zero.
.TI "\*(FC\-i \*(FIfile\*(FR, \*(FC\-\^\-include \*(FIfile\*(FR .TI "\*(FC\-i \*(FIfile\*(FR, \*(FC\-\^\-include \*(FIfile\*(FR
Include library AWK code in \*(FIfile\*(FR. Include library AWK code in \*(FIfile\*(FR.
See \fHAwk Program Execution\*(FR. See \fHAwk Program Execution\*(FR.
.TI "\*(FC\-l \*(FIlib\*(FR, \*(FC\-\^\-load \*(FIlib\*(FR .TI "\*(FC\-l \*(FIlib\*(FR, \*(FC\-\^\-load \*(FIlib\*(FR
Load dynamic extension \*(FIlib\fP. Load dynamic extension \*(FIlib\fP.
See \fHDynamic Extensions\*(FR. See \fHDynamic Extensions\*(FR.
.TI "\*(FC\-L \*(FR[\*(FC\*(FIvalue\*(FR], \*(FC\-\^\-lint\*(FR[\*(FC=\*(FIvalue \*(FR] .TI "\*(FC\-L \*(FR[\*(FC\*(FIvalue\*(FR], \*(FC\-\^\-lint\*(FR[\*(FC=\*(FIvalue \*(FR]
Warn about dubious or non-portable constructs. Warn about dubious or non-portable constructs. Possible optional
If \*(FIvalue\*(FR is \*(FIvalue\*(FRs are
\*(FCfatal\*(FR, \*(FCfatal\*(FR,
lint warnings become fatal errors. \*(FCinvalid\*(FR, and
If \*(FIvalue\*(FR is \*(FCno-ext\*(FR.
\*(FCinvalid\*(FR, See \*(AM for the details.
only issue warnings about things that are
actually invalid (not fully implemented yet).
.TI "\*(FC\-M\*(FR, \*(FC\-\^\-bignum\*(FR .TI "\*(FC\-M\*(FR, \*(FC\-\^\-bignum\*(FR
Enable arbitrary-precision arithmetic. Enable arbitrary-precision arithmetic.
.TI "\*(FC\-n\*(FR, \*(FC\-\^\-non\-decimal\-data\*(FR .TI "\*(FC\-n\*(FR, \*(FC\-\^\-non\-decimal\-data\*(FR
Recognize octal and hexadecimal values in input data. Recognize octal and hexadecimal values in input data.
\*(FIUse this option with great caution!\*(FR \*(FIUse this option with great caution!\*(FR
.TI "\*(FC\-N\*(FR, \*(FC\-\^\-use\-lc\-numeric\*(FR .TI "\*(FC\-N\*(FR, \*(FC\-\^\-use\-lc\-numeric\*(FR
Force use of the locale's decimal point character when parsing input data. Force use of the locale's decimal point character when parsing input data.
.TI "\*(FC\-o\*(FR[\*(FC\*(FIfile\*(FR], \*(FC\-\^\-pretty-print\*(FR[\*(FC=\*(F Ifile\*(FR] .TI "\*(FC\-o\*(FR[\*(FC\*(FIfile\*(FR], \*(FC\-\^\-pretty-print\*(FR[\*(FC=\*(F Ifile\*(FR]
Output a pretty printed version of the program to \*(FIfile\*(FR Output a pretty printed version of the program to \*(FIfile\*(FR
(default: \*(FCawkprof.out\*(FR). (default: \*(FCawkprof.out\*(FR).
skipping to change at line 997 skipping to change at line 995
.BT .BT
.\" --- Records .\" --- Records
.ES .ES
.fi .fi
\*(CDNormally, records are separated by newline characters. \*(CDNormally, records are separated by newline characters.
Assigning values to the built-in variable \*(FCRS\*(FR Assigning values to the built-in variable \*(FCRS\*(FR
controls how records are separated. controls how records are separated.
If \*(FCRS\fP is any single character, that character separates records. If \*(FCRS\fP is any single character, that character separates records.
\*(CLOtherwise, \*(FCRS\fP is a regular expression. \*(CLOtherwise, \*(FCRS\fP is a regular expression.
\*(CR(Not \*(NK.)\*(CL
Text in the input that matches this Text in the input that matches this
regular expression separates the record. regular expression separates the record.
\*(CB\*(GK sets \*(FCRT\*(FR to the value of the \*(CB\*(GK sets \*(FCRT\*(FR to the value of the
input text that matched the regular expression. input text that matched the regular expression.
The value of \*(FCIGNORECASE\fP The value of \*(FCIGNORECASE\fP
also affects how records are separated when also affects how records are separated when
\*(FCRS\fP is a regular expression.\*(CD \*(FCRS\fP is a regular expression.\*(CD
If \*(FCRS\fP is set to the null string, If \*(FCRS\fP is set to the null string,
then records are separated by one or more empty lines. then records are separated by one or more empty lines.
When \*(FCRS\fP is set to the null string, When \*(FCRS\fP is set to the null string,
skipping to change at line 1137 skipping to change at line 1134
\*(FIr\*(FC+\*(FR~one or more occurrences of \*(FIr\*(FR \*(FIr\*(FC+\*(FR~one or more occurrences of \*(FIr\*(FR
\*(FIr\*(FC?\*(FR~zero or one occurrences of \*(FIr\*(FR \*(FIr\*(FC?\*(FR~zero or one occurrences of \*(FIr\*(FR
\*(FIr\*(FC{\*(FIn\*(FC,\*(FIm\*(FC}\*(FR~\*(FIn\fP to \*(FIm\fP occurrences of \*(FIr\*(FR \*(CR(POSIX: see note below)\*(CD \*(FIr\*(FC{\*(FIn\*(FC,\*(FIm\*(FC}\*(FR~\*(FIn\fP to \*(FIm\fP occurrences of \*(FIr\*(FR \*(CR(POSIX: see note below)\*(CD
\*(FIr1\*(FC|\|\*(FIr2\*(FR~\*(FIr1\*(FR or \*(FIr2\*(FR \*(FIr1\*(FC|\|\*(FIr2\*(FR~\*(FIr1\*(FR or \*(FIr2\*(FR
.TE .TE
.sp .5 .sp .5
.fi .fi
The \*(FIr\*(FC{\*(FIn\*(FC,\*(FIm\*(FC}\*(FR notation is called an The \*(FIr\*(FC{\*(FIn\*(FC,\*(FIm\*(FC}\*(FR notation is called an
\*(FIinterval expression\fP. \*(FIinterval expression\fP.
\*(CRNot supported by \*(CRNot supported by
\*(MK or \*(NK.\*(CX \*(MK.\*(CX
.sp .5 .sp .5
\*(CDIn regular expressions, within character ranges \*(CDIn regular expressions, within character ranges
(\*(FC[\*(FR...\*(FC]\*(FR), (\*(FC[\*(FR...\*(FC]\*(FR),
the notation \*(FC[[:\*(FIclass\*(FC:]]\*(FR defines character classes\*(CD: the notation \*(FC[[:\*(FIclass\*(FC:]]\*(FR defines character classes\*(CD:
.sp .5 .sp .5
.TS .TS
center, tab(~); center, tab(~);
lp8 lp8 lp8 lp8. lp8 lp8 lp8 lp8.
\*(FCalnum\*(FR~alphanumeric~\*(FClower\*(FR~lowercase \*(FCalnum\*(FR~alphanumeric~\*(FClower\*(FR~lowercase
\*(FCalpha\*(FR~alphabetic~\*(FCprint\*(FR~printable \*(FCalpha\*(FR~alphabetic~\*(FCprint\*(FR~printable
skipping to change at line 1164 skipping to change at line 1161
.EB "\s+2\f(HBREGULAR EXPRESSIONS\*(FR\s0" .EB "\s+2\f(HBREGULAR EXPRESSIONS\*(FR\s0"
.\" --- Environment Variables .\" --- Environment Variables
.ES .ES
.fi .fi
\*(CDThe environment variable \*(FCAWKPATH\fP specifies a search path to use \*(CDThe environment variable \*(FCAWKPATH\fP specifies a search path to use
when finding source files named with the \*(FC\-f\fP and \*(FC\-i\fP when finding source files named with the \*(FC\-f\fP and \*(FC\-i\fP
options. options.
The default path is The default path is
\*(FC".:/usr/local/share/awk"\*(FR. \*(FC".:/usr/local/share/awk"\*(FR.
.\" if this variable does not exist.
.\" (The actual directory may vary,
.\" depending upon how \*(GK was built and installed.)
If a source file name contains a ``/'' character, If a source file name contains a ``/'' character,
no path search is performed. no path search is performed.
.sp .5 .sp .5
The variable \*(FCAWKLIBPATH\fP The variable \*(FCAWKLIBPATH\fP
specifies the search path for dynamic extensions to use specifies the search path for dynamic extensions to use
with \*(FC@load\fP and the \*(FC\-l\fP option. with \*(FC@load\fP and the \*(FC\-l\fP option.
.sp .5 .sp .5
For socket communication, For socket communication,
\*(FCGAWK_SOCK_RETRIES\fP \*(FCGAWK_SOCK_RETRIES\fP
controls the number of connection retries, and controls the number of connection retries, and
skipping to change at line 1188 skipping to change at line 1182
the interval between retries. the interval between retries.
The interval is in milliseconds. On systems that do not support The interval is in milliseconds. On systems that do not support
\*(FIusleep\fP(3), \*(FIusleep\fP(3),
the value is rounded up to an integral number of seconds. the value is rounded up to an integral number of seconds.
.sp .5 .sp .5
The value of \*(FCGAWK_READ_TIMEOUT\fP specifies the time, in milliseconds, The value of \*(FCGAWK_READ_TIMEOUT\fP specifies the time, in milliseconds,
for \*(GK to for \*(GK to
wait for input before returning with an error. wait for input before returning with an error.
.sp .5 .sp .5
If \*(FCPOSIXLY_CORRECT\fP exists If \*(FCPOSIXLY_CORRECT\fP exists
.\" in the environment,
then \*(GK then \*(GK
behaves exactly as if the \*(FC\-\^\-posix\fP option had been given.\*(CB behaves exactly as if the \*(FC\-\^\-posix\fP option had been given.\*(CB
.EB "\s+2\f(HBENVIRONMENT VARIABLES (\*(GK\f(HB)\*(FR\s0" .EB "\s+2\f(HBENVIRONMENT VARIABLES (\*(GK\f(HB)\*(FR\s0"
.BT .BT
.\" --- Localization .\" --- Localization
.ES .ES
.fi .fi
\*(CDThere are several steps involved in producing and running a localizable \*(CDThere are several steps involved in producing and running a localizable
\*(AK program. \*(AK program.
skipping to change at line 1335 skipping to change at line 1328
set \*(FCNF\*(FR, \*(FCNR\*(FR, \*(FCFNR\*(FR. set \*(FCNF\*(FR, \*(FCNR\*(FR, \*(FCFNR\*(FR.
T} T}
\*(FCgetline < \*(FIfile\*(FR Set \*(FC$0\fP from next record of \*(FIfile\*(FR ; set \*(FCNF\*(FR. \*(FCgetline < \*(FIfile\*(FR Set \*(FC$0\fP from next record of \*(FIfile\*(FR ; set \*(FCNF\*(FR.
\*(FCgetline \*(FIv\*(FR T{ \*(FCgetline \*(FIv\*(FR T{
Set \*(FIv\fP from next input record; Set \*(FIv\fP from next input record;
set \*(FCNR\*(FR, \*(FCFNR\*(FR. set \*(FCNR\*(FR, \*(FCFNR\*(FR.
T} T}
\*(FCgetline \*(FIv \*(FC< \*(FIfile\*(FR Set \*(FIv\fP from next record of \*(FIfile\*(FR. \*(FCgetline \*(FIv \*(FC< \*(FIfile\*(FR Set \*(FIv\fP from next record of \*(FIfile\*(FR.
\*(FIcmd \*(FC| getline\*(FR Pipe into \*(FCgetline\*(FR; set \*(FC$0\*(FR, \* (FCNF\*(FR. \*(FIcmd \*(FC| getline\*(FR Pipe into \*(FCgetline\*(FR; set \*(FC$0\*(FR, \* (FCNF\*(FR.
\*(FIcmd \*(FC| getline \*(FIv\*(FR Pipe into \*(FCgetline\*(FR; set \*(FIv\* (FR. \*(FIcmd \*(FC| getline \*(FIv\*(FR Pipe into \*(FCgetline\*(FR; set \*(FIv\* (FR.
.\" \*(CB\*(FIcmd \*(FC|& getline\*(FR Coprocess pipe into \*(FCgetline\*(FR; se t \*(FC$0\*(FR, \*(FCNF\*(FR.
.TE .TE
.fi .fi
.in +.2i .in +.2i
.ti -.2i .ti -.2i
\*(CB\*(FIcmd \*(FC|& getline\*(FR \*(CB\*(FIcmd \*(FC|& getline\*(FR
.br .br
Coprocess pipe into \*(FCgetline\*(FR; set \*(FC$0\*(FR, \*(FCNF\*(FR. Coprocess pipe into \*(FCgetline\*(FR; set \*(FC$0\*(FR, \*(FCNF\*(FR.
.br .br
.ti -.2i .ti -.2i
\*(FIcmd \*(FC|& getline \*(FIv\*(FR \*(FIcmd \*(FC|& getline \*(FIv\*(FR
skipping to change at line 1470 skipping to change at line 1462
.\" --- Printf Formats .\" --- Printf Formats
.ES .ES
.fi .fi
\*(CDThe \*(FCprintf\fP statement and \*(CDThe \*(FCprintf\fP statement and
\*(FCsprintf()\fP function \*(FCsprintf()\fP function
accept the following conversion specification formats: accept the following conversion specification formats:
.sp .5 .sp .5
.nf .nf
\*(CB\*(FC%a\fP, \*(FC%A\fP A C99 floating point hexadecimal number.\*(CD \*(CB\*(FC%a\fP, \*(FC%A\fP A C99 floating point hexadecimal number.\*(CD
\*(FC%c\fP An \s-1ASCII\s+1 character. \*(FC%c\fP A single character.
\*(FC%d\fP, \*(FC%i\fP A decimal number (the integer part). \*(FC%d\fP, \*(FC%i\fP A decimal number (the integer part).
\*(FC%e\fP A floating point number of the form \*(FC%e\fP A floating point number of the form
\*(FC[\-]d.dddddde[+\^\-]dd\*(FR. \*(FC[\-]d.dddddde[+\^\-]dd\*(FR.
\*(FC%E\fP Like \*(FC%e\fP, but use \*(FCE\fP instead of \*(FCe\*(FR . \*(FC%E\fP Like \*(FC%e\fP, but use \*(FCE\fP instead of \*(FCe\*(FR .
\*(FC%f\fP A floating point number of the form \*(FC%f\fP A floating point number of the form
\*(FC[\-]ddd.dddddd\*(FR. \*(FC[\-]ddd.dddddd\*(FR.
\*(FC%F\fP Like \*(FC%f\fP, but use capital letters for infinity and \*(FC%F\fP Like \*(FC%f\fP, but use capital letters for infinity and
not-a-number values. not-a-number values.
\*(FC%g\fP Use \*(FC%e\fP or \*(FC%f\fP, whichever is shorter, with \*(FC%g\fP Use \*(FC%e\fP or \*(FC%f\fP, whichever is shorter, with
nonsignificant zeros suppressed. nonsignificant zeros suppressed.
skipping to change at line 1918 skipping to change at line 1910
.sp .6 .sp .6
.\" --- Extensions .\" --- Extensions
.ES .ES
.fi .fi
.in +.2i .in +.2i
.ti -.2i .ti -.2i
\*(CD\*(FC@load "\*(FIextension\*(FC"\*(FR \*(CD\*(FC@load "\*(FIextension\*(FC"\*(FR
.br .br
Dynamically load the named \*(FIextension\*(FR. Dynamically load the named \*(FIextension\*(FR.
This adds new built-in functions to \*(GK. This adds new built-in functions to \*(GK.
.\" The extension should use the API defined by the
.\" \*(FCgawkapi.h\*(FR header file, as documented in
.\" the full manual.
The extension is loaded during the parsing of the program. The extension is loaded during the parsing of the program.
See the manual for details.\*(CB See the manual for details.\*(CB
.in -.2i .in -.2i
.EB "\s+2\f(HBDYNAMIC EXTENSIONS (\*(GK\f(HB)\*(FR\s0" .EB "\s+2\f(HBDYNAMIC EXTENSIONS (\*(GK\f(HB)\*(FR\s0"
.BT .BT
.\" --- Type Functions .\" --- Type Functions
.ES .ES
.fi .fi
.in +.2i .in +.2i
skipping to change at line 1995 skipping to change at line 1984
one of the known locale categories. one of the known locale categories.
You must also supply a text domain. Use \*(FCTEXTDOMAIN\*(FR You must also supply a text domain. Use \*(FCTEXTDOMAIN\*(FR
to use the current domain.\*(CB to use the current domain.\*(CB
.in -.2i .in -.2i
.EB "\s+2\f(HBINTERNATIONALIZATION (\*(GK\f(HB)\*(FR\s0" .EB "\s+2\f(HBINTERNATIONALIZATION (\*(GK\f(HB)\*(FR\s0"
.sp .5 .sp .5
.\" --- FTP/HTTP/GIT Information .\" --- FTP/HTTP/GIT Information
.ES .ES
.nf .nf
\*(CDHost: \*(FCftp.gnu.org\*(FR \*(CDHost: \*(FCftp.gnu.org\*(FR
File: \*(FC/gnu/gawk/gawk-5.0.1:tar.gz\fP File: \*(FC/gnu/gawk/gawk-5.1.0.tar.gz\fP
.in +.2i .in +.2i
.fi .fi
GNU \*(AK (\*(GK). There may be a later version. GNU \*(AK (\*(GK). There may be a later version.
.in -.2i .in -.2i
.nf .nf
.sp .4 .sp .4
.\" http://www.cs.princeton.edu/~bwk/btl.mirror/
.\" awk.tar.gz
.\" .br
\*(FCgit clone git://github.com/onetrueawk/awk\fP \*(FCgit clone git://github.com/onetrueawk/awk\fP
.in +.2i .in +.2i
.fi .fi
\*(NK. This version requires an ANSI C compiler; \*(NK. This version requires an ANSI C compiler;
GCC (the GNU Compiler Collection) works well. GCC (the GNU Compiler Collection) works well.
.in -.2i .in -.2i
.nf .nf
.sp .4 .sp .4
Host: \*(FCinvisible-island.net\*(FR Host: \*(FCinvisible-island.net\*(FR
File: \*(FC/mawk/mawk.tar.gz\fP File: \*(FC/mawk/mawk.tar.gz\fP
skipping to change at line 2026 skipping to change at line 2012
.fi .fi
Michael Brennan's \*(MK. Thomas Dickey now Michael Brennan's \*(MK. Thomas Dickey now
maintains it.\*(CX maintains it.\*(CX
.in -.2i .in -.2i
.EB "\s+2\f(HBFTP/HTTP/GIT INFORMATION\*(FR\s0" .EB "\s+2\f(HBFTP/HTTP/GIT INFORMATION\*(FR\s0"
.sp .5 .sp .5
.\" --- Copying Permissions .\" --- Copying Permissions
.ES .ES
.fi .fi
\*(CDCopyright \(co 1996\(en2005, \*(CDCopyright \(co 1996\(en2005,
2007, 2009\(en2019 Free Software Foundation, Inc. 2007, 2009\(en2020 Free Software Foundation, Inc.
.sp .5 .sp .5
Permission is granted to make and distribute verbatim copies of this Permission is granted to make and distribute verbatim copies of this
reference card provided the copyright notice and this permission notice reference card provided the copyright notice and this permission notice
are preserved on all copies. are preserved on all copies.
.sp .5 .sp .5
Permission is granted to copy and distribute modified versions of this Permission is granted to copy and distribute modified versions of this
reference card under the conditions for verbatim copying, provided that reference card under the conditions for verbatim copying, provided that
the entire resulting derived work is distributed under the terms of a the entire resulting derived work is distributed under the terms of a
permission notice identical to this one. permission notice identical to this one.
.sp .5 .sp .5
 End of changes. 14 change blocks. 
25 lines changed or deleted 11 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)