www/55973: make markup of gnome section a bit more compliant

Pav Lucistnik pav at oook.cz
Mon Aug 25 15:20:11 PDT 2003


>Number:         55973
>Category:       www
>Synopsis:       make markup of gnome section a bit more compliant
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-www
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Aug 25 15:20:09 PDT 2003
>Closed-Date:
>Last-Modified:
>Originator:     Pav Lucistnik
>Release:        FreeBSD 5.1-CURRENT i386
>Organization:
>Environment:
System: FreeBSD hood.oook.cz 5.1-CURRENT FreeBSD 5.1-CURRENT #0: Tue Aug 19 23:53:22 CEST 2003 root at hood.oook.cz:/usr/obj/usr/src/sys/PAV i386


	
>Description:
Markup cleanup in www/en/gnome:

* index.xsl and newsflash.xsl
  Don't propagate non-XHTML namespaces to XHTML output. This makes
  some pages validate as XHTML on mirrors with certain versions
  of xsltproc (try to validate http://www.freebsd.cz/gnome/ for example).
* many .sgml pages
  Remove single cell tables. They serve no purpose.
  Benefits: faster rendering, making tidy quiet.
* docs/faq2.sgml
  Convert table used for formatting of FAQ to ordered list.
  Convert spacing construction to inline style definition.
* docs/gnome_porting.sgml and docs/gnome2_porting.sgml
  Add summary attribute to <table> tag to make tidy happy.
  Add &nbsp; as a fill into empty table cells to make tidy happy.

>How-To-Repeat:
	
>Fix:

--- en/gnome/index.xsl.orig	Mon Aug 25 22:53:25 2003
+++ en/gnome/index.xsl	Mon Aug 25 22:52:49 2003
@@ -3,7 +3,7 @@
 <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
 		xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
 		xmlns:rdf1="http://my.netscape.com/rdf/simple/0.9/"
-		version="1.0">
+		exclude-result-prefixes="rdf rdf1" version="1.0">
   
   <xsl:import href="../includes.xsl"/>
   <xsl:import href="includes.xsl"/>
--- en/gnome/newsflash.xsl.orig	Mon Jan 28 17:38:30 2002
+++ en/gnome/newsflash.xsl	Mon Aug 25 22:59:25 2003
@@ -3,7 +3,7 @@
 <!-- $FreeBSD: www/en/gnome/newsflash.xsl,v 1.2 2002/01/28 16:38:30 sobomax Exp $ -->
 
 <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"
-  xmlns:cvs="http://www.FreeBSD.org/XML/CVS">
+  xmlns:cvs="http://www.FreeBSD.org/XML/CVS" exclude-result-prefixes="cvs">
 
   <xsl:import href="../includes.xsl"/>
   <xsl:import href="includes.xsl"/>
--- en/gnome/screenshots.sgml.orig	Sat Aug  2 22:57:37 2003
+++ en/gnome/screenshots.sgml	Mon Aug 25 23:03:58 2003
@@ -8,9 +8,6 @@
 <html>
   &header;
 
-  <table border="0">
-    <tr>
-      <td>
         <p>Here are some examples of GNOME running on FreeBSD.  Click on the
           thumbnails below to see a larger image.</p>
 
@@ -56,10 +53,6 @@
 	  <a href="images/ss12.png"><img src="images/ss12-tn.png" border="0" alt="Screen Shot 12">
 	  </a>
 	</p>
-
-      </td>
-    </tr>
-  </table>
 
   &footer;
 </body>
--- en/gnome/docs/bugging.sgml.orig	Sun Sep 15 21:46:32 2002
+++ en/gnome/docs/bugging.sgml	Mon Aug 25 23:09:42 2003
@@ -9,10 +9,6 @@
 <html>
   &header;
 
-    <table border="0">
-      <tr>
-        <td>
-
           <h2>1. What to report?</h2>
 
           <p>The rule of the thumb is: report as much information as you
@@ -95,9 +91,6 @@
 	      from your fix, without the need to wait for the vendor's next 
 	      release.</p></li>
           </ul>
-	</td>
-      </tr>
-    </table>
 
     &footer;
   </body>
--- en/gnome/docs/faq2.sgml.orig	Sat Jul 19 10:08:54 2003
+++ en/gnome/docs/faq2.sgml	Mon Aug 25 23:39:04 2003
@@ -8,9 +8,6 @@
 <html>
   &header;
 
-  <table border="0">
-    <tr>
-      <td>
         <h2>Contents</h2>
           <ol>
             <li> <a href="#q1">How do I get GNOME 2.2 for FreeBSD?</a>
@@ -37,21 +34,12 @@
 	      applications under GNOME 2.2?</a>
           </ol>
         <h2>Full Text </h2> 
-        <table border="0" cellspacing="0" cellpadding="2">
 
+          <ol>
 <!-- Q1 -->
-          <tr>
-	    <td width="10">
-	      <b><a name="q1"> 1.</a></b>
-	    </td>
-	    <td align="left" valign="top" colspan="3">
-	      <b>How do I get GNOME 2.2 for FreeBSD?</b>
-	    </td>
-          </tr>
-          <tr>
+	    <li style="padding-bottom: 0.5em"><a name="q1"></a>
+	    <p><b>How do I get GNOME 2.2 for FreeBSD?</b></p>
 <!-- A1 -->
-	  <td width="10"> <br> </td>
-	  <td align="left" valign="top" colspan="3"> 
 	    <p>There are two ways to install GNOME 2.2 on FreeBSD.  One way is to use 
 	      <a href="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/packages-using.html">
 	        packages</a>, and the other way is to use
@@ -108,22 +96,12 @@
 
 	    <p>These options may cause build errors on certain platforms, and
 	      thus they are not enabled by default.</p>
-	  </td>
-        </tr>
-        <tr><td><br></td></tr>
+	    </li>
 
 <!-- Q2 -->
-        <tr>
-	  <td width="10">
-	    <b><a name="q2"> 2.</a></b></td>
-	  <td align="left" valign="top" colspan="3">
-	    <b>GNOME 2.2 is failing to build from ports.  What do I do?</b>
-	  </td>
-        </tr>
+            <li style="padding-bottom: 0.5em"><a name="q2"></a>
+	    <p><b>GNOME 2.2 is failing to build from ports.  What do I do?</b></p>
 <!-- A2 -->
-        <tr>
-	  <td width="10"> <br> </td>
-	  <td align="left" valign="top" colspan="3"> 
 	    <p>The majority of GNOME 2.2 compilation problems can be solved 
 	      by making sure all the necessary GNOME 2.2 components are 
 	      <a href="#q5">up-to-date</a>. You may see compiler errors relating to pthreads 
@@ -154,23 +132,13 @@
 	      If you do not need these ports installed, it is recommended that
 	      you remove them.
 	    </p>
-	  </td>
-        </tr>
-        <tr><td><br></td></tr>
+	  </li>
 
 <!-- Q3 -->
-        <tr>
-	  <td width="10">
-	    <b><a name="q3"> 3.</a></b></td>
-	  <td align="left" valign="top" colspan="3">
-	    <b>I installed GNOME 2.2, but I am missing application foo.
-	      What gives?</b>
-	  </td>
-        </tr>
+	  <li style="padding-bottom: 0.5em"><a name="q3"></a>
+	    <p><b>I installed GNOME 2.2, but I am missing application foo.
+	      What gives?</b></p>
 <!-- A3 -->
-        <tr>
-	  <td width="10"> <br> </td>
-	  <td align="left" valign="top" colspan="3"> 
 	    <p>Only the core components, and a few extras, are included in the
 	      <tt>gnome2</tt> package.  While you can still run 
 	      <a href="#q6">GNOME 1.4 applications</a> under GNOME 2.2,
@@ -196,23 +164,12 @@
 # make install clean
 	    </pre>
 
-	  </td>
-        </tr>
-        <tr><td><br></td></tr>
+	  </li>
 
 <!-- Q4 -->
-        <tr>
-	  <td width="10">
-	    <b><a name="q4"> 4.</a></b></td>
-	  <td align="left" valign="top" colspan="3">
-	    <b>What is the best way to upgrade from GNOME 1.4 to GNOME 2?
-	    </b>
-	  </td>
-        </tr>
+	  <li style="padding-bottom: 0.5em"><a name="q4"></a>
+	    <p><b>What is the best way to upgrade from GNOME 1.4 to GNOME 2?</b></p>
 <!-- A4 -->
-        <tr>
-	  <td width="10"> <br> </td>
-	  <td align="left" valign="top" colspan="3"> 
 	    <p>Right now, the GNOME project is still very much in flux.
 	      Work still must be done to the GNOME ports infrastructure in
 	      order to get things working cleanly.  However, if you have
@@ -244,23 +201,13 @@
 	   <p>After those packages are removed, you can build GNOME 2.2 per 
 	     the instructions listed above.</p>
 
-	  </td>
-        </tr>
-        <tr><td><br></td></tr>
+	  </li>
 
 <!-- Q5 -->
-        <tr>
-	  <td width="10">
-	    <b><a name="q5"> 5.</a></b></td>
-	  <td align="left" valign="top" colspan="3">
-	    <b>How do I keep my GNOME 2.2 components and applications 
-	      up-to-date?</b>
-	  </td>
-        </tr>
+	  <li style="padding-bottom: 0.5em"><a name="q5"></a>
+	    <p><b>How do I keep my GNOME 2.2 components and applications 
+	      up-to-date?</b></p>
 <!-- A5 -->
-        <tr>
-	  <td width="10"> <br> </td>
-	  <td align="left" valign="top" colspan="3"> 
 	    <p>I find that <tt>/usr/ports/sysutils/portupgrade</tt> works really
 	      well.  For example:</p>
 
@@ -287,23 +234,12 @@
 	      reinstalling the desktop.  Fortunately, this extreme measure
 	      is only rarely needed.
 	    </p>
-	  </td>
-        </tr>
-
-        <tr><td><br></td></tr>
+	  </li>
 
 <!-- Q6 -->
-        <tr>
-	  <td width="10">
-	    <b><a name="q6"> 6.</a></b></td>
-	  <td align="left" valign="top" colspan="3">
-	    <b>Can I install GNOME 1.4 applications under GNOME 2.2?</b>
-	  </td>
-        </tr>
+	  <li style="padding-bottom: 0.5em"><a name="q6"></a>
+	    <p><b>Can I install GNOME 1.4 applications under GNOME 2.2?</b></p>
 <!-- A6 -->
-        <tr>
-	  <td width="10"> <br> </td>
-	  <td align="left" valign="top" colspan="3"> 
 	    <p>Sure!  Note, however, certain ports assume you are 
 	      running either the GNOME 1 or GNOME 2 desktop.  That is,
 	      they rely on certain desktop features such as the 
@@ -313,21 +249,12 @@
 	      (depending on your desktop version of choice) in 
 	      <tt>/etc/make.conf</tt>.  Then just install the GNOME port
 	      you wish.</p>
-	  </td>
-        </tr>
-        <tr><td><br></td></tr>
+	  </li>
+
 <!-- Q7 -->
-        <tr>
-	  <td width="10">
-	    <b><a name="q7"> 7.</a></b></td>
-	  <td align="left" valign="top" colspan="3">
-	    <b>Where can I get more themes for GNOME 2.2?</b>
-	  </td>
-        </tr>
+	  <li style="padding-bottom: 0.5em"><a name="q7"></a>
+	    <p><b>Where can I get more themes for GNOME 2.2?</b></p>
 <!-- A7 -->
-        <tr>
-	  <td width="10"> <br> </td>
-	  <td align="left" valign="top" colspan="3"> 
 	    <p>The website <a href="http://art.gnome.org"> 
 	      art.gnome.org</a> has been setup as a general GNOME theme
 	      repository.  They offer some gtk+-2, metacity, sawfish,
@@ -346,22 +273,12 @@
 	    <p>See the instructions on the website for installing the themes.
 	      If you feel inclined to port a few of them, you will not be
 	      turned away ;-).</p>
