NAME

       HTML::Lint::Error - Error object for the Lint functionality

SYNOPSIS

       See HTML::Lint for all the gory details.

EXPORTS

       None.  It's all object-based.

METHODS

       Almost everything is an accessor.

Error types: "STRUCTURE", "HELPER", "FLUFF"

       Each error has a type.  Note that these roughly, but not exactly, go from most severe to
       least severe.

       •   "STRUCTURE"

           For problems that relate to the structural validity of the code.  Examples: Unclosed
           <TABLE> tags, incorrect values for attributes, and repeated attributes.

       •   "HELPER"

           Helpers are notes that will help you with your HTML, or that will help the browser
           render the code better or faster.  Example: Missing HEIGHT and WIDTH attributes in an
           IMG tag.

       •   "FLUFF"

           Fluff is for items that don't hurt your page, but don't help it either.  This is
           usually something like an unknown attribute on a tag.

   new()
       Create an object.  It's not very exciting.

   is_type( $type1 [, $type2 ] )
       Tells if any of $type1, $type2... match the error's type.  Returns the type that matched.

           if ( $err->is_type( HTML::Lint::Error::STRUCTURE ) ) {....

   where()
       Returns a formatted string that describes where in the file the error has occurred.

       For example,

           (14:23)

       for line 14, column 23.

       The terrible thing about this function is that it's both a plain ol' formatting function
       as in

           my $str = where( 14, 23 );

       AND it's an object method, as in:

           my $str = $error->where();

       I don't know what I was thinking when I set it up this way, but it's bad practice.

   as_string()
       Returns a nicely-formatted string for printing out to stdout or some similar user thing.

   file()
       Returns the filename of the error, as set by the caller.

   line()
       Returns the line number of the error.

   column()
       Returns the column number, starting from 0

   errcode()
       Returns the HTML::Lint error code.  Don't rely on this, because it will probably go away.

   errtext()
       Descriptive text of the error

   type()
       Type of the error

POSSIBLE ERRORS

       Each possible error in HTML::Lint has a code.  These codes are used to identify each error
       for when you need to turn off error checking for a specific error.

   config-unknown-directive
       Unknown directive "DIRECTIVE"

       You specified a directive in a comment for HTML::Lint that it didn't recognize.

   config-unknown-value
       Unknown value "VALUE" for DIRECTIVE directive

       Directive values can only be "on", "off", "yes", "no", "true", "false", "0" and "1".

   elem-unknown
       Unknown element <TAG>

       HTML::Lint doesn't know what a TAG tag is.  These are pulled from HTML::Entities

   elem-unopened
       </TAG> with no opening <TAG>

   elem-unclosed
       <TAG> at WHERE is never closed

   elem-empty-but-closed
       <TAG> is not a container -- </TAG> is not allowed

   elem-img-alt-missing
       <img src="FILENAME.PNG"> does not have ALT text defined

   elem-img-sizes-missing
       <img src="FILENAME.PNG"> tag has no HEIGHT and WIDTH attributes

   elem-nonrepeatable
       <TAG> is not repeatable, but already appeared at WHERE

   doc-tag-required
       <TAG> tag is required

   attr-repeated
       ATTR attribute in <TAG> is repeated

   attr-unknown
       Unknown attribute "ATTR" for tag <TAG>

   text-invalid-entity
       Entity ENTITY is invalid

   text-unclosed-entity
       Entity ENTITY is missing its closing semicolon

   text-unknown-entity
       Entity ENTITY is unknown

   text-use-entity
       Character "CHAR" should be written as ENTITY

COPYRIGHT & LICENSE

       Copyright 2005-2012 Andy Lester.

       This program is free software; you can redistribute it and/or modify it under the terms of
       the Artistic License v2.0.

       http://www.opensource.org/licenses/Artistic-2.0

AUTHOR

       Andy Lester, "andy at petdance.com"