diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/ChangeLog | 9 | ||||
| -rw-r--r-- | doc/gawk.info | 253 | ||||
| -rw-r--r-- | doc/gawk.texi | 7 | ||||
| -rw-r--r-- | doc/gawktexi.in | 7 |
4 files changed, 147 insertions, 129 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index 4a154218..32106614 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,12 @@ +2016-05-25 Manuel Collado <mcollado2011@gmail.com>. + + * gawktexi.in: Document new 'nonfatal' API function. + +2016-05-25 Arnold D. Robbins <arnold@skeeve.com> + + * gawktexi.in: Typo fix in extension section, thanks to + Manuel Collado <mcollado2011@gmail.com>. + 2016-05-02 Andrew J. Schorr <aschorr@telemetry-investments.com> * gawktexi.in: Document new CPP defines gawk_api_major_version and diff --git a/doc/gawk.info b/doc/gawk.info index 248df6d5..17310b1c 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -24183,6 +24183,9 @@ extension ID received from 'gawk' when the extension was loaded:(1) 'void fatal(awk_ext_id_t id, const char *format, ...);' Print a message and then cause 'gawk' to exit immediately. +'void nonfatal(awk_ext_id_t id, const char *format, ...);' + Print a nonfatal error message. + 'void warning(awk_ext_id_t id, const char *format, ...);' Print a warning message. @@ -24923,7 +24926,7 @@ code: value passed in to 'sym_update()' before doing anything else with it, like so: - awk_value_t value; + awk_value_t val; awk_array_t new_array; new_array = create_array(); @@ -26622,7 +26625,7 @@ File: gawk.info, Node: Extension summary, Next: Extension Exercises, Prev: ga exit callbacks, a version string, input parsers, output wrappers, and two-way processors) - * Printing fatal, warning, and "lint" warning messages + * Printing fatal, nonfatal, warning, and "lint" warning messages * Updating 'ERRNO', or unsetting it @@ -35694,128 +35697,128 @@ Node: Input Parsers966765 Node: Output Wrappers976650 Node: Two-way processors981162 Node: Printing Messages983426 -Ref: Printing Messages-Footnote-1984500 -Node: Updating ERRNO984653 -Node: Requesting Values985392 -Ref: table-value-types-returned986129 -Node: Accessing Parameters987012 -Node: Symbol Table Access988247 -Node: Symbol table by name988759 -Node: Symbol table by cookie990780 -Ref: Symbol table by cookie-Footnote-1994929 -Node: Cached values994993 -Ref: Cached values-Footnote-1998494 -Node: Array Manipulation998585 -Ref: Array Manipulation-Footnote-1999676 -Node: Array Data Types999713 -Ref: Array Data Types-Footnote-11002371 -Node: Array Functions1002463 -Node: Flattening Arrays1006321 -Node: Creating Arrays1013229 -Node: Redirection API1018000 -Node: Extension API Variables1020831 -Node: Extension Versioning1021464 -Ref: gawk-api-version1021901 -Node: Extension API Informational Variables1023657 -Node: Extension API Boilerplate1024721 -Node: Finding Extensions1028535 -Node: Extension Example1029094 -Node: Internal File Description1029892 -Node: Internal File Ops1033972 -Ref: Internal File Ops-Footnote-11045734 -Node: Using Internal File Ops1045874 -Ref: Using Internal File Ops-Footnote-11048257 -Node: Extension Samples1048531 -Node: Extension Sample File Functions1050060 -Node: Extension Sample Fnmatch1057709 -Node: Extension Sample Fork1059196 -Node: Extension Sample Inplace1060414 -Node: Extension Sample Ord1063624 -Node: Extension Sample Readdir1064460 -Ref: table-readdir-file-types1065349 -Node: Extension Sample Revout1066154 -Node: Extension Sample Rev2way1066743 -Node: Extension Sample Read write array1067483 -Node: Extension Sample Readfile1069425 -Node: Extension Sample Time1070520 -Node: Extension Sample API Tests1071868 -Node: gawkextlib1072360 -Node: Extension summary1074807 -Node: Extension Exercises1078499 -Node: Language History1079996 -Node: V7/SVR3.11081652 -Node: SVR41083804 -Node: POSIX1085238 -Node: BTL1086617 -Node: POSIX/GNU1087346 -Node: Feature History1093208 -Node: Common Extensions1107578 -Node: Ranges and Locales1108861 -Ref: Ranges and Locales-Footnote-11113477 -Ref: Ranges and Locales-Footnote-21113504 -Ref: Ranges and Locales-Footnote-31113739 -Node: Contributors1113960 -Node: History summary1119529 -Node: Installation1120909 -Node: Gawk Distribution1121853 -Node: Getting1122337 -Node: Extracting1123298 -Node: Distribution contents1124936 -Node: Unix Installation1131030 -Node: Quick Installation1131712 -Node: Shell Startup Files1134126 -Node: Additional Configuration Options1135204 -Node: Configuration Philosophy1137009 -Node: Non-Unix Installation1139378 -Node: PC Installation1139836 -Node: PC Binary Installation1141156 -Node: PC Compiling1143008 -Ref: PC Compiling-Footnote-11146032 -Node: PC Testing1146141 -Node: PC Using1147321 -Node: Cygwin1151435 -Node: MSYS1152205 -Node: VMS Installation1152706 -Node: VMS Compilation1153497 -Ref: VMS Compilation-Footnote-11154726 -Node: VMS Dynamic Extensions1154784 -Node: VMS Installation Details1156469 -Node: VMS Running1158722 -Node: VMS GNV1163001 -Node: VMS Old Gawk1163736 -Node: Bugs1164207 -Node: Other Versions1168404 -Node: Installation summary1174988 -Node: Notes1176046 -Node: Compatibility Mode1176911 -Node: Additions1177693 -Node: Accessing The Source1178618 -Node: Adding Code1180053 -Node: New Ports1186272 -Node: Derived Files1190760 -Ref: Derived Files-Footnote-11196245 -Ref: Derived Files-Footnote-21196280 -Ref: Derived Files-Footnote-31196878 -Node: Future Extensions1196992 -Node: Implementation Limitations1197650 -Node: Extension Design1198833 -Node: Old Extension Problems1199987 -Ref: Old Extension Problems-Footnote-11201505 -Node: Extension New Mechanism Goals1201562 -Ref: Extension New Mechanism Goals-Footnote-11204926 -Node: Extension Other Design Decisions1205115 -Node: Extension Future Growth1207228 -Node: Old Extension Mechanism1208064 -Node: Notes summary1209827 -Node: Basic Concepts1211009 -Node: Basic High Level1211690 -Ref: figure-general-flow1211972 -Ref: figure-process-flow1212657 -Ref: Basic High Level-Footnote-11215958 -Node: Basic Data Typing1216143 -Node: Glossary1219471 -Node: Copying1251417 -Node: GNU Free Documentation License1288956 -Node: Index1314074 +Ref: Printing Messages-Footnote-1984597 +Node: Updating ERRNO984750 +Node: Requesting Values985489 +Ref: table-value-types-returned986226 +Node: Accessing Parameters987109 +Node: Symbol Table Access988344 +Node: Symbol table by name988856 +Node: Symbol table by cookie990877 +Ref: Symbol table by cookie-Footnote-1995026 +Node: Cached values995090 +Ref: Cached values-Footnote-1998591 +Node: Array Manipulation998682 +Ref: Array Manipulation-Footnote-1999773 +Node: Array Data Types999810 +Ref: Array Data Types-Footnote-11002468 +Node: Array Functions1002560 +Node: Flattening Arrays1006418 +Node: Creating Arrays1013326 +Node: Redirection API1018095 +Node: Extension API Variables1020926 +Node: Extension Versioning1021559 +Ref: gawk-api-version1021996 +Node: Extension API Informational Variables1023752 +Node: Extension API Boilerplate1024816 +Node: Finding Extensions1028630 +Node: Extension Example1029189 +Node: Internal File Description1029987 +Node: Internal File Ops1034067 +Ref: Internal File Ops-Footnote-11045829 +Node: Using Internal File Ops1045969 +Ref: Using Internal File Ops-Footnote-11048352 +Node: Extension Samples1048626 +Node: Extension Sample File Functions1050155 +Node: Extension Sample Fnmatch1057804 +Node: Extension Sample Fork1059291 +Node: Extension Sample Inplace1060509 +Node: Extension Sample Ord1063719 +Node: Extension Sample Readdir1064555 +Ref: table-readdir-file-types1065444 +Node: Extension Sample Revout1066249 +Node: Extension Sample Rev2way1066838 +Node: Extension Sample Read write array1067578 +Node: Extension Sample Readfile1069520 +Node: Extension Sample Time1070615 +Node: Extension Sample API Tests1071963 +Node: gawkextlib1072455 +Node: Extension summary1074902 +Node: Extension Exercises1078604 +Node: Language History1080101 +Node: V7/SVR3.11081757 +Node: SVR41083909 +Node: POSIX1085343 +Node: BTL1086722 +Node: POSIX/GNU1087451 +Node: Feature History1093313 +Node: Common Extensions1107683 +Node: Ranges and Locales1108966 +Ref: Ranges and Locales-Footnote-11113582 +Ref: Ranges and Locales-Footnote-21113609 +Ref: Ranges and Locales-Footnote-31113844 +Node: Contributors1114065 +Node: History summary1119634 +Node: Installation1121014 +Node: Gawk Distribution1121958 +Node: Getting1122442 +Node: Extracting1123403 +Node: Distribution contents1125041 +Node: Unix Installation1131135 +Node: Quick Installation1131817 +Node: Shell Startup Files1134231 +Node: Additional Configuration Options1135309 +Node: Configuration Philosophy1137114 +Node: Non-Unix Installation1139483 +Node: PC Installation1139941 +Node: PC Binary Installation1141261 +Node: PC Compiling1143113 +Ref: PC Compiling-Footnote-11146137 +Node: PC Testing1146246 +Node: PC Using1147426 +Node: Cygwin1151540 +Node: MSYS1152310 +Node: VMS Installation1152811 +Node: VMS Compilation1153602 +Ref: VMS Compilation-Footnote-11154831 +Node: VMS Dynamic Extensions1154889 +Node: VMS Installation Details1156574 +Node: VMS Running1158827 +Node: VMS GNV1163106 +Node: VMS Old Gawk1163841 +Node: Bugs1164312 +Node: Other Versions1168509 +Node: Installation summary1175093 +Node: Notes1176151 +Node: Compatibility Mode1177016 +Node: Additions1177798 +Node: Accessing The Source1178723 +Node: Adding Code1180158 +Node: New Ports1186377 +Node: Derived Files1190865 +Ref: Derived Files-Footnote-11196350 +Ref: Derived Files-Footnote-21196385 +Ref: Derived Files-Footnote-31196983 +Node: Future Extensions1197097 +Node: Implementation Limitations1197755 +Node: Extension Design1198938 +Node: Old Extension Problems1200092 +Ref: Old Extension Problems-Footnote-11201610 +Node: Extension New Mechanism Goals1201667 +Ref: Extension New Mechanism Goals-Footnote-11205031 +Node: Extension Other Design Decisions1205220 +Node: Extension Future Growth1207333 +Node: Old Extension Mechanism1208169 +Node: Notes summary1209932 +Node: Basic Concepts1211114 +Node: Basic High Level1211795 +Ref: figure-general-flow1212077 +Ref: figure-process-flow1212762 +Ref: Basic High Level-Footnote-11216063 +Node: Basic Data Typing1216248 +Node: Glossary1219576 +Node: Copying1251522 +Node: GNU Free Documentation License1289061 +Node: Index1314179 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 75deb196..9948b0f1 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -33023,6 +33023,9 @@ that parameter. More's the pity.} @item void fatal(awk_ext_id_t id, const char *format, ...); Print a message and then cause @command{gawk} to exit immediately. +@item void nonfatal(awk_ext_id_t id, const char *format, ...); +Print a nonfatal error message. + @item void warning(awk_ext_id_t id, const char *format, ...); Print a warning message. @@ -33899,7 +33902,7 @@ into @command{gawk}, you have to retrieve the array cookie from the value passed in to @command{sym_update()} before doing anything else with it, like so: @example -awk_value_t value; +awk_value_t val; awk_array_t new_array; new_array = create_array(); @@ -35816,7 +35819,7 @@ output wrappers, and two-way processors) @item -Printing fatal, warning, and ``lint'' warning messages +Printing fatal, nonfatal, warning, and ``lint'' warning messages @item Updating @code{ERRNO}, or unsetting it diff --git a/doc/gawktexi.in b/doc/gawktexi.in index a044c45e..3182366d 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -32114,6 +32114,9 @@ that parameter. More's the pity.} @item void fatal(awk_ext_id_t id, const char *format, ...); Print a message and then cause @command{gawk} to exit immediately. +@item void nonfatal(awk_ext_id_t id, const char *format, ...); +Print a nonfatal error message. + @item void warning(awk_ext_id_t id, const char *format, ...); Print a warning message. @@ -32990,7 +32993,7 @@ into @command{gawk}, you have to retrieve the array cookie from the value passed in to @command{sym_update()} before doing anything else with it, like so: @example -awk_value_t value; +awk_value_t val; awk_array_t new_array; new_array = create_array(); @@ -34907,7 +34910,7 @@ output wrappers, and two-way processors) @item -Printing fatal, warning, and ``lint'' warning messages +Printing fatal, nonfatal, warning, and ``lint'' warning messages @item Updating @code{ERRNO}, or unsetting it |