On 04/01/13 04:07, Ben Reser wrote:
(snip)
Thank you very much for the comments.
A new patch is attached.
Index: publish/docs/community-guide/general.part.html
===================================================================
--- publish/docs/community-guide/general.part.html (revision 1429564)
+++ publish/docs/community-guide/general.part.html (working copy)
@@ -174,15 +174,54 @@ understanding of the implementation details. Here
perusal order:</p>
<ol>
-<li><p>the basic building blocks: svn_string.h, svn_error.h, svn_types.h</p>
+<li><p>the basic building blocks:
+<a href=
+"http://subversion.apache.org/docs/api/latest/svn__string_8h.html";>
+ svn_string.h</a>,
+<a href=
+"http://subversion.apache.org/docs/api/latest/svn__error_8h.html";>
+ svn_error.h</a>,
+<a href=
+"http://subversion.apache.org/docs/api/latest/svn__types_8h.html";>
+ svn_types.h</a></p>
</li>
-<li><p>useful utilities: svn_io.h, svn_path.h, svn_hash.h, svn_xml.h</p>
+<li><p>
+<a href=
+"http://subversion.apache.org/docs/api/latest/svn__io_8h.html";>
+ svn_io.h</a>,
+<a href=
+"http://subversion.apache.org/docs/api/latest/svn__path_8h.html";>
+ svn_path.h</a>,
+<a href=
+"http://subversion.apache.org/docs/api/latest/svn__hash_8h.html";>
+ svn_hash.h</a>,
+<a href=
+"http://subversion.apache.org/docs/api/latest/svn__xml_8h.html";>
+ svn_xml.h</a></p>
</li>
-<li><p>the critical interface: svn_delta.h</p>
+<li><p>the critical interface:
+<a href=
+"http://subversion.apache.org/docs/api/latest/svn__delta_8h.html";>
+ svn__delta.h</a></p>
</li>
-<li><p>client-side interfaces: svn_ra.h, svn_wc.h, svn_client.h</p>
+<li><p>client-side interfaces:
+<a href=
+"http://subversion.apache.org/docs/api/latest/svn__ra_8h.html";>
+ svn_ra.h</a>,
+<a href=
+"http://subversion.apache.org/docs/api/latest/svn__wc_8h.html";>
+ svn_wc.h</a>,
+<a href=
+"http://subversion.apache.org/docs/api/latest/svn__client_8h.html";>
+ svn_client.h</a></p>
</li>
-<li><p>the repository and versioned filesystem: svn_repos.h, svn_fs.h</p>
+<li><p>the repository and versioned filesystem:
+<a href=
+"http://subversion.apache.org/docs/api/latest/svn__repos_8h.html";>
+ svn_repos.h</a>,
+<a href=
+"http://subversion.apache.org/docs/api/latest/svn__fs_8h.html";>
+ svn_fs.h</a></p>
</li>
</ol>
@@ -199,9 +238,22 @@ understand Subversion without first glancing over
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=
+"http://svn.apache.org/repos/asf/apr/apr/branches/1.5.x/include/apr_pools.h";>
+ apr_pools.h</a></p></li>
+<li><p>filesystem access:
+<a href=
+"http://svn.apache.org/repos/asf/apr/apr/branches/1.5.x/include/apr_file_io.h";>
+ apr_file_io.h</a></p></li>
+<li><p>hashes and arrays:
+<a href=
+"http://svn.apache.org/repos/asf/apr/apr/branches/1.5.x/include/apr_hash.h";>
+ apr_hash.h</a>,
+<a href=
+"http://svn.apache.org/repos/asf/apr/apr/branches/1.5.x/include/apr_tables.h";>
+ apr_tables.h</a>
+</p></li>
</ul>
<p>Subversion also tries to deliver reliable and secure software. This
@@ -209,7 +261,9 @@ can only be achieved by developers who understand
in the C programming language. Please see 'notes/assurance.txt' for
the full rationale behind this. Specifically, you should make it a
point to carefully read David Wheeler's Secure Programming (as
-mentioned in 'notes/assurance.txt'). If at any point you have
+mentioned in
+<a href="http://svn.apache.org/repos/asf/subversion/trunk/notes/assurance.txt";>
+'notes/assurance.txt'</a>). If at any point you have
questions about the security implications of a change, you are urged
to ask for review on the developer mailing list.</p>
@@ -225,74 +279,116 @@ to ask for review on the developer mailing list.</
<p>A rough guide to the source tree:</p>
<ul>
-<li><p><tt>doc/</tt><br />
+<li><p><tt><a
+ href="https://svn.apache.org/repos/asf/subversion/trunk/doc/";>
+ doc/</a></tt><br />
User and Developer documentation.</p>
</li>
-<li><p><tt>tools/</tt><br />
+
+<li><p><tt><a
+ href="https://svn.apache.org/repos/asf/subversion/trunk/tools/";>
+ tools/</a></tt><br />
+
Stuff that works with Subversion, but that Subversion doesn't
depend on. Code in tools/ is maintained collectively by the
Subversion project, and is under the same open source copyright as
Subversion itself.</p>
</li>
-<li><p><tt>contrib/</tt><br />
+
+<li><p><tt><a
+ href="https://svn.apache.org/repos/asf/subversion/trunk/contrib/";>
+ contrib/</a></tt><br />
+
Stuff that works with Subversion, but that Subversion doesn't
depend on, and that is maintained by individuals who may or may
not participate in Subversion development. Code in contrib/ is
open source, but may have a different license or copyright holder
than Subversion itself.</p>
</li>
+
<li><p><tt>packages/</tt><br />
Stuff to help packaging systems, like rpm and dpkg.</p>
</li>
-<li><p><tt>subversion/</tt><br />
+
+<li><p><tt><a
+ href="https://svn.apache.org/repos/asf/subversion/trunk/subversion/";>
+ subversion/</a></tt><br />
+
Source code to Subversion itself (as opposed to external
libraries).</p>
</li>
-<li><p><tt>subversion/include/</tt><br />
+<li><p><tt><a
+ href="https://svn.apache.org/repos/asf/subversion/trunk/subversion/include/";>
+ subversion/include/</a></tt><br />
+
Public header files for users of Subversion libraries.</p>
</li>
-<li><p><tt>subversion/include/private/</tt><br />
+
+<li><p><tt><a
+ href="https://svn.apache.org/repos/asf/subversion/trunk/subversion/include/private/";>
+ subversion/include/private/</a></tt><br />
+
Private header files shared internally by Subversion libraries.</p>
</li>
-<li><p><tt>subversion/libsvn_fs/</tt><br />
+
+<li><p><tt><a
+ href="https://svn.apache.org/repos/asf/subversion/trunk/subversion/libsvn_fs/";>
+ subversion/libsvn_fs/</a></tt><br />
The versioning "filesystem" API.</p>
</li>
-<li><p><tt>subversion/libsvn_repos/</tt><br />
+
+<li><p><tt><a
+ href="https://svn.apache.org/repos/asf/subversion/trunk/subversion/libsvn_repos/";>
+ subversion/libsvn_repos/</a></tt><br />
+
Repository functionality built around the `libsvn_fs' core.</p>
</li>
-<li><p><tt>subversion/libsvn_delta/</tt><br />
+
+<li><p><tt><a
+ href="https://svn.apache.org/repos/asf/subversion/trunk/subversion/libsvn_delta/";>
+ subversion/libsvn_delta/</a></tt><br />
+
Common code for tree deltas, text deltas, and property deltas.</p>
</li>
-<li><p><tt>subversion/libsvn_wc/</tt><br />
+
+<li><p><tt><a
+ href="https://svn.apache.org/repos/asf/subversion/trunk/subversion/libsvn_wc/";>
+ subversion/libsvn_wc/</a></tt><br />
+
Common code for working copies.</p>
</li>
-<li><p><tt>subversion/libsvn_ra/</tt><br />
+
+<li><p><tt><a
+ href="https://svn.apache.org/repos/asf/subversion/trunk/subversion/libsvn_ra/";>
+ subversion/libsvn_ra/</a></tt><br />
+
Common code for repository access.</p>
</li>
-<li><p><tt>subversion/libsvn_client/</tt><br />
+
+<li><p><tt><a
+ href="https://svn.apache.org/repos/asf/subversion/trunk/subversion/libsvn_client/";>
+ subversion/libsvn_client/</a></tt><br />
+
Common code for client operations.</p>
</li>
-<li><p><tt>subversion/svn/</tt><br />
+
+<li><p><tt><a
+ href="https://svn.apache.org/repos/asf/subversion/trunk/subversion/svn/";>
+ subversion/svn/</a></tt><br />
+
The command line client.</p>
</li>
-<li><p><tt>subversion/tests/</tt><br />
+
+<li><p><tt><a
+ href="https://svn.apache.org/repos/asf/subversion/trunk/subversion/tests/";>
+ subversion/tests/</a></tt><br />
+
Automated test suite.</p>
</li>
-<li><p><tt>apr/</tt><br />
- Apache Portable Runtime library. (Note: This is not in the same
- repository as Subversion. Read INSTALL for instructions on how to
- get it if you don't already have it.)</p>
-</li>
-<li><p><tt>neon/</tt><br />
- Neon library from Joe Orton. (Note: This is not in the same
- repository as Subversion. Read INSTALL for instructions on how to
- get it if you don't already have it.)</p>
-</li>
</ul>
</div> <!-- directory-layout -->
-
<div class="h2" id="branch-policy">
<h2>Branching policy
<a class="sectionlink" href="<!--#echo var="GUIDE_GENERAL_PAGE" -->#branch-policy"
[[[
Create links for all the linkable items in code-to-read and
directory-layout sections of general.html page.
* publish/docs/community-guide/general.part.html:
(code-to-read): Create links for all file names to point to HTML
pretty-print versions.
(code-to-read): Add link for 'notes/assurance.txt'.
(directory-layout): Create links for all directories to point to
current directories in development repository.
(directory-layout): Remove apr and neon links.
Patch by: Gabriela Gibson <gabriela.gibson{_AT_}gmail.com>
]]]
