You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@poi.apache.org by ni...@apache.org on 2007/05/29 19:18:45 UTC
svn commit: r542593 - in /jakarta/poi/trunk/src/documentation/content/xdocs:
book.xml getinvolved/book.xml getinvolved/branching.xml
getinvolved/index.xml index.xml mailinglists.xml mirrors.xml subversion.xml
Author: nick
Date: Tue May 29 10:18:45 2007
New Revision: 542593
URL: http://svn.apache.org/viewvc?view=rev&rev=542593
Log:
Further updates to the site
Added:
jakarta/poi/trunk/src/documentation/content/xdocs/mailinglists.xml (with props)
jakarta/poi/trunk/src/documentation/content/xdocs/subversion.xml (with props)
Modified:
jakarta/poi/trunk/src/documentation/content/xdocs/book.xml
jakarta/poi/trunk/src/documentation/content/xdocs/getinvolved/book.xml
jakarta/poi/trunk/src/documentation/content/xdocs/getinvolved/branching.xml
jakarta/poi/trunk/src/documentation/content/xdocs/getinvolved/index.xml
jakarta/poi/trunk/src/documentation/content/xdocs/index.xml
jakarta/poi/trunk/src/documentation/content/xdocs/mirrors.xml
Modified: jakarta/poi/trunk/src/documentation/content/xdocs/book.xml
URL: http://svn.apache.org/viewvc/jakarta/poi/trunk/src/documentation/content/xdocs/book.xml?view=diff&rev=542593&r1=542592&r2=542593
==============================================================================
--- jakarta/poi/trunk/src/documentation/content/xdocs/book.xml (original)
+++ jakarta/poi/trunk/src/documentation/content/xdocs/book.xml Tue May 29 10:18:45 2007
@@ -75,7 +75,7 @@
</menu>
<menu label="Code">
- <menu-item label="Subversion (current source code)" href="http://jakarta.apache.org/site/cvsindex.html"/>
+ <menu-item label="Subversion (current source code)" href="subversion.html"/>
<menu-item label="Top Voted Bugs" href="http://issues.apache.org/bugzilla/buglist.cgi?votes=1&product=POI&order=bugs.votes"/>
<menu-item label="Bug Database" href="http://issues.apache.org/bugzilla/buglist.cgi?product=POI"/>
<menu-item label="Patches" href="http://issues.apache.org/bugzilla/buglist.cgi?product=POI&short_desc=%5BPATCH%5D&short_desc_type=allwordssubstr"/>
Modified: jakarta/poi/trunk/src/documentation/content/xdocs/getinvolved/book.xml
URL: http://svn.apache.org/viewvc/jakarta/poi/trunk/src/documentation/content/xdocs/getinvolved/book.xml?view=diff&rev=542593&r1=542592&r2=542593
==============================================================================
--- jakarta/poi/trunk/src/documentation/content/xdocs/getinvolved/book.xml (original)
+++ jakarta/poi/trunk/src/documentation/content/xdocs/getinvolved/book.xml Tue May 29 10:18:45 2007
@@ -24,14 +24,15 @@
copyright="@year@ POI Project"
xmlns:xlink="http://www.w3.org/1999/xlink">
- <menu label="Jakarta POI">
+ <menu label="Apache POI">
<menu-item label="Top" href="../index.html"/>
</menu>
<menu label="Get Involved">
<menu-item label="Contributing" href="index.html"/>
<menu-item label="Branching" href="branching.html"/>
- <menu-item label="Mail Lists" href="http://jakarta.apache.org/site/mail2.html#poi"/>
+ <menu-item label="Subversion" href="../subversion.html"/>
+ <menu-item label="Mail Lists" href="../mailinglists.html"/>
</menu>
</book>
Modified: jakarta/poi/trunk/src/documentation/content/xdocs/getinvolved/branching.xml
URL: http://svn.apache.org/viewvc/jakarta/poi/trunk/src/documentation/content/xdocs/getinvolved/branching.xml?view=diff&rev=542593&r1=542592&r2=542593
==============================================================================
--- jakarta/poi/trunk/src/documentation/content/xdocs/getinvolved/branching.xml (original)
+++ jakarta/poi/trunk/src/documentation/content/xdocs/getinvolved/branching.xml Tue May 29 10:18:45 2007
@@ -24,7 +24,7 @@
<header>
<title>Branching</title>
<authors>
- <person id="GJS" name="Glen Stampoultzis" email="poi-user@jakarta.apache.org"/>
+ <person id="GJS" name="Glen Stampoultzis" email="user@poi.apache.org"/>
</authors>
</header>
Modified: jakarta/poi/trunk/src/documentation/content/xdocs/getinvolved/index.xml
URL: http://svn.apache.org/viewvc/jakarta/poi/trunk/src/documentation/content/xdocs/getinvolved/index.xml?view=diff&rev=542593&r1=542592&r2=542593
==============================================================================
--- jakarta/poi/trunk/src/documentation/content/xdocs/getinvolved/index.xml (original)
+++ jakarta/poi/trunk/src/documentation/content/xdocs/getinvolved/index.xml Tue May 29 10:18:45 2007
@@ -82,27 +82,27 @@
the project vision, etc.</li>
<li>Use POI a bit, look for gaps in the documentation and examples.</li>
<li>Join the mail lists and share your knowledge with others.</li>
- <li>Get <link href="http://jakarta.apache.org/site/cvsindex.html">Subversion</link> and check out the POI source tree</li>
+ <li>Get <link href="../subversion.html">Subversion</link> and check out the POI source tree</li>
<li>Documentation is always the best place to start contributing, maybe you found that if the documentation just told you how to do X then it would make more sense, modify the documentation.</li>
<li>Get used to building POI, you'll be doing it a lot, be one with the build, know its targets, etc.</li>
<li>Write Unit Tests. Great way to understand POI. Look for classes that aren't tested, or aren't tested on a public/protected method level, start there.</li>
<li>(HSSF)Get the Excel 97 Developer's Kit - its out of print but its dirt cheap (seen copies for under $15 (US)) used on <link href="http://www.amazon.com">amazon</link>. It explains the Excel file format.</li>
<li>Submit patches (see below) of your contributions, modifications.</li>
- <li>Fill out new features, see <link href="http://jakarta.apache.org/site/bugs.html">Bug database</link> for suggestions.</li>
+ <li>Fill out new features, see <link href="http://issues.apache.org/bugzilla/buglist.cgi?product=POI">Bug database</link> for suggestions.</li>
</ul>
</section>
<section><title>Submitting Patches</title>
<p>
Create patches by getting the latest sources from Subversion.
- Alter or add files as appropriate. Then, from the jakarta-poi directiory,
+ Alter or add files as appropriate. Then, from the poi directiory,
type svn diff > mypatch.patch. This will capture all of your changes
in a patch file of the appropriate format. Next, if you've added any
files, create an archive (tar.bz2 preferred as its the smallest) in a
- path-preserving archive format, relative to your jakarta-poi directory.
+ path-preserving archive format, relative to your poi directory.
You'll attach both files in the next step.
</p>
<p>
- Patches are submitted via the <link href="http://jakarta.apache.org/site/bugs.html">Bug Database</link>.
+ Patches are submitted via the <link href="http://issues.apache.org/bugzilla/buglist.cgi?product=POI">Bug Database</link>.
Create a new bug, set the subject to [PATCH] followed by a brief description. Explain you patch and any special instructions and submit/save it.
Next, go back to the bug, and create attachements for the patch files you
created. Be sure to describe not only the files purpose, but its format.
Modified: jakarta/poi/trunk/src/documentation/content/xdocs/index.xml
URL: http://svn.apache.org/viewvc/jakarta/poi/trunk/src/documentation/content/xdocs/index.xml?view=diff&rev=542593&r1=542592&r2=542593
==============================================================================
--- jakarta/poi/trunk/src/documentation/content/xdocs/index.xml (original)
+++ jakarta/poi/trunk/src/documentation/content/xdocs/index.xml Tue May 29 10:18:45 2007
@@ -35,9 +35,9 @@
<p>After quite a wait, version 3.0 of Apache POI (formerly
Apache Jakarta POI) has now been released. You can
<link href="./changes.html">view the changelog</link>, and
- <link href="http://www.apache.org/dyn/closer.cgi/jakarta/poi/release/">download</link>
+ <link href="http://www.apache.org/dyn/closer.cgi/poi/release/">download</link>
the source and binaries from your
- <link href="http://www.apache.org/dyn/closer.cgi/jakarta/poi/release/">local mirror</link>.</p>
+ <link href="http://www.apache.org/dyn/closer.cgi/poi/release/">local mirror</link>.</p>
</section>
<section><title>Purpose</title>
Added: jakarta/poi/trunk/src/documentation/content/xdocs/mailinglists.xml
URL: http://svn.apache.org/viewvc/jakarta/poi/trunk/src/documentation/content/xdocs/mailinglists.xml?view=auto&rev=542593
==============================================================================
--- jakarta/poi/trunk/src/documentation/content/xdocs/mailinglists.xml (added)
+++ jakarta/poi/trunk/src/documentation/content/xdocs/mailinglists.xml Tue May 29 10:18:45 2007
@@ -0,0 +1,97 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ ====================================================================
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ ====================================================================
+-->
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" "./dtd/document-v11.dtd">
+
+<document>
+ <header>
+ <title>Mailing Lists</title>
+ <authors>
+ <person id="NB" name="Nick Burch" email="nick@apache.org"/>
+ </authors>
+ </header>
+
+ <body>
+ <section><title>Mailing Lists - Guidelines</title>
+ <p>
+ <strong>Before subscribing to any of the mailing lists, please make
+ sure that you have read and understand the following
+ guidelines:</strong>
+ </p>
+ <ul>
+ <li><link href="http://www.apache.org/foundation/mailinglists.html">ASF guide to Mailing Lists</link></li>
+ <li><link href="http://www.apache.org/dev/contrib-email-tips.html">ASF Tips for email contributors</link></li>
+ <li><link href="http://jakarta.apache.org/site/mail.html">The Jakarta guide to Mailing Lists</link></li>
+ </ul>
+ </section>
+ <section><title>Lists</title>
+ <section><title>The POI User List</title>
+ <p>
+ <strong>Medium Traffic</strong>
+ <link href="mailto:user-subscribe@poi.apache.org">Subscribe</link>
+ <link href="mailto:user-unsubscribe@poi.apache.org">Unsubscribe</link>
+ <link href="http://mail-archives.apache.org/mod_mbox/poi-user/">Archive</link>
+ <link href="http://news.gmane.org/thread.php?group=gmane.comp.jakarta.poi.user">gmane.org</link>
+ </p>
+ <p>
+ This list is for users of POI to ask questions, share knowledge,
+ and discuss issues. POI developers are also expected to be
+ lurking on this list to offer support to users of POI.
+ </p>
+ </section>
+ <section><title>The POI Developer List</title>
+ <p>
+ <strong>Low Traffic</strong>
+ <link href="mailto:dev-subscribe@poi.apache.org">Subscribe</link>
+ <link href="mailto:dev-unsubscribe@poi.apache.org">Unsubscribe</link>
+ <link href="http://mail-archives.apache.org/mod_mbox/poi-dev/">Archive</link>
+ <link href="http://news.gmane.org/thread.php?group=gmane.comp.jakarta.poi.dev">gmane.org</link>
+ </p>
+ <p>
+ This is the list where participating developers of the POI
+ project meet and discuss issues, code changes/additions, etc.
+ Subscribers to this list also get notices of each and every
+ code change, build results, testing notices, etc.
+ <strong>Do not send mail to this list with usage questions or
+ configuration problems.</strong>
+ </p>
+ </section>
+ <section><title>The POI General List</title>
+ <p>
+ <strong>Low Traffic</strong>
+ <link href="mailto:general-subscribe@poi.apache.org">Subscribe</link>
+ <link href="mailto:general-unsubscribe@poi.apache.org">Unsubscribe</link>
+ <link href="http://mail-archives.apache.org/mod_mbox/poi-general/">Archive</link>
+ </p>
+ <p>
+ This list exists for general discussions on POI, not specific to
+ code or problems with code. Used for discussion of general matters
+ relating to all of the POI project, such as the website and
+ changes in procedures.
+ </p>
+ </section>
+ </section>
+ </body>
+ <footer>
+ <legal>
+ Copyright 2007 The Apache Software Foundation or its licensors, as applicable.
+ $Revision: 496536 $ $Date: 2007-01-15 23:11:09 +0000 (Mon, 15 Jan 2007) $
+ </legal>
+ </footer>
+</document>
Propchange: jakarta/poi/trunk/src/documentation/content/xdocs/mailinglists.xml
------------------------------------------------------------------------------
svn:eol-style = native
Modified: jakarta/poi/trunk/src/documentation/content/xdocs/mirrors.xml
URL: http://svn.apache.org/viewvc/jakarta/poi/trunk/src/documentation/content/xdocs/mirrors.xml?view=diff&rev=542593&r1=542592&r2=542593
==============================================================================
--- jakarta/poi/trunk/src/documentation/content/xdocs/mirrors.xml (original)
+++ jakarta/poi/trunk/src/documentation/content/xdocs/mirrors.xml Tue May 29 10:18:45 2007
@@ -21,7 +21,7 @@
<document>
<header>
- <title>Jakarta POI Mirror Site</title>
+ <title>Apache POI Mirror Site</title>
<authors>
<person id="AO" name="Andrew C. Oliver" email="acoliver@apache.org"/>
</authors>
@@ -31,7 +31,7 @@
<section><title>Mirrors</title>
<p>
These are mirrors of the
- <link href="http://jakarta.apache.org/poi">POI</link> website.
+ <link href="http://poi.apache.org/">POI</link> website.
If you know of others...report them! :-)
</p>
</section>
Added: jakarta/poi/trunk/src/documentation/content/xdocs/subversion.xml
URL: http://svn.apache.org/viewvc/jakarta/poi/trunk/src/documentation/content/xdocs/subversion.xml?view=auto&rev=542593
==============================================================================
--- jakarta/poi/trunk/src/documentation/content/xdocs/subversion.xml (added)
+++ jakarta/poi/trunk/src/documentation/content/xdocs/subversion.xml Tue May 29 10:18:45 2007
@@ -0,0 +1,86 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ ====================================================================
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ ====================================================================
+-->
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" "./dtd/document-v11.dtd">
+
+<document>
+ <header>
+ <title>Subversion - Source Code Repository</title>
+ <authors>
+ <person id="NB" name="Nick Burch" email="nick@apache.org"/>
+ </authors>
+ </header>
+
+ <body>
+ <section><title>Download the Source</title>
+ <p>
+ Most users of the source code probably don't need to have day to
+ day access to the source code as it changes. For these users we
+ provide easy to unpack source code downloads via our
+ <link href="ext:download">download pages.</link>
+ </p>
+ </section>
+ <section><title>Access the Version Controlled Source Code</title>
+ <p>
+ For information on connecting to the ASF Subversion repositories,
+ see the
+ <link href="http://www.apache.org/dev/version-control.html">version control page.</link>
+ </p>
+
+ <p>Subversion is an open-source version control system. The root url
+ of the ASF Subversion repository is
+ <link href="http://svn.apache.org/repos/asf/">http://svn.apache.org/repos/asf/</link>
+ for non-committers and
+ <link href="https://svn.apache.org/repos/asf/">https://svn.apache.org/repos/asf/</link>
+ for committers.
+ </p>
+
+ <p><strong>NOTE</strong>: When checking out a subproject using
+ subversion, ensure that you are checking out a tag, a branch or trunk
+ (the main-line) and not all tags and branches, to avoid filling up
+ your hard-disk and wasting bandwidth.
+ </p>
+
+ <p><strong>NOTE</strong>: See this
+ <link href="http://jakarta.apache.org/commons/svninfo.html">Subversion
+ information</link> page for a brief description of the relationship be
+ tween URL tuples such as <em>trunks-proper</em> and <em>proper</em>.</p>
+
+ <ul>
+ <li>For read only access to the Apache POI svn, please use
+ <link href="http://svn.apache.org/repos/asf/poi/trunk/">http://svn.apache.org/repos/asf/poi/trunk/</link></li>
+ <li>For committers (write) access to the Apache POI svn, please use
+ <link href="https://svn.apache.org/repos/asf/poi/trunk/">https://svn.apache.org/repos/asf/poi/trunk/</link></li>
+ <li>To browse the svn repository in your web browser, please us
+ <link href="http://svn.apache.org/viewcvs.cgi/poi/">ViewSVN</link></li>
+ </ul>
+
+ <p>If you are not a <em>Committer</em>, but you want to submit patches
+ or even request commit privileges, please see our
+ <link href="getinvolved/index.html">Guidelines</link> for more
+ information.</p>
+ </section>
+ </body>
+ <footer>
+ <legal>
+ Copyright 2007 The Apache Software Foundation or its licensors, as applicable.
+ $Revision: 496536 $ $Date: 2007-01-15 23:11:09 +0000 (Mon, 15 Jan 2007) $
+ </legal>
+ </footer>
+</document>
Propchange: jakarta/poi/trunk/src/documentation/content/xdocs/subversion.xml
------------------------------------------------------------------------------
svn:eol-style = native
---------------------------------------------------------------------
To unsubscribe, e-mail: poi-dev-unsubscribe@jakarta.apache.org
Mailing List: http://jakarta.apache.org/site/mail2.html#poi
The Apache Jakarta POI Project: http://jakarta.apache.org/poi/