-	  </td>
-        </tr>
-        <tr><td><br></td></tr>
+	  </li>
 
 <!-- Q8 -->
-        <tr>
-	  <td width="10">
-	    <b><a name="q8"> 8.</a></b></td>
-	  <td align="left" valign="top" colspan="3">
-	    <b>What window managers work well with GNOME 2.2?</b>
-	  </td>
-        </tr>
+	  <li style="padding-bottom: 0.5em"><a name="q8"></a>
+	    <p><b>What window managers work well with GNOME 2.2?</b></p>
 <!-- A8 -->
-        <tr>
-	  <td width="10"> <br> </td>
-	  <td align="left" valign="top" colspan="3"> 
 	    <p>The <tt>gnome2</tt> meta-port installs the 
 	      metacity window manager by default.  Another popular window
 	      manager that works well with GNOME 2.2 is 
@@ -380,21 +297,12 @@
 	      window manager will revert back to the one previously configured
 	      upon next login.  To switch back, simply reverse sawfish and 
 	      metacity.</p>
-	  </td>
-        </tr>
-        <tr><td><br></td></tr>
+	  </li>
+
 <!-- Q9 -->
-        <tr>
-	  <td width="10">
-	    <b><a name="q9"> 9.</a></b></td>
-	  <td align="left" valign="top" colspan="3">
-	    <b>Does GNOME 2.2 support anti-aliased fonts?</b>
-	  </td>
-        </tr>
+	  <li style="padding-bottom: 0.5em"><a name="q9"></a>
+	    <p><b>Does GNOME 2.2 support anti-aliased fonts?</b></p>
 <!-- A9 -->
