db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "ASF subversion and git services (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (DERBY-6898) Improve developer documentation for docs
Date Sun, 02 Oct 2016 23:05:20 GMT

    [ https://issues.apache.org/jira/browse/DERBY-6898?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15541120#comment-15541120

ASF subversion and git services commented on DERBY-6898:

Commit 1763109 from [~bryanpendleton] in branch 'site/trunk'
[ https://svn.apache.org/r1763109 ]

DERBY-6898: Improve developer documentation for docs

> Improve developer documentation for docs
> ----------------------------------------
>                 Key: DERBY-6898
>                 URL: https://issues.apache.org/jira/browse/DERBY-6898
>             Project: Derby
>          Issue Type: Improvement
>          Components: Web Site
>            Reporter: Bryan Pendleton
>            Assignee: Bryan Pendleton
> The information at
>     http://db.apache.org/derby/manuals/dita.html
> Needs several improvements:
> 1) In order to successfully use Ant to build the docs with a modern environment, you
must set CLASSPATH to include 
> {code}
> avalon-framework-4.2.0.jar  
> fop.jar
> batik-all-1.6.jar         
> {code}
> from the docs/trunk/lib directory, as in:
> {code}
> CLASSPATH=/docs/trunk/lib/fop.jar:/docs/trunk/lib/avalon-framework-4.2.0.jar:/docs/trunk/lib/batik-all-1.6.jar
ant html.ref
> {code}
> The documentation notes that you must do this "For PDF output", but
> in fact you have to do this for any sort of docs build, even html output.
> Otherwise you get a failed build, with mysterious error messages about how the Xerces
parsers cannot be found in the CLASSPATH. Note that the jars that you are adding to the CLASSPATH
aren't the same as the xercesImpl and xml-apis jars that are in trunk/lib, so there is some
strange mystery here that I don't understand, but modifying CLASSPATH in this way allows the
doc build to work.
> 2) If you are working on Fedora, or on another platform where the system 'svn' executable
uses LIBMAGIC, then you need to specify an alternate subversion/config file in your home directory
to ensure that the svn eol style is correct when you are adding new files to subversion with
svn add. On my Fedora system, this worked:
> {code}
> *.dita = svn:mime-type=text/xml;svn:eol-style=native
> *.ditamap = svn:mime-type=text/xml;svn:eol-style=native
> {code}

This message was sent by Atlassian JIRA

View raw message