From 5a9cffc3f443030ac93d890611316d0994f0cc13 Mon Sep 17 00:00:00 2001 From: Gaetan Nadon Date: Wed, 19 Jan 2011 10:06:56 -0500 Subject: config: move man pages into their own directory Use services provided by XORG_MANPAGE_SECTIONS. Use standard Makefile for man pages. Signed-off-by: Gaetan Nadon --- Makefile.am | 15 +- configure.ac | 5 +- man/Makefile.am | 12 ++ man/xedit.man | 451 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ xedit.man | 451 -------------------------------------------------------- 5 files changed, 468 insertions(+), 466 deletions(-) create mode 100644 man/Makefile.am create mode 100644 man/xedit.man delete mode 100644 xedit.man diff --git a/Makefile.am b/Makefile.am index f02ea7f..fc7a74c 100644 --- a/Makefile.am +++ b/Makefile.am @@ -19,6 +19,7 @@ # TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR # PERFORMANCE OF THIS SOFTWARE. +SUBDIRS = man bin_PROGRAMS = xedit noinst_LIBRARIES = liblisp.a libre.a libmp.a noinst_PROGRAMS = lisp/lsp lisp/re/tests @@ -184,7 +185,6 @@ dist_progmodes_DATA = \ ${srcdir}/lisp/modules/progmodes/xlog.lsp \ ${srcdir}/lisp/modules/progmodes/xrdb.lsp -appman_PRE = xedit.man EXTRA_DIST = \ app-defaults/Xedit-color \ @@ -211,20 +211,7 @@ EXTRA_DIST = \ lisp/test/stream.lsp \ lisp/test/widgets.lsp -appmandir = $(APP_MAN_DIR) - -appman_DATA = $(appman_PRE:man=@APP_MAN_SUFFIX@) - -EXTRA_DIST += $(appman_PRE) MAINTAINERCLEANFILES = ChangeLog INSTALL -CLEANFILES = $(appman_DATA) - -SUFFIXES = .$(APP_MAN_SUFFIX) .man - -# String replacements in MAN_SUBSTS now come from xorg-macros.m4 via configure -.man.$(APP_MAN_SUFFIX): - $(AM_V_GEN)$(SED) $(MAN_SUBSTS) < $< > $@ - .PHONY: ChangeLog INSTALL diff --git a/configure.ac b/configure.ac index 2a7b6f2..21c6696 100644 --- a/configure.ac +++ b/configure.ac @@ -64,4 +64,7 @@ AC_ARG_WITH(appdefaultdir, AC_SUBST(appdefaultdir) -AC_OUTPUT([Makefile]) +AC_CONFIG_FILES([ + Makefile + man/Makefile]) +AC_OUTPUT diff --git a/man/Makefile.am b/man/Makefile.am new file mode 100644 index 0000000..6799ec5 --- /dev/null +++ b/man/Makefile.am @@ -0,0 +1,12 @@ + +appmandir = $(APP_MAN_DIR) +appman_PRE = xedit.man +appman_DATA = $(appman_PRE:man=$(APP_MAN_SUFFIX)) + +EXTRA_DIST = $(appman_PRE) +CLEANFILES = $(appman_DATA) +SUFFIXES = .$(APP_MAN_SUFFIX) .man + +# String replacements in MAN_SUBSTS now come from xorg-macros.m4 via configure +.man.$(APP_MAN_SUFFIX): + $(AM_V_GEN)$(SED) $(MAN_SUBSTS) < $< > $@ diff --git a/man/xedit.man b/man/xedit.man new file mode 100644 index 0000000..cd40ad5 --- /dev/null +++ b/man/xedit.man @@ -0,0 +1,451 @@ +.\" $XConsortium: xedit.man,v 1.23 94/04/17 20:43:39 matt Exp $ +.\" Copyright (c) 1994 X Consortium +.\" +.\" Permission is hereby granted, free of charge, to any person obtaining +.\" a copy of this software and associated documentation files (the +.\" "Software"), to deal in the Software without restriction, including +.\" without limitation the rights to use, copy, modify, merge, publish, +.\" distribute, sublicense, and/or sell copies of the Software, and to +.\" permit persons to whom the Software is furnished to do so, subject to +.\" the following conditions: +.\" +.\" The above copyright notice and this permission notice shall be included +.\" in all copies or substantial portions of the Software. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS +.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +.\" IN NO EVENT SHALL THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR +.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, +.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR +.\" OTHER DEALINGS IN THE SOFTWARE. +.\" +.\" Except as contained in this notice, the name of the X Consortium shall +.\" not be used in advertising or otherwise to promote the sale, use or +.\" other dealings in this Software without prior written authorization +.\" from the X Consortium. +.\" +.\" $XFree86: xc/programs/xedit/xedit.man,v 1.18 2002/10/12 16:06:48 herrb Exp $ +.\" +.TH XEDIT 1 __vendorversion__ +.SH NAME +xedit \- simple text editor for X +.SH SYNTAX +.B xedit +[ +.I \-toolkitoption +\&.\|.\|. ] [ +.I filename +\&.\|.\|. ] +.SH DESCRIPTION +.I Xedit +provides a window consisting of the following four areas: +.IP "Commands Section" 25 +A set of commands that allow you to exit \fIxedit\fP, save the file, or +load a new file into the edit window. +.IP "Message Window" 25 +Displays \fIxedit\fP messages. In addition, this window can be also used as +a scratch pad. +.IP "Filename Display" +Displays the name of the file currently being edited, and whether this file +is \fIRead-Write\fP or \fIRead Only\fP. +.IP "Edit Window" 25 +Displays the text of the file that you are editing or creating. +.SH OPTIONS +.I Xedit +accepts all of the standard X Toolkit command line +options (see +.IR X (__miscmansuffix__)). +The order of the command line options is not important. +.TP 8 +.I 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, +.I xedit +lets you load files or create new files after it has started up. +.SH 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. +.PP + +The following keystroke combinations are defined: +.sp +.nf +.ta 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 [\fInumber\fP] Multiply by 4 or \fInumber\fP 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 +.sp +In addition, the pointer may be used to cut and paste text: +.ta .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) +.fi +.sp + +.SH LINE EDIT MODE +.I Line edit mode +enables several shortcut commands for searching and replacing text in a +xedit buffer. +.I Line edit mode +commands have the format: +.br +.nf + + [\fIline-number\fP[,\fIline-number\fP]]\fIcommand\fP[\fIparameters\fP] + +.fi +.I Line number +may be specified as: +.TP 8 +\&. +The current text line. +.TP 8 +$ +The last line of the file. +.TP 8 +number +The literal line \fInumber\fP. +.TP 8 +- or ^ +The previous line. Equivalent to \fI-1\fP. +.TP 8 +-number or ^number +The current line minus \fInumber\fP. +.TP 8 ++ +The next line. Equivalent to \fI+1\fP. +.TP 8 ++number +The current line plus \fInumber\fP. +.TP 8 +, or % +From the first to the last line. Equivalent to \fI1,$\fP. +.TP 8 +; +From the current to the last line. Equivalent to \fI.,$\fP. + +.PP +.I Command +may be specified as: +.TP 8 +s +Substitute text in the specified lines. +.TP 8 +/re/ +Search forward for the regular expression pattern \fIre\fP. +.TP 8 +?re? +Search backward for the regular expression pattern \fIre\fP. + +.PP +.I Parameters +may be specified as: +.TP 8 +/re/ +Works as a parameter to \fIi\fP or as a command. +.TP 8 +/re/text/ +Search forward for \fIre\fP and substitute by \fItext\fP. + +.PP +.I Options +may follow or be parameters, known values are: +.TP 8 +i +Case insensitive search. +.TP 8 +g +\fIGlobal\fP match when replacing text. Unless specified, only the nth, +that defaults to 1, match will be replaced. +.TP 8 +c +\fIConfirm\fP before replacing text. +.TP 8 +number +Replace only the occurrence referenced by \fInumber\fP. +.PP + +Commands accept some variations, examples: +.br +.nf + /pattern/i + i/pattern/ + i/pattern +.fi +Search forward for \fIpattern\fP. +.br +.nf + + ,sc/pattern/text + ,sc/pattern/text/ + ,s/pattern/text/c +.fi +Search the entire buffer and ask confirmation to replace \fIpattern\fP +with \fItext\fP. +.br +.nf + + ,s/pattern/text/number +.fi +Replace the match \fInumber\fP in the text line. If not specified, +defaults to the first occurrence. + +.PP +When searching for text, type to go to the next match. +When interactively replacing text, type \fIy\fP or \fIY\fP to accept the +change, and \fIn\fP or \fIN\fP to ignore it and go to the next match. + +.SH COMMANDS +.IP Quit 8 +Quits the current editing session. If any changes have not been saved, +.I xedit +displays a warning message, allowing the user to save them. +.IP Save +If file backups are enabled (see RESOURCES, below) +.I xedit +stores a copy of the +original, unedited file in \fIfile\fP, +then overwrites the \fIfile\fP with the contents of the edit window. The +filename is retrieved from the Text widget directly to the right of +the \fILoad\fP button. +.IP Load +Loads the file named in the text widget immediately to the right +of the this button and displays it in the Edit window. +.SH RESOURCES +For \fIxedit\fP the available resources are: +.TP 8 +.B tagsName (\fPClass\fB TagsName) +Specifies the name of the tags file to search when loading a new file. +Default value is \fItags\fP. +.TP 8 +.B loadTags (\fPClass\fB LoadTags) +Boolean value to enable or disabling searching for tags files. +Default is \fITrue\fP. +.TP 8 +.B enableBackups (\fPClass\fB EnableBackups) +Specifies that, when edits made to an existing file are saved, +.I xedit +is to copy the original version of that file to \fIfile\fP +before it saves the changes. The default value for this resource is +``on,'' stating that backups should be created. +.TP 8 +.B 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. +.TP 8 +.B backupNameSuffix (\fPClass\fB BackupNameSuffix) +Specifies a string that is to be appended to the backup filename. The +default is to use ``~'' as the suffix. +.TP 8 +.B positionFormat (\fPClass\fB Format) +Specifies a format string used to display the cursor position. This +string uses printf(__libmansuffix__) like notation, where +.B %l +prints the line number, +.B %c +prints the column number, +.B %p +prints the insert position offset, and +.B %s +prints the current file size. It is also allowed to specify field sizes, +with the notation +.B %\-?[0\-9]+ +\&. The default format string is ``L%l'', which shows the character ``L'' +followed by the line number. +.TP 8 +.B hints (\fPClass\fB Hints) +Specifies a list of strings, separated by new lines, that will be +displayed in the bc_label window. +.TP 8 +.B hintsInterval (\fPClass \fBInterval) +Specifies the interval in seconds, which the hint string in the bc_label +window will be changed. +.TP 8 +.B changedBitmap (\fPClass \fBBitmap) +Specifies the name of the Bitmap that will be displayed in the fileMenu, when +the file being edited is changed. +.TP 8 +.B 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 +\fI{non-blanks}{blanks}[{string}]\fP. Fields are separated by newlines. +Example of use: +\" +.br +.nf +nto not\\n\\ +/macro some long string with \\\\\\n newlines \\\\\\n +.fi +\" +.br +Will automatically replace the word \fInto\fP by \fInot\fP, and \fI/macro\fP +by \fIsome long string with + newlines +\fP +when you type that words. +.TP 8 +.B ispell.dictionaries (\fPClass \fBispell.Dictionary) +Specifies a list of dictionary names, separated by spaces, available to the +ispell program. The default value is \fI"american americamed+ english"\fP. +.TP 8 +.B ispell.dictionary (\fPClass \fBispell.Dictionary) +Specifies the default dictionary to use. +.TP 8 +.B ispell*.wordChars (\fPClass \fBispell*Chars) +Specifies a set of characters that can be part of a legal word. The +\fI\fP field is one of the dictionaries specified in the +\fIdictionaries\fP resource. +.TP 8 +.B 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 \fIispell\fP(__appmansuffix__) manpage for more information on ispell options. +.TP 8 +.B ispell.formatting (\fPClass \fPispell.TextFormat) +Specifies which text formatting to use while spell checking the file. The +available formats are \fItext\fP and \fIhtml\fP. +.TP 8 +.B 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 \fItext\fP mode. +.TP 8 +.B 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. +.TP 8 +.B ispell.lookCommand (\fPClass \fBispell.CommandLine) +The path to the program to search for alternate words, and possibly, +additional arguments. The default program used is \fI/usr/bin/egrep\fP. +.TP 8 +.B ispell.wordsFile (\fPClass \fBispell.Words) +The path to the file[s] to search for alternate words. The default file is +\fI/usr/share/dict/words\fP. +.TP 8 +.B 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 \fIGuess\fP. +.TP 8 +.B 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 \fIMiss\fP. +.TP 8 +.B 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 \fIRoot:\fP, and is +followed by a space and the root word. +.TP 8 +.B ispell.noneLabel (\fPClass \fBispell.Status) +String displayed in the ispell status bar when there is no near misses. The default +value is \fINone\fP. +.TP 8 +.B 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 \fICompound\fP. +.TP 8 +.B 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 \fIcheck\fP button in the xedit ispell +interface. The default value is \fIOk\fP. +.TP 8 +.B 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 \fIEnd Of File\fP. +.TP 8 +.B 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 \fIRepeat\fP. +.TP 8 +.B ispell.lookLabel (\fPClass \fBispell.Status) +The string displayed in the ispell status bar after displaying the results of +the \fILook\fP command. If no results are found, the value of the +\fIispell.noneLabel\fP resource is shown. +.TP 8 +.B ispell.workingLabel (\fPClass \fBispell.Status) +The string displayed in the ispell status bar while xedit is communicating with +ispell. The default value is \fI...\fP. +.SH WIDGETS +In order to specify resources, it is useful to know the hierarchy of +the widgets which compose \fIxedit\fR. In the notation below, +indentation indicates hierarchical structure. The widget class name +is given first, followed by the widget instance name. +.sp +.nf +.ta .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 +.fi +.sp +.SH ENVIRONMENT +.PP +.TP 20 +.I DISPLAY +to get the default host and display number. +.TP 20 +.I XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH FILES +.TP 20 +.I __apploaddir__/Xedit +specifies required resources +.SH "SEE ALSO" +.IR X (__miscmansuffix__), +.IR xrdb (__appmansuffix__), +.I "Athena Widget Set" +.SH RESTRICTIONS +Xedit is not a replacement to Emacs. +.SH COPYRIGHT +Copyright 1988, Digital Equipment Corporation. +.br +Copyright 1989, X Consortium +.br +Copyright 1998, The XFree86 Project +.br +See +.IR X (__miscmansuffix__) +for a full statement of rights and permissions. +.SH AUTHORS +Chris D. Peterson, MIT X Consortium +.br +Paulo Cesar Pereira de Andrade, The XFree86 Project diff --git a/xedit.man b/xedit.man deleted file mode 100644 index cd40ad5..0000000 --- a/xedit.man +++ /dev/null @@ -1,451 +0,0 @@ -.\" $XConsortium: xedit.man,v 1.23 94/04/17 20:43:39 matt Exp $ -.\" Copyright (c) 1994 X Consortium -.\" -.\" Permission is hereby granted, free of charge, to any person obtaining -.\" a copy of this software and associated documentation files (the -.\" "Software"), to deal in the Software without restriction, including -.\" without limitation the rights to use, copy, modify, merge, publish, -.\" distribute, sublicense, and/or sell copies of the Software, and to -.\" permit persons to whom the Software is furnished to do so, subject to -.\" the following conditions: -.\" -.\" The above copyright notice and this permission notice shall be included -.\" in all copies or substantial portions of the Software. -.\" -.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS -.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF -.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. -.\" IN NO EVENT SHALL THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR -.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, -.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -.\" OTHER DEALINGS IN THE SOFTWARE. -.\" -.\" Except as contained in this notice, the name of the X Consortium shall -.\" not be used in advertising or otherwise to promote the sale, use or -.\" other dealings in this Software without prior written authorization -.\" from the X Consortium. -.\" -.\" $XFree86: xc/programs/xedit/xedit.man,v 1.18 2002/10/12 16:06:48 herrb Exp $ -.\" -.TH XEDIT 1 __vendorversion__ -.SH NAME -xedit \- simple text editor for X -.SH SYNTAX -.B xedit -[ -.I \-toolkitoption -\&.\|.\|. ] [ -.I filename -\&.\|.\|. ] -.SH DESCRIPTION -.I Xedit -provides a window consisting of the following four areas: -.IP "Commands Section" 25 -A set of commands that allow you to exit \fIxedit\fP, save the file, or -load a new file into the edit window. -.IP "Message Window" 25 -Displays \fIxedit\fP messages. In addition, this window can be also used as -a scratch pad. -.IP "Filename Display" -Displays the name of the file currently being edited, and whether this file -is \fIRead-Write\fP or \fIRead Only\fP. -.IP "Edit Window" 25 -Displays the text of the file that you are editing or creating. -.SH OPTIONS -.I Xedit -accepts all of the standard X Toolkit command line -options (see -.IR X (__miscmansuffix__)). -The order of the command line options is not important. -.TP 8 -.I 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, -.I xedit -lets you load files or create new files after it has started up. -.SH 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. -.PP - -The following keystroke combinations are defined: -.sp -.nf -.ta 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 [\fInumber\fP] Multiply by 4 or \fInumber\fP 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 -.sp -In addition, the pointer may be used to cut and paste text: -.ta .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) -.fi -.sp - -.SH LINE EDIT MODE -.I Line edit mode -enables several shortcut commands for searching and replacing text in a -xedit buffer. -.I Line edit mode -commands have the format: -.br -.nf - - [\fIline-number\fP[,\fIline-number\fP]]\fIcommand\fP[\fIparameters\fP] - -.fi -.I Line number -may be specified as: -.TP 8 -\&. -The current text line. -.TP 8 -$ -The last line of the file. -.TP 8 -number -The literal line \fInumber\fP. -.TP 8 -- or ^ -The previous line. Equivalent to \fI-1\fP. -.TP 8 --number or ^number -The current line minus \fInumber\fP. -.TP 8 -+ -The next line. Equivalent to \fI+1\fP. -.TP 8 -+number -The current line plus \fInumber\fP. -.TP 8 -, or % -From the first to the last line. Equivalent to \fI1,$\fP. -.TP 8 -; -From the current to the last line. Equivalent to \fI.,$\fP. - -.PP -.I Command -may be specified as: -.TP 8 -s -Substitute text in the specified lines. -.TP 8 -/re/ -Search forward for the regular expression pattern \fIre\fP. -.TP 8 -?re? -Search backward for the regular expression pattern \fIre\fP. - -.PP -.I Parameters -may be specified as: -.TP 8 -/re/ -Works as a parameter to \fIi\fP or as a command. -.TP 8 -/re/text/ -Search forward for \fIre\fP and substitute by \fItext\fP. - -.PP -.I Options -may follow or be parameters, known values are: -.TP 8 -i -Case insensitive search. -.TP 8 -g -\fIGlobal\fP match when replacing text. Unless specified, only the nth, -that defaults to 1, match will be replaced. -.TP 8 -c -\fIConfirm\fP before replacing text. -.TP 8 -number -Replace only the occurrence referenced by \fInumber\fP. -.PP - -Commands accept some variations, examples: -.br -.nf - /pattern/i - i/pattern/ - i/pattern -.fi -Search forward for \fIpattern\fP. -.br -.nf - - ,sc/pattern/text - ,sc/pattern/text/ - ,s/pattern/text/c -.fi -Search the entire buffer and ask confirmation to replace \fIpattern\fP -with \fItext\fP. -.br -.nf - - ,s/pattern/text/number -.fi -Replace the match \fInumber\fP in the text line. If not specified, -defaults to the first occurrence. - -.PP -When searching for text, type to go to the next match. -When interactively replacing text, type \fIy\fP or \fIY\fP to accept the -change, and \fIn\fP or \fIN\fP to ignore it and go to the next match. - -.SH COMMANDS -.IP Quit 8 -Quits the current editing session. If any changes have not been saved, -.I xedit -displays a warning message, allowing the user to save them. -.IP Save -If file backups are enabled (see RESOURCES, below) -.I xedit -stores a copy of the -original, unedited file in \fIfile\fP, -then overwrites the \fIfile\fP with the contents of the edit window. The -filename is retrieved from the Text widget directly to the right of -the \fILoad\fP button. -.IP Load -Loads the file named in the text widget immediately to the right -of the this button and displays it in the Edit window. -.SH RESOURCES -For \fIxedit\fP the available resources are: -.TP 8 -.B tagsName (\fPClass\fB TagsName) -Specifies the name of the tags file to search when loading a new file. -Default value is \fItags\fP. -.TP 8 -.B loadTags (\fPClass\fB LoadTags) -Boolean value to enable or disabling searching for tags files. -Default is \fITrue\fP. -.TP 8 -.B enableBackups (\fPClass\fB EnableBackups) -Specifies that, when edits made to an existing file are saved, -.I xedit -is to copy the original version of that file to \fIfile\fP -before it saves the changes. The default value for this resource is -``on,'' stating that backups should be created. -.TP 8 -.B 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. -.TP 8 -.B backupNameSuffix (\fPClass\fB BackupNameSuffix) -Specifies a string that is to be appended to the backup filename. The -default is to use ``~'' as the suffix. -.TP 8 -.B positionFormat (\fPClass\fB Format) -Specifies a format string used to display the cursor position. This -string uses printf(__libmansuffix__) like notation, where -.B %l -prints the line number, -.B %c -prints the column number, -.B %p -prints the insert position offset, and -.B %s -prints the current file size. It is also allowed to specify field sizes, -with the notation -.B %\-?[0\-9]+ -\&. The default format string is ``L%l'', which shows the character ``L'' -followed by the line number. -.TP 8 -.B hints (\fPClass\fB Hints) -Specifies a list of strings, separated by new lines, that will be -displayed in the bc_label window. -.TP 8 -.B hintsInterval (\fPClass \fBInterval) -Specifies the interval in seconds, which the hint string in the bc_label -window will be changed. -.TP 8 -.B changedBitmap (\fPClass \fBBitmap) -Specifies the name of the Bitmap that will be displayed in the fileMenu, when -the file being edited is changed. -.TP 8 -.B 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 -\fI{non-blanks}{blanks}[{string}]\fP. Fields are separated by newlines. -Example of use: -\" -.br -.nf -nto not\\n\\ -/macro some long string with \\\\\\n newlines \\\\\\n -.fi -\" -.br -Will automatically replace the word \fInto\fP by \fInot\fP, and \fI/macro\fP -by \fIsome long string with - newlines -\fP -when you type that words. -.TP 8 -.B ispell.dictionaries (\fPClass \fBispell.Dictionary) -Specifies a list of dictionary names, separated by spaces, available to the -ispell program. The default value is \fI"american americamed+ english"\fP. -.TP 8 -.B ispell.dictionary (\fPClass \fBispell.Dictionary) -Specifies the default dictionary to use. -.TP 8 -.B ispell*.wordChars (\fPClass \fBispell*Chars) -Specifies a set of characters that can be part of a legal word. The -\fI\fP field is one of the dictionaries specified in the -\fIdictionaries\fP resource. -.TP 8 -.B 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 \fIispell\fP(__appmansuffix__) manpage for more information on ispell options. -.TP 8 -.B ispell.formatting (\fPClass \fPispell.TextFormat) -Specifies which text formatting to use while spell checking the file. The -available formats are \fItext\fP and \fIhtml\fP. -.TP 8 -.B 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 \fItext\fP mode. -.TP 8 -.B 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. -.TP 8 -.B ispell.lookCommand (\fPClass \fBispell.CommandLine) -The path to the program to search for alternate words, and possibly, -additional arguments. The default program used is \fI/usr/bin/egrep\fP. -.TP 8 -.B ispell.wordsFile (\fPClass \fBispell.Words) -The path to the file[s] to search for alternate words. The default file is -\fI/usr/share/dict/words\fP. -.TP 8 -.B 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 \fIGuess\fP. -.TP 8 -.B 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 \fIMiss\fP. -.TP 8 -.B 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 \fIRoot:\fP, and is -followed by a space and the root word. -.TP 8 -.B ispell.noneLabel (\fPClass \fBispell.Status) -String displayed in the ispell status bar when there is no near misses. The default -value is \fINone\fP. -.TP 8 -.B 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 \fICompound\fP. -.TP 8 -.B 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 \fIcheck\fP button in the xedit ispell -interface. The default value is \fIOk\fP. -.TP 8 -.B 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 \fIEnd Of File\fP. -.TP 8 -.B 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 \fIRepeat\fP. -.TP 8 -.B ispell.lookLabel (\fPClass \fBispell.Status) -The string displayed in the ispell status bar after displaying the results of -the \fILook\fP command. If no results are found, the value of the -\fIispell.noneLabel\fP resource is shown. -.TP 8 -.B ispell.workingLabel (\fPClass \fBispell.Status) -The string displayed in the ispell status bar while xedit is communicating with -ispell. The default value is \fI...\fP. -.SH WIDGETS -In order to specify resources, it is useful to know the hierarchy of -the widgets which compose \fIxedit\fR. In the notation below, -indentation indicates hierarchical structure. The widget class name -is given first, followed by the widget instance name. -.sp -.nf -.ta .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 -.fi -.sp -.SH ENVIRONMENT -.PP -.TP 20 -.I DISPLAY -to get the default host and display number. -.TP 20 -.I XENVIRONMENT -to get the name of a resource file that overrides the global resources -stored in the RESOURCE_MANAGER property. -.SH FILES -.TP 20 -.I __apploaddir__/Xedit -specifies required resources -.SH "SEE ALSO" -.IR X (__miscmansuffix__), -.IR xrdb (__appmansuffix__), -.I "Athena Widget Set" -.SH RESTRICTIONS -Xedit is not a replacement to Emacs. -.SH COPYRIGHT -Copyright 1988, Digital Equipment Corporation. -.br -Copyright 1989, X Consortium -.br -Copyright 1998, The XFree86 Project -.br -See -.IR X (__miscmansuffix__) -for a full statement of rights and permissions. -.SH AUTHORS -Chris D. Peterson, MIT X Consortium -.br -Paulo Cesar Pereira de Andrade, The XFree86 Project -- cgit v1.2.3