-        <tr>
-	  <td width="10"><br></td>
-	  <td align="left" valign="top" colspan="3"> 
 		<p>Yes!  Anti-aliasing requires XFree86 4.x with 
 		  freetype2 support.  To add freetype2 support to X, make
 		  sure you have the following modules loaded in your 
@@ -422,21 +330,12 @@
 		<p>If you have any questions, please send them to 
 		  <a href="mailto:&email;@FreeBSD.org">&email;@FreeBSD.org</a>.
 		</p>
-	  </td>
-        </tr>
-        <tr><td><br></td></tr>
+	  </li>
+
 <!-- Q10 -->
-        <tr>
-	  <td width="10">
-	    <b><a name="q10"> 10.</a></b></td>
-	  <td align="left" valign="top" colspan="3">
-	    <b>How can I control what fonts are anti-aliased?</b>
-	  </td>
-        </tr>
+	  <li style="padding-bottom: 0.5em"><a name="q10"></a>
+	    <p><b>How can I control what fonts are anti-aliased?</b></p>
 <!-- A10 -->
-        <tr>
-	  <td width="10"><br></td>
-	  <td align="left" valign="top" colspan="3"> 
 		<p>GNOME 2.2 makes use of Xft and fontconfig to handle 
 		  anti-aliasing.  Fontconfig is a very powerful XML-based
 		  font configuration package.  You can create a
