Re: [patch] nsswitch.conf.5: update for readability and latest glibc

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

 



>>> Thanks Mark. This looks good. I've done some light edits. Could you
>>> please review the below (also attached).
>>
>>
>> Hi Michael,
>>
>> I've reviewed your edits. They're almost all good, but I've had to counter
>> some of your light edits. Latest version below and attached.
>
> Hi Mark,
> Can you explain your changes? It looks like they mostly revert my additions of commas and formatting consistency with other pages.
> Why?
> Thanks, Michael

Hi Michael,

It's hard to know what exactly we're talking about here because your light edits were not supplied in a way that could easily be reviewed.  In fact, I had to diff the two to find out what you had edited.

I suggest the best approach is for you to apply my original patch unedited, then submit to this list a new patch with your suggested edits.  Then it will be easier for us to discuss which edits I didn't believe were correct or necessary, and others would also have transparency and be able to comment if they wished too.

Could you do that?

Thanks,
Mark.


-------- Original Message --------
From: "Michael Kerrisk (man-pages)" <mtk.manpages@xxxxxxxxx>
Sent: Fri Mar 30 00:22:24 GMT+01:00 2012
To: Mark R Bannister <mark@xxxxxxxxxxxxxxxxxxxxx>
Cc: linux-man@xxxxxxxxxxxxxxx
Subject: Re: [patch] nsswitch.conf.5: update for readability and latest glibc

On Fri, Mar 30, 2012 at 10:10 AM, Mark R Bannister
<mark@xxxxxxxxxxxxxxxxxxxxx> wrote:
> On 29/03/2012 19:33, Michael Kerrisk (man-pages) wrote:
>>
>> On Fri, Oct 14, 2011 at 9:26 AM, Mark R Bannister
>> <mark@xxxxxxxxxxxxxxxxxxxxx>  wrote:
>>>
>>> Hi,
>>>
>>> This patch applies to nsswitch.conf.5 in man-pages-3.36.
>>>
>>> My changes almost completely rewrite large sections of the man page.
>>>  They are needed to add clarity, correct grammar, reduce confusion, and
>>> bring up-to-date with the latest glibc.  I have checked the man page against
>>> the nss source code in glibc 2.14.90.
>>>
>>> Historical notes are demoted to the footer.
>>>
>>> I believe the rewrite makes the man page much clearer to understand, more
>>> authoratitive and easier to read.
>>>
>>> A web version of the man page is available here for proof reading:
>>> http://prose.sourceforge.net/man/linux/nsswitch.conf.5.html
>>>
>>> A patch is copied below, and also attached to this message.
>>>
>>> I am happy for my work to be released under the terms of the GNU General
>>> Public License.
>>
>> Thanks Mark. This looks good. I've done some light edits. Could you
>> please review the below (also attached).
>>
>
> Hi Michael,
>
> I've reviewed your edits.  They're almost all good, but I've had to counter
> some of your light edits.  Latest version below and attached.

Hi Mark,

Can you explain your changes? It looks like they mostly revert my
additions of commas and formatting consistency with other pages. Why?

Thanks,

Michael

-- 
Sent from my HTC
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html


[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux 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