diff options
author | Arnold D. Robbins <arnold@skeeve.com> | 2017-09-18 21:20:35 +0300 |
---|---|---|
committer | Arnold D. Robbins <arnold@skeeve.com> | 2017-09-18 21:20:35 +0300 |
commit | 34f9713c690622a95a13ab13aca5e86cd747c689 (patch) | |
tree | 8b3a9d6f7a353c70f23ab37d227a55b2e43692ea | |
parent | d1cbfd2d384ab7259f44b93f8a6a2ede4a6d4529 (diff) | |
download | egawk-34f9713c690622a95a13ab13aca5e86cd747c689.tar.gz egawk-34f9713c690622a95a13ab13aca5e86cd747c689.tar.bz2 egawk-34f9713c690622a95a13ab13aca5e86cd747c689.zip |
Change GNU URLs to use https.
-rw-r--r-- | doc/ChangeLog | 5 | ||||
-rw-r--r-- | doc/gawk.info | 1182 | ||||
-rw-r--r-- | doc/gawk.texi | 84 | ||||
-rw-r--r-- | doc/gawktexi.in | 84 |
4 files changed, 696 insertions, 659 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index e792b814..99ae61c4 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,8 @@ +2017-09-18 Arnold D. Robbins <arnold@skeeve.com> + + * gawktexi.in: Change GNU URLs to use `https://...'. + Revise UPDATE_MONTH. + 2017-09-17 Arnold D. Robbins <arnold@skeeve.com> * gawktexi.in: Change 'namespace' to 'name_space' where it matters diff --git a/doc/gawk.info b/doc/gawk.info index a0613b96..5b757a51 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -1147,10 +1147,10 @@ Typographical Conventions ========================= This Info file is written in Texinfo -(http://www.gnu.org/software/texinfo/), the GNU documentation formatting -language. A single Texinfo source file is used to produce both the -printed and online versions of the documentation. This minor node -briefly documents the typographical conventions used in Texinfo. +(https://www.gnu.org/software/texinfo/), the GNU documentation +formatting language. A single Texinfo source file is used to produce +both the printed and online versions of the documentation. This minor +node briefly documents the typographical conventions used in Texinfo. Examples you would type at the command line are preceded by the common shell primary and secondary prompts, '$' and '>'. Input that you @@ -1213,9 +1213,9 @@ Public License (GPL) to ensure that its software's source code is always available to the end user. A copy of the GPL is included for your reference (*note Copying::). The GPL applies to the C language source code for 'gawk'. To find out more about the FSF and the GNU Project -online, see the GNU Project's home page (http://www.gnu.org). This Info -file may also be read from GNU's website -(http://www.gnu.org/software/gawk/manual/). +online, see the GNU Project's home page (https://www.gnu.org). This +Info file may also be read from GNU's website +(https://www.gnu.org/software/gawk/manual/). A shell, an editor (Emacs), highly portable optimizing C, C++, and Objective-C compilers, a symbolic debugger and dozens of large and small @@ -2829,7 +2829,7 @@ environments. (1) For more detail, please see Section 4.4 of RFC 3875 (http://www.ietf.org/rfc/rfc3875). Also see the explanatory note sent to the 'gawk' bug mailing list -(http://lists.gnu.org/archive/html/bug-gawk/2014-11/msg00022.html). +(https://lists.gnu.org/archive/html/bug-gawk/2014-11/msg00022.html). (2) Not recommended. @@ -2974,7 +2974,7 @@ true for both '--traditional' and '--posix'. *Note Options::. path is searched again after adding the suffix '.awk' to the file name. 'gawk''s path search mechanism is similar to the shell's. (See 'The -Bourne-Again SHell manual' (http://www.gnu.org/software/bash/manual/).) +Bourne-Again SHell manual' (https://www.gnu.org/software/bash/manual/).) It treats a null entry in the path as indicating the current directory. (A null entry is indicated by starting or ending the path with a colon or by placing two colons next to each other ['::'].) @@ -18838,7 +18838,7 @@ hand. Here we present a program that can extract parts of a Texinfo input file into separate files. This Info file is written in Texinfo -(http://www.gnu.org/software/texinfo/), the GNU Project's document +(https://www.gnu.org/software/texinfo/), the GNU Project's document formatting language. A single Texinfo source file can be used to produce both printed documentation, with TeX, and online documentation. (The Texinfo language is described fully, starting with *note (Texinfo, @@ -20341,7 +20341,7 @@ use, 'gawk' automatically falls back to using regular pipes. earlier, at some loss in performance. This is because the tty driver buffers and sends data line-by-line. On systems with the 'stdbuf' (part of the GNU Coreutils package -(http://www.gnu.org/software/coreutils/coreutils.html)), you can use +(https://www.gnu.org/software/coreutils/coreutils.html)), you can use that program instead of ptys. Note also that ptys are not fully transparent. Certain binary @@ -21408,7 +21408,7 @@ complexity. Thus, most programming languages have facilities available for "debugging" programs, and now 'awk' is no exception. The 'gawk' debugger is purposely modeled after the GNU Debugger (GDB) -(http://www.gnu.org/software/gdb/) command-line debugger. If you are +(https://www.gnu.org/software/gdb/) command-line debugger. If you are familiar with GDB, learning how to use 'gawk' for debugging your program is easy. @@ -27188,10 +27188,10 @@ command is as follows: parser library installed in order to build and use the XML extension. In addition, you must have the GNU Autotools installed (Autoconf -(http://www.gnu.org/software/autoconf), Automake -(http://www.gnu.org/software/automake), Libtool -(http://www.gnu.org/software/libtool), and GNU 'gettext' -(http://www.gnu.org/software/gettext)). +(https://www.gnu.org/software/autoconf), Automake +(https://www.gnu.org/software/automake), Libtool +(https://www.gnu.org/software/libtool), and GNU 'gettext' +(https://www.gnu.org/software/gettext)). The simple recipe for building and testing 'gawkextlib' is as follows. First, build and install 'gawk': @@ -28534,11 +28534,11 @@ There are two ways to get GNU software: supported. If you have the 'wget' program, you can use a command like the following: - wget http://ftp.gnu.org/gnu/gawk/gawk-4.2.0.tar.gz + wget https://ftp.gnu.org/gnu/gawk/gawk-4.2.0.tar.gz The GNU software archive is mirrored around the world. The up-to-date list of mirror sites is available from the main FSF website -(http://www.gnu.org/order/ftp.html). Try to use one of the mirrors; +(https://www.gnu.org/order/ftp.html). Try to use one of the mirrors; they will be less busy, and you can usually find one closer to your site. @@ -29742,11 +29742,15 @@ B.6 Summary * The 'gawk' distribution is available from the GNU Project's main distribution site, 'ftp.gnu.org'. The canonical build recipe is: - wget http://ftp.gnu.org/gnu/gawk/gawk-4.2.0.tar.gz + wget https://ftp.gnu.org/gnu/gawk/gawk-4.2.0.tar.gz tar -xvpzf gawk-4.2.0.tar.gz cd gawk-4.2.0 ./configure && make && make check + NOTE: Because of the 'https://' URL, you may have to supply + the '--no-check-certificate' option to 'wget' to download the + file. + * 'gawk' may be built on non-POSIX systems as well. The currently supported systems are MS-Windows using MSYS, DJGPP, MinGW, and Cygwin, and both Vax/VMS and OpenVMS. Instructions for each system @@ -29851,7 +29855,7 @@ This clones the 'gawk' repository. If you are behind a firewall that does not allow you to use the Git native protocol, you can still access the repository using: - git clone http://git.savannah.gnu.org/r/gawk.git + git clone https://git.savannah.gnu.org/r/gawk.git Once you have made changes, you can use 'git diff' to produce a patch, and send that to the 'gawk' maintainer; see *note Bugs::, for how @@ -29896,7 +29900,7 @@ possible to include them: document describes how GNU software should be written. If you haven't read it, please do so, preferably _before_ starting to modify 'gawk'. (The 'GNU Coding Standards' are available from the - GNU Project's website (http://www.gnu.org/prep/standards/). + GNU Project's website (https://www.gnu.org/prep/standards/). Texinfo, Info, and DVI versions are also available.) 5. Use the 'gawk' coding style. The C code for 'gawk' follows the @@ -30181,12 +30185,16 @@ on; it was really painful. When the repository is self-contained, using worked for years (and still works). He had '/usr/local/bin' at the front of his 'PATH' and just did: - wget http://ftp.gnu.org/gnu/PACKAGE/PACKAGE-X.Y.Z.tar.gz + wget https://ftp.gnu.org/gnu/PACKAGE/PACKAGE-X.Y.Z.tar.gz tar -xpzvf PACKAGE-X.Y.Z.tar.gz cd PACKAGE-X.Y.Z ./configure && make && make check make install # as root + NOTE: Because of the 'https://' URL, you may have to supply + the '--no-check-certificate' option to 'wget' to download the + file. + Most of the above was originally written by the maintainer to other 'gawk' developers. It raised the objection from one of the developers "... that anybody pulling down the source from Git is not an end user." @@ -30205,7 +30213,7 @@ significant change being introduced. Fortunately, the Git server can meet this need. For any given branch named BRANCHNAME, use: - wget http://git.savannah.gnu.org/cgit/gawk.git/snapshot/gawk-BRANCHNAME.tar.gz + wget https://git.savannah.gnu.org/cgit/gawk.git/snapshot/gawk-BRANCHNAME.tar.gz to retrieve a snapshot of the given branch. @@ -35863,569 +35871,569 @@ Ref: Names-Footnote-156161 Node: This Manual56308 Ref: This Manual-Footnote-162793 Node: Conventions62893 -Node: Manual History65247 -Ref: Manual History-Footnote-168242 -Ref: Manual History-Footnote-268283 -Node: How To Contribute68357 -Node: Acknowledgments69008 -Node: Getting Started73916 -Node: Running gawk76355 -Node: One-shot77545 -Node: Read Terminal78808 -Node: Long80801 -Node: Executable Scripts82314 -Ref: Executable Scripts-Footnote-185109 -Node: Comments85212 -Node: Quoting87696 -Node: DOS Quoting93213 -Node: Sample Data Files95269 -Node: Very Simple97864 -Node: Two Rules102766 -Node: More Complex104651 -Node: Statements/Lines107517 -Ref: Statements/Lines-Footnote-1111976 -Node: Other Features112241 -Node: When113177 -Ref: When-Footnote-1114931 -Node: Intro Summary114996 -Node: Invoking Gawk115880 -Node: Command Line117394 -Node: Options118192 -Ref: Options-Footnote-1134811 -Ref: Options-Footnote-2135041 -Node: Other Arguments135066 -Node: Naming Standard Input138013 -Node: Environment Variables139106 -Node: AWKPATH Variable139664 -Ref: AWKPATH Variable-Footnote-1143075 -Ref: AWKPATH Variable-Footnote-2143109 -Node: AWKLIBPATH Variable143370 -Node: Other Environment Variables144627 -Node: Exit Status148448 -Node: Include Files149125 -Node: Loading Shared Libraries152720 -Node: Obsolete154148 -Node: Undocumented154840 -Node: Invoking Summary155137 -Node: Regexp156797 -Node: Regexp Usage158251 -Node: Escape Sequences160288 -Node: Regexp Operators166520 -Ref: Regexp Operators-Footnote-1173936 -Ref: Regexp Operators-Footnote-2174083 -Node: Bracket Expressions174181 -Ref: table-char-classes176657 -Node: Leftmost Longest179794 -Node: Computed Regexps181097 -Node: GNU Regexp Operators184524 -Node: Case-sensitivity188203 -Ref: Case-sensitivity-Footnote-1191090 -Ref: Case-sensitivity-Footnote-2191325 -Node: Regexp Summary191433 -Node: Reading Files192899 -Node: Records195168 -Node: awk split records195901 -Node: gawk split records200832 -Ref: gawk split records-Footnote-1205372 -Node: Fields205409 -Node: Nonconstant Fields208150 -Ref: Nonconstant Fields-Footnote-1210386 -Node: Changing Fields210590 -Node: Field Separators216518 -Node: Default Field Splitting219216 -Node: Regexp Field Splitting220334 -Node: Single Character Fields223687 -Node: Command Line Field Separator224747 -Node: Full Line Fields227965 -Ref: Full Line Fields-Footnote-1229487 -Ref: Full Line Fields-Footnote-2229533 -Node: Field Splitting Summary229634 -Node: Constant Size231708 -Node: Fixed width data232440 -Node: Skipping intervening235907 -Node: Allowing trailing data236705 -Node: Fields with fixed data237742 -Node: Splitting By Content239260 -Ref: Splitting By Content-Footnote-1242910 -Node: Testing field creation243073 -Node: Multiple Line244694 -Ref: Multiple Line-Footnote-1250578 -Node: Getline250757 -Node: Plain Getline253226 -Node: Getline/Variable255867 -Node: Getline/File257018 -Node: Getline/Variable/File258406 -Ref: Getline/Variable/File-Footnote-1260011 -Node: Getline/Pipe260099 -Node: Getline/Variable/Pipe262806 -Node: Getline/Coprocess263941 -Node: Getline/Variable/Coprocess265208 -Node: Getline Notes265950 -Node: Getline Summary268747 -Ref: table-getline-variants269171 -Node: Read Timeout269919 -Ref: Read Timeout-Footnote-1273825 -Node: Retrying Input273883 -Node: Command-line directories275082 -Node: Input Summary275988 -Node: Input Exercises279160 -Node: Printing279888 -Node: Print281722 -Node: Print Examples283179 -Node: Output Separators285959 -Node: OFMT287976 -Node: Printf289332 -Node: Basic Printf290117 -Node: Control Letters291691 -Node: Format Modifiers295679 -Node: Printf Examples301694 -Node: Redirection304180 -Node: Special FD311021 -Ref: Special FD-Footnote-1314189 -Node: Special Files314263 -Node: Other Inherited Files314880 -Node: Special Network315881 -Node: Special Caveats316741 -Node: Close Files And Pipes317690 -Ref: table-close-pipe-return-values324597 -Ref: Close Files And Pipes-Footnote-1325380 -Ref: Close Files And Pipes-Footnote-2325528 -Node: Nonfatal325680 -Node: Output Summary328005 -Node: Output Exercises329227 -Node: Expressions329906 -Node: Values331094 -Node: Constants331772 -Node: Scalar Constants332463 -Ref: Scalar Constants-Footnote-1333327 -Node: Nondecimal-numbers333577 -Node: Regexp Constants336578 -Node: Using Constant Regexps337104 -Node: Standard Regexp Constants337726 -Node: Strong Regexp Constants340914 -Node: Variables343872 -Node: Using Variables344529 -Node: Assignment Options346439 -Node: Conversion348312 -Node: Strings And Numbers348836 -Ref: Strings And Numbers-Footnote-1351899 -Node: Locale influences conversions352008 -Ref: table-locale-affects354766 -Node: All Operators355384 -Node: Arithmetic Ops356013 -Node: Concatenation358519 -Ref: Concatenation-Footnote-1361366 -Node: Assignment Ops361473 -Ref: table-assign-ops366464 -Node: Increment Ops367777 -Node: Truth Values and Conditions371237 -Node: Truth Values372311 -Node: Typing and Comparison373359 -Node: Variable Typing374179 -Ref: Variable Typing-Footnote-1380642 -Ref: Variable Typing-Footnote-2380714 -Node: Comparison Operators380791 -Ref: table-relational-ops381210 -Node: POSIX String Comparison384705 -Ref: POSIX String Comparison-Footnote-1386400 -Ref: POSIX String Comparison-Footnote-2386539 -Node: Boolean Ops386623 -Ref: Boolean Ops-Footnote-1391105 -Node: Conditional Exp391197 -Node: Function Calls392933 -Node: Precedence396810 -Node: Locales400469 -Node: Expressions Summary402101 -Node: Patterns and Actions404674 -Node: Pattern Overview405794 -Node: Regexp Patterns407471 -Node: Expression Patterns408013 -Node: Ranges411794 -Node: BEGIN/END414902 -Node: Using BEGIN/END415663 -Ref: Using BEGIN/END-Footnote-1418399 -Node: I/O And BEGIN/END418505 -Node: BEGINFILE/ENDFILE420819 -Node: Empty423726 -Node: Using Shell Variables424043 -Node: Action Overview426317 -Node: Statements428642 -Node: If Statement430490 -Node: While Statement431985 -Node: Do Statement434013 -Node: For Statement435161 -Node: Switch Statement438319 -Node: Break Statement440705 -Node: Continue Statement442797 -Node: Next Statement444624 -Node: Nextfile Statement447007 -Node: Exit Statement449659 -Node: Built-in Variables452062 -Node: User-modified453195 -Node: Auto-set460962 -Ref: Auto-set-Footnote-1476559 -Ref: Auto-set-Footnote-2476765 -Node: ARGC and ARGV476821 -Node: Pattern Action Summary481034 -Node: Arrays483464 -Node: Array Basics484793 -Node: Array Intro485637 -Ref: figure-array-elements487612 -Ref: Array Intro-Footnote-1490316 -Node: Reference to Elements490444 -Node: Assigning Elements492908 -Node: Array Example493399 -Node: Scanning an Array495158 -Node: Controlling Scanning498180 -Ref: Controlling Scanning-Footnote-1503579 -Node: Numeric Array Subscripts503895 -Node: Uninitialized Subscripts506079 -Node: Delete507698 -Ref: Delete-Footnote-1510450 -Node: Multidimensional510507 -Node: Multiscanning513602 -Node: Arrays of Arrays515193 -Node: Arrays Summary519960 -Node: Functions522053 -Node: Built-in523091 -Node: Calling Built-in524172 -Node: Numeric Functions526168 -Ref: Numeric Functions-Footnote-1530196 -Ref: Numeric Functions-Footnote-2530553 -Ref: Numeric Functions-Footnote-3530601 -Node: String Functions530873 -Ref: String Functions-Footnote-1554531 -Ref: String Functions-Footnote-2554659 -Ref: String Functions-Footnote-3554907 -Node: Gory Details554994 -Ref: table-sub-escapes556785 -Ref: table-sub-proposed558304 -Ref: table-posix-sub559667 -Ref: table-gensub-escapes561208 -Ref: Gory Details-Footnote-1562031 -Node: I/O Functions562185 -Ref: table-system-return-values568767 -Ref: I/O Functions-Footnote-1570747 -Ref: I/O Functions-Footnote-2570895 -Node: Time Functions571015 -Ref: Time Functions-Footnote-1581682 -Ref: Time Functions-Footnote-2581750 -Ref: Time Functions-Footnote-3581908 -Ref: Time Functions-Footnote-4582019 -Ref: Time Functions-Footnote-5582131 -Ref: Time Functions-Footnote-6582358 -Node: Bitwise Functions582624 -Ref: table-bitwise-ops583218 -Ref: Bitwise Functions-Footnote-1589251 -Ref: Bitwise Functions-Footnote-2589424 -Node: Type Functions589615 -Node: I18N Functions592532 -Node: User-defined594183 -Node: Definition Syntax594988 -Ref: Definition Syntax-Footnote-1600675 -Node: Function Example600746 -Ref: Function Example-Footnote-1603668 -Node: Function Caveats603690 -Node: Calling A Function604208 -Node: Variable Scope605166 -Node: Pass By Value/Reference608160 -Node: Return Statement611659 -Node: Dynamic Typing614638 -Node: Indirect Calls615568 -Ref: Indirect Calls-Footnote-1625819 -Node: Functions Summary625947 -Node: Library Functions628652 -Ref: Library Functions-Footnote-1632259 -Ref: Library Functions-Footnote-2632402 -Node: Library Names632573 -Ref: Library Names-Footnote-1636033 -Ref: Library Names-Footnote-2636256 -Node: General Functions636342 -Node: Strtonum Function637445 -Node: Assert Function640467 -Node: Round Function643793 -Node: Cliff Random Function645334 -Node: Ordinal Functions646350 -Ref: Ordinal Functions-Footnote-1649413 -Ref: Ordinal Functions-Footnote-2649665 -Node: Join Function649875 -Ref: Join Function-Footnote-1651645 -Node: Getlocaltime Function651845 -Node: Readfile Function655587 -Node: Shell Quoting657559 -Node: Data File Management658960 -Node: Filetrans Function659592 -Node: Rewind Function663688 -Node: File Checking665598 -Ref: File Checking-Footnote-1666932 -Node: Empty Files667133 -Node: Ignoring Assigns669112 -Node: Getopt Function670662 -Ref: Getopt Function-Footnote-1682131 -Node: Passwd Functions682331 -Ref: Passwd Functions-Footnote-1691170 -Node: Group Functions691258 -Ref: Group Functions-Footnote-1699156 -Node: Walking Arrays699363 -Node: Library Functions Summary702371 -Node: Library Exercises703777 -Node: Sample Programs704242 -Node: Running Examples705012 -Node: Clones705740 -Node: Cut Program706964 -Node: Egrep Program716893 -Ref: Egrep Program-Footnote-1724405 -Node: Id Program724515 -Node: Split Program728195 -Ref: Split Program-Footnote-1731654 -Node: Tee Program731783 -Node: Uniq Program734573 -Node: Wc Program741999 -Ref: Wc Program-Footnote-1746254 -Node: Miscellaneous Programs746348 -Node: Dupword Program747561 -Node: Alarm Program749591 -Node: Translate Program754446 -Ref: Translate Program-Footnote-1759011 -Node: Labels Program759281 -Ref: Labels Program-Footnote-1762632 -Node: Word Sorting762716 -Node: History Sorting766788 -Node: Extract Program768623 -Node: Simple Sed776152 -Node: Igawk Program779226 -Ref: Igawk Program-Footnote-1793557 -Ref: Igawk Program-Footnote-2793759 -Ref: Igawk Program-Footnote-3793881 -Node: Anagram Program793996 -Node: Signature Program797058 -Node: Programs Summary798305 -Node: Programs Exercises799519 -Ref: Programs Exercises-Footnote-1803648 -Node: Advanced Features803739 -Node: Nondecimal Data805729 -Node: Array Sorting807320 -Node: Controlling Array Traversal808020 -Ref: Controlling Array Traversal-Footnote-1816387 -Node: Array Sorting Functions816505 -Ref: Array Sorting Functions-Footnote-1821596 -Node: Two-way I/O821792 -Ref: Two-way I/O-Footnote-1828343 -Ref: Two-way I/O-Footnote-2828530 -Node: TCP/IP Networking828612 -Node: Profiling831730 -Ref: Profiling-Footnote-1840402 -Node: Advanced Features Summary840725 -Node: Internationalization842569 -Node: I18N and L10N844049 -Node: Explaining gettext844736 -Ref: Explaining gettext-Footnote-1850628 -Ref: Explaining gettext-Footnote-2850813 -Node: Programmer i18n850978 -Ref: Programmer i18n-Footnote-1855927 -Node: Translator i18n855976 -Node: String Extraction856770 -Ref: String Extraction-Footnote-1857902 -Node: Printf Ordering857988 -Ref: Printf Ordering-Footnote-1860774 -Node: I18N Portability860838 -Ref: I18N Portability-Footnote-1863294 -Node: I18N Example863357 -Ref: I18N Example-Footnote-1866163 -Node: Gawk I18N866236 -Node: I18N Summary866881 -Node: Debugger868222 -Node: Debugging869244 -Node: Debugging Concepts869685 -Node: Debugging Terms871494 -Node: Awk Debugging874069 -Node: Sample Debugging Session874975 -Node: Debugger Invocation875509 -Node: Finding The Bug876895 -Node: List of Debugger Commands883373 -Node: Breakpoint Control884706 -Node: Debugger Execution Control888400 -Node: Viewing And Changing Data891762 -Node: Execution Stack895136 -Node: Debugger Info896773 -Node: Miscellaneous Debugger Commands900844 -Node: Readline Support905932 -Node: Limitations906828 -Node: Debugging Summary908937 -Node: Arbitrary Precision Arithmetic910216 -Node: Computer Arithmetic911701 -Ref: table-numeric-ranges915292 -Ref: Computer Arithmetic-Footnote-1916014 -Node: Math Definitions916071 -Ref: table-ieee-formats919385 -Ref: Math Definitions-Footnote-1919988 -Node: MPFR features920093 -Node: FP Math Caution921810 -Ref: FP Math Caution-Footnote-1922882 -Node: Inexactness of computations923251 -Node: Inexact representation924211 -Node: Comparing FP Values925571 -Node: Errors accumulate926653 -Node: Getting Accuracy928086 -Node: Try To Round930796 -Node: Setting precision931695 -Ref: table-predefined-precision-strings932392 -Node: Setting the rounding mode934222 -Ref: table-gawk-rounding-modes934596 -Ref: Setting the rounding mode-Footnote-1938004 -Node: Arbitrary Precision Integers938183 -Ref: Arbitrary Precision Integers-Footnote-1941358 -Node: Checking for MPFR941507 -Node: POSIX Floating Point Problems942804 -Ref: POSIX Floating Point Problems-Footnote-1946675 -Node: Floating point summary946713 -Node: Dynamic Extensions948903 -Node: Extension Intro950456 -Node: Plugin License951722 -Node: Extension Mechanism Outline952519 -Ref: figure-load-extension952958 -Ref: figure-register-new-function954523 -Ref: figure-call-new-function955615 -Node: Extension API Description957677 -Node: Extension API Functions Introduction959319 -Node: General Data Types964859 -Ref: General Data Types-Footnote-1972980 -Node: Memory Allocation Functions973279 -Ref: Memory Allocation Functions-Footnote-1977487 -Node: Constructor Functions977586 -Node: Registration Functions981172 -Node: Extension Functions981857 -Node: Exit Callback Functions987072 -Node: Extension Version String988322 -Node: Input Parsers988985 -Node: Output Wrappers1001706 -Node: Two-way processors1006218 -Node: Printing Messages1008483 -Ref: Printing Messages-Footnote-11009654 -Node: Updating ERRNO1009807 -Node: Requesting Values1010546 -Ref: table-value-types-returned1011283 -Node: Accessing Parameters1012219 -Node: Symbol Table Access1013454 -Node: Symbol table by name1013966 -Node: Symbol table by cookie1015755 -Ref: Symbol table by cookie-Footnote-11019940 -Node: Cached values1020004 -Ref: Cached values-Footnote-11023540 -Node: Array Manipulation1023693 -Ref: Array Manipulation-Footnote-11024784 -Node: Array Data Types1024821 -Ref: Array Data Types-Footnote-11027479 -Node: Array Functions1027571 -Node: Flattening Arrays1032069 -Node: Creating Arrays1039045 -Node: Redirection API1043814 -Node: Extension API Variables1046647 -Node: Extension Versioning1047358 -Ref: gawk-api-version1047787 -Node: Extension GMP/MPFR Versioning1049515 -Node: Extension API Informational Variables1051143 -Node: Extension API Boilerplate1052216 -Node: Changes from API V11056190 -Node: Finding Extensions1056850 -Node: Extension Example1057409 -Node: Internal File Description1058207 -Node: Internal File Ops1062287 -Ref: Internal File Ops-Footnote-11073687 -Node: Using Internal File Ops1073827 -Ref: Using Internal File Ops-Footnote-11076210 -Node: Extension Samples1076484 -Node: Extension Sample File Functions1078013 -Node: Extension Sample Fnmatch1085662 -Node: Extension Sample Fork1087149 -Node: Extension Sample Inplace1088367 -Node: Extension Sample Ord1091584 -Node: Extension Sample Readdir1092420 -Ref: table-readdir-file-types1093309 -Node: Extension Sample Revout1094114 -Node: Extension Sample Rev2way1094703 -Node: Extension Sample Read write array1095443 -Node: Extension Sample Readfile1097385 -Node: Extension Sample Time1098480 -Node: Extension Sample API Tests1099828 -Node: gawkextlib1100320 -Node: Extension summary1102767 -Node: Extension Exercises1106469 -Node: Language History1107967 -Node: V7/SVR3.11109623 -Node: SVR41111775 -Node: POSIX1113209 -Node: BTL1114588 -Node: POSIX/GNU1115317 -Node: Feature History1121095 -Node: Common Extensions1136954 -Node: Ranges and Locales1138237 -Ref: Ranges and Locales-Footnote-11142853 -Ref: Ranges and Locales-Footnote-21142880 -Ref: Ranges and Locales-Footnote-31143115 -Node: Contributors1143336 -Node: History summary1149281 -Node: Installation1150661 -Node: Gawk Distribution1151605 -Node: Getting1152089 -Node: Extracting1153050 -Node: Distribution contents1154688 -Node: Unix Installation1161168 -Node: Quick Installation1161850 -Node: Shell Startup Files1164264 -Node: Additional Configuration Options1165353 -Node: Configuration Philosophy1167342 -Node: Non-Unix Installation1169711 -Node: PC Installation1170171 -Node: PC Binary Installation1171009 -Node: PC Compiling1171444 -Node: PC Using1172561 -Node: Cygwin1175606 -Node: MSYS1176376 -Node: VMS Installation1176877 -Node: VMS Compilation1177668 -Ref: VMS Compilation-Footnote-11178897 -Node: VMS Dynamic Extensions1178955 -Node: VMS Installation Details1180640 -Node: VMS Running1182893 -Node: VMS GNV1187172 -Node: VMS Old Gawk1187907 -Node: Bugs1188378 -Node: Bug address1189041 -Node: Usenet1191438 -Node: Maintainers1192215 -Node: Other Versions1193476 -Node: Installation summary1200060 -Node: Notes1201102 -Node: Compatibility Mode1201967 -Node: Additions1202749 -Node: Accessing The Source1203674 -Node: Adding Code1205109 -Node: New Ports1211327 -Node: Derived Files1215815 -Ref: Derived Files-Footnote-11221300 -Ref: Derived Files-Footnote-21221335 -Ref: Derived Files-Footnote-31221933 -Node: Future Extensions1222047 -Node: Implementation Limitations1222705 -Node: Extension Design1223888 -Node: Old Extension Problems1225042 -Ref: Old Extension Problems-Footnote-11226560 -Node: Extension New Mechanism Goals1226617 -Ref: Extension New Mechanism Goals-Footnote-11229981 -Node: Extension Other Design Decisions1230170 -Node: Extension Future Growth1232283 -Node: Old Extension Mechanism1233119 -Node: Notes summary1234882 -Node: Basic Concepts1236064 -Node: Basic High Level1236745 -Ref: figure-general-flow1237027 -Ref: figure-process-flow1237712 -Ref: Basic High Level-Footnote-11241013 -Node: Basic Data Typing1241198 -Node: Glossary1244526 -Node: Copying1276473 -Node: GNU Free Documentation License1314012 -Node: Index1339130 +Node: Manual History65248 +Ref: Manual History-Footnote-168245 +Ref: Manual History-Footnote-268286 +Node: How To Contribute68360 +Node: Acknowledgments69011 +Node: Getting Started73919 +Node: Running gawk76358 +Node: One-shot77548 +Node: Read Terminal78811 +Node: Long80804 +Node: Executable Scripts82317 +Ref: Executable Scripts-Footnote-185112 +Node: Comments85215 +Node: Quoting87699 +Node: DOS Quoting93216 +Node: Sample Data Files95272 +Node: Very Simple97867 +Node: Two Rules102769 +Node: More Complex104654 +Node: Statements/Lines107520 +Ref: Statements/Lines-Footnote-1111979 +Node: Other Features112244 +Node: When113180 +Ref: When-Footnote-1114934 +Node: Intro Summary114999 +Node: Invoking Gawk115883 +Node: Command Line117397 +Node: Options118195 +Ref: Options-Footnote-1134814 +Ref: Options-Footnote-2135045 +Node: Other Arguments135070 +Node: Naming Standard Input138017 +Node: Environment Variables139110 +Node: AWKPATH Variable139668 +Ref: AWKPATH Variable-Footnote-1143080 +Ref: AWKPATH Variable-Footnote-2143114 +Node: AWKLIBPATH Variable143375 +Node: Other Environment Variables144632 +Node: Exit Status148453 +Node: Include Files149130 +Node: Loading Shared Libraries152725 +Node: Obsolete154153 +Node: Undocumented154845 +Node: Invoking Summary155142 +Node: Regexp156802 +Node: Regexp Usage158256 +Node: Escape Sequences160293 +Node: Regexp Operators166525 +Ref: Regexp Operators-Footnote-1173941 +Ref: Regexp Operators-Footnote-2174088 +Node: Bracket Expressions174186 +Ref: table-char-classes176662 +Node: Leftmost Longest179799 +Node: Computed Regexps181102 +Node: GNU Regexp Operators184529 +Node: Case-sensitivity188208 +Ref: Case-sensitivity-Footnote-1191095 +Ref: Case-sensitivity-Footnote-2191330 +Node: Regexp Summary191438 +Node: Reading Files192904 +Node: Records195173 +Node: awk split records195906 +Node: gawk split records200837 +Ref: gawk split records-Footnote-1205377 +Node: Fields205414 +Node: Nonconstant Fields208155 +Ref: Nonconstant Fields-Footnote-1210391 +Node: Changing Fields210595 +Node: Field Separators216523 +Node: Default Field Splitting219221 +Node: Regexp Field Splitting220339 +Node: Single Character Fields223692 +Node: Command Line Field Separator224752 +Node: Full Line Fields227970 +Ref: Full Line Fields-Footnote-1229492 +Ref: Full Line Fields-Footnote-2229538 +Node: Field Splitting Summary229639 +Node: Constant Size231713 +Node: Fixed width data232445 +Node: Skipping intervening235912 +Node: Allowing trailing data236710 +Node: Fields with fixed data237747 +Node: Splitting By Content239265 +Ref: Splitting By Content-Footnote-1242915 +Node: Testing field creation243078 +Node: Multiple Line244699 +Ref: Multiple Line-Footnote-1250583 +Node: Getline250762 +Node: Plain Getline253231 +Node: Getline/Variable255872 +Node: Getline/File257023 +Node: Getline/Variable/File258411 +Ref: Getline/Variable/File-Footnote-1260016 +Node: Getline/Pipe260104 +Node: Getline/Variable/Pipe262811 +Node: Getline/Coprocess263946 +Node: Getline/Variable/Coprocess265213 +Node: Getline Notes265955 +Node: Getline Summary268752 +Ref: table-getline-variants269176 +Node: Read Timeout269924 +Ref: Read Timeout-Footnote-1273830 +Node: Retrying Input273888 +Node: Command-line directories275087 +Node: Input Summary275993 +Node: Input Exercises279165 +Node: Printing279893 +Node: Print281727 +Node: Print Examples283184 +Node: Output Separators285964 +Node: OFMT287981 +Node: Printf289337 +Node: Basic Printf290122 +Node: Control Letters291696 +Node: Format Modifiers295684 +Node: Printf Examples301699 +Node: Redirection304185 +Node: Special FD311026 +Ref: Special FD-Footnote-1314194 +Node: Special Files314268 +Node: Other Inherited Files314885 +Node: Special Network315886 +Node: Special Caveats316746 +Node: Close Files And Pipes317695 +Ref: table-close-pipe-return-values324602 +Ref: Close Files And Pipes-Footnote-1325385 +Ref: Close Files And Pipes-Footnote-2325533 +Node: Nonfatal325685 +Node: Output Summary328010 +Node: Output Exercises329232 +Node: Expressions329911 +Node: Values331099 +Node: Constants331777 +Node: Scalar Constants332468 +Ref: Scalar Constants-Footnote-1333332 +Node: Nondecimal-numbers333582 +Node: Regexp Constants336583 +Node: Using Constant Regexps337109 +Node: Standard Regexp Constants337731 +Node: Strong Regexp Constants340919 +Node: Variables343877 +Node: Using Variables344534 +Node: Assignment Options346444 +Node: Conversion348317 +Node: Strings And Numbers348841 +Ref: Strings And Numbers-Footnote-1351904 +Node: Locale influences conversions352013 +Ref: table-locale-affects354771 +Node: All Operators355389 +Node: Arithmetic Ops356018 +Node: Concatenation358524 +Ref: Concatenation-Footnote-1361371 +Node: Assignment Ops361478 +Ref: table-assign-ops366469 +Node: Increment Ops367782 +Node: Truth Values and Conditions371242 +Node: Truth Values372316 +Node: Typing and Comparison373364 +Node: Variable Typing374184 +Ref: Variable Typing-Footnote-1380647 +Ref: Variable Typing-Footnote-2380719 +Node: Comparison Operators380796 +Ref: table-relational-ops381215 +Node: POSIX String Comparison384710 +Ref: POSIX String Comparison-Footnote-1386405 +Ref: POSIX String Comparison-Footnote-2386544 +Node: Boolean Ops386628 +Ref: Boolean Ops-Footnote-1391110 +Node: Conditional Exp391202 +Node: Function Calls392938 +Node: Precedence396815 +Node: Locales400474 +Node: Expressions Summary402106 +Node: Patterns and Actions404679 +Node: Pattern Overview405799 +Node: Regexp Patterns407476 +Node: Expression Patterns408018 +Node: Ranges411799 +Node: BEGIN/END414907 +Node: Using BEGIN/END415668 +Ref: Using BEGIN/END-Footnote-1418404 +Node: I/O And BEGIN/END418510 +Node: BEGINFILE/ENDFILE420824 +Node: Empty423731 +Node: Using Shell Variables424048 +Node: Action Overview426322 +Node: Statements428647 +Node: If Statement430495 +Node: While Statement431990 +Node: Do Statement434018 +Node: For Statement435166 +Node: Switch Statement438324 +Node: Break Statement440710 +Node: Continue Statement442802 +Node: Next Statement444629 +Node: Nextfile Statement447012 +Node: Exit Statement449664 +Node: Built-in Variables452067 +Node: User-modified453200 +Node: Auto-set460967 +Ref: Auto-set-Footnote-1476564 +Ref: Auto-set-Footnote-2476770 +Node: ARGC and ARGV476826 +Node: Pattern Action Summary481039 +Node: Arrays483469 +Node: Array Basics484798 +Node: Array Intro485642 +Ref: figure-array-elements487617 +Ref: Array Intro-Footnote-1490321 +Node: Reference to Elements490449 +Node: Assigning Elements492913 +Node: Array Example493404 +Node: Scanning an Array495163 +Node: Controlling Scanning498185 +Ref: Controlling Scanning-Footnote-1503584 +Node: Numeric Array Subscripts503900 +Node: Uninitialized Subscripts506084 +Node: Delete507703 +Ref: Delete-Footnote-1510455 +Node: Multidimensional510512 +Node: Multiscanning513607 +Node: Arrays of Arrays515198 +Node: Arrays Summary519965 +Node: Functions522058 +Node: Built-in523096 +Node: Calling Built-in524177 +Node: Numeric Functions526173 +Ref: Numeric Functions-Footnote-1530201 +Ref: Numeric Functions-Footnote-2530558 +Ref: Numeric Functions-Footnote-3530606 +Node: String Functions530878 +Ref: String Functions-Footnote-1554536 +Ref: String Functions-Footnote-2554664 +Ref: String Functions-Footnote-3554912 +Node: Gory Details554999 +Ref: table-sub-escapes556790 +Ref: table-sub-proposed558309 +Ref: table-posix-sub559672 +Ref: table-gensub-escapes561213 +Ref: Gory Details-Footnote-1562036 +Node: I/O Functions562190 +Ref: table-system-return-values568772 +Ref: I/O Functions-Footnote-1570752 +Ref: I/O Functions-Footnote-2570900 +Node: Time Functions571020 +Ref: Time Functions-Footnote-1581687 +Ref: Time Functions-Footnote-2581755 +Ref: Time Functions-Footnote-3581913 +Ref: Time Functions-Footnote-4582024 +Ref: Time Functions-Footnote-5582136 +Ref: Time Functions-Footnote-6582363 +Node: Bitwise Functions582629 +Ref: table-bitwise-ops583223 +Ref: Bitwise Functions-Footnote-1589256 +Ref: Bitwise Functions-Footnote-2589429 +Node: Type Functions589620 +Node: I18N Functions592537 +Node: User-defined594188 +Node: Definition Syntax594993 +Ref: Definition Syntax-Footnote-1600680 +Node: Function Example600751 +Ref: Function Example-Footnote-1603673 +Node: Function Caveats603695 +Node: Calling A Function604213 +Node: Variable Scope605171 +Node: Pass By Value/Reference608165 +Node: Return Statement611664 +Node: Dynamic Typing614643 +Node: Indirect Calls615573 +Ref: Indirect Calls-Footnote-1625824 +Node: Functions Summary625952 +Node: Library Functions628657 +Ref: Library Functions-Footnote-1632264 +Ref: Library Functions-Footnote-2632407 +Node: Library Names632578 +Ref: Library Names-Footnote-1636038 +Ref: Library Names-Footnote-2636261 +Node: General Functions636347 +Node: Strtonum Function637450 +Node: Assert Function640472 +Node: Round Function643798 +Node: Cliff Random Function645339 +Node: Ordinal Functions646355 +Ref: Ordinal Functions-Footnote-1649418 +Ref: Ordinal Functions-Footnote-2649670 +Node: Join Function649880 +Ref: Join Function-Footnote-1651650 +Node: Getlocaltime Function651850 +Node: Readfile Function655592 +Node: Shell Quoting657564 +Node: Data File Management658965 +Node: Filetrans Function659597 +Node: Rewind Function663693 +Node: File Checking665603 +Ref: File Checking-Footnote-1666937 +Node: Empty Files667138 +Node: Ignoring Assigns669117 +Node: Getopt Function670667 +Ref: Getopt Function-Footnote-1682136 +Node: Passwd Functions682336 +Ref: Passwd Functions-Footnote-1691175 +Node: Group Functions691263 +Ref: Group Functions-Footnote-1699161 +Node: Walking Arrays699368 +Node: Library Functions Summary702376 +Node: Library Exercises703782 +Node: Sample Programs704247 +Node: Running Examples705017 +Node: Clones705745 +Node: Cut Program706969 +Node: Egrep Program716898 +Ref: Egrep Program-Footnote-1724410 +Node: Id Program724520 +Node: Split Program728200 +Ref: Split Program-Footnote-1731659 +Node: Tee Program731788 +Node: Uniq Program734578 +Node: Wc Program742004 +Ref: Wc Program-Footnote-1746259 +Node: Miscellaneous Programs746353 +Node: Dupword Program747566 +Node: Alarm Program749596 +Node: Translate Program754451 +Ref: Translate Program-Footnote-1759016 +Node: Labels Program759286 +Ref: Labels Program-Footnote-1762637 +Node: Word Sorting762721 +Node: History Sorting766793 +Node: Extract Program768628 +Node: Simple Sed776158 +Node: Igawk Program779232 +Ref: Igawk Program-Footnote-1793563 +Ref: Igawk Program-Footnote-2793765 +Ref: Igawk Program-Footnote-3793887 +Node: Anagram Program794002 +Node: Signature Program797064 +Node: Programs Summary798311 +Node: Programs Exercises799525 +Ref: Programs Exercises-Footnote-1803654 +Node: Advanced Features803745 +Node: Nondecimal Data805735 +Node: Array Sorting807326 +Node: Controlling Array Traversal808026 +Ref: Controlling Array Traversal-Footnote-1816393 +Node: Array Sorting Functions816511 +Ref: Array Sorting Functions-Footnote-1821602 +Node: Two-way I/O821798 +Ref: Two-way I/O-Footnote-1828350 +Ref: Two-way I/O-Footnote-2828537 +Node: TCP/IP Networking828619 +Node: Profiling831737 +Ref: Profiling-Footnote-1840409 +Node: Advanced Features Summary840732 +Node: Internationalization842576 +Node: I18N and L10N844056 +Node: Explaining gettext844743 +Ref: Explaining gettext-Footnote-1850635 +Ref: Explaining gettext-Footnote-2850820 +Node: Programmer i18n850985 +Ref: Programmer i18n-Footnote-1855934 +Node: Translator i18n855983 +Node: String Extraction856777 +Ref: String Extraction-Footnote-1857909 +Node: Printf Ordering857995 +Ref: Printf Ordering-Footnote-1860781 +Node: I18N Portability860845 +Ref: I18N Portability-Footnote-1863301 +Node: I18N Example863364 +Ref: I18N Example-Footnote-1866170 +Node: Gawk I18N866243 +Node: I18N Summary866888 +Node: Debugger868229 +Node: Debugging869252 +Node: Debugging Concepts869693 +Node: Debugging Terms871502 +Node: Awk Debugging874077 +Node: Sample Debugging Session874983 +Node: Debugger Invocation875517 +Node: Finding The Bug876903 +Node: List of Debugger Commands883381 +Node: Breakpoint Control884714 +Node: Debugger Execution Control888408 +Node: Viewing And Changing Data891770 +Node: Execution Stack895144 +Node: Debugger Info896781 +Node: Miscellaneous Debugger Commands900852 +Node: Readline Support905940 +Node: Limitations906836 +Node: Debugging Summary908945 +Node: Arbitrary Precision Arithmetic910224 +Node: Computer Arithmetic911709 +Ref: table-numeric-ranges915300 +Ref: Computer Arithmetic-Footnote-1916022 +Node: Math Definitions916079 +Ref: table-ieee-formats919393 +Ref: Math Definitions-Footnote-1919996 +Node: MPFR features920101 +Node: FP Math Caution921818 +Ref: FP Math Caution-Footnote-1922890 +Node: Inexactness of computations923259 +Node: Inexact representation924219 +Node: Comparing FP Values925579 +Node: Errors accumulate926661 +Node: Getting Accuracy928094 +Node: Try To Round930804 +Node: Setting precision931703 +Ref: table-predefined-precision-strings932400 +Node: Setting the rounding mode934230 +Ref: table-gawk-rounding-modes934604 +Ref: Setting the rounding mode-Footnote-1938012 +Node: Arbitrary Precision Integers938191 +Ref: Arbitrary Precision Integers-Footnote-1941366 +Node: Checking for MPFR941515 +Node: POSIX Floating Point Problems942812 +Ref: POSIX Floating Point Problems-Footnote-1946683 +Node: Floating point summary946721 +Node: Dynamic Extensions948911 +Node: Extension Intro950464 +Node: Plugin License951730 +Node: Extension Mechanism Outline952527 +Ref: figure-load-extension952966 +Ref: figure-register-new-function954531 +Ref: figure-call-new-function955623 +Node: Extension API Description957685 +Node: Extension API Functions Introduction959327 +Node: General Data Types964867 +Ref: General Data Types-Footnote-1972988 +Node: Memory Allocation Functions973287 +Ref: Memory Allocation Functions-Footnote-1977495 +Node: Constructor Functions977594 +Node: Registration Functions981180 +Node: Extension Functions981865 +Node: Exit Callback Functions987080 +Node: Extension Version String988330 +Node: Input Parsers988993 +Node: Output Wrappers1001714 +Node: Two-way processors1006226 +Node: Printing Messages1008491 +Ref: Printing Messages-Footnote-11009662 +Node: Updating ERRNO1009815 +Node: Requesting Values1010554 +Ref: table-value-types-returned1011291 +Node: Accessing Parameters1012227 +Node: Symbol Table Access1013462 +Node: Symbol table by name1013974 +Node: Symbol table by cookie1015763 +Ref: Symbol table by cookie-Footnote-11019948 +Node: Cached values1020012 +Ref: Cached values-Footnote-11023548 +Node: Array Manipulation1023701 +Ref: Array Manipulation-Footnote-11024792 +Node: Array Data Types1024829 +Ref: Array Data Types-Footnote-11027487 +Node: Array Functions1027579 +Node: Flattening Arrays1032077 +Node: Creating Arrays1039053 +Node: Redirection API1043822 +Node: Extension API Variables1046655 +Node: Extension Versioning1047366 +Ref: gawk-api-version1047795 +Node: Extension GMP/MPFR Versioning1049523 +Node: Extension API Informational Variables1051151 +Node: Extension API Boilerplate1052224 +Node: Changes from API V11056198 +Node: Finding Extensions1056858 +Node: Extension Example1057417 +Node: Internal File Description1058215 +Node: Internal File Ops1062295 +Ref: Internal File Ops-Footnote-11073695 +Node: Using Internal File Ops1073835 +Ref: Using Internal File Ops-Footnote-11076218 +Node: Extension Samples1076492 +Node: Extension Sample File Functions1078021 +Node: Extension Sample Fnmatch1085670 +Node: Extension Sample Fork1087157 +Node: Extension Sample Inplace1088375 +Node: Extension Sample Ord1091592 +Node: Extension Sample Readdir1092428 +Ref: table-readdir-file-types1093317 +Node: Extension Sample Revout1094122 +Node: Extension Sample Rev2way1094711 +Node: Extension Sample Read write array1095451 +Node: Extension Sample Readfile1097393 +Node: Extension Sample Time1098488 +Node: Extension Sample API Tests1099836 +Node: gawkextlib1100328 +Node: Extension summary1102779 +Node: Extension Exercises1106481 +Node: Language History1107979 +Node: V7/SVR3.11109635 +Node: SVR41111787 +Node: POSIX1113221 +Node: BTL1114600 +Node: POSIX/GNU1115329 +Node: Feature History1121107 +Node: Common Extensions1136966 +Node: Ranges and Locales1138249 +Ref: Ranges and Locales-Footnote-11142865 +Ref: Ranges and Locales-Footnote-21142892 +Ref: Ranges and Locales-Footnote-31143127 +Node: Contributors1143348 +Node: History summary1149293 +Node: Installation1150673 +Node: Gawk Distribution1151617 +Node: Getting1152101 +Node: Extracting1153064 +Node: Distribution contents1154702 +Node: Unix Installation1161182 +Node: Quick Installation1161864 +Node: Shell Startup Files1164278 +Node: Additional Configuration Options1165367 +Node: Configuration Philosophy1167356 +Node: Non-Unix Installation1169725 +Node: PC Installation1170185 +Node: PC Binary Installation1171023 +Node: PC Compiling1171458 +Node: PC Using1172575 +Node: Cygwin1175620 +Node: MSYS1176390 +Node: VMS Installation1176891 +Node: VMS Compilation1177682 +Ref: VMS Compilation-Footnote-11178911 +Node: VMS Dynamic Extensions1178969 +Node: VMS Installation Details1180654 +Node: VMS Running1182907 +Node: VMS GNV1187186 +Node: VMS Old Gawk1187921 +Node: Bugs1188392 +Node: Bug address1189055 +Node: Usenet1191452 +Node: Maintainers1192229 +Node: Other Versions1193490 +Node: Installation summary1200074 +Node: Notes1201276 +Node: Compatibility Mode1202141 +Node: Additions1202923 +Node: Accessing The Source1203848 +Node: Adding Code1205284 +Node: New Ports1211503 +Node: Derived Files1215991 +Ref: Derived Files-Footnote-11221637 +Ref: Derived Files-Footnote-21221672 +Ref: Derived Files-Footnote-31222270 +Node: Future Extensions1222384 +Node: Implementation Limitations1223042 +Node: Extension Design1224225 +Node: Old Extension Problems1225379 +Ref: Old Extension Problems-Footnote-11226897 +Node: Extension New Mechanism Goals1226954 +Ref: Extension New Mechanism Goals-Footnote-11230318 +Node: Extension Other Design Decisions1230507 +Node: Extension Future Growth1232620 +Node: Old Extension Mechanism1233456 +Node: Notes summary1235219 +Node: Basic Concepts1236401 +Node: Basic High Level1237082 +Ref: figure-general-flow1237364 +Ref: figure-process-flow1238049 +Ref: Basic High Level-Footnote-11241350 +Node: Basic Data Typing1241535 +Node: Glossary1244863 +Node: Copying1276810 +Node: GNU Free Documentation License1314349 +Node: Index1339467 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index ba28fc09..d2a4945d 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -64,7 +64,7 @@ @c applies to and all the info about who's publishing this edition @c These apply across the board. -@set UPDATE-MONTH August, 2017 +@set UPDATE-MONTH September, 2017 @set VERSION 4.2 @set PATCHLEVEL 0 @@ -282,7 +282,7 @@ Boston, MA 02110-1301 USA Phone: +1-617-542-5942 Fax: +1-617-542-2652 Email: <email>gnu@@gnu.org</email> -URL: <ulink url="http://www.gnu.org">http://www.gnu.org/</ulink></literallayout> +URL: <ulink url="https://www.gnu.org">https://www.gnu.org/</ulink></literallayout> <literallayout class="normal">Copyright © 1989, 1991, 1992, 1993, 1996–2005, 2007, 2009–2017 Free Software Foundation, Inc. @@ -312,7 +312,7 @@ A copy of the license is included in the section entitled @ifset FOR_PRINT A copy of the license may be found on the Internet at -@uref{http://www.gnu.org/software/gawk/manual/html_node/GNU-Free-Documentation-License.html, +@uref{https://www.gnu.org/software/gawk/manual/html_node/GNU-Free-Documentation-License.html, the GNU Project's website}. @end ifset @@ -364,7 +364,7 @@ Boston, MA 02110-1301 USA @* Phone: +1-617-542-5942 @* Fax: +1-617-542-2652 @* Email: @email{gnu@@gnu.org} @* -URL: @uref{http://www.gnu.org/} @* +URL: @uref{https://www.gnu.org/} @* @c This one is correct for gawk 3.1.0 from the FSF ISBN 1-882114-28-0 @* @@ -1579,7 +1579,7 @@ This @value{DOCUMENT} has the difficult task of being both a tutorial and a refe If you are a novice, feel free to skip over details that seem too complex. You should also ignore the many cross-references; they are for the expert user and for the Info and -@uref{http://www.gnu.org/software/gawk/manual/, HTML} +@uref{https://www.gnu.org/software/gawk/manual/, HTML} versions of the @value{DOCUMENT}. @end ifnotinfo @@ -1789,7 +1789,7 @@ printed edition. You may find them online, as follows: @itemize @value{BULLET} @item -@uref{http://www.gnu.org/software/gawk/manual/html_node/Notes.html, +@uref{https://www.gnu.org/software/gawk/manual/html_node/Notes.html, The appendix on implementation notes} describes how to disable @command{gawk}'s extensions, how to contribute new code to @command{gawk}, where to find information on some possible @@ -1797,20 +1797,20 @@ future directions for @command{gawk} development, and the design decisions behind the extension API. @item -@uref{http://www.gnu.org/software/gawk/manual/html_node/Basic-Concepts.html, +@uref{https://www.gnu.org/software/gawk/manual/html_node/Basic-Concepts.html, The appendix on basic concepts} provides some very cursory background material for those who are completely unfamiliar with computer programming. @item -@uref{http://www.gnu.org/software/gawk/manual/html_node/Glossary.html, +@uref{https://www.gnu.org/software/gawk/manual/html_node/Glossary.html, The Glossary} defines most, if not all, of the significant terms used throughout the @value{DOCUMENT}. If you find terms that you aren't familiar with, try looking them up here. @item -@uref{http://www.gnu.org/software/gawk/manual/html_node/GNU-Free-Documentation-License.html, +@uref{https://www.gnu.org/software/gawk/manual/html_node/GNU-Free-Documentation-License.html, The GNU FDL} is the license that covers this @value{DOCUMENT}. @end itemize @@ -1826,7 +1826,7 @@ omitted from the print edition but are available online. @unnumberedsec Typographical Conventions @cindex Texinfo -This @value{DOCUMENT} is written in @uref{http://www.gnu.org/software/texinfo/, Texinfo}, +This @value{DOCUMENT} is written in @uref{https://www.gnu.org/software/texinfo/, Texinfo}, the GNU documentation formatting language. A single Texinfo source file is used to produce both the printed and online versions of the documentation. @@ -1973,9 +1973,9 @@ for your reference @end ifclear The GPL applies to the C language source code for @command{gawk}. To find out more about the FSF and the GNU Project online, -see @uref{http://www.gnu.org, the GNU Project's home page}. +see @uref{https://www.gnu.org, the GNU Project's home page}. This @value{DOCUMENT} may also be read from -@uref{http://www.gnu.org/software/gawk/manual/, GNU's website}. +@uref{https://www.gnu.org/software/gawk/manual/, GNU's website}. @ifclear FOR_PRINT A shell, an editor (Emacs), highly portable optimizing C, C++, and @@ -2061,7 +2061,7 @@ you should first look at the @file{NEWS} file in the @command{gawk} distribution, which provides a high-level summary of the changes in each release. -You can then look at the @uref{http://www.gnu.org/software/gawk/manual/, +You can then look at the @uref{https://www.gnu.org/software/gawk/manual/, online version} of this @value{DOCUMENT} to read about any new features. @end ifset @@ -4015,7 +4015,7 @@ that pass arguments through the URL; using this option prevents a malicious code (via @option{-e}) to the CGI application.@footnote{For more detail, please see Section 4.4 of @uref{http://www.ietf.org/rfc/rfc3875, RFC 3875}. Also see the -@uref{http://lists.gnu.org/archive/html/bug-gawk/2014-11/msg00022.html, +@uref{https://lists.gnu.org/archive/html/bug-gawk/2014-11/msg00022.html, explanatory note sent to the @command{gawk} bug mailing list}.} This option should be used @@ -4532,7 +4532,7 @@ again after adding the suffix @samp{.awk} to the @value{FN}. @command{gawk}'s path search mechanism is similar to the shell's. -(See @uref{http://www.gnu.org/software/bash/manual/, +(See @uref{https://www.gnu.org/software/bash/manual/, @cite{The Bourne-Again SHell manual}}.) It treats a null entry in the path as indicating the current directory. @@ -26372,7 +26372,7 @@ them in by hand. Here we present a program that can extract parts of a Texinfo input file into separate files. @cindex Texinfo -This @value{DOCUMENT} is written in @uref{http://www.gnu.org/software/texinfo/, Texinfo}, +This @value{DOCUMENT} is written in @uref{https://www.gnu.org/software/texinfo/, Texinfo}, the GNU Project's document formatting language. A single Texinfo source file can be used to produce both printed documentation, with @TeX{}, and online documentation. @@ -26380,7 +26380,7 @@ printed documentation, with @TeX{}, and online documentation. (Texinfo is fully documented in the book @cite{Texinfo---The GNU Documentation Format}, available from the Free Software Foundation, -and also available @uref{http://www.gnu.org/software/texinfo/manual/texinfo/, online}.) +and also available @uref{https://www.gnu.org/software/texinfo/manual/texinfo/, online}.) @end ifnotinfo @ifinfo (The Texinfo language is described fully, starting with @@ -27361,7 +27361,7 @@ certainty through the space-time continuum. #! /usr/bin/gawk -f # From "13.3.11 And Now For Something Completely Different" -# http://www.gnu.org/software/gawk/manual/html_node/Signature-Program.html#Signature-Program +# https://www.gnu.org/software/gawk/manual/html_node/Signature-Program.html#Signature-Program # Copyright © 2008 Davide Brini @@ -28389,7 +28389,7 @@ If your system does not have ptys, or if all the system's ptys are in use, Using ptys usually avoids the buffer deadlock issues described earlier, at some loss in performance. This is because the tty driver buffers and sends data line-by-line. On systems with the @command{stdbuf} -(part of the @uref{http://www.gnu.org/software/coreutils/coreutils.html, +(part of the @uref{https://www.gnu.org/software/coreutils/coreutils.html, GNU Coreutils package}), you can use that program instead of ptys. Note also that ptys are not fully transparent. Certain binary control @@ -28518,7 +28518,7 @@ See @end ifinfo @ifnotinfo See -@uref{http://www.gnu.org/software/gawk/manual/gawkinet/, +@uref{https://www.gnu.org/software/gawk/manual/gawkinet/, @cite{@value{GAWKINETTITLE}}}, which comes as part of the @command{gawk} distribution, @end ifnotinfo @@ -29738,7 +29738,7 @@ complete detail in @inforef{Top, , GNU @command{gettext} utilities, gettext, GNU @command{gettext} utilities}.) @end ifinfo @ifnotinfo -@uref{http://www.gnu.org/software/gettext/manual/, +@uref{https://www.gnu.org/software/gettext/manual/, @cite{GNU @command{gettext} utilities}}.) @end ifnotinfo As of this writing, the latest version of GNU @command{gettext} is @@ -29801,7 +29801,7 @@ any complexity. Thus, most programming languages have facilities available for ``debugging'' programs, and now @command{awk} is no exception. The @command{gawk} debugger is purposely modeled after -@uref{http://www.gnu.org/software/gdb/, the GNU Debugger (GDB)} +@uref{https://www.gnu.org/software/gdb/, the GNU Debugger (GDB)} command-line debugger. If you are familiar with GDB, learning how to use @command{gawk} for debugging your program is easy. @@ -32434,7 +32434,7 @@ and describes the @code{gawkextlib} project. goals and design. @end ifclear @ifset FOR_PRINT -See @uref{http://www.gnu.org/software/gawk/manual/html_node/Extension-Design.html} +See @uref{https://www.gnu.org/software/gawk/manual/html_node/Extension-Design.html} for a discussion of the extension mechanism goals and design. @end ifset @@ -36709,11 +36709,11 @@ You will need to have the @uref{http://expat.sourceforge.net, Expat} XML parser library installed in order to build and use the XML extension. In addition, you must have the GNU Autotools installed -(@uref{http://www.gnu.org/software/autoconf, Autoconf}, -@uref{http://www.gnu.org/software/automake, Automake}, -@uref{http://www.gnu.org/software/libtool, Libtool}, +(@uref{https://www.gnu.org/software/autoconf, Autoconf}, +@uref{https://www.gnu.org/software/automake, Automake}, +@uref{https://www.gnu.org/software/libtool, Libtool}, and -@uref{http://www.gnu.org/software/gettext, GNU @command{gettext}}). +@uref{https://www.gnu.org/software/gettext, GNU @command{gettext}}). The simple recipe for building and testing @code{gawkextlib} is as follows. First, build and install @command{gawk}: @@ -36960,7 +36960,7 @@ find more information. To save space, we have omitted information on the history of features in @command{gawk} from this edition. You can find it in the -@uref{http://www.gnu.org/software/gawk/manual/html_node/Feature-History.html, +@uref{https://www.gnu.org/software/gawk/manual/html_node/Feature-History.html, online documentation}. @end ifset @@ -38816,13 +38816,13 @@ If you have the @command{wget} program, you can use a command like the following: @example -wget http://ftp.gnu.org/gnu/gawk/gawk-@value{VERSION}.@value{PATCHLEVEL}.tar.gz +wget https://ftp.gnu.org/gnu/gawk/gawk-@value{VERSION}.@value{PATCHLEVEL}.tar.gz @end example @end itemize The GNU software archive is mirrored around the world. The up-to-date list of mirror sites is available from -@uref{http://www.gnu.org/order/ftp.html, the main FSF website}. +@uref{https://www.gnu.org/order/ftp.html, the main FSF website}. Try to use one of the mirrors; they will be less busy, and you can usually find one closer to your site. @@ -39111,7 +39111,7 @@ is generated automatically using GNU Autoconf. described fully in @cite{Autoconf---Generating Automatic Configuration Scripts}, which can be found online at -@uref{http://www.gnu.org/software/autoconf/manual/index.html, +@uref{https://www.gnu.org/software/autoconf/manual/index.html, the Free Software Foundation's website}.) @end ifnotinfo @ifinfo @@ -40296,12 +40296,18 @@ The @command{gawk} distribution is available from the GNU Project's main distribution site, @code{ftp.gnu.org}. The canonical build recipe is: @example -wget http://ftp.gnu.org/gnu/gawk/gawk-@value{VERSION}.@value{PATCHLEVEL}.tar.gz +wget https://ftp.gnu.org/gnu/gawk/gawk-@value{VERSION}.@value{PATCHLEVEL}.tar.gz tar -xvpzf gawk-@value{VERSION}.@value{PATCHLEVEL}.tar.gz cd gawk-@value{VERSION}.@value{PATCHLEVEL} ./configure && make && make check @end example +@quotation NOTE +Because of the @samp{https://} URL, you may have to supply the +@option{--no-check-certificate} option to @command{wget} to download +the file. +@end quotation + @item @command{gawk} may be built on non-POSIX systems as well. The currently supported systems are MS-Windows using @@ -40416,7 +40422,7 @@ firewall that does not allow you to use the Git native protocol, you can still access the repository using: @example -git clone http://git.savannah.gnu.org/r/gawk.git +git clone https://git.savannah.gnu.org/r/gawk.git @end example Once you have made changes, you can use @samp{git diff} to produce a @@ -40476,7 +40482,7 @@ This document describes how GNU software should be written. If you haven't read it, please do so, preferably @emph{before} starting to modify @command{gawk}. (The @cite{GNU Coding Standards} are available from the GNU Project's -@uref{http://www.gnu.org/prep/standards/, website}. +@uref{https://www.gnu.org/prep/standards/, website}. Texinfo, Info, and DVI versions are also available.) @cindex @command{gawk}, coding style in @@ -40866,13 +40872,19 @@ Installing from source is quite easy. It's how the maintainer worked for years He had @file{/usr/local/bin} at the front of his @env{PATH} and just did: @example -wget http://ftp.gnu.org/gnu/@var{package}/@var{package}-@var{x}.@var{y}.@var{z}.tar.gz +wget https://ftp.gnu.org/gnu/@var{package}/@var{package}-@var{x}.@var{y}.@var{z}.tar.gz tar -xpzvf @var{package}-@var{x}.@var{y}.@var{z}.tar.gz cd @var{package}-@var{x}.@var{y}.@var{z} ./configure && make && make check make install # as root @end example +@quotation NOTE +Because of the @samp{https://} URL, you may have to supply the +@option{--no-check-certificate} option to @command{wget} to download +the file. +@end quotation + @c @item @ignore These days the maintainer uses Ubuntu 12.04 which is medium current, but @@ -40918,7 +40930,7 @@ Fortunately, the Git server can meet this need. For any given branch named @var{branchname}, use: @example -wget http://git.savannah.gnu.org/cgit/gawk.git/snapshot/gawk-@var{branchname}.tar.gz +wget https://git.savannah.gnu.org/cgit/gawk.git/snapshot/gawk-@var{branchname}.tar.gz @end example @noindent diff --git a/doc/gawktexi.in b/doc/gawktexi.in index 46eed243..2a30a876 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -59,7 +59,7 @@ @c applies to and all the info about who's publishing this edition @c These apply across the board. -@set UPDATE-MONTH August, 2017 +@set UPDATE-MONTH September, 2017 @set VERSION 4.2 @set PATCHLEVEL 0 @@ -277,7 +277,7 @@ Boston, MA 02110-1301 USA Phone: +1-617-542-5942 Fax: +1-617-542-2652 Email: <email>gnu@@gnu.org</email> -URL: <ulink url="http://www.gnu.org">http://www.gnu.org/</ulink></literallayout> +URL: <ulink url="https://www.gnu.org">https://www.gnu.org/</ulink></literallayout> <literallayout class="normal">Copyright © 1989, 1991, 1992, 1993, 1996–2005, 2007, 2009–2017 Free Software Foundation, Inc. @@ -307,7 +307,7 @@ A copy of the license is included in the section entitled @ifset FOR_PRINT A copy of the license may be found on the Internet at -@uref{http://www.gnu.org/software/gawk/manual/html_node/GNU-Free-Documentation-License.html, +@uref{https://www.gnu.org/software/gawk/manual/html_node/GNU-Free-Documentation-License.html, the GNU Project's website}. @end ifset @@ -359,7 +359,7 @@ Boston, MA 02110-1301 USA @* Phone: +1-617-542-5942 @* Fax: +1-617-542-2652 @* Email: @email{gnu@@gnu.org} @* -URL: @uref{http://www.gnu.org/} @* +URL: @uref{https://www.gnu.org/} @* @c This one is correct for gawk 3.1.0 from the FSF ISBN 1-882114-28-0 @* @@ -1546,7 +1546,7 @@ This @value{DOCUMENT} has the difficult task of being both a tutorial and a refe If you are a novice, feel free to skip over details that seem too complex. You should also ignore the many cross-references; they are for the expert user and for the Info and -@uref{http://www.gnu.org/software/gawk/manual/, HTML} +@uref{https://www.gnu.org/software/gawk/manual/, HTML} versions of the @value{DOCUMENT}. @end ifnotinfo @@ -1756,7 +1756,7 @@ printed edition. You may find them online, as follows: @itemize @value{BULLET} @item -@uref{http://www.gnu.org/software/gawk/manual/html_node/Notes.html, +@uref{https://www.gnu.org/software/gawk/manual/html_node/Notes.html, The appendix on implementation notes} describes how to disable @command{gawk}'s extensions, how to contribute new code to @command{gawk}, where to find information on some possible @@ -1764,20 +1764,20 @@ future directions for @command{gawk} development, and the design decisions behind the extension API. @item -@uref{http://www.gnu.org/software/gawk/manual/html_node/Basic-Concepts.html, +@uref{https://www.gnu.org/software/gawk/manual/html_node/Basic-Concepts.html, The appendix on basic concepts} provides some very cursory background material for those who are completely unfamiliar with computer programming. @item -@uref{http://www.gnu.org/software/gawk/manual/html_node/Glossary.html, +@uref{https://www.gnu.org/software/gawk/manual/html_node/Glossary.html, The Glossary} defines most, if not all, of the significant terms used throughout the @value{DOCUMENT}. If you find terms that you aren't familiar with, try looking them up here. @item -@uref{http://www.gnu.org/software/gawk/manual/html_node/GNU-Free-Documentation-License.html, +@uref{https://www.gnu.org/software/gawk/manual/html_node/GNU-Free-Documentation-License.html, The GNU FDL} is the license that covers this @value{DOCUMENT}. @end itemize @@ -1793,7 +1793,7 @@ omitted from the print edition but are available online. @unnumberedsec Typographical Conventions @cindex Texinfo -This @value{DOCUMENT} is written in @uref{http://www.gnu.org/software/texinfo/, Texinfo}, +This @value{DOCUMENT} is written in @uref{https://www.gnu.org/software/texinfo/, Texinfo}, the GNU documentation formatting language. A single Texinfo source file is used to produce both the printed and online versions of the documentation. @@ -1940,9 +1940,9 @@ for your reference @end ifclear The GPL applies to the C language source code for @command{gawk}. To find out more about the FSF and the GNU Project online, -see @uref{http://www.gnu.org, the GNU Project's home page}. +see @uref{https://www.gnu.org, the GNU Project's home page}. This @value{DOCUMENT} may also be read from -@uref{http://www.gnu.org/software/gawk/manual/, GNU's website}. +@uref{https://www.gnu.org/software/gawk/manual/, GNU's website}. @ifclear FOR_PRINT A shell, an editor (Emacs), highly portable optimizing C, C++, and @@ -2028,7 +2028,7 @@ you should first look at the @file{NEWS} file in the @command{gawk} distribution, which provides a high-level summary of the changes in each release. -You can then look at the @uref{http://www.gnu.org/software/gawk/manual/, +You can then look at the @uref{https://www.gnu.org/software/gawk/manual/, online version} of this @value{DOCUMENT} to read about any new features. @end ifset @@ -3926,7 +3926,7 @@ that pass arguments through the URL; using this option prevents a malicious code (via @option{-e}) to the CGI application.@footnote{For more detail, please see Section 4.4 of @uref{http://www.ietf.org/rfc/rfc3875, RFC 3875}. Also see the -@uref{http://lists.gnu.org/archive/html/bug-gawk/2014-11/msg00022.html, +@uref{https://lists.gnu.org/archive/html/bug-gawk/2014-11/msg00022.html, explanatory note sent to the @command{gawk} bug mailing list}.} This option should be used @@ -4443,7 +4443,7 @@ again after adding the suffix @samp{.awk} to the @value{FN}. @command{gawk}'s path search mechanism is similar to the shell's. -(See @uref{http://www.gnu.org/software/bash/manual/, +(See @uref{https://www.gnu.org/software/bash/manual/, @cite{The Bourne-Again SHell manual}}.) It treats a null entry in the path as indicating the current directory. @@ -25386,7 +25386,7 @@ them in by hand. Here we present a program that can extract parts of a Texinfo input file into separate files. @cindex Texinfo -This @value{DOCUMENT} is written in @uref{http://www.gnu.org/software/texinfo/, Texinfo}, +This @value{DOCUMENT} is written in @uref{https://www.gnu.org/software/texinfo/, Texinfo}, the GNU Project's document formatting language. A single Texinfo source file can be used to produce both printed documentation, with @TeX{}, and online documentation. @@ -25394,7 +25394,7 @@ printed documentation, with @TeX{}, and online documentation. (Texinfo is fully documented in the book @cite{Texinfo---The GNU Documentation Format}, available from the Free Software Foundation, -and also available @uref{http://www.gnu.org/software/texinfo/manual/texinfo/, online}.) +and also available @uref{https://www.gnu.org/software/texinfo/manual/texinfo/, online}.) @end ifnotinfo @ifinfo (The Texinfo language is described fully, starting with @@ -26375,7 +26375,7 @@ certainty through the space-time continuum. #! /usr/bin/gawk -f # From "13.3.11 And Now For Something Completely Different" -# http://www.gnu.org/software/gawk/manual/html_node/Signature-Program.html#Signature-Program +# https://www.gnu.org/software/gawk/manual/html_node/Signature-Program.html#Signature-Program # Copyright © 2008 Davide Brini @@ -27403,7 +27403,7 @@ If your system does not have ptys, or if all the system's ptys are in use, Using ptys usually avoids the buffer deadlock issues described earlier, at some loss in performance. This is because the tty driver buffers and sends data line-by-line. On systems with the @command{stdbuf} -(part of the @uref{http://www.gnu.org/software/coreutils/coreutils.html, +(part of the @uref{https://www.gnu.org/software/coreutils/coreutils.html, GNU Coreutils package}), you can use that program instead of ptys. Note also that ptys are not fully transparent. Certain binary control @@ -27532,7 +27532,7 @@ See @end ifinfo @ifnotinfo See -@uref{http://www.gnu.org/software/gawk/manual/gawkinet/, +@uref{https://www.gnu.org/software/gawk/manual/gawkinet/, @cite{@value{GAWKINETTITLE}}}, which comes as part of the @command{gawk} distribution, @end ifnotinfo @@ -28752,7 +28752,7 @@ complete detail in @inforef{Top, , GNU @command{gettext} utilities, gettext, GNU @command{gettext} utilities}.) @end ifinfo @ifnotinfo -@uref{http://www.gnu.org/software/gettext/manual/, +@uref{https://www.gnu.org/software/gettext/manual/, @cite{GNU @command{gettext} utilities}}.) @end ifnotinfo As of this writing, the latest version of GNU @command{gettext} is @@ -28815,7 +28815,7 @@ any complexity. Thus, most programming languages have facilities available for ``debugging'' programs, and now @command{awk} is no exception. The @command{gawk} debugger is purposely modeled after -@uref{http://www.gnu.org/software/gdb/, the GNU Debugger (GDB)} +@uref{https://www.gnu.org/software/gdb/, the GNU Debugger (GDB)} command-line debugger. If you are familiar with GDB, learning how to use @command{gawk} for debugging your program is easy. @@ -31448,7 +31448,7 @@ and describes the @code{gawkextlib} project. goals and design. @end ifclear @ifset FOR_PRINT -See @uref{http://www.gnu.org/software/gawk/manual/html_node/Extension-Design.html} +See @uref{https://www.gnu.org/software/gawk/manual/html_node/Extension-Design.html} for a discussion of the extension mechanism goals and design. @end ifset @@ -35723,11 +35723,11 @@ You will need to have the @uref{http://expat.sourceforge.net, Expat} XML parser library installed in order to build and use the XML extension. In addition, you must have the GNU Autotools installed -(@uref{http://www.gnu.org/software/autoconf, Autoconf}, -@uref{http://www.gnu.org/software/automake, Automake}, -@uref{http://www.gnu.org/software/libtool, Libtool}, +(@uref{https://www.gnu.org/software/autoconf, Autoconf}, +@uref{https://www.gnu.org/software/automake, Automake}, +@uref{https://www.gnu.org/software/libtool, Libtool}, and -@uref{http://www.gnu.org/software/gettext, GNU @command{gettext}}). +@uref{https://www.gnu.org/software/gettext, GNU @command{gettext}}). The simple recipe for building and testing @code{gawkextlib} is as follows. First, build and install @command{gawk}: @@ -35974,7 +35974,7 @@ find more information. To save space, we have omitted information on the history of features in @command{gawk} from this edition. You can find it in the -@uref{http://www.gnu.org/software/gawk/manual/html_node/Feature-History.html, +@uref{https://www.gnu.org/software/gawk/manual/html_node/Feature-History.html, online documentation}. @end ifset @@ -37830,13 +37830,13 @@ If you have the @command{wget} program, you can use a command like the following: @example -wget http://ftp.gnu.org/gnu/gawk/gawk-@value{VERSION}.@value{PATCHLEVEL}.tar.gz +wget https://ftp.gnu.org/gnu/gawk/gawk-@value{VERSION}.@value{PATCHLEVEL}.tar.gz @end example @end itemize The GNU software archive is mirrored around the world. The up-to-date list of mirror sites is available from -@uref{http://www.gnu.org/order/ftp.html, the main FSF website}. +@uref{https://www.gnu.org/order/ftp.html, the main FSF website}. Try to use one of the mirrors; they will be less busy, and you can usually find one closer to your site. @@ -38125,7 +38125,7 @@ is generated automatically using GNU Autoconf. described fully in @cite{Autoconf---Generating Automatic Configuration Scripts}, which can be found online at -@uref{http://www.gnu.org/software/autoconf/manual/index.html, +@uref{https://www.gnu.org/software/autoconf/manual/index.html, the Free Software Foundation's website}.) @end ifnotinfo @ifinfo @@ -39310,12 +39310,18 @@ The @command{gawk} distribution is available from the GNU Project's main distribution site, @code{ftp.gnu.org}. The canonical build recipe is: @example -wget http://ftp.gnu.org/gnu/gawk/gawk-@value{VERSION}.@value{PATCHLEVEL}.tar.gz +wget https://ftp.gnu.org/gnu/gawk/gawk-@value{VERSION}.@value{PATCHLEVEL}.tar.gz tar -xvpzf gawk-@value{VERSION}.@value{PATCHLEVEL}.tar.gz cd gawk-@value{VERSION}.@value{PATCHLEVEL} ./configure && make && make check @end example +@quotation NOTE +Because of the @samp{https://} URL, you may have to supply the +@option{--no-check-certificate} option to @command{wget} to download +the file. +@end quotation + @item @command{gawk} may be built on non-POSIX systems as well. The currently supported systems are MS-Windows using @@ -39430,7 +39436,7 @@ firewall that does not allow you to use the Git native protocol, you can still access the repository using: @example -git clone http://git.savannah.gnu.org/r/gawk.git +git clone https://git.savannah.gnu.org/r/gawk.git @end example Once you have made changes, you can use @samp{git diff} to produce a @@ -39490,7 +39496,7 @@ This document describes how GNU software should be written. If you haven't read it, please do so, preferably @emph{before} starting to modify @command{gawk}. (The @cite{GNU Coding Standards} are available from the GNU Project's -@uref{http://www.gnu.org/prep/standards/, website}. +@uref{https://www.gnu.org/prep/standards/, website}. Texinfo, Info, and DVI versions are also available.) @cindex @command{gawk}, coding style in @@ -39880,13 +39886,19 @@ Installing from source is quite easy. It's how the maintainer worked for years He had @file{/usr/local/bin} at the front of his @env{PATH} and just did: @example -wget http://ftp.gnu.org/gnu/@var{package}/@var{package}-@var{x}.@var{y}.@var{z}.tar.gz +wget https://ftp.gnu.org/gnu/@var{package}/@var{package}-@var{x}.@var{y}.@var{z}.tar.gz tar -xpzvf @var{package}-@var{x}.@var{y}.@var{z}.tar.gz cd @var{package}-@var{x}.@var{y}.@var{z} ./configure && make && make check make install # as root @end example +@quotation NOTE +Because of the @samp{https://} URL, you may have to supply the +@option{--no-check-certificate} option to @command{wget} to download +the file. +@end quotation + @c @item @ignore These days the maintainer uses Ubuntu 12.04 which is medium current, but @@ -39932,7 +39944,7 @@ Fortunately, the Git server can meet this need. For any given branch named @var{branchname}, use: @example -wget http://git.savannah.gnu.org/cgit/gawk.git/snapshot/gawk-@var{branchname}.tar.gz +wget https://git.savannah.gnu.org/cgit/gawk.git/snapshot/gawk-@var{branchname}.tar.gz @end example @noindent |