comparison etc/xemacs.1 @ 70:131b0175ea99 r20-0b30

Import from CVS: tag r20-0b30
author cvs
date Mon, 13 Aug 2007 09:02:59 +0200
parents ac2d302a0011
children c7528f8e288d
comparison
equal deleted inserted replaced
69:804d1389bcd6 70:131b0175ea99
1 .TH XEMACS 1 "1996 June 23" 1 .TH XEMACS 1 "1996 November 23"
2 .UC 4 2 .UC 4
3 .SH NAME 3 .SH NAME
4 xemacs \- Emacs: The Next Generation 4 xemacs \- Emacs: The Next Generation
5 .SH SYNOPSIS 5 .SH SYNOPSIS
6 .B xemacs 6 .B xemacs
28 The primary documentation of 28 The primary documentation of
29 .I XEmacs 29 .I XEmacs
30 is in the 30 is in the
31 .I XEmacs Reference 31 .I XEmacs Reference
32 .IR Manual , 32 .IR Manual ,
33 which you can read on line using Info, a subsystem of 33 which you can read on-line using Info, a subsystem of
34 .IR XEmacs . 34 .IR XEmacs .
35 Please look there for complete and up-to-date documentation. 35 Please look there for complete and up-to-date documentation.
36 Complete documentation on using Emacs Lisp is available on-line 36 Complete documentation on using Emacs Lisp is available on-line
37 through the 37 through the
38 .I XEmacs Lisp Programmer's 38 .I XEmacs Lisp Programmer's
60 in a few minutes. 60 in a few minutes.
61 Help Apropos (CTRL-h a) helps you 61 Help Apropos (CTRL-h a) helps you
62 find a command given its functionality, Help Key Binding (CTRL-h k) 62 find a command given its functionality, Help Key Binding (CTRL-h k)
63 describes a given key sequence's effect, and Help Function (CTRL-h f) 63 describes a given key sequence's effect, and Help Function (CTRL-h f)
64 describes a given Lisp function specified by name. You can also 64 describes a given Lisp function specified by name. You can also
65 lookup key sequences in the 65 look up key sequences in the
66 .I XEmacs Reference Manual 66 .I XEmacs Reference Manual
67 using Lookup Key Binding (CTRL-h CTRL-k), 67 using Lookup Key Binding (CTRL-h CTRL-k),
68 and lookup Lisp functions in the 68 and look up Lisp functions in the
69 .I XEmacs Lisp Programmer's Manual 69 .I XEmacs Lisp Programmer's Manual
70 using Lookup Function (CTRL-h CTRL-f). All of these help functions, 70 using Lookup Function (CTRL-h CTRL-f). All of these help functions,
71 and more, are available on the Help menu if you are using a window 71 and more, are available on the Help menu if you are using a window
72 system. 72 system.
73 .PP 73 .PP
97 (Font-Lock), compiling (Compile), running subshells within 97 (Font-Lock), compiling (Compile), running subshells within
98 .I XEmacs 98 .I XEmacs
99 windows (Shell), outline editing (Outline), running a Lisp read-eval-print 99 windows (Shell), outline editing (Outline), running a Lisp read-eval-print
100 loop (Lisp-Interaction-Mode), and automated psychotherapy (Doctor). 100 loop (Lisp-Interaction-Mode), and automated psychotherapy (Doctor).
101 .PP 101 .PP
102 There is an extensive reference manual, but 102 There is an extensive reference manual, but users of other Emacsen
103 users of other Emacsen 103 should have little trouble adapting even without a copy. Users new to
104 should have little trouble adapting even 104 Emacs will be able to use basic features fairly rapidly by studying
105 without a copy. Users new to Emacs will be able 105 the tutorial and using the self-documentation features.
106 to use basic features fairly rapidly by studying the tutorial and
107 using the self-documentation features.
108 .PP 106 .PP
109 .SM XEmacs Options 107 .SM XEmacs Options
110 .PP 108 .PP
111 The following options are processed in the order encountered: 109 XEmacs accepts all standard X Toolkit command line options when run in
112 .TP 8 110 an X Windows environment. In addition, the following options are accepted
113 .I file 111 (when options imply a sequence of actions to perform, they are
114 Edit 112 performed in the order encountered):
115 .IR file \.
116 .TP
117 .BI \+ number
118 Go to the line specified by
119 .I number
120 (do not insert a space between the "+" sign and
121 the number).
122 .TP
123 .B \-help
124 Print a help message and exit.
125 .TP
126 .B \-version
127 Print the version number and exit.
128 .TP
129 .BI \-f " function, " \-funcall " function"
130 Execute the lisp function
131 .IR function \.
132 .TP
133 .BI \-l " file, " \-load " file"
134 Load the Lisp code in the file
135 .IR file \.
136 .TP
137 .BI \-eval " form"
138 Evaluate the Lisp form
139 .IR form \.
140 .TP
141 .BI \-insert " file"
142 Insert
143 .I file
144 into the current buffer.
145 .TP
146 .B \-kill
147 Exit
148 .I XEmacs
149 (useful with
150 .BR \-batch ).
151 .PP
152 These options are processed only if they appear before all other
153 options (and generally must be in the order given):
154 .TP 8 113 .TP 8
155 .BI \-t " file" 114 .BI \-t " file"
156 Use specified 115 Use specified
157 .I file 116 .I file
158 as the terminal instead of using stdin/stdout. This implies 117 as the terminal instead of using stdin/stdout. This implies
165 .BR \-f , 124 .BR \-f ,
166 and 125 and
167 .B \-eval 126 .B \-eval
168 options to specify files to execute and functions to call. 127 options to specify files to execute and functions to call.
169 .TP 128 .TP
170 .B \-nw 129 .B \-nw\
171 Inhibit the use of any window-system-specific display code: use the 130 Inhibit the use of any window-system-specific display code: use the
172 current TTY. This must be the first argument specified in the 131 current TTY.
173 command line.
174 .TP 132 .TP
175 .B \-debug\-init 133 .B \-debug\-init
176 Enter the debugger if an error occurs in the init file. 134 Enter the debugger if an error occurs loading the init file.
177 .TP 135 .TP
178 .B \-unmapped 136 .B \-unmapped
179 Do not map the initial frame. 137 Do not map the initial frame.
180 .TP 138 .TP
181 .B \-no\-site\-file 139 .B \-no\-site\-file
186 .TP 144 .TP
187 .BI \-u " user, " \-user " user" 145 .BI \-u " user, " \-user " user"
188 Load 146 Load
189 .IR user 's 147 .IR user 's
190 init file. 148 init file.
149 .TP 8
150 .I file
151 Edit
152 .IR file \.
153 .TP
154 .BI \+ number
155 Go to the line specified by
156 .I number
157 (do not insert a space between the "+" sign and the number).
158 .TP
159 .B \-help, \-flags, \-?
160 Print a help message and exit.
161 .TP
162 .B \-V, \-version,
163 Print the version number and exit.
164 .TP
165 .BI \-f " function, " \-funcall " function"
166 Execute the lisp function
167 .IR function \.
168 .TP
169 .BI \-l " file, " \-load " file"
170 Load the Lisp code in the file
171 .IR file \.
172 .TP
173 .BI \-eval " form"
174 Evaluate the Lisp form
175 .IR form \.
176 .TP
177 .BI \-i " file, " \-insert " file"
178 Insert
179 .I file
180 into the current buffer.
181 .TP
182 .B \-kill
183 Exit
184 .I XEmacs
185 (useful with
186 .BR \-batch ).
191 .PP 187 .PP
192 .SM Using XEmacs with X 188 .SM Using XEmacs with X
193 .PP 189 .PP
194 .I XEmacs 190 .I XEmacs
195 has been tailored to work well with the X window system. 191 has been tailored to work well with the X window system.
199 display in. You will probably want to start the editor 195 display in. You will probably want to start the editor
200 as a background process 196 as a background process
201 so that you can continue using your original window. 197 so that you can continue using your original window.
202 .PP 198 .PP
203 .I XEmacs 199 .I XEmacs
204 can be started with the following X switches: 200 can be started with the following standard X options:
205 .TP 201 .TP
206 .BI \-geometry " ##x##+##+##" 202 .BI \-geometry " ##x##+##+##"
207 Specify the geometry of the initial window. The ##'s represent a number; 203 Specify the geometry of the initial window. The ##'s represent a number;
208 the four numbers are width (characters), height (characters), X offset 204 the four numbers are width (characters), height (characters), X offset
209 (pixels), and Y offset (pixels), respectively. Partial specifications of 205 (pixels), and Y offset (pixels), respectively. Partial specifications of
591 .ti -\w'CTRL-SHIFT-middle'u+4n 587 .ti -\w'CTRL-SHIFT-middle'u+4n
592 CTRL-SHIFT-left Make a selection, delete it, and insert it at point. 588 CTRL-SHIFT-left Make a selection, delete it, and insert it at point.
593 .br 589 .br
594 .ti -\w'CTRL-SHIFT-middle'u+4n 590 .ti -\w'CTRL-SHIFT-middle'u+4n
595 META-left Make a rectangular selection. 591 META-left Make a rectangular selection.
596 .PP
597 .SH FILES 592 .SH FILES
593 Lisp code is read at startup from the user's init file,
594 \fB$HOME/.emacs\fP.
595
598 /usr/local/info - files for the Info documentation browser 596 /usr/local/info - files for the Info documentation browser
599 (a subsystem of 597 (a subsystem of
600 .IR XEmacs ) 598 .IR XEmacs )
601 to refer to. The complete text of the 599 to refer to. The complete text of the
602 .I XEmacs Reference Manual 600 .I XEmacs Reference Manual
620 /usr/local/lib/xemacs-$VERSION/$CONFIGURATION - various programs that are used 618 /usr/local/lib/xemacs-$VERSION/$CONFIGURATION - various programs that are used
621 with XEmacs. 619 with XEmacs.
622 620
623 /usr/local/lib/xemacs-$VERSION/$CONFIGURATION/DOC-$VERSION-XEmacs - 621 /usr/local/lib/xemacs-$VERSION/$CONFIGURATION/DOC-$VERSION-XEmacs -
624 contains the documentation strings for the Lisp primitives and 622 contains the documentation strings for the Lisp primitives and
625 preloaded Lisp functions of 623 preloaded Lisp functions of \fIXEmacs\fP.
626 .IR XEmacs \. 624 They are stored here to reduce the size of \fIXEmacs\fP proper.
627 They are stored here to reduce the size of
628 .I XEmacs
629 proper.
630 625
631 .br 626 .br
632 /usr/local/lib/xemacs-$VERSION/etc/SERVICE - lists people offering 627 /usr/local/lib/xemacs-$VERSION/etc/SERVICE - lists people offering
633 various services to assist users of 628 various services to assist users of \fIXEmacs\fP,
634 .IR XEmacs ,
635 including education, troubleshooting, porting and customization. 629 including education, troubleshooting, porting and customization.
636 630
637 /usr/local/lib/xemacs/lock - holds lock files that are made for all 631 /usr/local/lib/xemacs/lock - holds lock files that are made for all
638 files being modified in 632 files being modified in
639 .IR XEmacs , 633 .IR XEmacs ,
706 .SH AUTHORS 700 .SH AUTHORS
707 .PP 701 .PP
708 .I XEmacs 702 .I XEmacs
709 was written by Chuck Thompson <cthomp@xemacs.org>, Ben Wing 703 was written by Chuck Thompson <cthomp@xemacs.org>, Ben Wing
710 <wing@666.com>, Jamie Zawinski <jwz@netscape.com>, Richard Mlynarik 704 <wing@666.com>, Jamie Zawinski <jwz@netscape.com>, Richard Mlynarik
711 <mly@adoc.xerox.com>, and many others. It was based on an early 705 <mly@adoc.xerox.com>, Martin Buchholz <mrb@eng.sun.com> and many
712 version of 706 others. It was based on an early version of
713 .I GNU Emacs Version 707 .I GNU Emacs Version
714 .IR 19 , 708 .IR 19 ,
715 written by Richard Stallman of the Free Software 709 written by Richard Stallman of the Free Software
716 Foundation, and has tracked subsequent releases of 710 Foundation, and has tracked subsequent releases of
717 .I GNU Emacs 711 .I GNU Emacs
745 with 739 with
746 .I GNU Emacs Version 740 .I GNU Emacs Version
747 .IR 19 \. 741 .IR 19 \.
748 .PP 742 .PP
749 Many others have also contributed significantly. For more detailed 743 Many others have also contributed significantly. For more detailed
750 information, including a long history of 744 information, including a long history of \fIXEmacs\fP from multiple
751 .I XEmacs 745 viewpoints and pretty pictures and bios of the major \fIXEmacs\fP
752 from multiple viewpoints and pretty pictures and bios of the major
753 .I XEmacs
754 contributors, see the 746 contributors, see the
755 .I XEmacs About Page 747 .I XEmacs About Page
756 (the About XEmacs option on the Help menu). 748 (the About XEmacs option on the Help menu).
757 .SH MORE INFORMATION 749 .SH MORE INFORMATION
758 For more information about 750 For more information about \fIXEmacs\fP, see the
759 .IR XEmacs ,
760 see the
761 .I XEmacs About Page 751 .I XEmacs About Page
762 (mentioned above), 752 (mentioned above),
763 look in the file /usr/local/lib/xemacs-$VERSION/etc/NEWS, 753 look in the file /usr/local/lib/xemacs-$VERSION/etc/NEWS,
764 or point your Web browser at 754 or point your Web browser at
765 .PP 755 .PP
766 http://www.xemacs.org/ 756 http://www.xemacs.org/
767 .PP 757 .PP
768 for up-to-the-minute information about 758 for up-to-the-minute information about \fIXEmacs\fP.
769 .IR XEmacs \.
770 .PP 759 .PP
771 The 760 The
772 .I XEmacs 761 .I XEmacs
773 FAQ (Frequently Asked Questions) can be found at the Web site just listed. 762 FAQ (Frequently Asked Questions) can be found at the Web site just listed.
774 A possibly out-of-date version is also accessible through the Info system 763 A possibly out-of-date version is also accessible through the Info system
775 inside of 764 inside of \fIXEmacs\fP.
776 .IR XEmacs \. 765 .PP
777 .PP 766 The latest version of \fIXEmacs\fP can be downloaded using anonymous
778 The latest version of 767 FTP from
779 .I XEmacs
780 can be downloaded using anonymous FTP from
781 .PP 768 .PP
782 ftp://ftp.xemacs.org/pub/xemacs/ 769 ftp://ftp.xemacs.org/pub/xemacs/
783 .PP 770 .PP
784 or from a mirror site near you. Here is an approximate (possibly 771 or from a mirror site near you. Here is an approximate (possibly
785 out-of-date) list of mirror sites: 772 out-of-date) list of mirror sites: