[svn.haxx.se] · SVN Dev · SVN Users · SVN Org · TSVN Dev · TSVN Users · Subclipse Dev · Subclipse Users · this month's index

Re: svn commit: r1817032 - in /subversion/site/staging/docs: index.html release-notes/1.8.html

From: Stefan <luke1410_at_posteo.de>
Date: Sun, 3 Dec 2017 13:51:42 +0100

On 03/12/2017 13:34, luke1410_at_apache.org wrote:
> Author: luke1410
> Date: Sun Dec 3 12:34:02 2017
> New Revision: 1817032
>
> URL: http://svn.apache.org/viewvc?rev=1817032&view=rev
> Log:
> Introduce anchors to release sections on the docs index page and use the 1.8
> one on the 1.8 release notes to fix the previously non-working link.
>
> * site/staging/docs/index.html: add anchors/sections to the different
> releases...
> * site/staging/docs/release-notes/1.8.html: ... update the link here
> accordingly
>
> Modified:
> subversion/site/staging/docs/index.html
> subversion/site/staging/docs/release-notes/1.8.html
>
> Modified: subversion/site/staging/docs/index.html
> URL: http://svn.apache.org/viewvc/subversion/site/staging/docs/index.html?rev=1817032&r1=1817031&r2=1817032&view=diff
> ==============================================================================
> --- subversion/site/staging/docs/index.html (original)
> +++ subversion/site/staging/docs/index.html Sun Dec 3 12:34:02 2017
> @@ -96,34 +96,58 @@
> libraries are upgraded to 1.6.0 without your having to change or
> recompile your software at all.</p>
>
> -<h3>Latest release (currently 1.9)</h3>
> +<div class="h3" id="latest-release">
> +<h3>Latest release (currently 1.9)
> +<a class="sectionlink" href="#latest-release"
> + title="Link to this section">&para;</a>
> +</h3>
>
> <ul>
> <li>C API</li>
> <li>JavaHL</li>
> </ul>
>
> -<h3>Subversion 1.9</h3>
> +</div> <!-- #latest-release -->
> +
> +<div class="h3" id="release-1.9">
> +<h3>Subversion 1.9
> +<a class="sectionlink" href="#release-1.9"
> + title="Link to this section">&para;</a>
> +</h3>
>
> <ul>
> <li>C API</li>
> <li>JavaHL</li>
> </ul>
>
> -<h3>Subversion 1.8</h3>
> +</div> <!-- #release-1.9 -->
> +
> +<div class="h3" id="release-1.8">
> +<h3>Subversion 1.8
> +<a class="sectionlink" href="#release-1.8"
> + title="Link to this section">&para;</a>
> +</h3>
>
> <ul>
> <li>C API</li>
> <li>JavaHL</li>
> </ul>
>
> -<h3>Subversion 1.7</h3>
> +</div> <!-- #release-1.8 -->
> +
> +<div class="h3" id="release-1.7">
> +<h3>Subversion 1.7
> +<a class="sectionlink" href="#release-1.7"
> + title="Link to this section">&para;</a>
> +</h3>
>
> <ul>
> <li>C API</li>
> <li>JavaHL</li>
> </ul>
>
> +</div> <!-- #release-1.7 -->
> +
> <h3>Unreleased (1.10-dev)</h3>
>
> <ul>
>
> Modified: subversion/site/staging/docs/release-notes/1.8.html
> URL: http://svn.apache.org/viewvc/subversion/site/staging/docs/release-notes/1.8.html?rev=1817032&r1=1817031&r2=1817032&view=diff
> ==============================================================================
> --- subversion/site/staging/docs/release-notes/1.8.html (original)
> +++ subversion/site/staging/docs/release-notes/1.8.html Sun Dec 3 12:34:02 2017
> @@ -2505,7 +2505,7 @@ by issuing one additional request at the
> <div class="notice" style="background-color: inherit">
> <p>Technical details:
> A session is often equivalent to calling one <tt>svn</tt> subcommand (or
> -one <tt>svn_client_*</tt> function, for API users).
> +one <tt>svn_client_*</tt> function, for API users).
> However several subcommands currently open multiple sessions. The extra
> request cost is incurred for each session. A single session may make numerous
> TCP connections (usually 2 and never more than 8) and the extra request will
>
>
This and the following commits adds sections links to API sections for
the different SVN releases which previously were missing.

The main reason for this change was actually to fix a non-working
section link present on the 1.8 release notes page [1].
Adding these links/sections however also changed the layout so the
h3-sections are now indented. Initially I thought to resolve this, but
after checking think it looks better that way. To see the change,
compare these two pages [2/3]. Anybody against keeping this change?

Also note that in order to use HTML 4.01 compliant ids, I did not go
with #1.8 but rather #release-1.8, since in HTML 4.01 ids are not
allowed to start with numbers.

Regards,
Stefan

[1] http://subversion.apache.org/docs/release-notes/1.8.html (see link:
"API users").
[2] http://subversion-staging.apache.org/docs/
[3] http://subversion.apache.org/docs/
Received on 2017-12-03 13:52:02 CET

This is an archived mail posted to the Subversion Dev mailing list.