name2id(1) - Linux man page

Name

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

Synopsis

name2id [ -x ] [ file ]

Description

The name2id command reads an HTML file and looks for elements with an A element has 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 multitoc, require IDs on headings instead of A elements with NAME attributes. So it is useful to run name2id prior to running multitoc and similar program. name2id 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.

Exit Status

The following exit values are returned:
  1. Successful completion.
    >0
    An error occurred in the parsing of the HTML file. name2id will try to correct the error and produce output anyway.

    See Also

    num(1), normalize(1), xml2asc(1) asc2xml(1) multitoc(1) toc(1)

    Bugs

    The error recovery for incorrect HTML is primitive.