All of lore.kernel.org
 help / color / mirror / Atom feed
From: Karel Zak <kzak@redhat.com>
To: J William Piggott <elseifthen@gmx.com>
Cc: Benno Schulenberg <bensberg@justemail.net>, util-linux@vger.kernel.org
Subject: Re: [PATCH 2/3] hwclock: remove unneeded stuff from the man-page header
Date: Wed, 18 Mar 2015 10:55:57 +0100	[thread overview]
Message-ID: <20150318095557.GA28925@ws.net.home> (raw)
In-Reply-To: <5508C836.1070702@gmx.com>

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@redhat.com>
 http://karelzak.blogspot.com

  reply	other threads:[~2015-03-18  9:56 UTC|newest]

Thread overview: 11+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2015-03-17 20:34 [PATCH 1/3] hwclock: remove an untrue phrase from the man page Benno Schulenberg
2015-03-17 20:34 ` [PATCH 2/3] hwclock: remove unneeded stuff from the man-page header Benno Schulenberg
2015-03-18  0:35   ` J William Piggott
2015-03-18  9:55     ` Karel Zak [this message]
2015-04-28 10:46   ` Karel Zak
2015-03-17 20:34 ` [PATCH 3/3] hwclock: fix spelling, punctuation and formatting mistakes in the man page Benno Schulenberg
2015-03-18  0:29   ` J William Piggott
2015-03-18 20:14     ` Benno Schulenberg
2015-04-08  8:22 ` [PATCH v2] " Benno Schulenberg
2015-04-16  7:49   ` Benno Schulenberg
2015-04-28 10:49   ` Karel Zak

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20150318095557.GA28925@ws.net.home \
    --to=kzak@redhat.com \
    --cc=bensberg@justemail.net \
    --cc=elseifthen@gmx.com \
    --cc=util-linux@vger.kernel.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.