1. NAME

xedit - simple text editor for X

2. SYNTAX

xedit [ -toolkitoption. . . ] [ filename. . . ]

3. DESCRIPTION

Xeditprovides a window consisting of the following four areas:

Commands Section 25 A set of commands that allow you to exit xedit, save the file, or load a new file into the edit window.

Message Window 25 Displays xedit messages. In addition, this window can be also used as a scratch pad.

Filename Display Displays the name of the file currently being edited, and whether this file is Read-Write or Read Only.

Edit Window 25 Displays the text of the file that you are editing or creating.

4. OPTIONS

Xeditaccepts all of the standard X Toolkit command line options (see X (7)). The order of the command line options is not important.

  • filename
            Specifies the file(s) that are to be loaded during start-up. This is the file which will be edited. If a file is not specified, xeditlets you load files or create new files after it has started up.

5. EDITING

The Athena Text widget is used for the three sections of this application that allow text input. The characters typed will go to the Text widget that has the input focus, or the Text widget that the pointer cursor is currently over.

The following keystroke combinations are defined:

 
Sélectionnez
1.0i 3.0i 4.5i
Ctrl-a	Beginning Of Line	Meta-b	Backward Word
Ctrl-b	Backward Character	Meta-f	Forward Word
Ctrl-d	Delete Next Character	Meta-i	Insert File
Ctrl-e	End Of Line	Meta-k	Kill To End Of Paragraph
Ctrl-f	Forward Character	Meta-q	Form Paragraph
Ctrl-g	Keyboard Reset	Meta-v	Previous Page
Ctrl-h	Delete Previous Character	Meta-y	Insert Current Selection
Ctrl-j	Newline And Indent	Meta-z	Scroll One Line Down
Ctrl-k	Kill To End Of Line	Meta-d	Delete Next Word
Ctrl-l	Redraw Display	Meta-D	Kill Word
Ctrl-m	Newline	Meta-h	Delete Previous Word
Ctrl-n	Next Line	Meta-H	Backward Kill Word
Ctrl-o	Newline And Backup	Meta-<	Beginning Of File
Ctrl-p	Previous Line	Meta->	End Of File
Ctrl-r	Search/Replace Backward	Meta-]	Forward Paragraph
Ctrl-s	Search/Replace Forward	Meta-[	Backward Paragraph
Ctrl-t	Transpose Characters
Ctrl-u [number]	Multiply by 4 or number	Meta-Delete	Delete Previous Word
Ctrl-v	Next Page	Meta-Shift Delete	Kill Previous Word
Ctrl-w	Kill Selection	Meta-Backspace	Delete Previous Word
Ctrl-y	Unkill	Meta-Shift Backspace	Kill Previous Word
Ctrl-z	Scroll One Line Up	Meta-z	Scroll One Line Down
Ctrl-_	Undo
Escape	Line Edit Mode
In addition, the pointer may be used to cut and paste text:
 .5i 2.0i
	Button 1 Down	Start Selection
	Button 1 Motion	Adjust Selection
	Button 1 Up	End Selection (cut)
	Button 2 Down	Insert Current Selection (paste)
	Button 3 Down	Extend Current Selection
	Button 3 Motion	Adjust Selection
	Button 3 Up	End Selection (cut)



6. LINE EDIT MODE

Line edit modeenables several shortcut commands for searching and replacing text in a xedit buffer. Line edit modecommands have the format:

 
Sélectionnez
	[line-number[,line-number]]command[parameters]

Line numbermay be specified as:

  • .
            The current text line.
  • $
            The last line of the file.
  • number
            The literal line number.
  • - or ^
            The previous line. Equivalent to -1.
  • -number or ^number
            The current line minus number.
  • +
            The next line. Equivalent to +1.
  • +number
            The current line plus number.
  • , or %
            From the first to the last line. Equivalent to 1,$.
  • ;
            From the current to the last line. Equivalent to .,$.

Commandmay be specified as:

  • s
            Substitute text in the specified lines.
  • /re/
            Search forward for the regular expression pattern re.
  • ?re?
            Search backward for the regular expression pattern re.

Parametersmay be specified as:

  • /re/
            Works as a parameter to i or as a command.
  • /re/text/
            Search forward for re and substitute by text.

Optionsmay follow or be parameters, known values are:

  • i
            Case insensitive search.
  • g
            Global match when replacing text. Unless specified, only the nth, that defaults to 1, match will be replaced.
  • c
            Confirm before replacing text.
  • number
            Replace only the occurrence referenced by number.

Commands accept some variations, examples:

 
Sélectionnez
/pattern/i
	i/pattern/
	i/pattern

Search forward for pattern.

 
Sélectionnez
	,sc/pattern/text
	,sc/pattern/text/
	,s/pattern/text/c

Search the entire buffer and ask confirmation to replace pattern with text.

 
Sélectionnez
	,s/pattern/text/number

Replace the match number in the text line. If not specified, defaults to the first occurrence.

When searching for text, type <Return> to go to the next match. When interactively replacing text, type y or Y to accept the change, and n or N to ignore it and go to the next match.

7. COMMANDS

Quit 8 Quits the current editing session. If any changes have not been saved, xeditdisplays a warning message, allowing the user to save them.

Save If file backups are enabled (see RESOURCES, below) xeditstores a copy of the original, unedited file in <prefix>file<suffix>, then overwrites the file with the contents of the edit window. The filename is retrieved from the Text widget directly to the right of the Load button.

Load Loads the file named in the text widget immediately to the right of the this button and displays it in the Edit window.

8. RESOURCES

For xedit the available resources are:

tagsName (\fPClass\fB TagsName)

        Specifies the name of the tags file to search when loading a new file. Default value is tags.

loadTags (\fPClass\fB LoadTags)

        Boolean value to enable or disabling searching for tags files. Default is True.

enableBackups (\fPClass\fB EnableBackups)

        Specifies that, when edits made to an existing file are saved, xeditis to copy the original version of that file to <prefix>file<suffix> before it saves the changes. The default value for this resource is ``on,'' stating that backups should be created.

backupNamePrefix (\fPClass\fB BackupNamePrefix)

        Specifies a string that is to be prepended to the backup filename. The default is that no string shall be prepended.

backupNameSuffix (\fPClass\fB BackupNameSuffix)

        Specifies a string that is to be appended to the backup filename. The default is to use ``~'' as the suffix.

positionFormat (\fPClass\fB Format)

        Specifies a format string used to display the cursor position. This string uses printf(3) like notation, where

%l prints the line number,

%c prints the column number,

%p prints the insert position offset, and

%s prints the current file size. It is also allowed to specify field sizes, with the notation

%-?[0-9]+ . The default format string is ``L%l'', which shows the character ``L'' followed by the line number.

hints (\fPClass\fB Hints)

        Specifies a list of strings, separated by new lines, that will be displayed in the bc_label window.

hintsInterval (\fPClass \fBInterval)

        Specifies the interval in seconds, which the hint string in the bc_label window will be changed.

changedBitmap (\fPClass \fBBitmap)

        Specifies the name of the Bitmap that will be displayed in the fileMenu, when the file being edited is changed.

autoReplace (\fPClass \fBReplace)

        This resource is useful to automatically correct common misspelling errors, but can also be used to create simple macros. The format is {non-blanks}{blanks}[{string}]. Fields are separeted by newlines. Example of use: \"

 
Sélectionnez
nto	  not\\n\\
/macro some long string with \\\\\\n newlines \\\\\\n

\"
Will automatically replace the word nto by not, and /macro by some long string with newlines when you type that words.

ispell.dictionaries (\fPClass \fBispell.Dictionary)

        Specifies a list of dictionary names, separeted by spaces, available to the ispell program. The default value is "american americamed+ english".

ispell.dictionary (\fPClass \fBispell.Dictionary)

        Specifies the default dictionary to use.

ispell*<DICTIONARY>.wordChars (\fPClass \fBispell*Chars)

        Specifies a set of characters that can be part of a legal word. The <DICTIONARY> field is one of the dictionaries specified in the dictionaries resource.

ispell.ispellCommand (\fPClass \fBispell.CommandLine)

        The path to the ispell program, and possibly, additional arguments. You don't need to specify the ``-w'' option, neither the ``-a'' option. Refer to the ispell(1) manpage for more information on ispell options.

ispell.formatting (\fPClass \fPispell.TextFormat)

        Specifies which text formatting to use while spell checking the file. The available formats are text and html.

ispell*text.skipLines (\fPClass \fBispell*text.Skip)

        Lines starting with one of the characters in this string will not be spell checked. This resource is only used in text mode.

ispell.terseMode (\fPClass \fBispell.Terse)

        When enabled, runs ispell in terse mode, not asking user interaction for words generated through compound formation (when using the ispell ``-C'' option), or words generated through affix removal. The default value is False.

ispell.lookCommand (\fPClass \fBispell.CommandLine)

        The path to the program to search for alternate words, and possibly, additional arguments. The default program used is /usr/bin/egrep.

ispell.wordsFile (\fPClass \fBispell.Words)

        The path to the file[s] to search for alternate words. The default file is /usr/share/dict/words.

ispell.guessLabel (\fPClass \fBispell.Status)

        String displayed in the ispell status bar when ispell returns a guess list of one or more words. The default value is Guess.

ispell.missLabel (\fPClass \fBispell.Status)

        String displayed in the ispell status bar when ispell returns a list of one or more words to match a misspelled one. The default value is Miss.

ispell.rootLabel (\fPClass \fBispell.Status)

        String displayed in the ispell status bar when the word is not in the dictionary, but it can be formed through a root one. The default value is Root:, and is followed by a space and the root word.

ispell.noneLabel (\fPClass \fBispell.Status)

        String displayed in the ispell status bar when there is no near misses. The default value is None.

ispell.compoundLabel (\fPClass \fBispell.Status)

        String displayed in the ispell status bar when the word being checked is formed by concatenation of two words. The default value is Compound.

ispell.okLabel (\fPClass \fBispell.Status)

        String displayed in the ispell status bar when the checked word is in the dictionary. This string is only displayed when using the check button in the xedit ispell interface. The default value is Ok.

ispell.eofLabel (\fPClass \fBispell.Status)

        The string displayed in the ispell status bar when the end of the file is reached. The default value is End Of File.

ispell.repeatLabel (\fPClass \fBispell.Status)

        The string displayed in the ispell status bar when two identical words are found together in the file. The default value is Repeat.

ispell.lookLabel (\fPClass \fBispell.Status)

        The string displayed in the ispell status bar after displaying the results of the Look command. If no results are found, the value of the ispell.noneLabel resource is shown.

ispell.workingLabel (\fPClass \fBispell.Status)

        The string displayed in the ispell status bar while xedit is communicating with ispell. The default value is ....

9. WIDGETS

In order to specify resources, it is useful to know the hierarchy of the widgets which compose xedit. In the notation below, indentation indicates hierarchical structure. The widget class name is given first, followed by the widget instance name.

 
Sélectionnez
.5i 1.0i 1.5i 2.0i
Xedit  xedit
	Paned  paned
		Paned  buttons
			Command  quit
			Command  save
			Command  load
			Text     filename
		Label  bc_label
		Text   messageWindow
		Label  labelWindow
		Text   editWindow



10. ENVIRONMENT

  • DISPLAY
                        to get the default host and display number.
  • XENVIRONMENT
                        to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

11. FILES

  • /etc/X11/app-defaults/Xedit
                        specifies required resources

12. SEE ALSO

X (7), xrdb (1), "Athena Widget Set"

13. RESTRICTIONS

Xedit is not a replacement to Emacs.

14. COPYRIGHT

Copyright 1988, Digital Equipment Corporation.
Copyright 1989, X Consortium
Copyright 1998, The XFree86 Project
See X (7) for a full statement of rights and permissions.

15. AUTHORS

Chris D. Peterson, MIT X Consortium
Paulo Cesar Pereira de Andrade, The XFree86 Project