From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from scc-mailout.scc.kit.edu (scc-mailout.scc.kit.edu [129.13.185.202]) by krisdoz.my.domain (8.14.3/8.14.3) with ESMTP id pAQCBhEU004337 for ; Sat, 26 Nov 2011 07:11:43 -0500 (EST) Received: from hekate.usta.de (asta-nat.asta.uni-karlsruhe.de [172.22.63.82]) by scc-mailout-02.scc.kit.edu with esmtp (Exim 4.72 #1) id 1RUH6a-0003EP-Ni; Sat, 26 Nov 2011 13:11:42 +0100 Received: from donnerwolke.usta.de ([172.24.96.3]) by hekate.usta.de with esmtp (Exim 4.72) (envelope-from ) id 1RUH6a-0007o3-QY; Sat, 26 Nov 2011 13:11:40 +0100 Received: from iris.usta.de ([172.24.96.5] helo=usta.de) by donnerwolke.usta.de with esmtp (Exim 4.72) (envelope-from ) id 1RUH6a-0005Iq-PT; Sat, 26 Nov 2011 13:11:40 +0100 Received: from schwarze by usta.de with local (Exim 4.72) (envelope-from ) id 1RUH6a-0004Y5-Og; Sat, 26 Nov 2011 13:11:40 +0100 Date: Sat, 26 Nov 2011 13:11:40 +0100 From: Ingo Schwarze To: Kristaps Dzonsons Cc: tech@mdocml.bsd.lv Subject: Re: mdocml: Store page titles in the correct case, and by default, only put Message-ID: <20111126121140.GC13912@iris.usta.de> References: <201111261123.pAQBNvRl005038@krisdoz.my.domain> <4ED0D36B.2080503@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: <4ED0D36B.2080503@bsd.lv> User-Agent: Mutt/1.5.21 (2010-09-15) Hi Kristaps, Kristaps Dzonsons wrote on Sat, Nov 26, 2011 at 12:54:19PM +0100: > On 26/11/2011 12:23, schwarze@mdocml.bsd.lv wrote: >> Log Message: >> ----------- >> Store page titles in the correct case, and by default, only >> put stuff into the database that man(1) will be able to retrieve. >> However, support an option to use all directories and files. >> feedback and ok kristaps@ > Some post-checkin comments. First, I think we can make verbose and > use_all into global statics, as they don't change and we're just > cluttering the function prototypes with them. No? Yes. I think a small number of global static variables is fine in a small utility program, even though lots of global statics tend to cause confusion in big systems. So i like your suggestion. > And second, in the manual, can you put the default usage following > the arguments? > > Its arguments are as follows: > > -a blah blah > > -b blah blah > > By default, foo does this and that... > > This is much easier to read and doesn't require that operators read > each option to understand the defaults. Yes, that makes sense. By the same argument, i'd even move the defaults *before* the options (leaving the fatal errors where they are, of course). When you are satisfied with the defaults, you don't even need to read the options, and unless you understand the defaults, the options (in particular -a) won't make much sense to you. I'm planning to handle these two tasks after putting the unformatted parser in and adding the type field to the index file. Yours, Ingo -- To unsubscribe send an email to tech+unsubscribe@mdocml.bsd.lv