1PRWD(1)                   BSD General Commands Manual                  PRWD(1)
2

NAME

4     prwd — universal shell prompt
5

SYNOPSIS

7     prwd [-aVh]
8

DESCRIPTION

10     prwd is a replacement for your shell's PS1, it provides a simple templat‐
11     ing language with commands to customize your prompt.  prwd keeps your
12     prompt consistent between shells, provides fast template commands to dis‐
13     play contextual information such as hostname, path, current git/hg branch
14     without an inordinate amount of slow shell scripting.
15
16     The command-line options are as follows:
17
18     -V      Show current version.
19
20     -h      Show usage.
21
22     -t template
23             Use the provided template instead of the one defined in the con‐
24             figuration file or the one defined in the environment variable
25             PRWD.  This is particularly useful for testing a new template.
26             Use single quote (') around your template to avoid your shell to
27             expand the $ variable.
28
29     -a      Outputs all the aliases starting with '$' as shell variable
30             exports. The output from this command is meant to be used with
31             eval in your .profile file, see section ALIAS VARIABLES in the
32             prwdrc(5) manual for more detailed information.
33

ENVIRONMENT

35     prwd can read its template from a configuration file, a command-line
36     parameters or the following environment variable:
37
38     PRWD        The template used to render your prompt.  This value will
39                 override the default internal template and can be overridden
40                 by the configuration file.
41

FILES

43     ~/.prwdrc  defines all the configuration, overrides PRWD and the internal
44                defaults.  See prwdrc(5) for configuratiom syntax and parame‐
45                ters.
46

SETUP

48     You'll need to place this line in your ~/.profile (your mileage may
49     vary):
50
51           export PS1='`prwd`'
52

SEE ALSO

54     prwdrc(5), pwd(1), csh(1), ksh(1), sh(1), getcwd(3)
55

AUTHORS

57     prwd was written by Bertrand Janin <b@janin.com> and is distributed under
58     an ISC license (BSD compatible, OSI compatible).
59
60BSD                              June 20, 2019                             BSD
Impressum