NAME

       hxname2id - move some NAME and ID attributes from an A to its parent

SYNOPSIS

       hxname2id [ -x ] [ file ]

DESCRIPTION

       The hxname2id command reads an HTML file and looks for elements with an A element as first
       child, with no intervening text other than whitespace. If that A element has an ID or NAME
       attribute, it is moved to the parent element and removed from the A.

       Because  Netscape  4  doesn't  understand  ID  attributes, it was common practice to write
       <H2><A NAME="sect7">...</A></H2> instead of <H2 ID="sect7">. This program can be  used  to
       convert such old HTML files to the new convention.

       Other  programs in this suite, such as hxmultitoc(1), require IDs on headings instead of A
       elements with NAME attributes.  So  it  is  useful  to  run  hxname2id  prior  to  running
       hxmultitoc and similar program.  hxname2id can be used in a pipe.

OPTIONS

       The following options are supported:

       -x        Use XML conventions: empty elements are written with a slash at the end: <IMG />

OPERANDS

       The following operand is supported:

       file      The name of an HTML file. If absent, standard input is read instead.

DIAGNOSTICS

       The following exit values are returned:

       0         Successful completion.

       > 0       An  error  occurred  in  the  parsing  of  the HTML file.  hxname2id will try to
                 correct the error and produce output anyway.

SEE ALSO

       asc2xml(1), hxmultitoc(1), hxnormalize(1), hxnum(1), hxtoc(1), xml2asc(1)

BUGS

       The error recovery for incorrect HTML is primitive.