aboutsummaryrefslogtreecommitdiffstats
path: root/doc/awkcard.in
diff options
context:
space:
mode:
Diffstat (limited to 'doc/awkcard.in')
-rw-r--r--doc/awkcard.in43
1 files changed, 27 insertions, 16 deletions
diff --git a/doc/awkcard.in b/doc/awkcard.in
index 7d55d977..30591403 100644
--- a/doc/awkcard.in
+++ b/doc/awkcard.in
@@ -1,7 +1,7 @@
.\" AWK Reference Card --- Arnold Robbins, arnold@skeeve.com
.\"
.\" Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002,
-.\" 2003, 2004, 2005 Free Software Foundation, Inc.
+.\" 2003, 2004, 2005, 2007 Free Software Foundation, Inc.
.\"
.\" Permission is granted to make and distribute verbatim copies of
.\" this reference card provided the copyright notice and this permission
@@ -100,8 +100,8 @@ Brian Kernighan and Michael Brennan who reviewed it.
\*(CD
.SL
.nf
-\*(FRCopyright \(co 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004
-Free Software Foundation, Inc.
+\*(FRCopyright \(co 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
+2005, 2007 Free Software Foundation, Inc.
.nf
.BT
@@ -223,11 +223,10 @@ mail to \*(FCbug-gawk@gnu.org\*(FR.\*(CX
.\" --- Command Line Arguments (gawk)
.ES
.fi
-\*(CDThe following options are specific to \*(GK.
-You may also use ``\*(FC\-W \*(FIoption\*(FR''
-for full POSIX compliance.
-Long options may abbreviated as long as the abbreviation
+\*(CDLong options may abbreviated as long as the abbreviation
remains unique.
+You may use ``\*(FC\-W \*(FIoption\*(FR''
+for full POSIX compliance.
.sp .5
.ig
.\" This option is left undocumented, on purpose.
@@ -355,21 +354,28 @@ T}
ls
l lw(2.2i).
\*(FC\-\^\-source '\*(FItext\*(FC'\*(FR
-%use \*(FItext\*(FR as AWK program source code.
+%T{
+use \*(FItext\*(FR as AWK program source code.
\*(FC\-\^\-version\*(FR%T{
print version information on \*(FCstdout\fP
and exit zero.
T}
+.T&
+ls
+l lw(2.2i).
+\*(FC\-\^\-use\-lc\-numeric
+%T{
+force use of the locale's decimal point character when parsing input data.
+T}
.TE
.sp .5
.fi
In compatibility mode,
any other options are flagged as invalid, but are otherwise ignored.
-In normal operation, as long as program text has been supplied, unknown
+Normally, if there is program text, unknown options
options are passed on to the AWK program in
\*(FCARGV\*(FR
-for processing. This is most useful for running AWK
-programs via the \*(FC#!\*(FR executable interpreter mechanism.\*(CB
+for processing.\*(CB
.EB "\s+2\f(HBCOMMAND LINE ARGUMENTS (\*(GK\f(HB)\*(FR\s0"
.BT
@@ -1168,7 +1174,7 @@ T}
.br
co-process pipe into \*(FCgetline\*(FR; set \*(FIv\*(FR.
.ti -.2i
-\*(FCnext\fP
+\*(CD\*(FCnext\fP
.br
stop processing the current input
record. Read next input record and
@@ -1297,6 +1303,8 @@ accept the following conversion specification formats:
\*(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[\-]ddd.dddddd\*(FR
+\*(FC%F\fP like \*(FC%f\fP, but use capital letters for infinity and
+ not-a-number values.
\*(FC%g\fP use \*(FC%e\fP or \*(FC%f\fP, whichever is shorter, with
nonsignificant zeros suppressed
\*(FC%G\fP like \*(FC%g\fP, but use \*(FC%E\fP instead of \*(FC%e\*(FR
@@ -1672,12 +1680,15 @@ stamp of the same form as returned by \*(FCsystime()\*(FR.
The \*(FIdatespec\fP is a string of the form
\*(FC"\*(FIYYYY MM DD HH MM SS[ DST]\*(FC"\*(FR.
.ti -.2i
-\*(FCstrftime(\*(FR[\*(FIformat \*(FR[\*(FC, \*(FItimestamp\*(FR]]\*(FC)\*(FR
+\*(FCstrftime(\*(FR[\*(FIformat \*(FR[\*(FC, \*(FItimestamp\*(FR[\*(FC, \*(FIutc-flag\*(FR]]]\*(FC)\*(FR
.br
formats \*(FItimestamp\fP
according to the specification in \*(FIformat\*(FR. The
\*(FItimestamp\fP should be of the same form as returned by
\*(FCsystime()\*(FR.
+If \*(FIutc-flag\*(FR
+is present and is non-zero or non-null, the result
+is in UTC, otherwise the result is in local time.
If \*(FItimestamp\fP is missing, the current time of day is used. If
\*(FIformat\fP is missing, a default format equivalent to the output
of \*(FIdate\*(FR(1) is used.
@@ -1902,7 +1913,7 @@ to use the current domain.\*(CB
.ES
.nf
\*(CDHost: \*(FCftp.gnu.org\*(FR
-File: \*(FC/gnu/gawk/gawk-3.1.5.tar.gz\fP
+File: \*(FC/gnu/gawk/gawk-3.1.6.tar.gz\fP
.in +.2i
.fi
GNU \*(AK (\*(GK). There may be a later version.
@@ -1929,8 +1940,8 @@ Michael Brennan's \*(MK. There may be a newer version.\*(CX
.\" --- Copying Permissions
.ES
.fi
-\*(CDCopyright \(co 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005
-Free Software Foundation, Inc.
+\*(CDCopyright \(co 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005,
+2007 Free Software Foundation, Inc.
.sp .5
Permission is granted to make and distribute verbatim copies of this
reference card provided the copyright notice and this permission notice