Re: GCJ redesign

[Gerald Pfeifer <pfeifer at dbai dot tuwien dot ac dot at>]

On 10 Nov 2002, Tom Tromey wrote:
>> If you revert this, that is, you replace these pseudo-tables
>> by an <h2> environment, I will hack our style file to do the
>> right thing for the java/*.html pages automatically.
> Could you update the style file first?

Well, that's just fair.  I'm going to do this by means of the patch
below, and as an example I have converted java/index.html accordingly.

Note that currently that horizontal bar appears larger than before because
this is now a true <h2> (previously it looked like a heading in graphical
browsers, but was not marked up accordingly).

If we want, we can change that; just replace

    <th align="left"><h2>
   </verbatim>
   %body
   <verbatim>
    </h2></th></tr></table>

by

    <th align="left"><b>
   </verbatim>
   %body
   <verbatim>
    </b></th></tr></table>

in style.mhtml.

> I'd like to make this change but I don't want it to "regress". Also I
> want to be able to check my work; I find the HTML in the java directory
> a bit hard to follow -- too many nested tables.

Definitely!  I hope that by getting rid of <GCJNAV> and the tables for
the headings this will become easier.

In other words, most of the "messy" stuff now resides in style.mhtml, and
regular documentation contributors should not have to worry about it. At
least that's my hope. ;-)

Gerald


Redefine <h2> to provide the style used for heading in java/*.html.

Index: style.mhtml
===================================================================
RCS file: /cvs/gcc/wwwdocs/htdocs/style.mhtml,v
retrieving revision 1.43
diff -u -3 -p -r1.43 style.mhtml
--- style.mhtml	10 Nov 2002 20:33:11 -0000	1.43
+++ style.mhtml	10 Nov 2002 21:34:51 -0000
@@ -11,6 +11,16 @@
  <group
   <set-var navigation>
   <set-var BACKPATH="../">
+  <define-container h2>
+   <verbatim>
+    <table border="0" cellpadding="4" width="95%"><tr bgcolor="#b0d0ff">
+    <th align="left"><h2>
+   </verbatim>
+   %body
+   <verbatim>
+    </h2></th></tr></table>
+   </verbatim>
+  </define-container>
  >
 >

2002-11-10  Gerald Pfeifer  <pfeifer@dbai.tuwien.ac.at>

        * index.html: Use <h2> instead of tricky tables to handle layout.
        Minor markup tweaks.

Index: java/index.html
===================================================================
RCS file: /cvs/gcc/wwwdocs/htdocs/java/index.html,v
retrieving revision 1.116
diff -u -3 -p -r1.116 index.html
--- java/index.html	31 Oct 2002 14:47:43 -0000	1.116
+++ java/index.html	10 Nov 2002 21:34:52 -0000
@@ -7,27 +7,21 @@

 <h1>The GNU Compiler for the Java<sup><a href="tm.html"><small>tm</small></a></sup> Programming Language</h1>

-<table border="0" cellpadding="4" width="95%">
-<tr bgcolor="#b0d0ff">
- <th align="left">
- What is GCJ?
- </th>
-</tr>
-</table>
-<br />
-GCJ is a portable, optimizing, ahead-of-time compiler for the Java
-Programming Language.  It can compile:
+<h2>What is GCJ?</h2>
+
+<p>GCJ is a portable, optimizing, ahead-of-time compiler for the Java
+Programming Language.  It can compile:</p>
 <ul>
 <li>Java source code directly to native machine code,</li>
 <li>Java source code to Java bytecode (class files),</li>
 <li>and Java bytecode to native machine code.</li>
 </ul>

-Compiled applications are linked with the GCJ runtime,
+<p>Compiled applications are linked with the GCJ runtime,
 <code>libgcj</code>, which provides the core class libraries, a
 garbage collector, and a bytecode interpreter. <code>libgcj</code> can
 dynamically load and interpret class files, resulting in mixed
-compiled/interpreted applications.
+compiled/interpreted applications.</p>

 <p>
 Most of the APIs specified by "The Java Class Libraries" Second
@@ -59,13 +53,7 @@ can see the <a href="libgcj-classpath-co
 <br />
 <br />

-<table border="0" cellpadding="4" width="95%">
-<tr bgcolor="#b0d0ff">
- <th align="left">
- GCJ News
- </th>
-</tr>
-</table>
+<h2>GCJ News</h2>

 <table>