dotextwrap(1)

✨ dotextwrap(1) — the line-folding filter that speaks every language 💅

okay bestie, sit down, because dotextwrap from the General Commands Manual is about to become your new obsession. it's a manual page, it's a whole vibe, and it's lowkey genius. 🦋

🌸 NAME 🌸

dotextwrap — a line-folding (text-wrapping) filter program with i18n support. that's it, that's the girl. 👑

✨ SYNOPSIS ✨

dotextwrap [<columns> [<tabs> [<header1> [<header2>]]]]

four optional args, nested like little matryoshka dolls. cute. 🎀

💖 DESCRIPTION 💖

so dotextwrap is a small filter whose whole job is wrapping text or folding lines. and when we say text-wrapping, we mean formatting a given text by adding newline characters at proper positions so the text fits the given width (or number of columns) of the terminal. it's giving tailor-made, custom-fitted, measured-to-your-window. ✂️✨

and because it's a filter, it reads from standard input and writes to standard output. no files touched, no mess, we love a low-maintenance icon. 🫶

now here's the part where it devours the other softwares: unlike other softwares, this supports internationalization. not me being dramatic, it's literally true. 😭 let's go through the receipts, one by one:

1. first — it automatically detects the current LC_CTYPE locale and follows it. it just knows. main character energy fr fr. 🔮
2. second — it supports multibyte encodings such as UTF-8 and EUC-JP. in multibyte encodings, one character consists from one or more bytes. yes, one whole vibe can be multiple bytes, she contains multitudes. 🦋
3. third — it supports fullwidth characters such as CJK Ideogram, Katakana, Hiragana, and Hangul. these characters occupy two columns per one character on the terminal. double the width, double the slay. 💅
4. fourth — it supports combining characters such as Thai and accents for Latin scripts. these characters occupy zero columns per one character on the terminal. zero. invisible. ghost mode. 🙈
5. fifth — it supports languages which do not use whitespaces between words. in these languages, lines can be folded at any places with small amount of exception (such as before commas). breaking wherever it wants, with just a tiny bit of manners. iconic behaviour honestly. 🍓

🌈 SEE ALSO 🌈

go read these next, bestie, the lore is deep:

• Manual pages of textwrap(3)
• setlocale(3)
• locale(7)
• charsets(7)
• UTF-8(7)

iykyk. 📚💜

👑 AUTHOR 👑

Tomohiro KUBOTA <kubota@debian.org>.

and that's the whole page, no cap. this beauty dropped on 2003-08-24 and it's still living in the General Commands Manual like the legend it is — dotextwrap(1), forever and always. periodt. 💖🌸✨