From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from scc-mailout-kit-02.scc.kit.edu (scc-mailout-kit-02.scc.kit.edu [129.13.231.82]) by fantadrom.bsd.lv (OpenSMTPD) with ESMTP id d23dda29 for ; Sat, 7 Nov 2015 08:34:43 -0500 (EST) Received: from asta-nat.asta.uni-karlsruhe.de ([172.22.63.82] helo=hekate.usta.de) by scc-mailout-kit-02.scc.kit.edu with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (envelope-from ) id 1Zv3dg-0002Rq-5M; Sat, 07 Nov 2015 14:34:41 +0100 Received: from donnerwolke.usta.de ([172.24.96.3]) by hekate.usta.de with esmtp (Exim 4.77) (envelope-from ) id 1Zv3dg-0005rN-36; Sat, 07 Nov 2015 14:34:40 +0100 Received: from athene.usta.de ([172.24.96.10]) by donnerwolke.usta.de with esmtp (Exim 4.84) (envelope-from ) id 1Zv3df-00059G-Td; Sat, 07 Nov 2015 14:34:40 +0100 Received: from localhost (1031@localhost [local]); by localhost (OpenSMTPD) with ESMTPA id 8629712d; Sat, 7 Nov 2015 14:34:39 +0100 (CET) Date: Sat, 7 Nov 2015 14:34:39 +0100 From: Ingo Schwarze To: Peter Bray Cc: discuss@mdocml.bsd.lv Subject: Re: mdocml [CVS_2015_11_07] Installation Paths Message-ID: <20151107133439.GC10393@athene.usta.de> References: <563D956E.4010202@yahoo.com.au> 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: <563D956E.4010202@yahoo.com.au> User-Agent: Mutt/1.5.23 (2014-03-12) Hi Peter, Peter Bray wrote on Sat, Nov 07, 2015 at 05:08:46PM +1100: > Another couple of questions, yes I know, there have been a few already ;-) Thanks for looking at mandoc so thoroughly! > I'm have been investigating manual page systems, and with multiple > systems on the same hosts, I didn't want any conflicts. > > So I added to 'configure.local', some new variables: PROGRAM_PREFIX > and PROGRAM_SUFFIX, and defined the BINM_* and MANM_* variables in > terms of these variables. See the configure.local at the end of this > email. No problem doing that locally if you want to. Though personally, i find individual lines like BINM_APROPOS=mandoc_apropos much easier to read, but that's maybe a matter of taste. > Question: Could such behavior be the default? > By this I mean the use of the variables like PROGRAM_PREFIX No, i'd rather have people consider each program and manual separately. Renaming stuff is unwise unless you really consider the implications for each single file. > and PROGRAM_SUFFIX I don't see any use for that. Even you don't seem to use it. In general, i dislike scaffolding and want to keep stuff simple. Just because something can be done doesn't mean it should. > in the default > computations in 'configure', but with 'configure.local', still > allowing other users to make personal overrides. Of course, both > variables should default to the empty string. Just asking :-) And then we need to talk about precedence and overriding in the documentation, and people get confused? No, i don't like that. > On installation with the above in use, I noticed that soelim(1) is > installed without a requested prefix (and suffix) from BINM_SOELIM > (see the output of the find command below). The same is true of the > soelim manual page. And although 'config.h' defines 'BINM_SOELIM' > correctly (based on configure.local), nothing uses this definition. > It is even documented in configure.local.example, that BINM_SOELIM is > the name of the soelim command. Here, you found a real bug. Fixed in CVS! > Interestingly, in a recursive > case-insensitive search of the source code for "soelim", I could not > determine how man(1) invokes soelim(1), It never does. The mandoc toolbox doesn't require soelim(1) for any particular purpose. It is just provided as an additional, stand-alone tool in case anybody wants to call it manually for whatever reasons. > or tells a *roff implementation to invokes its variant > of soelim(1) (but I didn't look very hard). The mdoc version of man(1) never calls any external roff(7) implementation, so it never needs to tell anybody about soelim(1). > Also, the tbl.3 manual page is installed without a prefix or suffix. Does that conflict with anything? With what, specifically? > Additionally, the 'install' pseudo-target creates > "${INSTALLATION_PREFIX}/share/examples/mandoc", but does not install > any example files into it. Question: Is it an obsolete directory or do > other packages expect this directory to exist? (and, if so, why) It is obsolete, and i just deleted it. > % cat > configure.local << __EOF__ > > MANPATH_DEFAULT="${MANPATH}" OUCH, don't do that, don't use data from the environment in configure.local, use constant data instead. Otherwise, you get erratic build results depending on whatever the user happens to have set in their shell. Thanks! Ingo -- To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv