PDP-10 Archive: info/vars.mss from mit_emacs_170_teco_1220 (original) (raw)

Trailing-Edge-PDP-10 Archives-mit_emacs_170_teco_1220- info/vars.mss

There are no other files named vars.mss in the archive.

@Unnumbered(Index of Variables)

An option is a variable whose value Edit Options offers for editing. A hook variable is a variable which is normally not defined, but which you can define if you wish for customization. Most hook variables require TECO programs as their values.

The default value of the variable is given in parentheses after its name. If no value is given, the default value is zero. If the word "nonexistent" appears, then the variable does not exist unless you create it.

@Begin(Description)

Abort Resumption Message @\This is the message to be printed by C-] to tell you how to resume the aborted command. If this variable is zero, there is no way to resume, so C-] asks for confirmation. @Note(Node="Quitting").

Additional Abbrev Expanders (nonexistent) @\If this variable exists when Word Abbrev mode is turned on, it is a string of characters which should terminate and expand an abbrev, in addition to the punctuation characters which normally do so. See also WORDAB Ins Chars.

After Compilation Hook (nonexistent) @\If this variable exists and is nonzero, then it is executed as a TECO expression by the function Compile, after compilation itself is finished. Exception: If the variable Compile Command is also nonzero, it overrides this hook. @Note(IName="After Compilation Hook", Node="Compile").

Atom Word Mode @\The minor mode Atom Word mode is on if this variable is nonzero. @Note(IName="Atom Word Mode", Name="Minor Modes", Node="MinorModes").

Auto Directory Display @\If this is nonzero, certain file operations automatically display the file directory. @Note(IName="Auto Directory Display", Name="Directories", Node="ListDir").

Auto Fill Mode @\The minor mode Auto Fill mode is on if this variable is nonzero. @Note(IName="Auto Fill Mode", Node="Filling").

Auto Push Point Notification @\The value of this variable is the string printed in the echo area by some commands to notify you that the mark has been set to the old location of point. @Note(IName="Auto Push Point Notification", Node="Search").

Auto Push Point Option (500)@\Searches set the mark if they move at least this many characters. @Note(IName="Auto Push Point Option", Node="Search").

Auto Save All Buffers @\If this is nonzero, auto save saves all buffers that are modified, not just the selected buffer. @Note(IName="Auto Save All Buffers", Name="Auto Save", Node="AutoSave").

Auto Save Default @\The minor mode Auto Save mode is on by default for newly visited files if this variable is nonzero. @Note(IName="Auto Save Default", Name="Auto Save", Node="AutoSave").

Auto Save Filenames (@ITS(DSK:;_SAV00

)@Twenex([SAVE]..)) @\These are the filenames used for auto saving if the visited filenames are not used. @ITS{If the last two characters of the first filename are "00", as they are by default, then they are replaced by the last two characters of the buffer number to get the filename actually used for saving}@Twenex{If the filename extension is null, the name of the buffer being saved is used instead}. @Note(IName="Auto Save Filenames", Name="Auto Save", Node="AutoSave").

Auto Save Interval (500) @\This is the number of characters between auto saves. @Note(IName="Auto Save Interval", Name="Auto Save", Node="AutoSave").

Auto Save Max (2) @\This is the maximum number of auto saves to keep. @Note(IName="Auto Save Max", Name="Auto Save", Node="AutoSave").

Auto Save Mode @\If this is nonzero, Auto Save mode is enabled. @Note(IName="Auto Save Mode", Name="Auto Save", Node="AutoSave").

Auto Save Visited File @\If this is nonzero, auto saving saves as the visited filenames. If this is zero, auto saving saves as the names which are the value of Auto Save Filenames (q.v.). @Note(IName="Auto Save Visited File", Name="Auto Save", Node="AutoSave").

Autoarg Mode @\When Autoarg Mode is nonzero, numeric arguments can be specified just by typing the digits. @Note(IName="Autoarg Mode", Node="Arguments").

Bottom Display Margin @\This controls the size of the region at the bottom of the screen which the cursor is not allowed to be in. If the cursor would normally move there, the window is recentered instead. The value is represented as a percentage of the screen size, and must not be negative or more than 99. It controls the TECO flag FS %BOTTOM. @Note(IName="Bottom Display Margin", Node="Display").

Buffer Creation Hook (nonexistent) @\If this variable exists and is nonzero, its value should be a TECO program to be executed whenever a newly created buffer is selected for the first time. @Note(IName="Buffer Creation Hook", Node="Buffers").

