Permalink
Browse files

The -dtd argument to start_html() is now documented

  (RT#60473, Thanks to giecrilj and steve@fisharerojo.org)
  • Loading branch information...
1 parent 1c78301 commit d955d47b0ad30e025c7678de8d33dc6ac1a7dbaf @markstos committed Nov 20, 2010
Showing with 14 additions and 0 deletions.
  1. +2 −0 Changes
  2. +12 −0 lib/CGI.pm
View
@@ -6,6 +6,8 @@
[DOCUMENTATION]
- quit referring to the <link> tag as being "rarely used". (Victor Sanders)
- typo and whitespace fixes (RT#62785, thanks to scop@cpan.org)
+ - The -dtd argument to start_html() is now documented
+ (RT#60473, Thanks to giecrilj and steve@fisharerojo.org)
[INTERNALS]
- Re-fixing https test in http.t. (RT#54768, thanks to SPROUT)
View
@@ -5412,6 +5412,18 @@ off in other cases by passing an empty string (-lang=>'').
The B<-encoding> argument can be used to specify the character set for
XHTML. It defaults to iso-8859-1 if not specified.
+The B<-dtd> argument can be used to specify a public DTD identifier string. For example:
+
+ -dtd => '-//W3C//DTD HTML 4.01 Transitional//EN')
+
+Alternatively, it can take public and system DTD identifiers as an array:
+
+ dtd => [ '-//W3C//DTD HTML 4.01 Transitional//EN', 'http://www.w3.org/TR/html4/loose.dtd' ]
+
+For the public DTD identifier to be considered, it must be valid. Otherwise it
+will be replaced by the default DTD. If the public DTD contains 'XHTML', CGI.pm
+will emit XML.
+
The B<-declare_xml> argument, when used in conjunction with XHTML,
will put a <?xml> declaration at the top of the HTML header. The sole
purpose of this declaration is to declare the character set

0 comments on commit d955d47

Please sign in to comment.