VIS-DIGRAPH(1)

📦
version 0.9.r531.gd89b6c27 · 5 versions
, in arch rolling

💫 VIS-DIGRAPH(1) 💫

okay so bestie, listen — this is a page from section 1 of the General Commands Manual, which means it's a user command, and it's genuinely one of the cutest little tools ever. say hi to vis-digraph 👋

✨ NAME ✨

vis-digraph — print a Unicode character using mnemonics 🎀

like, you give it a lil mnemonic and it gives you the whole entire glyph back. iconic behavior honestly.

🦋 SYNOPSIS 🦋

vis-digraph digraph ...
vis-digraph -

two modes, two vibes, pick your fighter 💅

🌸 DESCRIPTION 🌸

so what it does: vis-digraph reads a digraph from a command line argument or from standard input, and then prints the corresponding Unicode character to standard output — encoded in the current locale. yes, the locale matters, we'll get to that. no cap.

  • digraph — a set of two (or more) characters that get replaced by a single Unicode character. that's the whole deal. two-ish chars in, one gorgeous glyph out 🧚
  • - — read the digraph from standard input instead. useful when you wanna pipe things in, iykyk 🫶

and here's the fun part: if you run it with no argument at all, vis-digraph displays all available digraphs along with a description. literally the full menu. obsessed 😭💖

🎀 ENVIRONMENT 🎀

  • LC_CTYPE — the locale definition, and it's the thing setting the encoding format of the Unicode character that gets printed out. see locale(1) for more info, bestie, it's all there 📚

🔥 EXIT STATUS 🔥

the numbers mean things, and the numbers are:

  • 0 — digraph correctly read, recognised and printed out. slay 💅✨
  • 1 — digraph not recognised. it said "who?" 🙈
  • 2 — the digraph is the beginning of an existing digraph, but it does not correspond to a full digraph. so close, but not a complete one — it's giving cliffhanger 💀
  • 3 — an error occurred and the digraph could not be read or printed. rough one 😔

🌈 SEE ALSO 🌈

(go read them, they're right there, it's a whole ecosystem 🦋)

⭐ STANDARDS ⭐

vis-digraph follows the digraph format from RFC 1345:

http://tools.ietf.org/rfc/rfc1345.txt

periodt. that's the standard, that's the source of truth 👑

heads up bestie: the encoding of what comes out depends on LC_CTYPE, so if your locale's weird, your output's gonna be weird too. not a bug, just locale things 🫶

and that's the whole page!! this is Vis version v0.9-531-gd89b6c27-dirty, dated January 27, 2017 — one of the docs in the VIS-DIGRAPH(1) family, and honestly? a lil legend. bye bestie, go print some glyphs 💖🎀🌸

📦 where this page comes from