surfraw-update-path - Man Page

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).

2024-07-20 perl v5.40.0 User Contributed Perl Documentation