BATDIFF(1)

📦 version 2024.08.24, in arch rolling

💅 bestie, meet batdiff(1) 💅

okay so this is the General Commands Manual page for batdiff, and she’s lowkey iconic. no cap, she’s here to make diffs make sense. 🦋

🎀 NAME 🎀

batdiff — diff a file against the current git index, or display the diff between two files. that’s the whole assignment, bestie. 💖

✨ DESCRIPTION ✨

this script supports using delta as an alternative highlighter for diffs. slay. literally built for when you want your diffs to look cute and be readable. 🫶

🌸 USAGE 🌸

batdiff [OPTIONS] FILE
batdiff [OPTIONS] FILE OTHER_FILE
batdiff --staged

three ways to run her, pick your main character moment. 👑

🦋 ENVIRONMENT 🦋

the env table is tiny but mighty:

  • BATDIFF_USE_DELTA=true — if delta is installed, use delta by default. that’s it, that’s the whole environment section, periodt. 🌈

💖 OPTIONS 💖

the option menu is giving short, long, and what it does — here’s the whole list, no skipping:

  • -C, --context=[LINES] — the number of lines to show before and after the differing lines. context queen. 💅
  • --delta — display diffs using delta. fancy highlighter energy. ✨
  • --color — force color output. we love a colorful moment. 🌈
  • --no-color — force disable color output. okay, monochrome bestie. 🖤
  • --paging=["never"/"always"] — enable/disable paging. you choose the vibe. 📄
  • --pager=[PAGER] — specify the pager to use. pick your little scroll guy. 🫶
  • --terminal-width=[COLS] — generate output for the specified terminal width. width-aware realness. 📐
  • --staged — show staged changes. git girlies rise. 💀

🔥 CAVEATS 🔥

big caveat energy, bestie — read these before you act brand new:

when using bat as the printer:

  • syntax highlighting in diffs between two files is not supported. not supported, fr fr. 😭
  • syntax highlighting in a single-file diff requires bat >= 0.15. version check, no cap. ⭐

when using delta as the printer:

  • the --no-color option does not remove all color output. the color stays a little bit, bestie. 💀

🫶 sign-off: that’s the BATDIFF(1) General Commands Manual page — no source/version/date line here, just this cute little footer vibe. stay diffy 💖

📦 where this page comes from