NAME

       xml2asc - convert UTF-8 to &#nnn; entities

SYNOPSIS

       xml2asc

DESCRIPTION

       Reads  an UTF-8 encoded text from standard input and writes to standard output, converting
       all non-ASCII characters to &#nnn; entities, so that the result is ASCII-encoded.

       One example use is to convert ISO-8859-1 to ASCII with &#nnn; entities, by  first  running
       asc2xml to convert ISO-8859-1 to UTF-8 and then pipe the result into xml2asc to convert to
       ASCII with &#nnn; entities for all accented characters.

       To test if a file is correct UTF-8, ignore the output and test  the  exit  code,  e.g.  in
       Bash:

           xml2asc <myfile >/dev/null && echo "OK" || echo "Fail"

DIAGNOSTICS

       xml2asc returns with a non-zero exit code if the input was not UTF-8.

SEE ALSO

       asc2xml(1), UTF-8 (RFC 2279)

BUGS

       Doesn't distinguish mark-up from content, so if the input uses non-ASCII characters in XML
       element names, they will be output with numerical entities in them, which is not legal  in
       XML.