You are viewing a plain text version of this content. The canonical link for it is here.
Posted to derby-dev@db.apache.org by scott hutinger <sr...@www.mprojects.Horrabin.wiu.edu> on 2005/03/24 15:12:00 UTC

[docs] dita files

Jeff,

I need to put the two files you sent to me in the docs.  But, how do you 
want to manage the docs at it currently stands.  If one follows the 
directions on the website (at least those running linux) will have the 
problems I had with ref failing.

Also: the manual ids on the website derby/manuals/dita.html don't quite 
map up, at least refguide.  Should the directory be changed to refguide 
from ref?  That way it would map to the manual id on the website.

Also, when putting the files into the dita toolkit, should 
dita2fo_shell.xsl be changed to dita2fo-shell.xsl to work correctly.  Is 
this the only file (besides the dita2fo-links.xsl) that need to be 
included in the toolkit?  Or should it copy all the new ones from you 
and the other two?

Also, it might be good to do something like the following for those that 
don't read very well like myself:

Index: build.xml
===================================================================
--- build.xml   (revision 158792)
+++ build.xml   (working copy)
@@ -5,7 +5,17 @@
   <target name="usage">
     <echo message="For pdf output, run &quot;ant pdf&quot;"/>
     <echo message="For html output, run &quot;ant html&quot;"/>
-  </target>
+    <echo>
+  Manuals:
+     adminguide
+     getstart
+     devguide
+     ref - (use ref) refguide
+     tools
+     tuning
+       ant html.adminguide || ant pdf.adminguide
+     </echo>
+    </target>

   <property file="${basedir}/docs.properties"/>

Although the previous diff need some additions/mods etc...

thanks,
scott