On Mar 29, 2010, at 10:42 AM, Darren J Moffat wrote: > On 29/03/2010 18:30, Don Cragun wrote: >>> + + Indicates the file/directory was added in the later dataset >>> + - Indicates the file/directory was removed in the later dataset >>> + M Indicates the file/directory was modified in the later dataset >>> + R Indicates the file/directory was renamed in the later dataset >> >> Again, "file/directory" should just be "file" in all four lines above. > > While a that may be technically true I personally found it very useful that > it said file/directory. Particularly since this isn't a POSIX C API man page. > > I'd rather it made it clear that both files and directories, and all other > types of filesystem objects are supported here, and that it do so by > explicitly saying file and directory.
I'm not an ARC member, so you are free to ignore my comments. But, explicitly saying "file of any type and file of type directory" makes absolutely no sense to me. I don't see that it is clearer; it just raises the question of what does "file" mean on this man page if "directory" is not a type of file. I know you don't like POSIX/SUS based man pages, but <sys/stat.h> is pretty basic. It clearly shows that the S_IFMT portion of the st_mode field (which has type mode_t) specifies the file type. - Don > > -- > Darren J Moffat
