Jeroen van Wolffelaar <[EMAIL PROTECTED]> writes:
> If so, please document this properly with %s, 'optimal transfer' is a
> bit a vague term.
Thanks for mentioning this. There are several other doc. glitches
nearby. I installed this patch; I'm not sure whether it answers your
question (if not, please suggest wording improvements).
2005-02-08 Paul Eggert <[EMAIL PROTECTED]>
* doc/coreutils.texi (stat invocation): Normalize terminology,
capitalization, and sort order to match --help output. Mention %c
for file systems. Say that %s is the "Fundamental block size",
since that is what POSIX says; problem reported by Jeroen van
Wolffelaar.
* src/stat.c (usage): Likewise.
Index: doc/coreutils.texi
===================================================================
RCS file: /fetish/cu/doc/coreutils.texi,v
retrieving revision 1.239
diff -p -u -r1.239 coreutils.texi
--- doc/coreutils.texi 10 Jan 2005 18:12:35 -0000 1.239
+++ doc/coreutils.texi 8 Feb 2005 20:40:58 -0000
@@ -9065,7 +9065,7 @@ Print the information in terse form, sui
@cindex output format
Use @var{format} rather than the default format.
-Interpreted sequences for file stat are:
+The valid format sequences for files are:
@itemize @bullet
@item %a - Access rights in octal
@@ -9074,19 +9074,19 @@ Interpreted sequences for file stat are:
@item %B - The size in bytes of each block reported by @samp{%b}
@item %d - Device number in decimal
@item %D - Device number in hex
[EMAIL PROTECTED] %f - raw mode in hex
[EMAIL PROTECTED] %f - Raw mode in hex
@item %F - File type
[EMAIL PROTECTED] %g - Group Id of owner
[EMAIL PROTECTED] %g - Group ID of owner
@item %G - Group name of owner
@item %h - Number of hard links
@item %i - Inode number
@item %n - File name
[EMAIL PROTECTED] %N - Quoted File name with dereference if symbolic link
[EMAIL PROTECTED] %N - Quoted file name with dereference if symbolic link
@item %o - I/O block size
@item %s - Total size, in bytes
@item %t - Major device type in hex
@item %T - Minor device type in hex
[EMAIL PROTECTED] %u - User Id of owner
[EMAIL PROTECTED] %u - User ID of owner
@item %U - User name of owner
@item %x - Time of last access
@item %X - Time of last access as seconds since Epoch
@@ -9096,19 +9096,20 @@ Interpreted sequences for file stat are:
@item %Z - Time of last change as seconds since Epoch
@end itemize
-Interpreted sequences for file system stat are:
+The valid format sequences for file systems are:
@itemize @bullet
[EMAIL PROTECTED] %n - File name
[EMAIL PROTECTED] %i - File System id in hex
[EMAIL PROTECTED] %a - Free blocks available to non-superuser
[EMAIL PROTECTED] %b - Total data blocks in file system
[EMAIL PROTECTED] %c - Total file nodes in file system
[EMAIL PROTECTED] %d - Free file nodes in file system
[EMAIL PROTECTED] %f - Free blocks in file system
[EMAIL PROTECTED] %i - File System ID in hex
@item %l - Maximum length of file names
[EMAIL PROTECTED] %n - File name
[EMAIL PROTECTED] %s - Fundamental block size
@item %t - Type in hex
@item %T - Type in human readable form
[EMAIL PROTECTED] %b - Total data blocks in file system
[EMAIL PROTECTED] %f - Free blocks in file system
[EMAIL PROTECTED] %a - Free blocks available to non-superuser
[EMAIL PROTECTED] %s - Optimal transfer block size
[EMAIL PROTECTED] %c - Total file nodes in file system
@end itemize
@vindex TZ
Index: src/stat.c
===================================================================
RCS file: /fetish/cu/src/stat.c,v
retrieving revision 1.76
diff -p -u -r1.76 stat.c
--- src/stat.c 17 Nov 2004 03:12:06 -0000 1.76
+++ src/stat.c 8 Feb 2005 20:40:59 -0000
@@ -1,5 +1,5 @@
/* stat.c -- display file or file system status
- Copyright (C) 2001, 2002, 2003, 2004 Free Software Foundation.
+ Copyright (C) 2001, 2002, 2003, 2004, 2005 Free Software Foundation.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
@@ -659,38 +659,38 @@ Display file or file system status.\n\
fputs (_("\n\
The valid format sequences for files (without --file-system):\n\
\n\
- %A Access rights in human readable form\n\
%a Access rights in octal\n\
- %B The size in bytes of each block reported by `%b'\n\
+ %A Access rights in human readable form\n\
%b Number of blocks allocated (see %B)\n\
+ %B The size in bytes of each block reported by %b\n\
"), stdout);
fputs (_("\
- %D Device number in hex\n\
%d Device number in decimal\n\
- %F File type\n\
+ %D Device number in hex\n\
%f Raw mode in hex\n\
- %G Group name of owner\n\
+ %F File type\n\
%g Group ID of owner\n\
+ %G Group name of owner\n\
"), stdout);
fputs (_("\
%h Number of hard links\n\
%i Inode number\n\
- %N Quoted File name with dereference if symbolic link\n\
%n File name\n\
- %o IO block size\n\
+ %N Quoted file name with dereference if symbolic link\n\
+ %o I/O block size\n\
%s Total size, in bytes\n\
- %T Minor device type in hex\n\
%t Major device type in hex\n\
+ %T Minor device type in hex\n\
"), stdout);
fputs (_("\
- %U User name of owner\n\
%u User ID of owner\n\
- %X Time of last access as seconds since Epoch\n\
+ %U User name of owner\n\
%x Time of last access\n\
- %Y Time of last modification as seconds since Epoch\n\
+ %X Time of last access as seconds since Epoch\n\
%y Time of last modification\n\
- %Z Time of last change as seconds since Epoch\n\
+ %Y Time of last modification as seconds since Epoch\n\
%z Time of last change\n\
+ %Z Time of last change as seconds since Epoch\n\
\n\
"), stdout);
@@ -704,12 +704,12 @@ Valid format sequences for file systems:
%f Free blocks in file system\n\
"), stdout);
fputs (_("\
- %i File System id in hex\n\
+ %i File System ID in hex\n\
%l Maximum length of filenames\n\
%n File name\n\
- %s Optimal transfer block size\n\
- %T Type in human readable form\n\
+ %s Fundamental block size\n\
%t Type in hex\n\
+ %T Type in human readable form\n\
"), stdout);
printf (_("\nReport bugs to <%s>.\n"), PACKAGE_BUGREPORT);
}
--
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
