SYNOPSIShxname2id [ -x ] [ file ]
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.
OPTIONSThe following options are supported:
- Use XML conventions: empty elements are written with a slash at the end: <IMG />
OPERANDSThe following operand is supported:
- The name of an HTML file. If absent, standard input is read instead.
DIAGNOSTICSThe following exit values are returned:
- Successful completion.
- > 0
- An error occurred in the parsing of the HTML file. hxname2id will try to correct the error and produce output anyway.
The error recovery for incorrect HTML is primitive.