couchdb-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Dave Cottlehuber (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (COUCHDB-1536) Integrate Docs into Release Process
Date Fri, 02 Nov 2012 13:29:12 GMT

    [ https://issues.apache.org/jira/browse/COUCHDB-1536?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13489420#comment-13489420
] 

Dave Cottlehuber commented on COUCHDB-1536:
-------------------------------------------

Getting a failure during VPATH make due to missing PDFLATEX on OS X. I'm definitely not going
to have that available on windows, @nslater can you make it behave nicely?

if test -z "`which makeinfo`"; then \
	    /zfs/shared/repos/couch/git/build-aux/missing makeinfo; \
	fi
if test -n "`which sphinx-build`"; then \
	    sphinx-build -b texinfo -d doctrees -n -c /zfs/shared/repos/couch/git/share/doc/build/..
/zfs/shared/repos/couch/git/share/doc/build/../src ./texinfo; \
	    make -C texinfo info; \
	else \
	    /zfs/shared/repos/couch/git/build-aux/missing sphinx-build; \
	fi
Making output directory...
Running Sphinx v1.1.3
loading pickled environment... not yet created
building [texinfo]: all documents
updating environment: 25 added, 0 changed, 0 removed
reading sources... [100%] ssl                                                            
                                                                                         
                            
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
processing CouchDB.texi... index intro api-basics range configuring ssl os-daemons http-proxying
config_reference replication ddocs commonjs errors changes release api/reference api/configuration
api/authn api/database api/documents api/design api/misc api/local api/dbmaint json-structure

resolving references...
writing... done
copying images... ../images/futon-overview.png ../images/futon-editdoc.png ../images/futon-editeddoc.png
../images/futon-createdb.png ../images/futon-replform.png
copying Texinfo support files... /Users/dch/tmp/couchdocs/share/doc/build/texinfo/Makefile
done
build succeeded.
makeinfo --no-split -o 'CouchDB.info' 'CouchDB.texi'
CouchDB.texi:5: Warnung: nicht erkannter Kodierungsname „UTF-8“.
if test -z "`which pdflatex`"; then \
	    /zfs/shared/repos/couch/git/build-aux/missing pdflatex; \
	fi
WARNING: 'pdflatex' is needed, and is missing on your system.
         You might have modified some files without having the
         proper tools for further handling them.  Check the 'README' file,
         it often tells you about the needed prerequisites for installing
         this package.  You may also peek at any GNU archive site, in case
         some other package would contain this missing 'pdflatex' program.
make[4]: *** [pdf.stamp] Error 1
make[3]: *** [all-recursive] Error 1
make[2]: *** [all-recursive] Error 1
make[1]: *** [all-recursive] Error 1
make: *** [all] Error 2
                
> Integrate Docs into Release Process
> -----------------------------------
>
>                 Key: COUCHDB-1536
>                 URL: https://issues.apache.org/jira/browse/COUCHDB-1536
>             Project: CouchDB
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions: 1.3
>            Reporter: Dave Cottlehuber
>            Assignee: Noah Slater
>              Labels: docs,, make
>             Fix For: 1.3
>
>
> List of outstanding tasks for integrating documentation into CouchDB build chain:
> - create DNS CNAME docs -> couchdb.readthedocs.org 
> - add that to quicklinks on main site
> - extend makefile to: check for sphinx-build in PATH, & do the right thing in make
dist
> - check if that works in VPATH build
> - update wiki /Documentation as required

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

Mime
View raw message