Fix minor problems and polish reference docs

Problems

 - Eliminate — in favor of —

   — was causing 'no such entity' errors during docbook
   processing; — produces the equivalent output.

 - Fix column issues in appendices

   column counts were set to 3, when they are in fact 4. This passed
   under DocBook 4 and Spring Build for unknown reasons, but caused a
   hard stop under DocBook 5 and the docbook-reference-plugin.

 - Add jdbc callout section in docbook 5-friendly style

   use <co/> tags as advertised in DocBook documentation.

 - Set correct widths for PDF ref doc images

   images were rendering larger than the PDF page; just set all to
   width=400 and everything looks good.

Polish

 - Update reference doc copyright to 2012

 - Remove "work-in-progress" language from ref docs

 - Update maven URLs to repo.springsource.org

 - Update javadoc urls from 3.0.x/javadoc-api => current/api

 - Replace hardcoded "3.1" with ${version} in ref doc
This commit is contained in:
Chris Beams
2012-01-15 00:29:39 +01:00
parent 7a3aa70565
commit 86b5066a96
22 changed files with 163 additions and 157 deletions

View File

@@ -97,7 +97,7 @@ TR: This section doesn't read well and I think we should try to rewrite it.-->Nu
<para><mediaobject>
<imageobject role="fo">
<imagedata align="left" fileref="images/spring-overview.png"
format="PNG" />
format="PNG" width="400" />
</imageobject>
<imageobject role="html">
@@ -259,7 +259,7 @@ TR: OK. Added to diagram.--></para>
<para><mediaobject>
<imageobject role="fo">
<imagedata align="center" fileref="images/overview-full.png"
format="PNG" />
format="PNG" width="400" />
</imageobject>
<imageobject role="html">
@@ -289,7 +289,8 @@ TR: OK. Added to diagram.--></para>
<para><mediaobject>
<imageobject role="fo">
<imagedata align="center"
fileref="images/overview-thirdparty-web.png" format="PNG" />
fileref="images/overview-thirdparty-web.png" format="PNG"
width="400"/>
</imageobject>
<imageobject role="html">
@@ -315,7 +316,7 @@ TR: OK. Added to diagram.--></para>
<para><mediaobject>
<imageobject role="fo">
<imagedata align="center" fileref="images/overview-remoting.png"
format="PNG" />
format="PNG" width="400" />
</imageobject>
<imageobject role="html">
@@ -335,7 +336,7 @@ TR: OK. Added to diagram.--></para>
<para><mediaobject>
<imageobject role="fo">
<imagedata align="center" fileref="images/overview-ejb.png"
format="PNG" />
format="PNG" width="400" />
</imageobject>
<imageobject role="html">
@@ -620,7 +621,7 @@ TR: OK. Added to diagram.--></para>
<programlisting>&lt;repositories&gt;
&lt;repository&gt;
&lt;id&gt;com.springsource.repository.maven.release&lt;/id&gt;
&lt;url&gt;http://maven.springframework.org/release/&lt;/url&gt;
&lt;url&gt;http://repo.springsource.org/release/&lt;/url&gt;
&lt;snapshots&gt;&lt;enabled&gt;false&lt;/enabled&gt;&lt;/snapshots&gt;
&lt;/repository&gt;
&lt;/repositories&gt;</programlisting>
@@ -630,7 +631,7 @@ TR: OK. Added to diagram.--></para>
<programlisting>&lt;repositories&gt;
&lt;repository&gt;
&lt;id&gt;com.springsource.repository.maven.milestone&lt;/id&gt;
&lt;url&gt;http://maven.springframework.org/milestone/&lt;/url&gt;
&lt;url&gt;http://repo.springsource.org/milestone/&lt;/url&gt;
&lt;snapshots&gt;&lt;enabled&gt;false&lt;/enabled&gt;&lt;/snapshots&gt;
&lt;/repository&gt;
&lt;/repositories&gt;</programlisting>
@@ -640,7 +641,7 @@ TR: OK. Added to diagram.--></para>
<programlisting>&lt;repositories&gt;
&lt;repository&gt;
&lt;id&gt;com.springsource.repository.maven.snapshot&lt;/id&gt;
&lt;url&gt;http://maven.springframework.org/snapshot/&lt;/url&gt;
&lt;url&gt;http://repo.springsource.org/snapshot/&lt;/url&gt;
&lt;snapshots&gt;&lt;enabled&gt;true&lt;/enabled&gt;&lt;/snapshots&gt;
&lt;/repository&gt;
&lt;/repositories&gt;</programlisting>