From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from danbala.ifoer.tuwien.ac.at (danbala.ifoer.tuwien.ac.at [128.130.168.64]) by krisdoz.my.domain (8.14.5/8.14.5) with ESMTP id s33M6Yvu026763 for ; Thu, 3 Apr 2014 18:06:35 -0400 (EDT) Received: by danbala.ifoer.tuwien.ac.at (Postfix, from userid 116) id DA66E3903AA; Fri, 4 Apr 2014 00:06:32 +0200 (CEST) Date: Fri, 4 Apr 2014 00:06:32 +0200 From: Thomas Klausner To: discuss@mdocml.bsd.lv Subject: Re: pod2mdoc, docbook2mdoc Message-ID: <20140403220632.GC20391@danbala.tuwien.ac.at> References: <20140331205736.GJ31866@iris.usta.de> <20140331213020.GD29643@danbala.tuwien.ac.at> <5339E423.9010007@bsd.lv> <20140331222118.GB15415@iris.usta.de> <20140331223147.GA17640@danbala.tuwien.ac.at> <533D4DE1.4030304@bsd.lv> <20140403121738.GA6386@danbala.tuwien.ac.at> <533D552E.1080407@bsd.lv> <20140403135302.GA22574@iris.usta.de> X-Mailinglist: mdocml-discuss Reply-To: discuss@mdocml.bsd.lv MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20140403135302.GA22574@iris.usta.de> On Thu, Apr 03, 2014 at 03:53:02PM +0200, Ingo Schwarze wrote: > Thomas, you are already aiming high. Yes! > All your suggestions definitely make sense, but > they are beyond what the current state-of-the-art tools can do. ... > Eric S. Raymond basically says that it took > him a decade to get there, and he calls it very difficult. A few years ago when I last tried doclifter I wasn't very impressed, and your comparison today doesn't impress me much either... Thanks for that comparison, btw! > Which doesn't mean that Kristaps can't do better in a few days, > but... well... ESR isn't exactly known for stupidity in the > free software world, either, so bear with Kristaps. :) I hope I wasn't misunderstood: Kristaps, you're doing great! I didn't mean to put you down in any way. > No, it should not. The *.pod suffix just means "plain old documentation", > that can be any section, even 3p - though 1, 3, 5, 7, 8 are maybe more > likely than 3p because most Perlmodule docs are embedded in the *.pm. > Anyway, you shouldn't conclude anything from a *.pod filename. So worst-case we could tell pod2man with a flag which section the man page belongs to. Thomas -- To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv