buffer-setup(3)
[Home]
[Commands]
[Variables]
[Macro-Dev]
[Glossary]
NAME
SYNOPSIS
DESCRIPTION
buffer-setup provides a dialog interface to configuring the setup of the current buffer's file type within MicroEmacs. user-setup may be invoked from the main help menu or directly from the command line using
execute-named-command(2).
The changes made to a configuration in buffer-setup are maintained in future MicroEmacs sessions by storing them within the user's setup registry file, "<logname>.erf". Note that not all file types may be supported by buffer-setup, if not the help menu item will not be available.
The contents of the dialog change, depending on the features the current buffer's file type supports. These features are implemented and installed within the
buffer's file hook. The following buttons are always present at the bottom of the dialog:
Save
Saves the changes made to the configuration back to the users registry file, i.e. "<Log-Name>.erf" but does not re-initialize the current buffer. No changes made will effect the current buffer unless the Current button is pressed. Buffers of the same type created after the save may inherrit some of the changes.
Current
Makes the current buffer reflect the changes made, dismissing the buffer-setup dialog. This also performs the above 'Save' operation. Some changes such as dialog creation changes, will only take effect when MicroEmacs is restarted.
Exit
Quits buffer-setup, if changes where not Saved or made Current they will be lost.
Following is a list of configurable features which may be available:
Create Help Page
Enables/disables the creation of a help page dialog for the tools available for the current file type.
Create Tools Menu
Enables/disables the creation of a file type specific sub menu located within the main menu's Tools sub-menu.
Use Author Mode
For file types which have an automatic formatter/viewer (currently only html) enabling this will simply load the file enabling the source code to be viewed and edited. When disabled files of this type will be automatically processed giving a more readable 'formatted' representation.
Insert New Template
When creating a new buffer/file of this type, a default template will be inserted if this is enabled. When disabled the buffer will remain empty.
Setup Hilighting
Creates and enables the token
hilighting for the current file type.
Setup Auto Indent
Enables automatic formating (indenting) for the current file type. The indentation rules are either the built in 'C' indentation
cmode(2m) or created using the
indent(2) command. When enabled the
tab(2m) is still adhered to, but the
indent(2m) mode is ignored; when disabled the indent mode can be used.
Setup Auto Spell
Enables the setting up of
auto-spell(3). When enabled the auto-spell key bindings are created and auto-spell is enabled if enabled within the user-setup dialog.
Setup Folding
Enables the setting up of section
folding, when enabled the folding key bindings are created.
Add Abbreviations
Search Modes: Exact
Enables/disables the
exact(2m) mode over-riding the setting within the
user-setup(3) dialog. If this setting is changed the setting within user-setup will be ignored for the current file type.
Search Modes: Magic
Enables/disables the
magic(2m) mode over-riding the setting within the
user-setup(3) dialog. If this setting is changed the setting within user-setup will be ignored for the current file type.
Buffer Modes: Indent
Buffer Modes: Justify
Buffer Modes: Tab
Enables/disables the
tab(2m) mode over-riding the setting within the
user-setup(3) dialog. If this setting is changed the setting within user-setup will be ignored for the current file type.
Buffer Modes: Time
Buffer Modes: Undo
Enables/disables the
undo(2m) mode over-riding the setting within the
user-setup(3) dialog. If this setting is changed the setting within user-setup will be ignored for the current file type.
Buffer Modes: Wrap
NOTES
buffer-setup is a macro using
osd(2), defined in buffstp.emf.
SEE ALSO
(c) Copyright JASSPA 2001
Last Modified: 2001/07/14
Generated On: 2001/08/15