Documentation of fileMode could be improved to avoid user trip hazard
---------------------------------------------------------------------

                 Key: MASSEMBLY-229
                 URL: http://jira.codehaus.org/browse/MASSEMBLY-229
             Project: Maven 2.x Assembly Plugin
          Issue Type: Improvement
         Environment: n/a
            Reporter: Kelvin Goodson
            Priority: Minor


The website documentation for the fileMode parameter that occurs in a number of 
places in the assembly descriptor format description such as [1] does show a 
leading 0 for its values,  but it isn't clear that this is to declare the value 
as octal.  Anyone who is used to using the chmod command on *nix doesn't expect 
 to have to prefix the octal value with a 0, and therefore might assume the 0 
to be an insignificant digit.  It would be helpful to add a comment in the 
descriptions of these parameters that the value is interpreted as decimal 
unless preceded by a leading 0 to indicate an octal value.

[1] 
http://maven.apache.org/plugins/maven-assembly-plugin/assembly.html#class_file

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: 
http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

Reply via email to