# HG changeset patch # User Lute Kamstra # Date 1116426041 0 # Node ID 38477c70b31f87a1a27f06e2457b28ecb799b34d # Parent 0bdc2e9a381e7d323dadb97300de668802985f34 (Top): Update to the current structure of the manual. diff -r 0bdc2e9a381e -r 38477c70b31f man/emacs.texi --- a/man/emacs.texi Wed May 18 13:08:40 2005 +0000 +++ b/man/emacs.texi Wed May 18 14:20:41 2005 +0000 @@ -12,7 +12,7 @@ updated for Emacs version @value{EMACSVER}. Copyright (C) 1985, 1986, 1987, 1993, 1994, 1995, 1996, 1997, 1998, -1999, 2000, 2001, 2002, 2004 Free Software Foundation, Inc. +1999, 2000, 2001, 2002, 2004, 2005 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document @@ -129,13 +129,10 @@ Indexes (nodes containing large menus) * Key Index:: An item for each standard Emacs key sequence. +* Option Index:: An item for every command-line option. * Command Index:: An item for each command name. * Variable Index:: An item for each documented variable. * Concept Index:: An item for each concept. -@c This is last because @ifnottex leaves an empty line. -@ifnottex -* Option Index:: An item for every command-line option. -@end ifnottex Important General Concepts * Screen:: How to interpret what you see on the screen. @@ -196,17 +193,14 @@ * Emacs Server:: Using Emacs as an editing server for @code{mail}, etc. * Hardcopy:: Printing buffers or regions. * PostScript:: Printing buffers or regions as PostScript. -* PostScript Variables:: - Customizing the PostScript printing commands. +* PostScript Variables::Customizing the PostScript printing commands. * Sorting:: Sorting lines, paragraphs or pages within Emacs. * Narrowing:: Restricting display and editing to a portion of the buffer. * Two-Column:: Splitting apart columns to edit them in side-by-side windows. -* Editing Binary Files:: - Using Hexl mode to edit binary files. -* Saving Emacs Sessions:: - Saving Emacs state from one session to the next. +* Editing Binary Files::Using Hexl mode to edit binary files. +* Saving Emacs Sessions:: Saving Emacs state from one session to the next. * Recursive Edit:: A command can allow you to do editing "within the command". This is called a "recursive editing level". @@ -224,7 +218,6 @@ * Contributing:: How to contribute improvements to Emacs. * Service:: How to get help for your own Emacs needs. - Detailed Node Listing --------------------- @@ -245,12 +238,13 @@ change something. * Erasing:: Deleting and killing text. * Undo:: Undoing recent changes in the text. -* Files: Basic Files. Visiting, creating, and saving files. -* Help: Basic Help. Asking what a character does. +* Basic Files:: Visiting, creating, and saving files. +* Basic Help:: Asking what a character does. * Blank Lines:: Commands to make or delete blank lines. * Continuation Lines:: Lines too wide for the screen. * Position Info:: What page, line, row, or column is point on? * Arguments:: Numeric arguments for repeating a command. +* Repeating:: A short-cut for repeating the previous command. The Minibuffer @@ -268,19 +262,23 @@ * Apropos:: Asking what pertains to a given topic. * 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') The Mark and the Region * Setting Mark:: Commands to set the mark. * Transient Mark:: How to make Emacs highlight the region-- when there is one. +* Momentary Mark:: Enabling Transient Mark mode momentarily. * Using Region:: Summary of ways to operate on contents of the region. * Marking Objects:: Commands to put region around textual units. * Mark Ring:: Previous mark positions saved so you can go back there. * Global Mark Ring:: Previous mark positions in various buffers. -Killing +Killing and Moving Text * Deletion:: Commands for deleting small amounts of text and blank areas. @@ -302,6 +300,7 @@ * RegText:: Saving text in registers. * RegRect:: Saving rectangles in registers. * RegConfig:: Saving window configurations in registers. +* RegNumbers:: Numbers in registers. * RegFiles:: File names in registers. * Bookmarks:: Bookmarks are like registers, but persistent. @@ -355,7 +354,8 @@ * Keyboard Macro Query:: Making keyboard macros do different things each time. * Save Keyboard Macro:: Giving keyboard macros names; saving them in files. * Edit Keyboard Macro:: Editing keyboard macros. -* Keyboard Macro Step-Edit:: Interactively executing and editing a keyboard macro. +* Keyboard Macro Step-Edit:: Interactively executing and editing a keyboard + macro. File Handling @@ -382,8 +382,7 @@ * Backup:: How Emacs saves the old version of your file. * Interlocking:: How Emacs protects against simultaneous editing of one file by two users. -* Shadowing: File Shadowing. - Copying files to "shadows" automatically. +* File Shadowing:: Copying files to "shadows" automatically. * Time Stamps:: Emacs can update time stamps on saved files. Version Control @@ -392,7 +391,7 @@ * VC Mode Line:: How the mode line shows version control status. * Basic VC Editing:: How to edit a file under version control. * Old Versions:: Examining and comparing old versions. -* Secondary VC Commands:: The commands used a little less frequently. +* Secondary VC Commands:: The commands used a little less frequently. * Branches:: Multiple lines of development. * Remote Repositories:: Efficient access to remote CVS servers. * Snapshots:: Sets of file versions treated as a unit. @@ -408,6 +407,8 @@ * Several Buffers:: How to go through the list of all buffers and operate variously on several of them. * Indirect Buffers:: An indirect buffer shares the text of another buffer. +* Buffer Convenience:: Convenience and customization features for + buffer handling. Multiple Windows @@ -418,6 +419,7 @@ * Force Same Window:: Forcing certain buffers to appear in the selected window rather than in another window. * Change Window:: Deleting windows and changing their sizes. +* Window Convenience:: Convenience functions for window handling. Frames and X Windows @@ -451,6 +453,7 @@ * Language Environments:: Setting things up for the language you use. * Input Methods:: Entering text characters not on your keyboard. * Select Input Method:: Specifying your choice of input methods. +* Multibyte Conversion:: How single-byte characters convert to multibyte. * Coding Systems:: Character set conversion when you read and write files, and so on. * Recognize Coding:: How Emacs figures out which conversion to use. @@ -458,9 +461,10 @@ * Fontsets:: Fontsets are collections of fonts that cover the whole spectrum of characters. * Defining Fontsets:: Defining a new fontset. -* Single-Byte Character Support:: - You can pick one European character set - to use without multibyte characters. +* Undisplayable Characters::When characters don't display. +* Single-Byte Character Support:: You can pick one European character set + to use without multibyte characters. +* Charsets:: How Emacs groups its internal character codes. Major Modes @@ -484,16 +488,20 @@ * Text Mode:: The major modes for editing text files. * Outline Mode:: Editing outlines. * TeX Mode:: Editing input to the formatter TeX. +* HTML Mode:: Editing HTML, SGML, and XML files. * Nroff Mode:: Editing input to the formatter nroff. * Formatted Text:: Editing formatted text directly in WYSIWYG fashion. +* Text Based Tables:: Editing text-based tables in WYSIWYG fashion. Filling Text * Auto Fill:: Auto Fill mode breaks long lines automatically. +* Refill:: Keeping paragraphs filled. * Fill Commands:: Commands to refill paragraphs and center lines. * Fill Prefix:: Filling paragraphs that are indented or in a comment, etc. * Adaptive Fill:: How Emacs can determine the fill prefix automatically. +* Longlines:: Editing text with very long lines. Editing Programs @@ -501,8 +509,8 @@ * Defuns:: Commands to operate on major top-level parts of a program. * Program Indent:: Adjusting indentation to show the nesting. +* Parentheses:: Commands that operate on parentheses. * Comments:: Inserting, killing, and aligning comments. -* Parentheses:: Commands that operate on parentheses. * Documentation:: Getting documentation of functions you plan to call. * Hideshow:: Displaying blocks selectively. * Symbol Completion:: Completion on symbol names of your program or language. @@ -559,12 +567,12 @@ Fortran Mode -* Motion: Fortran Motion. Moving point by statements or subprograms. -* Indent: Fortran Indent. Indentation commands for Fortran. -* Comments: Fortran Comments. Inserting and aligning comments. -* Autofill: Fortran Autofill. Auto fill minor mode for Fortran. -* Columns: Fortran Columns. Measuring columns for valid Fortran. -* Abbrev: Fortran Abbrev. Built-in abbrevs for Fortran keywords. +* Fortran Motion:: Moving point by statements or subprograms. +* Fortran Indent:: Indentation commands for Fortran. +* Fortran Comments:: Inserting and aligning comments. +* Fortran Autofill:: Auto fill minor mode for Fortran. +* Fortran Columns:: Measuring columns for valid Fortran. +* Fortran Abbrev:: Built-in abbrevs for Fortran keywords. Compiling and Testing Programs @@ -580,8 +588,8 @@ with different facilities for running the Lisp programs. * Lisp Libraries:: Creating Lisp programs to run in Emacs. +* Lisp Eval:: Executing a single Lisp expression in Emacs. * Lisp Interaction:: Executing Lisp in an Emacs buffer. -* Lisp Eval:: Executing a single Lisp expression in Emacs. * External Lisp:: Communicating through Emacs with a separate Lisp. Running Debuggers Under Emacs @@ -590,6 +598,9 @@ * Debugger Operation:: Connection between the debugger and source buffers. * Commands of GUD:: Key bindings for common commands. * GUD Customization:: Defining your own commands for GUD. +* GDB Graphical Interface:: An enhanced mode that uses GDB features to + implement a graphical debugging environment through + Emacs. Maintaining Programs @@ -605,6 +616,7 @@ * Tag Syntax:: Tag syntax for various types of code and text files. * Create Tags Table:: Creating a tags table with @code{etags}. +* Etags Regexps:: Create arbitrary tags using regular expressions. * Select Tags Table:: How to visit a tags table. * Find Tag:: Commands to find the definition of a specific tag. * Tags Search:: Using a tags table for searching and replacing. @@ -631,6 +643,7 @@ * Editing Abbrevs:: Viewing or editing the entire list of defined abbrevs. * Saving Abbrevs:: Saving the entire list of abbrevs for another session. * Dynamic Abbrevs:: Abbreviations for words already in the buffer. +* Dabbrev Customization:: What is a word, for dynamic abbrevs. Case handling. Editing Pictures @@ -664,11 +677,15 @@ * Rmail Summary:: Summaries show brief info on many messages. * Rmail Sorting:: Sorting messages in Rmail. * Rmail Display:: How Rmail displays a message; customization. +* Rmail Coding:: How Rmail handles decoding character sets. * Rmail Editing:: Editing message text and headers in Rmail. * Rmail Digest:: Extracting the messages from a digest message. * Out of Rmail:: Converting an Rmail file to mailbox format. * Rmail Rot13:: Reading messages encoded in the rot13 code. * Movemail:: More details of fetching new mail. +* Remote Mailboxes:: Retrieving Mail from Remote Mailboxes. +* Other Mailbox Formats:: Retrieving Mail from Local Mailboxes in + Various Formats Dired, the Directory Editor @@ -688,7 +705,6 @@ * Hiding Subdirectories:: Making subdirectories visible or invisible. * Dired Updating:: Discarding lines for files of no interest. * Dired and Find:: Using `find' to choose the files for Dired. -* Dired and Find:: Using `find' to choose the files for Dired. * Wdired:: Operating on files by editing the Dired buffer. * Misc Dired Features:: Various other features. @@ -698,14 +714,16 @@ * Scroll Calendar:: Bringing earlier or later months onto the screen. * Counting Days:: How many days are there between two dates? * General Calendar:: Exiting or recomputing the calendar. -* LaTeX Calendar:: Print a calendar using LaTeX. +* LaTeX Calendar:: Print a calendar using LaTeX. * Holidays:: Displaying dates of holidays. * Sunrise/Sunset:: Displaying local times of sunrise and sunset. * Lunar Phases:: Displaying phases of the moon. * Other Calendars:: Converting dates to other calendar systems. * Diary:: Displaying events from your diary. * Appointments:: Reminders when it's time to do something. +* Importing Diary:: Converting diary events to/from other formats. * Daylight Savings:: How to specify when daylight savings time is active. +* Time Intervals:: Keeping track of time intervals. Movement in the Calendar @@ -741,27 +759,40 @@ * Single Shell:: How to run one shell command and return. * Interactive Shell:: Permanent shell taking input via Emacs. * Shell Mode:: Special Emacs commands used with permanent shell. +* Shell Prompts:: Two ways to recognize shell prompts. * Shell History:: Repeating previous commands in a shell buffer. +* Directory Tracking:: Keeping track when the subshell changes directory. * Shell Options:: Options for customizing Shell mode. +* Terminal emulator:: An Emacs window as a terminal emulator. +* Term Mode:: Special Emacs commands used in Term mode. +* Paging in Term:: Paging in the terminal emulator. * Remote Host:: Connecting to another computer. +Using Emacs as a Server + +* Invoking emacsclient:: Emacs client startup options. + +Hyperlinking and Navigation Features + +* Browse-URL:: Following URLs. +* Goto-address:: Activating URLs. +* FFAP:: Finding files etc. at point. + Customization * Minor Modes:: Each minor mode is one feature you can turn on independently of any others. -* Easy Customization:: - Convenient way to browse and change user options. +* Easy Customization:: Convenient way to browse and change user options. * Variables:: Many Emacs commands examine Emacs variables to decide what to do; by setting variables, you can control their functioning. * Key Bindings:: The keymaps say what command each key runs. By changing them, you can "redefine keys". -* Keyboard Translations:: - If your keyboard passes an undesired code - for a key, you can tell Emacs to - substitute another code. +* Keyboard Translations:: If your keyboard passes an undesired code + for a key, you can tell Emacs to + substitute another code. * Syntax:: The syntax table controls how words and - expressions are parsed. + expressions are parsed. * Init File:: How to write common customizations in the @file{.emacs} file. @@ -783,6 +814,7 @@ * Init Rebinding:: Rebinding keys with your init file, @file{.emacs}. * Function Keys:: Rebinding terminal function keys. * Named ASCII Chars:: Distinguishing @key{TAB} from @kbd{C-i}, and so on. +* Non-ASCII Rebinding:: Rebinding non-@acronym{ASCII} characters such as Latin-1. * Mouse Buttons:: Rebinding mouse buttons in Emacs. * Disabling:: Disabling a command means confirmation is required before it can be executed. This is done to protect @@ -803,18 +835,19 @@ * Text Garbled:: Garbage in the text. * Unasked-for Search:: Spontaneous entry to incremental search. * Memory Full:: How to cope when you run out of memory. +* After a Crash:: Recovering editing in an Emacs session that crashed. * Emergency Escape:: Emergency escape--- What to do if Emacs stops responding. * Total Frustration:: When you are at your wits' end. Reporting Bugs -* Criteria: Bug Criteria. Have you really found a bug? -* Understanding Bug Reporting:: How to report a bug effectively. -* Checklist:: Steps to follow for a good bug report. -* Sending Patches:: How to send a patch for GNU Emacs. +* Bug Criteria:: Have you really found a bug? +* Understanding Bug Reporting:: How to report a bug effectively. +* Checklist:: Steps to follow for a good bug report. +* Sending Patches:: How to send a patch for GNU Emacs. -Command Line Options and Arguments +Command Line Arguments for Emacs Invocation * Action Arguments:: Arguments to visit files, load libraries, and call functions. @@ -831,18 +864,29 @@ * Icons X:: Choosing what sort of icon to use, under X. * Misc X:: Other display options. -X Resources +Environment Variables + +* General Variables:: Environment variables that all versions of Emacs use. +* Misc Variables:: Certain system specific variables. +* MS-Windows Registry:: An alternative to the environment on MS-Windows. + +X Options and Resources * Resources:: Using X resources with Emacs (in general). * Table of Resources:: Table of specific X resources that affect Emacs. * Face Resources:: X resources for customizing faces. * Lucid Resources:: X resources for Lucid menus. * LessTif Resources:: X resources for LessTif and Motif menus. +* GTK resources:: Resources for GTK widgets. -Environment Variables +Emacs and the Mac OS -* General Variables:: Environment variables that all versions of Emacs use. -* Misc Variables:: Certain system specific variables. +* Mac Input:: Keyboard input on the Mac. +* Mac International:: International character sets on the Mac. +* Mac Environment Variables:: Setting environment variables for Emacs. +* Mac Directories:: Volumes and directories on the Mac. +* Mac Font Specs:: Specifying fonts on the Mac. +* Mac Functions:: Mac-specific Lisp functions. MS-DOS and Windows 95/98/NT @@ -852,6 +896,7 @@ * MS-DOS File Names:: File-name conventions on MS-DOS. * Text and Binary:: Text files on MS-DOS use CRLF to separate lines. * MS-DOS Printing:: How to specify the printer on MS-DOS. +* MS-DOS and MULE:: Support for internationalization on MS-DOS. * MS-DOS Processes:: Running subprocesses on MS-DOS. * Windows Processes:: Running subprocesses on Windows. * Windows System Menu:: Controlling what the ALT key does.