-.TH EMACS 1 "1995 December 7"
+.\" Copyright (C) 1995, 1999, 2000, 2001, 2002, 2003, 2004,
+.\" 2005 Free Software Foundation, Inc.
+.\"
+.\" This file is part of GNU Emacs.
+.\"
+.\" GNU Emacs is free software; you can redistribute it and/or modify
+.\" it under the terms of the GNU General Public License as published by
+.\" the Free Software Foundation; either version 2, or (at your option)
+.\" any later version.
+.\"
+.\" GNU Emacs is distributed in the hope that it will be useful,
+.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
+.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+.\" GNU General Public License for more details.
+.\"
+.\" You should have received a copy of the GNU General Public License
+.\" along with GNU Emacs; see the file COPYING. If not, write to the
+.\" Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+.\" Boston, MA 02110-1301, USA.
+.\"
+'\" t
+.TH EMACS 1 "2001 November 23"
.UC 4
.SH NAME
emacs \- GNU project Emacs
.br
.SH DESCRIPTION
.I GNU Emacs
-is a version of
+is a version of
.I Emacs,
-written by the author of the original (PDP-10)
+written by the author of the original (PDP-10)
.I Emacs,
Richard Stallman.
.br
page takes away from other more useful projects.
.br
The user functionality of GNU Emacs encompasses
-everything other
-.I Emacs
+everything other
+.I Emacs
editors do, and it is easily extensible since its
editing commands are written in Lisp.
.PP
but the facility assumes that you know how to manipulate
.I Emacs
windows and buffers.
-CTRL-h (backspace
-or CTRL-h) enters the Help facility. Help Tutorial (CTRL-h t)
+CTRL-h or F1 enters the Help facility. Help Tutorial (CTRL-h t)
requests an interactive tutorial which can teach beginners the fundamentals
-of
-.I Emacs
+of
+.I Emacs
in a few minutes.
Help Apropos (CTRL-h a) helps you
find a command given its functionality, Help Character (CTRL-h c)
(do not insert a space between the "+" sign and
the number).
.TP
+.BI \+ line:column
+Go to the specified
+.I line
+and
+.I column
+.TP
.B \-q
Do not load an init file.
.TP
+.B \-no-site-file
+Do not load the site-wide startup file.
+.TP
+.BI \-debug-init
+Enable
+.I Emacs
+Lisp debugger during the processing of the user init file
+.BI ~/.emacs.
+This is useful for debugging problems in the init file.
+.TP
.BI \-u " user"
Load
.I user's
.I file
as the terminal instead of using stdin/stdout.
This must be the first argument specified in the command line.
+.TP
+.B \-version
+Display
+.I Emacs
+version information and exit.
.PP
The following options are lisp-oriented
(these options are processed in the order encountered):
.BI \-l " file"
Load the lisp code in the file
.I file.
+.TP
+.BI \-eval " expr"
+Evaluate the Lisp expression
+.I expr.
.PP
The following options are useful when running
.I Emacs
options to specify files to execute and functions to call.
.TP
.B \-kill
-Exit
-.I Emacs
+Exit
+.I Emacs
while in batch mode.
+.TP
+.BI \-L " directory"
+Add
+.I directory
+to the list of directories
+.I Emacs
+searches for Lisp files.
.\" START DELETING HERE IF YOU'RE NOT USING X
.PP
.SM Using Emacs with X
When you specify a font, be sure to put a space between the
switch and the font name.
.TP
-.BI \-b " pixels"
+.BI \-bw " pixels"
Set the
.I Emacs
window's border width to the number of pixels specified by
.TP
.BI \-ib " pixels"
Set the window's internal border width to the number of pixels specified
-by
+by
.I pixels.
Defaults to one pixel of padding on each side of the window.
.PP
.TP 8
-.BI \-geometry " geometry"
+.BI \-\-geometry " geometry"
Set the
.I Emacs
window's width, height, and position as specified. The geometry
.IR X (1)
for more information.
The width and height are specified in characters; the default is 80 by
-24.
+24. See the Emacs manual, section "Options for Window Size and Position",
+for information on how window sizes interact
+with selecting or deselecting the tool bar and menu bar.
.PP
.TP 8
.BI \-fg " color"
the border color will be set to grey,
and the text and mouse cursors will be set to black.
.PP
-.SM Using the Mouse
+.SM Using the Mouse
.PP
The following lists the mouse button bindings for the
.I Emacs
window under X11.
-.in +\w'CTRL-SHIFT-middle'u+4n
-.ta \w'CTRL-SHIFT-middle'u+4n
-.ti -\w'CTRL-SHIFT-middle'u+4n
+.TS
+l l.
MOUSE BUTTON FUNCTION
-.br
-.ti -\w'CTRL-SHIFT-middle'u+4n
left Set point.
-.br
-.ti -\w'CTRL-SHIFT-middle'u+4n
middle Paste text.
-.br
-.ti -\w'CTRL-SHIFT-middle'u+4n
right Cut text into X cut buffer.
-.br
-.ti -\w'CTRL-SHIFT-middle'u+4n
SHIFT-middle Cut text into X cut buffer.
-.br
-.ti -\w'CTRL-SHIFT-middle'u+4n
SHIFT-right Paste text.
-.br
-.ti -\w'CTRL-SHIFT-middle'u+4n
CTRL-middle Cut text into X cut buffer and kill it.
-.br
-.ti -\w'CTRL-SHIFT-middle'u+4n
-CTRL-right Select this window, then split it into
+CTRL-right T{
+Select this window, then split it into
two windows. Same as typing CTRL-x 2.
+T}
.\" START DELETING HERE IF YOU'RE NOT USING X MENUS
-.br
-.ti -\w'CTRL-SHIFT-middle'u+4n
-CTRL-SHIFT-left X buffer menu--hold the buttons and keys
-down, wait for menu to appear, select
+CTRL-SHIFT-left T{
+X buffer menu--hold the buttons and keys
+down, wait for menu to appear, select
buffer, and release. Move mouse out of
menu and release to cancel.
-.br
-.ti -\w'CTRL-SHIFT-middle'u+4n
-CTRL-SHIFT-middle X help menu--pop up index card menu for
-Emacs help.
+T}
+CTRL-SHIFT-middle X help menu--pop up index card menu for Emacs help.
.\" STOP DELETING HERE IF YOU'RE NOT USING X MENUS
-.br
-.ti -\w'CTRL-SHIFT-middle'u+4n
-CTRL-SHIFT-right Select window with mouse, and delete all
+CTRL-SHIFT-right T{
+Select window with mouse, and delete all
other windows. Same as typing CTRL-x 1.
+T}
.\" STOP DELETING HERE IF YOU'RE NOT USING X
+.TE
.PP
.SH MANUALS
You can order printed copies of the GNU Emacs Manual from the Free
/usr/local/share/emacs/$VERSION/lisp - Lisp source files and compiled files
that define most editing commands. Some are preloaded;
others are autoloaded from this directory when used.
-
+
/usr/local/share/emacs/$VERSION/etc - various programs that are used with
GNU Emacs, and some files of information.
running in Raw mode on some Unix versions.
.SH UNRESTRICTIONS
.PP
-.I Emacs
-is free; anyone may redistribute copies of
-.I Emacs
+.I Emacs
+is free; anyone may redistribute copies of
+.I Emacs
to
-anyone under the terms stated in the
-.I Emacs
+anyone under the terms stated in the
+.I Emacs
General Public License,
-a copy of which accompanies each copy of
-.I Emacs
+a copy of which accompanies each copy of
+.I Emacs
and which also
appears in the reference manual.
.PP
systems. Such inclusion violates the terms on which distribution
is permitted. In fact, the primary purpose of the General Public
License is to prohibit anyone from attaching any other restrictions
-to redistribution of
+to redistribution of
.I Emacs.
.PP
-Richard Stallman encourages you to improve and extend
-.I Emacs,
+Richard Stallman encourages you to improve and extend
+.I Emacs,
and urges that
you contribute your extensions to the GNU library. Eventually GNU
(Gnu's Not Unix) will be a complete replacement for Berkeley
.I Emacs
was written by Richard Stallman and the Free Software Foundation.
Joachim Martillo and Robert Krawitz added the X features.
+.SH COPYING
+Copyright
+.if t \(co
+.if n (c)
+1995, 1999, 2000, 2001, 2002, 2003, 2004, 2005 Free Software Foundation, Inc.
+.PP
+Permission is granted to make and distribute verbatim copies of this
+document provided the copyright notice and this permission notice are
+preserved on all copies.
+.PP
+Permission is granted to copy and distribute modified versions of
+this document under the conditions for verbatim copying, provided that
+the entire resulting derived work is distributed under the terms of
+a permission notice identical to this one.
+.PP
+Permission is granted to copy and distribute translations of this
+document into another language, under the above conditions for
+modified versions, except that this permission notice may be stated
+in a translation approved by the Free Software Foundation.
+
+.\" arch-tag: 04dfd376-b46e-4924-919a-cecc3b257eaa