apr-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From jerenkra...@apache.org
Subject cvs commit: apr-site/xdocs/stylesheets project.xml
Date Fri, 26 Sep 2003 05:12:19 GMT
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 &#169; 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 &#169; 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 &#169; 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>
  
  
  

Mime
View raw message