weblint-1.005/000755 002126 000322 00000000000 05664163044 013625 5ustar00neilbkgroup000000 000000 weblint-1.005/Artistic000644 002126 000322 00000013736 05651102016 015330 0ustar00neilbkgroup000000 000000 The "Artistic License" Preamble The intent of this document is to state the conditions under which a Package may be copied, such that the Copyright Holder maintains some semblance of artistic control over the development of the package, while giving the users of the package the right to use and distribute the Package in a more-or-less customary fashion, plus the right to make reasonable modifications. Definitions: "Package" refers to the collection of files distributed by the Copyright Holder, and derivatives of that collection of files created through textual modification. "Standard Version" refers to such a Package if it has not been modified, or has been modified in accordance with the wishes of the Copyright Holder as specified below. "Copyright Holder" is whoever is named in the copyright or copyrights for the package. "You" is you, if you're thinking about copying or distributing this Package. "Reasonable copying fee" is whatever you can justify on the basis of media cost, duplication charges, time of people involved, and so on. (You will not be required to justify it to the Copyright Holder, but only to the computing community at large as a market that must bear the fee.) "Freely Available" means that no fee is charged for the item itself, though there may be fees involved in handling the item. It also means that recipients of the item may redistribute it under the same conditions they received it. 1. You may make and give away verbatim copies of the source form of the Standard Version of this Package without restriction, provided that you duplicate all of the original copyright notices and associated disclaimers. 2. You may apply bug fixes, portability fixes and other modifications derived from the Public Domain or from the Copyright Holder. A Package modified in such a way shall still be considered the Standard Version. 3. You may otherwise modify your copy of this Package in any way, provided that you insert a prominent notice in each changed file stating how and when you changed that file, and provided that you do at least ONE of the following: a) place your modifications in the Public Domain or otherwise make them Freely Available, such as by posting said modifications to Usenet or an equivalent medium, or placing the modifications on a major archive site such as uunet.uu.net, or by allowing the Copyright Holder to include your modifications in the Standard Version of the Package. b) use the modified Package only within your corporation or organization. c) rename any non-standard executables so the names do not conflict with standard executables, which must also be provided, and provide a separate manual page for each non-standard executable that clearly documents how it differs from the Standard Version. d) make other distribution arrangements with the Copyright Holder. 4. You may distribute the programs of this Package in object code or executable form, provided that you do at least ONE of the following: a) distribute a Standard Version of the executables and library files, together with instructions (in the manual page or equivalent) on where to get the Standard Version. b) accompany the distribution with the machine-readable source of the Package with your modifications. c) give non-standard executables non-standard names, and clearly document the differences in manual pages (or equivalent), together with instructions on where to get the Standard Version. d) make other distribution arrangements with the Copyright Holder. 5. You may charge a reasonable copying fee for any distribution of this Package. You may charge any fee you choose for support of this Package. You may not charge a fee for this Package itself. However, you may distribute this Package in aggregate with other (possibly commercial) programs as part of a larger (possibly commercial) software distribution provided that you do not advertise this Package as a product of your own. You may embed this Package's interpreter within an executable of yours (by linking); this shall be construed as a mere form of aggregation, provided that the complete Standard Version of the interpreter is so embedded. 6. The scripts and library files supplied as input to or produced as output from the programs of this Package do not automatically fall under the copyright of this Package, but belong to whomever generated them, and may be sold commercially, and may be aggregated with this Package. If such scripts or library files are aggregated with this Package via the so-called "undump" or "unexec" methods of producing a binary executable image, then distribution of such an image shall neither be construed as a distribution of this Package nor shall it fall under the restrictions of Paragraphs 3 and 4, provided that you do not represent such an executable image as a Standard Version of this Package. 7. C subroutines (or comparably compiled subroutines in other languages) supplied by you and linked into this Package in order to emulate subroutines and variables of the language defined by this Package shall not be considered part of this Package, but are the equivalent of input as in Paragraph 6, provided these subroutines do not change the language in any way that would cause it to fail the regression tests for the language. 8. Aggregation of this Package with a commercial distribution is always permitted provided that the use of this Package is embedded; that is, when no overt attempt is made to make this Package's interfaces visible to the end user of the commercial distribution. Such use shall not be construed as a distribution of this Package. 9. The name of the Copyright Holder may not be used to endorse or promote products derived from this software without specific prior written permission. 10. THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE. The End weblint-1.005/weblint000755 002126 000322 00000060405 05664162574 015233 0ustar00neilbkgroup000000 000000 : # use perl eval 'exec perl -S $0 "$@"' if $runnning_under_some_shell; # # weblint - pick fluff off WWW pages (html). # # Copyright (C) 1994 Neil Bowers. All rights reserved. # # See README for additional blurb. # Bugs, comments, suggestions welcome: neilb@khoros.unm.edu # $VERSION = '1.005'; ($PROGRAM = $0) =~ s@.*/@@; $LEADER = '$filename($.)'; #------------------------------------------------------------------------ # $usage - usage string displayed with the -U command-line switch #------------------------------------------------------------------------ $usage=<, and ". (Barry Bakalor ) o Make the code more efficient. o Generalize the context checks. o check for http://foo.com/nar/tar.gz! o option to spell-check text (Clay Webster ) o option to specify level of HTML (0, 1, or 2) o support the 'mixed-case' identifier. (reported by Victor Parada ) o support

