Re: [PATCH 0/5] hwclock: clean up messages

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

 



On Fri, Oct 24, 2014, at 14:22, JWP wrote:
> I would agree that it should have been named --verbose. However, I 
> have not suggested it because of Util-linux guidelines:
> 
> From util-linux//Documentation/howto-usage-function.txt
> 
> "The rule of thumb with other options is that once they exist, you may
> not change them, nor change how they work, nor remove them."

Sure.  But that does not mean you cannot add a synonym for --debug,
say --verbose, and document it, and undocument the original --debug
(but still recognize it and act upon it, just like in hwclock -v is
still recognized as a synonym of -V).  And then in a couple of years
print a deprecation warning when --debug is used, and then remove it
another two years later.

When you are going to refactor hwclock, many messages are going to
change anyway, and if anyone has become dependent on the --debug
messages, they will have to modify their scripts anyway; it will
then be a small trouble to change --debug to --verbose.  The rule
of thumb is mainly for options that people tend to use in scripts;
you don't want to break those without a very good reason.

Benno

-- 
http://www.fastmail.fm - One of many happy users:
  http://www.fastmail.fm/help/overview_quotes.html

--
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