aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/ChangeLog15
-rw-r--r--doc/gawk.info194
-rw-r--r--doc/gawk.texi24
-rw-r--r--doc/gawktexi.in24
4 files changed, 162 insertions, 95 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog
index 91919fb1..fc2a1354 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,18 @@
+2013-05-29 Arnold D. Robbins <arnold@skeeve.com>
+
+ * gawktexi.in (Internal File Description): Add "devbsize" element
+ to stat data array.
+
+2013-05-27 Arnold D. Robbins <arnold@skeeve.com>
+
+ * gawtexi.in: Sample filefuncs.c extension code: Change test from
+ ifdef HAVE_ST_BLKSIZE to HAVE_STRUCT_STAT_ST_BLKSIZE.
+
+2013-05-21 Arnold D. Robbins <arnold@skeeve.com>
+
+ * gawktexi.in (Quick Installation): Add a paragraph advising to
+ run `make install'. Thanks to Hermann Peifer.
+
2013-05-16 Arnold D. Robbins <arnold@skeeve.com>
* gawktexi.in (gawkextlib): Add a note to use make install on
diff --git a/doc/gawk.info b/doc/gawk.info
index 6685ba83..bc407397 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -23659,6 +23659,14 @@ appropriate information:
`"symlink"'
The file is a symbolic link.
+`"devbsize"'
+ The size of a block for the element indexed by `"blocks"'. This
+ information is derived from either the `DEV_BSIZE' constant
+ defined in `<sys/param.h>' on most systems, or the `S_BLKSIZE'
+ constant in `<sys/stat.h>' on BSD systems. For some other
+ systems, "a priori" knowledge is used to provide a value. Where no
+ value can be determined, it defaults to 512.
+
Several additional elements may be present depending upon the
operating system and the type of the file. You can test for them in
your `awk' program by using the `in' operator (*note Reference to
@@ -23887,9 +23895,9 @@ The latter part of the function makes selective additions to the
destination array, depending upon the availability of certain members
and/or the type of the file. It then returns zero, for success:
- #ifdef HAVE_ST_BLKSIZE
+ #ifdef HAVE_STRUCT_STAT_ST_BLKSIZE
array_set_numeric(array, "blksize", sbuf->st_blksize);
- #endif /* HAVE_ST_BLKSIZE */
+ #endif /* HAVE_STRUCT_STAT_ST_BLKSIZE */
pmode = format_mode(sbuf->st_mode);
array_set(array, "pmode", make_const_string(pmode, strlen(pmode),
@@ -25712,6 +25720,14 @@ not work, or if any of the tests fail, check the files in the
failure is not described there, please send in a bug report (*note
Bugs::).
+ Of course, once you've built `gawk', it is likely that you will wish
+to install it. To do so, you need to run the command `make check', as
+a user with the appropriate permissions. How to do this varies by
+system, but on many systems you can use the `sudo' command to do so.
+The command then becomes `sudo make install'. It is likely that you
+will be asked for your password, and you will have to have been set up
+previously as a user who is allowed to run the `sudo' command.
+

File: gawk.info, Node: Additional Configuration Options, Next: Configuration Philosophy, Prev: Quick Installation, Up: Unix Installation
@@ -25775,8 +25791,8 @@ are: what header files are available, so that they can be correctly
included, what (supposedly) standard functions are actually available
in your C libraries, and various miscellaneous facts about your
operating system. For example, there may not be an `st_blksize'
-element in the `stat' structure. In this case, `HAVE_ST_BLKSIZE' is
-undefined.
+element in the `stat' structure. In this case,
+`HAVE_STRUCT_STAT_ST_BLKSIZE' is undefined.
It is possible for your C compiler to lie to `configure'. It may do
so by not exiting with an error when a library function is not
@@ -32485,90 +32501,90 @@ Node: Extension API Boilerplate947271
Node: Finding Extensions951075
Node: Extension Example951635
Node: Internal File Description952366
-Node: Internal File Ops956054
-Ref: Internal File Ops-Footnote-1967538
-Node: Using Internal File Ops967678
-Ref: Using Internal File Ops-Footnote-1970031
-Node: Extension Samples970297
-Node: Extension Sample File Functions971821
-Node: Extension Sample Fnmatch980308
-Node: Extension Sample Fork982034
-Node: Extension Sample Inplace983252
-Node: Extension Sample Ord985030
-Node: Extension Sample Readdir985866
-Node: Extension Sample Revout987398
-Node: Extension Sample Rev2way987991
-Node: Extension Sample Read write array988681
-Node: Extension Sample Readfile990564
-Node: Extension Sample API Tests991382
-Node: Extension Sample Time991907
-Node: gawkextlib993271
-Node: Language History996031
-Node: V7/SVR3.1997553
-Node: SVR4999874
-Node: POSIX1001316
-Node: BTL1002702
-Node: POSIX/GNU1003436
-Node: Common Extensions1008971
-Node: Ranges and Locales1010277
-Ref: Ranges and Locales-Footnote-11014895
-Ref: Ranges and Locales-Footnote-21014922
-Ref: Ranges and Locales-Footnote-31015182
-Node: Contributors1015403
-Node: Installation1020282
-Node: Gawk Distribution1021176
-Node: Getting1021660
-Node: Extracting1022486
-Node: Distribution contents1024178
-Node: Unix Installation1029439
-Node: Quick Installation1030056
-Node: Additional Configuration Options1032018
-Node: Configuration Philosophy1033495
-Node: Non-Unix Installation1035837
-Node: PC Installation1036295
-Node: PC Binary Installation1037594
-Node: PC Compiling1039442
-Node: PC Testing1042386
-Node: PC Using1043562
-Node: Cygwin1047747
-Node: MSYS1048747
-Node: VMS Installation1049261
-Node: VMS Compilation1049864
-Ref: VMS Compilation-Footnote-11050871
-Node: VMS Installation Details1050929
-Node: VMS Running1052564
-Node: VMS Old Gawk1054171
-Node: Bugs1054645
-Node: Other Versions1058497
-Node: Notes1064098
-Node: Compatibility Mode1064898
-Node: Additions1065681
-Node: Accessing The Source1066608
-Node: Adding Code1068048
-Node: New Ports1074093
-Node: Derived Files1078228
-Ref: Derived Files-Footnote-11083549
-Ref: Derived Files-Footnote-21083583
-Ref: Derived Files-Footnote-31084183
-Node: Future Extensions1084281
-Node: Implementation Limitations1084862
-Node: Extension Design1086114
-Node: Old Extension Problems1087268
-Ref: Old Extension Problems-Footnote-11088776
-Node: Extension New Mechanism Goals1088833
-Ref: Extension New Mechanism Goals-Footnote-11092199
-Node: Extension Other Design Decisions1092385
-Node: Extension Future Growth1094491
-Node: Old Extension Mechanism1095327
-Node: Basic Concepts1097067
-Node: Basic High Level1097748
-Ref: figure-general-flow1098019
-Ref: figure-process-flow1098618
-Ref: Basic High Level-Footnote-11101847
-Node: Basic Data Typing1102032
-Node: Glossary1105387
-Node: Copying1130849
-Node: GNU Free Documentation License1168406
-Node: Index1193543
+Node: Internal File Ops956457
+Ref: Internal File Ops-Footnote-1967965
+Node: Using Internal File Ops968105
+Ref: Using Internal File Ops-Footnote-1970458
+Node: Extension Samples970724
+Node: Extension Sample File Functions972248
+Node: Extension Sample Fnmatch980735
+Node: Extension Sample Fork982461
+Node: Extension Sample Inplace983679
+Node: Extension Sample Ord985457
+Node: Extension Sample Readdir986293
+Node: Extension Sample Revout987825
+Node: Extension Sample Rev2way988418
+Node: Extension Sample Read write array989108
+Node: Extension Sample Readfile990991
+Node: Extension Sample API Tests991809
+Node: Extension Sample Time992334
+Node: gawkextlib993698
+Node: Language History996458
+Node: V7/SVR3.1997980
+Node: SVR41000301
+Node: POSIX1001743
+Node: BTL1003129
+Node: POSIX/GNU1003863
+Node: Common Extensions1009398
+Node: Ranges and Locales1010704
+Ref: Ranges and Locales-Footnote-11015322
+Ref: Ranges and Locales-Footnote-21015349
+Ref: Ranges and Locales-Footnote-31015609
+Node: Contributors1015830
+Node: Installation1020709
+Node: Gawk Distribution1021603
+Node: Getting1022087
+Node: Extracting1022913
+Node: Distribution contents1024605
+Node: Unix Installation1029866
+Node: Quick Installation1030483
+Node: Additional Configuration Options1032927
+Node: Configuration Philosophy1034404
+Node: Non-Unix Installation1036758
+Node: PC Installation1037216
+Node: PC Binary Installation1038515
+Node: PC Compiling1040363
+Node: PC Testing1043307
+Node: PC Using1044483
+Node: Cygwin1048668
+Node: MSYS1049668
+Node: VMS Installation1050182
+Node: VMS Compilation1050785
+Ref: VMS Compilation-Footnote-11051792
+Node: VMS Installation Details1051850
+Node: VMS Running1053485
+Node: VMS Old Gawk1055092
+Node: Bugs1055566
+Node: Other Versions1059418
+Node: Notes1065019
+Node: Compatibility Mode1065819
+Node: Additions1066602
+Node: Accessing The Source1067529
+Node: Adding Code1068969
+Node: New Ports1075014
+Node: Derived Files1079149
+Ref: Derived Files-Footnote-11084470
+Ref: Derived Files-Footnote-21084504
+Ref: Derived Files-Footnote-31085104
+Node: Future Extensions1085202
+Node: Implementation Limitations1085783
+Node: Extension Design1087035
+Node: Old Extension Problems1088189
+Ref: Old Extension Problems-Footnote-11089697
+Node: Extension New Mechanism Goals1089754
+Ref: Extension New Mechanism Goals-Footnote-11093120
+Node: Extension Other Design Decisions1093306
+Node: Extension Future Growth1095412
+Node: Old Extension Mechanism1096248
+Node: Basic Concepts1097988
+Node: Basic High Level1098669
+Ref: figure-general-flow1098940
+Ref: figure-process-flow1099539
+Ref: Basic High Level-Footnote-11102768
+Node: Basic Data Typing1102953
+Node: Glossary1106308
+Node: Copying1131770
+Node: GNU Free Documentation License1169327
+Node: Index1194464

End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index b8856115..240669cf 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -31597,6 +31597,15 @@ filesystem.
@item "symlink"
The file is a symbolic link.
@end table
+
+@c 5/2013: Thanks to Corinna Vinschen for this information.
+@item "devbsize"
+The size of a block for the element indexed by @code{"blocks"}.
+This information is derived from either the @code{DEV_BSIZE}
+constant defined in @code{<sys/param.h>} on most systems,
+or the @code{S_BLKSIZE} constant in @code{<sys/stat.h>} on BSD systems.
+For some other systems, @dfn{a priori} knowledge is used to provide
+a value. Where no value can be determined, it defaults to 512.
@end table
Several additional elements may be present depending upon the operating
@@ -31856,9 +31865,9 @@ certain members and/or the type of the file. It then returns zero,
for success:
@example
-#ifdef HAVE_ST_BLKSIZE
+#ifdef HAVE_STRUCT_STAT_ST_BLKSIZE
array_set_numeric(array, "blksize", sbuf->st_blksize);
-#endif /* HAVE_ST_BLKSIZE */
+#endif /* HAVE_STRUCT_STAT_ST_BLKSIZE */
pmode = format_mode(sbuf->st_mode);
array_set(array, "pmode", make_const_string(pmode, strlen(pmode),
@@ -34217,6 +34226,15 @@ check the files in the @file{README_d} directory to see if you've
found a known problem. If the failure is not described there,
please send in a bug report (@pxref{Bugs}).
+Of course, once you've built @command{gawk}, it is likely that you will
+wish to install it. To do so, you need to run the command @samp{make
+check}, as a user with the appropriate permissions. How to do this
+varies by system, but on many systems you can use the @command{sudo}
+command to do so. The command then becomes @samp{sudo make install}. It
+is likely that you will be asked for your password, and you will have
+to have been set up previously as a user who is allowed to run the
+@command{sudo} command.
+
@node Additional Configuration Options
@appendixsubsec Additional Configuration Options
@cindex @command{gawk}, configuring, options
@@ -34291,7 +34309,7 @@ they can be correctly included, what (supposedly) standard functions
are actually available in your C libraries, and various miscellaneous
facts about your operating system. For example, there may not be an
@code{st_blksize} element in the @code{stat} structure. In this case,
-@samp{HAVE_ST_BLKSIZE} is undefined.
+@samp{HAVE_STRUCT_STAT_ST_BLKSIZE} is undefined.
@cindex @code{custom.h} file
It is possible for your C compiler to lie to @command{configure}. It may
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index d79093bf..d0356991 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -30746,6 +30746,15 @@ filesystem.
@item "symlink"
The file is a symbolic link.
@end table
+
+@c 5/2013: Thanks to Corinna Vinschen for this information.
+@item "devbsize"
+The size of a block for the element indexed by @code{"blocks"}.
+This information is derived from either the @code{DEV_BSIZE}
+constant defined in @code{<sys/param.h>} on most systems,
+or the @code{S_BLKSIZE} constant in @code{<sys/stat.h>} on BSD systems.
+For some other systems, @dfn{a priori} knowledge is used to provide
+a value. Where no value can be determined, it defaults to 512.
@end table
Several additional elements may be present depending upon the operating
@@ -31005,9 +31014,9 @@ certain members and/or the type of the file. It then returns zero,
for success:
@example
-#ifdef HAVE_ST_BLKSIZE
+#ifdef HAVE_STRUCT_STAT_ST_BLKSIZE
array_set_numeric(array, "blksize", sbuf->st_blksize);
-#endif /* HAVE_ST_BLKSIZE */
+#endif /* HAVE_STRUCT_STAT_ST_BLKSIZE */
pmode = format_mode(sbuf->st_mode);
array_set(array, "pmode", make_const_string(pmode, strlen(pmode),
@@ -33366,6 +33375,15 @@ check the files in the @file{README_d} directory to see if you've
found a known problem. If the failure is not described there,
please send in a bug report (@pxref{Bugs}).
+Of course, once you've built @command{gawk}, it is likely that you will
+wish to install it. To do so, you need to run the command @samp{make
+check}, as a user with the appropriate permissions. How to do this
+varies by system, but on many systems you can use the @command{sudo}
+command to do so. The command then becomes @samp{sudo make install}. It
+is likely that you will be asked for your password, and you will have
+to have been set up previously as a user who is allowed to run the
+@command{sudo} command.
+
@node Additional Configuration Options
@appendixsubsec Additional Configuration Options
@cindex @command{gawk}, configuring, options
@@ -33440,7 +33458,7 @@ they can be correctly included, what (supposedly) standard functions
are actually available in your C libraries, and various miscellaneous
facts about your operating system. For example, there may not be an
@code{st_blksize} element in the @code{stat} structure. In this case,
-@samp{HAVE_ST_BLKSIZE} is undefined.
+@samp{HAVE_STRUCT_STAT_ST_BLKSIZE} is undefined.
@cindex @code{custom.h} file
It is possible for your C compiler to lie to @command{configure}. It may
generated by cgit v1.2.3 (git 2.25.1) at 2025-05-09 18:51:14 +0000