XML2ASC(1)                      HTML-XML-utils                      XML2ASC(1)




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.

7.x                               10 Jul 2011                       XML2ASC(1)