@@ -462,21 +361,12 @@
                 </pre>
 
                 <p>Refer to fonts-conf(5) for more information.</p>
-	  </td>
-        </tr>
-        <tr><td><br></td></tr>
+	  </li>
+
 <!-- Q11 -->
-        <tr>
-	  <td width="10">
-	    <b><a name="q11"> 11.</a></b></td>
-	  <td align="left" valign="top" colspan="3">
-	    <b>How do I edit my GNOME 2 menus?</b>
-	  </td>
-        </tr>
+	  <li style="padding-bottom: 0.5em"><a name="q11"></a>
+	    <p><b>How do I edit my GNOME 2 menus?</b></p>
 <!-- A11 -->
-        <tr>
-	  <td width="10"><br></td>
-	  <td align="left" valign="top" colspan="3"> 
 	    <p>You need to use Nautilus to edit your GNOME 2 menus.  If you
 	      want to edit any menu other than Favorites, you must be
 	      root.</p>
@@ -484,22 +374,13 @@
 	    <p>To edit the menus, launch Nautilus, and enter the URL 
 	      <b>applications:///</b>.  From there you should be able to edit
 	      your entire application menu.</p>
-	  </td>
-        </tr>
-        <tr><td><br></td></tr>
+	  </li>
+
 <!-- Q12 -->
