XAPIAN-COMPACT(1)

πŸ’… XAPIAN-COMPACT(1) β€” bestie edition πŸ’…

okay so this is a page from the User Commands manual, and it's about xapian-compact, which is genuinely one of those little tools that eats. let me walk you through it 🫢


✨ NAME ✨

xapian-compact β€” compact a database, or merge and compact several

🌸 SYNOPSIS 🌸

xapian-compact [OPTIONS] SOURCE_DATABASE... DESTINATION_DATABASE

πŸ¦‹ DESCRIPTION πŸ¦‹

xapian-compact β€” compact a database, or merge and compact several

like... that's the whole vibe. you give it one or more source databases and a destination, and it compacts/merges. iconic behavior tbh πŸ’–


πŸŽ€ OPTIONS πŸŽ€

  • -b, --blocksize=B β€” sets the blocksize in bytes (like 4096) or in K (like 4K). it must be between 2K and 64K and a power of 2, and the default is 8K. no cap, those are the rules ✨
  • -B, --backend=B β€” sets the output backend. the supported values are 'glass' and 'honey'. by default the input's backend is used. at present only glass to honey conversion is implemented β€” otherwise the backend must be the same πŸ‘‘
  • -n, --no-full β€” disables full compaction
  • -F, --fuller β€” no effect for glass since Xapian 1.4.31 (yeah, it's just vibing there πŸ’€)
  • -m, --multipass β€” if you're merging more than 3 databases, this merges the postlists in multiple passes. it's generally faster but requires more disk space for temporary files πŸ“
  • --no-renumber β€” preserves the numbering of document ids. useful if you have external references to them, or have set them to match unique ids from an external source. > heads up bestie: currently this option is only supported when merging databases if they have disjoint ranges of used document ids 😭
  • -s, --single-file β€” produces a single file database
  • --help β€” display this help and exit
  • --version β€” output version information and exit

πŸ’œ a little sign-off πŸ’œ

this page is from xapian-core 2.0.0, dated March 2026, and it's literally the XAPIAN-COMPACT(1) manual page. slay, go compact something, ily bye πŸ’…βœ¨πŸ¦‹

πŸ“¦ where this page comes from