You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@apr.apache.org by wr...@apache.org on 2006/04/14 00:59:12 UTC
svn commit: r393966 - in /apr/site/trunk/docs: download.html index.html
patches.html
Author: wrowe
Date: Thu Apr 13 15:59:12 2006
New Revision: 393966
URL: http://svn.apache.org/viewcvs?rev=393966&view=rev
Log:
Regenerate website
Modified:
apr/site/trunk/docs/download.html
apr/site/trunk/docs/index.html
apr/site/trunk/docs/patches.html
Modified: apr/site/trunk/docs/download.html
URL: http://svn.apache.org/viewcvs/apr/site/trunk/docs/download.html?rev=393966&r1=393965&r2=393966&view=diff
==============================================================================
--- apr/site/trunk/docs/download.html (original)
+++ apr/site/trunk/docs/download.html Thu Apr 13 15:59:12 2006
@@ -97,7 +97,7 @@
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#828DA6">
<font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="apr1"><strong>APR 1.2.6 is the best available version</strong></a>
+ <a name="apr1"><strong>APR 1.2.7 is the best available version</strong></a>
</font>
</td></tr>
<tr><td>
@@ -106,19 +106,19 @@
<ul>
<li>Unix Source:
-<a href="[preferred]/apr/apr-1.2.6.tar.gz">apr-1.2.6.tar.gz</a>
-[<a href="http://www.apache.org/dist/apr/apr-1.2.6.tar.gz.asc">PGP</a>]
-[<a href="http://www.apache.org/dist/apr/apr-1.2.6.tar.gz.md5">MD5</a>]</li>
+<a href="[preferred]/apr/apr-1.2.7.tar.gz">apr-1.2.7.tar.gz</a>
+[<a href="http://www.apache.org/dist/apr/apr-1.2.7.tar.gz.asc">PGP</a>]
+[<a href="http://www.apache.org/dist/apr/apr-1.2.7.tar.gz.md5">MD5</a>]</li>
<li>Unix Source:
-<a href="[preferred]/apr/apr-1.2.6.tar.bz2">apr-1.2.6.tar.bz2</a>
-[<a href="http://www.apache.org/dist/apr/apr-1.2.6.tar.bz2.asc">PGP</a>]
-[<a href="http://www.apache.org/dist/apr/apr-1.2.6.tar.bz2.md5">MD5</a>]</li>
+<a href="[preferred]/apr/apr-1.2.7.tar.bz2">apr-1.2.7.tar.bz2</a>
+[<a href="http://www.apache.org/dist/apr/apr-1.2.7.tar.bz2.asc">PGP</a>]
+[<a href="http://www.apache.org/dist/apr/apr-1.2.7.tar.bz2.md5">MD5</a>]</li>
<li>Win32 Source:
-<a href="[preferred]/apr/apr-1.2.6.zip">apr-1.2.6.zip</a>
-[<a href="http://www.apache.org/dist/apr/apr-1.2.6.zip.asc">PGP</a>]
-[<a href="http://www.apache.org/dist/apr/apr-1.2.6.zip.md5">MD5</a>]</li>
+<a href="[preferred]/apr/apr-1.2.7-win32-src.zip">apr-1.2.7-win32-src.zip</a>
+[<a href="http://www.apache.org/dist/apr/apr-1.2.7.zip.asc">PGP</a>]
+[<a href="http://www.apache.org/dist/apr/apr-1.2.7.zip.md5">MD5</a>]</li>
<li><a href="[preferred]/apr/">Other files</a></li>
@@ -129,7 +129,7 @@
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#828DA6">
<font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="aprutil1"><strong>APR-util 1.2.6 is the best available version</strong></a>
+ <a name="aprutil1"><strong>APR-util 1.2.7 is the best available version</strong></a>
</font>
</td></tr>
<tr><td>
@@ -138,19 +138,19 @@
<ul>
<li>Unix Source:
-<a href="[preferred]/apr/apr-util-1.2.6.tar.gz">apr-util-1.2.6.tar.gz</a>
-[<a href="http://www.apache.org/dist/apr/apr-util-1.2.6.tar.gz.asc">PGP</a>]
-[<a href="http://www.apache.org/dist/apr/apr-util-1.2.6.tar.gz.md5">MD5</a>]</li>
+<a href="[preferred]/apr/apr-util-1.2.7.tar.gz">apr-util-1.2.7.tar.gz</a>
+[<a href="http://www.apache.org/dist/apr/apr-util-1.2.7.tar.gz.asc">PGP</a>]
+[<a href="http://www.apache.org/dist/apr/apr-util-1.2.7.tar.gz.md5">MD5</a>]</li>
<li>Unix Source:
-<a href="[preferred]/apr/apr-util-1.2.6.tar.bz2">apr-util-1.2.6.tar.bz2</a>
-[<a href="http://www.apache.org/dist/apr/apr-util-1.2.6.tar.bz2.asc">PGP</a>]
-[<a href="http://www.apache.org/dist/apr/apr-util-1.2.6.tar.bz2.md5">MD5</a>]</li>
+<a href="[preferred]/apr/apr-util-1.2.7.tar.bz2">apr-util-1.2.7.tar.bz2</a>
+[<a href="http://www.apache.org/dist/apr/apr-util-1.2.7.tar.bz2.asc">PGP</a>]
+[<a href="http://www.apache.org/dist/apr/apr-util-1.2.7.tar.bz2.md5">MD5</a>]</li>
<li>Windows Source:
-<a href="[preferred]/apr/apr-util-1.2.6.zip">apr-util-1.2.6.zip</a>
-[<a href="http://www.apache.org/dist/apr/apr-util-1.2.6.zip.asc">PGP</a>]
-[<a href="http://www.apache.org/dist/apr/apr-util-1.2.6.zip.md5">MD5</a>]</li>
+<a href="[preferred]/apr/apr-util-1.2.7-win32-src.zip">apr-util-1.2.7-win32-src.zip</a>
+[<a href="http://www.apache.org/dist/apr/apr-util-1.2.7-win32-src.zip.asc">PGP</a>]
+[<a href="http://www.apache.org/dist/apr/apr-util-1.2.7-win32-src.zip.md5">MD5</a>]</li>
<li><a href="[preferred]/apr/">Other files</a></li>
@@ -180,9 +180,9 @@
[<a href="http://www.apache.org/dist/apr/apr-iconv-1.1.1.tar.bz2.md5">MD5</a>]</li>
<li>Windows Source:
-<a href="[preferred]/apr/apr-iconv-1.1.1.zip">apr-iconv-1.1.1.zip</a>
-[<a href="http://www.apache.org/dist/apr/apr-iconv-1.1.1.zip.asc">PGP</a>]
-[<a href="http://www.apache.org/dist/apr/apr-iconv-1.1.1.zip.md5">MD5</a>]</li>
+<a href="[preferred]/apr/apr-iconv-1.1.1-win32-src.zip">apr-iconv-1.1.1-win32-src.zip</a>
+[<a href="http://www.apache.org/dist/apr/apr-iconv-1.1.1-win32-src.zip.asc">PGP</a>]
+[<a href="http://www.apache.org/dist/apr/apr-iconv-1.1.1-win32-src.zip.md5">MD5</a>]</li>
<li><a href="[preferred]/apr/">Other files</a></li>
@@ -193,7 +193,7 @@
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#828DA6">
<font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="apr0"><strong>APR 0.9.7 is also available</strong></a>
+ <a name="apr0"><strong>APR 0.9.12 is also available</strong></a>
</font>
</td></tr>
<tr><td>
@@ -202,19 +202,19 @@
<ul>
<li>Unix Source:
-<a href="[preferred]/apr/apr-0.9.7.tar.gz">apr-0.9.7.tar.gz</a>
-[<a href="http://www.apache.org/dist/apr/apr-0.9.7.tar.gz.asc">PGP</a>]
-[<a href="http://www.apache.org/dist/apr/apr-0.9.7.tar.gz.md5">MD5</a>]</li>
+<a href="[preferred]/apr/apr-0.9.12.tar.gz">apr-0.9.12.tar.gz</a>
+[<a href="http://www.apache.org/dist/apr/apr-0.9.12.tar.gz.asc">PGP</a>]
+[<a href="http://www.apache.org/dist/apr/apr-0.9.12.tar.gz.md5">MD5</a>]</li>
<li>Unix Source:
-<a href="[preferred]/apr/apr-0.9.7.tar.bz2">apr-0.9.7.tar.bz2</a>
-[<a href="http://www.apache.org/dist/apr/apr-0.9.7.tar.bz2.asc">PGP</a>]
-[<a href="http://www.apache.org/dist/apr/apr-0.9.7.tar.bz2.md5">MD5</a>]</li>
+<a href="[preferred]/apr/apr-0.9.12.tar.bz2">apr-0.9.12.tar.bz2</a>
+[<a href="http://www.apache.org/dist/apr/apr-0.9.12.tar.bz2.asc">PGP</a>]
+[<a href="http://www.apache.org/dist/apr/apr-0.9.12.tar.bz2.md5">MD5</a>]</li>
<li>Windows Source:
-<a href="[preferred]/apr/apr-0.9.7.zip">apr-0.9.7.zip</a>
-[<a href="http://www.apache.org/dist/apr/apr-0.9.7.zip.asc">PGP</a>]
-[<a href="http://www.apache.org/dist/apr/apr-0.9.7.zip.md5">MD5</a>]</li>
+<a href="[preferred]/apr/apr-0.9.12-win32-src.zip">apr-0.9.12-win32-src.zip</a>
+[<a href="http://www.apache.org/dist/apr/apr-0.9.12-win32-src.zip.asc">PGP</a>]
+[<a href="http://www.apache.org/dist/apr/apr-0.9.12-win32-src.zip.md5">MD5</a>]</li>
</ul>
</blockquote>
@@ -223,7 +223,7 @@
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#828DA6">
<font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="aprutil1"><strong>APR-util 0.9.7 is also available</strong></a>
+ <a name="aprutil1"><strong>APR-util 0.9.12 is also available</strong></a>
</font>
</td></tr>
<tr><td>
@@ -232,19 +232,19 @@
<ul>
<li>Unix Source:
-<a href="[preferred]/apr/apr-util-0.9.7.tar.gz">apr-0.9.7.tar.gz</a>
-[<a href="http://www.apache.org/dist/apr/apr-util-0.9.7.tar.gz.asc">PGP</a>]
-[<a href="http://www.apache.org/dist/apr/apr-util-0.9.7.tar.gz.md5">MD5</a>]</li>
+<a href="[preferred]/apr/apr-util-0.9.12.tar.gz">apr-0.9.12.tar.gz</a>
+[<a href="http://www.apache.org/dist/apr/apr-util-0.9.12.tar.gz.asc">PGP</a>]
+[<a href="http://www.apache.org/dist/apr/apr-util-0.9.12.tar.gz.md5">MD5</a>]</li>
<li>Unix Source:
-<a href="[preferred]/apr/apr-util-0.9.7.tar.bz2">apr-util-0.9.7.tar.bz2</a>
-[<a href="http://www.apache.org/dist/apr/apr-util-0.9.7.tar.bz2.asc">PGP</a>]
-[<a href="http://www.apache.org/dist/apr/apr-util-0.9.7.tar.bz2.md5">MD5</a>]</li>
+<a href="[preferred]/apr/apr-util-0.9.12.tar.bz2">apr-util-0.9.12.tar.bz2</a>
+[<a href="http://www.apache.org/dist/apr/apr-util-0.9.12.tar.bz2.asc">PGP</a>]
+[<a href="http://www.apache.org/dist/apr/apr-util-0.9.12.tar.bz2.md5">MD5</a>]</li>
<li>Windows Source:
-<a href="[preferred]/apr/apr-util-0.9.7.zip">apr-util-0.9.7.zip</a>
-[<a href="http://www.apache.org/dist/apr/apr-util-0.9.7.zip.asc">PGP</a>]
-[<a href="http://www.apache.org/dist/apr/apr-util-0.9.7.zip.md5">MD5</a>]</li>
+<a href="[preferred]/apr/apr-util-0.9.12-win32-src.zip">apr-util-0.9.12-win32-src.zip</a>
+[<a href="http://www.apache.org/dist/apr/apr-util-0.9.12-win32-src.zip.asc">PGP</a>]
+[<a href="http://www.apache.org/dist/apr/apr-util-0.9.12-win32-src.zip.md5">MD5</a>]</li>
</ul>
</blockquote>
@@ -272,9 +272,9 @@
[<a href="http://www.apache.org/dist/apr/apr-iconv-0.9.7.tar.bz2.md5">MD5</a>]</li>
<li>Windows Source:
-<a href="[preferred]/apr/apr-iconv-0.9.7.zip">apr-iconv-0.9.7.zip</a>
-[<a href="http://www.apache.org/dist/apr/apr-iconv-0.9.7.zip.asc">PGP</a>]
-[<a href="http://www.apache.org/dist/apr/apr-iconv-0.9.7.zip.md5">MD5</a>]</li>
+<a href="[preferred]/apr/apr-iconv-0.9.7-win32-src.zip">apr-iconv-0.9.7-win32-src.zip</a>
+[<a href="http://www.apache.org/dist/apr/apr-iconv-0.9.7-win32-src.zip.asc">PGP</a>]
+[<a href="http://www.apache.org/dist/apr/apr-iconv-0.9.7-win32-src.zip.md5">MD5</a>]</li>
</ul>
</blockquote>
@@ -312,22 +312,6 @@
% gpg --import KEYS<br />
% gpg --verify apr-1.0.1.tar.gz.asc
</code></p>
-<ul>
-<li>apr-1.2.6.tar.gz is signed by Garrett Rooney
- <code>9BCFCE2F</code></li>
-<li>apr-util-1.2.6.tar.gz is signed by Garrett Rooney
- <code>9BCFCE2F</code></li>
-<li>apr-iconv-1.1.1.tar.gz is signed by William A. Rowe, Jr.
- <code>10FDE075</code></li>
-</ul>
-<ul>
-<li>apr-0.9.7.tar.gz is signed by William A. Rowe, Jr.
- <code>10FDE075</code></li>
-<li>apr-util-0.9.7.tar.gz is signed by William A. Rowe, Jr.
- <code>10FDE075</code></li>
-<li>apr-iconv-0.9.7.tar.gz is signed by William A. Rowe, Jr.
- <code>10FDE075</code></li>
-</ul>
<p>Alternatively, you can verify the MD5 signature on the files. A
unix program called <code>md5</code> or <code>md5sum</code> is
included in many unix distributions. It is also available as part of
Modified: apr/site/trunk/docs/index.html
URL: http://svn.apache.org/viewcvs/apr/site/trunk/docs/index.html?rev=393966&r1=393965&r2=393966&view=diff
==============================================================================
--- apr/site/trunk/docs/index.html (original)
+++ apr/site/trunk/docs/index.html Thu Apr 13 15:59:12 2006
@@ -67,13 +67,13 @@
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="1.2.6"><strong>Apache Portable Runtime 1.2.6 Released</strong></a>
+ <a name="1.2.7"><strong>Apache Portable Runtime 1.2.7 Released</strong></a>
</font>
</td></tr>
<tr><td>
<blockquote>
<p>The Apache Portable Runtime Project is proud to announce the
-release of APR version 1.2.6. For details of this release, see the
+release of APR version 1.2.7. For details of this release, see the
<a href="http://www.apache.org/dist/apr/Announcement1.2.html">official announcement</a> as well as the
<a href="http://www.apache.org/dist/apr/CHANGES-APR-1.2">CHANGES-APR-1.2</a>,
<a href="http://www.apache.org/dist/apr/CHANGES-APR-UTIL-1.2">CHANGES-APR-UTIL-1.2</a>, and
@@ -88,13 +88,13 @@
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="0.9.7"><strong>Apache Portable Runtime 0.9.7 Released</strong></a>
+ <a name="0.9.12"><strong>Apache Portable Runtime 0.9.12 Released</strong></a>
</font>
</td></tr>
<tr><td>
<blockquote>
<p>The Apache Portable Runtime Project is proud to announce the
-release of APR version 0.9.7. For details, of this legacy release see the
+release of APR version 0.9.12. For details, of this legacy release see the
<a href="http://www.apache.org/dist/apr/Announcement-0.9.html">official announcement</a>, as well as the
<a href="http://www.apache.org/dist/apr/CHANGES-APR-0.9">CHANGES-APR-0.9</a>,
<a href="http://www.apache.org/dist/apr/CHANGES-APR-UTIL-0.9">CHANGES-APR-UTIL-0.9</a>, and
Modified: apr/site/trunk/docs/patches.html
URL: http://svn.apache.org/viewcvs/apr/site/trunk/docs/patches.html?rev=393966&r1=393965&r2=393966&view=diff
==============================================================================
--- apr/site/trunk/docs/patches.html (original)
+++ apr/site/trunk/docs/patches.html Thu Apr 13 15:59:12 2006
@@ -57,8 +57,10 @@
who use it in their own projects. We want to make it as easy as possible for
people to contribute code. However, we do have some expectations of code that
is contributed. This is to help us review code as quickly as possible. If
-code is contributed that doesn't follow these guidelines, it will still be
-reviewed, but it will most likely take longer.</p>
+code is contributed that doesn't follow these guidelines, it might still be
+reviewed, but it will take longer and attract the attention of fewer
+developers. When you contribute, please remember that anyone evaluating your
+suggestion is a voulenteer contributor, just like yourself.</p>
</blockquote>
</td></tr>
</table>
@@ -86,8 +88,10 @@
partly due to APR's httpd lineage) is that the input values do not need to be
checked for correctness. It is the responsibility of the calling program that
uses APR to ensure that the input parameters are what APR expects. If the
-input parameters are invalid (NULL, for example), APR functions will likely
-produce a segfault when it attempts to reference these variables.</p>
+input parameters are invalid (NULL, for example), APR functions are expected
+to produce a segfault when it attempts to reference these variables. This
+increases the stability of consumer code, by forcing developers to fix code
+which might otherwise silently ignores fatal error conditions.</p>
</blockquote>
</td></tr>
</table>
@@ -99,16 +103,29 @@
</td></tr>
<tr><td>
<blockquote>
-<p>We prefer that patches be submitted in unified diff format:</p>
+<p>We request that patches be submitted in unified diff format:</p>
<blockquote><code>diff -u file-old.c file.c</code></blockquote>
-<p>but that isn't available on all platforms. If your platform doesn't
-support unified diffs, please use a context diff instead:</p>
+<p>or if working with an svn checkout:</p>
+<blockquote><code>svn diff file.c</code></blockquote>
+<p>where <code>file.c</code> is the file affected. (Older versions of diff
+may require -u3 to display lines of context, but the current version of GNU
+diff has deprecated the trailing number for -u and presumes three lines,
+use -U# syntax if you wish to provide more lines of context.)</p>
+<p>You can obtain the most sophisticated diff utility from the GNU diffutils
+project:</p>
+<blockquote><code><a href="http://www.gnu.org/software/diffutils/diffutils.html">http://www.gnu.org/software/diffutils/diffutils.html</a></code></blockquote>
+<p>and Windows users can obtain a native port of diff and other useful utilites
+from:</p>
+<blockquote><code><a href="http://unxutils.sourceforge.net/">http://unxutils.sourceforge.net/</a></code></blockquote>
+<p>If you <b>cannot</b> produce a unified diff, then at least please submit
+a context diff:</p>
<blockquote><code>diff -C3 file-old.c file.c</code></blockquote>
-<p>where <code>file.c</code> is the file affected. We should be able to feed
-the patch directly into the "patch" program and have it update the file or set
-of files. The <code>-C3</code> is very important - line numbers can change on
-a daily basis in some code files, so having context is crucial to knowing where
-it all really goes.</p>
+<p>We should be able to feed the patch directly into the "patch" program and
+have it update the file or set of files. The <code>-u</code> or
+<code>-C3</code> is critical; the existing code changes regularly, so having
+context is crucial to understanding your patch and knowing where it all really
+goes. Patches without filenames, line numbers and surrounding context become
+impossible to consider as time goes on.</p>
</blockquote>
</td></tr>
</table>
@@ -120,7 +137,19 @@
</td></tr>
<tr><td>
<blockquote>
-<p><b>If</b> you are a subscriber to dev@apr.apache.org, you can simply post
+<p>The best place to submit your patch is an attachment to a bug report:</p>
+<blockquote><code><a href="http://issues.apache.org/bugzilla/">http://issues.apache.org/bugzilla/</a></code></blockquote>
+<p>Be certain to research your patch, to ensure that it isn't already in an
+existing bug report, and that similiar code hasn't already been committed to
+the working development trunk:</p>
+<blockquote><code><a href="http://svn.apache.org/repos/asf/apr/apr/trunk/">http://svn.apache.org/repos/asf/apr/apr/trunk</a></code></blockquote>
+<blockquote><code><a href="http://svn.apache.org/repos/asf/apr/apr-util/trunk/">http://svn.apache.org/repos/asf/apr/apr-util/trunk</a></code></blockquote>
+<blockquote><code><a href="http://svn.apache.org/repos/asf/apr/apr-iconv/trunk/">http://svn.apache.org/repos/asf/apr/apr-iconv/trunk</a></code></blockquote>
+<p>Ensure your patch is attached as a text/ type file, and try retrieving it
+yourself after you add it, to ensure that others can, too. Do not submit links
+to other locations for your patch (or anyone else's patch!), as they will only
+be considered when submitted directly to the ASF by the original author.</p>
+<p><b>If</b> you are a subscriber to dev@apr.apache.org, you can also post
your patch there, with the string "[PATCH]" prefixing your subject line, so
everyone knows it's a patch. However, it's not guaranteed that your Patch will
find an advocate within the developers' group; if we're too busy working on