Modified: poi/site/src/documentation/content/xdocs/components/spreadsheet/limitations.xml URL: http://svn.apache.org/viewvc/poi/site/src/documentation/content/xdocs/components/spreadsheet/limitations.xml?rev=1836243&r1=1836242&r2=1836243&view=diff ============================================================================== --- poi/site/src/documentation/content/xdocs/components/spreadsheet/limitations.xml (original) +++ poi/site/src/documentation/content/xdocs/components/spreadsheet/limitations.xml Wed Jul 18 23:24:53 2018 @@ -17,7 +17,7 @@ limitations under the License. ==================================================================== --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "../dtd/document-v13.dtd"> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "document-v20.dtd"> <document> <header> @@ -40,7 +40,7 @@ <ul> <li> There are some inherent limits in the Excel file formats. These are defined in class - <link href="https://poi.apache.org/apidocs/org/apache/poi/ss/SpreadsheetVersion.html";>SpreadsheetVersion</link>. + <a href="../../apidocs/org/apache/poi/ss/SpreadsheetVersion.html">SpreadsheetVersion</a>. As long as you have enough main-memory, you should be able to handle files up to these limits. For huge files using the default POI classes you will likely need a very large amount of memory. <br/> @@ -49,13 +49,13 @@ <br/> <ul> <li> - For writing very huge files, there is <link href="http://poi.apache.org/spreadsheet/index.html";>SXSSFWorkbook</link> + For writing very huge files, there is <a href="site:spreadsheet">SXSSFWorkbook</a> which allows to do a streaming write of data out to files (with certain limitations on what you can do as only parts of the file are held in memory). </li> <li> For reading very huge files, take a look at the sample - <link href="https://svn.apache.org/repos/asf/poi/trunk/src/examples/src/org/apache/poi/xssf/eventusermodel/XLSX2CSV.java";>XLSX2CSV</link> + <a href="https://svn.apache.org/repos/asf/poi/trunk/src/examples/src/org/apache/poi/xssf/eventusermodel/XLSX2CSV.java";>XLSX2CSV</a> which shows how you can read a file in streaming fashion (again with some limitations on what information you can read out of the file, but there are ways to get at most of it if necessary). </li> @@ -85,8 +85,8 @@ Macros can not be created. The are currently no plans to support macros. However, reading and re-writing files containing macros will safely preserve the macros. Recent versions of Apache POI support extracting the macro data - via <link href="https://poi.apache.org/apidocs/org/apache/poi/poifs/macros/VBAMacroExtractor.html";>VBAMacroExtractor</link> - and <link href="https://poi.apache.org/apidocs/org/apache/poi/poifs/macros/VBAMacroReader.html";>VBAMacroReader</link><br/><br/> + via <a href="../../apidocs/org/apache/poi/poifs/macros/VBAMacroExtractor.html">VBAMacroExtractor</a> + and <a href="../../apidocs/org/apache/poi/poifs/macros/VBAMacroReader.html">VBAMacroReader</a><br/><br/> </li> <li> Pivot Tables<br/><br/>
Modified: poi/site/src/documentation/content/xdocs/components/spreadsheet/quick-guide.xml URL: http://svn.apache.org/viewvc/poi/site/src/documentation/content/xdocs/components/spreadsheet/quick-guide.xml?rev=1836243&r1=1836242&r2=1836243&view=diff ============================================================================== --- poi/site/src/documentation/content/xdocs/components/spreadsheet/quick-guide.xml (original) +++ poi/site/src/documentation/content/xdocs/components/spreadsheet/quick-guide.xml Wed Jul 18 23:24:53 2018 @@ -17,7 +17,7 @@ limitations under the License. ==================================================================== --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "../dtd/document-v13.dtd"> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "document-v20.dtd"> <document> <header> @@ -28,57 +28,57 @@ <p> Want to use HSSF and XSSF read and write spreadsheets in a hurry? This guide is for you. If you're after more in-depth coverage of the HSSF and - XSSF user-APIs, please consult the <link href="how-to.html">HOWTO</link> + XSSF user-APIs, please consult the <a href="how-to.html">HOWTO</a> guide as it contains actual descriptions of how to use this stuff. </p> <section><title>Index of Features</title> <ul> - <li><link href="#NewWorkbook">How to create a new workbook</link></li> - <li><link href="#NewSheet">How to create a sheet</link></li> - <li><link href="#CreateCells">How to create cells</link></li> - <li><link href="#CreateDateCells">How to create date cells</link></li> - <li><link href="#CellTypes">Working with different types of cells</link></li> - <li><link href="#Iterator">Iterate over rows and cells</link></li> - <li><link href="#CellContents">Getting the cell contents</link></li> - <li><link href="#TextExtraction">Text Extraction</link></li> - <li><link href="#FileInputStream">Files vs InputStreams</link></li> - <li><link href="#Alignment">Aligning cells</link></li> - <li><link href="#Borders">Working with borders</link></li> - <li><link href="#FillsAndFrills">Fills and color</link></li> - <li><link href="#MergedCells">Merging cells</link></li> - <li><link href="#WorkingWithFonts">Working with fonts</link></li> - <li><link href="#CustomColors">Custom colors</link></li> - <li><link href="#ReadWriteWorkbook">Reading and writing</link></li> - <li><link href="#NewLinesInCells">Use newlines in cells.</link></li> - <li><link href="#DataFormats">Create user defined data formats</link></li> - <li><link href="#FitTo">Fit Sheet to One Page</link></li> - <li><link href="#PrintArea2">Set print area for a sheet</link></li> - <li><link href="#FooterPageNumbers">Set page numbers on the footer of a sheet</link></li> - <li><link href="#ShiftRows">Shift rows</link></li> - <li><link href="#SelectSheet">Set a sheet as selected</link></li> - <li><link href="#Zoom">Set the zoom magnification for a sheet</link></li> - <li><link href="#Splits">Create split and freeze panes</link></li> - <li><link href="#Repeating">Repeating rows and columns</link></li> - <li><link href="#HeaderFooter">Headers and Footers</link></li> - <li><link href="#XSSFHeaderFooter">XSSF enhancement for Headers and Footers</link></li> - <li><link href="#DrawingShapes">Drawing Shapes</link></li> - <li><link href="#StylingShapes">Styling Shapes</link></li> - <li><link href="#Graphics2d">Shapes and Graphics2d</link></li> - <li><link href="#Outlining">Outlining</link></li> - <li><link href="#Images">Images</link></li> - <li><link href="#NamedRanges">Named Ranges and Named Cells</link></li> - <li><link href="#CellComments">How to set cell comments</link></li> - <li><link href="#Autofit">How to adjust column width to fit the contents</link></li> - <li><link href="#Hyperlinks">Hyperlinks</link></li> - <li><link href="#Validation">Data Validations</link></li> - <li><link href="#Embedded">Embedded Objects</link></li> - <li><link href="#Autofilter">Autofilters</link></li> - <li><link href="#ConditionalFormatting">Conditional Formatting</link></li> - <li><link href="#Hiding">Hiding and Un-Hiding Rows</link></li> - <li><link href="#CellProperties">Setting Cell Properties</link></li> - <li><link href="#DrawingBorders">Drawing Borders</link></li> - <li><link href="#PivotTable">Create a Pivot Table</link></li> - <li><link href="#RichText">Cells with multiple styles</link></li> + <li><a href="#NewWorkbook">How to create a new workbook</a></li> + <li><a href="#NewSheet">How to create a sheet</a></li> + <li><a href="#CreateCells">How to create cells</a></li> + <li><a href="#CreateDateCells">How to create date cells</a></li> + <li><a href="#CellTypes">Working with different types of cells</a></li> + <li><a href="#Iterator">Iterate over rows and cells</a></li> + <li><a href="#CellContents">Getting the cell contents</a></li> + <li><a href="#TextExtraction">Text Extraction</a></li> + <li><a href="#FileInputStream">Files vs InputStreams</a></li> + <li><a href="#Alignment">Aligning cells</a></li> + <li><a href="#Borders">Working with borders</a></li> + <li><a href="#FillsAndFrills">Fills and color</a></li> + <li><a href="#MergedCells">Merging cells</a></li> + <li><a href="#WorkingWithFonts">Working with fonts</a></li> + <li><a href="#CustomColors">Custom colors</a></li> + <li><a href="#ReadWriteWorkbook">Reading and writing</a></li> + <li><a href="#NewLinesInCells">Use newlines in cells.</a></li> + <li><a href="#DataFormats">Create user defined data formats</a></li> + <li><a href="#FitTo">Fit Sheet to One Page</a></li> + <li><a href="#PrintArea2">Set print area for a sheet</a></li> + <li><a href="#FooterPageNumbers">Set page numbers on the footer of a sheet</a></li> + <li><a href="#ShiftRows">Shift rows</a></li> + <li><a href="#SelectSheet">Set a sheet as selected</a></li> + <li><a href="#Zoom">Set the zoom magnification for a sheet</a></li> + <li><a href="#Splits">Create split and freeze panes</a></li> + <li><a href="#Repeating">Repeating rows and columns</a></li> + <li><a href="#HeaderFooter">Headers and Footers</a></li> + <li><a href="#XSSFHeaderFooter">XSSF enhancement for Headers and Footers</a></li> + <li><a href="#DrawingShapes">Drawing Shapes</a></li> + <li><a href="#StylingShapes">Styling Shapes</a></li> + <li><a href="#Graphics2d">Shapes and Graphics2d</a></li> + <li><a href="#Outlining">Outlining</a></li> + <li><a href="#Images">Images</a></li> + <li><a href="#NamedRanges">Named Ranges and Named Cells</a></li> + <li><a href="#CellComments">How to set cell comments</a></li> + <li><a href="#Autofit">How to adjust column width to fit the contents</a></li> + <li><a href="#Hyperlinks">Hyperlinks</a></li> + <li><a href="#Validation">Data Validations</a></li> + <li><a href="#Embedded">Embedded Objects</a></li> + <li><a href="#Autofilter">Autofilters</a></li> + <li><a href="#ConditionalFormatting">Conditional Formatting</a></li> + <li><a href="#Hiding">Hiding and Un-Hiding Rows</a></li> + <li><a href="#CellProperties">Setting Cell Properties</a></li> + <li><a href="#DrawingBorders">Drawing Borders</a></li> + <li><a href="#PivotTable">Create a Pivot Table</a></li> + <li><a href="#RichText">Cells with multiple styles</a></li> </ul> </section> <section><title>Features</title> @@ -363,7 +363,7 @@ <p>In cases such as these, you should fetch the first and last column information for a row, then call <em>getCell(int, MissingCellPolicy)</em> to fetch the cell. Use a - <link href="../apidocs/org/apache/poi/ss/usermodel/Row.MissingCellPolicy.html">MissingCellPolicy</link> + <a href="../../apidocs/org/apache/poi/ss/usermodel/Row.MissingCellPolicy.html">MissingCellPolicy</a> to control how blank or null cells are handled.</p> <source> // Decide which rows to process @@ -1392,7 +1392,7 @@ Examples: Note: Using relative values like 'A1:B1' can lead to unexpected moving of the cell that the name points to when working with the workbook in Microsoft Excel, usually using absolute references like '$A$1:$B$1' avoids this, see also - <link href="https://superuser.com/a/1031047/126954";>this discussion</link>. + <a href="https://superuser.com/a/1031047/126954";>this discussion</a>. </p> <p> Creating Named Range / Named Cell @@ -2197,7 +2197,7 @@ the data to populate another drop down l sheetCF.addConditionalFormatting(regions, cfRules); </source> <p> See more examples on Excel conditional formatting in - <link href="http://svn.apache.org/repos/asf/poi/trunk/src/examples/src/org/apache/poi/ss/examples/ConditionalFormats.java";>ConditionalFormats.java</link> + <a href="http://svn.apache.org/repos/asf/poi/trunk/src/examples/src/org/apache/poi/ss/examples/ConditionalFormats.java";>ConditionalFormats.java</a> </p> </section> @@ -2401,7 +2401,7 @@ the data to populate another drop down l <p> To apply a single set of text formatting (colour, style, font etc) to a cell, you should create a - <link href="/apidocs/org/apache/poi/ss/usermodel/CellStyle.html">CellStyle</link> + <a href="/../apidocs/org/apache/poi/ss/usermodel/CellStyle.html">CellStyle</a> for the workbook, then apply to the cells. </p> <source> @@ -2438,16 +2438,16 @@ the data to populate another drop down l <p> To apply different formatting to different parts of a cell, you need to use - <link href="/apidocs/org/apache/poi/ss/usermodel/RichTextString.html">RichTextString</link>, + <a href="../../apidocs/org/apache/poi/ss/usermodel/RichTextString.html">RichTextString</a>, which permits styling of parts of the text within the cell. </p> <p> There are some slight differences between HSSF and XSSF, especially around font colours (the two formats store colours quite differently internally), refer to the - <link href="/apidocs/org/apache/poi/hssf/usermodel/HSSFRichTextString.html">HSSF Rich Text String</link> + <a href="../../apidocs/org/apache/poi/hssf/usermodel/HSSFRichTextString.html">HSSF Rich Text String</a> and - <link href="/apidocs/org/apache/poi/xssf/usermodel/XSSFRichTextString.html">XSSF Rich Text String</link> + <a href="../../apidocs/org/apache/poi/xssf/usermodel/XSSFRichTextString.html">XSSF Rich Text String</a> javadocs for more details. </p> </section> Modified: poi/site/src/documentation/content/xdocs/components/spreadsheet/record-generator.xml URL: http://svn.apache.org/viewvc/poi/site/src/documentation/content/xdocs/components/spreadsheet/record-generator.xml?rev=1836243&r1=1836242&r2=1836243&view=diff ============================================================================== --- poi/site/src/documentation/content/xdocs/components/spreadsheet/record-generator.xml (original) +++ poi/site/src/documentation/content/xdocs/components/spreadsheet/record-generator.xml Wed Jul 18 23:24:53 2018 @@ -17,7 +17,7 @@ limitations under the License. ==================================================================== --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "../dtd/document-v13.dtd"> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "document-v20.dtd"> <document> <header> Modified: poi/site/src/documentation/content/xdocs/components/spreadsheet/use-case.xml URL: http://svn.apache.org/viewvc/poi/site/src/documentation/content/xdocs/components/spreadsheet/use-case.xml?rev=1836243&r1=1836242&r2=1836243&view=diff ============================================================================== --- poi/site/src/documentation/content/xdocs/components/spreadsheet/use-case.xml (original) +++ poi/site/src/documentation/content/xdocs/components/spreadsheet/use-case.xml Wed Jul 18 23:24:53 2018 @@ -17,7 +17,7 @@ limitations under the License. ==================================================================== --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "../dtd/document-v13.dtd"> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "document-v20.dtd"> <document> <header> Modified: poi/site/src/documentation/content/xdocs/components/spreadsheet/user-defined-functions.xml URL: http://svn.apache.org/viewvc/poi/site/src/documentation/content/xdocs/components/spreadsheet/user-defined-functions.xml?rev=1836243&r1=1836242&r2=1836243&view=diff ============================================================================== --- poi/site/src/documentation/content/xdocs/components/spreadsheet/user-defined-functions.xml (original) +++ poi/site/src/documentation/content/xdocs/components/spreadsheet/user-defined-functions.xml Wed Jul 18 23:24:53 2018 @@ -17,7 +17,7 @@ limitations under the License. ==================================================================== --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "../dtd/document-v13.dtd"> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "document-v20.dtd"> <document> <header> @@ -40,13 +40,13 @@ payments for a mortgage. The user enters the principal loan amount, the interest rate and the term of the loan. The Excel spreadsheet does the rest.</p> <p> - <img src="../resources/images/simple-xls-with-function.jpg" alt="mortgage calculation spreadsheet"/> + <img src="images/simple-xls-with-function.jpg" alt="mortgage calculation spreadsheet"/> </p> <p>When you actually look at the workbook you discover that rather than having the formula in a cell it has been written as VBA function. You review the function and determine that it could be written in Java:</p> <p> - <img src="../resources/images/calculatePayment.jpg" alt="VBA code"/> + <img src="images/calculatePayment.jpg" alt="VBA code"/> </p> <p>If we write a small program to try to evaluate this cell, we'll fail. Consider this source code:</p> <source><![CDATA[ @@ -406,7 +406,7 @@ cell: Sheet1!B4 returns value: org.apache.poi.ss.usermodel.CellValue [790.7936267415464] ]]></source> <p>That is it! Now you can create Java code and register it, allowing your POI based appliction to run spreadsheets that previously were inaccessible.</p> - <p>This example can be found in the <link href="http://svn.apache.org/repos/asf/poi/trunk/src/examples/src/org/apache/poi/ss/examples/formula";>src/examples/src/org/apache/poi/ss/examples/formula</link> folder in the source.</p> + <p>This example can be found in the <a href="http://svn.apache.org/repos/asf/poi/trunk/src/examples/src/org/apache/poi/ss/examples/formula";>src/examples/src/org/apache/poi/ss/examples/formula</a> folder in the source.</p> </section> </section> </body> Copied: poi/site/src/documentation/content/xdocs/devel/guidelines.xml (from r1836242, poi/site/src/documentation/content/xdocs/guidelines.xml) URL: http://svn.apache.org/viewvc/poi/site/src/documentation/content/xdocs/devel/guidelines.xml?p2=poi/site/src/documentation/content/xdocs/devel/guidelines.xml&p1=poi/site/src/documentation/content/xdocs/guidelines.xml&r1=1836242&r2=1836243&rev=1836243&view=diff ============================================================================== --- poi/site/src/documentation/content/xdocs/guidelines.xml (original) +++ poi/site/src/documentation/content/xdocs/devel/guidelines.xml Wed Jul 18 23:24:53 2018 @@ -17,7 +17,7 @@ limitations under the License. ==================================================================== --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "./dtd/document-v13.dtd"> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "document-v20.dtd"> <document> <header> @@ -32,13 +32,13 @@ <section><title>Index of Contribution Guidelines</title> <ul> - <li><link href="#Introduction">Introduction</link></li> - <li><link href="#WhereHelpNeeded">Where is help needed on the project?</link></li> - <li><link href="#GetInvolved">I just want to get involved, but don't know where to start?</link></li> - <li><link href="#SubmittingPatches">Submitting Patches</link></li> - <li><link href="#CodeStyle">Code Style</link></li> - <li><link href="#Mentoring">Mentoring and Committership</link></li> - <li><link href="#FileFormatInformation">File Format Information</link></li> + <li><a href="#Introduction">Introduction</a></li> + <li><a href="#WhereHelpNeeded">Where is help needed on the project?</a></li> + <li><a href="#GetInvolved">I just want to get involved, but don't know where to start?</a></li> + <li><a href="#SubmittingPatches">Submitting Patches</a></li> + <li><a href="#CodeStyle">Code Style</a></li> + <li><a href="#Mentoring">Mentoring and Committership</a></li> + <li><a href="#FileFormatInformation">File Format Information</a></li> </ul> </section> @@ -55,10 +55,10 @@ <section><title>The Licensing</title> <p> - The POI project is <link href="http://www.opensource.org";>OpenSource</link> - and developed/distributed under the <link + The POI project is <a href="http://www.opensource.org";>OpenSource</a> + and developed/distributed under the <a href="https://www.apache.org/foundation/license-faq.html";> - Apache Software License v2</link>. Unlike some other licenses, the Apache + Apache Software License v2</a>. Unlike some other licenses, the Apache license allows free open source development. Unlike some other Open Source licenses, it does not require you to release your source or use any particular license for your code which builds on top of it. (There are a @@ -72,9 +72,9 @@ <anchor id="WhereHelpNeeded"/> <section><title>Where is help needed on the project?</title> - <helpwanted/> + <p id="helpwanted"/> <p>Please note - only some of the areas where help is needed have been listed - in the <link href="https://helpwanted.apache.org/";>Apache "Help Wanted!" tool</link>, + in the <a href="https://helpwanted.apache.org/";>Apache "Help Wanted!" tool</a>, many others remain only in Bugzilla or listed as TODOs in the code. Please see the section below for more on these.</p> </section> @@ -82,42 +82,42 @@ <anchor id="GetInvolved"/> <section><title>I just want to get involved, but don't know where to start?</title> <ul> - <li>View the <link href="#WhereHelpNeeded">Apache "Help Wanted" tasks</link> listed + <li>View the <a href="#WhereHelpNeeded">Apache "Help Wanted" tasks</a> listed above, in case any of those are ones you can help with.</li> <li>Read the rest of the website, understand what POI is and what it does, the project vision, etc.</li> <li>Use POI a bit, look for gaps in the documentation and examples.</li> - <li>Join the <link href="mailinglists.html">mailing lists</link> and share your knowledge with others.</li> - <li>Get <link href="subversion.html">Subversion</link> and check out the POI source tree</li> + <li>Join the <a href="site:mailinglists">mailing lists</a> and share your knowledge with others.</li> + <li>Get <a href="site:subversion">Subversion</a> 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>Contribute examples - if there's something people are often asking about on the <link href="mailinglists.html">user list</link> which isn't covered in the documentation or current examples, try writing an example of this and uploading it as a patch.</li> + <li>Contribute examples - if there's something people are often asking about on the <a href="site:mailinglists">user list</a> which isn't covered in the documentation or current examples, try writing an example of this and uploading it as a patch.</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>Download the file format documentation from Microsoft - - <link href="https://msdn.microsoft.com/en-us/library/cc313105%28v=office.12%29.aspx";>OLE2 Binary - File Formats</link> or - <link href="http://www.ecma-international.org/publications/standards/Ecma-376.htm";>OOXML XML File Formats</link></li> + <a href="https://msdn.microsoft.com/en-us/library/cc313105%28v=office.12%29.aspx";>OLE2 Binary + File Formats</a> or + <a href="http://www.ecma-international.org/publications/standards/Ecma-376.htm";>OOXML XML File Formats</a></li> <li>Submit patches (see below) of your contributions, modifications.</li> - <li>Check the <link href="https://issues.apache.org/bugzilla/buglist.cgi?product=POI";>bug database</link> for simple problem reports, and write a patch to fix the problem</li> - <li>Review existing patches in the <link href="http://issues.apache.org/bugzilla/buglist.cgi?product=POI";>bug database</link>, and report if they still apply, if they need unit tests atc.</li> - <li>Take a look at all the <link href="https://issues.apache.org/bugzilla/buglist.cgi?product=POI;bug_status=NEW;bug_status=NEEDINFO";>unresolved issues in the bug database</link>, and see if you can help with testing or patches for them</li> - <li>Add in new features, see <link href="https://issues.apache.org/bugzilla/buglist.cgi?product=POI";>Bug database</link> for suggestions.</li> + <li>Check the <a href="https://issues.apache.org/bugzilla/buglist.cgi?product=POI";>bug database</a> for simple problem reports, and write a patch to fix the problem</li> + <li>Review existing patches in the <a href="http://issues.apache.org/bugzilla/buglist.cgi?product=POI";>bug database</a>, and report if they still apply, if they need unit tests atc.</li> + <li>Take a look at all the <a href="https://issues.apache.org/bugzilla/buglist.cgi?product=POI;bug_status=NEW;bug_status=NEEDINFO";>unresolved issues in the bug database</a>, and see if you can help with testing or patches for them</li> + <li>Add in new features, see <a href="https://issues.apache.org/bugzilla/buglist.cgi?product=POI";>Bug database</a> for suggestions.</li> </ul> - <p>The Apache <link href="http://www.apache.org/dev/contributors.html";>Contributors Tech Guide</link> gives a good overview how to start contributing patches.</p> + <p>The Apache <a href="http://www.apache.org/dev/contributors.html";>Contributors Tech Guide</a> gives a good overview how to start contributing patches.</p> <p>The Nutch project also have a very useful guide on becoming a new developer in their project. While it is written for their project, a large part of it will apply to POI too. You can read it at - <link href="https://wiki.apache.org/nutch/Becoming_A_Nutch_Developer";>http://wiki.apache.org/nutch/Becoming_A_Nutch_Developer</link>. The - <link href="https://community.apache.org/";>Apache Community Development - Project</link> also provides guidance and mentoring for new contributors.</p> + <a href="https://wiki.apache.org/nutch/Becoming_A_Nutch_Developer";>http://wiki.apache.org/nutch/Becoming_A_Nutch_Developer</a>. The + <a href="https://community.apache.org/";>Apache Community Development + Project</a> also provides guidance and mentoring for new contributors.</p> </section> <anchor id="SubmittingPatches"/> <section><title>Submitting Patches</title> <p> - Patches are submitted via the <link href="https://issues.apache.org/bugzilla/buglist.cgi?product=POI";>Bug Database</link>. + Patches are submitted via the <a href="https://issues.apache.org/bugzilla/buglist.cgi?product=POI";>Bug Database</a>. 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 attachments for the patch files you @@ -141,7 +141,7 @@ A number of Apache projects provide far more comprehensive guides to producing and submitting patches than we do, you may wish to review some of their information if you're unsure. The - <link href="https://commons.apache.org/patches.html";>Apache Commons</link> one + <a href="https://commons.apache.org/patches.html";>Apache Commons</a> one is fairly similar as a starting point. </p> <p>You may create your patch file using either of the following approaches (the committers recommend the first):</p> @@ -201,7 +201,7 @@ <section><title>Approach 3 - the git way</title> <p> If you are working on a Git clone of Apache POI (see the - <link href="subversion.html">Version Control page</link> for + <a href="site:subversion">Version Control page</a> for more on the read-only Git mirrors), it is possible to generate a patch of your changes (including new binary files) using Git. </p> @@ -229,13 +229,13 @@ </section> <section><title>checklist before submitting a patch</title> <ul> - <li>Added code complies with <link href="#CodeStyle">coding standards</link>.</li> + <li>Added code complies with <a href="#CodeStyle">coding standards</a>.</li> <li>Added code compiles and runs on Java 1.6.</li> - <li>New java files begin with the <link href="https://www.apache.org/foundation/license-faq.html";> - Apache Software License</link> statement.</li> + <li>New java files begin with the <a href="https://www.apache.org/foundation/license-faq.html";> + Apache Software License</a> statement.</li> <li>The code does not depend on code that is unlicensed or - <link href="https://www.apache.org/legal/resolved.html#category-a";>incompatibly licensed with ASL 2.0</link>. - <link href="https://www.apache.org/licenses/GPL-compatibility.html";>GPL</link> and LGPL code may not be used.</li> + <a href="https://www.apache.org/legal/resolved.html#category-a";>incompatibly licensed with ASL 2.0</a>. + <a href="https://www.apache.org/licenses/GPL-compatibility.html";>GPL</a> and LGPL code may not be used.</li> <li>The code does not include <code>@author</code> tags.</li> <li>Existing test cases succeed.</li> <li>New test cases written and succeed (Use <code>@Ignore</code> from <code>org.junit</code> for in-progress work).</li> @@ -243,7 +243,7 @@ <li>Examples updated or added as appropriate.</li> <li>Diff files generated using <code>svn diff</code>.</li> <li>Newly added files are included in the patch or alongside the patch.</li> - <li>The <link href="https://bz.apache.org/bugzilla/describecomponents.cgi?product=POI";>bugzilla</link> subject dev contains [PATCH], task name and patch reason in subject.</li> + <li>The <a href="https://bz.apache.org/bugzilla/describecomponents.cgi?product=POI";>bugzilla</a> subject dev contains [PATCH], task name and patch reason in subject.</li> <li>The bugzilla description contains a rationale for the patch.</li> <li>Attachment to the bugzilla entry contains the patch file.</li> </ul> @@ -253,8 +253,8 @@ <anchor id="CodeStyle"/> <section><title>Code Style</title> <p>The long standing - <link href="resolutions/res001.html">Minimal - Coding Standards</link> from 2002 still largely apply to the project.</p> + <a href="site:res001">Minimal + Coding Standards</a> from 2002 still largely apply to the project.</p> <p>When making changes to an existing file, please try to follow the same style that that file already uses. This will keep things looking similar, and will prevent patches becoming largely about @@ -284,7 +284,7 @@ bit of work before it can be committed by an existing committer, with any luck your later patches will be applied with no / minor tweaks. Please do take note of any changes required by your earlier patches, to learn for later ones! If - in doubt, ask on the <link href="mailinglists.html">dev mailing list</link>.</p> + in doubt, ask on the <a href="site:mailinglists">dev mailing list</a>.</p> <p>The requirement for patches over several months is to ensure that committers remain with the project. It's very easy for a good developer to fire off half a dozen good patches in the couple of weeks that they're working on a POI @@ -300,12 +300,12 @@ contributors. However, everyone involved in POI is a volunteer, and it may happen that your first few patches come in at a time when all the committers are very busy. Do please have patience, and remember to use the - <link href="mailinglists.html">dev mailing list</link> so that other + <a href="site:mailinglists">dev mailing list</a> so that other contributors can assist you!</p> <p>For more information on getting started at Apache, mentoring, and local Apache Committers near you who can offer advice, please see the - <link href="http://community.apache.org/";>Apache Community Development - Project</link> website.</p> + <a href="http://community.apache.org/";>Apache Community Development + Project</a> website.</p> </section> <anchor id="FileFormatInformation"/> @@ -314,27 +314,27 @@ <p> In early 2008, Microsoft made a fairly complete set of documentation on the binary file formats freely and publicly available. These were - released under the <link href="https://msdn.microsoft.com/en-us/openspecifications/default";> - Open Specification Promise</link>, which does allow us to use them for - building open source software under the <link + released under the <a href="https://msdn.microsoft.com/en-us/openspecifications/default";> + Open Specification Promise</a>, which does allow us to use them for + building open source software under the <a href="https://www.apache.org/foundation/license-FAQ.html";> - Apache Software License</link>. + Apache Software License</a>. </p> <p> You can download the documentation on Excel, Word, PowerPoint and Escher (drawing) from - <link href="https://msdn.microsoft.com/en-us/library/cc313118.aspx";>http://msdn.microsoft.com/en-us/library/cc313118.aspx</link>. + <a href="https://msdn.microsoft.com/en-us/library/cc313118.aspx";>http://msdn.microsoft.com/en-us/library/cc313118.aspx</a>. Documentation on a few of the supporting technologies used in these file formats can be downloaded from - <link href="https://msdn.microsoft.com/en-us/library/jj633110.aspx";>http://msdn.microsoft.com/en-us/library/jj633110.aspx</link>. + <a href="https://msdn.microsoft.com/en-us/library/jj633110.aspx";>http://msdn.microsoft.com/en-us/library/jj633110.aspx</a>. </p> <p> For the VSDX format (implemented in Apache POI as XDGF), an - <link href="https://msdn.microsoft.com/en-us/library/office/jj228622.aspx";>introduction - is available from Microsoft</link>, and full details are available - <link href="https://msdn.microsoft.com/en-us/library/office/jj684209(v=office.15).aspx">here</link> + <a href="https://msdn.microsoft.com/en-us/library/office/jj228622.aspx";>introduction + is available from Microsoft</a>, and full details are available + <a href="https://msdn.microsoft.com/en-us/library/office/jj684209(v=office.15).aspx">here</a> and - <link href="https://msdn.microsoft.com/en-us/library/hh645006(v=office.12).aspx">here</link>. + <a href="https://msdn.microsoft.com/en-us/library/hh645006(v=office.12).aspx">here</a>. </p> <p> Previously, Microsoft published a book on the Excel 97 file format. @@ -347,14 +347,14 @@ of the ECMA / ISO standardisation effort for the formats. This documentation is quite large, but you can normally find the bit you need without too much effort! This can be downloaded from - <link href="http://www.ecma-international.org/publications/standards/Ecma-376.htm";>http://www.ecma-international.org/publications/standards/Ecma-376.htm</link>, + <a href="http://www.ecma-international.org/publications/standards/Ecma-376.htm";>http://www.ecma-international.org/publications/standards/Ecma-376.htm</a>, and is also under the - <link href="https://msdn.microsoft.com/en-us/openspecifications/default";>OSP</link>. + <a href="https://msdn.microsoft.com/en-us/openspecifications/default";>OSP</a>. </p> <p> Additionally for the newer Office Open XML (ooxml) file formats, you can find some good introductary documentation (often clearer for getting - started with) at <link href="http://officeopenxml.com/";>officeopenxml.com</link>, + started with) at <a href="http://officeopenxml.com/";>officeopenxml.com</a>, which is an independent site documenting the file formats. </p> <p> Copied: poi/site/src/documentation/content/xdocs/devel/historyandfuture.xml (from r1836242, poi/site/src/documentation/content/xdocs/historyandfuture.xml) URL: http://svn.apache.org/viewvc/poi/site/src/documentation/content/xdocs/devel/historyandfuture.xml?p2=poi/site/src/documentation/content/xdocs/devel/historyandfuture.xml&p1=poi/site/src/documentation/content/xdocs/historyandfuture.xml&r1=1836242&r2=1836243&rev=1836243&view=diff ============================================================================== --- poi/site/src/documentation/content/xdocs/historyandfuture.xml (original) +++ poi/site/src/documentation/content/xdocs/devel/historyandfuture.xml Wed Jul 18 23:24:53 2018 @@ -17,7 +17,7 @@ limitations under the License. ==================================================================== --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "./dtd/document-v13.dtd"> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "document-v20.dtd"> <document> <header> @@ -83,8 +83,8 @@ already started making waves. </p> <p>Somewhere in there we decided to finally submit the project - to <link href="https://cocoon.apache.org/";>The Apache - Cocoon Project</link>, only to discover the project had + to <a href="https://cocoon.apache.org/";>The Apache + Cocoon Project</a>, only to discover the project had outgrown fitting nicely into just Cocoon long ago. Furthermore, Andrew started eyeing other projects he'd like to see POI functionality added to. So it was decided to donate @@ -95,7 +95,7 @@ already started making waves. </p> <p>In Early 2007, we graduated from - <link href="https://jakarta.apache.org/";>Jakarta</link>, and became + <a href="https://jakarta.apache.org/";>Jakarta</a>, and became our own Top Level Project (TLP) within Apache.</p> </section> Copied: poi/site/src/documentation/content/xdocs/devel/index.xml (from r1836242, poi/site/src/documentation/content/xdocs/howtobuild.xml) URL: http://svn.apache.org/viewvc/poi/site/src/documentation/content/xdocs/devel/index.xml?p2=poi/site/src/documentation/content/xdocs/devel/index.xml&p1=poi/site/src/documentation/content/xdocs/howtobuild.xml&r1=1836242&r2=1836243&rev=1836243&view=diff ============================================================================== --- poi/site/src/documentation/content/xdocs/howtobuild.xml (original) +++ poi/site/src/documentation/content/xdocs/devel/index.xml Wed Jul 18 23:24:53 2018 @@ -17,7 +17,7 @@ limitations under the License. ==================================================================== --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "./dtd/document-v13.dtd"> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "document-v20.dtd"> <document> <header> @@ -45,7 +45,7 @@ <section> <title>Install Apache Ant</title> <p> - The POI build system requires <link href="https://ant.apache.org/";>Apache Ant</link> + The POI build system requires <a href="https://ant.apache.org/";>Apache Ant</a> version 1.8 - 1.9.x for Java 1.6 and higher. Newer versions (1.10.x) require Java 8 or higher. </p> <p> @@ -61,13 +61,13 @@ <title>Install Apache Forrest</title> <p> The POI build system requires - <link href="https://forrest.apache.org/";>Apache Forrest</link> + <a href="https://forrest.apache.org/";>Apache Forrest</a> to build the documentation. </p> <p> Specifically the build has been tested to work with Forrest 0.5.x. This is an <strong>old release</strong> which is available - <link href="https://archive.apache.org/dist/forrest/pre-0.6/";>here</link>. + <a href="https://archive.apache.org/dist/forrest/pre-0.6/";>here</a>. </p> <p> Remember to set the FORREST_HOME environment variable. @@ -160,17 +160,17 @@ Ant build.</p> <p>However, including Apache POI within your own Maven project is fully supported, and widely used. Please see the - <link href="overview.html#components">Components Page</link> + <a href="site:components">Components Page</a> for details of the Maven artifacts available.</p> </section> <section> <title>Setting environment variables</title> <p>Linux: - <link href="https://help.ubuntu.com/community/EnvironmentVariables";>help.ubuntu.com</link>, - <link href="http://unix.stackexchange.com/questions/117467/how-to-permanently-set-environmental-variables";>unix.stackexchange.com</link> + <a href="https://help.ubuntu.com/community/EnvironmentVariables";>help.ubuntu.com</a>, + <a href="http://unix.stackexchange.com/questions/117467/how-to-permanently-set-environmental-variables";>unix.stackexchange.com</a> </p> <p>Windows: - <link href="https://en.wikipedia.org/wiki/Environment_variable#DOS.2C_OS.2F2_and_Windows";>en.wikipedia.org</link> + <a href="https://en.wikipedia.org/wiki/Environment_variable#DOS.2C_OS.2F2_and_Windows";>en.wikipedia.org</a> </p> </section> </body> Modified: poi/site/src/documentation/content/xdocs/devel/plan/index.xml URL: http://svn.apache.org/viewvc/poi/site/src/documentation/content/xdocs/devel/plan/index.xml?rev=1836243&r1=1836242&r2=1836243&view=diff ============================================================================== --- poi/site/src/documentation/content/xdocs/devel/plan/index.xml (original) +++ poi/site/src/documentation/content/xdocs/devel/plan/index.xml Wed Jul 18 23:24:53 2018 @@ -17,7 +17,7 @@ limitations under the License. ==================================================================== --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "../dtd/document-v13.dtd"> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "document-v20.dtd"> <document> <header> @@ -50,7 +50,7 @@ <p>Anyone can participate in this process. Please get involved in discussion on <code>dev</code> and contribute patches for these summary planning - documents via the normal <link href="../guidelines.html">contribution</link> + documents via the normal <a href="site:guidelines">contribution</a> process. </p> @@ -63,12 +63,10 @@ <section><title>Topics and Issues</title> <ul> - <li><link href="POI20Vision.html">POI Version 2.0 Vision</link> + <li><a href="site:vision20">POI Version 2.0 Vision</a> </li> - <li><link href="POI10Vision.html">POI Version 1.0 Vision</link> + <li><a href="site:vision10">POI Version 1.0 Vision</a> </li> - <li>See the general <link href="../todo.html">To Do</link> list - and the <code>dev</code> email archives for other issues</li> </ul> </section> Copied: poi/site/src/documentation/content/xdocs/devel/plan/vision10.xml (from r1836242, poi/site/src/documentation/content/xdocs/plan/POI10Vision.xml) URL: http://svn.apache.org/viewvc/poi/site/src/documentation/content/xdocs/devel/plan/vision10.xml?p2=poi/site/src/documentation/content/xdocs/devel/plan/vision10.xml&p1=poi/site/src/documentation/content/xdocs/plan/POI10Vision.xml&r1=1836242&r2=1836243&rev=1836243&view=diff ============================================================================== --- poi/site/src/documentation/content/xdocs/plan/POI10Vision.xml (original) +++ poi/site/src/documentation/content/xdocs/devel/plan/vision10.xml Wed Jul 18 23:24:53 2018 @@ -17,7 +17,7 @@ limitations under the License. ==================================================================== --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "../dtd/document-v13.dtd"> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "document-v20.dtd"> <document> <header> Copied: poi/site/src/documentation/content/xdocs/devel/plan/vision20.xml (from r1836242, poi/site/src/documentation/content/xdocs/plan/POI20Vision.xml) URL: http://svn.apache.org/viewvc/poi/site/src/documentation/content/xdocs/devel/plan/vision20.xml?p2=poi/site/src/documentation/content/xdocs/devel/plan/vision20.xml&p1=poi/site/src/documentation/content/xdocs/plan/POI20Vision.xml&r1=1836242&r2=1836243&rev=1836243&view=diff ============================================================================== --- poi/site/src/documentation/content/xdocs/plan/POI20Vision.xml (original) +++ poi/site/src/documentation/content/xdocs/devel/plan/vision20.xml Wed Jul 18 23:24:53 2018 @@ -17,7 +17,7 @@ limitations under the License. ==================================================================== --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "../dtd/document-v13.dtd"> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "document-v20.dtd"> <document> <header> @@ -44,7 +44,7 @@ </p> <p> This document was created before the POI components for - <link href="http://xml.apache.org/cocoon";>Apache Cocoon</link> + <a href="http://xml.apache.org/cocoon";>Apache Cocoon</a> were accepted into the Cocoon project itself. It was also written before POI was accepted into Jakarta. So while the vision hasn't changed some of the components are actually now @@ -238,8 +238,8 @@ <p> The produced code shall be licensed by the Apache License as used by the Cocoon 2 project (APL 1.1) and - maintained on at <link href="http://poi.sourceforge.net/";>http://poi.sourceforge.net</link> - and <link href="http://sourceforge.net/projects/poi";>http://sourcefoge.net/projects/poi</link>. + maintained on at <a href="http://poi.sourceforge.net/";>http://poi.sourceforge.net</a> + and <a href="http://sourceforge.net/projects/poi";>http://sourcefoge.net/projects/poi</a>. It is our hope to at some point integrate with the various Apache projects (xml.apache.org and jakarta.apache.org), at which point we'd turn the copyright over to them. Added: poi/site/src/documentation/content/xdocs/devel/references/3rdparty.xml URL: http://svn.apache.org/viewvc/poi/site/src/documentation/content/xdocs/devel/references/3rdparty.xml?rev=1836243&view=auto ============================================================================== --- poi/site/src/documentation/content/xdocs/devel/references/3rdparty.xml (added) +++ poi/site/src/documentation/content/xdocs/devel/references/3rdparty.xml Wed Jul 18 23:24:53 2018 @@ -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 V2.0//EN" "document-v20.dtd"> + +<document> + <header> + <title>Third Party Contributions</title> + <authors> + <person name="Nicola Ken Barozzi" email="[email protected]"/> + </authors> + </header> + + <body> + + <section><title>How to Contribute</title> + <p> + See <a href="contrib.xml">How to contribute to Poi</a>. + </p> + + </section> + + <section><title>Contributed Components</title> + <p> + These are not necessarily deemed to be high enough quality to be included in the + core distribution, but they have been tested under <a href="contrib.xml"> + several key environments</a>, they are provided under the same license + as Poi, and they are included in the POI distribution under the + <code>contrib/</code> directory. + </p> + + <p> + <strong>None as yet!</strong> - although you can expect that some of the links + listed below will eventually migrate to the "contributed components" level, and + then maybe even into the main distribution. + </p> + </section> + + <section><title>Patch Queue</title> + <p><a href="patches.html">Submissions of modifications</a> + to POI which are awaiting review. Anyone can + comment on them on the dev mailing list - code reviewers are needed! + <strong>Use these at your own risk</strong> - although POI has no guarantee + either, these patches have not been reviewed, let alone accepted. + </p> + </section> + + <section><title>Other Extensions</title> + <p>The other extensions listed here are <strong>not endorsed</strong> by the POI + project either - they are provided as a convenience only. They may or may not work, + they may or may not be open source, etc. + </p> + + <p>To have a link added to this table, see <a href="contrib.xml">How to contribute + to POI</a>.</p> + + <table> + <tr> + <th>Name and Link</th> + <th>Type</th> + <th>Description</th> + <th>Status</th> + <th>Licensing</th> + <th>Contact</th> + </tr> + </table> + + </section> +</body> +</document> Modified: poi/site/src/documentation/content/xdocs/devel/references/index.xml URL: http://svn.apache.org/viewvc/poi/site/src/documentation/content/xdocs/devel/references/index.xml?rev=1836243&r1=1836242&r2=1836243&view=diff ============================================================================== --- poi/site/src/documentation/content/xdocs/devel/references/index.xml (original) +++ poi/site/src/documentation/content/xdocs/devel/references/index.xml Wed Jul 18 23:24:53 2018 @@ -17,7 +17,7 @@ limitations under the License. ==================================================================== --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "../dtd/document-v13.dtd"> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "document-v20.dtd"> <document> <header> @@ -41,7 +41,7 @@ that utilises POI let us know.</p> <!-- <ul> - <li><link href=""></link></li> + <li><a href=""></a></li> </ul> --> </section> @@ -49,7 +49,7 @@ <section><title>Products/Projects using POI</title> <p>Publicly available products/projects using POI include:</p> <ul> - <li><link href="http://jtimetracker.sourceforge.net/";>JTimeTracker</link></li> + <li><a href="http://jtimetracker.sourceforge.net/";>JTimeTracker</a></li> </ul> </section> @@ -57,7 +57,7 @@ <p>POI depends on publicly available documents describing various file formats. The list below contains links to some of them.</p> <ul> - <li><link href="http://www.wotsit.org/";>Wotsit's Format</link></li> + <li><a href="http://www.wotsit.org/";>Wotsit's Format</a></li> </ul> </section> Copied: poi/site/src/documentation/content/xdocs/devel/references/logocontest.xml (from r1836242, poi/site/src/documentation/content/xdocs/news/logocontest.xml) URL: http://svn.apache.org/viewvc/poi/site/src/documentation/content/xdocs/devel/references/logocontest.xml?p2=poi/site/src/documentation/content/xdocs/devel/references/logocontest.xml&p1=poi/site/src/documentation/content/xdocs/news/logocontest.xml&r1=1836242&r2=1836243&rev=1836243&view=diff ============================================================================== --- poi/site/src/documentation/content/xdocs/news/logocontest.xml (original) +++ poi/site/src/documentation/content/xdocs/devel/references/logocontest.xml Wed Jul 18 23:24:53 2018 @@ -17,7 +17,7 @@ limitations under the License. ==================================================================== --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "../dtd/document-v13.dtd"> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "document-v20.dtd"> <document> <header> Modified: poi/site/src/documentation/content/xdocs/devel/resolutions/index.xml URL: http://svn.apache.org/viewvc/poi/site/src/documentation/content/xdocs/devel/resolutions/index.xml?rev=1836243&r1=1836242&r2=1836243&view=diff ============================================================================== --- poi/site/src/documentation/content/xdocs/devel/resolutions/index.xml (original) +++ poi/site/src/documentation/content/xdocs/devel/resolutions/index.xml Wed Jul 18 23:24:53 2018 @@ -17,7 +17,7 @@ limitations under the License. ==================================================================== --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "../dtd/document-v13.dtd"> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "document-v20.dtd"> <document> <header> Modified: poi/site/src/documentation/content/xdocs/devel/resolutions/res001.xml URL: http://svn.apache.org/viewvc/poi/site/src/documentation/content/xdocs/devel/resolutions/res001.xml?rev=1836243&r1=1836242&r2=1836243&view=diff ============================================================================== --- poi/site/src/documentation/content/xdocs/devel/resolutions/res001.xml (original) +++ poi/site/src/documentation/content/xdocs/devel/resolutions/res001.xml Wed Jul 18 23:24:53 2018 @@ -17,7 +17,7 @@ limitations under the License. ==================================================================== --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "../dtd/document-v13.dtd"> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "document-v20.dtd"> <document> <header> Copied: poi/site/src/documentation/content/xdocs/devel/subversion.xml (from r1836242, poi/site/src/documentation/content/xdocs/subversion.xml) URL: http://svn.apache.org/viewvc/poi/site/src/documentation/content/xdocs/devel/subversion.xml?p2=poi/site/src/documentation/content/xdocs/devel/subversion.xml&p1=poi/site/src/documentation/content/xdocs/subversion.xml&r1=1836242&r2=1836243&rev=1836243&view=diff ============================================================================== --- poi/site/src/documentation/content/xdocs/subversion.xml (original) +++ poi/site/src/documentation/content/xdocs/devel/subversion.xml Wed Jul 18 23:24:53 2018 @@ -17,7 +17,7 @@ limitations under the License. ==================================================================== --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "./dtd/document-v13.dtd"> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "document-v20.dtd"> <document> <header> @@ -32,15 +32,15 @@ <p> Most users of the source code probably don't need to have day to day access to the source code as it changes. Therefore most users will want - to make use of our <link href="download.html">source release</link> + to make use of our <a href="site:download">source release</a> packages, which contain the complete source tree for each binary release, suitable for browsing or debugging. These source releases are available from our - <link href="download.html">download page.</link> + <a href="site:download">download page.</a> </p> <p> The Apache POI source code is also available as source artifacts - in the <link href="https://search.maven.org/#search%7Cga%7C1%7Cg%3A%22org.apache.poi%22";>Maven Central repository</link>, + in the <a href="https://search.maven.org/#search%7Cga%7C1%7Cg%3A%22org.apache.poi%22";>Maven Central repository</a>, which may be helpful for those users who make use of POI via Maven and wish to inspect the source (eg when debugging in an IDE). </p> @@ -49,10 +49,10 @@ <p> For general information on connecting to the ASF Subversion, repositories, see the - <link href="https://www.apache.org/dev/version-control.html";>version control page.</link> + <a href="https://www.apache.org/dev/version-control.html";>version control page.</a> </p> - <p>Apache POI uses <link href="https://subversion.apache.org";>Subversion</link> as its version control system, + <p>Apache POI uses <a href="https://subversion.apache.org";>Subversion</a> as its version control system, but also has a read-only git mirror </p> @@ -64,14 +64,14 @@ <ul> <li>For read only access to the latest Apache POI code, please use - <link href="https://svn.apache.org/repos/asf/poi/trunk/";>https://svn.apache.org/repos/asf/poi/trunk/</link></li> + <a href="https://svn.apache.org/repos/asf/poi/trunk/";>https://svn.apache.org/repos/asf/poi/trunk/</a></li> <li>To browse the svn repository in your web browser, please use - <link href="https://svn.apache.org/viewvc/poi/";>ViewVC</link></li> + <a href="https://svn.apache.org/viewvc/poi/";>ViewVC</a></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="guidelines.html">Contribution Guidelines</link> for more + <a href="site:guidelines">Contribution Guidelines</a> for more information.</p> </section> <section><title>Git access to POI sources</title> @@ -84,22 +84,22 @@ </p> <p> The official read-only Git repository for Apache POI is available - from <link href="https://git.apache.org/";>git.apache.org/</link> . - The Git Clone URL is: <link href="git://git.apache.org/poi.git">git://git.apache.org/poi.git</link> - and Https Clone URL: <link href="https://git.apache.org/poi.git";>https://git.apache.org/poi.git</link> . - Please see the <link href="https://git.apache.org/";>Git at - Apache</link> page for more details on the service. + from <a href="https://git.apache.org/";>git.apache.org/</a> . + The Git Clone URL is: <a href="git://git.apache.org/poi.git">git://git.apache.org/poi.git</a> + and Https Clone URL: <a href="https://git.apache.org/poi.git";>https://git.apache.org/poi.git</a> . + Please see the <a href="https://git.apache.org/";>Git at + Apache</a> page for more details on the service. </p> <p> - In addition to the <link href="https://git.apache.org/";>git.apache.org</link> + In addition to the <a href="https://git.apache.org/";>git.apache.org</a> repository, changes are also mirrored in near-realtime to GitHub. The GitHub repository is available at - <link href="https://github.com/apache/poi";>https://github.com/apache/poi</link> . + <a href="https://github.com/apache/poi";>https://github.com/apache/poi</a> . Please note that the GitHub repository is read-only, but pull requests sent to it will result in an email being sent to the mailing list. A Git-formatted patch added to Bugzilla is generally preferred though, as it can be tracked along with all the other contributions. Please see the - <link href="guidelines.html">contribution guidelines</link> for more + <a href="site:guidelines">contribution guidelines</a> for more information on getting involved in the project.</p> </section> <section><title>Using Git via the SVN-Git bridge</title> @@ -110,8 +110,8 @@ will keep information from the SVN revisions so that the Git repository can be updated with newer revisions from Subversion as well as allowing to push commits from Git "upstream" into the Subversion repository. See the - <link href="https://www.kernel.org/pub/software/scm/git/docs/git-svn.html";> - official documentation</link> for more details. + <a href="https://www.kernel.org/pub/software/scm/git/docs/git-svn.html";> + official documentation</a> for more details. </p> </section> <section><title>Set up the repository</title> @@ -122,12 +122,12 @@ </p> <source> - git svn clone https://svn.apache.org/repos/asf/poi/trunk poisvngit --revision <link href="https://svn.apache.org/viewvc?view=revision&revision=1732982";>1732982</link>:HEAD + git svn clone https://svn.apache.org/repos/asf/poi/trunk poisvngit --revision <a href="https://svn.apache.org/viewvc?view=revision&revision=1732982";>1732982</a>:HEAD </source> <p> Running without <code>--revision from:HEAD</code> will run for a long time and will retrieve the full version history of the Subversion repository. If you need more repository history, change the <code>from</code> revision to an - <link href="https://svn.apache.org/viewvc/poi/tags/";>earlier release</link> or omit the <code>--revision</code> + <a href="https://svn.apache.org/viewvc/poi/tags/";>earlier release</a> or omit the <code>--revision</code> specifier altogether. </p> <p> @@ -230,7 +230,7 @@ <section><title>Code metrics </title> <p> Code quality reports for Apache POI are available on the - <link href="https://analysis.apache.org/dashboard/index/221489";>Apache Sonar instance</link>. + <a href="https://analysis.apache.org/dashboard/index/221489";>Apache Sonar instance</a>. </p> <p> Sonar provides lots of useful numbers and statistics, especially Copied: poi/site/src/documentation/content/xdocs/devel/who.xml (from r1836242, poi/site/src/documentation/content/xdocs/who.xml) URL: http://svn.apache.org/viewvc/poi/site/src/documentation/content/xdocs/devel/who.xml?p2=poi/site/src/documentation/content/xdocs/devel/who.xml&p1=poi/site/src/documentation/content/xdocs/who.xml&r1=1836242&r2=1836243&rev=1836243&view=diff ============================================================================== --- poi/site/src/documentation/content/xdocs/who.xml (original) +++ poi/site/src/documentation/content/xdocs/devel/who.xml Wed Jul 18 23:24:53 2018 @@ -17,7 +17,7 @@ limitations under the License. ==================================================================== --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "./dtd/document-v13.dtd"> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "document-v20.dtd"> <document> <header> @@ -34,14 +34,14 @@ The Apache POI Project operates on a meritocracy: the more you do, the more responsibility you will obtain. This page lists all of the people who have gone the extra mile and are Committers. If you would like to get involved, - the first step is to join the <link href="mailinglists.html">mailing lists</link>. + the first step is to join the <a href="site:mailinglists">mailing lists</a>. </p> <p> We ask that you please do not send us emails privately asking for support. We are non-paid volunteers who help out with the project and we do not necessarily have the time or energy to help people on an individual basis. - The <link href="mailinglists.html">mailing lists</link> have many individuals + The <a href="site:mailinglists">mailing lists</a> have many individuals who will help answer detailed requests for help. The benefit of using mailing lists over private communication is that they are a shared resource where others can also learn from common questions. @@ -53,7 +53,7 @@ <!-- <section><title>Advisors</title>--> <!-- <ul>--> -<!-- <li><link href="http://www.betaversion.org/~stefano/";>Stefano Mazzocchi</link> (stefano at apache dot org)--> +<!-- <li><a href="http://www.betaversion.org/~stefano/";>Stefano Mazzocchi</a> (stefano at apache dot org)--> <!-- </li>--> <!-- </ul>--> <!-- </section>--> @@ -67,35 +67,31 @@ <ul> <!-- Alphabetical by surname --> <li>Tim Allison (tallison at apache dot org)</li> - <li><link href="https://people.apache.org/list_B.html#kiwiwings";>Andreas Beeker</link> (kiwiwings at apache dot org)</li> + <li><a href="https://people.apache.org/list_B.html#kiwiwings";>Andreas Beeker</a> (kiwiwings at apache dot org)</li> <li>Nick Burch (nick at apache dot org)</li> <li>Amol S Deshmukh (amol at apache dot org)</li> <li>David Fisher (wave at apache dot org)</li> <li>Jason Height (jheight at apache dot org)</li> <li>Marc Johnson (mjohnson at apache dot org)</li> - <li><link href="http://www.rainer-klute.de/";>Rainer Klute</link> (klute at apache dot org)</li> + <li><a href="http://www.rainer-klute.de/";>Rainer Klute</a> (klute at apache dot org)</li> <li>Yegor Kozlov (yegor at apache dot org)</li> <li>Shawn Laubach (slaubach at apache dot org)</li> <li>Josh Micich (josh at apache dot org)</li> <li>Mark Murphy (jmarkmurphy at apache dot org)</li> <li>Danny Mui (dmui at apache dot org)</li> - <li><link href="https://people.apache.org/~dnorth/";>David North</link> (dnorth at apache dot org)</li> + <li><a href="https://people.apache.org/~dnorth/";>David North</a> (dnorth at apache dot org)</li> <li>Javen O'Neal (onealj at apache dot org)</li> <li>Uwe Schindler (uschindler at apache dot org)</li> <li>Avik Sengupta (avik at apache dot org)</li> <li>Dominik Stadler (centic at apache dot org)</li> - <li><link href="http://members.iinet.net.au/~gstamp/glen/";>Glen Stampoultzis</link> (glens at apache.org)</li> + <li><a href="http://members.iinet.net.au/~gstamp/glen/";>Glen Stampoultzis</a> (glens at apache.org)</li> <li>Jon Svede (jsvede at apache dot org)</li> <li>Maxim Valyanskiy (maxcom at apache dot org)</li> <li>Sergey Vladimirov (sergey at apache dot org)</li> <li>Greg Woolsey (gwoolsey at apache dot org)</li> </ul> </section> - <section><title>Translators</title> - <ul> - <li>(Please add your name here!!)</li> - </ul> - </section> + <section><title>Emeritus Committers</title> <ul> <li>Andrew C. Oliver (acoliver at gmail dot com)</li> @@ -129,7 +125,7 @@ So the best way to help a bug report see progress is to provide more information if available or supply patches together with unit-tests. - If you can, look at <link href="guidelines.html">Contribution Guidelines</link> + If you can, look at <a href="site:guidelines">Contribution Guidelines</a> for more information about providing patches. </p> </section> --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
