On Mon, Mar 29, 2010 at 06:42:17PM +0100, 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'd say: call them "objects". (First, this matches ZFS's internal terminology. Second, it almost certainly will mean, to most users, "regular files, directories, symlinks, device nodes, ... Third, we really ought to call such things "objects" since calling them "files" is certainly confusing.) Nico --
