943090846f
When running `make` I ran into a couple of problems building the manual. While I'm not entirely sure that this is the root cause, it appears to have been related to the fact that ruby 2.0 dropped syck completely in favor of psych (which was introduced in 1.9.2) for YAML processing. I'm currently using ruby 2.1.0p0. I'm assuming that the fact that the YAML engine was explicitly set to syck in the Rakefile was an attempt to work around some incompatibility between the two libraries, so I looked into what would be necessary to get it to work with the newer one. The changes to `manual.yml` ended up being pretty minor: I ran it through `iconv` to convert some ISO-8859-1 characters to UTF-8 and added some quotes in places (apparently you can't start a string value with '`').
Documentation
The jq website, manpages and some of the tests are generated from this
directory. The directory holds a Bonsai
website, and the manual is a YAML file in content/3.manual.
To build the documentation (including building the jq manpage), you'll need a working Ruby setup. The easiest way to get one is to install RVM and Ruby 1.9.3 like so:
\curl -L https://get.rvm.io | bash -s stable --ruby=1.9.3
After that finishes installing, you'll need to make sure RVM is on
your path by doing source $HOME/.rvm/scripts/rvm, or just opening a
new shell. See http://rvm.io for more info on RVM.
Once RVM is installed, you can install all the dependencies for jq's
documentation build by running this from the docs directory:
bundle install
When bundle manages to install the dependencies, rerun ./configure
in the jq root directory and then the Makefile will be able to
generate the jq manpage.