Mailing-List: contact dev-help@couchdb.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@couchdb.apache.org
Received-SPF: neutral (nike.apache.org: local policy)
MIME-Version: 1.0
In-Reply-To: <20120929115118.3907.14488@eos.apache.org>
References: <20120929115118.3907.14488@eos.apache.org>
Date: Mon, 1 Oct 2012 10:40:47 +0200
Message-ID: 
 <CAL+Y1nuyoT+1PT_728Fw4PyJkX++TQeSbFqaH8rby72eAQxOjQ@mail.gmail.com>
Subject: Re: [Couchdb Wiki] Update of "Documentation" by NoahSlater
From: Dave Cottlehuber <dch@jsonified.com>
To: dev@couchdb.apache.org
Content-Type: text/plain; charset=ISO-8859-1

On 29 September 2012 13:51, Apache Wiki <wikidiffs@apache.org> wrote:
> Dear Wiki user,
>
> You have subscribed to a wiki page or wiki category on "Couchdb Wiki" for change notification.
>
> The "Documentation" page has been changed by NoahSlater:
> http://wiki.apache.org/couchdb/Documentation?action=diff&rev1=17&rev2=18
>
>   There is no makefile support yet. It should do the following:
>
>    * make sure search works
> +   * current get an error
> +   * "XMLHttpRequest cannot load file://[...]/share/docs/build/html/searchindex.js. Origin null is not allowed by Access-Control-Allow-Origin."

This does work (at least it did last week) but your browser won't load
from filesystem (CORS err). Try using mongoose or whatever to serve
the folder directly & check over http://localhost. Does it still fail?

>    * check sphinx-build is in path
>      * check sphinx, docutils, and pygments are installed

I'd not bother with all that. If sphinx-build is in the path & the
modules aren't it won't run anyway, so make should pick up the error,
right?

>      * add note to readme about these being required for docs, like help2man

Underway.