incubator-couchdb-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Jan Lehnardt <...@apache.org>
Subject Re: Docs, second try
Date Sun, 17 Jun 2012 13:17:00 GMT

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` 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`.
> 
> Any help is appreciated!
> Cheers
> Jan
> -- 
> 
> 
> 
> 


Mime
View raw message