Buffer Deselection Hook (nonexistent) @\If this variable exists and is nonzero, its value should be a TECO program to be executed whenever a buffer is about to be deselected. The difference between this and Buffer Selection Hook is that, while both are executed (if they exist) when you switch buffers, this is executed before the switch, and Buffer Selection Hook is executed after the switch. @Note(IName="Buffer Deselection Hook", Node="Buffers").

Buffer Selection Hook (nonexistent) @\If this variable exists and is nonzero, its value should be a TECO program to be executed whenever a buffer is selected. @Note(IName="Buffer Selection Hook", Node="Buffers").

Case Replace (1) @\When Case Replace is nonzero, Replace String and Query Replace attempt to preserve case when they replace. @Note(IName="Case Replace", Node="Replace").

Case Search (1) @\If Case Search is nonzero, searches of all sorts allow upper case letters and lower case letters to match each other. It controls the TECO flag FS BOTH CASE. @Note(IName="Case Search", Node="Search").

Collapse in Comparison (nonexistent) @\If this variable exists and is not zero, it should be a string of characters for M-X Compare Windows to regard as insignificant. @Note(IName="Collapse in Comparison", Node="Windows").

Comment Begin @\This is the string used to start new comments. If it is zero, the value of Comment Start is used. @Note(IName="Comment Begin", Node="Comments").

Comment Column @\This is the column at which comments are aligned. @Note(IName="Comment Column", Node="Comments").

Comment End @\This is the string which is used to end comments. It is often empty for languages in which comments end at the end of the line. @Note(IName="Comment End", Node="Comments").

Comment Multi Line (nonexistent) @\If this variable exists and is nonzero, then when Auto Fill mode breaks a comment line, it does not insert a new comment starter on the new line. This is for use with languages that have explicit comment terminators, if you want single multi-line comments instead of single-line comments on consecutive lines. @Note(IName="Comment Multi Line", Node="Comments").

Comment Rounding (/8+1*8) @\This is the TECO program used to decide what column to start a comment in when the text of the line goes past the comment column. The argument to the program is the column at which text ends. @Note(IName="Comment Rounding", Node="Comments").

Comment Start @\This is the string used for recognizing existing comments, and for starting new ones if Comment Begin is zero. If Comment Start is zero, semicolon is used. @Note(IName="Comment Start", Node="Comments").

Compile Command (nonexistent) @\If this variable exists and is nonzero, its value should be a TECO program to be used by the M-X Compile command to compile the file. @Note(IName="Compile Command", Node="Compile").

Compiler Filename (nonexistent) @\If this variable exists and is nonzero, its value should be the name of the compiler to use, @Twenex{a filename}@ITS{suitable for a colon command}. By default, the name of the major mode is used as the name of the compiler. @Note(IName="Compiler Filename", Node="Compile").

Compiler Switches (nonexistent) @\If this variable exists and is nonzero, its value is used as switches for compilation. @Note(IName="Compiler Switches", Node="Compile").

Cursor Centering Point (40) @\This specifies how far from the top of the screen point ought to appear when a new window position is chosen. The value of the variable is the percentage of the screen size. It must not be negative or more than 99. It controls the TECO flag FS %CENTER. @Note(IName="Cursor Centering Point", Node="Display").

Default Major Mode (Fundamental) @\This is the major mode in which new buffers are created. If it is the null string, new buffers are created in the same mode as the previously selected buffer. @Note(IName="Default Major Mode", Node="Buffers").

Digit Shift Table (nonexistent) @\If this variable exists and is nonzero, its value should be a string containing the ten characters which are the upper case equivalents of the digits 0 through 9 on the keyboard being used. Meta-' (@w[^R Upcase] Digit) uses this table, and reads it from the user if the variable does not exist. @Note(IName="Digit Shift Table", Name="Fixing Typos", Node="Fixit").

Directory Lister (@w[& Subset] Directory Listing) @\This is the TECO program used for listing a directory for C-X C-D and the Auto Directory Display option. The default value is the definition of the function @w[& Subset] Directory Listing. @ITS{Another useful value is the definition of the function @w[& Rotated] Directory Listing.} @Note(IName="Directory Lister", Node="ListDir", Name="Directories").

Display Matching Paren (-1) @\This variable controls automatic display of the matching open parenthesis when a close parenthesis is inserted. @Note(IName="Display Matching Paren", Node="Matching").

Display Mode Line Inverse @\If this is nonzero, the mode line is displayed in inverse video or otherwise highlighted, on terminals which can support it. This controls the TECO flag FS INVMOD. @Note(IName="Display Mode Line Inverse", Name="Mode Line", Node="ModeLine").

