Changes

Jump to navigation Jump to search
Line 62: Line 62:  
* None of our methods are exported and must be called using indirect notation, whereas CGI.pm can export any of it’s methods.
 
* None of our methods are exported and must be called using indirect notation, whereas CGI.pm can export any of it’s methods.
   −
* start_html() doesn’t support all the same arguments, but those that do have the same names.  However, the effects of the missing arguments can be easily replicated by making the appropriate tags
+
* start_html() doesn’t support all the same arguments, but those that do have the same names.  However, the effects of the missing arguments can be easily replicated by making the appropriate tags explicitly and handing them in via either the "head" or "body" arguments, where appropriate.  The common arguments are [’title’, ’author’, ’meta’, ’style’, ’head’, ’body’], in that order.
          explicitely and handing them in via either the "head" or "body" arguments, where appropriate.  The common arguments are [’title’, ’author’, ’meta’, ’style’, ’head’, ’body’], in that order.
     −
* Our textarea() method is autoloaded, and doesn’t have the special symantecs that CGI.pm’s textarea() does.  However, any module who subclasses from this one can override textarea() with one that
+
* Our textarea() method is autoloaded, and doesn’t have the special symantecs that CGI.pm’s textarea() does.  However, any module who subclasses from this one can override textarea() with one that matches CGI.pm’s symantecs.  The "HTML::FormMaker" module does this.
          matches CGI.pm’s symantecs.  The "HTML::FormMaker" module does this.
      
* Autoloaded methods do not use the presence or absense of arguments to decide whether to make the new tag as a pair or as "start only".
 
* Autoloaded methods do not use the presence or absense of arguments to decide whether to make the new tag as a pair or as "start only".
Line 72: Line 70:  
* Autoloaded methods that make html tags won’t concatenate their arguments into a single argument under any circumstances, but in some cases the "shortcuts" of CGI.pm will do so.
 
* Autoloaded methods that make html tags won’t concatenate their arguments into a single argument under any circumstances, but in some cases the "shortcuts" of CGI.pm will do so.
   −
* Currently we don’t html-escape any argument values passed to our tag making functions, whereas CGI.pm sometimes does.  While we expect our caller to do the escaping themselves where necessary,
+
* Currently we don’t html-escape any argument values passed to our tag making functions, whereas CGI.pm sometimes does.  While we expect our caller to do the escaping themselves where necessary, we may do it later in an update.
          we may do it later in an update.
     −
* We go further to make the generated HTML human-readable by: 1. having each new tag start on a new line; 2. making all tag and attribute names uppercase; 3.  ensuring that about 20 often-used tag
+
* We go further to make the generated HTML human-readable by: 1. having each new tag start on a new line; 2. making all tag and attribute names uppercase; 3.  ensuring that about 20 often-used tag attributes always appear in the same order (eg: ’type’ is before ’name’ is before ’value’), and before any others.
          attributes always appear in the same order (eg: ’type’ is before ’name’ is before ’value’), and before any others.
      
=== COPYING ===
 
=== COPYING ===

Navigation menu