as a container, at least optionally. o option to understand server-side includes, e.g.: o write a regression testsuite! o catch: & should be & & should be & " should be " " should be " o option to specify whether messages go to stdout or stderr o bad-link check gets confused if given a path with directories in it, such as foo/bar/fred.html (Barry Bakalor) o Use a DTD! EofToDo $pairElements = 'HTML|HEAD|BODY|TITLE|H1|H2|H3|H4|H5|H6|'. 'B|I|U|TT|STRONG|EM|CODE|KBD|VAR|DFN|CITE|SAMP|'. 'UL|OL|DL|MENU|DIR|FORM|SELECT|STRIKE|TEXTAREA|'. 'BLOCKQUOTE|ADDRESS|A|CODE|PRE'; # expect to see these tags only once $onceOnlyRE = 'HTML|HEAD|BODY|TITLE'; # expect these tags to have attributes # these are elements which have no required attributes, but we expect to # see at least one of the attributes $expectArgsRE = 'A'; # these tags can only appear in the head element $headTagsRE = 'TITLE|NEXTID|LINK|BASE'; # these tags are allowed to appear in the head element $okInHead = 'ISINDEX|TITLE|NEXTID|LINK|BASE|!--'; # obsolete tags $obsoleteTags = 'PLAINTEXT|XMP|LISTING|COMMENT'; # expect to see these at least once. @expectedTags = ('HTML', 'HEAD', 'TITLE', 'BODY'); # elements which cannot be nested $nonNest = 'A'; # elements which can only appear in a FORM element $formElements = 'INPUT|SELECT|TEXTAREA'; # # This is a regular expression for all regular elements # $legalElements = 'A|ADDRESS|B|BASE|BLOCKQUOTE|BODY|BR|CITE|CODE|DD|DFN|DIR|DL|DT|EM|'. 'FORM|H1|H2|H3|H4|H5|H6|HEAD|HR|HTML|I|IMG|INPUT|ISINDEX|KBD|LI|'. 'LINK|MENU|META|NEXTID|OL|OPTION|P|PRE|SAMP|SELECT|STRIKE|STRONG|TEXTAREA|'. 'TITLE|TT|U|UL|VAR'; # This table holds the valid attributes for elements # Where an element does not have an entry, this implies that the element # does not take any atttributes %validAttributes = ( 'A', 'NAME|HREF|REL|REV|URN|TITLE|METHODS', 'BASE', 'HREF', 'DL', 'COMPACT', 'FORM', 'ACTION|METHOD|ENCTYPE', 'HTML', 'VERSION', 'IMG', 'SRC|ALT|ALIGN|ISMAP', 'INPUT', 'TYPE|NAME|VALUE|SRC|CHECKED|SIZE|MAXLENGTH|ALIGN', 'LINK', 'HREF|REL|REV|URN|TITLE|METHODS', 'META', 'HTTP-EQUIV|NAME|CONTENT', 'NEXTID', 'N', 'OPTION', 'SELECTED|VALUE', 'PRE', 'WIDTH', 'SELECT', 'NAME|SIZE|MULTIPLE', 'TEXTAREA', 'NAME|ROWS|COLS', 'UL', 'COMPACT', ); %requiredAttributes = ( 'BASE', 'HREF', 'FORM', 'ACTION', 'IMG', 'SRC', 'LINK', 'HREF', 'NEXTID', 'N', 'SELECT', 'NAME', 'TEXTAREA', 'NAME|ROWS|COLS' ); require 'getopts.pl'; require 'find.pl'; die "$usage" unless @ARGV > 0; &ReadDefaults(); &GetConfigFile(); &Getopts('d:e:RsTUvx:') || die "use -U switch to display usage statement\n"; die "$PROGRAM v$VERSION\n" if $opt_v; die "$usage" if $opt_U; die "$todo" if $opt_T; &AddExtension($opt_x) if $opt_x; $LEADER = 'line $.' if $opt_s; # -d to disable warnings if ($opt_d) { for (split(/,/,$opt_d)) { warn "$PROGRAM: unknown warning `$_'\n" unless defined $enabled{$_}; $enabled{$_} = 0; } } # -e to enable warnings if ($opt_e) { for (split(/,/,$opt_e)) { warn "$PROGRAM: unknown warning `$_'\n" unless defined $enabled{$_}; $enabled{$_} = 1; $enabled{'lower-case'} = 0 if $_ eq 'upper-case'; $enabled{'upper-case'} = 0 if $_ eq 'lower-case'; $enabled{'upper-case'} = $enabled{'lower-case'} = 0 if $_ eq 'mixed-case'; } } # -R switch, so use find on command-line arguments if ($opt_R) { push(@ARGV, '.') if @ARGV == 0; &find(shift(@ARGV)) while @ARGV > 0; exit 0; } &WebLint(shift(@ARGV)) while @ARGV > 0; exit 0; #======================================================================== # Function: WebLint # Purpose: This is the high-level interface to the checker. It takes # a file and checks for fluff. #======================================================================== sub WebLint { local($filename,$relpath) = @_; local(@tags) = (); local($tagRE) = (''); local(@taglines) = (); local(@orphans) = (); local(@orphanlines) = (); local(%seenPage); local(%seenTag); local(%whined); local(*PAGE); local($line) = (''); local($id); local($tag); local($closing); local($tail); local(%args); local($arg); local($rest); local($lastNonTag); local(@notSeen); local($seenMailtoLink) = (0); local($matched); local($matchedLine); local($novalue); local($heading); local($headingLine); local($_); if ($filename eq '-') { *PAGE = *STDIN; $filename = 'stdin'; } else { return if defined $seenPage{$filename}; if (-d $filename) { print "$PROGRAM: $filename is a directory.\n"; return; } $seenPage{$filename}++; open(PAGE,"<$filename") || do { print "$PROGRAM: could not read file $filename: $!\n"; return; }; $filename = $relpath if defined $relpath; } undef $heading; READLINE: while () { $line .= $_; $line =~ s/\n/ /g; while ($line =~ / #-------------------------------------------------------- if ($tail =~ /^!--/) { # push lastNonTag onto word list for spell checking $ct = $'; next READLINE unless $ct =~ /--\s*>/; $comment = $`; $line = $'; # markup embedded in comment can confuse some (most? :-) browsers &whine('markup-in-comment') if $comment =~ /<\s*[^>]+>/; next; } next READLINE unless $tail =~ /^(\s*)([^>]+)>/; &whine('leading-whitespace', $2) if $1 ne ''; $id = $tag = $2; $line = $'; # push lastNonTag onto word list for spell checking undef $tail; undef $closing; undef %args; #-- is ignored for now. next if $id =~ /^!doctype/i; #-------------------------------------------------------- #== some seriously ugly code to handle attributes ... #-------------------------------------------------------- if ($tag =~ m|^(\S+)\s+(.*)|) { ($id,$tail) = ($1,$2); $tail =~ s/\n/ /g; # check for odd number of quote characters ($quotes = $tail) =~ s/[^"]//g; &whine('odd-quotes', $tag) if length($quotes) % 2 == 1; $novalue = 0; $valid = $validAttributes{"\U$id"}; while ($tail =~ /^\s*([^=\s]+)\s*=\s*(.*)$/ # catch attributes like ISMAP for IMG, with no arg || ($tail =~ /^\s*(\S+)\s+(.*)/ && ($novalue = 1))) { $arg = "\U$1"; $rest = $2; &whine('unexpected-open', $tag) if $arg =~ / element in HEAD? &whine('mailto-link') if $id eq 'HEAD' && $seenMailtoLink == 0; } else { #-------------------------------------------------------- # do context checks. Should really be a state machine. #-------------------------------------------------------- if ($id eq 'A' && defined $args{'HREF'}) { $target = $args{'HREF'}; if ($target =~ /([^:]+):\/\/([^\/]+)(.*)$/ || $target =~ /^(news|mailto):/ || $target =~ /^\//) { } else { $target =~ s/#.*$//; if ($target !~ /^\s*$/ && ! -f $target && ! -d $target) { &whine('bad-link', $target); } } } if ($id =~ /^H(\d)$/) { if (defined $heading && $1 - $heading > 1) { &whine('heading-order', $id, $heading, $headingLine); } $heading = $1; $headingLine = $.; } #-- check for mailto: LINK ------------------------------ if ($id eq 'LINK' && $args{'REV'} =~ /^made$/i && $args{'HREF'} =~ /^mailto:/i) { $seenMailtoLink = 1; } if ($id =~ /^($onceOnlyRE)$/) { &whine('once-only', $id, $seenTag{$id}) if $seenTag{$id}; } $seenTag{$id} = $.; &whine('body-no-head') if $id eq 'BODY' && !$seenTag{'HEAD'}; if ($id ne 'HTML' && $id ne '!DOCTYPE' && !$seenTag{'HTML'} && !$whined{'outer-html'}) { &whine('html-outer'); $whined{'outer-html'} = 1; } #-- check for illegally nested elements --------------------- if ($id =~ /^($nonNest)$/ && $id =~ /^($tagRE)$/) { for ($i=$#tags; $tags[$i] ne $id; --$i) {} &whine('nested-element', $id, $taglines[$i]); } &whine('unknown-element', $id) unless $id =~ /^($legalElements)$/; #-- check for elements which can only appear in a FORM element if ($id =~ /^($formElements)$/ && 'FORM' !~ /^($tagRE)$/) { &whine('form-item', $id); } #-- check for elements which can only appear in a FORM element if ($id =~ 'OPTION' && 'SELECT' !~ /^($tagRE)$/) { &whine('select-option'); } #-------------------------------------------------------- # check for tags which can only appear in the HEAD element #-------------------------------------------------------- if ($id =~ /^($headTagsRE)$/ && 'HEAD' !~ /^($tagRE)$/) { &whine('head-element', $id); } if ($id !~ /^($okInHead)$/ && 'HEAD' =~ /^($tagRE)$/) { &whine('non-head-element', $id); } #-------------------------------------------------------- # DT and DD can only appear in definition list (

