diff options
Diffstat (limited to 'man')
| -rw-r--r-- | man/ChangeLog | 147 | ||||
| -rw-r--r-- | man/ack.texi | 2 | ||||
| -rw-r--r-- | man/building.texi | 155 | ||||
| -rw-r--r-- | man/cmdargs.texi | 4 | ||||
| -rw-r--r-- | man/custom.texi | 5 | ||||
| -rw-r--r-- | man/dired.texi | 41 | ||||
| -rw-r--r-- | man/display.texi | 11 | ||||
| -rw-r--r-- | man/emacs.texi | 2 | ||||
| -rw-r--r-- | man/entering.texi | 56 | ||||
| -rw-r--r-- | man/erc.texi | 2 | ||||
| -rw-r--r-- | man/faq.texi | 187 | ||||
| -rw-r--r-- | man/gnus.texi | 14 | ||||
| -rw-r--r-- | man/help.texi | 116 | ||||
| -rw-r--r-- | man/mark.texi | 30 | ||||
| -rw-r--r-- | man/misc.texi | 13 | ||||
| -rw-r--r-- | man/mule.texi | 4 | ||||
| -rw-r--r-- | man/org.texi | 154 | ||||
| -rw-r--r-- | man/rcirc.texi | 2 | ||||
| -rw-r--r-- | man/search.texi | 9 | ||||
| -rw-r--r-- | man/texinfo.tex | 44 | ||||
| -rw-r--r-- | man/text.texi | 64 |
21 files changed, 752 insertions, 310 deletions
diff --git a/man/ChangeLog b/man/ChangeLog index 6385b4393a0..ee0dac8359c 100644 --- a/man/ChangeLog +++ b/man/ChangeLog @@ -1,3 +1,138 @@ +2006-08-25 Kim F. Storm <storm@cua.dk> + + * display.texi (Display Custom): Add variables overline-margin + and x-underline-at-descent-line. + +2006-08-25 Richard Stallman <rms@gnu.org> + + * entering.texi (Exiting): Rewrite to give graphical displays + priority over text terminals. + + * search.texi (Incremental Search): Move index entries. + +2006-08-23 Chong Yidong <cyd@stupidchicken.com> + + * custom.texi (Init File): Reference Find Init to avoid "home + directory" confusion. + +2006-08-22 Nick Roberts <nickrob@snap.net.nz> + + * building.texi (Other GDB-UI Buffers): Describe how to edit + a value in the locals buffer. + +2006-08-21 Richard Stallman <rms@gnu.org> + + * search.texi (Basic Isearch): Add `isearch' index entry. + +2006-08-16 Richard Stallman <rms@gnu.org> + + * misc.texi (Saving Emacs Sessions): Clean up wording. + + * mark.texi (Marking Objects): Mention term "select all". + + * emacs.texi (Top): Update subnode menu. + + * help.texi (Help Mode): Move node up in file. + +2006-08-15 Carsten Dominik <dominik@science.uva.nl> + + * org.texi (Installation, Activation): Split from Installation and + Activation. + (Clocking work time): Documented new features. + +2006-08-15 Nick Roberts <nickrob@snap.net.nz> + + * building.texi (Stack Buffer): Explain fringe arrow. + +2006-08-13 Alex Schroeder <alex@gnu.org> + + * rcirc.texi (Configuration): Use correct variable in rcirc-authinfo + example. + +2006-08-12 Eli Zaretskii <eliz@gnu.org> + + * faq.texi (How to add fonts): New node. + + * misc.texi (Saving Emacs Sessions): Clarify when desktop is restored + on startup. + +2006-08-11 Romain Francoise <romain@orebokech.com> + + * ack.texi (Acknowledgments): Delete mention to zone-mode.el. + +2006-08-10 Sven Joachim <svenjoac@gmx.de> (tiny change) + + * mule.texi (Recognize Coding, Text Coding): Fix typos. + +2006-08-10 Richard Stallman <rms@gnu.org> + + * text.texi (Format Faces): Substantial rewrites to deal + with face merging. Empty regions don't count. Clarify + face property inheritance. + +2006-08-08 Romain Francoise <romain@orebokech.com> + + * dired.texi (Marks vs Flags): Fix typo reported by Ari Roponen + <arjuropo@cc.jyu.fi>. + +2006-08-05 Romain Francoise <romain@orebokech.com> + + * faq.texi (New in Emacs 22): Expand. + +2006-08-04 Eli Zaretskii <eliz@gnu.org> + + * cmdargs.texi (Window Size X) <--geometry>: Only width and height + apply to all frames. + +2006-08-03 Michael Olson <mwolson@gnu.org> + + * erc.texi: Update for ERC 5.1.4. + +2006-08-01 Richard Stallman <rms@gnu.org> + + * help.texi (Name Help): Add index entries for describe-variable. + +2006-08-01 Nick Roberts <nickrob@snap.net.nz> + + * building.texi (GDB Graphical Interface): Shorten node names. + (GDB-UI Layout): Use GDB-related. + (Other GDB-UI Buffers): Simplify English. + +2006-07-31 Richard Stallman <rms@gnu.org> + + * search.texi (Query Replace): Add xref for Dired's Q command. + +2006-07-28 Katsumi Yamaoka <yamaoka@jpl.org> + + * gnus.texi (Oort Gnus): Mention that the Lisp files are now installed + in .../site-lisp/gnus/ by default. + [ From gnus-news.texi in the trunk. ] + +2006-07-27 Reiner Steib <Reiner.Steib@gmx.de> + + * gnus.texi (MIME Commands): Additions for yEnc. + +2006-07-31 Nick Roberts <nickrob@snap.net.nz> + + * building.texi (GDB commands in Fringe): Rename to... + (Source Buffers): ..this and move forward. Describe hollow arrow and + new option gdb-find-source-frame. + +2006-07-29 Richard Stallman <rms@gnu.org> + + * dired.texi (Operating on Files): Simplify previous change + and fix Texinfo usage. + +2006-07-29 Eli Zaretskii <eliz@gnu.org> + + * dired.texi (Operating on Files): Add cross-references. State the + Unix commands that do similar things. + +2006-07-28 Richard Stallman <rms@gnu.org> + + * mark.texi (Transient Mark): Clarify that region never disappears + when Transient Mark mode is off, and not when it is on. + 2006-07-27 Richard Stallman <rms@gnu.org> * search.texi (Non-ASCII Isearch): Clarify. Mention C-q. @@ -6,15 +141,15 @@ * xresources.texi (GTK styles): Fix texinfo usage. - * pgg.texi, org.texi, info.texi, forms.texi, flymake.texi: + * pgg.texi, org.texi, info.texi, forms.texi, flymake.texi: * faq.texi: Move periods and commas inside quotes. * commands.texi (User Input): Explain why we teach keyboard cmds. - - * xresources.texi, xresmini.texi, search.texi, programs.texi: - * misc.texi, kmacro.texi, killing.texi, glossary.texi: - * fortran-xtra.texi, files.texi, emacs.texi, emacs-xtra.texi: - * doclicense.texi, display.texi, dired.texi, basic.texi: + + * xresources.texi, xresmini.texi, search.texi, programs.texi: + * misc.texi, kmacro.texi, killing.texi, glossary.texi: + * fortran-xtra.texi, files.texi, emacs.texi, emacs-xtra.texi: + * doclicense.texi, display.texi, dired.texi, basic.texi: * anti.texi, ack.texi: Move periods and commas inside quotes. 2006-07-22 Eli Zaretskii <eliz@gnu.org> diff --git a/man/ack.texi b/man/ack.texi index 7294cdc3350..67c731d6174 100644 --- a/man/ack.texi +++ b/man/ack.texi @@ -419,8 +419,6 @@ them. @item John Heidemann wrote @file{mouse-copy.el} and @file{mouse-drag.el}, which provide alternative mouse-based editing and scrolling features. -He also contributed @file{zone-mode.el}, a major mode for editing DNS -zone files. @item Jon K Hellan wrote @file{utf7.el}, support for mail-safe transformation diff --git a/man/building.texi b/man/building.texi index 549c69da544..01cdf88fe39 100644 --- a/man/building.texi +++ b/man/building.texi @@ -833,17 +833,17 @@ Emacs session. If you have customized @code{gud-gdb-command-name} in that way, you can use @kbd{M-x gdba} to invoke GDB in graphical mode. @menu -* GDB User Interface Layout:: Control the number of displayed buffers. +* GDB-UI Layout:: Control the number of displayed buffers. +* Source Buffers:: Use the mouse in the fringe/margin to + control your program. * Breakpoints Buffer:: A breakpoint control panel. * Stack Buffer:: Select a frame from the call stack. -* Other GDB User Interface Buffers:: Input/output, locals, registers, +* Other GDB-UI Buffers:: Input/output, locals, registers, assembler, threads and memory buffers. -* GDB commands in the Fringe:: Use the mouse in the fringe/margin to - control your program. * Watch Expressions:: Monitor variable values in the speedbar. @end menu -@node GDB User Interface Layout +@node GDB-UI Layout @subsubsection GDB User Interface Layout @cindex GDB User Interface layout @@ -863,7 +863,7 @@ displays the following frame layout: +--------------------------------+--------------------------------+ | GUD buffer (I/O of GDB) | Locals buffer | |--------------------------------+--------------------------------+ -| Source buffer | I/O buffer for debugged pgm | +| Primary Source buffer | I/O buffer for debugged pgm | |--------------------------------+--------------------------------+ | Stack buffer | Breakpoints buffer | +--------------------------------+--------------------------------+ @@ -871,8 +871,8 @@ displays the following frame layout: @end smallexample However, if @code{gdb-use-separate-io-buffer} is @code{nil}, the I/O -buffer does not appear and the source buffer occupies the full width -of the frame. +buffer does not appear and the primary source buffer occupies the full +width of the frame. @findex gdb-restore-windows If you change the window layout, for example, while editing and @@ -884,7 +884,7 @@ layout with the command @code{gdb-restore-windows}. containing just the GUD buffer and a source file, type @kbd{M-x gdb-many-windows}. - You may also specify additional GUD-related buffers to display, + You may also specify additional GDB-related buffers to display, either in the same frame or a different one. Select the buffers you want with the @samp{GUD->GDB-windows} and @samp{GUD->GDB-Frames} sub-menus. If the menu-bar is unavailable, type @code{M-x @@ -904,6 +904,61 @@ as well as GDB's breakpoints. You do need to check that the breakpoints in recently edited source files are still in the right places. +@node Source Buffers +@subsubsection Source Buffers +@cindex GDB commands in Fringe + +@c @findex gdb-mouse-set-clear-breakpoint +@c @findex gdb-mouse-toggle-breakpoint +Many GDB commands can be entered using keybindings or the tool bar but +sometimes it is quicker to use the fringe. These commands either +manipulate breakpoints or control program execution. When there is no +fringe, you can use the margin but this is only present when the +source file already has a breakpoint. + +You can click @kbd{Mouse-1} in the fringe or display margin of a +source buffer to set a breakpoint there and, on a graphical display, a +red bullet will appear on that line. If a breakpoint already exists +on that line, the same click will remove it. You can also enable or +disable a breakpoint by clicking @kbd{C-Mouse-1} on the bullet. + +A solid arrow in the left fringe of a source buffer indicates the line +of the innermost frame where the debugged program has stopped. A +hollow arrow indicates the current execution line of higher level +frames. + +If you drag the arrow in the fringe with @kbd{Mouse-1} +(@code{gdb-mouse-until}), execution will continue to the line where +you release the button, provided it is still in the same frame. +Alternatively, you can click @kbd{Mouse-3} at some point in the fringe +of this buffer and execution will advance to there. A similar command +(@code{gdb-mouse-jump}) allows you to jump to a source line without +executing the intermediate lines by clicking @kbd{C-Mouse-3}. This +command allows you to go backwards which can be useful for running +through code that has already executed, in order to examine its +execution in more detail. + +@table @kbd +@item Mouse-1 +Set or clear a breakpoint. + +@item C-Mouse-1 +Enable or disable a breakpoint. + +@item Mouse-3 +Continue execution to here. + +@item C-Mouse-3 +Jump to here. +@end table + +If the variable @code{gdb-find-source-frame} is non-@code{nil} and +execution stops in a frame for which there is no source code e.g after +an interrupt, then Emacs finds and displays the first frame further up +stack for which there is source. If it is @code{nil} then the source +buffer continues to display the last frame which maybe more useful, +for example, when re-setting a breakpoint. + @node Breakpoints Buffer @subsubsection Breakpoints Buffer @@ -918,7 +973,7 @@ breakpoint}, the breakpoint which point is on. @findex gdb-toggle-breakpoint Enable/disable the current breakpoint (@code{gdb-toggle-breakpoint}). On a graphical display, this changes the color of a bullet in the -margin of the source buffer at the relevant line. This is red when +margin of a source buffer at the relevant line. This is red when the breakpoint is enabled and grey when it is disabled. Text-only terminals correspondingly display a @samp{B} or @samp{b}. @@ -946,34 +1001,35 @@ of the nested subroutine calls (@dfn{stack frames}) now active in the program. @xref{Backtrace,, Backtraces, gdb, The GNU debugger}. @findex gdb-frames-select - The selected frame number is displayed in reverse contrast. To -select a frame in GDB, move point in the stack buffer to that stack -frame and type @key{RET} (@code{gdb-frames-select}), or click +An arrow in the fringe points to the selected frame or, if the fringe is +not present, the number of the selected frame is displayed in reverse +contrast. To select a frame in GDB, move point in the stack buffer to +that stack frame and type @key{RET} (@code{gdb-frames-select}), or click @kbd{Mouse-2} on a stack frame. If the locals buffer is visible, -selecting a stack frame updates it to display the local variables of -the new frame. +selecting a stack frame updates it to display the local variables of the +new frame. -@node Other GDB User Interface Buffers +@node Other GDB-UI Buffers @subsubsection Other Buffers @table @asis @item Input/Output Buffer @vindex gdb-use-separate-io-buffer If the variable @code{gdb-use-separate-io-buffer} is non-@code{nil}, -the executable program that is being debugged takes its input and -displays its output here. Otherwise it uses the GUD buffer for that. -To toggle whether GUD mode uses this buffer, do @kbd{M-x -gdb-use-separate-io-buffer}. That takes effect when you next -restart the program you are debugging. +the program being debugged takes its input and displays its output +here. Otherwise it uses the GUD buffer for that. To toggle whether +GUD mode uses this buffer, do @kbd{M-x gdb-use-separate-io-buffer}. +This takes effect when you next restart the program you are debugging. The history and replay commands from Shell mode are available here, -as are the commands to send signals to the program you are debugging. +as are the commands to send signals to the debugged program. @xref{Shell Mode}. @item Locals Buffer The locals buffer displays the values of local variables of the current frame for simple data types (@pxref{Frame Info, Frame Info, -Information on a frame, gdb, The GNU debugger}). +Information on a frame, gdb, The GNU debugger}). Press @key{RET} or +click @kbd{Mouse-2} on the value if you want to edit it. Arrays and structures display their type only. With GDB 6.4 or later, move point to their name and press @key{RET}, or alternatively click @@ -985,7 +1041,7 @@ of GDB, use @kbd{Mouse-2} or @key{RET} on the type description @findex toggle-gdb-all-registers The registers buffer displays the values held by the registers (@pxref{Registers,,, gdb, The GNU debugger}). Press @key{RET} or -click @kbd{Mouse-2} on a register if you want to change its value. +click @kbd{Mouse-2} on a register if you want to edit its value. With GDB 6.4 or later, recently changed register values display with @code{font-lock-warning-face}. With earlier versions of GDB, you can press @key{SPC} to toggle the display of floating point registers @@ -1003,10 +1059,10 @@ The threads buffer displays a summary of all threads currently in your program (@pxref{Threads, Threads, Debugging programs with multiple threads, gdb, The GNU debugger}). Move point to any thread in the list and press @key{RET} to select it (@code{gdb-threads-select}) and -display the associated source in the source buffer. Alternatively, -click @kbd{Mouse-2} on a thread to select it. If the locals buffer is -visible, its contents update to display the variables that are local -in the new thread. +display the associated source in the primary source buffer. +Alternatively, click @kbd{Mouse-2} on a thread to select it. If the +locals buffer is visible, its contents update to display the variables +that are local in the new thread. @item Memory Buffer The memory buffer lets you examine sections of program memory @@ -1017,49 +1073,6 @@ displays. Click @kbd{Mouse-3} on the header line to select the display format or unit size for these data items. @end table -@node GDB commands in the Fringe -@subsubsection GDB commands in the Fringe -@cindex GDB commands in the Fringe - -@c @findex gdb-mouse-set-clear-breakpoint -@c @findex gdb-mouse-toggle-breakpoint -Many GDB commands can be entered using keybindings or the tool bar but -sometimes it is quicker to use the fringe. These commands either -manipulate breakpoints or control program execution. When there is no -fringe, you can use the margin but this is only present when the -source file already has a breakpoint. - -You can click @kbd{Mouse-1} in the fringe or display margin of a -source buffer to set a breakpoint there and, on a graphical display, a -red bullet will appear on that line. If a breakpoint already exists -on that line, the same click will remove it. You can also enable or -disable a breakpoint by clicking @kbd{C-Mouse-1} on the bullet. - -If you drag the debugger arrow in the fringe with @kbd{Mouse-1} -(@code{gdb-mouse-until}), execution will continue to the line where -you release the button, provided it is still in the same frame. -Alternatively, you can click @kbd{Mouse-3} at some point in the fringe -of this buffer and execution will advance to there. A similar command -(@code{gdb-mouse-jump}) allows you to jump to a source line without -executing the intermediate lines by clicking @kbd{C-Mouse-3}. This -command allows you to go backwards which can be useful for running -through code that has already executed, in order to examine its -execution in more detail. - -@table @kbd -@item Mouse-1 -Set or clear a breakpoint. - -@item C-Mouse-1 -Enable or disable a breakpoint. - -@item Mouse-3 -Continue execution to here. - -@item C-Mouse-3 -Jump to here. -@end table - @node Watch Expressions @subsubsection Watch Expressions @cindex Watching expressions in GDB diff --git a/man/cmdargs.texi b/man/cmdargs.texi index a1b26bcdcb3..fc17d7ec695 100644 --- a/man/cmdargs.texi +++ b/man/cmdargs.texi @@ -1013,7 +1013,9 @@ position of the initial Emacs frame: @cindex geometry, command-line argument Specify the size @var{width} and @var{height} (measured in character columns and lines), and positions @var{xoffset} and @var{yoffset} -(measured in pixels). This applies to all frames. +(measured in pixels). The @var{width} and @var{height} parameters +apply to all frames, whereas @var{xoffset} and @var{yoffset} only to +the initial frame. @item -fs @opindex -fs diff --git a/man/custom.texi b/man/custom.texi index dbe2a1b328c..682cb5b9310 100644 --- a/man/custom.texi +++ b/man/custom.texi @@ -2063,9 +2063,8 @@ Reference Manual}. @cindex rebinding keys, permanently @cindex startup (init file) - When Emacs is started, it normally loads a Lisp program from the -file @file{.emacs} or @file{.emacs.el} in your home directory -(see @ref{General Variables, HOME}, if you don't know where that is). + When Emacs is started, it normally loads a Lisp program from the file +@file{.emacs} or @file{.emacs.el} in your home directory (@pxref{Find Init}). We call this file your @dfn{init file} because it specifies how to initialize Emacs for you. You can use the command line switch @samp{-q} to prevent loading your init file, and @samp{-u} (or diff --git a/man/dired.texi b/man/dired.texi index 97597ffcd81..0281c6b0107 100644 --- a/man/dired.texi +++ b/man/dired.texi @@ -325,7 +325,7 @@ for @file{..} and typing @kbd{f} there. Instead of flagging a file with @samp{D}, you can @dfn{mark} the file with some other character (usually @samp{*}). Most Dired commands to operate on files use the files marked with @samp{*}. The -only command that operates on flagged flies is @kbd{x}, which expunges +only command that operates on flagged files is @kbd{x}, which expunges them. Here are some commands for marking with @samp{*}, for unmarking, and @@ -550,34 +550,38 @@ next window, that other buffer's directory is suggested instead. @item C @var{new} @key{RET} Copy the specified files (@code{dired-do-copy}). The argument @var{new} is the directory to copy into, or (if copying a single file) the new -name. +name. This is like the shell command @code{cp}. @vindex dired-copy-preserve-time If @code{dired-copy-preserve-time} is non-@code{nil}, then copying with this command preserves the modification time of the old file in -the copy. +the copy, like @samp{cp -p}. @vindex dired-recursive-copies @cindex recursive copying The variable @code{dired-recursive-copies} controls whether to copy -directories recursively. The default is @code{nil}, which means that -directories cannot be copied. +directories recursively (like @samp{cp -r}). The default is +@code{nil}, which means that directories cannot be copied. @item D @findex dired-do-delete @kindex D @r{(Dired)} -Delete the specified files (@code{dired-do-delete}). Like the other -commands in this section, this command operates on the @emph{marked} -files, or the next @var{n} files. By contrast, @kbd{x} +Delete the specified files (@code{dired-do-delete}). This is like the +shell command @code{rm}. + +Like the other commands in this section, this command operates on the +@emph{marked} files, or the next @var{n} files. By contrast, @kbd{x} (@code{dired-do-flagged-delete}) deletes all @dfn{flagged} files. @findex dired-do-rename @kindex R @r{(Dired)} @cindex renaming files (in Dired) +@cindex moving files (in Dired) @item R @var{new} @key{RET} -Rename the specified files (@code{dired-do-rename}). The argument -@var{new} is the directory to rename into, or (if renaming a single -file) the new name. +Rename the specified files (@code{dired-do-rename}). If you rename a +single file, the argument @var{new} is the new name of the file. If +you rename several files, the argument @var{new} is the directory into +which to move the files (this is like the shell command @code{mv}). Dired automatically changes the visited file name of buffers associated with renamed files so that they refer to the new names. @@ -586,17 +590,19 @@ with renamed files so that they refer to the new names. @kindex H @r{(Dired)} @cindex hard links (in Dired) @item H @var{new} @key{RET} -Make hard links to the specified files (@code{dired-do-hardlink}). The -argument @var{new} is the directory to make the links in, or (if making -just one link) the name to give the link. +Make hard links to the specified files (@code{dired-do-hardlink}). +This is like the shell command @code{ln}. The argument @var{new} is +the directory to make the links in, or (if making just one link) the +name to give the link. @findex dired-do-symlink @kindex S @r{(Dired)} @cindex symbolic links (creation in Dired) @item S @var{new} @key{RET} Make symbolic links to the specified files (@code{dired-do-symlink}). -The argument @var{new} is the directory to make the links in, or (if -making just one link) the name to give the link. +This is like @samp{ln -s}. The argument @var{new} is the directory to +make the links in, or (if making just one link) the name to give the +link. @findex dired-do-chmod @kindex M @r{(Dired)} @@ -631,7 +637,8 @@ different places). @cindex changing file time (in Dired) @item T @var{timestamp} @key{RET} Touch the specified files (@code{dired-do-touch}). This means -updating their modification times to the present time. +updating their modification times to the present time. This is like +the shell command @code{touch}. @findex dired-do-print @kindex P @r{(Dired)} diff --git a/man/display.texi b/man/display.texi index 57276ac7557..2a0abd4bef6 100644 --- a/man/display.texi +++ b/man/display.texi @@ -1215,6 +1215,17 @@ page for other output. On such terminals, you might want to set the variable assume, when resumed, that the screen page it is using still contains what Emacs last wrote there. +@vindex overline-margin + On graphical display, this variables specifies the number of pixes +the overline is shown above the text. The value includes the height of +the overline itself (1 pixel). The default value is 2 pixels. + +@vindex x-underline-at-descent-line + On graphical display, the underline is normally drawn at the +baseline level of the font. If @code{x-underline-at-descent-line} is +non-@code{nil}, the underline is drawn at the same position as the +font's decent line. + @ignore arch-tag: 2219f910-2ff0-4521-b059-1bd231a536c4 @end ignore diff --git a/man/emacs.texi b/man/emacs.texi index a5c8371c7db..b2f028052e5 100644 --- a/man/emacs.texi +++ b/man/emacs.texi @@ -272,9 +272,9 @@ Help * Key Help:: Asking what a key does in Emacs. * Name Help:: Asking about a command, variable or function name. * Apropos:: Asking what pertains to a given topic. +* Help Mode:: Special features of Help mode and Help buffers. * Library Keywords:: Finding Lisp libraries by keywords (topics). * Language Help:: Help relating to international language support. -* Help Mode:: Special features of Help mode and Help buffers. * Misc Help:: Other help commands. * Help Files:: Commands to display pre-written help files. * Help Echo:: Help on active text and tooltips (`balloon help') diff --git a/man/entering.texi b/man/entering.texi index bef6a5a4db0..dca85d44812 100644 --- a/man/entering.texi +++ b/man/entering.texi @@ -69,20 +69,19 @@ already running Emacs. @xref{Emacs Server}. @cindex leaving Emacs @cindex quitting Emacs - There are two commands for exiting Emacs, and three kinds of exiting: -@dfn{suspending} Emacs, @dfn{Iconifying} Emacs, and @dfn{killing} -Emacs. + There are two commands for exiting Emacs, and three kinds of +exiting: @dfn{iconifying} Emacs, @dfn{suspending} Emacs, and +@dfn{killing} Emacs. - @dfn{Suspending} means stopping Emacs temporarily and returning -control to its parent process (usually a shell), allowing you to resume -editing later in the same Emacs job, with the same buffers, same kill -ring, same undo history, and so on. This is the usual way to exit Emacs -when running on a text terminal. + @dfn{Iconifying} means replacing the Emacs frame with a small box or +``icon'' on the screen. This is the usual way to exit Emacs when +you're using a graphical display---if you bother to ``exit'' at all. +(Just switching to another application is usually sufficient.) - @dfn{Iconifying} means replacing the Emacs frame with a small box -somewhere on the screen. This is the usual way to exit Emacs when you're -using a graphics terminal---if you bother to ``exit'' at all. (Just switching -to another application is usually sufficient.) + @dfn{Suspending} means stopping Emacs temporarily and returning +control to its parent process (usually a shell), allowing you to +resume editing later in the same Emacs job. This is the usual way to +exit Emacs when running it on a text terminal. @dfn{Killing} Emacs means destroying the Emacs job. You can run Emacs again later, but you will get a fresh Emacs; there is no way to resume @@ -97,12 +96,18 @@ Kill Emacs (@code{save-buffers-kill-emacs}). @end table @kindex C-z -@findex suspend-emacs - To suspend or iconify Emacs, type @kbd{C-z} (@code{suspend-emacs}). -On text terminals, this suspends Emacs. On graphical displays, -it iconifies the Emacs frame. +@findex iconify-or-deiconify-frame + On graphical displays, @kbd{C-z} runs the command +@code{iconify-or-deiconify-frame}, which temporarily iconifies (or +``minimizes'') the selected Emacs frame (@pxref{Frames}). You can +then use the window manager to select some other application. (You +could select another application without iconifying Emacs first, but +getting the Emacs frame out of the way can make it more convenient to +find the other application.) - Suspending Emacs takes you back to the shell from which you invoked +@findex suspend-emacs + On a text terminal, @kbd{C-z} runs the command @code{suspend-emacs}. +Suspending Emacs takes you back to the shell from which you invoked Emacs. You can resume Emacs with the shell command @command{%emacs} in most common shells. On systems that don't support suspending programs, @kbd{C-z} starts an inferior shell that communicates @@ -112,19 +117,12 @@ subshell. (The way to do that is probably with @kbd{C-d} or systems, you can only get back to the shell from which Emacs was run (to log out, for example) when you kill Emacs. +@vindex cannot-suspend Suspending can fail if you run Emacs under a shell that doesn't -support suspending programs, even if the system itself does support -it. In such a case, you can set the variable @code{cannot-suspend} to -a non-@code{nil} value to force @kbd{C-z} to start an inferior shell. -(One might also describe Emacs's parent shell as ``inferior'' for -failing to support job control properly, but that is a matter of -taste.) - - On graphical displays, @kbd{C-z} has a different meaning: it runs -the command @code{iconify-or-deiconify-frame}, which temporarily -iconifies (or ``minimizes'') the selected Emacs frame -(@pxref{Frames}). Then you can use the window manager to get back to -a shell window. +support suspendion of its subjobs, even if the system itself does +support it. In such a case, you can set the variable +@code{cannot-suspend} to a non-@code{nil} value to force @kbd{C-z} to +start an inferior shell. @kindex C-x C-c @findex save-buffers-kill-emacs diff --git a/man/erc.texi b/man/erc.texi index 29b0f059722..c4317f11511 100644 --- a/man/erc.texi +++ b/man/erc.texi @@ -12,7 +12,7 @@ @syncodeindex fn cp @copying -This manual is for ERC version 5.1.3. +This manual is for ERC version 5.1.4. Copyright @copyright{} 2005, 2006 Free Software Foundation, Inc. diff --git a/man/faq.texi b/man/faq.texi index 7890c13a4d8..54be5f38a65 100644 --- a/man/faq.texi +++ b/man/faq.texi @@ -1146,16 +1146,28 @@ and on @code{xterm} with @kbd{emacs -nw}. @cindex Emacs 22, new features in @cindex Recently introduced features -@c FIXME: Improve this node before the 22.1 release. @cindex Default features -Font-lock mode, auto-compression mode, and file name shadow mode are now -enabled by default. It is now possible to follow links with -@kbd{mouse-1}. - -@cindex Supported systems -Emacs 22 features support for GNU/Linux systems on S390 and X86-64 -machines, as well as support for the Mac OS X and Cygwin operating -systems. +Font Lock mode, auto-compression mode, and file name shadow mode are now +enabled by default. On graphics displays it is now possible to follow +links with @kbd{mouse-1}, and the modeline of the selected window is now +highlighted. Window fringes are now customizable. The minibuffer +prompt is now displayed in a distinct face. + +Emacs now reads abbrev definitions automatically at startup. The +maximum size of buffers has been doubled and is now 256M on 32-bit +machines. Grep mode is now separate from Compilation mode and has many +new specific options and commands. + +The original Emacs macro system has been replaced by the new Kmacro +package, which provides many new commands and features and a simple +interface that uses the function keys F3 and F4. Macros are now stored +in a macro ring, and can be debugged and edited interactively. + +The GUD (Grand Unified Debugger) package can now be used with a full +graphical user interface to the debugger which provides many features +found in traditional development environments, making it easy to +manipulate breakpoints, add watch points, display the call stack, etc. +Breakpoints are now displayed in the source buffer. @cindex GTK+ Toolkit @cindex Drag-and-drop @@ -1164,15 +1176,39 @@ Emacs can now be built with GTK+ widgets, and supports drag-and-drop operation on X. Mouse wheel support is now enabled by default. @cindex New modes -Many new modes and packages have been included in Emacs, such as Leim, -Calc, Tramp and URL, as well as IDO, CUA, rcirc, ERC, conf-mode, -python-mode, table, tumme, SES, ruler, Flymake, Org, PGG, etc. +Many new modes and packages have been included in Emacs, such as Calc, +Tramp and URL, as well as IDO, CUA, rcirc, ERC, conf-mode, python-mode, +table, tumme, SES, ruler, Flymake, Org, PGG, wdired, t-mouse, longlines, +dns-mode, savehist, Password, Printing, Reveal, etc. + +@cindex Multilingual Environment +Leim is now part of Emacs. Unicode support has been much improved, and +the following input methods have been added: belarusian, bulgarian-bds, +bulgarian-phonetic, chinese-sisheng, croatian, dutch, georgian, +latin-alt-postfix, latin-postfix, latin-prefix, latvian-keyboard, +lithuanian-numeric, lithuanian-keyboard, malayalam-inscript, rfc1345, +russian-computer, sgml, slovenian, tamil-inscript ucs, +ukrainian-computer, vietnamese-telex, and welsh. + +The following language environment have also been added: Belarusian, +Bulgarian, Chinese-EUC-TW, Croatian, French, Georgian, Italian, Latin-6, +Latin-7, Latvian, Lithuanian, Malayalam, Russian, Russian, Slovenian, +Swedish, Tajik, Tamil, UTF-8, Ukrainian, Ukrainian, Welsh, and +Windows-1255. + +@cindex Supported systems +Emacs 22 features support for GNU/Linux systems on S390 and x86-64 +machines, as well as support for the Mac OS X and Cygwin operating +systems. @cindex Documentation @cindex Emacs Lisp Manual In addition, Emacs 22 now includes the Emacs Lisp Reference Manual (@pxref{Emacs Lisp documentation}) and the Emacs Lisp Intro. +Many other changes have been made in Emacs 22, use @kbd{C-h n} to get a +full list. + @c ------------------------------------------------------------ @node Common requests, Bugs and problems, Status of Emacs, Top @chapter Common requests @@ -4837,6 +4873,7 @@ You can get the old behavior by binding @kbd{SPC} to * Inputting eight-bit characters:: * Kanji and Chinese characters:: * Right-to-left alphabets:: +* How to add fonts:: @end menu @node Emacs does not display 8-bit characters, Inputting eight-bit characters, Alternate character sets, Alternate character sets @@ -4876,7 +4913,7 @@ Emacs 20 and later includes many of the features of MULE, the MULtilingual Enhancement to Emacs. @xref{Installing Emacs}, for information on where to find and download the latest version of Emacs. -@node Right-to-left alphabets, , Kanji and Chinese characters, Alternate character sets +@node Right-to-left alphabets, How to add fonts, Kanji and Chinese characters, Alternate character sets @section Where is an Emacs that can handle Semitic (right-to-left) alphabets? @cindex Right-to-left alphabets @cindex Hebrew, handling with Emacs @@ -4896,8 +4933,128 @@ Emacs 18. Write to Joel if you want the patches or package. @file{hebrew.el} requires a Hebrew screen font, but no other hardware support. Joel has a screen font for PCs running MS-DOS or GNU/Linux. -You might also try to query archie for files named with @file{hebrew}; -several ftp sites in Israel may also have the necessary files. +You might also try querying @code{archie} for files named with +@file{hebrew}; several ftp sites in Israel may also have the necessary +files. + +@node How to add fonts, , Right-to-left alphabets, Alternate character sets +@section How do I add fonts for use with Emacs? +@cindex add fonts for use with Emacs +@cindex intlfonts + +First, download and install the BDF font files and any auxiliary +packages they need. The GNU Intlfonts distribution can be found on +@uref{http://directory.fsf.org/localization/intlfonts.html, the GNU +Software Directory Web site}. + +Next, if you are on X Window system, issue the following two commands +from the shell's prompt: + +@example + xset +fp /usr/local/share/emacs/fonts + xset fp rehash +@end example + +@noindent +(Modify the first command if you installed the fonts in a directory +that is not @file{/usr/local/share/emacs/fonts}.) You also need to +arrange for these two commands to run whenever you log in, e.g., by +adding them to your window-system startup file, such as +@file{~/.xsessionrc} or @file{~/.gnomerc}. + +Now, add the following line to your @file{~/.emacs} init file: + +@lisp + (add-to-list 'bdf-directory-list "/usr/share/emacs/fonts/bdf") +@end lisp + +@noindent +(Again, modify the file name if you installed the fonts elsewhere.) + +Finally, if you wish to use the installed fonts with @code{ps-print}, +add the following line to your @file{~/.emacs}: + +@lisp + (setq ps-multibyte-buffer 'bdf-font-except-latin) +@end lisp + +A few additional steps are necessary for MS-Windows; they are listed +below. + +First, make sure @emph{all} the directories with BDF font files are +mentioned in @code{bdf-directory-list}. On Unix and GNU/Linux +systems, one normally runs @kbd{make install} to install the BDF fonts +in the same directory. By contrast, Windows users typically don't run +the Intlfonts installation command, but unpack the distribution in +some directory, which leaves the BDF fonts in its subdirectories. For +example, assume that you unpacked Intlfonts in @file{C:/Intlfonts}; +then you should set @code{bdf-directory-list} as follows: + +@lisp + (setq bdf-directory-list + '("C:/Intlfonts/Asian" + "C:/Intlfonts/Chinese" "C:/Intlfonts/Chinese.X" + "C:/Intlfonts/Chinese.BIG" "C:/Intlfonts/Ethiopic" + "C:/Intlfonts/European" "C:/Intlfonts/European.BIG" + "C:/Intlfonts/Japanese" "C:/Intlfonts/Japanese.X" + "C:/Intlfonts/Japanese.BIG" "C:/Intlfonts/Korean.X" + "C:/Intlfonts/Misc")) +@end lisp + +@cindex @code{w32-bdf-filename-alist} +@cindex @code{w32-find-bdf-fonts} +Next, you need to set up the variable @code{w32-bdf-filename-alist} to +an alist of the BDF fonts and their corresponding file names. +Assuming you have set @code{bdf-directory-list} to name all the +directories with the BDF font files, the following Lisp snippet will +set up @code{w32-bdf-filename-alist}: + +@lisp + (setq w32-bdf-filename-alist + (w32-find-bdf-fonts bdf-directory-list)) +@end lisp + +Now, create fontsets for the BDF fonts: + +@lisp + (create-fontset-from-fontset-spec + "-*-fixed-medium-r-normal-*-16-*-*-*-c-*-fontset-bdf, + japanese-jisx0208:-*-*-medium-r-normal-*-16-*-*-*-c-*-jisx0208.1983-*, + katakana-jisx0201:-*-*-medium-r-normal-*-16-*-*-*-c-*-jisx0201*-*, + latin-jisx0201:-*-*-medium-r-normal-*-16-*-*-*-c-*-jisx0201*-*, + japanese-jisx0208-1978:-*-*-medium-r-normal-*-16-*-*-*-c-*-jisx0208.1978-*, + thai-tis620:-misc-fixed-medium-r-normal--16-160-72-72-m-80-tis620.2529-1, + lao:-misc-fixed-medium-r-normal--16-160-72-72-m-80-MuleLao-1, + tibetan-1-column:-TibMdXA-fixed-medium-r-normal--16-160-72-72-m-80-MuleTibetan-1, + ethiopic:-Admas-Ethiomx16f-Medium-R-Normal--16-150-100-100-M-160-Ethiopic-Unicode, + tibetan:-TibMdXA-fixed-medium-r-normal--16-160-72-72-m-160-MuleTibetan-0") +@end lisp + +Many of the international bdf fonts from Intlfonts are type 0, and +therefore need to be added to font-encoding-alist: + +@lisp + (setq font-encoding-alist + (append '(("MuleTibetan-0" (tibetan . 0)) + ("GB2312" (chinese-gb2312 . 0)) + ("JISX0208" (japanese-jisx0208 . 0)) + ("JISX0212" (japanese-jisx0212 . 0)) + ("VISCII" (vietnamese-viscii-lower . 0)) + ("KSC5601" (korean-ksc5601 . 0)) + ("MuleArabic-0" (arabic-digit . 0)) + ("MuleArabic-1" (arabic-1-column . 0)) + ("MuleArabic-2" (arabic-2-column . 0))) + font-encoding-alist)) +@end lisp + +You can now use the Emacs font menu to select the @samp{bdf: 16-dot medium} +fontset, or you can select it by setting the default font in your +@file{~/.emacs}: + +@lisp + (set-default-font "fontset-bdf") +@end lisp + @c ------------------------------------------------------------ @node Mail and news, Concept index, Alternate character sets, Top diff --git a/man/gnus.texi b/man/gnus.texi index 9092999dfc9..6e350bc4517 100644 --- a/man/gnus.texi +++ b/man/gnus.texi @@ -9372,11 +9372,15 @@ default is @code{nil}. @item gnus-article-emulate-mime @vindex gnus-article-emulate-mime +@cindex uuencode +@cindex yEnc There are other, non-@acronym{MIME} encoding methods used. The most common is @samp{uuencode}, but yEncode is also getting to be popular. If this variable is non-@code{nil}, Gnus will look in message bodies to see if it finds these encodings, and if so, it'll run them through the -Gnus @acronym{MIME} machinery. The default is @code{t}. +Gnus @acronym{MIME} machinery. The default is @code{t}. Only +single-part yEnc encoded attachments can be decoded. There's no support +for encoding in Gnus. @item gnus-unbuttonized-mime-types @vindex gnus-unbuttonized-mime-types @@ -26075,6 +26079,14 @@ later entry for more information about marks. Note that downgrading isn't save in general. @item +Lisp files are now installed in @file{.../site-lisp/gnus/} by default. +It defaulted to @file{.../site-lisp/} formerly. In addition to this, +the new installer issues a warning if other Gnus installations which +will shadow the latest one are detected. You can then remove those +shadows manually or remove them using @code{make +remove-installed-shadows}. + +@item New @file{make.bat} for compiling and installing Gnus under MS Windows Use @file{make.bat} if you want to install Gnus under MS Windows, the diff --git a/man/help.texi b/man/help.texi index 47600b711fa..08f528f5151 100644 --- a/man/help.texi +++ b/man/help.texi @@ -74,9 +74,9 @@ This displays the available Emacs packages based on keywords. * Key Help:: Asking what a key does in Emacs. * Name Help:: Asking about a command, variable or function name. * Apropos:: Asking what pertains to a given topic. +* Help Mode:: Special features of Help mode and Help buffers. * Library Keywords:: Finding Lisp libraries by keywords (topics). * Language Help:: Help relating to international language support. -* Help Mode:: Special features of Help mode and Help buffers. * Misc Help:: Other help commands. * Help Files:: Commands to display pre-written help files. * Help Echo:: Help on active text and tooltips (`balloon help') @@ -251,6 +251,8 @@ name is defined as a Lisp function. Type @kbd{C-g} to cancel the @kbd{C-h f} command if you don't really want to view the documentation. +@kindex C-h v +@findex describe-variable @kbd{C-h v} (@code{describe-variable}) is like @kbd{C-h f} but describes Lisp variables instead of Lisp functions. Its default is the Lisp symbol around or before point, if that is the name of a @@ -388,6 +390,62 @@ display the most relevant ones first. the variable @code{apropos-documentation-sort-by-scores} is @code{nil}, apropos lists the symbols found in alphabetical order. +@node Help Mode +@section Help Mode Commands + + Help buffers provide the same commands as View mode (@pxref{Misc File +Ops}), plus a few special commands of their own. + +@table @kbd +@item @key{SPC} +Scroll forward. +@item @key{DEL} +Scroll backward. +@item @key{RET} +Follow a cross reference at point. +@item @key{TAB} +Move point forward to the next cross reference. +@item S-@key{TAB} +Move point back to the previous cross reference. +@item Mouse-1 +@itemx Mouse-2 +Follow a cross reference that you click on. +@item C-c C-c +Show all documentation about the symbol at point. +@end table + + When a function name (@pxref{M-x,, Running Commands by Name}), +variable name (@pxref{Variables}), or face name (@pxref{Faces}) +appears in the documentation, it normally appears inside paired +single-quotes. To view the documentation of that command, variable or +face, you can click on the name with @kbd{Mouse-1} or @kbd{Mouse-2}, +or move point there and type @key{RET}. Use @kbd{C-c C-b} to retrace +your steps. + +@cindex URL, viewing in help +@cindex help, viewing web pages +@cindex viewing web pages in help +@cindex web pages, viewing in help +@findex browse-url + You can follow cross references to URLs (web pages) also. This uses +the @code{browse-url} command to view the page in the browser you +choose. @xref{Browse-URL}. + +@kindex @key{TAB} @r{(Help mode)} +@findex help-next-ref +@kindex S-@key{TAB} @r{(Help mode)} +@findex help-previous-ref + There are convenient commands to move point to cross references in +the help text. @key{TAB} (@code{help-next-ref}) moves point down to +the next cross reference. @kbd{S-@key{TAB}} moves up to the previous +cross reference (@code{help-previous-ref}). + + To view all documentation about any symbol name that appears in the +text, move point to the symbol name and type @kbd{C-c C-c} +(@code{help-follow-symbol}). This shows all available documentation +about the symbol as a variable, function and/or face. As above, use +@kbd{C-c C-b} to retrace your steps. + @node Library Keywords @section Keyword Search for Lisp Libraries @@ -458,62 +516,6 @@ input method currently in use. @xref{Input Methods}. coding systems---either a specified coding system, or the ones currently in use. @xref{Coding Systems}. -@node Help Mode -@section Help Mode Commands - - Help buffers provide the same commands as View mode (@pxref{Misc File -Ops}), plus a few special commands of their own. - -@table @kbd -@item @key{SPC} -Scroll forward. -@item @key{DEL} -Scroll backward. -@item @key{RET} -Follow a cross reference at point. -@item @key{TAB} -Move point forward to the next cross reference. -@item S-@key{TAB} -Move point back to the previous cross reference. -@item Mouse-1 -@itemx Mouse-2 -Follow a cross reference that you click on. -@item C-c C-c -Show all documentation about the symbol at point. -@end table - - When a function name (@pxref{M-x,, Running Commands by Name}), -variable name (@pxref{Variables}), or face name (@pxref{Faces}) -appears in the documentation, it normally appears inside paired -single-quotes. To view the documentation of that command, variable or -face, you can click on the name with @kbd{Mouse-1} or @kbd{Mouse-2}, -or move point there and type @key{RET}. Use @kbd{C-c C-b} to retrace -your steps. - -@cindex URL, viewing in help -@cindex help, viewing web pages -@cindex viewing web pages in help -@cindex web pages, viewing in help -@findex browse-url - You can follow cross references to URLs (web pages) also. This uses -the @code{browse-url} command to view the page in the browser you -choose. @xref{Browse-URL}. - -@kindex @key{TAB} @r{(Help mode)} -@findex help-next-ref -@kindex S-@key{TAB} @r{(Help mode)} -@findex help-previous-ref - There are convenient commands to move point to cross references in -the help text. @key{TAB} (@code{help-next-ref}) moves point down to -the next cross reference. @kbd{S-@key{TAB}} moves up to the previous -cross reference (@code{help-previous-ref}). - - To view all documentation about any symbol name that appears in the -text, move point to the symbol name and type @kbd{C-c C-c} -(@code{help-follow-symbol}). This shows all available documentation -about the symbol as a variable, function and/or face. As above, use -@kbd{C-c C-b} to retrace your steps. - @node Misc Help @section Other Help Commands diff --git a/man/mark.texi b/man/mark.texi index cf7b87366e8..2736dccd297 100644 --- a/man/mark.texi +++ b/man/mark.texi @@ -139,21 +139,23 @@ have a text terminal where typing @kbd{C-@key{SPC}} does not produce On a terminal that supports colors, Emacs has the ability to highlight the current region. But normally it does not. Why not? - Once you have set the mark in a buffer, there is @emph{always} a -region in that buffer. This is because every command that sets the -mark also activates it, and nothing ever deactivates it. Highlighting -the region all the time would be a nuisance. So normally Emacs -highlights the region only immediately after you have selected one -with the mouse. + In the normal mode of use, every command that sets the mark also +activates it, and nothing ever deactivates it. Thus, once you have +set the mark in a buffer, there is @emph{always} a region in that +buffer. Highlighting the region all the time would be a nuisance. So +normally Emacs highlights the region only immediately after you have +selected one with the mouse. If you want region highlighting, you can use Transient Mark mode. -This is a more rigid mode of operation in which the region always -``lasts'' only until you use it; you explicitly must set up a region -for each command that uses one. In Transient Mark mode, most of the -time there is no region; therefore, highlighting the region when it -exists is useful and not annoying. When Transient Mark mode is -enabled, Emacs always highlights the region whenever there is a -region. +This is a more rigid mode of operation in which the region ``lasts'' +only until you use it; operating on the region text deactivates the +mark, so there is no region any more. Therefore, you must explicitly +set up a region for each command that uses one. + + When Transient Mark mode is enabled, Emacs highlights the region, +whenever there is a region. In Transient Mark mode, most of the time +there is no region; therefore, highlighting the region when it exists +is useful and not annoying. @findex transient-mark-mode To enable Transient Mark mode, type @kbd{M-x transient-mark-mode}. @@ -367,7 +369,7 @@ negative) instead of the current page. Finally, @kbd{C-x h} (@code{mark-whole-buffer}) sets up the entire buffer as the region, by putting point at the beginning and the mark at -the end. +the end. (In some programs this is called ``select all.'') In Transient Mark mode, all of these commands activate the mark. diff --git a/man/misc.texi b/man/misc.texi index 6f6d448bc7d..f6fb5edfbdb 100644 --- a/man/misc.texi +++ b/man/misc.texi @@ -1998,8 +1998,9 @@ subsequent Emacs sessions reload the saved desktop. @findex desktop-save @vindex desktop-save-mode You can save the desktop manually with the command @kbd{M-x -desktop-save}. You can also enable automatic desktop saving when -you exit Emacs: use the Customization buffer (@pxref{Easy +desktop-save}. You can also enable automatic saving of the desktop +when you exit Emacs, and automatic restoration of the last saved +desktop when Emacs starts: use the Customization buffer (@pxref{Easy Customization}) to set @code{desktop-save-mode} to @code{t} for future sessions, or add this line in your @file{~/.emacs} file: @@ -2009,7 +2010,8 @@ sessions, or add this line in your @file{~/.emacs} file: @findex desktop-change-dir @findex desktop-revert - When Emacs starts, it looks for a saved desktop in the current + If you turn on @code{desktop-save-mode} in your @file{~/.emacs}, +then when Emacs starts, it looks for a saved desktop in the current directory. Thus, you can have separate saved desktops in different directories, and the starting directory determines which one Emacs reloads. You can save the current desktop and reload one saved in @@ -2018,7 +2020,10 @@ another directory by typing @kbd{M-x desktop-change-dir}. Typing Specify the option @samp{--no-desktop} on the command line when you don't want it to reload any saved desktop. This turns off -@code{desktop-save-mode} for the current session. +@code{desktop-save-mode} for the current session. Starting Emacs with +the @samp{--no-init-file} option also disables desktop reloading, +since it bypasses the @file{.emacs} init file, where +@code{desktop-save-mode} is usually turned on. @vindex desktop-restore-eager By default, all the buffers in the desktop are restored at one go. diff --git a/man/mule.texi b/man/mule.texi index a49478dfe02..9437e30f485 100644 --- a/man/mule.texi +++ b/man/mule.texi @@ -785,7 +785,7 @@ file. The variable @code{file-coding-system-alist} specifies this correspondence. There is a special function @code{modify-coding-system-alist} for adding elements to this list. For example, to read and write all @samp{.txt} files using the coding system -@code{china-iso-8bit}, you can execute this Lisp expression: +@code{chinese-iso-8bit}, you can execute this Lisp expression: @smallexample (modify-coding-system-alist 'file "\\.txt\\'" 'chinese-iso-8bit) @@ -1003,7 +1003,7 @@ of with @kbd{C-x @key{RET} f}, there is no warning if the buffer contains characters that the coding system cannot handle. Other file commands affected by a specified coding system include -@kbd{C-x C-i} and @kbd{C-x C-v}, as well as the other-window variants +@kbd{C-x i} and @kbd{C-x C-v}, as well as the other-window variants of @kbd{C-x C-f}. @kbd{C-x @key{RET} c} also affects commands that start subprocesses, including @kbd{M-x shell} (@pxref{Shell}). If the immediately following command does not use the coding system, then diff --git a/man/org.texi b/man/org.texi index 3e327279726..7897ba32867 100644 --- a/man/org.texi +++ b/man/org.texi @@ -3,8 +3,8 @@ @setfilename ../info/org @settitle Org Mode Manual -@set VERSION 4.43 -@set DATE July 2006 +@set VERSION 4.44 +@set DATE August 2006 @dircategory Emacs @direntry @@ -98,7 +98,8 @@ Software Foundation raise funds for GNU development.'' Introduction * Summary:: Brief summary of what Org-mode does -* Installation:: How to install Org-mode +* Installation:: How to install a downloaded version of Org-mode +* Activation:: How to activate Org-mode for certain buffers. * Feedback:: Bug reports, ideas, patches etc. Document Structure @@ -270,7 +271,8 @@ Extensions, Hooks and Hacking @menu * Summary:: Brief summary of what Org-mode does -* Installation:: How to install Org-mode +* Installation:: How to install a downloaded version of Org-mode +* Activation:: How to activate Org-mode for certain buffers. * Feedback:: Bug reports, ideas, patches etc. @end menu @@ -323,18 +325,68 @@ questions (FAQ), links to tutorials etc. This page is located at @page -@node Installation, Feedback, Summary, Introduction -@section Installation and Activation +@node Installation, Activation, Summary, Introduction +@section Installation @cindex installation +@cindex XEmacs + +@b{Important:} If Org-mode is part of the Emacs distribution or an +XEmacs package, please skip this section and go directly to +@ref{Activation}. + +If you have downloaded Org-mode from the Web, you must take the +following steps to install it: Go into the Org-mode distribution +directory and edit the top section of the file @file{Makefile}. You +must set the name of the Emacs binary (likely either @file{emacs} or +@file{xemacs}), and the paths to the directories where local Lisp and +Info files are kept. If you don't have access to the system-wide +directories, create your own two directories for these files, enter them +into the Makefile, and make sure Emacs finds the Lisp files by adding +the following line to @file{.emacs}: + +@example +(setq load-path (cons "~/path/to/lispdir" load-path)) +@end example + +@b{XEmacs users now need to install the file @file{noutline.el} from +the @file{xemacs} subdirectory of the Org-mode distribution. Use the +command:} + +@example +@b{make install-noutline} +@end example + +@noindent Now byte-compile and install the Lisp files with the shell +commands: + +@example +make +make install +@end example + +@noindent If you want to install the info documentation, use this command: + +@example +make install-info +@end example + +@noindent Then add to @file{.emacs}: + +@lisp +;; This line only if org-mode is not part of the X/Emacs distribution. +(require 'org-install) +@end lisp + +@node Activation, Feedback, Installation, Introduction +@section Activation +@cindex activation @cindex autoload @cindex global keybindings @cindex keybindings, global -If Org-mode is part of the Emacs distribution or an XEmacs package, -you only need to copy the following lines to your @file{.emacs} file. -The last two lines define @emph{global} keys for the commands -@command{org-store-link} and @command{org-agenda} - please -choose suitable keys yourself. +Add the following lines to your @file{.emacs} file. The last two lines +define @emph{global} keys for the commands @command{org-store-link} and +@command{org-agenda} - please choose suitable keys yourself. @lisp ;; The following lines are always needed. Choose your own keys. @@ -345,30 +397,17 @@ choose suitable keys yourself. Furthermore, you must activate @code{font-lock-mode} in org-mode buffers, because significant functionality depends on font-locking being -active. You can do this with either one of the following two lines: +active. You can do this with either one of the following two lines +(XEmacs user must use the second option): @lisp (global-font-lock-mode 1) ; for all buffers (add-hook 'org-mode-hook 'turn-on-font-lock) ; org-mode buffers only @end lisp -If you have downloaded Org-mode from the Web, you must take additional -action: Byte-compile @file{org.el} and @file{org-publish.el} and put -them together with @file{org-install.el} on your load path. Then add to -@file{.emacs}: - -@lisp -;; This line only if org-mode is not part of the X/Emacs distribution. -(require 'org-install) -@end lisp - -If you use Org-mode with XEmacs, you also need to install the file -@file{noutline.el} from the @file{xemacs} subdirectory of the Org-mode -distribution. - @cindex org-mode, turning on -With this setup, all files with extension @samp{.org} will be put into -Org-mode. As an alternative, make the first line of a file look like -this: +With this setup, all files with extension @samp{.org} will be put +into Org-mode. As an alternative, make the first line of a file look +like this: @example MY PROJECTS -*- mode: org; -*- @@ -378,7 +417,7 @@ MY PROJECTS -*- mode: org; -*- the file's name is. See also the variable @code{org-insert-mode-line-in-empty-file}. -@node Feedback, , Installation, Introduction +@node Feedback, , Activation, Introduction @section Feedback @cindex feedback @cindex bug reports @@ -826,8 +865,14 @@ But in the end, not individual scenes matter but the film as a whole. @end group @end example -Org-mode supports these lists by tuning filling and wrapping commands -to deal with them correctly. +Org-mode supports these lists by tuning filling and wrapping commands to +deal with them correctly@footnote{Org-mode only changes the filling +settings for Emacs. For XEmacs, you should use Kyle E. Jones' +@file{filladapt.el}. To turn is on, put into @file{.emacs}: +@example +(require 'filladapt) +@end example +}. The following commands act on items when the cursor is in the first line of an item (the line with the bullet or number). @@ -2160,7 +2205,7 @@ If you define many keywords, you can use in-buffer completion (see The second possibility is to use TODO keywords to indicate different types of action items. For example, you might want to indicate that -items are for ``work'' or ``home.'' If you are into David Allen's +items are for ``work'' or ``home''. If you are into David Allen's @emph{Getting Things DONE}, you might want to use todo types @samp{NEXTACTION}, @samp{WAITING}, @samp{MAYBE}. Or, when you work with several people on a single project, you might want to assign @@ -2547,7 +2592,12 @@ keyword together with a timestamp. Stop the clock (clock-out). The inserts another timestamp at the same location where the clock was last started. It also directly computes the resulting time in inserts it after the time range as @samp{=> -HH:MM}. +HH:MM}. +@kindex C-c C-y +@item C-c C-y +Recompute the time interval after changing one of the time stamps. This +is only necessary if you edit the time stamps directly. If you change +them with @kbd{S-@key{cursor}} keys, the update is automatic. @kindex C-c C-t @item C-c C-t Changing the TODO state of an item to DONE automatically stops the clock @@ -2565,8 +2615,8 @@ can use visibility cycling to study the tree, but the overlays disappear automatically when the buffer is changed. @kindex C-c C-x C-r @item C-c C-x C-r -Insert a dynamic block containing a clock report as an org-mode table -into the current file. +Insert a dynamic block (@pxref{Dynamic blocks}) containing a clock +report as an org-mode table into the current file. @example #+BEGIN: clocktable :maxlevel 2 :emphasize nil @@ -2578,7 +2628,32 @@ table. The @samp{BEGIN} line can specify options: @example :maxlevels @r{Maximum level depth to which times are listed in the table.} :emphasize @r{When @code{t}, emphasize level one and level two items} +:block @r{The time block to consider. This block is specified relative} + @r{to the current time and may be any of these keywords:} + @r{@code{today}, @code{yesterday}, @code{thisweek}, @code{lastweek},} + @r{@code{thismonth}, @code{lastmonth}, @code{thisyear}, or @code{lastyear}}. +:tstart @r{A time string specifying when to start considering times} +:tend @r{A time string specifying when to stop considering times} +@end example +So to get a clock summary for the current day, you could write +@example +#+BEGIN: clocktable :maxlevel 2 :block today + +#+END: clocktable @end example +and to use a specific time range you could write@footnote{Note that all +parameters must be specified in a single line - the line is broken here +only to fit it onto the manual.} +@example +#+BEGIN: clocktable :tstart "<2006-08-10 Thu 10:00>" + :tend "<2006-08-10 Thu 12:00>" + +#+END: clocktable +@end example +@kindex C-u C-c C-x C-u +@item C-u C-c C-x C-u +Update all dynamic blocks (@pxref{Dynamic blocks}). This is useful if +you have several clocktable blocks in a buffer. @end table The @kbd{l} key may be used in the timeline (@pxref{Timeline}) and in @@ -4653,8 +4728,7 @@ setup. See the installation instructions in the file @item @file{cdlatex.el} by Carsten Dominik @cindex @file{cdlatex.el} Org-mode can make use of the cdlatex package to efficiently enter -La@TeX{} fragments into Org-mode files. -@file{cdlatex.el} is not part of Emacs, find it on the web. +La@TeX{} fragments into Org-mode files. See @ref{CDLaTeX mode}. @item @file{remember.el} by John Wiegley @cindex @file{remember.el} Org mode cooperates with remember, see @ref{Remember}. @@ -4784,7 +4858,7 @@ caused by the preparations for the 22.1 release. In the mean time, @url{http://dto.freeshell.org/e/org-publish.el}. @cindex @file{org-blog.el} @item @file{org-blog.el} by David O'Toole -A blogging plug-in for @file{org-publish.el}. +A blogging plug-in for @file{org-publish.el}.@* @url{http://dto.freeshell.org/notebook/OrgMode.html}. @cindex @file{org-blogging.el} @item @file{org-blogging.el} by Bastien Guerry @@ -4805,7 +4879,7 @@ to the block and can also specify parameters for the function producing the content of the block. @example -#+BEGIN: myblock :parameter1 value1 :parameter2 value2 ..... +#+BEGIN: myblock :parameter1 value1 :parameter2 value2 ... #+END: @end example diff --git a/man/rcirc.texi b/man/rcirc.texi index fb24a681b7f..606e6beea06 100644 --- a/man/rcirc.texi +++ b/man/rcirc.texi @@ -501,7 +501,7 @@ by the arguments this method requires. Here is an example to illustrate how you would set it: @example -(setq rcirc-startup-channels-alist +(setq rcirc-authinfo '(("freenode" nickserv "bob" "p455w0rd") ("freenode" chanserv "bob" "#bobland" "passwd99") ("bitlbee" bitlbee "robert" "sekrit"))) diff --git a/man/search.texi b/man/search.texi index 282b36e3a50..ac11e58b268 100644 --- a/man/search.texi +++ b/man/search.texi @@ -33,6 +33,8 @@ asks interactively which occurrences to replace. @node Incremental Search @section Incremental Search +@cindex incremental search +@cindex isearch An incremental search begins searching as soon as you type the first character of the search string. As you type in the search string, Emacs @@ -63,7 +65,6 @@ Incremental search backward (@code{isearch-backward}). @node Basic Isearch @subsection Basics of Incremental Search -@cindex incremental search @kindex C-s @findex isearch-forward @@ -1241,8 +1242,10 @@ line. used the minibuffer to read its arguments. @xref{Repetition, C-x ESC ESC}. - See also @ref{Transforming File Names}, for Dired commands to rename, -copy, or link files by replacing regexp matches in file names. + @xref{Operating on Files}, for the Dired @kbd{Q} command which +performs query replace on selected files. See also @ref{Transforming +File Names}, for Dired commands to rename, copy, or link files by +replacing regexp matches in file names. @node Other Repeating Search @section Other Search-and-Loop Commands diff --git a/man/texinfo.tex b/man/texinfo.tex index d41d40084b0..36c1acad97c 100644 --- a/man/texinfo.tex +++ b/man/texinfo.tex @@ -3,7 +3,7 @@ % Load plain if necessary, i.e., if running under initex. \expandafter\ifx\csname fmtname\endcsname\relax\input plain\fi % -\def\texinfoversion{2006-06-19.13} +\def\texinfoversion{2006-07-17.16} % % Copyright (C) 1985, 1986, 1988, 1990, 1991, 1992, 1993, 1994, 1995, % 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006 Free @@ -327,9 +327,9 @@ \pagebody{#1}% \ifdim\ht\footlinebox > 0pt % Only leave this space if the footline is nonempty. - % (We lessened \vsize for it in \oddfootingxxx.) + % (We lessened \vsize for it in \oddfootingyyy.) % The \baselineskip=24pt in plain's \makefootline has no effect. - \vskip 2\baselineskip + \vskip 24pt \unvbox\footlinebox \fi % @@ -2051,11 +2051,11 @@ where each line of input produces a line of output.} % and arrange explicitly to hyphenate at a dash. % -- rms. { - \catcode`\-=\active - \catcode`\_=\active + \catcode`\-=\active \catcode`\_=\active \catcode`\'=\active % \global\def\code{\begingroup - \catcode`\-=\active \catcode`\_=\active + \catcode`\-=\active \catcode`\_=\active \catcode`\'=\active + \let'\singlequotechar \ifallowcodebreaks \let-\codedash \let_\codeunder @@ -2472,8 +2472,8 @@ where each line of input produces a line of output.} % % Leave some space for the footline. Hopefully ok to assume % @evenfooting will not be used by itself. - \global\advance\pageheight by -\baselineskip - \global\advance\vsize by -\baselineskip + \global\advance\pageheight by -12pt + \global\advance\vsize by -12pt } \parseargdef\everyfooting{\oddfootingxxx{#1}\evenfootingxxx{#1}} @@ -5042,7 +5042,7 @@ where each line of input produces a line of output.} {\tentt \global\dimen0 = 3em}% Width of the box. \dimen2 = .55pt % Thickness of rules % The text. (`r' is open on the right, `e' somewhat less so on the left.) -\setbox0 = \hbox{\kern-.75pt \tensf error\kern-1.5pt} +\setbox0 = \hbox{\kern-.75pt \reducedsf error\kern-1.5pt} % \setbox\errorbox=\hbox to \dimen0{\hfil \hsize = \dimen0 \advance\hsize by -5.8pt % Space to left+right. @@ -5265,11 +5265,10 @@ where each line of input produces a line of output.} % \maketwodispenvs {lisp}{example}{% \nonfillstart - \tt + \tt\quoteexpand \let\kbdfont = \kbdexamplefont % Allow @kbd to do something special. \gobble % eat return } - % @display/@smalldisplay: same as @lisp except keep current font. % \makedispenv {display}{% @@ -5397,6 +5396,22 @@ where each line of input produces a line of output.} \newdimen\tabw \setbox0=\hbox{\tt\space} \tabw=8\wd0 % tab amount % \def\starttabbox{\setbox0=\hbox\bgroup} + +% Allow an option to not replace quotes with a regular directed right +% quote/apostrophe (char 0x27), but instead use the undirected quote +% from cmtt (char 0x0d). The undirected quote is ugly, so don't make it +% the default, but it works for pasting with more pdf viewers (at least +% evince), the lilypond developers report. xpdf does work with the +% regular 0x27. +% +\def\singlequotechar{% + \expandafter\ifx\csname SETcodequoteundirected\endcsname\relax + '% + \else + \char'15 + \fi +} +% \begingroup \catcode`\^^I=\active \gdef\tabexpand{% @@ -5409,7 +5424,13 @@ where each line of input produces a line of output.} \wd0=\dimen0 \box0 \starttabbox }% } + \catcode`\'=\active + \gdef\quoteexpand{% + \catcode`\'=\active + \def'{\singlequotechar} + }% \endgroup +% \def\setupverbatim{% \let\nonarrowing = t% \nonfillstart @@ -5418,6 +5439,7 @@ where each line of input produces a line of output.} \def\par{\leavevmode\egroup\box0\endgraf}% \catcode`\`=\active \tabexpand + \quoteexpand % Respect line breaks, % print special symbols as themselves, and % make each space count diff --git a/man/text.texi b/man/text.texi index 3a166174fda..b764a83d8db 100644 --- a/man/text.texi +++ b/man/text.texi @@ -2067,59 +2067,61 @@ Display a list of all the defined colors (@code{list-colors-display}). @subsection Faces in Formatted Text The Faces submenu lists various Emacs faces including @code{bold}, -@code{italic}, and @code{underline}. Selecting one of these adds the -chosen face to the region. @xref{Faces}. You can also specify a face -with these keyboard commands: +@code{italic}, and @code{underline} (@pxref{Faces}). These menu items +operate on the region if it is active and nonempty. Otherwise, they +specify to use that face for an immediately following self-inserting +character. Instead of the menu, you can use these keyboard commands: @table @kbd @kindex M-o d @r{(Enriched mode)} @findex facemenu-set-default @item M-o d -Set the region, or the next inserted character, to the @code{default} face -(@code{facemenu-set-default}). +Remove all @code{face} properties from the region (which includes +specified colors), or force the following inserted character to have no +@code{face} property (@code{facemenu-set-default}). @kindex M-o b @r{(Enriched mode)} @findex facemenu-set-bold @item M-o b -Set the region, or the next inserted character, to the @code{bold} face -(@code{facemenu-set-bold}). +Add the face @code{bold} to the region or to the following inserted +character (@code{facemenu-set-bold}). @kindex M-o i @r{(Enriched mode)} @findex facemenu-set-italic @item M-o i -Set the region, or the next inserted character, to the @code{italic} face -(@code{facemenu-set-italic}). +Add the face @code{italic} to the region or to the following inserted +character (@code{facemenu-set-italic}). @kindex M-o l @r{(Enriched mode)} @findex facemenu-set-bold-italic @item M-o l -Set the region, or the next inserted character, to the @code{bold-italic} face -(@code{facemenu-set-bold-italic}). +Add the face @code{bold-italic} to the region or to the following +inserted character (@code{facemenu-set-bold-italic}). @kindex M-o u @r{(Enriched mode)} @findex facemenu-set-underline @item M-o u -Set the region, or the next inserted character, to the @code{underline} face -(@code{facemenu-set-underline}). +Add the face @code{underline} to the region or to the following inserted +character (@code{facemenu-set-underline}). @kindex M-o o @r{(Enriched mode)} @findex facemenu-set-face @item M-o o @var{face} @key{RET} -Set the region, or the next inserted character, to the face @var{face} -(@code{facemenu-set-face}). +Add the face @var{face} to the region or to the following inserted +character (@code{facemenu-set-face}). @end table - If you use these commands with a prefix argument---or, in Transient Mark -mode, if the region is not active---then these commands specify a face -to use for any immediately following self-inserting input. -@xref{Transient Mark}. This applies to both the keyboard commands and -the menu commands. + With a prefix argument, all these commands apply to an immediately +following self-inserting character, disregarding the region. - Specifying the @code{default} face also resets foreground and -background color to their defaults.(@pxref{Format Colors}). + A self-inserting character normally inherits the @code{face} +property (and most other text properties) from the preceding character +in the buffer. If you use the above commands to specify face for the +next self-inserting character, or the next section's commands to +specify a foreground or background color for it, then it does not +inherit the @code{face} property from the preceding character; instead +it uses whatever you specified. It will still inherit other text +properties, though. - Any self-inserting character you type inherits, by default, the face -properties (as well as most other text properties) of the preceding -character. Specifying any face property, including foreground or -background color, for your next self-inserting character will prevent -it from inheriting any face properties from the preceding character, -although it will still inherit other text properties. Characters -inserted by yanking do not inherit text properties. + Strictly speaking, these commands apply only to the first following +self-inserting character that you type. But if you insert additional +characters after it, they will inherit from the first one. So it +appears that these commands apply to all of them. Enriched mode defines two additional faces: @code{excerpt} and @code{fixed}. These correspond to codes used in the text/enriched file @@ -2157,8 +2159,8 @@ colors that you have used in Enriched mode in the current Emacs session. If you specify a color with a prefix argument---or, in Transient Mark mode, if the region is not active---then it applies to any -immediately following self-inserting input. @xref{Transient Mark}. -Otherwise, the command applies to the region. +immediately following self-inserting input. Otherwise, the command +applies to the region. Each color menu contains one additional item: @samp{Other}. You can use this item to specify a color that is not listed in the menu; it reads |