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.