add one-line descriptions to each program usage()

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



See commit:

https://github.com/stevenhoneyman/util-linux/commit/d5b828e418102b354025bbf7f91b2dcdfc1f4e66

the idea is to add one-line descriptions to each program usage().

Comments?

 IMHO it's not so bad idea, the description will be translated, and
 --help output more informative. Note that for example coreutils use it
 too.

 Anyway, the patch is not ready. I don't like the command name in the
 description -- it's redundant.

 Maybe it would be better to move the description above Options
 section. Something like

---
 Usage:
   fdisk [options] <disk>      change partition table
   fdisk [options] -l [<disk>] list partition table(s)

 Manipulate and list disk partition table.       <---!

 Options:
    -b, --sector-size <size>      physical and logical sector size
    ...
---

    Karel

-- 
 Karel Zak  <kzak@xxxxxxxxxx>
 http://karelzak.blogspot.com
--
To unsubscribe from this list: send the line "unsubscribe util-linux" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html




[Index of Archives]     [Netdev]     [Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux