tech@mandoc.bsd.lv
 help / color / mirror / Atom feed
From: Kristaps Dzonsons <kristaps@bsd.lv>
To: tech@mdocml.bsd.lv, Alexis <surryhill@gmail.com>
Subject: Re: Allow configure variables to be set from environment
Date: Sat, 17 Jan 2015 21:10:10 +0100	[thread overview]
Message-ID: <54BAC1A2.2060907@bsd.lv> (raw)
In-Reply-To: <20150117010706.GH9772@iris.usta.de>

Alexis,

Ingo's right on this one, but let's think a bit more.  There are a lot 
of OS X people out there and a lot of them use homebrew.  I think it's 
worthwhile to have (or at least consider having) an official mandoc in 
homebrew, but it should be done right.  Doing a naive installation isn't 
enough.

The problem, as mentioned, is that makewhatis(8) won't pick up any 
homebrew manuals, making mandoc(1) only useful as a standalone binary 
operating directly on manpages (e.g., mandoc path/to/manpage.1).

You can patch makewhatis(8) not to check if the manpage is looking at 
symlinks outside of the MANPATH, but that's effectively opening up a 
security hole where mandoc(1) tools might be run on basically anything. 
  (By the way, did you plan on cron'ing makewhatis(8) or anything?)

If you don't patch makewhatis(8) and install it as-is, you're going to 
confuse users when their manpages don't show up when using the other 
tools installed with the package (apropos, man, etc.) or when running 
the respective mandoc arguments (-a, -f, etc.).

So either you patch makewhatis(8) or patch the installation to *only* 
install mandoc, then patch mandoc to omit -f, -k, and -a, and not 
respond to being invoked as apropos, whatis, or man.

Essentially, the question is whether you want mandoc as a constellation 
of tools (a man replacement) with security tools or a developer tool.

I don't know what the correct solution is here.  Bref, homebrew has issues.

Best,

Kristaps
--
 To unsubscribe send an email to tech+unsubscribe@mdocml.bsd.lv

  reply	other threads:[~2015-01-17 20:10 UTC|newest]

Thread overview: 15+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
     [not found] <sfid-H20150116-225859-+021.89-1@spamfilter.osbf.lua>
2015-01-16 21:58 ` Alexis
2015-01-16 23:32   ` Thomas Klausner
2015-01-17  1:31     ` Ingo Schwarze
2015-01-17  1:07   ` Ingo Schwarze
2015-01-17 20:10     ` Kristaps Dzonsons [this message]
2015-01-18  3:33       ` Ingo Schwarze
2015-01-20 15:15         ` Alexis
2015-01-21 23:05           ` Ingo Schwarze
2015-01-22  0:21             ` Kristaps Dzonsons
2015-01-22  0:35               ` Ingo Schwarze
2015-01-22  7:32                 ` Alexis
2015-01-22  7:26             ` Alexis
2015-01-23 22:05               ` Ingo Schwarze
2015-01-20 15:19     ` Alexis
2015-01-21 21:07       ` Ingo Schwarze

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=54BAC1A2.2060907@bsd.lv \
    --to=kristaps@bsd.lv \
    --cc=surryhill@gmail.com \
    --cc=tech@mdocml.bsd.lv \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).