gwu(1)

💖 gwu — the dump-your-database era 💖

okay bestie, welcome to gwu(1), a General Commands Manual page, and honestly? it's giving "quietly essential". pull up a chair, grab a strawberry 🍓, and let's get into it.

✨ NAME ✨

gwu — dump a GeneWeb database 💅

🌸 SYNOPSIS 🌸

gwu [ options ] < base_file >

🦋 DESCRIPTION 🦋

so gwu dumps the contents of the GeneWeb database to standard output. that's the whole vibe. it's a genuinely good way to back the database up in a neutral form, and it can also make upgrades to new software way easier. no cap.

the primary documentation of gwu lives in the HTML documentation, which you can find in the documentation directory — that's /usr/share/doc/geneweb on Debian systems. please go look there for the complete and up-to-date documentation, bestie, because this page is the snack and that one's the whole meal 🫶

👑 OPTIONS 👑

• -help — command-line help. that's it, that's the girl 💁‍♀️
• -o <file> — output file name (else it goes to stdout)
• -odir <dir> — create files from the original name in directory (else they go on the -o file)
• -mem — save memory space, but slower 😭 (the eternal tradeoff)
• -a <1st_name> [num] <surname> — select ancestors of ...
• -d <1st_name> [num] <surname> — select descendants of ...
• -ad <1st_name> [num] <surname> — select ancestors of ... and all their descendants. heads up: it has no effect if -a and/or -d are used, and option -nsp is forced. periodt.
• -aws <1st_name> [num] <surname> — select ancestors with siblings 🧚
• -s <surname> — select this surname (this option can be used several times)
• -nsp — no spouses' parents (applies to options -s and -d)
• -nn — no (database) notes 🙈
• -c <num> — when a person is born less than <num> years ago, it is not exported unless it is Public. all the spouses and descendants are also censored. 🫣
• -sep 1st_name.num surname — to use together with the option -odir: separate this person and all their ancestors and descendants sharing the same surname. all the concerned families are displayed on standard output instead of their associated files. this option can be used several times.
• -sep_only_file <file> — with option -sep, tells it to separate only groups of that file.
• -sep_limit <num> — when using the option -sep, groups of families can become isolated in the files. gwu reconnects them to the separated families (i.e. displays them to standard output) if the size of these groups is less than 21. this option changes that limit.

fr fr, go read the HTML docs too. this page is the highlight reel, not the director's cut 💜

and that's the whole page, bestie 🌈 this icon of a manual page is dated 2002 October 16th, and it's from gwu(1) — yeah, she's been serving since 2002 and she still ate 💅✨ mwah, go dump that database 🎀