On Tue, Apr 29, 2014 at 05:10:31PM +0000, Duncan wrote: > To users familiar with Unix/POSIX/Linux CLI, "usage" (as --usage) is most > often seen as a rather less common and generally briefer form of --help, > usually with the distinction being that --help may be a screen or more of > output, while --usage is much shorter, perhaps a single line.
I did a quick check of ~20 randomly chosen binaries in /usr/bin and none of them had --usage among options, unlike --help. > While I had seen it listed in manpages and --help output often enough, > once I actually went looking for real examples I had a hard time finding > some, but eventually found some in the grub (grub2) command set. We can put usage examples to the man pages, following git here. > OTOH, for CLI veterans anyway, standard old "du" (btrfs fi du) should be > as immediately understood as "df". > Given that confusion, I'd suggest either simply making it du, or making > it "device_usage" but with "du" a documented alias printing exactly the > same output, thus giving folks an easy way to avoid the _. Though adding a command alias is trivial, I'd rather not do that right now. Let's see if we can live with 'btrfs fi us'. I worked for me during developing the patch series. -- To unsubscribe from this list: send the line "unsubscribe linux-btrfs" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
