diff options
Diffstat (limited to '')
-rw-r--r-- | templates/man1/gawk.1.pot | 4302 |
1 files changed, 4302 insertions, 0 deletions
diff --git a/templates/man1/gawk.1.pot b/templates/man1/gawk.1.pot new file mode 100644 index 00000000..f448f83d --- /dev/null +++ b/templates/man1/gawk.1.pot @@ -0,0 +1,4302 @@ +# SOME DESCRIPTIVE TITLE +# Copyright (C) YEAR Free Software Foundation, Inc. +# This file is distributed under the same license as the PACKAGE package. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"POT-Creation-Date: 2024-03-09 15:35+0100\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <LL@li.org>\n" +"Language: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. type: ds PX +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "\\s-1POSIX\\s+1" +msgstr "" + +#. type: ds UX +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "\\s-1UNIX\\s+1" +msgstr "" + +#. type: ds GN +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "\\s-1GNU\\s+1" +msgstr "" + +#. type: ds AK +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "\\s-1AWK\\s+1" +msgstr "" + +#. type: ds EP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "I<GAWK: Effective AWK Programming>" +msgstr "" + +#. type: TH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "GAWK" +msgstr "" + +#. type: TH +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "Nov 02 2023" +msgstr "" + +#. type: TH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "Free Software Foundation" +msgstr "" + +#. type: TH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "Utility Commands" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "NAME" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "gawk - pattern scanning and processing language" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "SYNOPSIS" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"B<gawk> [ \\*(PX or \\*(GN style options ] B<-f> I<program-file> [ B<-\\^-" +"> ] file .\\|.\\|." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"B<gawk> [ \\*(PX or \\*(GN style options ] [ B<-\\^-> ] I<program-text> " +"file .\\|.\\|." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "DESCRIPTION" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"I<Gawk> is the \\*(GN Project's implementation of the \\*(AK programming " +"language. It conforms to the definition of the language in the \\*(PX " +"1003.1 standard. This version in turn is based on the description in I<The " +"AWK Programming Language>, by Aho, Kernighan, and Weinberger. I<Gawk> " +"provides the additional features found in the current version of Brian " +"Kernighan's I<awk> and numerous \\*(GN-specific extensions." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"The command line consists of options to I<gawk> itself, the \\*(AK program " +"text (if not supplied via the B<-f> or B<-\\^-include> options), and values " +"to be made available in the B<ARGC> and B<ARGV> pre-defined \\*(AK variables." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "PREFACE" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"This manual page is intentionally as terse as possible. Full details are " +"provided in \\*(EP, and you should look there for the full story on any " +"specific feature. Where possible, links to the online version of the manual " +"are provided." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "OPTION FORMAT" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"I<Gawk> options may be either traditional \\*(PX-style one letter options, " +"or \\*(GN-style long options. \\*(PX options start with a single ``-'', " +"while long options start with ``-\\^-''. Long options are provided for both " +"\\*(GN-specific features and for \\*(PX-mandated features." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"I<Gawk>-specific options are typically used in long-option form. Arguments " +"to long options are either joined with the option by an B<=> sign, with no " +"intervening spaces, or they may be provided in the next command line " +"argument. Long options may be abbreviated, as long as the abbreviation " +"remains unique." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Additionally, every long option has a corresponding short option, so that " +"the option's functionality may be used from within B<#!> executable scripts." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "OPTIONS" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"I<Gawk> accepts the following options. Standard options are listed first, " +"followed by options for I<gawk> extensions, listed alphabetically by short " +"option." +msgstr "" + +#. type: TP +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<-f>I< program-file>,I< >B<-\\^-file>I< program-file>" +msgstr "" + +#. type: Plain text +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +msgid "" +"Read the \\*(AK program source from the file I<program-file>, instead of " +"from the first command line argument. Multiple B<-f> options may be used. " +"Files read with B<-f> are treated as if they begin with an implicit " +"B<@namespace \"awk\"> statement." +msgstr "" + +#. type: TP +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<-F>I< fs>, B<-\\^-field-separator>I< fs>" +msgstr "" + +#. type: Plain text +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +msgid "" +"Use I<fs> for the input field separator (the value of the B<FS> predefined " +"variable)." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<-v>I< var>B<\\^=\\^>I<val>, B<-\\^-assign >I<var>B<\\^=\\^>I<val>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Assign the value I<val> to the variable I<var>, before execution of the " +"program begins. Such variable values are available to the B<BEGIN> rule of " +"an \\*(AK program." +msgstr "" + +#. type: TP +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<-b>, B<-\\^-characters-as-bytes>" +msgstr "" + +#. type: Plain text +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +msgid "" +"Treat all input data as single-byte characters. The B<-\\^-posix> option " +"overrides this one." +msgstr "" + +#. type: TP +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<-c>, B<-\\^-traditional>" +msgstr "" + +#. type: Plain text +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +msgid "" +"Run in I<compatibility> mode. In compatibility mode, I<gawk> behaves " +"identically to Brian Kernighan's I<awk>; none of the \\*(GN-specific " +"extensions are recognized." +msgstr "" + +#. type: TP +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<-C>, B<-\\^-copyright>" +msgstr "" + +#. type: Plain text +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +msgid "" +"Print the short version of the \\*(GN copyright information message on the " +"standard output and exit successfully." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<-d>[I<file>], B<-\\^-dump-variables>[B<=>I<file>]" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Print a sorted list of global variables, their types and final values to " +"I<file>. The default file is B<awkvars.out> in the current directory." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<-D>[I<file>], B<-\\^-debug>[B<=>I<file>]" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Enable debugging of \\*(AK programs. By default, the debugger reads " +"commands interactively from the keyboard (standard input). The optional " +"I<file> argument specifies a file with a list of commands for the debugger " +"to execute non-interactively." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"In this mode of execution, I<gawk> loads the AWK source code and then " +"prompts for debugging commands. I<Gawk> can only debug AWK program source " +"provided with the B<-f> and B<-\\^-include> options. The debugger is " +"documented in \\*(EP; see I<https://www.gnu.org/software/gawk/manual/" +"html_node/Debugger.html#Debugger>." +msgstr "" + +#. type: TP +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<-e>I< program-text>, B<-\\^-source>I< program-text>" +msgstr "" + +#. type: Plain text +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +msgid "" +"Use I<program-text> as \\*(AK program source code. Each argument supplied " +"via B<-e> is treated as if it begins with an implicit B<@namespace \"awk\"> " +"statement." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<-E >I<file>, B<-\\^-exec >I<file>" +msgstr "" + +#. type: Plain text +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +msgid "" +"Similar to B<-f>, however, this option is the last one processed. This " +"should be used with B<#!> scripts, particularly for CGI applications, to " +"avoid passing in options or source code (!) on the command line from a URL. " +"This option disables command-line variable assignments." +msgstr "" + +#. type: TP +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<-g>, B<-\\^-gen-pot>" +msgstr "" + +#. type: Plain text +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +msgid "" +"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." +msgstr "" + +#. type: TP +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<-h>, B<-\\^-help>" +msgstr "" + +#. type: Plain text +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +msgid "" +"Print a relatively short summary of the available options on the standard " +"output. Per the I<GNU Coding Standards>, these options cause an immediate, " +"successful exit." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<-i >I<include-file>, B<-\\^-include >I<include-file>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Load an awk source library. This searches for the library using the " +"B<AWKPATH> environment variable. If the initial search fails, another " +"attempt will be made after appending the B<\\&.awk> suffix. The file will " +"be loaded only once (i.e., duplicates are eliminated), and the code does not " +"constitute the main program source. Files read with B<-\\^-include> are " +"treated as if they begin with an implicit B<@namespace \"awk\"> statement." +msgstr "" + +#. type: TP +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<-I>, B<-\\^-trace>" +msgstr "" + +#. type: Plain text +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +msgid "" +"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." +msgstr "" + +#. type: TP +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<-k>, B<-\\^-csv>" +msgstr "" + +#. type: Plain text +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +msgid "" +"Enable CSV special processing. See B<Comma Separated Values>, below, for " +"more detail." +msgstr "" + +#. type: TP +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<-l>I< lib>, B<-\\^-load>I< lib>" +msgstr "" + +#. type: Plain text +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +msgid "" +"Load a I<gawk> extension from the shared library I<lib>. This searches for " +"the library using the B<AWKLIBPATH> environment variable. If the initial " +"search fails, another attempt will be made after appending the default " +"shared library suffix for the platform. The library initialization routine " +"is expected to be named B<dl_load()>." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<-L >[I<value>], B<-\\^-lint>[B<=>I<value>]" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Provide warnings about constructs that are dubious or non-portable to other " +"\\*(AK implementations. See I<https://www.gnu.org/software/gawk/manual/" +"html_node/Options.html#Options> for the list of possible values for I<value>." +msgstr "" + +#. type: TP +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<-M>, B<-\\^-bignum>" +msgstr "" + +#. type: Plain text +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +msgid "" +"Force arbitrary precision arithmetic on numbers. This option has no effect " +"if I<gawk> is not compiled to use the GNU MPFR and GMP libraries. (In such " +"a case, I<gawk> issues a warning.)" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"B<NOTE:> This feature is I<on parole>. The primary I<gawk> maintainer is no " +"longer supporting it, although there is a member of the development team who " +"is. If this situation changes, the feature will be removed from I<gawk>." +msgstr "" + +#. type: TP +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<-n>, B<-\\^-non-decimal-data>" +msgstr "" + +#. type: Plain text +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +msgid "" +"Recognize octal and hexadecimal values in input data. I<Use this option " +"with great caution!>" +msgstr "" + +#. type: TP +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<-N>, B<-\\^-use-lc-numeric>" +msgstr "" + +#. type: Plain text +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +msgid "" +"Force I<gawk> to use the locale's decimal point character when parsing input " +"data." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<-o>[I<file>], B<-\\^-pretty-print>[B<=>I<file>]" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Output a pretty printed version of the program to I<file>. The default file " +"is B<awkprof.out> in the current directory. This option implies B<-\\^-no-" +"optimize>." +msgstr "" + +#. type: TP +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<-O>, B<-\\^-optimize>" +msgstr "" + +#. type: Plain text +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +msgid "" +"Enable I<gawk>'s default optimizations upon the internal representation of " +"the program. This option is on by default." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<-p>[I<prof-file>], B<-\\^-profile>[B<=>I<prof-file>]" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Start a profiling session, and send the profiling data to I<prof-file>. The " +"default is B<awkprof.out> in the current directory. The profile contains " +"execution counts of each statement in the program in the left margin and " +"function call counts for each user-defined function. I<Gawk> runs more " +"slowly in this mode. This option implies B<-\\^-no-optimize>." +msgstr "" + +#. type: TP +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<-P>, B<-\\^-posix>" +msgstr "" + +#. type: Plain text +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +msgid "" +"This turns on I<compatibility> mode, and disables a number of common " +"extensions." +msgstr "" + +#. type: TP +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<-r>, B<-\\^-re-interval>" +msgstr "" + +#. type: Plain text +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +msgid "" +"Enable the use of I<interval expressions> in regular expression matching. " +"Interval expressions are enabled by default, but this option remains for " +"backwards compatibility." +msgstr "" + +#. type: TP +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<-s>, B<-\\^-no-optimize>" +msgstr "" + +#. type: Plain text +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +msgid "" +"Disable I<gawk>'s default optimizations upon the internal representation of " +"the program." +msgstr "" + +#. type: TP +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<-S>, B<-\\^-sandbox>" +msgstr "" + +#. type: Plain text +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +msgid "" +"Run I<gawk> in sandbox mode, disabling the B<system()> function, input " +"redirection with B<getline>, output redirection with B<print> and B<printf>, " +"and loading dynamic extensions. Command execution (through pipelines) is " +"also disabled." +msgstr "" + +#. type: TP +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<-t>, B<-\\^-lint-old>" +msgstr "" + +#. type: Plain text +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +msgid "" +"Provide warnings about constructs that are not portable to the original " +"version of \\*(UX I<awk>." +msgstr "" + +#. type: TP +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<-V>, B<-\\^-version>" +msgstr "" + +#. type: Plain text +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +msgid "" +"Print version information for this particular copy of I<gawk> on the " +"standard output. This is useful when reporting bugs. Per the I<GNU Coding " +"Standards>, these options cause an immediate, successful exit." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<-\\^->" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Signal the end of options. This is useful to allow further arguments to the " +"\\*(AK program itself to start with a ``-''." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"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 options are passed on to the \\*(AK program in the B<ARGV> " +"array for processing." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"For \\*(PX compatibility, the B<-W> option may be used, followed by the name " +"of a long option." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "AWK PROGRAM EXECUTION" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"An \\*(AK program consists of a sequence of optional directives, pattern-" +"action statements, and optional function definitions." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "B<@include \">I<filename\\^>B<\">" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "B<@load \">I<filename\\^>B<\">" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "B<@namespace \">I<name\\^>B<\">" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "I<pattern>B<\t{ >I<action statements>B< }>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "B<function >I<name>B<(>I<parameter list>B<) { >I<statements>B< }>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"I<Gawk> first reads the program source from the I<program-file>(s) if " +"specified, from arguments to B<-\\^-source>, or from the first non-option " +"argument on the command line. The B<-f> and B<-\\^-source> options may be " +"used multiple times on the command line. I<Gawk> reads the program text as " +"if all the I<program-file>s and command line source texts had been " +"concatenated together." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"In addition, lines beginning with B<@include> may be used to include other " +"source files into your program. This is equivalent to using the B<-\\^-" +"include> option." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Lines beginning with B<@load> may be used to load extension functions into " +"your program. This is equivalent to using the B<-\\^-load> option." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"The environment variable B<AWKPATH> specifies a search path to use when " +"finding source files named with the B<-f> and B<-\\^-include> options. If " +"this variable does not exist, the default path is B<\".:/usr/local/share/" +"awk\">. (The actual directory may vary, depending upon how I<gawk> was " +"built and installed.) If a file name given to the B<-f> option contains a " +"``/'' character, no path search is performed." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"The environment variable B<AWKLIBPATH> specifies a search path to use when " +"finding source files named with the B<-\\^-load> option. If this variable " +"does not exist, the default path is B<\"/usr/local/lib/gawk\">. (The actual " +"directory may vary, depending upon how I<gawk> was built and installed.)" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"I<Gawk> executes \\*(AK programs in the following order. First, all " +"variable assignments specified via the B<-v> option are performed. Next, " +"I<gawk> compiles the program into an internal form. Then, I<gawk> executes " +"the code in the B<BEGIN> rule(s) (if any), and then proceeds to read each " +"file named in the B<ARGV> array (up to B<ARGV[ARGC-1]>). If there are no " +"files named on the command line, I<gawk> reads the standard input." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"If a filename on the command line has the form I<var>B<=>I<val> it is " +"treated as a variable assignment. The variable I<var> will be assigned the " +"value I<val>. (This happens after any B<BEGIN> rule(s) have been run.)" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"If the value of a particular element of B<ARGV> is empty (B<\"\">), I<gawk> " +"skips over it." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"For each input file, if a B<BEGINFILE> rule exists, I<gawk> executes the " +"associated code before processing the contents of the file. Similarly, " +"I<gawk> executes the code associated with B<ENDFILE> rules after processing " +"the file." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"For each record in the input, I<gawk> tests to see if it matches any " +"I<pattern> in the \\*(AK program. For each pattern that the record matches, " +"I<gawk> executes the associated I<action>. The patterns are tested in the " +"order they occur in the program." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Finally, after all the input is exhausted, I<gawk> executes the code in the " +"B<END> rule(s) (if any)." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "Command Line Directories" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"According to POSIX, files named on the I<awk> command line must be text " +"files. The behavior is ``undefined'' if they are not. Most versions of " +"I<awk> treat a directory on the command line as a fatal error." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"For I<gawk>, a directory on the command line produces a warning, but is " +"otherwise skipped. If either of the B<-\\^-posix> or B<-\\^-traditional> " +"options is given, then I<gawk> reverts to treating directories on the " +"command line as a fatal error." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "VARIABLES, RECORDS AND FIELDS" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"\\*(AK variables are dynamic; they come into existence when they are first " +"used. Their values are either floating-point numbers or strings, or both, " +"depending upon how they are used. Additionally, I<gawk> allows variables to " +"have regular-expression type. \\*(AK also has one dimensional arrays; " +"arrays with multiple dimensions may be simulated. However, I<gawk> provides " +"true arrays of arrays. Several pre-defined variables are set as a program " +"runs; these are described as needed and summarized below." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "Records" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Normally, records are separated by newline characters. You can control how " +"records are separated by assigning values to the built-in variable B<RS>. " +"See I<https://www.gnu.org/software/gawk/manual/html_node/Records.html> for " +"the details." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "Fields" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"As each input record is read, I<gawk> splits the record into I<fields>, " +"using the value of the B<FS> variable as the field separator. Additionally, " +"B<FIELDWIDTHS> and B<FPAT> may be used to control input field splitting. " +"See the details, starting at I<https://www.gnu.org/software/gawk/manual/" +"html_node/Fields.html>." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Each field in the input record may be referenced by its position: B<$1>, " +"B<$2>, and so on. B<$0> is the whole record, including leading and trailing " +"whitespace." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"The variable B<NF> is set to the total number of fields in the input record." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"References to non-existent fields (i.e., fields after B<$NF>) produce the " +"null string. However, assigning to a non-existent field (e.g., B<$(NF+2) = " +"5>) increases the value of B<NF>, creates any intervening fields with the " +"null string as their values, and causes the value of B<$0> to be recomputed, " +"with the fields being separated by the value of B<OFS>. References to " +"negative numbered fields cause a fatal error. Decrementing B<NF> causes the " +"values of fields past the new value to be lost, and the value of B<$0> to be " +"recomputed, with the fields being separated by the value of B<OFS>." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Assigning a value to an existing field causes the whole record to be rebuilt " +"when B<$0> is referenced. Similarly, assigning a value to B<$0> causes the " +"record to be resplit, creating new values for the fields." +msgstr "" + +#. type: SS +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "Comma Separated Values" +msgstr "" + +#. type: Plain text +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +msgid "" +"When invoked with ether the B<-k> or the B<-\\^-csv> option, I<gawk> does " +"not use regular record determination and field splitting as described " +"above. Instead, records are terminated by unquoted newlines, and fields are " +"separated by commas. Double-quotes may be used to enclose fields containing " +"commas, newlines, or doubled double-quotes. See I<https://www.gnu.org/" +"software/gawk/manual/html_node/Comma-Separated-Fields.html> for more details." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "Built-in Variables" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"I<Gawk\\^>'s built-in variables are listed below. This list is purposely " +"terse. For details, see I<https://www.gnu.org/software/gawk/manual/html_node/" +"Built_002din-Variables>." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<ARGC>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "The number of command line arguments." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<ARGIND>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "The index in B<ARGV> of the current file being processed." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<ARGV>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Array of command line arguments. The array is indexed from 0 to B<ARGC> - 1." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<BINMODE>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"On non-POSIX systems, specifies use of ``binary'' mode for all file I/O. " +"See I<https://www.gnu.org/software/gawk/manual/html_node/PC-Using.html> for " +"the details." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<CONVFMT>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "The conversion format for numbers, B<\"%.6g\">, by default." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<ENVIRON>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"An array containing the values of the current environment. The array is " +"indexed by the environment variables, each element being the value of that " +"variable." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<ERRNO>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"If a system error occurs either doing a redirection for B<getline>, during a " +"read for B<getline>, or during a B<close()>, then B<ERRNO> is set to a " +"string describing the error. The value is subject to translation in non-" +"English locales." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<FIELDWIDTHS>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"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." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<FILENAME>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"The name of the current input file. If no files are specified on the " +"command line, the value of B<FILENAME> is ``-''. However, B<FILENAME> is " +"undefined inside the B<BEGIN> rule (unless set by B<getline>)." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<FNR>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "The input record number in the current input file." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<FPAT>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"A regular expression describing the contents of the fields in a record. " +"When set, I<gawk> parses the input into fields, where the fields match the " +"regular expression, instead of using the value of B<FS> as the field " +"separator." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<FS>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"The input field separator, a space by default. See I<https://www.gnu.org/" +"software/gawk/manual/html_node/Field-Separators.html> for the details." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<FUNCTAB>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"An array whose indices and corresponding values are the names of all the " +"user-defined or extension functions in the program. B<NOTE>: You may not " +"use the B<delete> statement with the B<FUNCTAB> array." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<IGNORECASE>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Controls the case-sensitivity of all regular expression and string " +"operations. See I<https://www.gnu.org/software/gawk/manual/html_node/" +"Case_002dsensitivity.html> for details." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<LINT>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Provides dynamic control of the B<-\\^-lint> option from within an \\*(AK " +"program." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<NF>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "The number of fields in the current input record." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<NR>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "The total number of input records seen so far." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<OFMT>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "The output format for numbers, B<\"%.6g\">, by default." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<OFS>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "The output field separator, a space by default." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<ORS>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "The output record separator, by default a newline." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<PREC>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"The working precision of arbitrary precision floating-point numbers, 53 by " +"default." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<PROCINFO>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"The elements of this array provide access to information about the running " +"\\*(AK program. See I<https://www.gnu.org/software/gawk/manual/html_node/" +"Auto_002dset> for the details." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<ROUNDMODE>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"The rounding mode to use for arbitrary precision arithmetic on numbers, by " +"default B<\"N\"> (IEEE-754 roundTiesToEven mode). See I<https://www.gnu.org/" +"software/gawk/manual/html_node/Setting-the-rounding-mode> for the details." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<RS>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "The input record separator, by default a newline." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<RT>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"The record terminator. I<Gawk> sets B<RT> to the input text that matched " +"the character or regular expression specified by B<RS>." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<RSTART>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "The index of the first character matched by B<match()>; 0 if no match." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<RLENGTH>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "The length of the string matched by B<match()>; -1 if no match." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<SUBSEP>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"The string used to separate multiple subscripts in array elements, by " +"default B<\"\\e034\">." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<SYMTAB>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"An array whose indices are the names of all currently defined global " +"variables and arrays in the program. You may not use the B<delete> " +"statement with the B<SYMTAB> array, nor assign to elements with an index " +"that is not a variable name." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<TEXTDOMAIN>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"The text domain of the \\*(AK program; used to find the localized " +"translations for the program's strings." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "Arrays" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Arrays are subscripted with an expression between square brackets (B<[> and " +"B<]>). If the expression is an expression list (I<expr>, I<expr> .\\|." +"\\|.) then the array subscript is a string consisting of the concatenation " +"of the (string) value of each expression, separated by the value of the " +"B<SUBSEP> variable. This facility is used to simulate multiply dimensioned " +"arrays. For example:" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "B<i = \"A\";\\^ j = \"B\";\\^ k = \"C\">" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "B<x[i, j, k] = \"hello, world\\en\">" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"assigns the string B<\"hello,\\ world\\en\"> to the element of the array " +"B<x> which is indexed by the string B<\"A\\e034B\\e034C\">. All arrays in " +"\\*(AK are associative, i.e., indexed by string values." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"The special operator B<in> may be used to test if an array has an index " +"consisting of a particular value:" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "" +"B<if (val in array)\n" +"\tprint array[val]>\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "If the array has multiple subscripts, use B<(i, j) in array>." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"The B<in> construct may also be used in a B<for> loop to iterate over all " +"the elements of an array. However, the B<(i, j) in array> construct only " +"works in tests, not in B<for> loops." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"An element may be deleted from an array using the B<delete> statement. The " +"B<delete> statement may also be used to delete the entire contents of an " +"array, just by specifying the array name without a subscript." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"I<gawk> supports true multidimensional arrays. It does not require that such " +"arrays be ``rectangular'' as in C or C++. See I<https://www.gnu.org/" +"software/gawk/manual/html_node/Arrays> for details." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "Namespaces" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"I<Gawk> provides a simple I<namespace> facility to help work around the fact " +"that all variables in AWK are global." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"A I<qualified name> consists of a two simple identifiers joined by a double " +"colon (B<::>). The left-hand identifier represents the namespace and the " +"right-hand identifier is the variable within it. All simple (non-qualified) " +"names are considered to be in the ``current'' namespace; the default " +"namespace is B<awk>. However, simple identifiers consisting solely of " +"uppercase letters are forced into the B<awk> namespace, even if the current " +"namespace is different." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"You change the current namespace with an B<@namespace \">I<name\\^>B<\"> " +"directive." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"The standard predefined builtin function names may not be used as namespace " +"names. The names of additional functions provided by I<gawk> may be used as " +"namespace names or as simple identifiers in other namespaces. For more " +"details, see I<https://www.gnu.org/software/gawk/manual/html_node/Namespaces." +"html#Namespaces>." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "Variable Typing And Conversion" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Variables and fields may be (floating point) numbers, or strings, or both. " +"They may also be regular expressions. How the value of a variable is " +"interpreted depends upon its context. If used in a numeric expression, it " +"will be treated as a number; if used as a string it will be treated as a " +"string." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"To force a variable to be treated as a number, add zero to it; to force it " +"to be treated as a string, concatenate it with the null string." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Uninitialized variables have the numeric value zero and the string value " +"\"\" (the null, or empty, string)." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"When a string must be converted to a number, the conversion is accomplished " +"using I<strtod>(3). A number is converted to a string by using the value of " +"B<CONVFMT> as a format string for I<sprintf>(3), with the numeric value of " +"the variable as the argument. However, even though all numbers in \\*(AK " +"are floating-point, integral values are I<always> converted as integers." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"I<Gawk> performs comparisons as follows: If two variables are numeric, they " +"are compared numerically. If one value is numeric and the other has a " +"string value that is a ``numeric string,'' then comparisons are also done " +"numerically. Otherwise, the numeric value is converted to a string and a " +"string comparison is performed. Two strings are compared, of course, as " +"strings." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Note that string constants, such as B<\"57\">, are I<not> numeric strings, " +"they are string constants. The idea of ``numeric string'' only applies to " +"fields, B<getline> input, B<FILENAME>, B<ARGV> elements, B<ENVIRON> elements " +"and the elements of an array created by B<split()> or B<patsplit()> that are " +"numeric strings. The basic idea is that I<user input>, and only user input, " +"that looks numeric, should be treated that way." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "Octal and Hexadecimal Constants" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"You may use C-style octal and hexadecimal constants in your AWK program " +"source code. For example, the octal value B<011> is equal to decimal B<9>, " +"and the hexadecimal value B<0x11> is equal to decimal 17." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "String Constants" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"String constants in \\*(AK are sequences of characters enclosed between " +"double quotes (like B<\"value\">). Within strings, certain I<escape " +"sequences> are recognized, as in C. See I<https://www.gnu.org/software/gawk/" +"manual/html_node/Escape-Sequences> for the details." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "Regexp Constants" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"A regular expression constant is a sequence of characters enclosed between " +"forward slashes (like B</value/>)." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"The escape sequences described in the manual may also be used inside " +"constant regular expressions (e.g., B</[\\ \\et\\ef\\en\\er\\ev]/> matches " +"whitespace characters)." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"I<Gawk> provides I<strongly typed> regular expression constants. These are " +"written with a leading B<@> symbol (like so: B<@/value/>). Such constants " +"may be assigned to scalars (variables, array elements) and passed to user-" +"defined functions. Variables that have been so assigned have regular " +"expression type." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "PATTERNS AND ACTIONS" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"\\*(AK is a line-oriented language. The pattern comes first, and then the " +"action. Action statements are enclosed in B<{> and B<}>. Either the " +"pattern may be missing, or the action may be missing, but, of course, not " +"both. If the pattern is missing, the action executes for every single " +"record of input. A missing action is equivalent to" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "B<{ print }>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "which prints the entire record." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Comments begin with the B<#> character, and continue until the end of the " +"line. Empty lines may be used to separate statements. Normally, a " +"statement ends with a newline, however, this is not the case for lines " +"ending in a comma, B<{>, B<?>, B<:>, B<&&>, or B<||>. Lines ending in B<do> " +"or B<else> also have their statements automatically continued on the " +"following line. In other cases, a line can be continued by ending it with a " +"``\\e'', in which case the newline is ignored. However, a ``\\e'' after a " +"B<#> is not special." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Multiple statements may be put on one line by separating them with a ``;''. " +"This applies to both the statements within the action part of a pattern-" +"action pair (the usual case), and to the pattern-action statements " +"themselves." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "Patterns" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "\\*(AK patterns may be one of the following:" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "" +"B<BEGIN>\n" +"B<END>\n" +"B<BEGINFILE>\n" +"B<ENDFILE>\n" +"B</>I<regular expression>B</>\n" +"I<relational expression>\n" +"I<pattern>B< && >I<pattern>\n" +"I<pattern>B< || >I<pattern>\n" +"I<pattern>B< ? >I<pattern>B< : >I<pattern>\n" +"B<(>I<pattern>B<)>\n" +"B<!>I< pattern>\n" +"I<pattern1>B<, >I<pattern2>\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"B<BEGIN> and B<END> are two special kinds of patterns which are not tested " +"against the input. The action parts of all B<BEGIN> patterns are merged as " +"if all the statements had been written in a single B<BEGIN> rule. They are " +"executed before any of the input is read. Similarly, all the B<END> rules " +"are merged, and executed when all the input is exhausted (or when an B<exit> " +"statement is executed). B<BEGIN> and B<END> patterns cannot be combined " +"with other patterns in pattern expressions. B<BEGIN> and B<END> patterns " +"cannot have missing action parts." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"B<BEGINFILE> and B<ENDFILE> are additional special patterns whose actions " +"are executed before reading the first record of each command-line input file " +"and after reading the last record of each file. Inside the B<BEGINFILE> " +"rule, the value of B<ERRNO> is the empty string if the file was opened " +"successfully. Otherwise, there is some problem with the file and the code " +"should use B<nextfile> to skip it. If that is not done, I<gawk> produces its " +"usual fatal error for files that cannot be opened." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"For B</>I<regular expression>B</> patterns, the associated statement is " +"executed for each input record that matches the regular expression. Regular " +"expressions are essentially the same as those in I<egrep>(1). See I<https://" +"www.gnu.org/software/gawk/manual/html_node/Regexp.html> for the details on " +"regular expressions." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"A I<relational expression> may use any of the operators defined below in the " +"section on actions. These generally test whether certain fields match " +"certain regular expressions." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"The B<&&>, B<||>, and B<!> operators are logical AND, logical OR, and " +"logical NOT, respectively, as in C. They do short-circuit evaluation, also " +"as in C, and are used for combining more primitive pattern expressions. As " +"in most languages, parentheses may be used to change the order of evaluation." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"The B<?\\^:> operator is like the same operator in C. If the first pattern " +"is true then the pattern used for testing is the second pattern, otherwise " +"it is the third. Only one of the second and third patterns is evaluated." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"The I<pattern1>B<, >I<pattern2> form of an expression is called a I<range " +"pattern>. It matches all input records starting with a record that matches " +"I<pattern1>, and continuing until a record that matches I<pattern2>, " +"inclusive. It does not combine with any other sort of pattern expression." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "Actions" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Action statements are enclosed in braces, B<{> and B<}>. Action statements " +"consist of the usual assignment, conditional, and looping statements found " +"in most languages. The operators, control statements, and input/output " +"statements available are patterned after those in C." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "Operators" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "The operators in \\*(AK, in order of decreasing precedence, are:" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<(>\\&.\\|.\\|.B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "Grouping" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<$>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "Field reference." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<++ -\\^->" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "Increment and decrement, both prefix and postfix." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<^>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "Exponentiation." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<+ - !>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "Unary plus, unary minus, and logical negation." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<* / %>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "Multiplication, division, and modulus." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<+ ->" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "Addition and subtraction." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "I<space>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "String concatenation." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<| |&>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "Piped I/O for B<getline>, B<print>, and B<printf>." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<E<lt> E<gt> E<lt>= E<gt>= == !=>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "The regular relational operators." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<~ !~>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "Regular expression match, negated match." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<in>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "Array membership." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<&&>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "Logical AND." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<||>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "Logical OR." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<?:>" +msgstr "" + +#. type: Plain text +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +msgid "" +"The C conditional expression. This has the form I<expr1>B< ? >I<expr2>B< : " +">I<expr3\\/>. If I<expr1> is true, the value of the expression is I<expr2>, " +"otherwise it is I<expr3>. Only one of I<expr2> and I<expr3> is evaluated." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<= += -= *= /= %= ^=>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Assignment. Both absolute assignment B<(>I<var>B< = >I<value>B<)> and " +"operator-assignment (the other forms) are supported." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "Control Statements" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "The control statements are as follows:" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "" +"B<if (>I<condition>B<) >I<statement> [ B<else>I< statement >]\n" +"B<while (>I<condition>B<) >I<statement>\n" +"B<do >I<statement >B<while (>I<condition>B<)>\n" +"B<for (>I<expr1>B<; >I<expr2>B<; >I<expr3>B<) >I<statement>\n" +"B<for (>I<var >B<in>I< array>B<) >I<statement>\n" +"B<break>\n" +"B<continue>\n" +"B<delete >I<array\\^>B<[\\^>I<index\\^>B<]>\n" +"B<delete >I<array\\^>\n" +"B<exit> [ I<expression> ]\n" +"B<{ >I<statements >B<}>\n" +"B<switch (>I<expression>B<) {\n" +"case >I<value>B<|>I<regex>B< : >I<statement\n" +"\\&.\\^.\\^.\n" +">[ B<default: >I<statement >]\n" +"B<}>\n" +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "I/O Statements" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "The input/output statements are as follows:" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<close(>I<file >[B<, >I<how>]B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Close an open file, pipe or coprocess. The optional I<how> should only be " +"used when closing one end of a two-way pipe to a coprocess. It must be a " +"string value, either B<\"to\"> or B<\"from\">." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<getline>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "Set B<$0> from the next input record; set B<NF>, B<NR>, B<FNR>, B<RT>." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<getline E<lt>>I<file>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "Set B<$0> from the next record of I<file>; set B<NF>, B<RT>." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<getline>I< var>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "Set I<var> from the next input record; set B<NR>, B<FNR>, B<RT>." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<getline>I< var>B< E<lt>>I<file>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "Set I<var> from the next record of I<file>; set B<RT>." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "I<command>B< | getline >[I<var>]" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Run I<command>, piping the output either into B<$0> or I<var>, as above, and " +"B<RT>." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "I<command>B< |& getline >[I<var>]" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Run I<command> as a coprocess piping the output either into B<$0> or I<var>, " +"as above, and B<RT>. (The I<command> can also be a socket. See the " +"subsection B<Special File Names>, below.)" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "\\&B<fflush(>[I<file\\^>]B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Flush any buffers associated with the open output file or pipe I<file>. If " +"I<file> is missing or if it is the null string, then flush all open output " +"files and pipes." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<next>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Stop processing the current input record. Read the next input record and " +"start processing over with the first pattern in the \\*(AK program. Upon " +"reaching the end of the input data, execute any B<END> rule(s)." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<nextfile>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Stop processing the current input file. The next input record read comes " +"from the next input file. Update B<FILENAME> and B<ARGIND>, reset B<FNR> to " +"1, and start processing over with the first pattern in the \\*(AK program. " +"Upon reaching the end of the input data, execute any B<ENDFILE> and B<END> " +"rule(s)." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<print>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Print the current record. The output record is terminated with the value of " +"B<ORS>." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<print>I< expr-list>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Print expressions. Each expression is separated by the value of B<OFS>. " +"The output record is terminated with the value of B<ORS>." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<print>I< expr-list>B< E<gt>>I<file>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Print expressions on I<file>. Each expression is separated by the value of " +"B<OFS>. The output record is terminated with the value of B<ORS>." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<printf>I< fmt, expr-list>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "Format and print." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<printf>I< fmt, expr-list>B< E<gt>>I<file>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "Format and print on I<file>." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<system(>I<cmd-line>B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Execute the command I<cmd-line>, and return the exit status. (This may not " +"be available on non-\\*(PX systems.) See I<https://www.gnu.org/software/" +"gawk/manual/html_node/I_002fO-Functions.html#I_002fO-Functions> for the full " +"details on the exit status." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "Additional output redirections are allowed for B<print> and B<printf>." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<print .\\|.\\|.\\& E<gt>E<gt>>I< file>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "Append output to the I<file>." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<print .\\|.\\|.\\& |>I< command>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "Write on a pipe." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<print .\\|.\\|.\\& |&>I< command>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Send data to a coprocess or socket. (See also the subsection B<Special File " +"Names>, below.)" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"The B<getline> command returns 1 on success, zero on end of file, and -1 on " +"an error. If the I<errno>(3) value indicates that the I/O operation may be " +"retried, and B<PROCINFO[\">I<input\\^>B<\", \"RETRY\"]> is set, then -2 is " +"returned instead of -1, and further calls to B<getline> may be attempted. " +"Upon an error, B<ERRNO> is set to a string describing the problem." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"B<NOTE>: Failure in opening a two-way socket results in a non-fatal error " +"being returned to the calling function. If using a pipe, coprocess, or " +"socket to B<getline>, or from B<print> or B<printf> within a loop, you " +"I<must> use B<close()> to create new instances of the command or socket. " +"\\*(AK does not automatically close pipes, sockets, or coprocesses when they " +"return EOF." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"The \\*(AK versions of the B<printf> statement and B<sprintf()> function are " +"similar to those of C. For details, see I<https://www.gnu.org/software/gawk/" +"manual/html_node/Printf.html>." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "Special File Names" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"When doing I/O redirection from either B<print> or B<printf> into a file, or " +"via B<getline> from a file, I<gawk> recognizes certain special filenames " +"internally. These filenames allow access to open file descriptors inherited " +"from I<gawk\\^>'s parent process (usually the shell). These file names may " +"also be used on the command line to name data files. The filenames are:" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<->" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "The standard input." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B</dev/stdin>" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B</dev/stdout>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "The standard output." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B</dev/stderr>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "The standard error output." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B</dev/fd/\\^>I<n>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "The file associated with the open file descriptor I<n>." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"The following special filenames may be used with the B<|&> coprocess " +"operator for creating TCP/IP network connections:" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B</inet/tcp/>I<lport>B</>I<rhost>B</>I<rport>" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B</inet4/tcp/>I<lport>B</>I<rhost>B</>I<rport>" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B</inet6/tcp/>I<lport>B</>I<rhost>B</>I<rport>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Files for a TCP/IP connection on local port I<lport> to remote host I<rhost> " +"on remote port I<rport>. Use a port of B<0> to have the system pick a " +"port. Use B</inet4> to force an IPv4 connection, and B</inet6> to force an " +"IPv6 connection. Plain B</inet> uses the system default (most likely " +"IPv4). Usable only with the B<|&> two-way I/O operator." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B</inet/udp/>I<lport>B</>I<rhost>B</>I<rport>" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B</inet4/udp/>I<lport>B</>I<rhost>B</>I<rport>" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B</inet6/udp/>I<lport>B</>I<rhost>B</>I<rport>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "Similar, but use UDP/IP instead of TCP/IP." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "Numeric Functions" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "\\*(AK has the following built-in arithmetic functions:" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<atan2(>I<y>B<,>I< x>B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "Return the arctangent of I<y/x> in radians." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<cos(>I<expr>B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "Return the cosine of I<expr>, which is in radians." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<exp(>I<expr>B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "The exponential function." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<int(>I<expr>B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "Truncate to integer." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<log(>I<expr>B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "The natural logarithm function." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<rand()>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Return a random number I<N>, between zero and one, such that 0 \\(E<lt>= " +"I<N> E<lt> 1." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<sin(>I<expr>B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "Return the sine of I<expr>, which is in radians." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<sqrt(>I<expr>B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "Return the square root of I<expr>." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "\\&B<srand(>[I<expr\\^>]B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Use I<expr> as the new seed for the random number generator. If no I<expr> " +"is provided, use the time of day. Return the previous seed for the random " +"number generator." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "String Functions" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"I<Gawk> has the following built-in string functions; details are provided in " +"I<https://www.gnu.org/software/gawk/manual/html_node/String-Functions>." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<asort(>I<s >[B<, >I<d> [B<, >I<how>] ]B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Return the number of elements in the source array I<s>. Sort the contents " +"of I<s> using I<gawk\\^>'s normal rules for comparing values, and replace " +"the indices of the sorted values I<s> with sequential integers starting with " +"1. If the optional destination array I<d> is specified, first duplicate I<s> " +"into I<d>, and then sort I<d>, leaving the indices of the source array I<s> " +"unchanged. The optional string I<how> controls the direction and the " +"comparison mode. Valid values for I<how> are described in I<https://www.gnu." +"org/software/gawk/manual/html_node/String-Functions.html#String-Functions>. " +"I<s> and I<d> are allowed to be the same array; this only makes sense when " +"supplying the third argument as well." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<asorti(>I<s >[B<, >I<d> [B<, >I<how>] ]B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Return the number of elements in the source array I<s>. The behavior is the " +"same as that of B<asort()>, except that the array I<indices> are used for " +"sorting, not the array values. When done, the array is indexed numerically, " +"and the values are those of the original indices. The original values are " +"lost; thus provide a second array if you wish to preserve the original. The " +"purpose of the optional string I<how> is the same as for B<asort()>. Here " +"too, I<s> and I<d> are allowed to be the same array; this only makes sense " +"when supplying the third argument as well." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<gensub(>I<r>B<, >I<s>B<, >I<h >[B<, >I<t>]B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Search the target string I<t> for matches of the regular expression I<r>. " +"If I<h> is a string beginning with B<g> or B<G>, then replace all matches of " +"I<r> with I<s>. Otherwise, I<h> is a number indicating which match of I<r> " +"to replace. If I<t> is not supplied, use B<$0> instead. Within the " +"replacement text I<s>, the sequence B<\\e>I<n>, where I<n> is a digit from 1 " +"to 9, may be used to indicate just the text that matched the I<n>'th " +"parenthesized subexpression. The sequence B<\\e0> represents the entire " +"matched text, as does the character B<&>. Unlike B<sub()> and B<gsub()>, " +"the modified string is returned as the result of the function, and the " +"original target string is I<not> changed." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<gsub(>I<r>B<, >I<s >[B<, >I<t>]B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"For each substring matching the regular expression I<r> in the string I<t>, " +"substitute the string I<s>, and return the number of substitutions. If I<t> " +"is not supplied, use B<$0>. An B<&> in the replacement text is replaced " +"with the text that was actually matched. Use B<\\e&> to get a literal " +"B<&>. (This must be typed as B<\"\\e\\e&\">; see I<https://www.gnu.org/" +"software/gawk/manual/html_node/Gory-Details.html#Gory-Details> for a fuller " +"discussion of the rules for ampersands and backslashes in the replacement " +"text of B<sub()>, B<gsub()>, and B<gensub()>.)" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<index(>I<s>B<,>I< t>B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Return the index of the string I<t> in the string I<s>, or zero if I<t> is " +"not present. (This implies that character indices start at one.)" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<length(>[I<s>]B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Return the length of the string I<s>, or the length of B<$0> if I<s> is not " +"supplied. With an array argument, B<length()> returns the number of " +"elements in the array." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<match(>I<s>B<, >I<r >[B<, >I<a>]B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Return the position in I<s> where the regular expression I<r> occurs, or " +"zero if I<r> is not present, and set the values of B<RSTART> and " +"B<RLENGTH>. Note that the argument order is the same as for the B<~> " +"operator: I<str>B< ~> I<re>." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"See I<https://www.gnu.org/software/gawk/manual/html_node/String-Functions." +"html#String-Functions> for a description of how the array I<a> is filled if " +"it is provided." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<patsplit(>I<s>B<, >I<a >[B<, >I<r> [B<, >I<seps>] ]B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Split the string I<s> into the array I<a> and the separators array I<seps> " +"on the regular expression I<r>, and return the number of fields. Element " +"values are the portions of I<s> that matched I<r>. The value of " +"B<seps[>I<i>B<]> is the possibly null separator that appeared after " +"B<a[>I<i>B<]>. The value of B<seps[0]> is the possibly null leading " +"separator. If I<r> is omitted, B<FPAT> is used instead. The arrays I<a> " +"and I<seps> are cleared first. Splitting behaves identically to field " +"splitting with B<FPAT>." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<split(>I<s>B<, >I<a >[B<, >I<r> [B<, >I<seps>] ]B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Split the string I<s> into the array I<a> and the separators array I<seps> " +"on the regular expression I<r>, and return the number of fields. If I<r> is " +"omitted, B<FS> is used instead. The arrays I<a> and I<seps> are cleared " +"first. B<seps[>I<i>B<]> is the field separator matched by I<r> between " +"B<a[>I<i>B<]> and B<a[>I<i>B<+1]>. Splitting behaves identically to field " +"splitting." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<sprintf(>I<fmt\\^>B<,>I< expr-list\\^>B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Print I<expr-list> according to I<fmt>, and return the resulting string." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<strtonum(>I<str>B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Examine I<str>, and return its numeric value. If I<str> begins with a " +"leading B<0>, treat it as an octal number. If I<str> begins with a leading " +"B<0x> or B<0X>, treat it as a hexadecimal number. Otherwise, assume it is a " +"decimal number." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<sub(>I<r>B<, >I<s >[B<, >I<t>]B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Just like B<gsub()>, but replace only the first matching substring. Return " +"either zero or one." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<substr(>I<s>B<, >I<i >[B<, >I<n>]B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Return the at most I<n>-character substring of I<s> starting at I<i>. If " +"I<n> is omitted, use the rest of I<s>." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<tolower(>I<str>B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Return a copy of the string I<str>, with all the uppercase characters in " +"I<str> translated to their corresponding lowercase counterparts. Non-" +"alphabetic characters are left unchanged." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<toupper(>I<str>B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Return a copy of the string I<str>, with all the lowercase characters in " +"I<str> translated to their corresponding uppercase counterparts. Non-" +"alphabetic characters are left unchanged." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"I<Gawk> is multibyte aware. This means that B<index()>, B<length()>, " +"B<substr()> and B<match()> all work in terms of characters, not bytes." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "Time Functions" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"I<Gawk> provides the following functions for obtaining time stamps and " +"formatting them. Details are provided in I<https://www.gnu.org/software/gawk/" +"manual/html_node/Time-Functions>." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<mktime(>I<datespec> [B<, >I<utc-flag>]B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Turn I<datespec> into a time stamp of the same form as returned by " +"B<systime()>, and return the result. If I<utc-flag> is present and is non-" +"zero or non-null, the time is assumed to be in the UTC time zone; otherwise, " +"the time is assumed to be in the local time zone. If I<datespec> does not " +"contain enough elements or if the resulting time is out of range, " +"B<mktime()> returns -1. See I<https://www.gnu.org/software/gawk/manual/" +"html_node/Time-Functions.html#Time-Functions> for the details of I<datespec>." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<strftime(>[I<format >[B<, >I<timestamp>[B<, >I<utc-flag>]]]B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Format I<timestamp> according to the specification in I<format>. If I<utc-" +"flag> is present and is non-zero or non-null, the result is in UTC, " +"otherwise the result is in local time. The I<timestamp> should be of the " +"same form as returned by B<systime()>. If I<timestamp> is missing, the " +"current time of day is used. If I<format> is missing, a default format " +"equivalent to the output of I<date>(1) is used. The default format is " +"available in B<PROCINFO[\"strftime\"]>. See the specification for the " +"B<strftime()> function in ISO C for the format conversions that are " +"guaranteed to be available." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<systime()>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Return the current time of day as the number of seconds since the Epoch " +"(1970-01-01 00:00:00 UTC on \\*(PX systems)." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "Bit Manipulations Functions" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"I<Gawk> supplies the following bit manipulation functions. They work by " +"converting double-precision floating point values to B<uintmax_t> integers, " +"doing the operation, and then converting the result back to floating point. " +"Passing negative operands to any of these functions causes a fatal error." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "The functions are:" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<and(>I<v1>B<, >I<v2 >[, ...]B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Return the bitwise AND of the values provided in the argument list. There " +"must be at least two." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<compl(>I<val>B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "Return the bitwise complement of I<val>." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<lshift(>I<val>B<, >I<count>B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "Return the value of I<val>, shifted left by I<count> bits." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<or(>I<v1>B<, >I<v2 >[, ...]B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Return the bitwise OR of the values provided in the argument list. There " +"must be at least two." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<rshift(>I<val>B<, >I<count>B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "Return the value of I<val>, shifted right by I<count> bits." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<xor(>I<v1>B<, >I<v2 >[, ...]B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Return the bitwise XOR of the values provided in the argument list. There " +"must be at least two." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "Type Functions" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"The following functions provide type related information about their " +"arguments." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<isarray(>I<x>B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "Return true if I<x> is an array, false otherwise." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<typeof(>I<x>B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Return a string indicating the type of I<x>. The string will be one of " +"B<\"array\">, B<\"number\">, B<\"regexp\">, B<\"string\">, B<\"strnum\">, " +"B<\"unassigned\">, or B<\"undefined\">." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "Internationalization Functions" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"The following functions may be used from within your AWK program for " +"translating strings at run-time. For full details, see I<https://www.gnu." +"org/software/gawk/manual/html_node/I18N-Functions.html#I18N-Functions>." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<bindtextdomain(>I<directory >[B<, >I<domain>]B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Specify the directory where I<gawk> looks for the B<\\&.gmo> files, in case " +"they will not or cannot be placed in the ``standard'' locations. It returns " +"the directory where I<domain> is ``bound.''" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"The default I<domain> is the value of B<TEXTDOMAIN>. If I<directory> is the " +"null string (B<\"\">), then B<bindtextdomain()> returns the current binding " +"for the given I<domain>." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<dcgettext(>I<string >[B<, >I<domain >[B<, >I<category>]]B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Return the translation of I<string> in text domain I<domain> for locale " +"category I<category>. The default value for I<domain> is the current value " +"of B<TEXTDOMAIN>. The default value for I<category> is B<\"LC_MESSAGES\">." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<dcngettext(>I<string1>B<, >I<string2>B<, >I<number >[B<, >I<domain >[B<, >I<category>]]B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Return the plural form used for I<number> of the translation of I<string1> " +"and I<string2> in text domain I<domain> for locale category I<category>. " +"The default value for I<domain> is the current value of B<TEXTDOMAIN>. The " +"default value for I<category> is B<\"LC_MESSAGES\">." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "Boolean Valued Functions" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"You can create special Boolean-typed values; see the manual for how they " +"work and why they exist." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<mkbool(>I<expression\\^>B<)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Based on the boolean value of I<expression> return either a true value or a " +"false value. True values have numeric value one. False values have numeric " +"value zero." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "USER-DEFINED FUNCTIONS" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "Functions in \\*(AK are defined as follows:" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "B<function >I<name>B<(>I<parameter list>B<) { >I<statements >B<}>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Functions execute when they are called from within expressions in either " +"patterns or actions. Actual parameters supplied in the function call are " +"used to instantiate the formal parameters declared in the function. Arrays " +"are passed by reference, other variables are passed by value." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Local variables are declared as extra parameters in the parameter list. The " +"convention is to separate local variables from real parameters by extra " +"spaces in the parameter list. For example:" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "" +"B<function f(p, q, a, b)\t# a and b are local\n" +"{\n" +"\t\\&.\\|.\\|.\n" +"}>\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B</abc/\t{ .\\|.\\|.\\& ; f(1, 2) ; .\\|.\\|.\\& }>\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"The left parenthesis in a function call is required to immediately follow " +"the function name, without any intervening whitespace. This restriction " +"does not apply to the built-in functions listed above." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Functions may call each other and may be recursive. Function parameters " +"used as local variables are initialized to the null string and the number " +"zero upon function invocation." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Use B<return>I< expr> to return a value from a function. The return value " +"is undefined if no value is provided, or if the function returns by " +"``falling off'' the end." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Functions may be called indirectly. To do this, assign the name of the " +"function to be called, as a string, to a variable. Then use the variable as " +"if it were the name of a function, prefixed with an B<@> sign, like so:" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "" +"B<function myfunc()\n" +"{\n" +"\tprint \"myfunc called\"\n" +"\t\\&.\\|.\\|.\n" +"}>\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "" +"B<{\t.\\|.\\|.\n" +"\tthe_func = \"myfunc\"\n" +"\t@the_func()\t# call through the_func to myfunc\n" +"\t.\\|.\\|.\n" +"}>\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"If B<-\\^-lint> has been provided, I<gawk> warns about calls to undefined " +"functions at parse time, instead of at run time. Calling an undefined " +"function at run time is a fatal error." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "DYNAMICALLY LOADING NEW FUNCTIONS" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"You can dynamically add new functions written in C or C++ to the running " +"I<gawk> interpreter with the B<@load> statement. The full details are " +"beyond the scope of this manual page; see I<https://www.gnu.org/software/" +"gawk/manual/html_node/Dynamic-Extensions.html#Dynamic-Extensions>." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "SIGNALS" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"The I<gawk> profiler accepts two signals. B<SIGUSR1> causes it to dump a " +"profile and function call stack to the profile file, which is either " +"B<awkprof.out>, or whatever file was named with the B<-\\^-profile> option. " +"It then continues to run. B<SIGHUP> causes I<gawk> to dump the profile and " +"function call stack and then exit." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "INTERNATIONALIZATION" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"String constants are sequences of characters enclosed in double quotes. In " +"non-English speaking environments, it is possible to mark strings in the " +"\\*(AK program as requiring translation to the local natural language. Such " +"strings are marked in the \\*(AK program with a leading underscore (``_''). " +"For example," +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "B<gawk 'BEGIN { print \"hello, world\" }'>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "always prints B<hello, world>. But," +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "B<gawk 'BEGIN { print _\"hello, world\" }'>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"might print B<bonjour, monde> in France. See I<https://www.gnu.org/software/" +"gawk/manual/html_node/Internationalization.html#Internationalization> for " +"the steps involved in producing and running a localizable \\*(AK program." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "GNU EXTENSIONS" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"I<Gawk> has a too-large number of extensions to \\*(PX I<awk>. They are " +"described in I<https://www.gnu.org/software/gawk/manual/html_node/" +"POSIX_002fGNU.html>. All the extensions can be disabled by invoking I<gawk> " +"with the B<-\\^-traditional> or B<-\\^-posix> options." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "ENVIRONMENT VARIABLES" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"The B<AWKPATH> environment variable can be used to provide a list of " +"directories that I<gawk> searches when looking for files named via the B<-" +"f>, B<-\\^-file>, B<-i> and B<-\\^-include> options, and the B<@include> " +"directive. If the initial search fails, the path is searched again after " +"appending B<\\&.awk> to the filename." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"The B<AWKLIBPATH> environment variable can be used to provide a list of " +"directories that I<gawk> searches when looking for files named via the B<-l> " +"and B<-\\^-load> options." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"The B<GAWK_PERSIST_FILE> environment variable, if present, specifies a file " +"to use as the backing store for persistent memory. I<This is an " +"experimental feature>. See \\*(EP for the details." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"The B<GAWK_READ_TIMEOUT> environment variable can be used to specify a " +"timeout in milliseconds for reading input from a terminal, pipe or two-way " +"communication including sockets." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"For connection to a remote host via socket, B<GAWK_SOCK_RETRIES> controls " +"the number of retries, and B<GAWK_MSEC_SLEEP> the interval between retries. " +"The interval is in milliseconds. On systems that do not support " +"I<usleep>(3), the value is rounded up to an integral number of seconds." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"If B<POSIXLY_CORRECT> exists in the environment, then I<gawk> behaves " +"exactly as if B<-\\^-posix> had been specified on the command line. If B<-" +"\\^-lint> has been specified, I<gawk> issues a warning message to this " +"effect." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "EXIT STATUS" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"If the B<exit> statement is used with a value, then I<gawk> exits with the " +"numeric value given to it." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Otherwise, if there were no problems during execution, I<gawk> exits with " +"the value of the C constant B<EXIT_SUCCESS>. This is usually zero." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"If an error occurs, I<gawk> exits with the value of the C constant " +"B<EXIT_FAILURE>. This is usually one." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"If I<gawk> exits because of a fatal error, the exit status is 2. On non-" +"POSIX systems, this value may be mapped to B<EXIT_FAILURE>." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "VERSION INFORMATION" +msgstr "" + +#. type: Plain text +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +msgid "This man page documents I<gawk>, version 5.3." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "AUTHORS" +msgstr "" + +#. type: Plain text +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +msgid "" +"The original version of \\*(UX I<awk> was designed and implemented by Alfred " +"Aho, Peter Weinberger, and Brian Kernighan of Bell Laboratories. Ozan Yigit " +"is the the current maintainer. Brian Kernighan occasionally dabbles in its " +"development." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Paul Rubin and Jay Fenlason, of the Free Software Foundation, wrote I<gawk>, " +"to be compatible with the original version of I<awk> distributed in Seventh " +"Edition \\*(UX. John Woods contributed a number of bug fixes. David " +"Trueman, with contributions from Arnold Robbins, made I<gawk> compatible " +"with the new version of \\*(UX I<awk>. Arnold Robbins is the current " +"maintainer." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"See \\*(EP for a full list of the contributors to I<gawk> and its " +"documentation." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"See the B<README> file in the I<gawk> distribution for up-to-date " +"information about maintainers and which ports are currently supported." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "BUG REPORTS" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"If you find a bug in I<gawk>, please use the I<gawkbug>(1) program to " +"report it." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Full instructions for reporting a bug are provided in I<https://www.gnu.org/" +"software/gawk/manual/html_node/Bugs.html>. I<Please> carefully read and " +"follow the instructions given there. This will make bug reporting and " +"resolution much easier for everyone involved. Really." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "BUGS" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"The B<-F> option is not necessary given the command line variable assignment " +"feature; it remains only for backwards compatibility." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "This manual page is too long; I<gawk> has too many features." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "SEE ALSO" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"I<egrep>(1), I<sed>(1), I<gawkbug>(1), I<printf>(3), and I<strftime>(3)." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"I<The AWK Programming Language>, Alfred V.\\& Aho, Brian W.\\& Kernighan, " +"Peter J.\\& Weinberger, Addison-Wesley, 1988. ISBN 0-201-07981-X." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"\\*(EP, Edition 5.2, shipped with the I<gawk> source. The current version " +"of this document is available online at I<https://www.gnu.org/software/gawk/" +"manual>." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"The GNU B<gettext> documentation, available online at I<https://www.gnu.org/" +"software/gettext>." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "EXAMPLES" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "Print and sort the login names of all users:\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "" +"B<\tBEGIN\t{ FS = \":\" }\n" +"\t\t{ print $1 | \"sort\" }>\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "Count lines in a file:\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "" +"B<\t\t{ nlines++ }\n" +"\tEND\t{ print nlines }>\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "Precede each line by its number in the file:\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<\t{ print FNR, $0 }>\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "Concatenate and line number (a variation on a theme):\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "B<\t{ print NR, $0 }>\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "Run an external command for particular lines of data:\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "" +"B<\ttail -f access_log |\n" +"\tawk '/myhome.html/ { system(\"nmap \" $1 \"E<gt>E<gt> logdir/myhome.html\") }'>\n" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +#, no-wrap +msgid "COPYING PERMISSIONS" +msgstr "" + +#. type: Plain text +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed +msgid "" +"Copyright \\(co 1989, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, " +"2001, 2002, 2003, 2004, 2005, 2007, 2009, 2010, 2011, 2012, 2013, 2014, " +"2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023 Free Software " +"Foundation, Inc." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Permission is granted to make and distribute verbatim copies of this manual " +"page provided the copyright notice and this permission notice are preserved " +"on all copies." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Permission is granted to copy and distribute modified versions of this " +"manual page under the conditions for verbatim copying, provided that the " +"entire resulting derived work is distributed under the terms of a permission " +"notice identical to this one." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-tumbleweed +msgid "" +"Permission is granted to copy and distribute translations of this manual " +"page into another language, under the above conditions for modified " +"versions, except that this permission notice may be stated in a translation " +"approved by the Foundation." +msgstr "" + +#. type: TH +#: debian-bookworm debian-unstable +#, no-wrap +msgid "Jun 09 2022" +msgstr "" + +#. type: TP +#: debian-bookworm debian-unstable +#, no-wrap +msgid "B<-f>I< program-file>,I< >" +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable +msgid "" +"B<-\\^-file>I< program-file> Read the \\*(AK program source from the file " +"I<program-file>, instead of from the first command line argument. Multiple " +"B<-f> options may be used. Files read with B<-f> are treated as if they " +"begin with an implicit B<@namespace \"awk\"> statement." +msgstr "" + +#. type: TP +#: debian-bookworm debian-unstable +#, no-wrap +msgid "B<-F>I< fs>, " +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable +msgid "" +"B<-\\^-field-separator>I< fs> Use I<fs> for the input field separator (the " +"value of the B<FS> predefined variable)." +msgstr "" + +#. type: TP +#: debian-bookworm debian-unstable +#, no-wrap +msgid "B<-b>I<, >" +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable +msgid "" +"B<-\\^-characters-as-bytes> Treat all input data as single-byte characters. " +"The B<-\\^-posix> option overrides this one." +msgstr "" + +#. type: TP +#: debian-bookworm debian-unstable +#, no-wrap +msgid "B<-c>I<, >" +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable +msgid "" +"B<-\\^-traditional> Run in I<compatibility> mode. In compatibility mode, " +"I<gawk> behaves identically to Brian Kernighan's I<awk>; none of the \\*(GN-" +"specific extensions are recognized." +msgstr "" + +#. type: TP +#: debian-bookworm debian-unstable +#, no-wrap +msgid "B<-C>I<, >" +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable +msgid "" +"B<-\\^-copyright> Print the short version of the \\*(GN copyright " +"information message on the standard output and exit successfully." +msgstr "" + +#. type: TP +#: debian-bookworm debian-unstable +#, no-wrap +msgid "B<-e>I< program-text>, " +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable +msgid "" +"B<-\\^-source>I< program-text> Use I<program-text> as \\*(AK program source " +"code. Each argument supplied via B<-e> is treated as if it begins with an " +"implicit B<@namespace \"awk\"> statement." +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable +msgid "" +"Similar to B<-f>, however, this is option is the last one processed. This " +"should be used with B<#!> scripts, particularly for CGI applications, to " +"avoid passing in options or source code (!) on the command line from a URL. " +"This option disables command-line variable assignments." +msgstr "" + +#. type: TP +#: debian-bookworm debian-unstable +#, no-wrap +msgid "B<-g>I<, >" +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable +msgid "" +"B<-\\^-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." +msgstr "" + +#. type: TP +#: debian-bookworm debian-unstable +#, no-wrap +msgid "B<-h>I<, >" +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable +msgid "" +"B<-\\^-help> Print a relatively short summary of the available options on " +"the standard output. Per the I<GNU Coding Standards>, these options cause " +"an immediate, successful exit." +msgstr "" + +#. type: TP +#: debian-bookworm debian-unstable +#, no-wrap +msgid "B<-I>I<, >" +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable +msgid "" +"B<-\\^-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." +msgstr "" + +#. type: TP +#: debian-bookworm debian-unstable +#, no-wrap +msgid "B<-l>I< lib>, " +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable +msgid "" +"B<-\\^-load>I< lib> Load a I<gawk> extension from the shared library " +"I<lib>. This searches for the library using the B<AWKLIBPATH> environment " +"variable. If the initial search fails, another attempt will be made after " +"appending the default shared library suffix for the platform. The library " +"initialization routine is expected to be named B<dl_load()>." +msgstr "" + +#. type: TP +#: debian-bookworm debian-unstable +#, no-wrap +msgid "B<-M>I<, >" +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable +msgid "" +"B<-\\^-bignum> Force arbitrary precision arithmetic on numbers. This option " +"has no effect if I<gawk> is not compiled to use the GNU MPFR and GMP " +"libraries. (In such a case, I<gawk> issues a warning.)" +msgstr "" + +#. type: TP +#: debian-bookworm debian-unstable +#, no-wrap +msgid "B<-n>I<, >" +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable +msgid "" +"B<-\\^-non-decimal-data> Recognize octal and hexadecimal values in input " +"data. I<Use this option with great caution!>" +msgstr "" + +#. type: TP +#: debian-bookworm debian-unstable +#, no-wrap +msgid "B<-N>I<, >" +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable +msgid "" +"B<-\\^-use-lc-numeric> Force I<gawk> to use the locale's decimal point " +"character when parsing input data." +msgstr "" + +#. type: TP +#: debian-bookworm debian-unstable +#, no-wrap +msgid "B<-O>I<, >" +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable +msgid "" +"B<-\\^-optimize> Enable I<gawk>'s default optimizations upon the internal " +"representation of the program. This option is on by default." +msgstr "" + +#. type: TP +#: debian-bookworm debian-unstable +#, no-wrap +msgid "B<-P>I<, >" +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable +msgid "" +"B<-\\^-posix> This turns on I<compatibility> mode, and disables a number of " +"common extensions." +msgstr "" + +#. type: TP +#: debian-bookworm debian-unstable +#, no-wrap +msgid "B<-r>I<, >" +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable +msgid "" +"B<-\\^-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." +msgstr "" + +#. type: TP +#: debian-bookworm debian-unstable +#, no-wrap +msgid "B<-s>I<, >" +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable +msgid "" +"B<-\\^-no-optimize> Disable I<gawk>'s default optimizations upon the " +"internal representation of the program." +msgstr "" + +#. type: TP +#: debian-bookworm debian-unstable +#, no-wrap +msgid "B<-S>I<, >" +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable +msgid "" +"B<-\\^-sandbox> Run I<gawk> in sandbox mode, disabling the B<system()> " +"function, input redirection with B<getline>, output redirection with " +"B<print> and B<printf>, and loading dynamic extensions. Command execution " +"(through pipelines) is also disabled." +msgstr "" + +#. type: TP +#: debian-bookworm debian-unstable +#, no-wrap +msgid "B<-t>I<, >" +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable +msgid "" +"B<-\\^-lint-old> Provide warnings about constructs that are not portable to " +"the original version of \\*(UX I<awk>." +msgstr "" + +#. type: TP +#: debian-bookworm debian-unstable +#, no-wrap +msgid "B<-V>I<, >" +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable +msgid "" +"B<-\\^-version> Print version information for this particular copy of " +"I<gawk> on the standard output. This is useful when reporting bugs. Per " +"the I<GNU Coding Standards>, these options cause an immediate, successful " +"exit." +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable +msgid "" +"The C conditional expression. This has the form I<expr1>B< ? >I<expr2>B< : " +">I<expr3> \\&. If I<expr1> is true, the value of the expression is " +"I<expr2>, otherwise it is I<expr3>. Only one of I<expr2> and I<expr3> is " +"evaluated." +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable +msgid "This man page documents I<gawk>, version 5.2." +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable +msgid "" +"The original version of \\*(UX I<awk> was designed and implemented by Alfred " +"Aho, Peter Weinberger, and Brian Kernighan of Bell Laboratories. Brian " +"Kernighan continues to maintain and enhance it." +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable +msgid "" +"Copyright \\(co 1989, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, " +"2001, 2002, 2003, 2004, 2005, 2007, 2009, 2010, 2011, 2012, 2013, 2014, " +"2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022 Free Software Foundation, Inc." +msgstr "" |