This Appendix documents the resource file for PowerShell (stored as ~/.pshellrc). Please note that this format is rigid, since the parser is not very robust. Spacing is important as well as capitalization.
Note: Editing this file by hand is no longer necessary, since all of the options can now be modified through the Preferences dialog.
The file generally starts with the definitions of the applications to put in the File menu. They are in the following format:
[app] tcsh /bin/tcsh New _tcsh tab
Each application definition must begin with [app]. The second line (tcsh in this example) is the title that will be put in the notebook tab when the program is started. The third line is the program to be run. The full path must be included. The last line contains the text to put in the File menu for this option.
This section, which begins with [options], simply contains a number of lines which define various program options. They have the following format:
<variable> <value> [<value 2> ... <value n>]
Each variable has at least one value assigned to it. Many are simply 'true' or 'false' (note that capitalization matters.) Many are assigned a string (such as the font variable) and some (such as fg, which represents the foreground color) have several values. There is only a single space between the variable name and its value, and never an equal sign or any other character.
The last section, which begins with [colors], is simply the RGB values for the color palette to use, 3 per line, with 18 lines. The last two are ignored (they are replaced in the palette by the foreground and background colors as defined in the [options] section.
The file must end with the text [eof].