Display Overprinting @\If this is nonzero, backspace characters and stray carriage return characters in the buffer display as actual overprinting rather than as ^H and ^M. This variable controls the TECO flags FS ^H PRINT and FS ^M PRINT. @Note(IName="Display Overprinting", Node="Characters").

Echo Area Height (3) @\This is the number of lines in the echo area. Its value should be at least one. It controls the TECO flag FS ECHO LINES. @Note(IName="Echo Area Height", Node="Screen").

EMACS Version @\This variable's value is the EMACS version number.

End of Buffer Display Margin (35) @\This specifies how far up the screen the end of the buffer is placed, if it is on screen at all, when a new window position is chosen. It is represented as a percentage of the screen size, and must not be negative or more than 99. Its value controls the TECO flag FS %END. @Note(IName="End of Buffer Display Margin", Node="Display").

Error Messages in Echo Area @\If this is nonzero, error messages are printed in the echo area instead of at the top of the screen. It controls the TECO flag FS ECHO ERRORS. @Note(IName="Error Messages in Echo Area", Node="Lossage").

@Twenex{ EXEC Name (nonexistent) @\If this variable exists, its value, if nonzero, is the filename of the program to be used by M-X Push to EXEC to serve as the EXEC. @Note(IName="EXEC Name", Node="Subforks").}

Exit Hook (nonexistent) @\If this variable exists and is nonzero, its value is a TECO program to be executed whenever EMACS is exited, instead of the normal action of doing an auto save. The subroutine @w[& Exit] EMACS is responsible for executing it. @Note(IName="Exit Hook", Node="Exiting").

@Twenex{ Exit to Inferior Hook (nonexistent) @\If this variable exists and is nonzero, its value is a TECO program to be executed whenever EMACS is about to invoke an inferior fork that is likely to read from the terminal. This is done in addition to all normal actions.}

Exit to Superior Hook (nonexistent) @\If this variable exists and is nonzero, its value is a TECO program to be executed whenever EMACS is about to return to its superior @ITS{job}@Twenex{fork}, in addition to all normal actions.

Fill Column (70) @\The value of Fill Column is the width used for filling text. It controls the TECO flag FS ADLINE. @Note(IName="Fill Column", Node="Filling").

Fill Extra Space List (.?!) @\The characters in this string are the ones which ought to be followed by two spaces when text is filled. @Note(IName="Fill Extra Space List", Node="Filling").

Fill Prefix @\The value of this variable is the prefix expected on every line of text before filling and placed at the front of every line after filling. It is usually empty, for filling nonindented text. @Note(IName="Fill Prefix", Node="Filling").

Indent Tabs Mode (-1) @\If Indent Tabs Mode is nonzero, then tab characters are used by the indent commands. Otherwise, only spaces are used. @Note(IName="Indent Tabs Mode", Name="Indenting Text", Node="TextIndent").

Setup Hook (nonexistent) @\If this variable exists and is nonzero, its value should be a TECO program to be executed when the library is loaded. The library's @w[& Setup] function is responsible for doing this. If the library has no @w[& Setup] function, it will not handle a setup hook either. @Note(Node="Libraries").

Kill Hook (nonexistent) @\Some libraries may execute the value of this variable, if it exists and is nonzero, when the library is being removed from core with Kill Libraries. This is done by the library's @w[& Kill] function; if the library has no @w[& Kill] Library function, it will not handle a kill hook. @Note(Node="Libraries").

Lisp Indent @\This variable controls the indentation within calls to the function . Actually, the variable used is not always Lisp Indent, but rather Indent, where is the value of Lisp Indent Language. @Note(IName="Lisp Indent", Node="Indenting").

Lisp Indent DEFanything (1) @\The value of this variable controls indentation within calls to functions whose names start with "def". Actually, the variable used is not always Lisp Indent DEFanything, but rather Indent DEFanything, where is the value of Lisp Indent Language. @Note(IName="Lisp Indent DEFanything", Node="Indenting").

Lisp Indent Language (Lisp) @\The value of this variable is the string used as the language name when looking for Indent variables. @Note(IName="Lisp Indent Language", Node="Indenting").

Lisp Indent Offset @\If nonzero, this selects an alternative default style of indentation for Lisp. Actually, the variable used is not always Lisp Indent Offset, but rather Indent Offset, where is the value of Lisp Indent Language. @Note(IName="Lisp Indent Offset", Node="Indenting").

Mail Reader Library (nonexistent) @\If this variable exists and is nonzero, it is the name of the library to be used by M-X Read Mail for reading mail and by M-X Send Mail for sending mail. The former calls the function "" in the library, and the latter calls the function "@w[& Mail] Message". @ITS{If the variable does not exist, the library RMAIL is used}. @Note(IName="Mail Reader Library", Node="Mail").

