In perl.git, the branch blead has been updated <http://perl5.git.perl.org/perl.git/commitdiff/dd766832e653b99bd7a3b57d049f81e9d8c000fe?hp=68382b6727fe4a09697a35a454bba30279648d54>
- Log ----------------------------------------------------------------- commit dd766832e653b99bd7a3b57d049f81e9d8c000fe Author: Craig A. Berry <[email protected]> Date: Tue Sep 18 23:24:56 2012 -0700 [perl #99382] 'stat' call documentation is poorly worded The use of "block" to describe both the file-or-device-specific sweet spot for I/O operations and the number of file-system-specific chunks (not necessarily 512-byte chunks) is unfortunate. I think we came by it honestly because Perl just provides a wrapper around: http://pubs.opengroup.org/onlinepubs/009695399/basedefs/sys/stat.h.html which says: blksize_t st_blksize A file system-specific preferred I/O block size for this object. In some file system types, this may vary from file to file. blkcnt_t st_blocks Number of blocks allocated for this object. and in the "Rationale" section they say: "The unit for the st_blocks member of the stat structure is not defined within IEEE Std 1003.1-2001. In some implementations it is 512 bytes. It may differ on a file system basis. There is no correlation between values of the st_blocks and st_blksize, and the f_bsize (from <sys/statvfs.h>) structure members." The existing piece in perlfunc.pod was written in 1997 for Perl 5.003. Screens were smaller then. Perhaps we could afford to wrap to a second line now and say something like: M pod/perlfunc.pod commit 37ccf918afde3d9f88f7955b043e8ecc5158caaa Author: Father Chrysostomos <[email protected]> Date: Tue Sep 18 20:30:24 2012 -0700 embed.fnc: Clarify o comments It applies also to S_ for static functions. M embed.fnc ----------------------------------------------------------------------- Summary of changes: embed.fnc | 2 +- pod/perlfunc.pod | 6 ++++-- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/embed.fnc b/embed.fnc index 2ac6644..6c8dfad 100644 --- a/embed.fnc +++ b/embed.fnc @@ -74,7 +74,7 @@ : : The really OLD name for API funcs : -: o Has no Perl_foo compatibility macro: +: o Has no Perl_foo or S_foo compatibility macro: : : embed.h: suppress "#define foo Perl_foo" : diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod index 08743ed..5a2eb71 100644 --- a/pod/perlfunc.pod +++ b/pod/perlfunc.pod @@ -7401,8 +7401,10 @@ meanings of the fields: 8 atime last access time in seconds since the epoch 9 mtime last modify time in seconds since the epoch 10 ctime inode change time in seconds since the epoch (*) - 11 blksize preferred block size for file system I/O - 12 blocks actual number of blocks allocated + 11 blksize preferred I/O size in bytes for interacting with the + file (may vary from file to file) + 12 blocks actual number of system-specific blocks allocated + on disk (often, but not always, 512 bytes each) (The epoch was at 00:00 January 1, 1970 GMT.) -- Perl5 Master Repository
