DETOX.TBL(5)

💖 DETOX.TBL 💖

okay bestie, welcome to the detox.tbl page, straight out of the File Formats Manual section of your local man pages 🎀 this is the whole vibe on how you tune the translation tables for detox(1) — the little tables that tell detox how to read your characters. let's get into it 🦋

---

✨ NAME ✨

detox.tbl — translation table for detox(1) 💅

---

🌸 OVERVIEW 🌸

so detox lets you configure how the safe, ISO-8859-1, and UTF-8 (aka Unicode) filters do their thing 💖 and the way you do that is through these text-based translation tables — they're literally just text files that let you tune how these character sets get interpreted. no cap, that's the whole concept ✨

---

🎀 SYNTAX 🎀

the format is genuinely so simple it's giving main character energy. there are exactly two levels: one for meta data, and one for the actual translations 🌈

• default _ — this sets the default translation for a character. here's the important part tho: if the default is empty or non-existent, that means any unknown character should fall through to the next filter 👑 and that's how you can chain multiple translation tables together in a sequence, one after another. iconic, honestly.
• start — marks the start of a value list inside the translation table ✨
• start lang — marks the start of a language specific value list inside the translation table 🦋
• end — marks the end of a value list inside the translation table 🫶
• value translation — the value can be written in decimal (1), hex (0x01), or octal (01). same rules that apply to sscanf apply here, fr fr. and translation can be a string or a quoted string, with either single or double quotes 💅

---

💜 EXAMPLES 💜

okay so here's a lil peek at part of a safe table, with only a few character replacements specified 🍓

#
# This is a simple example of a "safe" table.  It only translates 4 characters.
#
# The default is commented out, so any character that is not in this table will
# be ignored.
#

# default   _

#
# This is the main replacement block.  Each line specifies a character and a
# string to replace it with.
#

start
0x09    _tab_           # comments work on lines, too
0x24    _dollar_        # $$$
0x26    _and_           # ampersand
end

#
# Starts an optional, language-specific translation block.  detox will read
# your locale and load the block if the word after start matches the language
# portion of your locale.
#
# In the example here, the character $ will be replaced with "_money_" if the
# user is working in English.  If the user is using a different language, $
# will be replaced with the value configured in the previous block, "_dollar_".
#

start en
0x24    _money_         # money money
end

# EOF

and then you could enable this table in your ~/.detoxrc, hanging out with your other filters 💖

# Sample detoxrc

sequence default {
        safe {
                filename "/home/MYUSERNAME/.local/share/detox/safe.tbl";
        };
        safe;
        wipeup;
};

# EOF

so when detox runs, it'll run the custom safe filter first, then the default safe filter, and then finally the wipeup filter 🔥 head over to detoxrc(5) for more deets on all the various filter types, iykyk ✨

---

🌈 SEE ALSO 🌈

• detox(1)
• detoxrc(5)
• ascii(7)
• iso_8859-1(7)
• unicode(7)
• utf-8(7)

---

👑 AUTHORS 👑

detox was written by Doug Harple. periodt 💅

---

okay that's the whole page bestie, you ate that 🫶 this came to you from Debian, dated February 24, 2021 — go forth and translate your characters, mwah 💖✨🎀