Bug 27854

Summary: Nested <a> elements in en_US.ISO_8859-1/books/fdp-primer/index.html
Product: Documentation Reporter: setantae <setantae>
Component: Books & ArticlesAssignee: dd <dd>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description setantae 2001-06-03 15:40:00 UTC
	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>

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.
How-To-Repeat: 	Visit http://www.FreeBSD.org/doc/en_US.ISO_8859-1/books/fdp-primer/index.html
	and view the source.
Comment 1 alex freebsd_committer freebsd_triage 2001-06-03 15:42:18 UTC
Responsible Changed
From-To: freebsd-doc->dd

dd is working on this
Comment 2 dd freebsd_committer freebsd_triage 2001-06-04 06:04:31 UTC
State Changed
From-To: open->closed

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`.