htmerge(1)

💖 htmerge(1) — the merge bestie 💖

General Commands Manual ✨ htmerge — create document index and word database for the ht://Dig search engine 🎀

🌸 NAME 🌸

htmerge — bestie, this is the girl who takes the files htdig made and turns them into a document index and a word database. Then htsearch uses those databases to actually, like, do the searching. She's the middle child and she ATE 💅

✨ SYNOPSIS ✨

htmerge [options]

🦋 DESCRIPTION 🦋

Okay so listen. Htmerge creates a document index and a word database out of the files that were created by htdig. Those databases are then used by htsearch to perform the actual searched. (yes bestie, "the actual searched" — that's the original's whole vibe, we respect it 🫶)

It's giving pipeline. It's giving teamwork. It's giving htdig → htmerge → htsearch and honestly? iconic.

🎀 OPTIONS 🎀

• -a — Use alternate work files. This tells htdig to append .work to database files, which causes a second copy of the database to be built. Why would you want that? Because it lets the original files keep being used by htsearch while the indexing run is happening. No downtime, no drama 💖
• -c configfile — Use the specified configfile instead of the default one. You're the main character, you pick your own config ✨
• -d — Prevent the document index from being created. Just… don't make it. Periodt.
• -s — Print statistics about the document and word databases after htmerge has finished. Receipts! Show me the numbers 📊
• -v — Run in verbose mode. This gives you some hints about the progress of the merge. Lowkey a lifesaver when you're running htmerge interactively, because some parts — especially the word database creation — can take a very long time. Like, go-get-a-snack long. Go-touch-grass long 😭
• -w — Prevent the word database from being created. Same energy as -d, but for the words 🚫

🌈 ENVIRONMENT 🌈

• TMPDIR — On top of the command line options, the environment variable TMPDIR will be used to designate the directory where intermediate files are stored during the sorting process. So if your /tmp is a mess, that's a you problem, bestie 🫶

🍓 FILES 🍓

• /etc/htdig/htdig.conf — The default configuration file. The one she reaches for when you don't hand her a -c 💅

👑 SEE ALSO 👑

Please refer to the HTML pages (in the htdig-doc package) /usr/share/doc/htdig-doc/html/index.html and the manual pages htdig(1) and htsearch(1) for a detailed description of ht://Dig and its commands.

tl;dr of the tl;dr: go read the docs, they're right there, iykyk 📚

💜 AUTHOR 💜

This manual page was written by Christian Schwarz, modified by Stijn de Bekker, based on the HTML documentation of ht://Dig. Shoutout to the OGs 🫡

and that's the whole page, bestie!! this iconic little manual dropped on 21 July 1997 as part of htmerge(1) in the General Commands Manual — fr fr a classic, no cap, she's been slaying since before some of us were born 💀✨🌸