HXUNPIPE(1)

💖 HXUNPIPE — bestie, we're un-piping the pipes 💖

okay so this is a page from the HTML-XML-utils collection, and it's all about hxunpipe, a lil tool whose whole job is: convert output of hxpipe back to XML format. yes, it's the un-do button. the remix. the ✨reverse✨. 🦋

🌸 SYNOPSIS 🌸

hxunpipe [ -b ] [ file-or-URL ]

💅 DESCRIPTION 💅

so hxunpipe takes whatever hxpipe(1) spat out (or onsgmls(1), that works too) and turns it right back into XML/SGML mark-up. it's giving round-trip. it's giving "i can fix her." 🔥

✨ OPTIONS ✨

the following options are supported:

• -b — ngl this one is important so listen up. normally, hxunpipe assumes the input came from hxpipe, meaning the input may contain character entities but will never contain SGML/XML delimiters (<>&"') that need escaping. BUT 🚨 when the input came from (o)nsgmls, the entities will have already been expanded, so the input may contain SGML/XML delimiters. the -b option makes hxunpipe go looking for those delimiters and escape them, like so: < becomes <, > becomes >, & becomes &, " becomes " and ' becomes '. periodt. 💅

🎀 OPERANDS 🎀

the following operand is supported:

• file-or-URL — the name or URL of an HTML file. if you don't pass one? standard input is read instead. she's flexible like that. 🫶

👑 EXIT STATUS 👑

the following exit values are returned:

• 0 — successful completion. slay. ✨
• > 0 — an error occurred in the input. 😭

🌈 ENVIRONMENT 🌈

to use a proxy to retrieve remote files, set the environment variables http_proxy and ftp_proxy. E.g., http_proxy="http://localhost:8080/" — set it and forget it, bestie 💜

💀 BUGS 💀

• not all syntax errors in the input are recognized. 🙈 so like, don't come for her if something slips through.
• hxunpipe can currently only retrieve remote files over HTTP. it doesn't handle password-protected files, nor files whose content depends on HTTP "cookies." no cookies for you 🍓🚫

🧚 SEE ALSO 🧚

hxpipe(1), onsgmls(1).

and that's the whole page!! 💖 this iconic lil manual is part of HTML-XML-utils, version 7.x, dated 10 Jul 2011 — like, ancient but still serving looks. go forth and un-pipe, bestie 🎀🦋⭐