diff options
| -rw-r--r-- | doc/ChangeLog | 5 | ||||
| -rw-r--r-- | doc/gawk.info | 179 | ||||
| -rw-r--r-- | doc/gawk.texi | 4 | ||||
| -rw-r--r-- | doc/gawktexi.in | 4 | ||||
| -rw-r--r-- | extension/ChangeLog | 6 | ||||
| -rw-r--r-- | extension/inplace.3am | 5 |
6 files changed, 116 insertions, 87 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index ab1ba2be..6e4c40b0 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,5 +1,10 @@ 2015-06-17 Andrew J. Schorr <aschorr@telemetry-investments.com> + * gawktexi.in: Document inplace shortcomings -- it does not preserve + ACLs, and it may leave temporary files behind if killed by a signal. + +2015-06-17 Andrew J. Schorr <aschorr@telemetry-investments.com> + * gawktexi.in: Document new inplace variable to control whether inplace editing is active. diff --git a/doc/gawk.info b/doc/gawk.info index 2378fef8..81ec11d1 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -25618,6 +25618,13 @@ processing immediately without damaging the original file. $ gawk -i inplace -v INPLACE_SUFFIX=.bak '{ gsub(/foo/, "bar") } > { print }' file1 file2 file3 + Please note that, while the extension does attempt to preserve +ownership and permissions, it makes no attempt to copy the ACLs from the +original file. + + If the program dies prematurely, as might happen if an unhandled +signal is received, a temporary file may be left behind. + File: gawk.info, Node: Extension Sample Ord, Next: Extension Sample Readdir, Prev: Extension Sample Inplace, Up: Extension Samples @@ -34986,91 +34993,91 @@ Node: Extension Sample File Functions1023883 Node: Extension Sample Fnmatch1031532 Node: Extension Sample Fork1033019 Node: Extension Sample Inplace1034237 -Node: Extension Sample Ord1037166 -Node: Extension Sample Readdir1038002 -Ref: table-readdir-file-types1038891 -Node: Extension Sample Revout1039696 -Node: Extension Sample Rev2way1040285 -Node: Extension Sample Read write array1041025 -Node: Extension Sample Readfile1042967 -Node: Extension Sample Time1044062 -Node: Extension Sample API Tests1045410 -Node: gawkextlib1045902 -Node: Extension summary1048326 -Node: Extension Exercises1052018 -Node: Language History1053515 -Node: V7/SVR3.11055171 -Node: SVR41057324 -Node: POSIX1058758 -Node: BTL1060138 -Node: POSIX/GNU1060868 -Node: Feature History1066389 -Node: Common Extensions1079719 -Node: Ranges and Locales1081002 -Ref: Ranges and Locales-Footnote-11085618 -Ref: Ranges and Locales-Footnote-21085645 -Ref: Ranges and Locales-Footnote-31085880 -Node: Contributors1086101 -Node: History summary1091670 -Node: Installation1093050 -Node: Gawk Distribution1093995 -Node: Getting1094479 -Node: Extracting1095302 -Node: Distribution contents1096940 -Node: Unix Installation1102693 -Node: Quick Installation1103309 -Node: Additional Configuration Options1105736 -Node: Configuration Philosophy1107540 -Node: Non-Unix Installation1109910 -Node: PC Installation1110368 -Node: PC Binary Installation1111688 -Node: PC Compiling1113540 -Ref: PC Compiling-Footnote-11116564 -Node: PC Testing1116673 -Node: PC Using1117853 -Node: Cygwin1121967 -Node: MSYS1122737 -Node: VMS Installation1123238 -Node: VMS Compilation1124029 -Ref: VMS Compilation-Footnote-11125259 -Node: VMS Dynamic Extensions1125317 -Node: VMS Installation Details1127002 -Node: VMS Running1129255 -Node: VMS GNV1132096 -Node: VMS Old Gawk1132831 -Node: Bugs1133302 -Node: Other Versions1137416 -Node: Installation summary1143890 -Node: Notes1144948 -Node: Compatibility Mode1145813 -Node: Additions1146595 -Node: Accessing The Source1147520 -Node: Adding Code1148956 -Node: New Ports1155111 -Node: Derived Files1159599 -Ref: Derived Files-Footnote-11165084 -Ref: Derived Files-Footnote-21165119 -Ref: Derived Files-Footnote-31165717 -Node: Future Extensions1165831 -Node: Implementation Limitations1166489 -Node: Extension Design1167672 -Node: Old Extension Problems1168826 -Ref: Old Extension Problems-Footnote-11170344 -Node: Extension New Mechanism Goals1170401 -Ref: Extension New Mechanism Goals-Footnote-11173765 -Node: Extension Other Design Decisions1173954 -Node: Extension Future Growth1176067 -Node: Old Extension Mechanism1176903 -Node: Notes summary1178666 -Node: Basic Concepts1179848 -Node: Basic High Level1180529 -Ref: figure-general-flow1180811 -Ref: figure-process-flow1181496 -Ref: Basic High Level-Footnote-11184797 -Node: Basic Data Typing1184982 -Node: Glossary1188310 -Node: Copying1220256 -Node: GNU Free Documentation License1257795 -Node: Index1282913 +Node: Extension Sample Ord1037447 +Node: Extension Sample Readdir1038283 +Ref: table-readdir-file-types1039172 +Node: Extension Sample Revout1039977 +Node: Extension Sample Rev2way1040566 +Node: Extension Sample Read write array1041306 +Node: Extension Sample Readfile1043248 +Node: Extension Sample Time1044343 +Node: Extension Sample API Tests1045691 +Node: gawkextlib1046183 +Node: Extension summary1048607 +Node: Extension Exercises1052299 +Node: Language History1053796 +Node: V7/SVR3.11055452 +Node: SVR41057605 +Node: POSIX1059039 +Node: BTL1060419 +Node: POSIX/GNU1061149 +Node: Feature History1066670 +Node: Common Extensions1080000 +Node: Ranges and Locales1081283 +Ref: Ranges and Locales-Footnote-11085899 +Ref: Ranges and Locales-Footnote-21085926 +Ref: Ranges and Locales-Footnote-31086161 +Node: Contributors1086382 +Node: History summary1091951 +Node: Installation1093331 +Node: Gawk Distribution1094276 +Node: Getting1094760 +Node: Extracting1095583 +Node: Distribution contents1097221 +Node: Unix Installation1102974 +Node: Quick Installation1103590 +Node: Additional Configuration Options1106017 +Node: Configuration Philosophy1107821 +Node: Non-Unix Installation1110191 +Node: PC Installation1110649 +Node: PC Binary Installation1111969 +Node: PC Compiling1113821 +Ref: PC Compiling-Footnote-11116845 +Node: PC Testing1116954 +Node: PC Using1118134 +Node: Cygwin1122248 +Node: MSYS1123018 +Node: VMS Installation1123519 +Node: VMS Compilation1124310 +Ref: VMS Compilation-Footnote-11125540 +Node: VMS Dynamic Extensions1125598 +Node: VMS Installation Details1127283 +Node: VMS Running1129536 +Node: VMS GNV1132377 +Node: VMS Old Gawk1133112 +Node: Bugs1133583 +Node: Other Versions1137697 +Node: Installation summary1144171 +Node: Notes1145229 +Node: Compatibility Mode1146094 +Node: Additions1146876 +Node: Accessing The Source1147801 +Node: Adding Code1149237 +Node: New Ports1155392 +Node: Derived Files1159880 +Ref: Derived Files-Footnote-11165365 +Ref: Derived Files-Footnote-21165400 +Ref: Derived Files-Footnote-31165998 +Node: Future Extensions1166112 +Node: Implementation Limitations1166770 +Node: Extension Design1167953 +Node: Old Extension Problems1169107 +Ref: Old Extension Problems-Footnote-11170625 +Node: Extension New Mechanism Goals1170682 +Ref: Extension New Mechanism Goals-Footnote-11174046 +Node: Extension Other Design Decisions1174235 +Node: Extension Future Growth1176348 +Node: Old Extension Mechanism1177184 +Node: Notes summary1178947 +Node: Basic Concepts1180129 +Node: Basic High Level1180810 +Ref: figure-general-flow1181092 +Ref: figure-process-flow1181777 +Ref: Basic High Level-Footnote-11185078 +Node: Basic Data Typing1185263 +Node: Glossary1188591 +Node: Copying1220537 +Node: GNU Free Documentation License1258076 +Node: Index1283194 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 6927704d..d9d6842f 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -34656,6 +34656,10 @@ $ @kbd{gawk -i inplace -v INPLACE_SUFFIX=.bak '@{ gsub(/foo/, "bar") @}} > @kbd{@{ print @}' file1 file2 file3} @end example +Please note that, while the extension does attempt to preserve ownership and permissions, it makes no attempt to copy the ACLs from the original file. + +If the program dies prematurely, as might happen if an unhandled signal is received, a temporary file may be left behind. + @node Extension Sample Ord @subsection Character and Numeric values: @code{ord()} and @code{chr()} diff --git a/doc/gawktexi.in b/doc/gawktexi.in index 58fa4f60..75f3bb71 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -33747,6 +33747,10 @@ $ @kbd{gawk -i inplace -v INPLACE_SUFFIX=.bak '@{ gsub(/foo/, "bar") @}} > @kbd{@{ print @}' file1 file2 file3} @end example +Please note that, while the extension does attempt to preserve ownership and permissions, it makes no attempt to copy the ACLs from the original file. + +If the program dies prematurely, as might happen if an unhandled signal is received, a temporary file may be left behind. + @node Extension Sample Ord @subsection Character and Numeric values: @code{ord()} and @code{chr()} diff --git a/extension/ChangeLog b/extension/ChangeLog index 5b372e9d..993729a5 100644 --- a/extension/ChangeLog +++ b/extension/ChangeLog @@ -1,5 +1,11 @@ 2015-06-17 Andrew J. Schorr <aschorr@telemetry-investments.com> + * inplace.3am (BUGS): Document that ACLs are not preserved, and + a temporary file may be left behind if the program is killed by + a signal. + +2015-06-17 Andrew J. Schorr <aschorr@telemetry-investments.com> + * inplace.3am: Document new inplace variable to control whether inplace editing is active. diff --git a/extension/inplace.3am b/extension/inplace.3am index b1682e22..a045fe6c 100644 --- a/extension/inplace.3am +++ b/extension/inplace.3am @@ -40,7 +40,10 @@ One can reenable inplace editing by placing .B inplace=1 prior to files that should be subject to inplace editing. ... .SH NOTES -... .SH BUGS +.SH BUGS +While the extension does attempt to preserve ownership and permissions, it makes no attempt to copy the ACLs from the original file. +.PP +If the program dies prematurely, as might happen if an unhandled signal is received, a temporary file may be left behind. .SH EXAMPLE .ft CW .nf |