diff options
Diffstat (limited to 'man/man1/apf.1df')
| -rw-r--r-- | man/man1/apf.1df | 12 |
1 files changed, 6 insertions, 6 deletions
diff --git a/man/man1/apf.1df b/man/man1/apf.1df index 025af010..9c89857c 100644 --- a/man/man1/apf.1df +++ b/man/man1/apf.1df @@ -8,14 +8,14 @@ foorc foo --bar baz .SH DESCRIPTION Add newline-delimited arguments read from a file to a command's arguments -(before any given ones) before running it. This is intended as a quick way of +(before any given ones) before running it. This is intended as a quick way of implementing *rc files for interactive shell calls to programs that don't support such files, without having to use broken environment variables like GNU grep(1)'s GREP_OPTIONS. .P This enables you to use arguments with shell metacharacters and spaces in them -that you do not want expanded. The only exception is that you cannot have -newlines in any of the arguments. This was done to keep POSIX sh(1) +that you do not want expanded. The only exception is that you cannot have +newlines in any of the arguments. This was done to keep POSIX sh(1) compatibility. .P For example, given this simple program in our $PATH, printargs: @@ -56,10 +56,10 @@ Or just a shell function, if it's only wanted for interactive shells: .P $ printargs() { apf "$HOME"/.printargsrc printargs "$@" ; } .P -It's not considered an error if the file doesn't exist or is empty. If it's a +It's not considered an error if the file doesn't exist or is empty. If it's a directory or otherwise not byte-readable, an error will be printed to stderr, -but execution of the called program will continue anyway. Blank lines or lines -beginning with # are also ignored. Both leading and trailing whitespace is +but execution of the called program will continue anyway. Blank lines or lines +beginning with # are also ignored. Both leading and trailing whitespace is preserved. .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> |