Mail Sender Library (nonexistent) @\If this variable exists and is nonzero, it specifies the library to be used by M-X Send Mail only, overriding Mail Reader Library. @Note(IName="Mail Sender Library", Node="Mail").

@Twenex{ Mail Reader Program (nonexistent) @\If this variable exists (and Mail Reader Library does not), it is the name of the the program to be used for reading and sending mail. @Note(IName="Mail Reader Library", Node="Mail").}

..D (nonexistent) @\This variable is used by the major mode to record the syntax table for that mode. It is created by the first use of the mode, and if you supply your value, that value will be accepted instead. For example, Text mode uses Text ..D. Not all major modes have their own syntax tables. @Note(Node="Syntax").

Mode Hook (nonexistent) @\If this variable exists and is nonzero, its value is a TECO program to be executed when the major mode is entered. For example, Text Mode Hook is executed when Text mode is entered. @Note(Name="Major Modes", Node="MajorModes").

Next Screen Context Lines (nonexistent) @\If this variable exists, its value specifies the number of lines of overlap between one screenful and the next, when scrolling by screens with C-V and M-V. @Note(IName="Next Screen Context Lines", Node="Display").

Only Global Abbrevs (nonexistent) @\If this variable exists and its value is nonzero, then Word Abbrev Mode assumes that you are not using any mode-specific abbrevs. @XNote(IName="Only Global Abbrevs", Name="Customizing WORDAB", File="WORDAB", Node="Alternatives").

Overwrite Mode @\If this is nonzero, the minor mode Overwrite mode is in effect. It controls the TECO flag FS ^R REPLACE. @Note(IName="Overwrite Mode", Name="Minor Modes", Node="MinorModes").

Page Delimiter (Formfeed (Control-L)) @\This is the TECO search string used to recognize page boundaries. @Note(IName="Page Delimiter", Node="Pages").

PAGE Flush CRLF @\If this variable exists and is nonzero, the PAGE library expects every page to start with a blank line, which is not considered part of the contents of the page. @Note(IName="PAGE Flush CRLF", Node="PAGE").

Paragraph Delimiter (.@CTL[O]@CTL[I]@CTL[O] @CTL[O]') @\This is the TECO search string used to recognize beginnings of paragraphs. @Note(IName="Paragraph Delimiter", Node="Sentences").

Permit Unmatched Paren (-1) @\Controls whether the bell is run if you insert an unmatched close parenthesis. @Note(IName="Permit Unmatched Paren", Node="Matching").

Prefix Char List @\This variable's value is a string which lists all the prefix characters defined, so that self-documentation facilities can find any subcommands of prefix characters which call a given function. @INFONote(File="CONV", Node="Prefix", Name="Prefix Characters").

Quote Execute Command (nonexistent) @\If this variable exists and is zero, then M-X does not quote @ctl{]} characters which appear in the string arguments of the command. @Note(IName="Quote Execute Command", Name="Extended Commands", Node="MMArcana").

Read Line Delay @\This is the amount of time, in 30'ths of a second, which EMACS should wait after starting to read a line of input, before it prompts and starts echoing the input.

Readable Word Abbrev Files (nonexistent) @\If this variable exists and is nonzero, word abbrev files will be written in the format that M-X List Word Abbrevs uses, instead of in a less readable but faster loading format. @XNote(IName="Readable Word Abbrev Files", Name="Saving Abbrevs", File="WORDAB", Node="Saving").

Region Query Size (5000) @\Many commands which act on the region require confirmation if the region contains more than this many characters. @Note(IName="Region Query Size", Node="Mark").

@Twenex{ Return from Inferior Hook (nonexistent) @\If this variable exists and is nonzero, its value should be a TECO program to be executed whenever an inferior fork returns to EMACS, except for inferior forks which return nearly immediately. @Note(IName="Return from Inferior Hook", Node="Subforks").}

Return from Superior Hook (nonexistent) @\If this variable exists and is nonzero, its value should be a TECO program to be executed whenever EMACS is resumed after being exited. @Note(IName="Return from Superior Hook", Node="Exiting").

SAIL Character Mode @\If this is nonzero, characters in the buffer with ASCII codes 0 through 37 are displayed without conversion. Do not try to use this feature except on terminals specially equipped to handle it. The variable controls the TECO flag FS SAIL. @Note(IName="SAIL Character Mode", Name="Ideal Keyboards", Node="Ideal").

