incl

Langue: en

Version: 18 Mar 2000 (fedora - 04/07/09)

Section: 1 (Commandes utilisateur)

NAME

incl - expand included HTML or XML files

SYNOPSIS

incl [ -x ] [ -b base ] [ file-or-URL ]

DESCRIPTION

The incl command copies an HTML or XML file to standard output, looking for comments with a certain structure. Such an comment is replaced by the file whose name is given as the atrribute of the directive. For example:

  ...<!-- include "foo.html" -->...
 
 

will be replaced by the content of the file foo.html. It is important to note that you must quote filenames if they contain whitespace.

OPTIONS

The following options are supported:
-x
Use XML conventions: empty elements are written with a slash at the end: <IMG /> Also causes the name of the attribute (see option -a) to become case-sensitive.
-b base
Sets the base URL for resolving relative URLs. By default the file given as argument is the base URL.

OPERANDS

The following operand is supported:
file-or-URL
The name of an HTML or XML file or the URL of one. If absent, standard input is read instead.

EXIT STATUS

The following exit values are returned:
0
Successful completion.
>0
An error occurred in the parsing of one of the HTML or XML files.

SEE ALSO

xml2asc(1), UTF-8 (RFC 2279), normalize(1), num(1), toc(1), htmlprune(1). unent(1) asc2xml(1)

BUGS

Assumes UTF-8 as input. Doesn't expand character entities. Instead pipe the input through unent(1) and asc2xml(1) to convert it to UTF-8.