cvs commit: logging-site/src/xdocs/site logging-site.xml

[ceki]

ceki        2004/04/17 05:47:30

  Modified:    docs/site logging-site.html
               src/xdocs/site logging-site.xml
  Log:
  

  Added a comment on the recently discovered fix for the anchor problem.

  

  PR:

  Obtained from:

  Submitted by: 

  Reviewed by:  

  
  Revision  Changes    Path
  1.6       +16 -1     logging-site/docs/site/logging-site.html
  
  Index: logging-site.html
  ===================================================================
  RCS file: /home/cvs/logging-site/docs/site/logging-site.html,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- logging-site.html 28 Jan 2004 20:40:55 -0000      1.5
  +++ logging-site.html 17 Apr 2004 12:47:29 -0000      1.6
  @@ -390,7 +390,7 @@
         <mkdir dir="${docs.dest}/css"/>  
         <copy file="${logging-site}/docs/css/site.css" 
tofile="${docs.dest}/css/site.css"/>
         
  -      <anakia basedir="${xdocs.src}" destdir="${docs.dest}/"
  +      <anakia basedir="${docs.src}" destdir="${docs.dest}/"
        extension=".html"
        style="site.vsl"
        projectFile="stylesheets/project.xml"
  @@ -510,6 +510,21 @@
   module, please send feedback to the "general AT logging DOT apache DOT
   org" mailing list. Please try to give a detailed description of what
   is confusing so that we can update the page to make things clearer.
  +</p>
  +                                                                                    
               <h2>Known problems</h2>
  +                                                                                    
               <p>The current velocity style-sheets transform most elements with empty
  +bodies into their shorter form, supposed to be equivalent. In
  +particular, an html anchor such as <code>&lt;a
  +name="foobar"&gt;&lt;/a&gt;</code> will be transformed into
  +<code>&lt;a name="foobar"/&gt;</code>. The latter form very much
  +confuses browsers into thinking that the rest of the document is a URL
  +link. It even causes Internet Explorer version 6.0 to crash.
  +</p>
  +                                                                                    
               <p>The workaround is to insert a single character between the start
  +tag and the end tag. For example, writing
  +<code>&lt;a�name="foobar"&gt;&amp;#160;&lt;/a&gt;</code> instead
  +of <code>&lt;a name="foobar"&gt;&lt;/a&gt;</code> where the entity
  +&amp;#160; represents non-breaking space.
   </p>
                                                   
                       </td>
  
  
  
  1.7       +18 -0     logging-site/src/xdocs/site/logging-site.xml
  
  Index: logging-site.xml
  ===================================================================
  RCS file: /home/cvs/logging-site/src/xdocs/site/logging-site.xml,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- logging-site.xml  7 Feb 2004 15:47:09 -0000       1.6
  +++ logging-site.xml  17 Apr 2004 12:47:30 -0000      1.7
  @@ -342,6 +342,24 @@
   is confusing so that we can update the page to make things clearer.
   </p>
   
  +<h2>Known problems</h2>
  +
  +<p>The current velocity style-sheets transform most elements with empty
  +bodies into their shorter form, supposed to be equivalent. In
  +particular, an html anchor such as <code>&lt;a
  +name="foobar"&gt;&lt;/a&gt;</code> will be transformed into
  +<code>&lt;a name="foobar"/&gt;</code>. The latter form very much
  +confuses browsers into thinking that the rest of the document is a URL
  +link. It even causes Internet Explorer version 6.0 to crash.
  +</p>
  +
  +<p>The workaround is to insert a single character between the start
  +tag and the end tag. For example, writing
  +<code>&lt;a&#160;name="foobar"&gt;&amp;#160;&lt;/a&gt;</code> instead
  +of <code>&lt;a name="foobar"&gt;&lt;/a&gt;</code> where the entity
  +&amp;#160; represents non-breaking space.
  +</p>
  +
   </body>
   </document>