-        <tr>
-	  <td width="10">
-	    <b><a name="q12"> 12.</a></b></td>
-	  <td align="left" valign="top" colspan="3">
-	    <b>How do I use GTK+ 2 resource settings for GTK+ 2 applications
-	      when not in a GNOME environment?</b>
-	  </td>
-        </tr>
+	  <li style="padding-bottom: 0.5em"><a name="q12"></a>
+	    <p><b>How do I use GTK+ 2 resource settings for GTK+ 2 applications
+	      when not in a GNOME environment?</b></p>
 <!-- A12 -->
-        <tr>
-	  <td width="10"><br></td>
-	  <td align="left" valign="top" colspan="3"> 
 	    <p> GNOME 2 applications get their GTK+ 2 resources from themes and
 	      the corresponding theme engine.  If you would rather run your
 	      GTK+ 2 applications in a non-GNOME environment then you will
@@ -526,32 +407,19 @@
 		  <pre>gtk-font-name = "Verdana 11"</pre>
 		</li>
               </ol>
-	  </td>
-        </tr>
-        <tr><td><br></td></tr>
+	  </li>
+
 <!-- Q13 -->
-        <tr>
-	  <td width="10">
-	    <b><a name="q13"> 13.</a></b></td>
-	  <td align="left" valign="top" colspan="3">
-	    <b>How do I configure settings for GNOME 1.4 applications under
-	      GNOME 2.2?</b>
-	  </td>
-        </tr>
+	  <li style="padding-bottom: 0.5em"><a name="q13"></a>
+	    <p><b>How do I configure settings for GNOME 1.4 applications under
+	      GNOME 2.2?</b></p>
 <!-- A13 -->
-        <tr>
-	  <td width="10"><br></td>
-	  <td align="left" valign="top" colspan="3"> 
 	    <p>Install <tt>sysutils/gnomecontrolcenter</tt>, then invoke
 	      <tt>gnomecc</tt> from the command line to bring up the GNOME
 	      1.4 control center.</p>
-	  </td>
-        </tr>
-        <tr><td><br></td></tr>
-        </table>
-      </td>
-    </tr>
-  </table>
+	  </li>
+        </ol>
+
   &footer;
 </body>
 </html>
--- en/gnome/docs/gnome2_porting.sgml.orig	Sun Jul 13 07:11:09 2003
+++ en/gnome/docs/gnome2_porting.sgml	Mon Aug 25 23:48:57 2003
@@ -7,11 +7,9 @@
 ]>
 <html>
   &header;
-    <table border="0">
-      <tr>
-        <td>
+
 <!-- Begin USE_GNOME components list -->
-          <table border="1">
+          <table border="1" summary="GNOME 2 components">
 		    <tr>
 			  <th>COMPONENT</th>
 			  <th>ASSOCIATED PROGRAM</th>
@@ -45,7 +43,7 @@
 			<tr>
 			  <td><tt>esound</tt></td>
 			  <td><tt>audio/esound</tt></td>
-			  <td><tt></tt></td>
+			  <td><tt>&nbsp;</tt></td>
 			</tr>
 
 			<tr>
