Date: Tue, 10 Jul 2001 17:37:51 -0600 From: Warner Losh <imp@harmony.village.org> To: Greg Lehey <grog@FreeBSD.org> Cc: Ruslan Ermilov <ru@FreeBSD.org>, doc@FreeBSD.org Subject: Re: cvs commit: src/sbin/vinum vinum.8 Message-ID: <200107102337.f6ANbpJ47680@harmony.village.org> In-Reply-To: Your message of "Wed, 11 Jul 2001 08:26:05 %2B0930." <20010711082605.D64441@wantadilla.lemis.com> References: <20010711082605.D64441@wantadilla.lemis.com> <200107101800.f6AI0Jg09923@freefall.freebsd.org> <200107101004.f6AA49e06877@freefall.freebsd.org> <200107041418.f64EIXJ57365@freefall.freebsd.org> <20010704173757.A296@sydney.worldwide.lemis.com> <20010705084955.A92314@sunbay.com>
next in thread | previous in thread | raw e-mail | index | archive | help
[[ I've redirected this to doc@ because the greg cc'd core for reasons that make no sense to me ]] 1) WOULD YOU STOP CCING CORE UNTIL YOUVE MADE AN ATTEMPT TO RESOLVE THIS IN DOC. I've said it before and will say it again: take your fight elsewhere and if you can't resolve it, then come back to core. Now, onto the meat of the dispute: In message <20010711082605.D64441@wantadilla.lemis.com> Greg Lehey writes: : > Nope, this was *you* who, with no valid reason, backed out my change : > without explaining. : : I first asked you to back it out, and when you refused (without : stating a valid reason), I did it myself. My valid reason is that the : name of the program is vinum, not VINUM. Your reason for this change : was bogus: you said that troff couldn't handle lower case in this : position, which is just plain wrong. Even if it were right, it would : be the wrong solution. You may wish to provide some more history here, since I've redirected it to doc@, where it belongs. : > From about two thousand -mdoc manpages that could be found in src/ : > tree (including src/contrib/ ones), this manpage was the only one : > with lowercased document title, : : After you had changed all the rest. Tradition is on RU's side here. man cp on my SunOS 4.1.3 box shows CP not cp. : > and this *is* a good reason to keep it in uppercase. : : No, it's not. Seems like a good reason to keep it upper case to me. Let's let doc deside. : > mdoc(7) police: removed HISTORY info from the .Os call. : : The HISTORY section is of interest; it seems that you have now decided : to axe it in all man pages. If this is a requirement of mandoc, we : should review whether we want to be that compliant. Get your facts straight. All he did was remove BSD from the .Os call. The history sections are still there. I just verified this. It means that we'll have: FreeBSD 4.3 April 18, 1994 FreeBSD 4.3 at the bottom of the page rather than: 4th Berkeley Distribution April 18, 1994 4th Berkeley Distribution which seems reasonable to me. Other BSDs have done this. Eg, he changed: .Os BSD4 to .Os : I find all of these changes objectionable. You shouldn't be required : to change correct punctuation to incorrect punctuation, correct number : to incorrect number (AUTHOR to AUTHORS), correct case to incorrect : case, nor to remove relevant information. Please point to the : document which mandates this, and the part of the document which makes : this a requirement, not a recommendation. In addition, please stop : changing these man pages until we've had a chance to discuss whether : we really want to modify our man pages in this manner. This one I can't comment on. It also seems that you are being to personal in attacking ru here. Maybe you are right on these issues, but it seems that you are wrapping them all together when they should be handled separately. Warner To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200107102337.f6ANbpJ47680>