NAME

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

SYNOPSIS

       gv-update-userconfig [filename]

DESCRIPTION

       gv-update-userconfig is a simple script to update an .gv config file to the current version of gv(1).

       You  can  specify  a  file  which is used instead of .gv by using the optional filename argument. This is
       useful if the environment variable XUSERSEARCHPATH is used.

       This is done by removing all entries known to cause problems with the current version of GNU gv (i.e. the
       one  the  version  of  this  program belongs to) and updating the version information in that file.  This
       resets all problematic items back to the default values.

       -h, --help, --usage
              displays a short help message

       -r     removes all resources from ~/.gv that equal the  default  resources  being  shipped  with  GNU  gv
              (ignoring whitespaces).

       -n     switches  to  alternative navigation by adding resp. updating navigation resources to ~/.gv, i. e.
              after each page switch (except if selected by the page number) the page is  scrolled  to  top  (if
              switching forward) resp. to the bottom (if switching backward).

       -N     switches to standard navigation by adding resp. updating navigation resources to ~/.gv.

       -s     removes navigation resources from ~/.gv and therefore enables standard navigation.

       -i     updates  translation file. Using the optional filename parameter is strongly recommended for using
              this option. This option cannot be used together with any of the other options.

BACKGROUND

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

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

       Sometimes older values miss things needed by the new GNU gv to work properly.  This GNU  gv  will  notice
       old (or missing) version information in this file and refuse to start until fixed.

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.