From setantae@submonkey.net  Sun Jun  3 07:33:49 2001
Return-Path: <setantae@submonkey.net>
Received: from relay3-gui.server.ntli.net (relay3-gui.server.ntli.net [194.168.4.200])
	by hub.freebsd.org (Postfix) with ESMTP id C2A8337B401
	for <FreeBSD-gnats-submit@freebsd.org>; Sun,  3 Jun 2001 07:33:43 -0700 (PDT)
	(envelope-from setantae@submonkey.net)
Received: from m730-mp1-cvx1b.bri.ntl.com ([62.255.10.218] helo=rhadamanth.hounds)
	by relay3-gui.server.ntli.net with esmtp (Exim 3.03 #2)
	id 156YiT-0003WT-00
	for FreeBSD-gnats-submit@freebsd.org; Sun, 03 Jun 2001 15:18:54 +0100
Received: from setantae by rhadamanth.hounds with local (Exim 3.22 #1)
	id 156YxW-000ONZ-00
	for FreeBSD-gnats-submit@freebsd.org; Sun, 03 Jun 2001 15:34:26 +0100
Message-Id: <E156YxW-000ONZ-00@rhadamanth.hounds>
Date: Sun, 03 Jun 2001 15:34:27 +0100
From: setantae@submonkey.net
Sender: setantae <setantae@submonkey.net>
Reply-To: setantae@submonkey.net
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: Nested <a> elements in en_US.ISO_8859-1/books/fdp-primer/index.html
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         27854
>Category:       docs
>Synopsis:       Nested <a> elements in en_US.ISO_8859-1/books/fdp-primer/index.html
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    dd
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Jun 03 07:40:00 PDT 2001
>Closed-Date:    Sun Jun 3 22:04:31 PDT 2001
>Last-Modified:  Sun Jun 03 22:05:43 PDT 2001
>Originator:     setantae@submonkey.net
>Release:        FreeBSD 4.3-STABLE i386
>Organization:
>Environment:
System: FreeBSD rhadamanth.hounds 4.3-STABLE FreeBSD 4.3-STABLE #1: Mon May 28 22:04:16 BST 2001 root@rhadamanth.hounds:/usr/obj/usr/src/sys/RHADAMANTH i386


	
>Description:
	The FreeBSD Documentation Project Primer for New Contributors contents
	page contains nested <a> elements which causes confusion when parsed
	(both by myself and by Netscape :).

	The offending sections are items 3-6 and 3-7 in
	en_US.ISO_8859-1/books/fdp-primer/index.html - I include the relevant
	HTML below :

          <dt>3-6. <a href=
          "sgml-primer-elements.html#SGML-PRIMER-ENVARS"><tt class=
          "FILENAME">.profile</tt>, for <a href=
          "http://www.FreeBSD.org/cgi/man.cgi?query=sh&amp;sektion=1">
          <span class="CITEREFENTRY">sh(1)</span></a> and <a href=
          "http://www.FreeBSD.org/cgi/man.cgi?query=bash&amp;sektion=1">
          <span class="CITEREFENTRY">bash(1)</span></a>
          users</a></dt>

          <dt>3-7. <a href="sgml-primer-elements.html#AEN443"><tt
          class="FILENAME">.login</tt>, for <a href=
          "http://www.FreeBSD.org/cgi/man.cgi?query=csh&amp;sektion=1">
          <span class="CITEREFENTRY">csh(1)</span></a> and <a href=
          "http://www.FreeBSD.org/cgi/man.cgi?query=tcsh&amp;sektion=1">
          <span class="CITEREFENTRY">tcsh(1)</span></a>
          users</a></dt>

>How-To-Repeat:
	Visit http://www.FreeBSD.org/doc/en_US.ISO_8859-1/books/fdp-primer/index.html
	and view the source.

>Fix:
	I do not currently have the sources for doc/ installed, so cannot submit a
	patch, but the HTML should probably look like this instead :

          <dt>3-6. <a href=
          "sgml-primer-elements.html#SGML-PRIMER-ENVARS"><tt class=
          "FILENAME">.profile</tt></a>, for <a href=
          "http://www.FreeBSD.org/cgi/man.cgi?query=sh&amp;sektion=1">
          <span class="CITEREFENTRY">sh(1)</span></a> and <a href=
          "http://www.FreeBSD.org/cgi/man.cgi?query=bash&amp;sektion=1">
          <span class="CITEREFENTRY">bash(1)</span></a>
          users</dt>

          <dt>3-7. <a href="sgml-primer-elements.html#AEN443"><tt
          class="FILENAME">.login</tt></a>, for <a href=
          "http://www.FreeBSD.org/cgi/man.cgi?query=csh&amp;sektion=1">
          <span class="CITEREFENTRY">csh(1)</span></a> and <a href=
          "http://www.FreeBSD.org/cgi/man.cgi?query=tcsh&amp;sektion=1">
          <span class="CITEREFENTRY">tcsh(1)</span></a>
          users</dt>

	I'm still reading the Primer and am still not quite sure what the DocBook
	would look like.  Sorry.
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->dd 
Responsible-Changed-By: alex 
Responsible-Changed-When: Sun Jun 3 07:42:18 PDT 2001 
Responsible-Changed-Why:  
dd is working on this 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=27854 
State-Changed-From-To: open->closed 
State-Changed-By: dd 
State-Changed-When: Sun Jun 3 22:04:31 PDT 2001 
State-Changed-Why:  
Actually, this is already fixed.  I committed the necessary changes to 
the stylesheets yesterday.  It will take effect on the main website 
when either the document in question is modified, or the next time the 
build scripts do a `make clean`. 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=27854 
>Unformatted:
