pofilter(1)

💅 pofilter(1) — the vibe-check tool for your translations 💅

Okay so bestie, listen. This is pofilter from the Translate Toolkit, and honestly? It's giving quality control supervisor energy. It runs checks on your Gettext PO, XLIFF and TMX localization files and tells you what's sus. 🕵️‍♀️✨

---

🌸 SYNOPSIS 🌸

pofilter [--version] [-h|--help] [--manpage] [--progress PROGRESS]
[--errorlevel ERRORLEVEL] [-i|--input] INPUT [-x|--exclude EXCLUDE]
[-o|--output] OUTPUT [-l|--listfilters] [--review] [--noreview]
[--fuzzy] [--nofuzzy] [--nonotes] [--autocorrect] [--language LANG]
[--openoffice] [--libreoffice] [--mozilla] [--drupal] [--gnome] [--kde]
[--wx] [--excludefilter FILTER] [-t|--test FILTER] [--notranslatefile
FILE] [--musttranslatefile FILE] [--validcharsfile FILE]

Like, that's a lot of flags, but we're gonna go through every single one together, no cap. 🫶

---

✨ DESCRIPTION ✨

So here's the tea ☕: whenever a test fails, pofilter creates snippet files. Those little guys are the receipts — you can examine them, fix them up, and then merge them right back into the originals using pomerge. Iconic workflow, honestly. 💖

Want examples and usage instructions? The docs are literally right here:

http://docs.translatehouse.org/projects/translate-toolkit/en/latest/commands/pofilter.html

And for the full description of every single test (yes, all of them, grab a snack 🍓):

http://docs.translatehouse.org/projects/translate-toolkit/en/latest/commands/pofilter_tests.html

---

🎀 OPTIONS 🎀

Okay bestie, buckle up. Here's every flag, no skipping, periodt. 👑

• --version — show program's version number and exit. Slay, now you know what you're running. ✨
• -h, --help — show this help message and exit. Your classic "help me help you" moment. 💅
• --manpage — output a manpage based on the help. Meta af, we love a self-aware icon. 🌀
• --progress — show progress as: dots, none, bar, names, verbose. Pick your vibe: dots are cute, names is for the nosy girlies, verbose is for the "tell me everything" main characters. 👀
• --errorlevel — show errorlevel as: none, message, exception, traceback. none is giving "ignorance is bliss", traceback is giving "I want to see the whole crime scene". 💀
• -i, --input — read from INPUT in po, pot, tmx, xlf, xliff formats. Feed it your files, bestie. 🍽️
• -x, --exclude — exclude names matching EXCLUDE from input paths. Not today, satan. 🙈
• -o, --output — write to OUTPUT in po, pot, tmx, xlf, xliff formats. Same formats, same energy, new destination. 🎁
• -l, --listfilters — list filters available. A little menu of what this thing can do. Lowkey handy. 📋
• --review — include units marked for review (default). They're still in the group chat. 🫶
• --noreview — exclude units marked for review. Left on read. ✌️
• --fuzzy — include units marked fuzzy (default). The "kinda sorta maybe" translations get a seat at the table. 🌫️
• --nofuzzy — exclude units marked fuzzy. Sorry babes, you're not invited. 🚪
• --nonotes — don't add notes about the errors. Sometimes you just want the drama without the commentary. 🤫
• --autocorrect — output automatic corrections where possible rather than describing issues. Instead of "here's what's wrong ✍️", it's "here, I fixed it 💅". Only where possible though, don't get too excited.
• --language — set target language code (e.g. af-ZA) [required for spell check and recommended in general]. Fr fr, set it. Spell check literally won't work without it. 🗣️
• --openoffice — use the standard checks for OpenOffice translations. Preset unlocked. 🗂️
• --libreoffice — use the standard checks for LibreOffice translations. 🗂️
• --mozilla — use the standard checks for Mozilla translations. 🦊
• --drupal — use the standard checks for Drupal translations. 💧
• --gnome — use the standard checks for Gnome translations. 🐾
• --kde — use the standard checks for KDE translations. 💠
• --wx — use the standard checks for wxWidgets translations. 🧩
• --excludefilter — don't use FILTER when filtering. Blocked and reported. 🚫
• -t, --test — only use test *FILTER*s specified with this option when filtering. A very curated guest list — only the tests you named show up. 🎟️
• --notranslatefile — read list of untranslatable words from FILE (must not be translated). Hands off these ones. 🙅‍♀️
• --musttranslatefile — read list of translatable words from FILE (must be translated). These ones gotta get done. ✅
• --validcharsfile — read list of all valid characters from FILE (must be in UTF-8). Character guest list, and it's UTF-8 only, no exceptions. 🔤

---

💡 Quick reminder bestie: the snippet files that pop out when a test fails are your whole thing — check 'em, fix 'em, then pomerge them back into the originals. That's the cycle. That's the lifestyle. 🔁

---

And that's the whole page! ✨ Written by the Translate Toolkit 3.12.1 girlies, dated the same as always — you're looking at version 3.12.1, and yes, this is the pofilter(1) manual, mwah 💋🎀🦋