..
#-------------------------------------------------------- if (($id eq 'DT' || $id eq 'DD') && 'DL' !~ /^($tagRE)$/) { &whine('defn-list-elements', $id); } #-------------------------------------------------------- # LI can only appear in DIR, MENU, OL, UL #-------------------------------------------------------- if ($id eq 'LI' && " @tags " !~ / (DIR|MENU|OL|UL) /) { &whine('list-item'); } #-------------------------------------------------------- # check for tags which can only appear in the HEAD element #-------------------------------------------------------- &whine('obsolete', $id) if $id =~ /^($obsoleteTags)$/; } #-------------------------------------------------------- #== was tag of type ... ? #== welcome to kludgeville, population seems to be on the increase! #-------------------------------------------------------- if ($id =~ /^($pairElements)$/) { if ($closing && $tags[$#tags] eq $id) { $matched = pop @tags; $matchedLine = pop @taglines; #-- does top of stack match top of orphans stack? -------- while (@orphans > 0 && @tags > 0 && $orphans[$#orphans] eq $tags[$#tags]) { &whine('element-overlap', $orphans[$#orphans], $orphanlines[$#orphanlines], $matched, $matchedLine); pop @orphans; pop @orphanlines; pop @tags; pop @taglines; } $tagRE = join('|',@tags); } elsif ($closing && $tags[$#tags] ne $id) { #-- closing tag does not match opening tag on top of stack if ($id =~ /^($tagRE)$/) { # If we saw , , or , then we try # and resolve anything inbetween on the tag stack if ($id =~ /^(HTML|HEAD|BODY)$/) { while ($tags[$#tags] ne $id) { &whine('unclosed-element',pop @tags,pop @taglines); #-- does top of stack match top of orphans stack? -- while (@orphans > 0 && @tags > 0 && $orphans[$#orphans] eq $tags[$#tags]) { pop @orphans; pop @orphanlines; pop @tags; pop @taglines; } } #-- pop off the HTML, HEAD, or BODY tag ------------ pop @tags; pop @taglines; $tagRE = join('|',@tags); } else { #-- matched opening tag lower down on stack push(@orphans, $id); push(@orphanlines, $.); } } else { &whine('mis-match', $id); } } else { push(@tags,$id); $tagRE = join('|',@tags); push(@taglines,$.); } } #-------------------------------------------------------- #== inline images (IMG) should have an ALT argument :-) #-------------------------------------------------------- &whine('img-alt') if $id eq 'IMG' && !defined $args{'ALT'}; } $lastNonTag = $line unless $line =~ /^\s*$/; } close PAGE; while (@tags > 0) { $tag = shift(@tags); $line = shift(@taglines); &whine('unclosed-element', $tag, $line); } for (@expectedTags) { push(@notSeen,$_) unless $seenTag{$_}; } printf("%sexpected tag(s) not seen: @notSeen\n", ($opt_s ? "" : "$filename(-): ")) if @notSeen > 0; } #======================================================================== # Function: whine # Purpose: Give a standard format whine: # filename(line #): # The associative array `enabled' is used as a gating # function, to suppress or enable each warning. Every # warning has an associated identifier, which is used to # refer to the warning, and as the index into the hash. #======================================================================== sub whine { local($id,@argv) = @_; return unless $enabled{$id}; eval "print \"$LEADER: $message{$id}\n\""; } #======================================================================== # Function: GetConfigFile # Purpose: Read user's configuration file, if such exists. # If WEBLINTRC is set in user's environment, then read the # file referenced, otherwise try for $HOME/.weblintrc. #======================================================================== sub GetConfigFile { local(*CONFIG); local($filename); local($arglist); $filename = $ENV{'WEBLINTRC'} || "$ENV{'HOME'}/.weblintrc"; return unless -f $filename; open(CONFIG,"< $filename") || do { print "Unable to read config file `$filename': $!\n"; return 0; }; while () { s/#.*$//; next if /^\s*$/; #-- match keyword: process one or more argument ------------------- if (/^\s*(enable|disable|extension)\s+(.*)$/i) { $keyword = "\U$1"; $arglist = $2; while ($arglist =~ /^\s*(\S+)/) { $enabled{$1} = 1 if $keyword eq 'ENABLE'; $enabled{$1} = 0 if $keyword eq 'DISABLE'; &AddExtension($1) if $keyword eq 'EXTENSION'; $arglist = $'; } } } close CONFIG; 1; } #======================================================================== # Function: AddExtension # Purpose: Extend the HTML understood. Currently supported extensions: # netscape - the netscape extensions proposed by # Mosaic Communications, Inc. See: # http://mosaic.mcom.com/home/services_docs/html-extensions.html #======================================================================== sub AddExtension { local($extension) = @_; if ("\L$extension" ne 'netscape') { warn "$PROGRAM: unknown extension `$extension' -- ignoring.\n"; return; } #--------------------------------------------------------------------- # netscape extensions #--------------------------------------------------------------------- #-- new element attributes for existing elements --------------------- &AddAttributes('ISINDEX', 'PROMPT'); &AddAttributes('HR', 'SIZE', 'SIZE', 'ALIGN', 'NOSHADE'); &AddAttributes('UL', 'TYPE'); &AddAttributes('OL', 'TYPE'); &AddAttributes('LI', 'TYPE'); &AddAttributes('IMG', 'WIDTH', 'HEIGHT', 'BORDER', 'VSPACE', 'HSPACE'); &AddAttributes('BR', 'CLEAR'); #-- new elements ----------------------------------------------------- $legalElements .= 'NOBR|WBR|FONT|BASEFONT|CENTER'; $pairElements .= '|CENTER|NOBR'; &AddAttributes('FONT', 'SIZE'); &AddAttributes('BASEFONT', 'SIZE'); } sub AddAttributes { local($element,@attributes) = @_; local($attr); $attr = join('|', @attributes); if (defined $validAttributes{$element}) { $validAttributes{$element} .= "|$attr"; } else { $validAttributes{$element} = "$attr"; } } #======================================================================== # Function: wanted # Purpose: This is called by &find() to determined whether a file # is wanted. We're looking for files, with the filename # extension .html or .htm. #======================================================================== sub wanted { /\.(html|htm)$/ && -f $_ && &WebLint($_,$name); } #======================================================================== # Function: ReadDefaults # Purpose: Read the built-in defaults. These are stored at the end # of the script, after the __END__, and read from the # DATA filehandle. #======================================================================== sub ReadDefaults { while () { next if /^$/; ($id,$default,$message) = m|^([^:]+):([^:]+):(.*)$|g; $enabled{$id} = ($default eq 'ENABLE'); ($message{$id} = $3) =~ s/"/\\"/g; } } __END__ upper-case:DISABLE:tag <$argv[0]> is not in upper case. lower-case:DISABLE:tag <$argv[0]> is not in lower case. mixed-case:ENABLE: here-anchor:ENABLE:bad form to use `here' as an anchor! require-head:ENABLE:no in HEAD element. once-only:ENABLE:tag <$argv[0]> should only appear once. I saw one on line $argv[1]! body-no-head:ENABLE:<BODY> but no <HEAD>. html-outer:ENABLE:outer tags should be <HTML> .. </HTML>. head-element:ENABLE:<$argv[0]> can only appear in the HEAD element. non-head-element:ENABLE:<$argv[0]> cannot appear in the HEAD element. list-item:ENABLE:<LI> can only appear in DIR, MENU, OL or UL elements. obsolete:ENABLE:<$argv[0]> is obsolete. mis-match:ENABLE:unmatched </$argv[0]> (no matching <$argv[0]> seen). img-alt:ENABLE:IMG does not have ALT text defined. nested-element:ENABLE:<$argv[0]> cannot be nested -- </$argv[0]> not yet seen for <$argv[0]> on line $argv[1]. defn-list-elements:ENABLE:<$argv[0]> can only be used in definition list (<DL>..</DL>). form-item:ENABLE:<$argv[0]> can only appear in a FORM element. select-option:ENABLE:<OPTION> can only appear within a SELECT element. mailto-link:DISABLE:Did not see <LINK REV=MADE HREF="mailto:..."> in HEAD. element-overlap:ENABLE:</$argv[0]> on line $argv[1] seems to overlap <$argv[2]>, opened on line $argv[3]. unclosed-element:ENABLE:No closing </$argv[0]> seen for <$argv[0]> on line $argv[1]. markup-in-comment:ENABLE:Markup embedded in a comment can confuse some browsers. unknown-attribute:ENABLE:Unknown attribute "$argv[1]" for element <$argv[0]>. leading-whitespace:ENABLE:Should not have whitespace between "<" and "$argv[0]>". required-attribute:ENABLE:$argv[0] attribute is required for <$argv[1]>. unknown-element:ENABLE:unknown element <$argv[0]>. odd-quotes:ENABLE:odd number of quotes in element <$argv[0]>. heading-order:ENABLE:heading <$argv[0]> follows <H$argv[1]> on line $argv[2]. bad-link:DISABLE:target for anchor "$argv[0]" not found. expected-attribute:ENABLE:expected an attribute for <$argv[0]>. unexpected-open:ENABLE:unexpected < in <$argv[0]> -- potentially unclosed element. } #-------------------------------------------------------- # DT and DD can only appear in definition list (<DL> .. </DL> #-------------------------------------------------------- if (($id eq 'DT' || $id eq 'DD') && 'DL' !~ /weblint-1.005/README��������������������������������������������������������������������������������000644 �002126 �000322 �00000006345 05663514662 014522� 0����������������������������������������������������������������������������������������������������ustar�00neilb���������������������������kgroup��������������������������000000 �000000 ������������������������������������������������������������������������������������������������������������������������������������������������������������������������ Weblint, Version 1.005 Copyright (c) 1994 Neil Bowers. All rights reserved. Khoral Research, Inc. This program is free software; you can redistribute it and/or modify it under the terms of the "Artistic License". You should have received a copy of the Artistic License with this distribution, in the file named "Artistic". If not, I'll be glad to provide one. -------------------------------------------------------------------------- Weblint is a perl script which checks html pages for the World-Wide Web. Files to be checked are passed on the command-line: % weblint *.html Warnings are generated a la lint -- <filename>(line #): <warning>. E.g.: home.html(9): unmatched </H2> (seems to match <H1> on line 8) The following checks are currently performed: * basic structure * unknown elements and element attributes. * context checks (where a tag must appear within a certain element). * overlapped elements. * expects to see a TITLE in the HEAD element. * do IMG elements have ALT text? * illegally nested elements. * mis-matched tags (e.g., <H1> ... </H2>) * unclosed elements (e.g., <H1> ... ) * catches elements which should only appear once * flags obsolete elements. * odd number of quotes in tag. * order of headings. * potentially unclosed tags. * flags markup embedded in comments --- this can confuse some browsers. * whines if you use `here' as anchor text :-) * tags where attributes are expected (e.g. anchors). * existence of local anchor targets. * flag case of tags (not enabled by default). * expect a <LINK REV=MADE HREF=mailto:...> in HEAD element (not enabled by default). All warnings can be enabled or disabled, using a configuration file, $HOME/.weblintrc. A sample configuration file, weblintrc, is included in the distribution. -------------------------------------------------------------------------- Installation A simple Makefile is provided, in which you may want to modify BINDIR and MANDIR, which specify where the weblint script and manpage should be installed. Weblint uses the `getopts.pl' and `find.pl' libraries, which are part of the standard perl library, so this will hopefully not cause any problems. Please let me know if it does. The manpage (weblint.1) should be installed in a directory where it will be picked up by man (e.g., /usr/local/man/man1 on our machines). A postscript version of the manpage (weblint.ps) is included in this distribution. Weblint is available via anonymous ftp from ftp.khoros.unm.edu, in /pub/perl/www/weblint-1.005.tar.gz, or you can get it from the weblint home page: http://www.khoros.unm.edu/staff/neilb/weblint.html -------------------------------------------------------------------------- I hope you find this useful. Comments, suggestions and bug reports are welcome, see my email address or home page, given below. Sample html helps when tracking down problems. I maintain an email list, weblint-victims@khoros.unm.edu, which I will mail announcements to whenever a new version of weblint is released. Email me if you want to be added to this list. Neil Bowers Khoral Research, Inc. <neilb@khoros.unm.edu> http://www.khoros.unm.edu/staff/neilb/ whine('element-overlap', $orphans[$#orphans], $orphanlines[$#orphanlines], $matched, $matchedLine); pop @orphans; pop @orphanlines; pop @tags; pop @taglines; } $tagRE = join('|',@tags); } elsif ($closing && $tags[$#tweblint-1.005/ChangeLog�����������������������������������������������������������������������������000644 �002126 �000322 �00000026235 05664162766 015421� 0����������������������������������������������������������������������������������������������������ustar�00neilb���������������������������kgroup��������������������������000000 �000000 ������������������������������������������������������������������������������������������������������������������������������������������������������������������������ ChangeLog for WebLint 1.005 21-nov-94 neilb * Fixed bug whereby unknown tags were always given as </...>, whether they were opening or closing tags. (reported by Larry Virden <lvirden@cas.org>) 20-nov-94 neilb * Giving the -R switch with no files/directories specified now defaults to `.', the current directory. (suggested by Barry Bakalor <barry@hal.com>) * Fixed bug whereby required attributes were being checked on closing tags as well as opening tags. (reported by Barry Bakalor <barry@hal.com>) * Fixed bugs in `bad-link' check for non-existent targets: - mailto: - news: - directories - absolute paths, eg cgi-scripts (HREF="/cgi-bin/foo") (reported by Barry Bakalor <barry@hal.com>) * Fixed typos in weblintrc. (reported by Barry Bakalor <barry@hal.com>) 1.004 19-nov-94 neilb * Added an Announce file to distribution, which contains verbose announcement for the current version, listing all new warnings and their identifiers. * First attempt at check for potentially unclosed elements --- checking for: < ... < ... > for example: <A HREF="..." anchor text</A> Warning has identifier `unexpected-open'. This might not catch all cases at the moment, since I didn't want it to generate bogus warnings where < appears in an attribute value (eg ALT="<-"). * Changed the 'expected-attribute' identifier to 'required-attribute', and added a warning with identifier 'expected-attribute'. This is for elements which have no *required* attributes, but for which you expect to see at least one attribute, such as anchors. * Added a Makefile, with targets for install, preview, tar, clean, and a postscript version of the man page. (suggested by Richard Lloyd <R.K.Lloyd@csc.liv.ac.uk>) 18-nov-94 neilb * Added support for `proposed' items: REL and REV attributes of anchors, META, DFN, STRIKE, and U. (noted by Robert Schmunk <pcrxs@nasagiss.giss.nasa.gov>) 17-nov-94 neilb * Added a check for relative local links, to generate a warning if the target does not exist. Warning identifier: bad-link * Added -d and -e switches to enable and disable warnings. The argument can be one or more warning identifiers, with multiple identifiers separated with commas. For example: weblint -e upper-case foo.html A pseudo identifier `mixed-case' is now supported: weblint -e mixed-case foo.html Turns off upper-case and lower-case checking. * Warning added for heading which is more than one level deeper than the most recent heading. I.e. <H1> followed by <H3> results in warning, with identifier 'heading-order'. (suggested by Bill Arnett <billa@netcom.com>) 16-nov-94 neilb * Changed the extension switch from -e to -x, so that -e and -d can be used for enable/disable warning(s). 15-nov-94 neilb * Added a check for an odd number of quotes in an element, so the following now generates a warning: <A HREF="http://www.foobar.com/> 14-nov-94 neilb * If an element is not recognized, then any element attributes are not checked for validity. (suggested by Victor Parada <vparada@inf.utfsm.cl>) * All keywords in the configuration file can now take multiple arguments. I.e., you can enable multiple warnings with: enable mailto-link upper-case * The illegal element check wasn't being performed on closing tags, so </XYZ> wouldn't generate a warning. (reported by Victor Parada <vparada@inf.utfsm.cl>) * Added a sample configuration file `weblintrc', with comments describing everything which can be configured. Configuration matches the built-in defaults. * Use of <!doctype ...> would generate a bunch of bogus whines. (reported by several people :-) 1.003 11-nov-94 neilb * Added support for HTML extensions. Currently only the netscape extensions are supported, either by: weblint -e netscape .... or, in your .weblintrc: # enable the netscape HTML extensions extension netscape Weblint will not complain that <CENTER> is an unknown element, and also knows about the additional element attributes. * Fixed the bug in the -R code whereby it would get confused about where it was. (reported by Victor Parada <vparada@inf.utfsm.cl>, and Bob Friesenhahn <bfriesen@simple.dallas.tx.us>) * Removed the generic context check added on 6-nov-94. I need to learn more about implied context before this is added back in. It currently whines about *everything* :-( 6-nov-94 neilb * Generalized the context checks; they are now table driven, and based on the HTML spec. Warning identifier is `illegal-context'. 5-nov-94 neilb * Made the usage slightly more verbose, giving example usage. (suggested by Douglas Brick <dbrick@u.washington.edu>) * Added a check for illegal elements, with warning identifier of 'unknown-element', enabled by default. So <\PRE> and <CENTER> will generate this warning. (suggested by Joerg Heitkoetter <Joerg.Heitkoetter\@germany.eu.net>) * For non-nestable elements (such as anchors), the warning now gives the line number of the still open element. * Weblint now correctly recognizes SGML comments where there is whitespace between the -- and > closing the comment. Eg: <!-- this is a valid comment -- > (reported by Paul Black <black@lal.cs.byu.edu>) 3-nov-94 neilb * Removed the warning with identifier 'tag-args': expected argument for tag <...>. and replaced it with a general check for required attributes, with identifier 'expected-attribute': sample.html(9): SRC attribute is required for <IMG>. * Added a -s command-line switch, for short warnings. Short warnings do not include the filename: line 5: no <TITLE> in HEAD element. (suggested by Clay Webster <clay@unipress.com>) * Added a check and warning (identifier: leading-whitespace) for whitespace between < and tag name, for example: < TITLE> will generate warning: Should not have whitespace between "<" and "TITLE>". * The usage statement is now printed if weblint is invoked without any command-line arguments. * Fixed bug whereby <IMG SRC="foo.gif" ISMAP ALT="alt text"> would generate a warning that element had no ALT text. * Added a check for legal attributes. So the following <A HROF="..."> generates a warning: Unknown attribute "HROF" for element <A>. with warning identifier of 'unknown-attribute'. * Messages are now written to STDOUT rather than STDERR. 1.002 2-nov-94 neilb * Now correctly (or more correctly at least) recognizes SGML comments, and doesn't get confused by markup embedded in comments. Added a new warning for markup embedded in a comment, since this confuses some browsers. The warning, with identifier 'markup-in-comment', is enabled by default. * Modified the checks on element closing tags </...>, performed for </HEAD>, </BODY> and </HTML> -- the following used to generate a bogus warning that no </UL> was seen: <HTML><HEAD><TITLE>sample
  • unclosed italic