Save Word Abbrevs (nonexistent) @\If this variable exists, its value determines which abbrevs will be saved upon exit from EMACS when abbrevs have been modified. Setting it to 1 causes all abbrevs to be saved. @XNote(IName="Save Word Abbrevs", Name="Saving Abbrevs", File="WORDAB", Node="Saving"). Setting it to -1 causes just the incremental abbrevs to be saved. @XNote(IName="Save Word Abbrevs", Name="Dumped Environments", File="WORDAB", Node="Dumping").

Search Exit Char (27) @\This is the numeric code for the 9-bit character which should exit incremental search and not have its normal command meaning in that case. The default, 27, is the code for Altmode.

Search Exit Option (nonexistent) @\If this variable is 0, Control and Meta characters without special meanings do not exit incrementatl search; instead, they are part of the string to be searched for. If this variable does not exist, or is nonzero, then those characters exit the search and then have their normal function.

Set Mode Line Hook @\This is a hook which is executed every time the mode line is recomputed. It can insert text in the buffer to put it in the mode line after the minor modes. @Note(IName="Set Mode Line Hook", Name="Mode Line", Node="ModeLine").

SLOWLY Maximum Speed (nonexistent) @\If this variable is defined, it is the maximum output speed for which SLOWLY, if loaded, should define its commands. @XNote(IName="SLOWLY Maximum Speed", Name="SLOWLY", Node="Options", File="SLOWLY").

Space Indent Flag @\If this flag is nonzero, then Auto Fill indents the new lines which it creates, by performing a Tab. Most major modes for programming languages set this nonzero. @Note(IName="Space Indent Flag", Node="Filling").

@Twenex{ System Output Holding @\If this is nonzero, then Twenex page mode is not turned off by EMACS. This means that the characters C-S and C-Q stop and resume output to the terminal from Twenex and cannot be used as EMACS commands in any way. The variable controls the TECO flag FS TT PAGE.}

Tab Stop Definitions (a string) @\The value of Tab Stop Definitions is a string defining the tab stops to be used by the command M-I (^R Tab to Tab Stop). @Note(IName="Tab Stop Definitions", Name="Indenting Text", Node="TextIndent").

Tags Find File (nonexistent) @\If this variable exists and is not zero, TAGS uses C-X C-F to switch files. Otherwise, TAGS uses C-X C-V. @XNOTE(Name="TAGS", File="TAGS", Node="Top"). Some other things may decide to use multiple buffers if this variable is nonzero. @Note(Node="Buffers", IName="Tags Find File").

Tags Search Verbose (nonexistent) @\If this variable exists and is zero, Tags Search does not print out the name of each file that it begins to search. If the variable is nonexistent, that is equivalent to a value of 1. @XNote(IName="Tags Search Verbose", File="TAGS", Name="Tags Search", Node="Search").

Temp File FN2 List (MEMO@CTL[O]XGP@CTL[O] ...) @\This is a TECO search string which recognizes the filenames which indicate that the file is probably temporary. @Note(IName="Temp File FN2 List", Name="Clean Directory", Node="CleanDir").

Top Display Margin @\This controls the size of the region at the top of the screen which the cursor is not allowed to be in. If the cursor would normally move there, the window is recentered instead. The value is represented as a percentage of the screen size, and must not be negative or more than 99. It controls the TECO flag FS %TOP. @Note(IName="Top Display Margin", Node="Display").

Underline Begin (nonexistent) @\If this variable exists, its value should be the character or string to use to begin underlines for the M-_ command. @Note(IName="Underline Begin", Node="Underlining").

Underline End (nonexistent) @\If this variable exists, its value should be the character or string to use to end underlines for the M-_ command. @Note(IName="Underline End", Node="Underlining").

Visit File Hook (nonexistent) @\If this variable exists and is nonzero, its value should be a TECO program to be executed whenever a file is visited. @Note(IName="Visit File Hook", Node="Visiting").

Visit File Save Old (1) @\This variable controls whether visiting a file offers to save the file previously visited in the same buffer, if it has changes. @Note(IName="Visit File Save Old", Node="Visiting").

WORDAB All Caps (nonexistent) @\If this variable exists and is nonzero, expanding an all-upper-case abbrev to a multi-word expansion will cause the words in the expansion to be all-upper-case, instead of just having their first letters uppercased. @XNote(IName="WORDAB All Caps", Name="Controlling Expansion", File="WORDAB", Node="Expanding").

WORDAB Ins Chars (nonexistent) @\If this variable exists when Word Abbrev Mode is turned on, it should be a string containing precisely those characters which should terminate and expand an abbrev. This variable overrides Additional Abbrev Expanders (q.v.). @XNote(IName="WORDAB", Name="Customizing WORDAB", File="WORDAB", Node="Alternatives").

@End(Description)