From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtp1.rz.uni-karlsruhe.de (Debian-exim@smtp1.rz.uni-karlsruhe.de [129.13.185.217]) by krisdoz.my.domain (8.14.3/8.14.3) with ESMTP id oAULZqYq003224 for ; Tue, 30 Nov 2010 16:35:53 -0500 (EST) Received: from hekate.usta.de (asta-nat.asta.uni-karlsruhe.de [172.22.63.82]) by smtp1.rz.uni-karlsruhe.de with esmtp (Exim 4.63 #1) id 1PNXrb-0005u4-IB; Tue, 30 Nov 2010 22:35:51 +0100 Received: from donnerwolke.usta.de ([172.24.96.3]) by hekate.usta.de with esmtp (Exim 4.72) (envelope-from ) id 1PNXrb-0004Rc-Gl; Tue, 30 Nov 2010 22:35:51 +0100 Received: from iris.usta.de ([172.24.96.5] helo=usta.de) by donnerwolke.usta.de with esmtp (Exim 4.69) (envelope-from ) id 1PNXrb-0005cp-EH; Tue, 30 Nov 2010 22:35:51 +0100 Received: from schwarze by usta.de with local (Exim 4.72) (envelope-from ) id 1PNXrb-0000Bg-3T; Tue, 30 Nov 2010 22:35:51 +0100 Date: Tue, 30 Nov 2010 22:35:50 +0100 From: Ingo Schwarze To: tech@mdocml.bsd.lv Cc: jmc@openbsd.org Subject: Re: Where to put mandoc roff documentation? Message-ID: <20101130213550.GB4617@iris.usta.de> References: <20101127184503.GA27534@iris.usta.de> <20101127211832.GA27550@kerhand.co.uk> <20101127214631.GC27534@iris.usta.de> <20101128152330.GA23201@iris.usta.de> <4CF3DC5C.1040207@bsd.lv> X-Mailinglist: mdocml-tech Reply-To: tech@mdocml.bsd.lv MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <4CF3DC5C.1040207@bsd.lv> User-Agent: Mutt/1.5.21 (2010-09-15) Hi Kristaps, Kristaps Dzonsons wrote on Mon, Nov 29, 2010 at 06:01:16PM +0100: > I, for one, have no issues with these changes. Good, they are now in OpenBSD, and we now install roff(7). Thanks for your review, Jason! > Feel free to commit them into BSD.lv. I'd like to, but that path is blocked for now. Kristaps, you are lacking lots of features! Look at this: revision 1.9 date: 2010/11/27 02:17:43; author: schwarze; state: Exp; lines: +19 -2 Document .so. This file still needs lots of love before we can consider installing it. ---------------------------- revision 1.10 date: 2010/11/27 17:46:46; author: schwarze; state: Exp; lines: +240 -85 Document .de and .de1. Extend and improve .ds documentation. Improve .ig and .nr documentation. Add minimal explanations for .am, .ami, .am1, and .dei. Start improving the distinction of requests and macros. Add myself as an author. ---------------------------- revision 1.2 date: 2010/11/28 01:00:41; author: schwarze; state: Exp; lines: +17 -1 Parse and ignore the .ad, .hy, .nh, and .ne roff requests. Ignoring these can neither cause information loss nor serious formatting issues. As they are frequently used by pod2man(1), this considerably reduces ERROR noise from mandoc -Tlint for the Perl manuals. ---------------------------- revision 1.3 date: 2010/11/29 00:12:02; author: schwarze; state: Exp; lines: +30 -2 Implement the roff .ft (change font) request for man(7). Of course, we don't want to encourage low-level physical markup, but pod2man(1) writes such requests, so Perl manuals contain them, and some Xenocara and lots and lots of ports manuals use them as well. In base and Xenocara, this will reduce mandoc -Tlint ERROR noise; in ports, it will improve rendering of many manuals. Of course, none of this can go into bsd.lv right now, or you badly get your code and docs out of sync. Trying to apply just the cleanup diff blows up pathetically: Patching file roff.7 using Plan A... Hunk #1 failed at 15. Hunk #2 failed at 123. Hunk #3 failed at 169. Hunk #4 failed at 180. Hunk #5 failed at 203. Hunk #6 failed at 217. Hunk #7 failed at 238. Hunk #8 failed at 272. Hunk #9 succeeded at 151 with fuzz 1 (offset -155 lines). Hunk #10 succeeded at 334 (offset -31 lines). No such line 362 in input file, ignoring Hunk #11 succeeded at 259 (offset -155 lines). Hunk #12 succeeded at 399 (offset -31 lines). Hunk #13 failed at 433. Hunk #14 failed at 458. Hunk #15 failed at 483. Hunk #16 succeeded at 356 with fuzz 2 (offset -165 lines). Hunk #17 succeeded at 506 with fuzz 2 (offset -48 lines). 11 out of 17 hunks failed--saving rejects to roff.7.rej done Look at the offsets, it's not even patching the right parts of the file for those few chunks that don't conflict. So sorry... Yours, Ingo -- To unsubscribe send an email to tech+unsubscribe@mdocml.bsd.lv