Gentoo is kind of an edge case, very very few people run it. According to
distrowatch its rank 44:
I suspect while a certain class of we nerds prefers a source based
distribution, the vast majority of end-users do not. And I believe Gentoo
is by *far* the most popular of the source-based Linux distros.
Most of those requirements you listed are pretty popular and widely used.
I’m no ruby fan myself, but Ruby’s popularity is substantially larger than
Gentoo’s. According to a glassdoor study, its the 9th most in-demand
ranking even ahead of C and Go.
So the thing is, the tool chain for asciidoc was *considerably* more
onerous for me than asciidoctor. I didn’t go out choosing asciidoctor
because I loved it, or even that I already had prior experience with it. I
chose it after a fairly large amount of research, after giving up in
*anger* at attempts to make the prior docbook based tool chain function on
my primary development platforms (I use MacOS X and illumos — I don’t
recall which gave me trouble now.) After hours and hours of debugging, I
finally said screw it, I needed something I that Just Worked. asciidoctor
fit the bill for me.
TBH, we could probably change the format of the man pages for editing from
the adoc format to simple mdoc. That was more formatting work, but it
would involve very little effort for folks who want to get access to man
style pages. (Most man viewers can read mdoc pages natively.) That might
be easier for you?
And further, I remind everyone, the documentation formatting is entirely
optional. Actually, it was not normally enabled by default in previous
releases. Formal copies of the documentation are posted at nanomsg.org for
everyone, so it shouldnt be a stopper for anyone.
On Mon, May 16, 2016 at 7:46 AM, Dirkjan Ochtman <dirkjan@xxxxxxxxxx> wrote:
On Mon, May 16, 2016 at 3:54 PM, Garrett D'Amore <garrett@xxxxxxxxxx>
I actually found installing asciidoctor far less onerous than the oldtoolchain. I had lots of problems getting the docbook and libxslt to work
for me - probably because my preferred work platform is not Linux.
format documentation. But it's entirely optional to do so. Getting ruby
So Ruby is a requirement - and all of its dependencies - if you want to
for most platforms is usually close to trivial. And I think asciidoctor
should be platform neutral. If it isn't packaged for other platforms that
might just be due to lack of effort at the distro.
So in the context of source-based Linux distributions like Gentoo,
this means that formatting documentation will for many people require
first building libyaml, ragel, ruby, rubygems, rake, racc, json, rdoc
and finally asciidoctor. To me, the cost/benefit of that is totally
As far as the Unknown thing - that's a mystery to me. What version ofcmake were you using ?
I have cmake-3.3.1 installed.