DWFILTER(1)

💖 DWFILTER(1) — reformat text for processing 💖

okay bestie, so dwfilter is a little program from the dwdiff family — manual page number one, section one, in case you were wondering — and honestly? she's giving glow-up assistant. let's get into it. 🦋

---

✨ NAME ✨

dwfilter — reformat text with dwdiff for further processing

---

🌸 SYNOPSIS 🌸

dwfilter [OPTIONS] OLD FILE NEW FILE POST PROCESSOR [POST PROCESSOR OPTIONS]

---

💅 DESCRIPTION 💅

So here's the vibe: dwfilter takes the text in the old file and reformats it according to what's in the new file (or the other way around, we'll get to that). Then it takes that freshly reformatted old file and the new file and shoves them both through a secondary filter. Two-for-one, iconic.

Why would you even want this? Because visual diff programs like meld and kdiff3 are amazing and you love them, but they get all dramatic when a text file has been reformatted after editing. dwfilter fixes that so you can still use them. fr fr.

Bonus use case: it lets you create small patches even when the new text has been reformatted. slay.

And for the reformatting part? dwfilter uses dwdiff. obviously. 💁‍♀️

---

🎀 OPTIONS 🎀

• -r, --reverse — flip the whole thing around: reformat the new file based on the contents of the old file, instead of the default where the old file gets reformatted based on the contents of the new file. main character energy, but backwards. 🔄

and also — dwfilter accepts all of these dwdiff options:

• -d delimiters, --delimiters=delimiters
• -P, --punctuation
• -W whitespace, --white-space=whitespace
• -i, --ignore-case
• -I, --ignore-formatting
• -D option, --diff-option=option
• -Cnum, --context=num
• -mnum, --match-context=num
• --aggregate-changes
• --wdiff-output
• -A algorithm, --algorithm=algorithm
• --profile=name, --no-profile

not me explaining all of these here tho — see the dwdiff manual page for the meaning. iykyk, bestie, i'm not doing the homework for you. 😭

file name tea: a single dash (-) as a file means standard input. only one file can be read from standard input, so don't get greedy. 🙈

And if you've got file names that start with a dash and you don't want dwfilter mistaking them for options? just drop a double dash (--) and everything after it gets interpreted as files to read. problem solved, periodt. ✨

---

💀 BUGS 💀

If you think you've found a bug — first of all, deep breaths — please check that you're using the latest version of dwdiff at <http://os.ghalkes.nl/dwdiff.html>. 👑

When you report bugs, please include a minimal example that demonstrates the problem. like, the smallest possible thing that still breaks. help them help you, bestie. 🫶

---

🌈 AUTHOR 🌈

G.P. Halkes <dwdiff@ghalkes.nl>

---

⭐ COPYRIGHT ⭐

Copyright © 2006-2010 G.P. Halkes

dwdiff is licensed under the GNU General Public License version 3. 💜

For more details on the license, see the file COPYING in the documentation directory. On Un*x systems this is usually /usr/share/doc/dwdiff-$VERSION$.

---

🦋 SEE ALSO 🦋

dwdiff(1), diff(1), meld(1), kdiff3(1)

---

and that's the whole page, babe 🎀 — this was Version $VERSION$, dated 2018/12/06, and yes it's DWFILTER(1) all the way through. go forth and diff pretty. 💖✨🌸