Author: buildbot
Date: Fri Mar 20 19:20:14 2015
New Revision: 944515
Log:
Staging update by buildbot for sis
Modified:
websites/staging/sis/trunk/content/ (props changed)
websites/staging/sis/trunk/content/book/en/developer-guide.html
websites/staging/sis/trunk/content/source.html
Propchange: websites/staging/sis/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Fri Mar 20 19:20:14 2015
@@ -1 +1 @@
-1659735
+1668122
Modified: websites/staging/sis/trunk/content/book/en/developer-guide.html
==============================================================================
Binary files - no diff available.
Modified: websites/staging/sis/trunk/content/source.html
==============================================================================
--- websites/staging/sis/trunk/content/source.html (original)
+++ websites/staging/sis/trunk/content/source.html Fri Mar 20 19:20:14 2015
@@ -271,10 +271,6 @@ structure of <code><table></code>
<td><code>{@preformat}</code></td>
<td>An inline taglet for pre-formatted text. The first word inside the taglet
shall be one of <code>java</code>, <code>xml</code>, <code>sql</code>,
<code>wkt</code>, <code>text</code>, <code>math</code> or
<code>shell</code>.</td>
</tr>
-<tr>
-<td><code>{@section}</code></td>
-<td>An inline taglet for the title of a new section in the javadoc.</td>
-</tr>
</tbody>
</table>
<h2 id="html">HTML elements</h2>
@@ -286,6 +282,45 @@ For example:</p>
<li>Instead of "<code><pre>â</pre></code>" for a Java listing,
use "<code>{@preformat java â}</code>"
(this Javadoc tag is specific to Apache SIS â see above table).</li>
</ul>
+<p>The following HTML tags can be used:</p>
+<table>
+<thead>
+<tr>
+<th>HTML element</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code><div class="section"></code></td>
+<td>Header of a sub-section in a package, class or member description.</td>
+</tr>
+<tr>
+<td><code><div class="note"></code></td>
+<td>Note or example (use smaller font).</td>
+</tr>
+<tr>
+<td><code><ul></code> or <code><ol></code></td>
+<td>Start a list with few space between the items (useful for short
descriptions).</td>
+</tr>
+<tr>
+<td><code><ul class="verbose"></code></td>
+<td>Start a list with more space between the items (useful for long
descriptions).</td>
+</tr>
+<tr>
+<td><code><table class="sis"></code></td>
+<td>Table with a blue header row and some space between the cells</td>
+</tr>
+<tr>
+<td><code><table class="compact"></code></td>
+<td>Table without vertical space between the cells.</td>
+</tr>
+<tr>
+<td><code><td class="sep"></code></td>
+<td>Table cell with a vertical line on the left side.</td>
+</tr>
+</tbody>
+</table>
<h2 id="mathml">MathML elements</h2>
<p>The source code occasionally uses MathML for formulas that are difficult to
render with only Unicode characters.
PNG images are not extensively used for formulas because they are difficult to
edit after creation,
@@ -305,7 +340,7 @@ Note that a <a href="http://www.mathjax.
<p>Usages of the <code><p></code> tag should be relatively rare.
Do <strong>not</strong> use <code><p></code> for the first paragraph in
a package, class or member documentation,
or for the first paragraph after a <code></ul></code>,
<code></ol></code>, <code></table></code>,
<code></blockquote></code>, <code></pre></code>,
-<code>{@preformat}</code> or <code>{@section}</code> element.
+or <code>{@preformat}</code> element.
The <code><p></code> tag shall be used only for separating a new
paragraph from a previous one.
In such cases, <code><p></code> shall have a matching
<code></p></code> tag at the paragraph end in order to form valid
HTML.</p>
<h2 id="css">Javadoc CSS</h2>
