Re: http://java.sun.com/j2se/1.5.0/docs/tooldocs/solaris/jar.html

The documentation to the JAR tool describes the `-C' flag as "Temporarily changes directories (cd dir) during execution of the jar command while processing the following inputfiles argument". In the Synopsis section, it says: "Multiple -C dir inputfiles sets are allowed."

The "Inputfiles" argument is defined as "Files or directories, separated by spaces, to be combined into jarfile [...]".

I understood this to mean that one -C option applies to all following arguments until the next -C option is seen. However, it applies only to the immediately next argument; further inputfiles are searched for relative to the original working directory.

I ask that the wording be clarified (e.g., `inputfiles' could be replaced by `inputfile').

However, you could also considering modifing the behavior of the JAR utility to actually change directory for all following inputfile arguments until the next -C argument; this is how (at least) GNU tar(1) works and your documentation does state "[-C's] operation is intended to be similar to the -C option of the UNIX tar utility."