X-Git-Url: http://git.tuebingen.mpg.de/?p=adu.git;a=blobdiff_plain;f=select.ggo;h=d8f3ae3a37ad8b51ae9e8c3f03b106750af46117;hp=33e75fe6fe72be2fe5cac482fbdd50b8acdefee4;hb=8033c743e9d07be7b79277e15b477e19f7e83d87;hpb=15c765b696accdce0b20c339876e21e6e5967a52 diff --git a/select.ggo b/select.ggo index 33e75fe..d8f3ae3 100644 --- a/select.ggo +++ b/select.ggo @@ -44,20 +44,6 @@ details=" Sort by file size, file count or unsorted. " -option "format" f -#~~~~~~~~~~~~~~~~~ -"how to format the output" -string typestr="" -optional -details=" - %(basedir) -- the path given to --base-dir during create - %(dir) -- the name of the directory - %(dir_size) -- the size of the sum of all regular files in this directory - %(num_files) -- the number of regular files in this directory - %% -- interpolates to % - %xx -- interpolates to the character with hex code xx -" - option "output" o #~~~~~~~~~~~~~~~~ "file to write output to" @@ -67,3 +53,120 @@ default="-" details=" If empty, or not given, use stdout. " + +option "size-unit" - +#~~~~~~~~~~~~~~~~~~~ +"select output format for sizes" +enum typestr="format" +values="h","b","k","m","g","t" +default="h" +optional +details=" + Print sizes in the given unit: human-readable, bytes, + kilobytes (2^10), megabytes (2^20), gigabytes (2^30), terabytes + (2^40). The default is \"h\", i.e. human-readable. +" + +option "count-unit" - +#~~~~~~~~~~~~~~~~~~~~ +"select output format for counted values" +enum typestr="format" +values="h","n","k","m","g","t" +default="h" +optional +details=" + Print the number of files/directories in the given unit: + human-readable, number, number/10^3, number/10^6, number/10^12, + number/10^15. The default is to print numbers in human-readable + format. +" + + +option "user-summary-sort" - +#~~~~~~~~~~~~~~~~~~~~~~~~~~~ +"how to sort the user-summary" +enum typestr="col_spec" +values="name","uid","dir_count","file_count","size" +default="size" +optional +details=" + It is enough to specify the first letter of the column specifier, + e.g. \"--user-summary-sort f\" sorts by file count. +" + +option "no-user-summary" - +#~~~~~~~~~~~~~~~~~~~~~~~~~~~ +"do not print the user summary table" +flag off + + +option "user-list" - +#~~~~~~~~~~~~~~~~~~~ +"how to print per-user directory listings" +enum typestr="which" +values="size","file_count","both","none" +default="both" +optional +details=" + Similar to the global directory listings mentioned above, + adu can print two directory listings per user. This option + controls which of the these should be printed. +" +option "no-global-summary" - +#~~~~~~~~~~~~~~~~~~~~~~~~~~~ +"do not print the summary line" +flag off + +option "global-list" - +#~~~~~~~~~~~~~~~~~~~~~ +"how to print global directory listings" +enum typestr="which" +values="size","file_count","both","none" +default="both" +optional +details=" + By default adu prints two global directory listings: The + first prints the directory names ordered by the sum of the + sizes of the contained files while the second listing prints + them sorted by the number of files. This option can be used + to print only one or neither of these two listings. +" +option "print-base-dir" - +#~~~~~~~~~~~~~~~~~~~~~~~~ +"whether to include the base-dir in the output" +flag off +details=" + If this flag is given, all directories printed are prefixed + with the base directory. The default is to print paths relative + to the base dir. +" + +######################## +section "Format strings" +######################## + +option "global-summary-format" - +#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +"How to format the global summary" +string typestr="" +default="#directories: %(dirs), #files: %(files), size: %(size)\n\n" +details=" + dirs: The number of directories + files: The number of files + size: Total size of all files +" +optional + +option "user-summary-format" - +#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +"How to format the user summary" +string typestr="" +default="%(pw_name:l:16) %(uid:r:5) %(dirs:r:5) %(files:r:5) %(size:r:5)\n" +details=" + pw_name: The user name + uid: The user id + dirs: The number of directories + files: The number of files + size: Total size of all files +" +optional