X-Git-Url: https://git.distorted.org.uk/u/mdw/putty/blobdiff_plain/12994a99cafd5cf7800fffeecd3dd9e76456b286..d9c40fd6ed72588278c633ee5db5c2eefad6ba7c:/unix/pterm.1 diff --git a/unix/pterm.1 b/unix/pterm.1 index 345fb76d..8e55e946 100644 --- a/unix/pterm.1 +++ b/unix/pterm.1 @@ -84,7 +84,7 @@ default using the \fILoginShell\fP resource. Tells \fIpterm\fP not to display a scroll bar. .IP "\fB-sb\fP" Tells \fIpterm\fP to display a scroll bar: this is the opposite of -\fI-ls-\fP. This is the default option: you will probably only need +\fI-sb-\fP. This is the default option: you will probably only need to specify it explicitly if you have changed the default using the \fIScrollBar\fP resource. .IP "\fB-log\fP \fIfilename\fP" @@ -103,12 +103,29 @@ resources which do not have their own command-line options. For example: pterm -xrm 'ScrollbarOnLeft: 1' +.IP "\fB-help\fP, \fB--help\fP" +Display a message summarizing the available options .SH X RESOURCES \fIpterm\fP can be more completely configured by means of X resources. All of these resources are of the form \fIpterm.FOO\fP for some FOO; you can make \fIpterm\fP look them up under another name, such as \fIxyz.FOO\fP, by specifying the command-line option "-name xyz". +.IP "\fBpterm.CloseOnExit\fP" +This option should be set to 0, 1 or 2; the default is 2. It +controls what \fIpterm\fP does when the process running inside it +terminates. When set to 2 (the default), \fIpterm\fP will close its +window as soon as the process inside it terminates. When set to 0, +\fIpterm\fP will print the process's exit status, and the window +will remain present until a key is pressed (allowing you to inspect +the scrollback, and copy and paste text out of it). + +When this setting is set to 1, \fIpterm\fP will close +immediately if the process exits cleanly (with an exit status of +zero), but the window will stay around if the process exits with a +non-zero code or on a signal. This enables you to see what went +wrong if the process suffers an error, but not to have to bother +closing the window in normal circumstances. .IP "\fBpterm.TerminalType\fP" This controls the value set in the TERM environment variable inside the new terminal. The default is "xterm". @@ -218,6 +235,11 @@ not drive you crazy. The bell overload mode is activated by receiving N bells in time T; after a further time S without any bells, overload mode will turn itself off again. + +Bell overload mode is always deactivated by any keypress in the +terminal. This means it can respond to large unexpected streams of +data, but does not interfere with ordinary command-line activities +that generate beeps (such as filename completion). .IP "\fBpterm.BellOverloadN\fP" This option counts the number of bell characters which will activate bell overload if they are received within a length of time T. The