I find it easier to use two windows while doing my updates. One I call my
build window. I keep this one in the CVS_HOME\jk directory and I
only run two commands in this window:
First I run ant clean
Then I run ant docs
|
My second window I call my edit window and I keep that one in the
CVS_HOME\jk\xdocs directory where I'm doing my edits, diffs, and cvs
updates.
Before you start editing you should always update your local repository to
prevent conflicts.
You only need to update the xdocs directory C:\build\jakarta-tomcat-connectors\jk>cd xdocs
C:\build\jakarta-tomcat-connectors\jk\xdocs>
C:\build\jakarta-tomcat-connectors\jk\xdocs>cvs update -dP
|
Now that your repository is up to date you can begin editing. Find
something in the documentation to edit. When you find somethng remember the
name of the file. In your edit window find and edit the xml source file
with the same name. After you are done return to the build window, and
in the CVS_HOME\jk directory run:
C:\build\jakarta-tomcat-connectors\jk> ant clean
|
This will delete all the previous html files and make the area ready for
updated material. Now to make fresh documents that incorporate your changes
run:
C:\build\jakarta-tomcat-connectors\jk\>ant docs
|
Use your browser to view the edits you just made, they will be in the
CVS_HOME\jk\build\docs sub-tree. If it looks good and is ready to go,
all that is left to do is to create a patch and submit it.