HXUNENT(1)

✨ HXUNENT(1) ✨

okay bestie, listen up — this is hxunent from the HTML-XML-utils fam, and she is so much simpler than she sounds, i promise 💖

🌸 NAME 🌸

hxunent — replace HTML predefined character entities by UTF-8 💅

🎀 SYNOPSIS 🎀

hxunent [ -b ] [ -f ] [ file ]

🦋 DESCRIPTION 🦋

so like, the hxunent command reads the file (or standard input if you don't give her one 🥺) and copies it over to standard output, except she swaps all the &-entities for their equivalent character, encoded as UTF-8. periodt.

for example: " becomes " and < becomes <. iconic behavior, honestly ✨

💖 OPTIONS 💖

here's everything she supports, no cap:

• -b — the five builtin entities of XML (< > " ' &) are not replaced, they just get copied through unchanged. you need this if the output has to be valid XML or SGML. like, it's not a vibe thing, it's a requirement thing 🫶
• -f — this one changes how unknown entities or lone ampersands get handled. normally they're copied unchanged (she's chill like that), but with this flag she tries to "fix" them by replacing ampersands with &. ngl, those stray ampersands are usually what happens when you copy-paste URLs into a document 😭 and fr fr, this option does actually fix them and make the document valid. main character energy.

💀 DIAGNOSTICS 💀

her exit value is 0 if everything went well ✨ otherwise:

1. 1 — the input couldn't be read (file not found, file not readable... the usual tragic reasons 🙈)
2. 2 — wrong command line arguments. bestie. what did you type.

🌈 SEE ALSO 🌈

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

🍓 BUGS 🍓

okay so, real talk — the program assumes entities are as defined by HTML. she does not read a document's DTD to find the actual definitions in use in that document. so like, if your doc is being weird about its entities, that's why 🥲

and heads up: with -f, she will even remove all entities that are not HTML entities. yes, all of them. not a drill 💀

that's the whole page, bestie 🧚 — written for the HTML-XML-utils collection, version 7.x, dated 10 Jul 2011. go forth and unent, you've got this 👑💜