Re: [PATCH] code file names linkified in general.html of the Hacking Guide

[Daniel Shahaf <da...@elego.de>]

Gabriela Gibson wrote on Wed, Dec 19, 2012 at 12:40:42 +0000:
>  in APR (look in 'apr/include/'):</p>
>  
>  <ul>
> -<li><p>memory pools:  apr_pools.h</p></li>
> -<li><p>filesystem access:  apr_file_io.h</p></li>
> -<li><p>hashes and arrays:  apr_hash.h, apr_tables.h</p></li>
> +<li><p>memory pools:  <a href="https://svn.apache.org/repos/asf/subversion/trunk/subversion/include/apr_pools.h">apr_pools.h</a></p></li>

Broken links.  If you want to link to them in APR's svn tree that's
fine, but I'm not sure whether you should link to the apr 1.x or 2.x
versions of these headers?

Re: [PATCH] code file names linkified in general.html of the Hacking Guide

[Stefan Sperling <st...@elego.de>]

On Wed, Dec 19, 2012 at 03:48:25PM +0200, Daniel Shahaf wrote:
> Gabriela Gibson wrote on Wed, Dec 19, 2012 at 12:40:42 +0000:
> >  in APR (look in 'apr/include/'):</p>
> >  
> >  <ul>
> > -<li><p>memory pools:  apr_pools.h</p></li>
> > -<li><p>filesystem access:  apr_file_io.h</p></li>
> > -<li><p>hashes and arrays:  apr_hash.h, apr_tables.h</p></li>
> > +<li><p>memory pools:  <a href="https://svn.apache.org/repos/asf/subversion/trunk/subversion/include/apr_pools.h">apr_pools.h</a></p></li>
> 
> Broken links.  If you want to link to them in APR's svn tree that's
> fine, but I'm not sure whether you should link to the apr 1.x or 2.x
> versions of these headers?

Daniel means this svn tree: http://svn.apache.org/repos/asf/apr/apr/
Which is where the APR project (http://apr.apache.org) has its source code.
Just in case this wasn't clear.

I'd say link to APR 1.5.x, which is the current release in the 1.x
series: http://svn.apache.org/repos/asf/apr/apr/branches/1.5.x/include/apr_pools.h
It doesn't really matter if this link gets stale over time.
Curious readers will find newer versions of the file on their own.