I've been prodding Jan's docs branch this morning. Some successes, some fails.  

* I can't install xsltproc via brew (as in the docs README):

$ brew install xsltproc  
Error: No available formula for xsltproc  


* Regardless of that I got the docs to build, and made a PDF/bunch of html files.
* I couldn't get this to work with a make of couch itself, the build of couch crashes:

/tmp/couch $ ./bin/couchdb
Apache CouchDB 1.3.0a-7f1461e-git (LogLevel=info) is starting.
{"init terminating in do_boot",{{badmatch,{error,{bad_return,{{couch_app,start,[normal,["/tmp/couch/etc/couchdb/default.ini","/tmp/couch/etc/couchdb/local.ini"]]},{'EXIT',{{badmatch,{error,shutdown}},[{couch_server_sup,start_server,1,[{file,"couch_server_sup.erl"},{line,96}]},{application_master,start_it_old,4,[{file,"application_master.erl"},{line,274}]}]}}}}}},[{couch,start,0,[{file,"couch.erl"},{line,18}]},{init,start_it,1,[]},{init,start_em,1,[]}]}}

Crash dump was written to: erl_crash.dump
init terminating in do_boot ()

which I assume isn't related to docs.
* did a make clean in both docs and main dir, once I did that the docs build fails:
SEVERE: Exception
javax.xml.transform.TransformerException: org.apache.fop.fo.ValidationException: "{http://www.w3.org/1999/XSL/Format}block" is not a valid child of "fo:root"! (See position 1110:144)


I'm guessing something didn't get cleaned up correctly - I'm going to try a fresh check out next.

Where do you want to go with this beyond having it available from futon? Like I said in Berlin I'm happy to contribute where I can...  


On Sunday, 17 June 2012 at 14:17, Jan Lehnardt wrote:

>  
> On Jun 17, 2012, at 15:05 , Jan Lehnardt wrote:
>  
> >  
> > On Jun 17, 2012, at 12:47 , Jan Lehnardt wrote:
> >  
> > >  
> > > On Jun 17, 2012, at 12:12 , Jan Lehnardt wrote:
> > >  
> > > > Same repo, some news:
> > > >  
> > > > - updated NOTICE
> > > > - added minimal css styling to make it not look ass
> > > > - made make distcheck pass* (wooo!)
> > > > - linked the per-chapter build in Futon instead of the full-page.**
> > > >  
> > > > As far as I can see, this is good to go into master.
> > >  
> > > Well, one more thing™: I need to hook this up to `make install`.
> > > I'll try and do this right away.
> > >  
> >  
> >  
> > I got this half done, but I think I will need from you guys.
> >  
> > The latest version is still on https://github.com/janl/couchdb/tree/docs
> >  
> > If you do
> >  
> > $ export COUCHDB_DOC_JAR_DIR=/path/to/doc/jars
> > $ make
> > $ cd share/docs
> > $ make
> > $ cd ../..
> > $ make install
> >  
>  
>  
> actually:
>  
> $ cd share/docs
> $ make
> $ cd ../..
> [$ make]
> $ make install
>  
> Cheers
> Jan
> --  
>  
> >  
> > The docs get installed properly and the hook up with Futon works just fine.
> >  
> > Obviously, we want `make` in `share/doc` to run as part of the top level
> > make, but I don't know how to hook this up.
> >  
> > I tried porting all `Makefiles` in `share/doc` to `Makefile.am (http://Makefile.am)` like we do
> > elsewhere, but then the docs build system gets confused with paths, I don't
> > think this is going to work without porting the whole docs build system to
> > the way CouchDB uses make. An easier way for now would be to treat the docs
> > build system as a black box that gets started with `make` in share/docs.
> > `make install` for docs is handled in `share/Makefile.am (http://Makefile.am)`.
> >  
> > Any help is appreciated!
> > Cheers
> > Jan
> > --  
> >  
>  
>  
>