* Slight re-arrangement of man page sections, to follow traditional UNIX conventions (reported by Joerg Heitkoetter ) * No longer complains if you have more than one ADDRESS element on a page. 1-nov-94 neilb * added a -R switch, which is used to recurse down directories, checking any files found with a file extension of .html or .htm; for example: weblint -R . Weblint now depends on find.pl from the standard perl library. (suggested by Thomas Leavitt ) * changed logic of the check for elements which can and can't appear in the HEAD element. Weblint previously complained that ISINDEX could only appear in the HEAD, which was not true (reported by Victor Parada ) 29-oct-94 neilb * attributes were not being seen in multi-line tags if they appeared after the first newline. Eg: alt text> generated a warning that the IMG had no ALT text. (reported by Barry Bakalor <barry@hal.com>) * Now handles whitespace around the = of tag attributes. The following used to generate a warning: <IMG SRC = and complaining that the IMG had no ALT text. (reported by Richard Lloyd ) * If you give `-' as a filename, weblint will read from standard input. Warnings will be given for `stdin'. (suggested by Ryan Waldron ) 1.001 24-oct-94 neilb * Added a man page (initial man page supplied by Juergen Schoenwaelder ) * Added a check for FORM elements: - INPUT, SELECT, and TEXTAREA must appear in a FORM. - OPTION must be within a SELECT element. * Added code which checks for overlapped elements. E.g.:

... ...

This now results in one warning rather than six :-) Multiply overlapped elements (more than two) don't always generated the `correct' number of warnings, but you should get at least one :-) * Improved check for unclosed elements. Following example now generates one warning, instead of the multitude generated by weblint 1.0: ... unclosed bold element 23-oct-94 neilb * fixed the whine generated if you have a at the start of your page. * added support for a configuration file. WEBLINTRC, or $HOME/.weblintrc. Changed the whine() function to use warning identifiers. Defined whines, with identifiers, and default enabling are stored beyond the end of the script. Can enable or disable warnings in your .weblintrc. * added check for illegally nested elements (eg anchors). * additional check for items which should not appear in HEAD. * check that
and
appear in a definition list (DL). * added COMMENT to list of obsolete elements. * added check for elements which must be in a FORM element. * added check for , which is not enabled by default. 21-oct-94 neilb * added check for LI, that it appears within DIR, MENU, OL or UL elements * Fixed bug whereby weblint wasn't seeing tags with embedded newlines. Eg: 20-oct-94 neilb * fixed bug in the code which keeps track of currently `open' elements. It was getting confused on line numbers. (reported by Barry Bakalor ) * checks at end of file for unclosed elements were giving message: tag <...> has no matching . rather than correct closing tag. (reported by Barry Bakalor ) 1.000 First version made publically available. rn; } #--------------------------------------------------------------------- # netscape extensions #--------------------------------------------------------------------- #-- new element attributes for existing elements --------------------- &AddAttributes('ISINDEX', 'PROMPT'); &AddAttributes('HR', 'SIZE', 'SIZE', 'ALIGN',weblint-1.005/weblint.1000600 002126 000322 00000014542 05663514616 015355 0ustar00neilbkgroup000000 000000 .TH weblint 1L "Oct 94" "Handmade" .de iD \fIIdentifier\fP: \\$1 .br \fIDefault\fP: \\$2 .. .de wC .TP 4 .B \(bu \\$1 .. .SH NAME weblint \- pick fluff off web pages (HTML) .SH SYNOPSIS .B weblint [ .B "-d \fIid\fP" ] [ .B "-e \fIid\fP" ] [ .B "-R" ] [ .B "-s" ] [ .B "-T" ] [ .B "-U" ] [ .B "-v" ] [ .B "-x \fIextension\fP" ] file1 .. fileN .SH DESCRIPTION Weblint is a perl script which picks fluff off html pages. Files to be checked are passed on the command-line. Warnings are generated a la lint: .LP .RS .nf .ft CW home.html(9): unmatched (no matching seen). .ft P .fi .RE .TP The following checks are currently performed: .RS .wC "basic structure" .wC "unknown elements and element attributes." .wC "context checks (where a tag must appear within a certain element)." .wC "overlapped elements." .wC "expects to see a TITLE in the HEAD element." .wC "do IMG elements have ALT text?" .wC "illegally nested elements." .wC "mis-matched tags (e.g.,

