GV(1)

💖 GV(1) — the gv-update-userconfig glow-up page 💖

okay so bestie, welcome to the User Commands section of the manual, and today's main character is a little script called gv-update-userconfig. She's small. She's powerful. She fixes your config. Periodt. 🎀

✨ NAME ✨

gv-update-userconfig — update ~/.gv config file

✨ SYNOPSIS ✨

gv-update-userconfig [filename]

✨ DESCRIPTION ✨

gv-update-userconfig is a simple script whose whole job is updating an .gv config file so it matches the current version of gv(1). That's it. That's the task. She ate. 💅

You can also pass a filename — that's optional, btw — and she'll use that file instead of .gv. Super useful when the environment variable XUSERSEARCHPATH is in play. iykyk. 🦋

How does the magic happen? She removes every entry known to cause problems with the current version of GNU gv (i.e. the one the version of this program belongs to) and updates the version information inside that file. Which means all the problematic items get reset back to their default values. Fresh start energy. 🌸

Now the options, bestie, one by one, no skips:

• -h, --help, --usage — displays a short help message. That's the vibe check option. 🫶
• -r — removes all resources from ~/.gv that equal the default resources being shipped with GNU gv (and yes, it ignores whitespaces while doing it). ✨
• -n — switches to alternative navigation by adding resp. updating navigation resources to ~/.gv. Meaning: after each page switch (except if selected by the page number), the page is scrolled to top if you're switching forward, resp. to the bottom if you're switching backward. Iconic behaviour honestly. 🔥
• -N — switches to standard navigation by adding resp. updating navigation resources to ~/.gv. The lowercase/uppercase thing is real, don't mix them up. 😭
• -s — removes navigation resources from ~/.gv and therefore enables standard navigation. Clean slate, no navigation drama. 🧚
• -i — updates translation file. Using the optional filename parameter is strongly recommended for using this option. And this option cannot be used together with any of the other options. Like, she does NOT share the spotlight. 👑

✨ BACKGROUND ✨

The $(HOME)/.gv file is written by GNU gv when you activate the Save button in one of the configuration dialogs. 🎀

The values in there get used if there is no display-specific resource value — the kind loaded from $(HOME)/.Xresources at login time, or manually via xrdb(1). 🌈

Sometimes older values miss things that the new GNU gv needs in order to work properly. And when that happens? This GNU gv will notice the old (or missing) version information in this file and refuse to start until it's fixed. Not her being dramatic — she literally won't launch. 💀

✨ SEE ALSO ✨

• gv(1)
• xrdb(1)

✨ COPYRIGHT ✨

This manpage is Copyright © 2008 Bernhard R. Link and can be used, copied, distributed and/or modified without restrictions.

This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

and that's the whole page, bestie 🫶 this cutie lives under the name gv, version date 2008-07-31 — go forth and update those configs, mwah 💖✨🎀