surfraw-update-path man page

surfraw-update-path — updates PATH in shell config files

Synopsis

surfraw-update-path [-add] [-remove] [-check] [-sys] [-all] [-help] [-shell=SHELL]

Description

surfraw-update-path adds the surfraw elvi directory (/usr/libexec/surfraw) to your PATH in your shell's config file.

Currently it supports bash, sh, csh, tcsh, ash, dash, ksh, pdksh, zsh, rc, and es

Don't forget to login again or source your login files for it to take effect.

Options

-check
Checks to see if the surfraw config code is present. This is the default.
-add
Adds the surfraw config code.
-remove
Removes the surfraw config code
-sys
Updates the system-wide shell config instead of the user. Must be done as root.
-shell=SHELL
Selects the shell to configure. Defaults to the value of the $SHELL environment variable.

Currently supported shells are:

sh, ash, bash, dash, csh, tcsh, ksh, pdksh, zsh, rc, and es.
-all
Attempts to configure the startup files for all known shells
-help
Gives a usage message

Return Value

-check returns 0 if the surfraw code is present in the file, 1 if it is not found, or 2 on error.

All other options return 0 on success, or 2 on error.

Environment

SHELL
Used to determine which shell to configure, if -shell is not given.
HOME
Used to find users config files.
ENV
Used by posix-compliant shells to specify a startup rc file.
ZDOTDIR
Used to find user config files for zsh. If not set, defaults to HOME.

See Also

surfraw(1), sh(1), ash(1), bash(1), dash(1), csh(1), tcsh(1), ksh(1), pdksh(1), zsh(1), rc(1), es(1)

Author

Ian Beckwith <ianb@erislabs.net>

Referenced By

elvi.1sr(1), surfraw(1).

2016-02-05 perl v5.22.1 User Contributed Perl Documentation