...

)" .wC "unclosed elements (e.g.,

... )" .wC "catches elements which should only appear once" .wC "flags obsolete elements." .wC "odd number of quotes in tag." .wC "order of headings." .wC "potentially unclosed tags." .wC "flags markup embedded in comments, since this can confuse some browsers." .wC "whines if you use `here' as anchor text :-)" .wC "tags where attributes are expected (e.g. anchors)." .wC "existence of local anchor targets." .wC "flag case of tags (not enabled by default)." .wC "expect a in HEAD element (not enabled by default)." .RE .SH OPTIONS .TP .B "-d \fIwarning-identifier\fP" Disable the warning associated with the identifier. Multiple identifiers can be specified, with a comma between identifiers. .TP .B "-e \fIwarning-identifier\fP" Enable the warning associated with the identifier. Multiple identifiers can be specified, with a comma between identifiers. .TP .B -R If any of the command-line arguments are directories, then recursively search them, and check any files found with filename extension of html or htm. .TP .B -s Generate `short' warning messages, which do not include the filename. .TP .B -v Display the version number. .TP .B -U Show a short usage summary. .TP .B -T Display the current ToDo list. .TP .B "-x \fIextension\fP" Include checks for the specified HTML extension. Currently the only extension supported is \fInetscape\fP. This can also be set in your weblint configuration file, described below. .SH CONFIGURATION FILE \fIWeblint\fP can be configured using a file \fI.weblintrc\fP in your home directory (or a file referenced by the WEBLINTRC environment variable). This file lets you enable or disable specific warnings, each of which has a short identifier string. For example, if you want to enable the check for tags in upper-case, but disable the check for obsolete elements, then you would include the following lines in your .weblintrc: .LP .RS .ft CW .ps -2 .nf # enable warning for tags not in upper-case enable upper-case # disable the warning for obsolete tags disable obsolete # enable the netscape HTML extensions extension netscape .fi .ps +2 .ft P .RE .LP The keywords can be followed by any number of arguments, separated by spaces or tabs. Anything following a `#' is treated as a comment. .LP A sample configuration file is included in the weblint distribution (as of version 1.004), which mirrors the configuration built-in to weblint. .SH WARNINGS All warnings generated by \fIweblint\fP are listed below, along with the associated identifier, and whether the warning is enabled or disabled by default. .TP \fBtag <...> is not in upper case.\fP .iD upper-case disabled .TP \fBtag <...> is not in lower case.\fP .iD lower-case disabled .TP \fB\f(BIfoo\fP attribute is required for <...>\fP .iD required-attribute enabled .TP \fBexpected an attribute for <...>\fP .iD expected-attribute enabled .TP \fBunknown element <...>\fP .iD unknown-element enabled .TP \fBUnknown attribute "..." for element <...>.\fP .iD unknown-attribute enabled .TP \fBShould not have whitespace between "<" and "...>"\fP .iD leading-whitespace enabled .TP \fBbad form to use `here' as an anchor!\fP .iD here-anchor enabled .TP \fBno in HEAD element.\fP .iD require-head enabled .TP \fBtag <...> should only appear once. I saw one on line XX!\fP .iD once-only enabled .TP \fB<BODY> but no <HEAD>.\fP .iD body-no-head enabled .TP \fBouter tags should be <HTML> .. </HTML>.\fP .iD html-outer enabled .TP \fB<...> can only appear in the HEAD element.\fP .iD head-element head-element .TP \fB<...> cannot appear in the HEAD element.\fP .iD non-head-element enabled .TP \fB<LI> can only appear in DIR, MENU, OL or UL elements.\fP .iD list-item enabled .TP \fB<...> is obsolete.\fP .iD obsolete enabled .TP \fBunmatched </...> (no matching <...> seen).\fP .iD mis-match enabled .TP \fBIMG does not have ALT text defined.\fP .iD img-alt enabled .TP \fB<...> cannot be nested.\fP .iD nested-element enabled .TP \fB<...> can only be used in definition list (<DL>..</DL>).\fP .iD defn-list-elements enabled .TP \fB<...> can only appear in a FORM element.\fP .iD form-item enabled .TP \fB<OPTION> can only appear within a SELECT element.\fP .iD select-option enabled .TP \fBDid not see <LINK REV=MADE HREF="mailto:..."> in HEAD.\fP .iD mailto-link disabled .TP \fB</...> on line XX seems to overlap <...>, opened on line YY.\fP .iD element-overlap enabled .TP \fBNo closing </...> seen for <...> on line XX.\fP .iD unclosed-element enabled .TP \fBMarkup embedded in a comment can confuse some browsers.\fP .iD markup-in-comment enabled .TP \fBodd number of quotes in element <...>.\fP .iD odd-quotes enabled .TP \fBheading <H?> follows <H?> on line N. .iD heading-order enabled .TP \fBtarget for anchor "..." not found.\fP .iD bad-link enabled .TP \fBunexpected < in <...> -- potentially unclosed element.\fP .iD unexpected-open enabled .SH "ENVIRONMENT VARIABLES" .TP \fBWEBLINTRC\fP If this variable is defined, and references a file, then \fIweblint\fP will read for the user's configuration, rather than $HOME/.weblintrc. .SH FILES .TP \fI$HOME/.weblintrc\fP The user's configuration file. See the section `CONFIGURATION FILE'. .SH SEE ALSO perl(1) .SH VERSION This manpage describes \fIweblint 1.005\fP. .SH AVAILABILITY .ft CW .ps -2 .nf ftp://ftp.khoros.unm.edu/pub/perl/www/weblint* http://www.khoros.unm.edu/staff/neilb/weblint.html .fi .ft P .ps +2 .SH AUTHOR Neil Bowers, Khoral Research, Inc. .br neilb@khoros.unm.edu lint'ing more than one file on the command-line, some state variables would roll over to the next file, causing bogus warnings. (reported by Barry Bakalor weblint-1.005/weblint.ps����������������������������������������������������������������������������000644 �002126 �000322 �00000044171 05664163047 015647� 0����������������������������������������������������������������������������������������������������ustar�00neilb���������������������������kgroup��������������������������000000 �000000 ������������������������������������������������������������������������������������������������������������������������������������������������������������������������%!PS-Adobe-3.0 %%Creator: groff version 1.09 %%CreationDate: Mon Nov 21 11:25:43 1994 %%DocumentNeededResources: font Times-Roman %%+ font Times-Bold %%+ font Times-Italic %%+ font Courier %%+ font Times-BoldItalic %%DocumentSuppliedResources: procset grops 1.09 0 %%Pages: 4 %%PageOrder: Ascend %%Orientation: Portrait %%EndComments %%BeginProlog %%BeginResource: procset grops 1.09 0 /setpacking where{ pop currentpacking true setpacking }if /grops 120 dict dup begin /SC 32 def /A/show load def /B{0 SC 3 -1 roll widthshow}bind def /C{0 exch ashow}bind def /D{0 exch 0 SC 5 2 roll awidthshow}bind def /E{0 rmoveto show}bind def /F{0 rmoveto 0 SC 3 -1 roll widthshow}bind def /G{0 rmoveto 0 exch ashow}bind def /H{0 rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def /I{0 exch rmoveto show}bind def /J{0 exch rmoveto 0 SC 3 -1 roll widthshow}bind def /K{0 exch rmoveto 0 exch ashow}bind def /L{0 exch rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def /M{rmoveto show}bind def /N{rmoveto 0 SC 3 -1 roll widthshow}bind def /O{rmoveto 0 exch ashow}bind def /P{rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def /Q{moveto show}bind def /R{moveto 0 SC 3 -1 roll widthshow}bind def /S{moveto 0 exch ashow}bind def /T{moveto 0 exch 0 SC 5 2 roll awidthshow}bind def /SF{ findfont exch [exch dup 0 exch 0 exch neg 0 0]makefont dup setfont [exch/setfont cvx]cvx bind def }bind def /MF{ findfont [5 2 roll 0 3 1 roll neg 0 0]makefont dup setfont [exch/setfont cvx]cvx bind def }bind def /level0 0 def /RES 0 def /PL 0 def /LS 0 def /PLG{ gsave newpath clippath pathbbox grestore exch pop add exch pop }bind def /BP{ /level0 save def 1 setlinecap 1 setlinejoin 72 RES div dup scale LS{ 90 rotate }{ 0 PL translate }ifelse 1 -1 scale }bind def /EP{ level0 restore showpage }bind def /DA{ newpath arcn stroke }bind def /SN{ transform .25 sub exch .25 sub exch round .25 add exch round .25 add exch itransform }bind def /DL{ SN moveto SN lineto stroke }bind def /DC{ newpath 0 360 arc closepath }bind def /TM matrix def /DE{ TM currentmatrix pop translate scale newpath 0 0 .5 0 360 arc closepath TM setmatrix }bind def /RC/rcurveto load def /RL/rlineto load def /ST/stroke load def /MT/moveto load def /CL/closepath load def /FL{ currentgray exch setgray fill setgray }bind def /BL/fill load def /LW/setlinewidth load def /RE{ findfont dup maxlength 1 index/FontName known not{1 add}if dict begin { 1 index/FID ne{def}{ pop pop}ifelse }forall /Encoding exch def dup/FontName exch def currentdict end definefont pop }bind def /DEFS 0 def /EBEGIN{ moveto DEFS begin }bind def /EEND/end load def /CNT 0 def /level1 0 def /PBEGIN{ /level1 save def translate div 3 1 roll div exch scale neg exch neg exch translate 0 setgray 0 setlinecap 1 setlinewidth 0 setlinejoin 10 setmiterlimit [] 0 setdash /setstrokeadjust where{ pop false setstrokeadjust }if /setoverprint where{ pop false setoverprint }if newpath /CNT countdictstack def userdict begin /showpage{} def }bind def /PEND{ clear countdictstack CNT sub{end}repeat level1 restore }bind def end def /setpacking where{ pop setpacking }if %%EndResource %%IncludeResource: font Times-Roman %%IncludeResource: font Times-Bold %%IncludeResource: font Times-Italic %%IncludeResource: font Courier %%IncludeResource: font Times-BoldItalic grops begin/DEFS 1 dict def DEFS begin/u{.001 mul}bind def end/RES 72 def/PL 792 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron/Zcaron /scaron/zcaron/Ydieresis/trademark/quotesingle/.notdef/.notdef/.notdef /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef /.notdef/.notdef/space/exclam/quotedbl/numbersign/dollar/percent /ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen /period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon /semicolon/less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O /P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/backslash/bracketright/circumflex /underscore/quoteleft/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y /z/braceleft/bar/braceright/tilde/.notdef/quotesinglbase/guillemotleft /guillemotright/bullet/florin/fraction/perthousand/dagger/daggerdbl /endash/emdash/ff/fi/fl/ffi/ffl/dotlessi/dotlessj/grave/hungarumlaut /dotaccent/breve/caron/ring/ogonek/quotedblleft/quotedblright/oe/lslash /quotedblbase/OE/Lslash/.notdef/exclamdown/cent/sterling/currency/yen /brokenbar/section/dieresis/copyright/ordfeminine/guilsinglleft /logicalnot/minus/registered/macron/degree/plusminus/twosuperior /threesuperior/acute/mu/paragraph/periodcentered/cedilla/onesuperior /ordmasculine/guilsinglright/onequarter/onehalf/threequarters /questiondown/Agrave/Aacute/Acircumflex/Atilde/Adieresis/Aring/AE /Ccedilla/Egrave/Eacute/Ecircumflex/Edieresis/Igrave/Iacute/Icircumflex /Idieresis/Eth/Ntilde/Ograve/Oacute/Ocircumflex/Otilde/Odieresis /multiply/Oslash/Ugrave/Uacute/Ucircumflex/Udieresis/Yacute/Thorn /germandbls/agrave/aacute/acircumflex/atilde/adieresis/aring/ae/ccedilla /egrave/eacute/ecircumflex/edieresis/igrave/iacute/icircumflex/idieresis /eth/ntilde/ograve/oacute/ocircumflex/otilde/odieresis/divide/oslash /ugrave/uacute/ucircumflex/udieresis/yacute/thorn/ydieresis]def /Times-BoldItalic@0 ENC0/Times-BoldItalic RE/Courier@0 ENC0/Courier RE /Times-Italic@0 ENC0/Times-Italic RE/Times-Bold@0 ENC0/Times-Bold RE /Times-Roman@0 ENC0/Times-Roman RE %%EndProlog %%Page: 1 1 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF 369.96(weblint\(1L\) weblint\(1L\))72 48 R/F1 9 /Times-Bold@0 SF -.18(NA)72 84 S(ME).18 E F0(weblint \255 pick \215uf) 108 96 Q 2.5(fo)-.25 G .5 -.25(ff w)-2.5 H(eb pages \(HTML\)).25 E F1 (SYNOPSIS)72 112.8 Q/F2 10/Times-Bold@0 SF(weblint)108 124.8 Q F0([)2.5 E F2(-d)2.5 E/F3 10/Times-Italic@0 SF(id)2.5 E F0 2.5(][)2.5 G F2(-e)A F3(id)2.5 E F0 2.5(][)2.5 G F2(-R)A F0 2.5(][)2.5 G F2(-s)A F0 2.5(][) 2.5 G F2(-T)A F0 2.5(][)2.5 G F2(-U)A F0 2.5(][)2.5 G F2(-v)A F0 2.5(][) 2.5 G F2(-x)A F3 -.2(ex)2.5 G(tension).2 E F0 2.5<5d8c>2.5 G (le1 .. \214leN)-2.5 E F1(DESCRIPTION)72 141.6 Q F0 -.8(We)108 153.6 S .578(blint is a perl script which picks \215uf).8 F 3.077(fo)-.25 G 1.077 -.25(ff h)-3.077 H .577(tml pages.).25 F .577(Files to be check) 5.577 F .577(ed are passed on the command-)-.1 F 2.5(line. W)108 165.6 R (arnings are generated a la lint:)-.8 E/F4 10/Courier@0 SF (home.html\(9\): unmatched </A> \(no matching <A> seen\).)144 182.4 Q F0 (The follo)108 199.2 Q(wing checks are currently performed:)-.25 E F2 <83>144 216 Q F0(basic structure)16.5 E F2<83>144 232.8 Q F0(unkno)16.5 E(wn elements and element attrib)-.25 E(utes.)-.2 E F2<83>144 249.6 Q F0 (conte)16.5 E (xt checks \(where a tag must appear within a certain element\).)-.15 E F2<83>144 266.4 Q F0 -.15(ove)16.5 G(rlapped elements.).15 E F2<83>144 283.2 Q F0 -.15(ex)16.5 G(pects to see a TITLE in the HEAD element.).15 E F2<83>144 300 Q F0(do IMG elements ha)16.5 E .3 -.15(ve A)-.2 H 1.84 -.92(LT t).15 H -.15(ex).92 G(t?).15 E F2<83>144 316.8 Q F0(ille)16.5 E -.05(ga)-.15 G(lly nested elements.).05 E F2<83>144 333.6 Q F0 (mis-matched tags \(e.g., <H1> ... </H2>\))16.5 E F2<83>144 350.4 Q F0 (unclosed elements \(e.g., <H1> ... \))16.5 E F2<83>144 367.2 Q F0 (catches elements which should only appear once)16.5 E F2<83>144 384 Q F0(\215ags obsolete elements.)16.5 E F2<83>144 400.8 Q F0 (odd number of quotes in tag.)16.5 E F2<83>144 417.6 Q F0 (order of headings.)16.5 E F2<83>144 434.4 Q F0 (potentially unclosed tags.)16.5 E F2<83>144 451.2 Q F0 (\215ags markup embedded in comments, since this can confuse some bro) 16.5 E(wsers.)-.25 E F2<83>144 468 Q F0 (whines if you use `here' as anchor te)16.5 E(xt :-\))-.15 E F2<83>144 484.8 Q F0(tags where attrib)16.5 E(utes are e)-.2 E (xpected \(e.g. anchors\).)-.15 E F2<83>144 501.6 Q F0 -.15(ex)16.5 G (istence of local anchor tar).15 E(gets.)-.18 E F2<83>144 518.4 Q F0 (\215ag case of tags \(not enabled by def)16.5 E(ault\).)-.1 E F2<83>144 535.2 Q F0 -.15(ex)16.5 G .265(pect a <LINK REV=MADE HREF=mailto:...> i\ n HEAD element \(not enabled by def).15 F(ault\).)-.1 E F1(OPTIONS)72 552 Q F2(-d)108 564 Q F3(warning-identi\214er)2.5 E F0 1.413 (Disable the w)144 576 R 1.413(arning associated with the identi\214er) -.1 F 6.412(.M)-.55 G 1.412 (ultiple identi\214ers can be speci\214ed, with a)-6.412 F (comma between identi\214ers.)144 588 Q F2(-e)108 604.8 Q F3 (warning-identi\214er)2.5 E F0 1.626(Enable the w)144 616.8 R 1.626 (arning associated with the identi\214er)-.1 F 6.626(.M)-.55 G 1.626 (ultiple identi\214ers can be speci\214ed, with a)-6.626 F (comma between identi\214ers.)144 628.8 Q F2(-R)108 645.6 Q F0 .143 (If an)25.45 F 2.643(yo)-.15 G 2.642(ft)-2.643 G .142 (he command-line ar)-2.642 F .142(guments are directories, then recursi) -.18 F -.15(ve)-.25 G .142(ly search them, and check an).15 F(y)-.15 E (\214les found with \214lename e)144 657.6 Q(xtension of html or htm.) -.15 E F2(-s)108 674.4 Q F0(Generate `short' w)28.78 E (arning messages, which do not include the \214lename.)-.1 E F2(-v)108 691.2 Q F0(Display the v)27.67 E(ersion number)-.15 E(.)-.55 E F2(-U)108 708 Q F0(Sho)25.45 E 2.5(was)-.25 G(hort usage summary)-2.5 E(.)-.65 E 174.71(Handmade Oct)72 768 R 213.03(94 1)2.5 F EP %%Page: 2 2 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF 369.96(weblint\(1L\) weblint\(1L\))72 48 R/F1 10 /Times-Bold@0 SF(-T)108 84 Q F0(Display the current T)26 E(oDo list.)-.8 E F1(-x)108 100.8 Q/F2 10/Times-Italic@0 SF -.2(ex)2.5 G(tension).2 E F0 2.103(Include checks for the speci\214ed HTML e)144 112.8 R 4.603 (xtension. Currently)-.15 F 2.104(the only e)4.603 F 2.104 (xtension supported is)-.15 F F2(netscape)144 124.8 Q F0 5(.T)C(his can\ also be set in your weblint con\214guration \214le, described belo)-5 E -.65(w.)-.25 G/F3 9/Times-Bold@0 SF(CONFIGURA)72 141.6 Q(TION FILE)-.855 E F2 -.92(We)108 153.6 S(blint).92 E F0 2.159 (can be con\214gured using a \214le)4.659 F F2(.weblintr)4.659 E(c)-.37 E F0 2.159(in your home directory \(or a \214le referenced by the)4.659 F .38(WEBLINTRC en)108 165.6 R .38(vironment v)-.4 F 2.88 (ariable\). This)-.25 F .38 (\214le lets you enable or disable speci\214c w)2.88 F .38 (arnings, each of which)-.1 F .049(has a short identi\214er string.)108 177.6 R -.15(Fo)5.049 G 2.549(re).15 G .049(xample, if you w)-2.699 F .049(ant to enable the check for tags in upper)-.1 F .049(-case, b)-.2 F .048(ut disable)-.2 F(the check for obsolete elements, then you w)108 189.6 Q(ould include the follo)-.1 E(wing lines in your .weblintrc:)-.25 E/F4 8/Courier@0 SF 4.8(#e)144 206.4 S (nable warning for tags not in upper-case)-4.8 E(enable upper-case)144 218.4 Q 4.8(#d)144 242.4 S(isable the warning for obsolete tags)-4.8 E (disable obsolete)144 254.4 Q 4.8(#e)144 278.4 S (nable the netscape HTML extensions)-4.8 E(extension netscape)144 290.4 Q F0 .126(The k)108 307.2 R -.15(ey)-.1 G -.1(wo).15 G .127 (rds can be follo).1 F .127(wed by an)-.25 F 2.627(yn)-.15 G .127 (umber of ar)-2.627 F .127(guments, separated by spaces or tabs.)-.18 F (An)5.127 E .127(ything follo)-.15 F(w-)-.25 E (ing a `#' is treated as a comment.)108 319.2 Q 3.1(As)108 336 S .6 (ample con\214guration \214le is included in the weblint distrib)-3.1 F .6(ution \(as of v)-.2 F .6(ersion 1.004\), which mirrors the)-.15 F (con\214guration b)108 348 Q(uilt-in to weblint.)-.2 E F3 -1.08(WA)72 364.8 S(RNINGS)1.08 E F0 1.101(All w)108 376.8 R 1.101 (arnings generated by)-.1 F F2(weblint)3.601 E F0 1.101(are listed belo) 3.601 F 2.401 -.65(w, a)-.25 H 1.101 (long with the associated identi\214er).65 F 3.602(,a)-.4 G 1.102 (nd whether the)-3.602 F -.1(wa)108 388.8 S (rning is enabled or disabled by def).1 E(ault.)-.1 E F1 (tag <...> is not in upper case.)108 405.6 Q F2(Identi\214er)144 417.6 Q F0 2.5(:u)C(pper)-2.5 E(-case)-.2 E F2(Default)144 429.6 Q F0 2.5(:d)C (isabled)-2.5 E F1(tag <...> is not in lo)108 446.4 Q(wer case.)-.1 E F2 (Identi\214er)144 458.4 Q F0 2.5(:l)C -.25(ow)-2.5 G(er).25 E(-case)-.2 E F2(Default)144 470.4 Q F0 2.5(:d)C(isabled)-2.5 E/F5 10 /Times-BoldItalic@0 SF -.1(fo)108 487.2 S(o).1 E F1(attrib)2.5 E (ute is r)-.2 E(equir)-.18 E(ed f)-.18 E(or <...>)-.25 E F2 (Identi\214er)144 499.2 Q F0 2.5(:r)C(equired-attrib)-2.5 E(ute)-.2 E F2 (Default)144 511.2 Q F0 2.5(:e)C(nabled)-2.5 E F1(expected an attrib)108 528 Q(ute f)-.2 E(or <...>)-.25 E F2(Identi\214er)144 540 Q F0 2.5(:e)C (xpected-attrib)-2.65 E(ute)-.2 E F2(Default)144 552 Q F0 2.5(:e)C (nabled)-2.5 E F1(unkno)108 568.8 Q(wn element <...>)-.1 E F2 (Identi\214er)144 580.8 Q F0 2.5(:u)C(nkno)-2.5 E(wn-element)-.25 E F2 (Default)144 592.8 Q F0 2.5(:e)C(nabled)-2.5 E F1(Unkno)108 609.6 Q (wn attrib)-.1 E(ute "..." f)-.2 E(or element <...>.)-.25 E F2 (Identi\214er)144 621.6 Q F0 2.5(:u)C(nkno)-2.5 E(wn-attrib)-.25 E(ute) -.2 E F2(Default)144 633.6 Q F0 2.5(:e)C(nabled)-2.5 E F1(Should not ha) 108 650.4 Q .2 -.1(ve w)-.25 H(hitespace between "<" and "...>").1 E F2 (Identi\214er)144 662.4 Q F0 2.5(:l)C(eading-whitespace)-2.5 E F2 (Default)144 674.4 Q F0 2.5(:e)C(nabled)-2.5 E F1(bad f)108 691.2 Q (orm to use `her)-.25 E(e' as an anchor!)-.18 E F2(Identi\214er)144 703.2 Q F0 2.5(:h)C(ere-anchor)-2.5 E F2(Default)144 715.2 Q F0 2.5(:e)C (nabled)-2.5 E 174.71(Handmade Oct)72 768 R 213.03(94 2)2.5 F EP %%Page: 3 3 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF 369.96(weblint\(1L\) weblint\(1L\))72 48 R/F1 10 /Times-Bold@0 SF(no <TITLE> in HEAD element.)108 84 Q/F2 10 /Times-Italic@0 SF(Identi\214er)144 96 Q F0 2.5(:r)C(equire-head)-2.5 E F2(Default)144 108 Q F0 2.5(:e)C(nabled)-2.5 E F1 (tag <...> should only appear once.)108 124.8 Q 2.5(Is)5 G (aw one on line XX!)-2.5 E F2(Identi\214er)144 136.8 Q F0 2.5(:o)C (nce-only)-2.5 E F2(Default)144 148.8 Q F0 2.5(:e)C(nabled)-2.5 E F1 (<BOD)108 165.6 Q(Y> b)-.4 E(ut no <HEAD>.)-.2 E F2(Identi\214er)144 177.6 Q F0 2.5(:b)C(ody-no-head)-2.5 E F2(Default)144 189.6 Q F0 2.5(:e) C(nabled)-2.5 E F1(outer tags should be <HTML> .. </HTML>.)108 206.4 Q F2(Identi\214er)144 218.4 Q F0 2.5(:h)C(tml-outer)-2.5 E F2(Default)144 230.4 Q F0 2.5(:e)C(nabled)-2.5 E F1 (<...> can only appear in the HEAD element.)108 247.2 Q F2(Identi\214er) 144 259.2 Q F0 2.5(:h)C(ead-element)-2.5 E F2(Default)144 271.2 Q F0 2.5 (:h)C(ead-element)-2.5 E F1(<...> cannot appear in the HEAD element.)108 288 Q F2(Identi\214er)144 300 Q F0 2.5(:n)C(on-head-element)-2.5 E F2 (Default)144 312 Q F0 2.5(:e)C(nabled)-2.5 E F1 (<LI> can only appear in DIR, MENU)108 328.8 Q 2.5(,O)-.5 G 2.5(Lo)-2.5 G 2.5(rU)-2.5 G 2.5(Le)-2.5 G(lements.)-2.5 E F2(Identi\214er)144 340.8 Q F0 2.5(:l)C(ist-item)-2.5 E F2(Default)144 352.8 Q F0 2.5(:e)C(nabled) -2.5 E F1(<...> is obsolete.)108 369.6 Q F2(Identi\214er)144 381.6 Q F0 2.5(:o)C(bsolete)-2.5 E F2(Default)144 393.6 Q F0 2.5(:e)C(nabled)-2.5 E F1(unmatched </...> \(no matching <...> seen\).)108 410.4 Q F2 (Identi\214er)144 422.4 Q F0 2.5(:m)C(is-match)-2.5 E F2(Default)144 434.4 Q F0 2.5(:e)C(nabled)-2.5 E F1(IMG does not ha)108 451.2 Q .2 -.1 (ve A)-.25 H 1.84 -.92(LT t).1 H(ext de\214ned.).92 E F2(Identi\214er) 144 463.2 Q F0 2.5(:i)C(mg-alt)-2.5 E F2(Default)144 475.2 Q F0 2.5(:e)C (nabled)-2.5 E F1(<...> cannot be nested.)108 492 Q F2(Identi\214er)144 504 Q F0 2.5(:n)C(ested-element)-2.5 E F2(Default)144 516 Q F0 2.5(:e)C (nabled)-2.5 E F1 (<...> can only be used in de\214nition list \(<DL>..</DL>\).)108 532.8 Q F2(Identi\214er)144 544.8 Q F0 2.5(:d)C(efn-list-elements)-2.5 E F2 (Default)144 556.8 Q F0 2.5(:e)C(nabled)-2.5 E F1 (<...> can only appear in a FORM element.)108 573.6 Q F2(Identi\214er) 144 585.6 Q F0 2.5(:f)C(orm-item)-2.5 E F2(Default)144 597.6 Q F0 2.5 (:e)C(nabled)-2.5 E F1 (<OPTION> can only appear within a SELECT element.)108 614.4 Q F2 (Identi\214er)144 626.4 Q F0 2.5(:s)C(elect-option)-2.5 E F2(Default)144 638.4 Q F0 2.5(:e)C(nabled)-2.5 E F1 (Did not see <LINK REV=MADE HREF="mailto:..."> in HEAD)108 655.2 Q(.)-.2 E F2(Identi\214er)144 667.2 Q F0 2.5(:m)C(ailto-link)-2.5 E F2(Default) 144 679.2 Q F0 2.5(:d)C(isabled)-2.5 E F1(</...> on line XX seems to o) 108 696 Q -.1(ve)-.1 G(rlap <...>, opened on line YY).1 E(.)-.92 E F2 (Identi\214er)144 708 Q F0 2.5(:e)C(lement-o)-2.5 E -.15(ve)-.15 G(rlap) .15 E F2(Default)144 720 Q F0 2.5(:e)C(nabled)-2.5 E 174.71 (Handmade Oct)72 768 R 213.03(94 3)2.5 F EP %%Page: 4 4 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF 369.96(weblint\(1L\) weblint\(1L\))72 48 R/F1 10 /Times-Bold@0 SF(No closing </...> seen f)108 84 Q(or <...> on line XX.) -.25 E/F2 10/Times-Italic@0 SF(Identi\214er)144 96 Q F0 2.5(:u)C (nclosed-element)-2.5 E F2(Default)144 108 Q F0 2.5(:e)C(nabled)-2.5 E F1(Markup embedded in a comment can confuse some br)108 124.8 Q -.1(ow) -.18 G(sers.).1 E F2(Identi\214er)144 136.8 Q F0 2.5(:m)C (arkup-in-comment)-2.5 E F2(Default)144 148.8 Q F0 2.5(:e)C(nabled)-2.5 E F1(odd number of quotes in element <...>.)108 165.6 Q F2(Identi\214er) 144 177.6 Q F0 2.5(:o)C(dd-quotes)-2.5 E F2(Default)144 189.6 Q F0 2.5 (:e)C(nabled)-2.5 E F1(heading <H?> f)108 206.4 Q(ollo)-.25 E (ws <H?> on line N.)-.1 E F2(Identi\214er)144 218.4 Q F0 2.5(:h)C (eading-order)-2.5 E F2(Default)144 230.4 Q F0 2.5(:e)C(nabled)-2.5 E F1 (tar)108 247.2 Q(get f)-.1 E(or anchor "..." not f)-.25 E(ound.)-.25 E F2(Identi\214er)144 259.2 Q F0 2.5(:b)C(ad-link)-2.5 E F2(Default)144 271.2 Q F0 2.5(:e)C(nabled)-2.5 E F1 (unexpected < in <...> -- potentially unclosed element.)108 288 Q F2 (Identi\214er)144 300 Q F0 2.5(:u)C(ne)-2.5 E(xpected-open)-.15 E F2 (Default)144 312 Q F0 2.5(:e)C(nabled)-2.5 E/F3 9/Times-Bold@0 SF(ENVIR) 72 328.8 Q(ONMENT V)-.27 E(ARIABLES)-1.215 E F1(WEBLINTRC)108 340.8 Q F0 .413(If this v)144 352.8 R .413 (ariable is de\214ned, and references a \214le, then)-.25 F F2(weblint) 2.912 E F0 .412(will read for the user')2.912 F 2.912(sc)-.55 G (on\214guration,)-2.912 E(rather than $HOME/.weblintrc.)144 364.8 Q F3 (FILES)72 381.6 Q F2($HOME/.weblintr)108 393.6 Q(c)-.37 E F0(The user') 144 405.6 Q 2.5(sc)-.55 G(on\214guration \214le.)-2.5 E (See the section `CONFIGURA)5 E(TION FILE'.)-1.11 E F3(SEE ALSO)72 422.4 Q F0(perl\(1\))108 434.4 Q F3(VERSION)72 451.2 Q F0 (This manpage describes)108 463.2 Q F2(weblint 1.005)2.5 E F0(.)A F3 -.855 -1.305(AV A)72 480 T(ILABILITY)1.305 E/F4 8/Courier@0 SF (ftp://ftp.khoros.unm.edu/pub/perl/www/weblint*)108 492 Q (http://www.khoros.unm.edu/staff/neilb/weblint.html)108 504 Q F3 -.45 (AU)72 520.8 S(THOR).45 E F0(Neil Bo)108 532.8 Q (wers, Khoral Research, Inc.)-.25 E(neilb@khoros.unm.edu)108 544.8 Q 174.71(Handmade Oct)72 768 R 213.03(94 4)2.5 F EP %%Trailer end %%EOF identi\214ers.)144 588 Q F2(-e)108 604.8 Q F3 (warning-identi\214er)2.5 E F0 1.626(Enable the w)144 616.8 R 1.626 (arning associated with the identi\214er)-.1 F 6.626(.M)-.55 G 1.626 (ultiple identi\214ers can be speci\214ed, with a)-6.626 F (comma between identi\214ers.)144 628.8 Q F2(-R)108 645.6 Q F0 .143 (If an)25.45 F 2.643(yo)-.15 G 2.642(ft)-2.643 G .142 (he command-line ar)-2.642 weblint-1.005/weblintrc�����������������������������������������������������������������������������000644 �002126 �000322 �00000016472 05664162304 015551� 0����������������������������������������������������������������������������������������������������ustar�00neilb���������������������������kgroup��������������������������000000 �000000 ������������������������������������������������������������������������������������������������������������������������������������������������������������������������# # sample configuration file for weblint # distributed as part of weblint 1.005 # # the setting in this file reflect the built-in defaults # #------------------------------------------------------------------------ # There are two checks for the case of element tags: # upper-case all tags should be in upper case # lower-case all tags should be in lower case # If both are disabled, then case is ignored #------------------------------------------------------------------------ disable upper-case lower-case #------------------------------------------------------------------------ # Bad style to use `here' as anchor text #------------------------------------------------------------------------ enable here-anchor #------------------------------------------------------------------------ # Flag any elements which are not recognized. This will catch mis-typed # elements (e.g. <TOTLE>, or <\BODY>). #------------------------------------------------------------------------ enable unknown-element #------------------------------------------------------------------------ # check element attributes to see if they are legal #------------------------------------------------------------------------ enable unknown-attribute #------------------------------------------------------------------------ # flag if no HEAD element in page #------------------------------------------------------------------------ enable require-head #------------------------------------------------------------------------ # Flag elements which should only appear once on a page (eg TITLE) #------------------------------------------------------------------------ enable once-only #------------------------------------------------------------------------ # Flag case where page has BODY element, but no HEAD defined #------------------------------------------------------------------------ enable body-no-head #------------------------------------------------------------------------ # If you want outer element to be <HTML> #------------------------------------------------------------------------ enable html-outer #------------------------------------------------------------------------ # Flag elements which are only allowed to appear in HEAD element #------------------------------------------------------------------------ enable head-element #------------------------------------------------------------------------ # Flag elements which aren't allowed to appear in HEAD element #------------------------------------------------------------------------ enable non-head-element #------------------------------------------------------------------------ # list item (LI) can only appear in OL, UL, DIR, or MENU #------------------------------------------------------------------------ enable list-item #------------------------------------------------------------------------ # Flag obsolete elements, such as XMP and LISTING #------------------------------------------------------------------------ enable obsolete #------------------------------------------------------------------------ # Flag mis-matched begin and end tags; for example: # <H1> ... </H2> #------------------------------------------------------------------------ enable mis-match #------------------------------------------------------------------------ # Flag any IMG elements which don't have ALT text defined. #------------------------------------------------------------------------ enable img-alt #------------------------------------------------------------------------ # Flag illegally nested elements (such as anchors). #------------------------------------------------------------------------ enable nested-element #------------------------------------------------------------------------ # DL and DT are only allowed to appear in DL element (definition list). #------------------------------------------------------------------------ enable defn-list-elements #------------------------------------------------------------------------ # Check for those elements which are only allowed to appear within a FORM #------------------------------------------------------------------------ enable form-item #------------------------------------------------------------------------ # OPTION element can only appear within SELECT element. #------------------------------------------------------------------------ enable select-option #------------------------------------------------------------------------ # Check for mailto: LINK in header; for example: # <LINK REV=MADE HREF="mailto:neilb@khoros.unm.edu"> # This lets at least lynx users comment on a page. #------------------------------------------------------------------------ disable mailto-link #------------------------------------------------------------------------ # Flag overlapped elements. For example: # <A HREF="..."> <B> text </A> </B> #------------------------------------------------------------------------ enable element-overlap #------------------------------------------------------------------------ # Generate a warning if closing tag is not seen for elements where # it is expected. A common case is <A NAME="..."> ... </A>. #------------------------------------------------------------------------ enable unclosed-element #------------------------------------------------------------------------ # Generate a warning if markup appears inside a comment. This can # confuse quite a few browsers, so it's not a good idea to do it. #------------------------------------------------------------------------ enable markup-in-comment #------------------------------------------------------------------------ # You are not allowed to have any whitespace between the opening # < and element name. #------------------------------------------------------------------------ enable leading-whitespace #------------------------------------------------------------------------ # Flag potentially unclosed tags: # < ... < ... > #------------------------------------------------------------------------ enable unexpected-open #------------------------------------------------------------------------ # Elements which do not have any required attributes, but for which at # least one attribute is expected. Anchors, for example. #------------------------------------------------------------------------ enable expected-attribute #------------------------------------------------------------------------ # Required element attributes. Eg IMG tag must have SRC attribute. #------------------------------------------------------------------------ enable required-attribute #------------------------------------------------------------------------ # Currently just checks local links, to see if target file exists. # disabled at the moment, since it generates bogus warnings if the file # path included directories. #------------------------------------------------------------------------ disable bad-link #------------------------------------------------------------------------ # Check for headings which are more than 1 level deeper than previous. # Example: <H1> followed by <H3> #------------------------------------------------------------------------ enable heading-order #------------------------------------------------------------------------ # Check for odd number of double quotes in tag, to catch things like: # <A HREF="url > #------------------------------------------------------------------------ enable odd-quotes ------------------------- enable body-no-head #------------------------------------------------------------------------ # If you want outer element to be <HTML> #-----------------------------------weblint-1.005/Announce������������������������������������������������������������������������������000644 �002126 �000322 �00000004741 05664162231 015321� 0����������������������������������������������������������������������������������������������������ustar�00neilb���������������������������kgroup��������������������������000000 �000000 ������������������������������������������������������������������������������������������������������������������������������������������������������������������������ Weblint 1.005 is now available: ftp://ftp.khoros.unm.edu/pub/perl/www/weblint-1.005.tar.gz http://www.khoros.unm.edu/staff/neilb/weblint.html Non-trivial changes summarized below; see ChangeLog for gory details. Warnings introduced in 1.005 are listed in the Announce file of the distribution, along with their identifiers. As ever, thanks to everyone for feedback, particularly Victor Parada, who gave a lot :-) neilb Changes in Weblint 1.005 * Added an Announce file to distribution, which contains verbose announcement for the current version, listing all new warnings and their identifiers. * Using -R without any other arguments defaults to current directory. * First attemp at check for potentially unclosed elements. For example: <A HREF="..." anchor text </A> * Check for expected attributes, where an element has no required attributes, but at least one attribute is expected (e.g. anchors). * Added a simple Makefile * Now understands the elements which are classified as `proposed' in the HTML2 doc of July 1994 (META, DFN, STRIKE, U, and REL & REV attributes for anchors). * Added check for local links, to see if target exists. * Check for headings which are more than one level greater than previous. E.g.: <H1> followed by <H3> * Changed -e (for extensions) to -x. * Added -d and -e command-line switches, to disable/enable warnings. * Added a check for odd number of quotes (") in tag. This catches: <A HREF="...> * If an element is not recognized, then its attributes are ignored. * Keywords in configuration file now understand multiple parameters. * Illegal element check now performed on closing tags. * Added a sample configuration file to distribution -- "weblintrc". * fixed my goof in 1.003 --- <!DOCTYPE ...> confused weblint New Warnings in 1.005 unexpected-open default: enabled checks for: < ... < ... > expected-attribute default: enabled checks for: elements which don't have required attributes, but where at least one attribute is expected. required-attribute default: enabled checks for: required attributes of elements. bad-link default: disabled checks for: existence of local targets for anchors. This generates bogus warnings if the filename includes directories, which is why it's disabled. heading-order default: enabled checks for: headings more than one level deeper than previous odd-quotes default: enabled checks for: odd number of quotes (") in tag -------------------- enable nonweblint-1.005/Makefile������������������������������������������������������������������������������000644 �002126 �000322 �00000001337 05663514521 015270� 0����������������������������������������������������������������������������������������������������ustar�00neilb���������������������������kgroup��������������������������000000 �000000 ������������������������������������������������������������������������������������������������������������������������������������������������������������������������# # Makefile for weblint # BINDIR = /usr/local/bin MANDIR = /usr/local/man/man1 PSROFF = groff -Tps PSVIEW = ghostview PROGRAM = weblint PSFILE = $(PROGRAM).ps VERSION = 1.005 TARFILE = $(PROGRAM)-$(VERSION).tar TGZ = $(TARFILE).gz all: $(PROGRAM) $(PSFILE) install: $(PROGRAM) -cp $(PROGRAM) $(BINDIR) -chmod 755 $(BINDIR)/$(PROGRAM) -cp $(PROGRAM).1 $(MANDIR) -chmod 644 $(MANDIR)/$(PROGRAM).1 $(PSFILE): $(PROGRAM).1 $(PSROFF) -man $(PROGRAM).1 > $(PSFILE) preview: $(PSFILE) $(PSVIEW) $(PSFILE) tar: clean $(PROGRAM) $(PSFILE) ( \ cd .. ; \ tar cvf $(TARFILE) $(PROGRAM)-$(VERSION) ; \ gzip $(TARFILE) ; \ mv $(TGZ) $(PROGRAM)-$(VERSION) \ ) clean: $(RM) -f *~ $(PSFILE) $(TARFILE) $(TGZ) entially unclosed elements. For example: <A HREF="..." anchor text </A> * Check for expected attributes, where an element has no required attributes, but at least one attribute is expected (e.g. anchors). * Added a simple Makefile * Now understands the elements which are c��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������