..


.. "INCL" "1" "15 Feb 2008" "4.x" "HTML-XML-utils"

"INCL" "1" "15 Feb 2008" "4.x" "HTML-XML-utils"

Table of contents


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 a comment is replaced by the file whose name is given as the attribute 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 />.
-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.

DIAGNOSTICS

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

SEE ALSO

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

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.