You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@apr.apache.org by je...@apache.org on 2003/09/26 07:12:19 UTC
cvs commit: apr-site/xdocs/stylesheets project.xml
jerenkrantz 2003/09/25 22:12:19
Modified: docs guidelines.html index.html mailing-lists.html
patches.html projects.html versioning.html
xdocs/stylesheets project.xml
Added: xdocs mailing-lists.xml patches.xml projects.xml
Removed: xdocs mailing-lists.html patches.html projects.html
Log:
Further work on converting website to XHTML and Anakia templates.
Revision Changes Path
1.3 +16 -13 apr-site/docs/guidelines.html
Index: guidelines.html
===================================================================
RCS file: /home/cvs/apr-site/docs/guidelines.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -u -r1.2 -r1.3
--- guidelines.html 26 Sep 2003 04:47:27 -0000 1.2
+++ guidelines.html 26 Sep 2003 05:12:19 -0000 1.3
@@ -12,32 +12,35 @@
<tr>
<!-- LEFT SIDE NAVIGATION -->
<td valign="top" nowrap="nowrap">
- <p><b>Essentials</b></p>
+ <p><b>Get Involved</b></p>
<menu compact="compact">
- <li><a href="http://www.apache.org/LICENSE.txt">License</a></li>
- </menu>
- <p><b>Subprojects</b></p>
- <menu compact="compact">
- <li>APR</li>
- <li>APR-util</li>
- <li>APR-iconv</li>
+ <li><a href="anoncvs.txt">CVS</a></li>
+ <li><a href="mailing-lists.html">Mailing Lists</a></li>
+ <li><a href="http://cvs.apache.org/snapshots/apr/">Snapshots</a></li>
+ <li><a href="compiling_win32.html">Build on Win32</a></li>
+ <li><a href="compiling_unix.html">Build on Unix</a></li>
</menu>
<p><b>Download!</b></p>
<menu compact="compact">
<li><a href="http://www.apache.org/dyn/closer.cgi/apr/">from a mirror</a></li>
</menu>
- <p><b>Get Involved</b></p>
+ <p><b>Docs</b></p>
<menu compact="compact">
- <li><a href="anoncvs.txt">CVS</a></li>
- <li><a href="http://cvs.apache.org/snapshots/apr/">Snapshots</a></li>
- <li><a href="compiling_win32.html">Build on Win32</a></li>
- <li><a href="compiling_unix.html">Build on Unix</a></li>
+ <li><a href="docs/apr/">APR</a></li>
+ <li><a href="docs/apr-util/">APR-util</a></li>
+ <li>APR-iconv</li>
</menu>
<p><b>Guidelines</b></p>
<menu compact="compact">
<li><a href="guidelines.html">Project Guidelines</a></li>
<li><a href="patches.html">Contributing</a></li>
<li><a href="versioning.html">Version Numbers</a></li>
+ </menu>
+ <p><b><a
+href="/info/">Miscellaneous</a></b></p>
+ <menu compact="compact">
+ <li><a href="http://www.apache.org/LICENSE.txt">License</a></li>
+ <li><a href="projects.html">Projects using APR</a></li>
</menu>
</td>
<!-- RIGHT SIDE INFORMATION -->
1.2 +16 -13 apr-site/docs/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/apr-site/docs/index.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -u -r1.1 -r1.2
--- index.html 26 Sep 2003 04:00:22 -0000 1.1
+++ index.html 26 Sep 2003 05:12:19 -0000 1.2
@@ -12,32 +12,35 @@
<tr>
<!-- LEFT SIDE NAVIGATION -->
<td valign="top" nowrap="nowrap">
- <p><b>Essentials</b></p>
+ <p><b>Get Involved</b></p>
<menu compact="compact">
- <li><a href="http://www.apache.org/LICENSE.txt">License</a></li>
- </menu>
- <p><b>Subprojects</b></p>
- <menu compact="compact">
- <li>APR</li>
- <li>APR-util</li>
- <li>APR-iconv</li>
+ <li><a href="anoncvs.txt">CVS</a></li>
+ <li><a href="mailing-lists.html">Mailing Lists</a></li>
+ <li><a href="http://cvs.apache.org/snapshots/apr/">Snapshots</a></li>
+ <li><a href="compiling_win32.html">Build on Win32</a></li>
+ <li><a href="compiling_unix.html">Build on Unix</a></li>
</menu>
<p><b>Download!</b></p>
<menu compact="compact">
<li><a href="http://www.apache.org/dyn/closer.cgi/apr/">from a mirror</a></li>
</menu>
- <p><b>Get Involved</b></p>
+ <p><b>Docs</b></p>
<menu compact="compact">
- <li><a href="anoncvs.txt">CVS</a></li>
- <li><a href="http://cvs.apache.org/snapshots/apr/">Snapshots</a></li>
- <li><a href="compiling_win32.html">Build on Win32</a></li>
- <li><a href="compiling_unix.html">Build on Unix</a></li>
+ <li><a href="docs/apr/">APR</a></li>
+ <li><a href="docs/apr-util/">APR-util</a></li>
+ <li>APR-iconv</li>
</menu>
<p><b>Guidelines</b></p>
<menu compact="compact">
<li><a href="guidelines.html">Project Guidelines</a></li>
<li><a href="patches.html">Contributing</a></li>
<li><a href="versioning.html">Version Numbers</a></li>
+ </menu>
+ <p><b><a
+href="/info/">Miscellaneous</a></b></p>
+ <menu compact="compact">
+ <li><a href="http://www.apache.org/LICENSE.txt">License</a></li>
+ <li><a href="projects.html">Projects using APR</a></li>
</menu>
</td>
<!-- RIGHT SIDE INFORMATION -->
1.2 +86 -56 apr-site/docs/mailing-lists.html
Index: mailing-lists.html
===================================================================
RCS file: /home/cvs/apr-site/docs/mailing-lists.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -u -r1.1 -r1.2
--- mailing-lists.html 26 Sep 2003 04:00:22 -0000 1.1
+++ mailing-lists.html 26 Sep 2003 05:12:19 -0000 1.2
@@ -1,57 +1,87 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
- "http://www.w3.org/TR/REC-html40/loose.dtd">
-<HTML>
-<HEAD>
-<TITLE>APR Mailing Lists</TITLE>
-</HEAD>
-<!-- Background white, links blue (unvisited), navy (visited), red (active) -->
- <BODY
- BGCOLOR="#FFFFFF"
- TEXT="#000000"
- LINK="#0000FF"
- VLINK="#000080"
- ALINK="#FF0000"
- >
-<CENTER>
-<H1 ALIGN=CENTER>APR Mailing Lists</H1>
-</CENTER>
-
- <P>
- The Apache Project makes very heavy use of mailing lists. All of
- these are <A HREF="http://www.ezmlm.org/">ezmlm</A> lists, which
- means that if you want to subscribe to <B><EM>list</EM>@apr.apache.org</B>
- then you want to email <B><EM>list</EM>-subscribe@apr.apache.org</B>,
- for any given list. If you need help with the various ezmlm commands
- for a given list, email <B><EM>list</EM>-help@apr.apache.org</B>.
- Details given below.
-
- <UL>
- <LI><A
- HREF="mailto:cvs-subscribe@apr.apache.org"
- ><SAMP>cvs</SAMP></A>
- <P>
- This list is used to notify developers of changes to the master CVS
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
+ <meta name="author" content="APR Developers" /><meta name="email" content="dev@apr.apache.org" />
+ <title>Mailing Lists - The Apache Portable Runtime Project</title>
+ </head>
+ <body bgcolor="#ffffff" text="#000000" link="#525D76">
+<p><a href="/"><img src="./images/apr_logo_wide.png" alt="The Apache Portable Runtime Project" border="0"/></a></p>
+ <table border="0" width="100%" cellspacing="4">
+ <tr>
+ <!-- LEFT SIDE NAVIGATION -->
+ <td valign="top" nowrap="nowrap">
+ <p><b>Get Involved</b></p>
+ <menu compact="compact">
+ <li><a href="anoncvs.txt">CVS</a></li>
+ <li><a href="mailing-lists.html">Mailing Lists</a></li>
+ <li><a href="http://cvs.apache.org/snapshots/apr/">Snapshots</a></li>
+ <li><a href="compiling_win32.html">Build on Win32</a></li>
+ <li><a href="compiling_unix.html">Build on Unix</a></li>
+ </menu>
+ <p><b>Download!</b></p>
+ <menu compact="compact">
+ <li><a href="http://www.apache.org/dyn/closer.cgi/apr/">from a mirror</a></li>
+ </menu>
+ <p><b>Docs</b></p>
+ <menu compact="compact">
+ <li><a href="docs/apr/">APR</a></li>
+ <li><a href="docs/apr-util/">APR-util</a></li>
+ <li>APR-iconv</li>
+ </menu>
+ <p><b>Guidelines</b></p>
+ <menu compact="compact">
+ <li><a href="guidelines.html">Project Guidelines</a></li>
+ <li><a href="patches.html">Contributing</a></li>
+ <li><a href="versioning.html">Version Numbers</a></li>
+ </menu>
+ <p><b><a
+href="/info/">Miscellaneous</a></b></p>
+ <menu compact="compact">
+ <li><a href="http://www.apache.org/LICENSE.txt">License</a></li>
+ <li><a href="projects.html">Projects using APR</a></li>
+ </menu>
+ </td>
+ <!-- RIGHT SIDE INFORMATION -->
+ <td align="left" valign="top">
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <strong>APR Mailing Lists</strong>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+<p>The APR Project makes very heavy use of mailing lists. All of these are <a href="http://www.ezmlm.org/">ezmlm</a> lists, which means that if you want to
+subscribe to <b><em>list</em>@apr.apache.org</b> then you want to email
+<b><em>list</em>-subscribe@apr.apache.org</b>, for any given list. If you need
+help with the various ezmlm commands for a given list, email
+<b><em>list</em>-help@apr.apache.org</b>. Details given below.</p>
+<ul>
+ <li><a href="mailto:cvs-subscribe@apr.apache.org"><samp>cvs</samp></a>
+ <p>This list is used to notify developers of changes to the master CVS
repository. As changes are applied, CVS log messages are sent to
- everyone who is a member of the list.
- </P>
- </LI>
-
- <LI><A HREF="mailto:dev-subscribe@apr.apache.org">
- <SAMP>dev</SAMP></A>
- <P>
- This list is the primary developer mailing list. If you have
- patches or suggestions, feel free to share them with this list.
- </P>
-
- <LI><A
- HREF="mailto:serf-dev-subscribe@apr.apache.org"
- ><SAMP>serf-dev</SAMP></A>
- <P>
- This list is the developer mailing list for the serf subproject.
- If you have patches or suggestions, feel free to share them with
- this list.
- </P>
- </LI>
- </UL>
- </BODY>
-</HTML>
+ everyone who is a member of the list.</p>
+ </li>
+ <li><a href="mailto:dev-subscribe@apr.apache.org"><samp>dev</samp></a>
+ <p>This list is the primary developer mailing list. If you have
+ patches or suggestions, feel free to share them with this list.</p>
+ </li>
+</ul>
+ </blockquote>
+ </td></tr>
+</table>
+ </td>
+ </tr>
+ <!-- FOOTER -->
+ <tr><td colspan="2"><hr noshade="noshade" size="1"/></td></tr>
+ <tr><td colspan="2" align="center">
+ <font size="-1">
+ <em>Copyright © 1999-2003, The Apache Software Foundation</em>
+ </font>
+ </td>
+ </tr>
+ </table>
+ </body>
+</html>
1.2 +146 -94 apr-site/docs/patches.html
Index: patches.html
===================================================================
RCS file: /home/cvs/apr-site/docs/patches.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -u -r1.1 -r1.2
--- patches.html 26 Sep 2003 04:00:22 -0000 1.1
+++ patches.html 26 Sep 2003 05:12:19 -0000 1.2
@@ -1,96 +1,148 @@
-<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
- <head>
- <title>How to Contribute Patches</title>
- </head>
-
- <body>
- <h1>Creating Patches</h1>
-
- <p>
- Like most Open Source projects, APR thrives on contributions from
- people 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>
- <HR>
- <H2>
- Code Style
- </H2>
- <P>
- Currently APR is using the same code format as Apache. The Apache
- style-guide was debated for a long time before it the Apache Group
- settled on it, and because APR grew out of Apache code, it made sense
- to continue the same style. It is unlikely that this style will change
- at any time. The style-guide can currently be found on the Apache httpd
- dev site, <A HREF="http://httpd.apache.org/dev/styleguide.html">here</A>.
- </P>
-
- <P>
- We also have very high expectations for code quality; and to us this
- means the avoidance of excessive static buffers, using the
- memory pool mechanism (which ensures proper cleanup), and otherwise
- writing thread-safe code. We also expect one or two levels of
- optimizations to be applied, too - is a bitmask faster for this? Is
- a strchr() faster than an index()? Etc. Of course it'd be nice if we
- had a real document describing this all, but we don't yet.</P>
-
- <P>
- One notable standard that has been adopted within APR functions (and
- is 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>
-
- <HR>
- <H2>
- Patch Format
- </H2>
-
- <P>We prefer that patches be submitted in unified diff format:
-
- <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:
-
- <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>
-
- <HR>
- <H2>
- Submitting your Patch
- </H2>
- <P>
- <B>If</B> you are a subscriber to dev@apr.apache.org, you can simply 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 something else or everyone's on
- vacation, it could get lost in the noise. Feel free to resubmit your
- patch in a week or so if you have not yet received any feedback from
- the developers' group.
-
- <P>Also, there are often times when the core developers are in
- "feature freeze", when they are trying to iron out the remaining
- bugs in the code in preparation for a release.
-
- <hr>
- <address><a href="mailto:rbb@apache.org">Ryan Bloom</a></address>
-<!-- Created: Fri Nov 24 16:27:22 PST 2000 -->
-<!-- hhmts start -->
-Last modified: <!--#echo var="LAST_MODIFIED"-->
-<!-- hhmts end -->
- </body>
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
+ <meta name="author" content="APR Developers" /><meta name="email" content="dev@apr.apache.org" />
+ <title>How to Contribute Patches - The Apache Portable Runtime Project</title>
+ </head>
+ <body bgcolor="#ffffff" text="#000000" link="#525D76">
+<p><a href="/"><img src="./images/apr_logo_wide.png" alt="The Apache Portable Runtime Project" border="0"/></a></p>
+ <table border="0" width="100%" cellspacing="4">
+ <tr>
+ <!-- LEFT SIDE NAVIGATION -->
+ <td valign="top" nowrap="nowrap">
+ <p><b>Get Involved</b></p>
+ <menu compact="compact">
+ <li><a href="anoncvs.txt">CVS</a></li>
+ <li><a href="mailing-lists.html">Mailing Lists</a></li>
+ <li><a href="http://cvs.apache.org/snapshots/apr/">Snapshots</a></li>
+ <li><a href="compiling_win32.html">Build on Win32</a></li>
+ <li><a href="compiling_unix.html">Build on Unix</a></li>
+ </menu>
+ <p><b>Download!</b></p>
+ <menu compact="compact">
+ <li><a href="http://www.apache.org/dyn/closer.cgi/apr/">from a mirror</a></li>
+ </menu>
+ <p><b>Docs</b></p>
+ <menu compact="compact">
+ <li><a href="docs/apr/">APR</a></li>
+ <li><a href="docs/apr-util/">APR-util</a></li>
+ <li>APR-iconv</li>
+ </menu>
+ <p><b>Guidelines</b></p>
+ <menu compact="compact">
+ <li><a href="guidelines.html">Project Guidelines</a></li>
+ <li><a href="patches.html">Contributing</a></li>
+ <li><a href="versioning.html">Version Numbers</a></li>
+ </menu>
+ <p><b><a
+href="/info/">Miscellaneous</a></b></p>
+ <menu compact="compact">
+ <li><a href="http://www.apache.org/LICENSE.txt">License</a></li>
+ <li><a href="projects.html">Projects using APR</a></li>
+ </menu>
+ </td>
+ <!-- RIGHT SIDE INFORMATION -->
+ <td align="left" valign="top">
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <strong>Creating Patches</strong>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+<p>Like most Open Source projects, APR thrives on contributions from people
+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>
+ </blockquote>
+ </td></tr>
+</table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <strong>Code Style</strong>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+<p>Currently APR is using the same code format as Apache. The Apache
+style-guide was debated for a long time before it the Apache Group settled on
+it, and because APR grew out of Apache code, it made sense to continue the same
+style. It is unlikely that this style will change at any time. The
+style-guide can currently be found on the Apache httpd dev site, <a href="http://httpd.apache.org/dev/styleguide.html">here</a>.</p>
+<p>We also have very high expectations for code quality; and to us this means
+the avoidance of excessive static buffers, using the memory pool mechanism
+(which ensures proper cleanup), and otherwise writing thread-safe code. We
+also expect one or two levels of optimizations to be applied, too - is a
+bitmask faster for this? Is a strchr() faster than an index()? Etc. Of
+course it'd be nice if we had a real document describing this all, but we don't
+yet.</p>
+<p>One notable standard that has been adopted within APR functions (and is
+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>
+ </blockquote>
+ </td></tr>
+</table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <strong>Patch Format</strong>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+<p>We prefer 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>
+<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>
+ </blockquote>
+ </td></tr>
+</table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <strong>Submitting Your Patch</strong>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+<p><b>If</b> you are a subscriber to dev@apr.apache.org, you can simply 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
+something else or everyone's on vacation, it could get lost in the noise. Feel
+free to resubmit your patch in a week or so if you have not yet received any
+feedback from the developers' group.</p>
+<p>Also, there are often times when the core developers are in "feature
+freeze", when they are trying to iron out the remaining bugs in the code in
+preparation for a release.</p>
+ </blockquote>
+ </td></tr>
+</table>
+ </td>
+ </tr>
+ <!-- FOOTER -->
+ <tr><td colspan="2"><hr noshade="noshade" size="1"/></td></tr>
+ <tr><td colspan="2" align="center">
+ <font size="-1">
+ <em>Copyright © 1999-2003, The Apache Software Foundation</em>
+ </font>
+ </td>
+ </tr>
+ </table>
+ </body>
</html>
1.2 +100 -28 apr-site/docs/projects.html
Index: projects.html
===================================================================
RCS file: /home/cvs/apr-site/docs/projects.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -u -r1.1 -r1.2
--- projects.html 26 Sep 2003 04:00:22 -0000 1.1
+++ projects.html 26 Sep 2003 05:12:19 -0000 1.2
@@ -1,35 +1,107 @@
-<!doctype html public "-//W3C//DTD HTML 4.0 Transitional//EN"
- "http://www.w3.org/TR/REC-html40/loose.dtd">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
- <title>Open Source Projects Using Apache Portable Runtime</title>
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
+ <meta name="author" content="APR Developers" /><meta name="email" content="dev@apr.apache.org" />
+ <title>Projects Using the Apache Portable Runtime - The Apache Portable Runtime Project</title>
</head>
- <body>
- <table border="0" cellspacing="10" cellpadding="10">
- <tr align="left" valign="middle">
- <td>
- <img src="http://www.apache.org/images/asf-logo.gif"
- width="387" height="100" alt="The Apache Software Foundation"></td>
+ <body bgcolor="#ffffff" text="#000000" link="#525D76">
+<p><a href="/"><img src="./images/apr_logo_wide.png" alt="The Apache Portable Runtime Project" border="0"/></a></p>
+ <table border="0" width="100%" cellspacing="4">
+ <tr>
+ <!-- LEFT SIDE NAVIGATION -->
+ <td valign="top" nowrap="nowrap">
+ <p><b>Get Involved</b></p>
+ <menu compact="compact">
+ <li><a href="anoncvs.txt">CVS</a></li>
+ <li><a href="mailing-lists.html">Mailing Lists</a></li>
+ <li><a href="http://cvs.apache.org/snapshots/apr/">Snapshots</a></li>
+ <li><a href="compiling_win32.html">Build on Win32</a></li>
+ <li><a href="compiling_unix.html">Build on Unix</a></li>
+ </menu>
+ <p><b>Download!</b></p>
+ <menu compact="compact">
+ <li><a href="http://www.apache.org/dyn/closer.cgi/apr/">from a mirror</a></li>
+ </menu>
+ <p><b>Docs</b></p>
+ <menu compact="compact">
+ <li><a href="docs/apr/">APR</a></li>
+ <li><a href="docs/apr-util/">APR-util</a></li>
+ <li>APR-iconv</li>
+ </menu>
+ <p><b>Guidelines</b></p>
+ <menu compact="compact">
+ <li><a href="guidelines.html">Project Guidelines</a></li>
+ <li><a href="patches.html">Contributing</a></li>
+ <li><a href="versioning.html">Version Numbers</a></li>
+ </menu>
+ <p><b><a
+href="/info/">Miscellaneous</a></b></p>
+ <menu compact="compact">
+ <li><a href="http://www.apache.org/LICENSE.txt">License</a></li>
+ <li><a href="projects.html">Projects using APR</a></li>
+ </menu>
+ </td>
+ <!-- RIGHT SIDE INFORMATION -->
+ <td align="left" valign="top">
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="submit"><strong>Submit your project!</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+<p>Do you use APR? Send an email to dev@apr.apache.org with your project
+name and a URL to get added to this list!</p>
+ </blockquote>
+ </td></tr>
+</table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="open_source"><strong>Open Source Projects Using APR</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+<p>The following open source projects are known to use APR:</p>
+<ul>
+ <li><a href="http://httpd.apache.org">Apache HTTP Server</a></li>
+ <li><a href="http://httpd.apache.org/test/flood/">Flood load tester</a></li>
+ <li><a href="http://jxta-c.jxta.org/">JXTA-C</a></li>
+ <li><a href="http://jakarta.apache.org/tomcat/">Tomcat's mod_jk v2 and mod_webapp</a></li>
+ <li><a href="http://subversion.tigris.org/">Subversion</a></li>
+ <li><a href="http://opendj.org/">OPENdj</a></li>
+</ul>
+ </blockquote>
+ </td></tr>
+</table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="commercial"><strong>Commercial Projects Using APR</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+<p>The following commercial projects are known to use APR:</p>
+<ul>
+ <li><a href="http://www.covalent.net/">Various Covalent Products</a></li>
+</ul>
+ </blockquote>
+ </td></tr>
+</table>
+ </td>
</tr>
- <tr align="left" valign="middle">
- <td>
- <a name=open_source></a><h3>Open Source projects using APR</h3>
- <p>
- <a href="http://httpd.apache.org">Apache Web Server</a><br>
- <a href="http://httpd.apache.org/test/flood/">Flood load test tool</a> <br>
- <a href="http://jxta-c.jxta.org">JXTA-C</a><br>
- <a href="http://jakarta.apache.org/tomcat">Tomcat's mod_jk v2 and mod_webapp</a><br>
- <a href="http://subversion.tigris.org">Subversion</a><br>
- <a href="http://opendj.org">OPENdj</a><br>
- </p>
- </td>
- </tr>
- <tr align="left" valign="middle">
- <td>
- <a name=commercial></a><h3>Commercial projects using APR</h3>
- <p>
- <a href="http://www.covalent.net">Various Covalent Products</a>
- </td>
+ <!-- FOOTER -->
+ <tr><td colspan="2"><hr noshade="noshade" size="1"/></td></tr>
+ <tr><td colspan="2" align="center">
+ <font size="-1">
+ <em>Copyright © 1999-2003, The Apache Software Foundation</em>
+ </font>
+ </td>
</tr>
</table>
</body>
1.3 +16 -13 apr-site/docs/versioning.html
Index: versioning.html
===================================================================
RCS file: /home/cvs/apr-site/docs/versioning.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -u -r1.2 -r1.3
--- versioning.html 26 Sep 2003 04:47:27 -0000 1.2
+++ versioning.html 26 Sep 2003 05:12:19 -0000 1.3
@@ -12,32 +12,35 @@
<tr>
<!-- LEFT SIDE NAVIGATION -->
<td valign="top" nowrap="nowrap">
- <p><b>Essentials</b></p>
+ <p><b>Get Involved</b></p>
<menu compact="compact">
- <li><a href="http://www.apache.org/LICENSE.txt">License</a></li>
- </menu>
- <p><b>Subprojects</b></p>
- <menu compact="compact">
- <li>APR</li>
- <li>APR-util</li>
- <li>APR-iconv</li>
+ <li><a href="anoncvs.txt">CVS</a></li>
+ <li><a href="mailing-lists.html">Mailing Lists</a></li>
+ <li><a href="http://cvs.apache.org/snapshots/apr/">Snapshots</a></li>
+ <li><a href="compiling_win32.html">Build on Win32</a></li>
+ <li><a href="compiling_unix.html">Build on Unix</a></li>
</menu>
<p><b>Download!</b></p>
<menu compact="compact">
<li><a href="http://www.apache.org/dyn/closer.cgi/apr/">from a mirror</a></li>
</menu>
- <p><b>Get Involved</b></p>
+ <p><b>Docs</b></p>
<menu compact="compact">
- <li><a href="anoncvs.txt">CVS</a></li>
- <li><a href="http://cvs.apache.org/snapshots/apr/">Snapshots</a></li>
- <li><a href="compiling_win32.html">Build on Win32</a></li>
- <li><a href="compiling_unix.html">Build on Unix</a></li>
+ <li><a href="docs/apr/">APR</a></li>
+ <li><a href="docs/apr-util/">APR-util</a></li>
+ <li>APR-iconv</li>
</menu>
<p><b>Guidelines</b></p>
<menu compact="compact">
<li><a href="guidelines.html">Project Guidelines</a></li>
<li><a href="patches.html">Contributing</a></li>
<li><a href="versioning.html">Version Numbers</a></li>
+ </menu>
+ <p><b><a
+href="/info/">Miscellaneous</a></b></p>
+ <menu compact="compact">
+ <li><a href="http://www.apache.org/LICENSE.txt">License</a></li>
+ <li><a href="projects.html">Projects using APR</a></li>
</menu>
</td>
<!-- RIGHT SIDE INFORMATION -->
1.1 apr-site/xdocs/mailing-lists.xml
Index: mailing-lists.xml
===================================================================
<?xml version="1.0"?>
<document>
<properties>
<author email="dev@apr.apache.org">APR Developers</author>
<title>Mailing Lists</title>
</properties>
<body>
<section>
<title>APR Mailing Lists</title>
<p>The APR Project makes very heavy use of mailing lists. All of these are <a
href="http://www.ezmlm.org/">ezmlm</a> lists, which means that if you want to
subscribe to <b><em>list</em>@apr.apache.org</b> then you want to email
<b><em>list</em>-subscribe@apr.apache.org</b>, for any given list. If you need
help with the various ezmlm commands for a given list, email
<b><em>list</em>-help@apr.apache.org</b>. Details given below.</p>
<ul>
<li><a href="mailto:cvs-subscribe@apr.apache.org"><samp>cvs</samp></a>
<p>This list is used to notify developers of changes to the master CVS
repository. As changes are applied, CVS log messages are sent to
everyone who is a member of the list.</p>
</li>
<li><a href="mailto:dev-subscribe@apr.apache.org"><samp>dev</samp></a>
<p>This list is the primary developer mailing list. If you have
patches or suggestions, feel free to share them with this list.</p>
</li>
</ul>
</section>
</body>
</document>
1.1 apr-site/xdocs/patches.xml
Index: patches.xml
===================================================================
<?xml version="1.0"?>
<document>
<properties>
<author email="dev@apr.apache.org">APR Developers</author>
<title>How to Contribute Patches</title>
</properties>
<body>
<section>
<title>Creating Patches</title>
<p>Like most Open Source projects, APR thrives on contributions from people
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>
</section>
<section>
<title>Code Style</title>
<p>Currently APR is using the same code format as Apache. The Apache
style-guide was debated for a long time before it the Apache Group settled on
it, and because APR grew out of Apache code, it made sense to continue the same
style. It is unlikely that this style will change at any time. The
style-guide can currently be found on the Apache httpd dev site, <a
href="http://httpd.apache.org/dev/styleguide.html">here</a>.</p>
<p>We also have very high expectations for code quality; and to us this means
the avoidance of excessive static buffers, using the memory pool mechanism
(which ensures proper cleanup), and otherwise writing thread-safe code. We
also expect one or two levels of optimizations to be applied, too - is a
bitmask faster for this? Is a strchr() faster than an index()? Etc. Of
course it'd be nice if we had a real document describing this all, but we don't
yet.</p>
<p>One notable standard that has been adopted within APR functions (and is
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>
</section>
<section>
<title>Patch Format</title>
<p>We prefer 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>
<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>
</section>
<section>
<title>Submitting Your Patch</title>
<p><b>If</b> you are a subscriber to dev@apr.apache.org, you can simply 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
something else or everyone's on vacation, it could get lost in the noise. Feel
free to resubmit your patch in a week or so if you have not yet received any
feedback from the developers' group.</p>
<p>Also, there are often times when the core developers are in "feature
freeze", when they are trying to iron out the remaining bugs in the code in
preparation for a release.</p>
</section>
</body>
</document>
1.1 apr-site/xdocs/projects.xml
Index: projects.xml
===================================================================
<?xml version="1.0"?>
<document>
<properties>
<author email="dev@apr.apache.org">APR Developers</author>
<title>Projects Using the Apache Portable Runtime</title>
</properties>
<body>
<section id="submit">
<title>Submit your project!</title>
<p>Do you use APR? Send an email to dev@apr.apache.org with your project
name and a URL to get added to this list!</p>
</section>
<section id="open_source">
<title>Open Source Projects Using APR</title>
<p>The following open source projects are known to use APR:</p>
<ul>
<li><a href="http://httpd.apache.org">Apache HTTP Server</a></li>
<li><a href="http://httpd.apache.org/test/flood/">Flood load tester</a></li>
<li><a href="http://jxta-c.jxta.org/">JXTA-C</a></li>
<li><a href="http://jakarta.apache.org/tomcat/"
>Tomcat's mod_jk v2 and mod_webapp</a></li>
<li><a href="http://subversion.tigris.org/">Subversion</a></li>
<li><a href="http://opendj.org/">OPENdj</a></li>
</ul>
</section>
<section id="commercial">
<title>Commercial Projects Using APR</title>
<p>The following commercial projects are known to use APR:</p>
<ul>
<li><a href="http://www.covalent.net/">Various Covalent Products</a></li>
</ul>
</section>
</body>
</document>
1.2 +15 -15 apr-site/xdocs/stylesheets/project.xml
Index: project.xml
===================================================================
RCS file: /home/cvs/apr-site/xdocs/stylesheets/project.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -u -r1.1 -r1.2
--- project.xml 26 Sep 2003 04:00:26 -0000 1.1
+++ project.xml 26 Sep 2003 05:12:19 -0000 1.2
@@ -3,25 +3,23 @@
<title>The Apache Portable Runtime Project</title>
<body>
-<menu><title>Essentials</title>
- <li><a href="http://www.apache.org/LICENSE.txt">License</a></li>
-</menu>
-<menu><title>Subprojects</title>
- <li>APR</li>
- <li>APR-util</li>
- <li>APR-iconv</li>
+<menu><title>Get Involved</title>
+ <li><a href="anoncvs.txt">CVS</a></li>
+ <li><a href="mailing-lists.html">Mailing Lists</a></li>
+ <li><a href="http://cvs.apache.org/snapshots/apr/">Snapshots</a></li>
+ <li><a href="compiling_win32.html">Build on Win32</a></li>
+ <li><a href="compiling_unix.html">Build on Unix</a></li>
</menu>
<menu><title>Download!</title>
<li><a href="http://www.apache.org/dyn/closer.cgi/apr/">from a mirror</a></li>
</menu>
-<menu><title>Get Involved</title>
- <li><a href="anoncvs.txt">CVS</a></li>
- <li><a href="http://cvs.apache.org/snapshots/apr/">Snapshots</a></li>
- <li><a href="compiling_win32.html">Build on Win32</a></li>
- <li><a href="compiling_unix.html">Build on Unix</a></li>
+<menu><title>Docs</title>
+ <li><a href="docs/apr/">APR</a></li>
+ <li><a href="docs/apr-util/">APR-util</a></li>
+ <li>APR-iconv</li>
</menu>
<menu><title>Guidelines</title>
@@ -30,8 +28,10 @@
<li><a href="versioning.html">Version Numbers</a></li>
</menu>
-<!--menu><title href="/info/">Miscellaneous</title>
- <li><a href="/contributors/">Contributors</a></li>
-</menu-->
+<menu><title href="/info/">Miscellaneous</title>
+ <li><a href="http://www.apache.org/LICENSE.txt">License</a></li>
+ <li><a href="projects.html">Projects using APR</a></li>
+ <!--li><a href="/contributors/">Contributors</a></li-->
+</menu>
</body>
</project>