incubator-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject cvs commit: incubator-site/src/documentation/content/xdocs updating_docs.xml
Date Thu, 07 Aug 2003 14:18:10 GMT
jefft       2003/08/07 07:18:10

  Added:       src/documentation/content/xdocs updating_docs.xml
  A short page to answer the question "how do I update the docs?"
  Revision  Changes    Path
  1.1                  incubator-site/src/documentation/content/xdocs/updating_docs.xml
  Index: updating_docs.xml
  <?xml version="1.0" encoding="UTF-8"?>
  <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" "document-v11.dtd">
      <title>Updating the documentation</title>
        <title>Updating the documentation</title>
        <p>The process for submitting new documentation or modifying an
          existing page is as follows</p>
          <title>Download Forrest</title>
          <p>Download <link href="">Apache
              Forrest</link>, or obtain it from CVS:</p>
            cvs login
            <em>press enter</em>
            cvs checkout xml-forrest
            cd xml-forrest
            export PATH=`pwd`/build/dist/shbat/bin:$PATH
          <title>Download incubator-site</title>
          <p>Download the <code>incubator-site</code> CVS module.
            Continuing from the previous example:</p>
            cd ..
            cvs checkout incubator-site
          <title>Make your changes</title>
          <p>Edit the XML docs in <code>incubator-site/src/documentation/content/xdocs/</code>.
 If you are not familiar
            with DTDs, the syntax is best learned <link
              example</link>. If you add a new page or change a page's name, update
<code>book.xml</code>, from which the
            menu is generated.  More details can be found <link href="">in
              Forrest's documentation</link>.</p>
          <title>Render the site</title>
          <p>In the <code>incubator-site/</code> directory, type 'forrest'
to render the HTML and PDF files in
            <code>build/site</code>.  Forrest validates the XML, so will catch
any syntax errors.</p>
          <title>Submit or commit the change</title>
          <p>If the site built without errors, you can now make a patch with the command
<code>cvs diff -u >
              incubator-site.diff</code> in the <code>incubator-site/</code>
directory, and submit it to the <link
              href="index.html#MailingLists">mailing list</link>, with '<code>[PATCH]</code>'
in the email subject.
            Incubator committers can just commit the contents of <code>build/site</code>
(after checking it is okay!).</p>

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message