On 17 February 2015 at 05:02, Mike Frysinger <vapier@xxxxxxxxxx> wrote: > On 16 Feb 2015 11:30, Kees Cook wrote: >> On Sun, Feb 15, 2015 at 9:51 AM, Mike Frysinger wrote: >> > On 15 Feb 2015 16:13, Michael Kerrisk (man-pages) wrote: >> >> On 02/15/2015 11:46 AM, Mike Frysinger wrote: >> >> > On 17 Jan 2015 23:22, Kees Cook wrote: >> >> >> --- a/man2/syscall.2 >> >> >> +++ b/man2/syscall.2 >> >> >> @@ -36,6 +36,8 @@ >> >> >> .\" >> >> >> .\" 2002-03-20 Christoph Hellwig <hch@xxxxxxxxxxxxx> >> >> >> .\" - adopted for Linux >> >> >> +.\" 2015-01-17, Kees Cook <keescook@xxxxxxxxxxxx> >> >> >> +.\" Added mips and arm64. >> >> >> .\" >> >> > >> >> > can we scrub changelogs from the man pages in general ? they're usually >> >> > incomplete and rarely provide more than `git log -p`. >> >> >> >> Yes, I tend to discourage them these days, but don't always worry too much if >> >> someone adds them to patch. >> > >> > in this case, i think Kees was following apparent convention rather than >> > thinking he always add one. so i'm suggesting we help out at least the >> > people who are just trying to DTRT by scrubbing the tree of existing ones >> > that aren't useful. >> >> Yeah, I tend to try to follow the convention in the file. It's wasn't >> clear what to do. I'm happy to send a patch to wipe my entries, if >> that's desired. > > i don't think we need to make you do that one off :). if Michael is happy with > scrubbing the code base, lets go that route. While I (generally) discourage changelogs in the source, I'm not concerned enough to actually do anything about this (and Kees don't worry about a patch). In some cases, the changelogs do have actually useful info (from pre-Git days), and even since then I myself find a few entries are sometimes useful to get a quick idea of the evolution of a page. Yes, some entries are just noise, but automating some solution to remove them would be error prone and require moderate effort for tiny benefit. Thanks, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/ -- 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
