Subject: Bug#642761: [coreutils] chmod: manual page confusing about difference between MODE and OCTAL-MODE

From: Filipus Klutiero <[email-masked]>
Date: Sat, 24 Sep 2011 17:57:44 -0400

Package: coreutils
Version: 8.13-2
Severity: minor

The chmod SYNOPSIS has these 2 most prominent usages:

> chmod  [OPTION]... MODE[,MODE]... FILE...
>  chmod  [OPTION]... OCTAL-MODE FILE... 

The description then says:
> chmod  changes the file mode bits of each given file according to 
> /mode/, which can be either a symbolic representation of changes to 
> make, or an octal number representing the bit pattern for the new mode 
> bits. 

without distinguishing between MODE and OCTAL-MODE.