Bug 34794

Summary: [patch] Documentation Primer uses deprecated HTML examples.
Product: Documentation Reporter: zak beam <phase5>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description zak beam 2002-02-10 16:40:01 UTC 
	The FreeBSD Documentation Primer makes use of the align attribute for
	the &lt;p&gt; tag in various examples. This attribute has been deprecated
	and should probably not be used. This doesn't generate any errors using
	HTML 4.01 Transitional however, so the need to change this may not be
	needed depending on your viewpoint. (though using Strict declares that
	no such attribute exists.)

Fix: 

Remove references to align attribute and possibly replace it with
	another example. However &lt;p&gt; is used as an example throughout
	this chapter so those references may need changing to remain consistent.
	If this is determined to be an issue and no-one else is keen to, I'm
	prepared to make the needed changes.
How-To-Repeat: 	View doc/en_US.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml
	online at http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/sgml-primer-elements.html
Comment 1 darklogik 2002-02-11 20:47:32 UTC 
I really do not want to come off as 'rude' but if you suply the word 
[patch], you should attach a patch.  Reading over the pr, I gather you 
have not simply missed the patch as you suggest making the changes 
yourself if noone wishes to undertake the task.  For future reference, 
please only specifiy [patch] when you plan on attaching one.

Let me also add that, many of us are very busy and any patch to the 
current documentation which makes it better would be very helpful. 
Thanks alot!

-- 
Tom (Darklogik) Rhodes
www.Pittgoth.com Gothic Liberation Front
www.FreeBSD.org  The Power To Serve
Comment 2 Murray Stokely freebsd_committer freebsd_triage 2002-03-13 08:09:55 UTC 
State Changed
From-To: open->closed

HTML 4.01 Transitional is very popular, and most of our own web pages 
use it.  Using this attribute in an example is not really a problem, 
unless you feel so strongly about this as to supply a high quality 
patch.  You will then of course need to come up with another element 
with an attribute for the sake of an example.  The text clearly 
describes the use of elements and attributes -- it is not a tutorial 
on writing HTML.  Thanks for the submission though!