@@ -297,7 +295,7 @@
 			<tr>
 			  <td><tt>pkgconfig</tt></td>
 			  <td><tt>devel/pkgconfig</tt></td>
-			  <td><tt></tt></td>
+			  <td><tt>&nbsp;</tt></td>
 			</tr>
 
 			<tr>
@@ -313,9 +311,6 @@
 	    the <a href="/ports/gnome.html">existing ports</a> for examples.
 	    The <a href="mailto:&email;@FreeBSD.org">freebsd-gnome mailing
 	    list</a> is also there for you.</p>
-        </td>
-      </tr>
-    </table>
 
   &footer;
   </body>
--- en/gnome/docs/gnome_porting.sgml.orig	Mon Aug 25 23:46:21 2003
+++ en/gnome/docs/gnome_porting.sgml	Mon Aug 25 23:45:40 2003
@@ -7,11 +7,9 @@
 ]>
 <html>
   &header;
-    <table border="0">
-      <tr>
-        <td>
+
 <!-- Begin USE_GNOME components list -->
-          <table border="1">
+          <table border="1" summary="GNOME 1 components">
 		    <tr>
 			  <th>COMPONENT</th>
 			  <th>ASSOCIATED PROGRAM</th>
@@ -27,7 +25,7 @@
 			<tr>
 			  <td><tt>esound</tt></td>
 			  <td><tt>audio/esound</tt></td>
-			  <td><tt></tt></td>
+			  <td><tt>&nbsp;</tt></td>
 			</tr>
 
 			<tr>
@@ -157,7 +155,7 @@
 			<tr>
 			  <td><tt>libghttp</tt></td>
 			  <td><tt>www/libghttp</tt></td>
-			  <td><tt></tt></td>
+			  <td><tt>&nbsp;</tt></td>
 			</tr>
 
 			<tr>
@@ -197,9 +195,6 @@
 	    the <a href="/ports/gnome.html">existing ports</a> for examples.
 	    The <a href="mailto:&email;@FreeBSD.org">freebsd-gnome mailing
 	    list</a> is also there for you.</p>
-        </td>
-      </tr>
-    </table>
 
   &footer;
   </body>
--- en/gnome/docs/porting.sgml.orig	Tue Jun  3 19:55:11 2003
+++ en/gnome/docs/porting.sgml	Mon Aug 25 23:50:23 2003
@@ -7,9 +7,7 @@
 ]>
 <html>
   &header;
-    <table border="0">
-      <tr>
-        <td>
+
           <p>This document assumes that you already know how the port system works,
 	    and therefore only provides GNOME-specific hints and tips.  General
 	    instructions can be found in the 
@@ -310,9 +308,6 @@
 	    the <a href="/ports/gnome.html">existing ports</a> for examples.
 	    The <a href="mailto:&email;@FreeBSD.org">freebsd-gnome mailing
 	    list</a> is also there for you.</p>
-        </td>
-      </tr>
-    </table>
 
   &footer;
   </body>
--- en/gnome/docs/22knownissues.sgml.old	Tue Aug 26 00:00:15 2003
+++ en/gnome/docs/22knownissues.sgml	Mon Aug 25 23:58:29 2003
@@ -9,10 +9,6 @@
 <html>
   &header;
 
-    <table border="0">
-      <tr>
-        <td>
-
 	  <p>Below are a list of known issues with GNOME 2.2 that are 
 	    specific to FreeBSD.  They are not the only known issues,
 	    however.  Please familiarize yourself with the GNOME 2.2
@@ -67,9 +63,6 @@
 	      helping, please contact <a href="mailto:&email;@FreeBSD.org">
 	      freebsd-gnome at FreeBSD.org</a>.
 	    </p>
-	</td>
-      </tr>
-    </table>
 
     &footer;
   </body>
>Release-Note:
>Audit-Trail:
>Unformatted:


More information about the freebsd-www mailing list