Re: [PATCH 2/3] hwclock: remove unneeded stuff from the man-page header

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

 



On Tue, Mar 17, 2015 at 08:35:02PM -0400, J William Piggott wrote: 
> First, you have no right to assign my name to anything, let alone a
> legal notice.

This is valid point, but it would be also nice if you guys will be able
to keep our discussions in friendly climate. This is not lkml, right? ;-)

> Second, we've already been through this. The decision was left to Karel
> and he accepted it as is. There is nothing wrong with a man-page having
> some top comments.

Well, I miss the header. It's fine (and it's recommended) to add your
copyright to header. I personally prefer git to record history than
use file header for this purpose, but I have no strong opinion for
this. More important is to have nice man pages with usable content.

Note that in code I sometimes add my name and date to the comment
before some important code block. Maybe you can use the same in man
pages.  For example add a comment before man page section rather than
use man page header for this purpose.

    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