diff options
Diffstat (limited to 'doc/emacs')
47 files changed, 406 insertions, 405 deletions
diff --git a/doc/emacs/abbrevs.texi b/doc/emacs/abbrevs.texi index a3cb989320a..23d7e28f4e3 100644 --- a/doc/emacs/abbrevs.texi +++ b/doc/emacs/abbrevs.texi @@ -20,7 +20,7 @@ to expand the letters in the buffer before point by looking for other words in the buffer that start with those letters. @xref{Dynamic Abbrevs}. - ``Hippie'' expansion generalizes abbreviation expansion. + A third kind, @dfn{hippie expansion}, generalizes abbreviation expansion. @xref{Hippie Expand, , Hippie Expansion, autotype, Features for Automatic Typing}. @@ -250,10 +250,10 @@ keeps track of this to help you see which abbrevs you actually use, so that you can eliminate those that you don't use often. The string at the end of the line is the expansion. - Some abbrevs are marked with @samp{(sys)}. These ``system'' abbrevs + Some abbrevs are marked with @samp{(sys)}. These @dfn{system abbrevs} (@pxref{Abbrevs,,, elisp, The Emacs Lisp Reference Manual}) are pre-defined by various modes, and are not saved to your abbrev file. -To disable a ``system'' abbrev, define an abbrev of the same name that +To disable a system abbrev, define an abbrev of the same name that expands to itself, and save it to your abbrev file. @findex edit-abbrevs diff --git a/doc/emacs/ack.texi b/doc/emacs/ack.texi index f612a7b04d8..f34de976a05 100644 --- a/doc/emacs/ack.texi +++ b/doc/emacs/ack.texi @@ -155,7 +155,7 @@ directory changes in shell buffers; @file{filecache.el}, which records which directories your files are in; @file{locate.el}, which interfaces to the @code{locate} command; @file{find-lisp.el}, an Emacs Lisp emulation of the @command{find} program; @file{net-utils.el}; and -the ``generic mode'' feature. +the generic mode feature. @item Emmanuel Briot wrote @file{xml.el}, an XML parser for Emacs; and @@ -196,7 +196,8 @@ for editing IDL and WAVE CL. Bob Chassell wrote @file{texnfo-upd.el}, @file{texinfo.el}, and @file{makeinfo.el}, modes and utilities for working with Texinfo files; and @file{page-ext.el}, commands for extended page handling. He also -wrote the ``Introduction to programming in Emacs Lisp'' manual. +wrote the Emacs Lisp introduction. @xref{,,,eintr, Introduction to +Programming in Emacs Lisp}. @item Jihyun Cho wrote @file{hanja-util.el} and @file{hangul.el}, utilities @@ -247,10 +248,10 @@ for compiled Emacs Lisp code. @item Mathias Dahl wrote @file{image-dired.el}, a package for viewing image -files as ``thumbnails''. +files as thumbnails. @item -Julien Danjou wrote an implementation of ``Desktop Notifications'' +Julien Danjou wrote an implementation of desktop notifications (@file{notifications.el}, and related packages for ERC and Gnus); and @file{color.el}, a library for general color manipulation. He also made various contributions to Gnus. @@ -544,11 +545,11 @@ diary entries to and from the iCalendar format; @file{bubbles.el}, a puzzle game. @item -Kyle Jones wrote @file{life.el}, a package to play Conway's ``life'' game. +Kyle Jones wrote @file{life.el}, a package to play Conway's Game of Life. @item Terry Jones wrote @file{shadow.el}, a package for finding potential -load-path problems when some Lisp file ``shadows'' another. +load-path problems when some Lisp file shadows another. @item Simon Josefsson wrote @file{dns-mode.el}, an editing mode for Domain @@ -708,7 +709,7 @@ Leo Liu wrote @file{pcmpl-x.el}, providing completion for miscellaneous external tools; and revamped support for Octave in Emacs 24.4. @item -Károly Lőrentey wrote the ``multi-terminal'' code, which allows +Károly Lőrentey wrote the multi-terminal code, which allows Emacs to run on graphical and text terminals simultaneously. @item @@ -726,7 +727,7 @@ Autoconf files; @file{cfengine.el}, a mode for editing Cfengine files; @file{elide-head.el}, a package for eliding boilerplate text from file headers; @file{hl-line.el}, a minor mode for highlighting the line in the current window on which point is; @file{cap-words.el}, a minor mode -for motion in ``CapitalizedWordIdentifiers''; @file{latin1-disp.el}, a +for motion in @code{CapitalizedWordIdentifiers}; @file{latin1-disp.el}, a package that lets you display ISO 8859 characters on Latin-1 terminals by setting up appropriate display tables; the version of @file{python.el} used prior to Emacs 24.3; @file{smiley.el}, a @@ -822,7 +823,7 @@ command with its arguments. @item Richard Mlynarik wrote @file{cl-indent.el}, a package for indenting -Common Lisp code; @file{ebuff-menu.el}, an ``electric'' browser for +Common Lisp code; @file{ebuff-menu.el}, an electric browser for buffer listings; @file{ehelp.el}, bindings for browsing help screens; and @file{rfc822.el}, a parser for E-mail addresses in the RFC-822 format, used in mail messages and news articles. @@ -848,7 +849,7 @@ text; @file{smerge-mode.el}, a minor mode for resolving @code{diff3} conflicts; @file{diff-mode.el}, a mode for viewing and editing context diffs; @file{css-mode.el} for Cascading Style Sheets; @file{bibtex-style.el} for Bib@TeX{} Style files; @file{mpc.el}, a -client for the ``Music Player Daemon''; @file{smie.el}, a generic +client for the Music Player Daemon (MPD); @file{smie.el}, a generic indentation engine; and @file{pcase.el}, implementing ML-style pattern matching. In Emacs 24, he integrated the lexical binding code, cleaned up the CL namespace (making it acceptable to use CL @@ -930,7 +931,7 @@ Jeff Peck wrote @file{sun.el}, key bindings for sunterm keys. @item Damon Anton Permezel wrote @file{hanoi.el}, an animated demonstration of -the ``Towers of Hanoi'' puzzle. +the Towers of Hanoi puzzle. @item William M. Perry wrote @file{mailcap.el} (with Lars Magne @@ -1003,7 +1004,7 @@ source code version control systems, with Paul Eggert; @file{gud.el}, a package for running source-level debuggers like GDB and SDB in Emacs; @file{asm-mode.el}, a mode for editing assembly language code; @file{AT386.el}, terminal support package for IBM's AT keyboards; -@file{cookie1.el}, support for ``fortune-cookie'' programs like +@file{cookie1.el}, support for fortune-cookie programs like @file{yow.el} and @file{spook.el}; @file{finder.el}, a package for finding Emacs Lisp packages by keyword and topic; @file{keyswap.el}, code to swap the @key{BS} and @key{DEL} keys; @file{loadhist.el}, @@ -1055,7 +1056,7 @@ DSSSL code. @item Martin Rudalics implemented improved display-buffer handling in Emacs 24; -and implemented ``pixel-wise'' resizing of windows and frames. +and implemented pixel-wise resizing of windows and frames. @item Ivar Rummelhoff wrote @file{winner.el}, which records recent window @@ -1177,7 +1178,7 @@ selecting regions to follow many other systems. @item Richard Stallman invented Emacs. He is the original author of GNU Emacs, and has been Emacs maintainer over several non-contiguous -periods. In addition to much of the ``core'' Emacs code, he has +periods. In addition to much of the core Emacs code, he has written @file{easymenu.el}, a facility for defining Emacs menus; @file{image-mode.el}, support for visiting image files; @file{menu-bar.el}, the Emacs menu bar support code; @@ -1193,8 +1194,8 @@ Ake Stenhoff and Lars Lindberg wrote @file{imenu.el}, a framework for browsing indices made from buffer contents. @item -Peter Stephenson wrote @file{vcursor.el}, which implements a ``virtual -cursor'' that you can move with the keyboard and use for copying text. +Peter Stephenson wrote @file{vcursor.el}, which implements a virtual +cursor that you can move with the keyboard and use for copying text. @item Ken Stevens wrote @file{ispell.el}, a spell-checker interface. @@ -1230,7 +1231,7 @@ the keyboard. @item Jean-Philippe Theberge wrote @file{thumbs.el}, a package for viewing -image files as ``thumbnails''. +image files as thumbnails. @item Spencer Thomas wrote the original @file{dabbrev.el}, providing a command @@ -1274,7 +1275,7 @@ for Gnus; and @file{timezone.el}, providing functions for dealing with time zones. @item -Neil W. Van Dyke wrote @file{webjump.el}, a ``hot links'' package. +Neil W. Van Dyke wrote @file{webjump.el}, a Web hotlist package. @item Didier Verna wrote @file{rect.el}, a package of functions for @@ -1373,7 +1374,7 @@ manual pages without the @code{man} command. @item Masatake Yamato wrote @file{ld-script.el}, an editing mode for GNU linker scripts, and contributed subword handling and style -``guessing'' in CC mode. +guessing in CC mode. @item Jonathan Yavner wrote @file{testcover.el}, a package for keeping track diff --git a/doc/emacs/anti.texi b/doc/emacs/anti.texi index def5411064c..72452a501a6 100644 --- a/doc/emacs/anti.texi +++ b/doc/emacs/anti.texi @@ -13,21 +13,21 @@ greater simplicity that results from the absence of many Emacs @itemize @bullet @item -Support for displaying and editing ``bidirectional'' text has been +Support for displaying and editing bidirectional text has been removed. Text is now always displayed on the screen in a single consistent direction---left to right---regardless of the underlying script. Similarly, @kbd{C-f} and @kbd{C-b} always move the text cursor to the right and left respectively. Also, @key{RIGHT} and @key{LEFT} are now equivalent to @kbd{C-f} and @kbd{C-b}, as you might expect, rather than moving forward or backward based on the underlying -``paragraph direction''. +paragraph direction. -Users of ``right-to-left'' languages, like Arabic and Hebrew, may +Users of right-to-left languages, like Arabic and Hebrew, may adapt by reading and/or editing text in left-to-right order. @item The Emacs Lisp package manager has been removed. Instead of using a -``user interface'' (@kbd{M-x list-packages}), additional Lisp packages +user interface (@kbd{M-x list-packages}), additional Lisp packages must now be installed by hand, which is the most flexible and ``Lispy'' method anyway. Typically, this just involves editing your init file to add the package installation directory to the load path @@ -43,7 +43,7 @@ the text in the region; it deletes a single character instead. We have reworked how Emacs handles the clipboard and the X primary selection. Commands for killing and yanking, like @kbd{C-w} and @kbd{C-y}, use the primary selection and not the clipboard, so you can -use these commands without interfering with ``cutting'' or ``pasting'' +use these commands without interfering with cutting or pasting in other programs. The @samp{Cut}/@samp{Copy}/@samp{Paste} menu items are bound to separate clipboard commands, not to the same commands as @kbd{C-w}/@kbd{M-w}/@kbd{C-y}. diff --git a/doc/emacs/arevert-xtra.texi b/doc/emacs/arevert-xtra.texi index 9d356108677..69431c65983 100644 --- a/doc/emacs/arevert-xtra.texi +++ b/doc/emacs/arevert-xtra.texi @@ -17,13 +17,13 @@ of buffers for which it is implemented (listed in the menu below). Like file buffers, non-file buffers should normally not revert while you are working on them, or while they contain information that might get lost after reverting. Therefore, they do not revert if they are -``modified''. This can get tricky, because deciding when a non-file +modified. This can get tricky, because deciding when a non-file buffer should be marked modified is usually more difficult than for file buffers. Another tricky detail is that, for efficiency reasons, Auto Revert often does not try to detect all possible changes in the buffer, only -changes that are ``major'' or easy to detect. Hence, enabling +changes that are major or easy to detect. Hence, enabling auto-reverting for a non-file buffer does not always guarantee that all information in the buffer is up-to-date, and does not necessarily make manual reverts useless. diff --git a/doc/emacs/basic.texi b/doc/emacs/basic.texi index 0a4391094b3..40daf56a3a1 100644 --- a/doc/emacs/basic.texi +++ b/doc/emacs/basic.texi @@ -424,7 +424,7 @@ On some text terminals, Emacs may not recognize the @key{DEL} key properly. @xref{DEL Does Not Delete}, if you encounter this problem. The @key{Delete} (@code{delete-forward-char}) command deletes in the -``opposite direction'': it deletes the character after point, i.e., the +opposite direction: it deletes the character after point, i.e., the character under the cursor. If point was at the end of a line, this joins the following line onto this one. Like @kbd{@key{DEL}}, it deletes the text in the region if the region is active (@pxref{Mark}). @@ -762,7 +762,7 @@ down one line, as you might expect---the @samp{0} is treated as part of the prefix argument. (What if you do want to insert five copies of @samp{0}? Type @kbd{M-5 -C-u 0}. Here, @kbd{C-u} ``terminates'' the prefix argument, so that +C-u 0}. Here, @kbd{C-u} terminates the prefix argument, so that the next keystroke begins the command that you want to execute. Note that this meaning of @kbd{C-u} applies only to this case. For the usual role of @kbd{C-u}, see below.) @@ -780,7 +780,7 @@ multiplies the argument for the next command by four. @kbd{C-u C-u} multiplies it by sixteen. Thus, @kbd{C-u C-u C-f} moves forward sixteen characters. Other useful combinations are @kbd{C-u C-n}, @kbd{C-u C-u C-n} (move down a good fraction of a screen), @kbd{C-u -C-u C-o} (make ``a lot'' of blank lines), and @kbd{C-u C-k} (kill four +C-u C-o} (make sixteen blank lines), and @kbd{C-u C-k} (kill four lines). You can use a numeric argument before a self-inserting character to diff --git a/doc/emacs/buffers.texi b/doc/emacs/buffers.texi index c217c09aa42..5a4d1abfc39 100644 --- a/doc/emacs/buffers.texi +++ b/doc/emacs/buffers.texi @@ -94,7 +94,7 @@ now displayed in any window. While entering the buffer name, you can use the usual completion and history commands (@pxref{Minibuffer}). Note that @kbd{C-x b}, and -related commands, use ``permissive completion with confirmation'' for +related commands, use @dfn{permissive completion with confirmation} for minibuffer completion: if you type @key{RET} immediately after completing up to a nonexistent buffer name, Emacs prints @samp{[Confirm]} and you must type a second @key{RET} to submit that @@ -180,7 +180,7 @@ buffers that were current most recently come first. @samp{.} in the first field of a line indicates that the buffer is current. @samp{%} indicates a read-only buffer. @samp{*} indicates -that the buffer is ``modified''. If several buffers are modified, it +that the buffer is modified. If several buffers are modified, it may be time to save some with @kbd{C-x s} (@pxref{Save Commands}). Here is an example of a buffer list: diff --git a/doc/emacs/building.texi b/doc/emacs/building.texi index 1d40a2dd12d..fbef9feb5a6 100644 --- a/doc/emacs/building.texi +++ b/doc/emacs/building.texi @@ -322,7 +322,7 @@ nohup @var{command}; sleep 1 @end example @ifnottex - On the MS-DOS ``operating system'', asynchronous subprocesses are + On MS-DOS, asynchronous subprocesses are not supported, so @kbd{M-x compile} runs the compilation command synchronously (i.e., you must wait until the command finishes before you can do anything else in Emacs). @xref{MS-DOS}. @@ -334,7 +334,7 @@ you can do anything else in Emacs). @xref{MS-DOS}. Just as you can run a compiler from Emacs and then visit the lines with compilation errors, you can also run @command{grep} and then visit the lines on which matches were found. This works by treating -the matches reported by @command{grep} as if they were ``errors''. +the matches reported by @command{grep} as if they were errors. The output buffer uses Grep mode, which is a variant of Compilation mode (@pxref{Compilation Mode}). @@ -800,12 +800,12 @@ the command to @kbd{C-c @var{binding}} in the GUD buffer's mode and to @table @samp @item %f The name of the current source file. If the current buffer is the GUD -buffer, then the ``current source file'' is the file that the program +buffer, then the current source file is the file that the program stopped in. @item %l The number of the current source line. If the current buffer is the GUD -buffer, then the ``current source line'' is the line that the program +buffer, then the current source line is the line that the program stopped in. @item %e @@ -848,7 +848,7 @@ GUD}). You must use this if you want to debug multiple programs within one Emacs session, as that is currently unsupported by @kbd{M-x gdb}. - Internally, @kbd{M-x gdb} informs GDB that its ``screen size'' is + Internally, @kbd{M-x gdb} informs GDB that its screen size is unlimited; for correct operation, you must not change GDB's screen height and width values during the debugging session. @@ -893,8 +893,8 @@ displays the following frame layout: @findex gdb-restore-windows @findex gdb-many-windows - If you ever change the window layout, you can restore the ``many -windows'' layout by typing @kbd{M-x gdb-restore-windows}. To toggle + If you ever change the window layout, you can restore the many-windows +layout by typing @kbd{M-x gdb-restore-windows}. To toggle between the many windows layout and a simple layout with just the GUD interaction buffer and a source file, type @kbd{M-x gdb-many-windows}. diff --git a/doc/emacs/cal-xtra.texi b/doc/emacs/cal-xtra.texi index ed850456c8b..3b5b3c58a65 100644 --- a/doc/emacs/cal-xtra.texi +++ b/doc/emacs/cal-xtra.texi @@ -143,7 +143,7 @@ all) of the variables @code{calendar-bahai-all-holidays-flag}, Each of the holiday variables is a list of @dfn{holiday forms}, each form describing a holiday (or sometimes a list of holidays). Here is a table of the possible kinds of holiday form. Day numbers and month -numbers count starting from 1, but ``dayname'' numbers count Sunday as +numbers count starting from 1, but @dfn{dayname} numbers count Sunday as 0. The argument @var{string} is always the description of the holiday, as a string. @@ -840,7 +840,7 @@ Renew medication (5th time) @noindent in the fancy diary display on September 7, 2012. - There is an ``early reminder'' diary sexp that includes its entry in the + There is an early-reminder diary sexp that includes its entry in the diary not only on the date of occurrence, but also on earlier dates. For example, if you want a reminder a week before your anniversary, you can use diff --git a/doc/emacs/calendar.texi b/doc/emacs/calendar.texi index e9c8b7356aa..bc13d4ba296 100644 --- a/doc/emacs/calendar.texi +++ b/doc/emacs/calendar.texi @@ -57,7 +57,7 @@ For more advanced topics, Calendar mode provides commands to move through the calendar in logical units of time such as days, weeks, months, and years. If you move outside the three months originally displayed, the calendar -display ``scrolls'' automatically through time to make the selected +display scrolls automatically through time to make the selected date visible. Moving to a date lets you view its holidays or diary entries, or convert it to other calendars; moving by long time periods is also useful simply to scroll the calendar. @@ -269,7 +269,7 @@ contents one month backwards in time. @kindex M-v @r{(Calendar mode)} @findex calendar-scroll-right-three-months The commands @kbd{C-v} and @kbd{M-v} scroll the calendar by an entire -``screenful''---three months---in analogy with the usual meaning of +screenful---three months---in analogy with the usual meaning of these commands. @kbd{C-v} makes later dates visible and @kbd{M-v} makes earlier dates visible. These commands take a numeric argument as a repeat count; in particular, since @kbd{C-u} multiplies the next command @@ -432,8 +432,8 @@ Generate a Filofax-style calendar for one year (@code{cal-tex-cursor-filofax-year}). @end table - Some of these commands print the calendar sideways (in ``landscape -mode''), so it can be wider than it is long. Some of them use Filofax + Some of these commands print the calendar sideways (in landscape +mode), so it can be wider than it is long. Some of them use Filofax paper size (3.75in x 6.75in). All of these commands accept a prefix argument, which specifies how many days, weeks, months or years to print (starting always with the selected one). @@ -631,8 +631,8 @@ for all users in a @file{default.el} file. @xref{Init File}. These calendar commands display the dates and times of the phases of the moon (new moon, first quarter, full moon, last quarter). This -feature is useful for debugging problems that ``depend on the phase of -the moon''. +feature is useful for debugging problems that depend on the phase of +the moon. @table @kbd @item M @@ -665,7 +665,7 @@ See the discussion in the previous section. @xref{Sunrise/Sunset}. @cindex Gregorian calendar The Emacs calendar displayed is @emph{always} the Gregorian calendar, -sometimes called the ``new style'' calendar, which is used in most of +sometimes called the New Style calendar, which is used in most of the world today. However, this calendar did not exist before the sixteenth century and was not widely used before the eighteenth century; it did not fully displace the Julian calendar and gain universal @@ -759,13 +759,13 @@ official calendar of Iran will be at that time. into solar years. The years go in cycles of sixty, each year containing either twelve months in an ordinary year or thirteen months in a leap year; each month has either 29 or 30 days. Years, ordinary months, and -days are named by combining one of ten ``celestial stems'' with one of -twelve ``terrestrial branches'' for a total of sixty names that are +days are named by combining one of ten @dfn{celestial stems} with one of +twelve @dfn{terrestrial branches} for a total of sixty names that are repeated in a cycle of sixty. @cindex Bahá'í calendar The Bahá'í calendar system is based on a solar cycle of 19 months with -19 days each. The four remaining ``intercalary'' days are placed +19 days each. The four remaining intercalary days are placed between the 18th and 19th months. @node To Other Calendar @@ -908,7 +908,7 @@ Islamic, or French names. @findex calendar-hebrew-list-yahrzeits @cindex yahrzeits One common issue concerning the Hebrew calendar is the computation -of the anniversary of a date of death, called a ``yahrzeit''. The Emacs +of the anniversary of a date of death, called a @dfn{yahrzeit}. The Emacs calendar includes a facility for such calculations. If you are in the calendar, the command @kbd{M-x calendar-hebrew-list-yahrzeits} asks you for a range of years and then displays a list of the yahrzeit dates for those @@ -1463,11 +1463,11 @@ variable @code{diary-outlook-formats}. Other mail clients can set @c FIXME the name of the RFC is hardly very relevant. @cindex iCalendar support The icalendar package allows you to transfer data between your Emacs -diary file and iCalendar files, which are defined in ``RFC +diary file and iCalendar files, which are defined in @cite{RFC 2445---Internet Calendaring and Scheduling Core Object Specification -(iCalendar)'' (as well as the earlier vCalendar format). +(iCalendar)} (as well as the earlier vCalendar format). -@c Importing works for ``ordinary'' (i.e., non-recurring) events, but +@c Importing works for ordinary (i.e., non-recurring) events, but @c (at present) may not work correctly (if at all) for recurring events. @c Exporting of diary files into iCalendar files should work correctly @c for most diary entries. This feature is a work in progress, so the @@ -1601,11 +1601,11 @@ timeclock-change}. Once you've collected data from a number of time intervals, you can use @kbd{M-x timeclock-workday-remaining} to see how much time is left to work today (assuming a typical average of 8 hours a day), and @kbd{M-x -timeclock-when-to-leave} which will calculate when you're ``done''. +timeclock-when-to-leave} which will calculate when you're done. @vindex timeclock-modeline-display @findex timeclock-modeline-display - If you want Emacs to display the amount of time ``left'' of your + If you want Emacs to display the amount of time left of your workday in the mode line, either customize the @code{timeclock-modeline-display} variable and set its value to @code{t}, or invoke the @kbd{M-x timeclock-modeline-display} command. diff --git a/doc/emacs/cmdargs.texi b/doc/emacs/cmdargs.texi index 60fe97720c3..1385fefaead 100644 --- a/doc/emacs/cmdargs.texi +++ b/doc/emacs/cmdargs.texi @@ -443,8 +443,8 @@ some other programs. Emacs does not require any of these environment variables to be set, but it uses their values if they are set. @c This used to be @vtable, but that enters the variables alone into -@c the Variable Index, which in some cases, like ``HOME'', might be -@c confused with keys by that name, and other cases, like ``NAME'', +@c the Variable Index, which in some cases, like HOME, might be +@c confused with keys by that name, and other cases, like NAME, @c might be confused with general-purpose phrases. @table @env @item CDPATH @@ -582,7 +582,7 @@ The name of the news server. Used by the mh and Gnus packages. @item ORGANIZATION @vindex ORGANIZATION, environment variable The name of the organization to which you belong. Used for setting the -``Organization:'' header in your posts from the Gnus package. +@samp{Organization:} header in your posts from the Gnus package. @item PATH @vindex PATH, environment variable A colon-separated list of directories containing executable files. @@ -808,7 +808,7 @@ Use @var{font} as the default font. @end table When passing a font name to Emacs on the command line, you may need to -``quote'' it, by enclosing it in quotation marks, if it contains +quote it, by enclosing it in quotation marks, if it contains characters that the shell treats specially (e.g., spaces). For example: @@ -1036,7 +1036,7 @@ tool bar when it processes the specified geometry. When using one of @samp{--fullscreen}, @samp{--maximized}, @samp{--fullwidth} or @samp{--fullheight}, some window managers require you to set the variable @code{frame-resize-pixelwise} to a non-@code{nil} -value to make a frame appear truly ``maximized'' or ``fullscreen''. +value to make a frame appear truly maximized or fullscreen. Some window managers have options that can make them ignore both program-specified and user-specified positions. If these are set, @@ -1115,7 +1115,7 @@ for the initial Emacs frame. @opindex --iconic @itemx --iconic @cindex start iconified, command-line argument -Start Emacs in an iconified (``minimized'') state. +Start Emacs in an iconified state. @item -nbi @opindex -nbi @@ -1125,12 +1125,12 @@ Start Emacs in an iconified (``minimized'') state. Disable the use of the Emacs icon. @end table - Most window managers allow you to ``iconify'' (or ``minimize'') an + Most window managers allow you to iconify (or minimize) an Emacs frame, hiding it from sight. Some window managers replace -iconified windows with tiny ``icons'', while others remove them +iconified windows with tiny icons, while others remove them entirely from sight. The @samp{-iconic} option tells Emacs to begin running in an iconified state, rather than showing a frame right away. -The text frame doesn't appear until you deiconify (or ``un-minimize'') +The text frame doesn't appear until you deiconify (or un-minimize) it. By default, Emacs uses an icon containing the Emacs logo. On diff --git a/doc/emacs/commands.texi b/doc/emacs/commands.texi index fb77c77358f..98e12531253 100644 --- a/doc/emacs/commands.texi +++ b/doc/emacs/commands.texi @@ -70,7 +70,7 @@ where the @key{META} key does not function reliably. On graphical displays, the window manager might block some keyboard inputs, including @kbd{M-@key{TAB}}, @kbd{M-@key{SPC}}, @kbd{C-M-d} and @kbd{C-M-l}. If you have this problem, you can either customize -your window manager to not block those keys, or ``rebind'' the +your window manager to not block those keys, or rebind the affected Emacs commands (@pxref{Customization}). @cindex input event diff --git a/doc/emacs/custom.texi b/doc/emacs/custom.texi index 43c61d769c7..0d11f12dfc0 100644 --- a/doc/emacs/custom.texi +++ b/doc/emacs/custom.texi @@ -28,7 +28,7 @@ Reference Manual}. 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''. + By changing them, you can redefine keys. * Init File:: How to write common customizations in the initialization file. @end menu @@ -728,7 +728,7 @@ maximum length of the kill ring (@pxref{Earlier Kills}); if you give @code{kill-ring-max} a string value, commands such as @kbd{C-y} (@code{yank}) will signal an error. On the other hand, some variables don't care about type; for instance, if a variable has one effect for -@code{nil} values and another effect for ``non-@code{nil}'' values, +@code{nil} values and another effect for non-@code{nil} values, then any value that is not the symbol @code{nil} induces the second effect, regardless of its type (by convention, we usually use the value @code{t}---a symbol which stands for ``true''---to specify a @@ -773,22 +773,22 @@ C-h v fill-column @key{RET} displays something like this: @example -fill-column is a variable defined in `C source code'. -fill-column's value is 70 +fill-column is a variable defined in ‘C source code’. +Its value is 70 -Automatically becomes buffer-local when set. -This variable is safe as a file local variable if its value -satisfies the predicate @code{integerp}. + Automatically becomes buffer-local when set. + This variable is safe as a file local variable if its value + satisfies the predicate ‘integerp’. Documentation: Column beyond which automatic line-wrapping should happen. -Interactively, you can set the local value with C-x f. +Interactively, you can set the buffer local value using C-x f. You can customize this variable. @end example @noindent -The line that says ``You can customize the variable'' indicates that +The line that says @samp{You can customize the variable} indicates that this variable is a user option. @kbd{C-h v} is not restricted to user options; it allows non-customizable variables too. @@ -1156,7 +1156,7 @@ the list. Here is an example: # End: @end example - Some ``variable names'' have special meanings in a local variables + Some names have special meanings in a local variables list: @itemize @@ -1761,7 +1761,7 @@ and @kbd{C-c p} in Texinfo mode: alphabetical characters are case-insensitive. In other words, @kbd{C-A} does the same thing as @kbd{C-a}, and @kbd{M-A} does the same thing as @kbd{M-a}. This concerns only alphabetical characters, -and does not apply to ``shifted'' versions of other keys; for +and does not apply to shifted versions of other keys; for instance, @kbd{C-@@} is not the same as @kbd{C-2}. A @key{Control}-modified alphabetical character is always considered @@ -1784,9 +1784,9 @@ to them. The modifier bits are labeled as @samp{s-}, @samp{H-} and @samp{A-} respectively. Even if your keyboard lacks these additional modifier keys, you can -enter it using @kbd{C-x @@}: @kbd{C-x @@ h} adds the ``hyper'' flag to -the next character, @kbd{C-x @@ s} adds the ``super'' flag, and -@kbd{C-x @@ a} adds the ``alt'' flag. For instance, @kbd{C-x @@ h +enter it using @kbd{C-x @@}: @kbd{C-x @@ h} adds the Hyper flag to +the next character, @kbd{C-x @@ s} adds the Super flag, and +@kbd{C-x @@ a} adds the Alt flag. For instance, @kbd{C-x @@ h C-a} is a way to enter @kbd{Hyper-Control-a}. (Unfortunately, there is no way to add two modifiers by using @kbd{C-x @@} twice for the same character, because the first one goes to work on the @kbd{C-x}.) @@ -1836,7 +1836,7 @@ key. @xref{Init Rebinding}, for examples of binding function keys. @cindex keypad - Many keyboards have a ``numeric keypad'' on the right hand side. + Many keyboards have a numeric keypad on the right hand side. The numeric keys in the keypad double up as cursor motion keys, toggled by a key labeled @samp{Num Lock}. By default, Emacs translates these keys to the corresponding keys in the main keyboard. @@ -1866,13 +1866,13 @@ prefix arguments. started out as names for certain @acronym{ASCII} control characters, used so often that they have special keys of their own. For instance, @key{TAB} was another name for @kbd{C-i}. Later, users found it -convenient to distinguish in Emacs between these keys and the ``same'' +convenient to distinguish in Emacs between these keys and the corresponding control characters typed with the @key{Ctrl} key. Therefore, on most modern terminals, they are no longer the same: @key{TAB} is different from @kbd{C-i}. Emacs can distinguish these two kinds of input if the keyboard does. -It treats the ``special'' keys as function keys named @code{tab}, +It treats the special keys as function keys named @code{tab}, @code{return}, @code{backspace}, @code{linefeed}, @code{escape}, and @code{delete}. These function keys translate automatically into the corresponding @acronym{ASCII} characters @emph{if} they have no @@ -1882,7 +1882,7 @@ need to pay attention to the distinction unless they care to. If you do not want to distinguish between (for example) @key{TAB} and @kbd{C-i}, make just one binding, for the @acronym{ASCII} character @key{TAB} (octal code 011). If you do want to distinguish, make one binding for -this @acronym{ASCII} character, and another for the ``function key'' @code{tab}. +this @acronym{ASCII} character, and another for the function key @code{tab}. With an ordinary @acronym{ASCII} terminal, there is no way to distinguish between @key{TAB} and @kbd{C-i} (and likewise for other such pairs), @@ -1937,7 +1937,7 @@ single click definition has run when the first click was received. This constrains what you can do with double clicks, but user interface designers say that this constraint ought to be followed in any case. A double click should do something similar to the single click, only -``more so''. The command for the double-click event should perform the +more so. The command for the double-click event should perform the extra work for the double click. If a double-click event has no binding, it changes to the @@ -1984,8 +1984,8 @@ or @samp{triple-}, which always precede @samp{drag-} or @samp{down-}. A frame includes areas that don't show text from the buffer, such as the mode line and the scroll bar. You can tell whether a mouse button -comes from a special area of the screen by means of dummy ``prefix -keys''. For example, if you click the mouse in the mode line, you get +comes from a special area of the screen by means of dummy prefix +keys. For example, if you click the mouse in the mode line, you get the prefix key @code{mode-line} before the ordinary mouse-button symbol. Thus, here is how to define the command for clicking the first button in a mode line to run @code{scroll-up-command}: diff --git a/doc/emacs/dired.texi b/doc/emacs/dired.texi index 4adb698450b..b00c974ef2c 100644 --- a/doc/emacs/dired.texi +++ b/doc/emacs/dired.texi @@ -14,7 +14,7 @@ optionally some of its subdirectories as well. You can use the normal Emacs commands to move around in this buffer, and special Dired commands to operate on the listed files. - The Dired buffer is ``read-only'', and inserting text in it is not + The Dired buffer is read-only, and inserting text in it is not allowed. Ordinary printing characters such as @kbd{d} and @kbd{x} are redefined for special Dired commands. Some Dired commands @dfn{mark} or @dfn{flag} the @dfn{current file} (that is, the file on the current @@ -924,7 +924,7 @@ from the name of the old file. The four regular-expression substitution commands effectively perform a search-and-replace on the selected file names. They read two arguments: a regular expression @var{from}, and a substitution -pattern @var{to}; they match each ``old'' file name against +pattern @var{to}; they match each old file name against @var{from}, and then replace the matching part with @var{to}. You can use @samp{\&} and @samp{\@var{digit}} in @var{to} to refer to all or part of what the pattern matched in the old file name, as in @@ -1262,7 +1262,7 @@ and erases all flags and marks. @findex wdired-change-to-wdired-mode Wdired is a special mode that allows you to perform file operations by editing the Dired buffer directly (the ``W'' in ``Wdired'' stands -for ``writable''.) To enter Wdired mode, type @kbd{C-x C-q} +for ``writable''). To enter Wdired mode, type @kbd{C-x C-q} (@code{dired-toggle-read-only}) while in a Dired buffer. Alternatively, use the @samp{Immediate / Edit File Names} menu item. @@ -1307,7 +1307,7 @@ buffer containing image-dired, corresponding to the marked files. You can also enter Image-Dired directly by typing @kbd{M-x image-dired}. This prompts for a directory; specify one that has image files. This creates thumbnails for all the images in that -directory, and displays them all in the ``thumbnail buffer''. This +directory, and displays them all in the thumbnail buffer. This takes a long time if the directory contains many image files, and it asks for confirmation if the number of image files exceeds @code{image-dired-show-all-from-dir-max-files}. @@ -1348,9 +1348,9 @@ with a certain tag, you can use @kbd{C-t d} to view them. You can also tag a file directly from the thumbnail buffer by typing @kbd{t t} and you can remove a tag by typing @kbd{t r}. There is also -a special ``tag'' called ``comment'' for each file (it is not a tag in +a special tag called ``comment'' for each file (it is not a tag in the exact same sense as the other tags, it is handled slightly -different). That is used to enter a comment or description about the +differently). That is used to enter a comment or description about the image. You comment a file from the thumbnail buffer by typing @kbd{c}. You will be prompted for a comment. Type @kbd{C-t c} to add a comment from Dired (@code{image-dired-dired-comment-files}). @@ -1375,7 +1375,7 @@ the directory already exists. @findex dired-do-isearch @findex dired-do-isearch-regexp The command @kbd{M-s a C-s} (@code{dired-do-isearch}) begins a -``multi-file'' incremental search on the marked files. If a search +multi-file incremental search on the marked files. If a search fails at the end of a file, typing @kbd{C-s} advances to the next marked file and repeats the search; at the end of the last marked file, the search wraps around to the first marked file. The command @@ -1425,21 +1425,21 @@ will operate on the selected files. @findex dired-compare-directories The command @kbd{M-x dired-compare-directories} is used to compare the current Dired buffer with another directory. It marks all the files -that are ``different'' between the two directories. It puts these marks +that differ between the two directories. It puts these marks in all Dired buffers where these files are listed, which of course includes the current buffer. The default comparison method (used if you type @key{RET} at the -prompt) is to compare just the file names---each file name that does -not appear in the other directory is ``different''. You can specify +prompt) is to compare just the file names---file names differ if +they do not appear in the other directory. You can specify more stringent comparisons by entering a Lisp expression, which can refer to the variables @code{size1} and @code{size2}, the respective file sizes; @code{mtime1} and @code{mtime2}, the last modification times in seconds, as floating point numbers; and @code{fa1} and @code{fa2}, the respective file attribute lists (as returned by the function @code{file-attributes}). This expression is evaluated for -each pair of like-named files, and if the expression's value is -non-@code{nil}, those files are considered ``different''. +each pair of like-named files, and files differ if the expression's +value is non-@code{nil}. For instance, the sequence @code{M-x dired-compare-directories @key{RET} (> mtime1 mtime2) @key{RET}} marks files newer in this @@ -1448,7 +1448,7 @@ directory than in this one. It also marks files with no counterpart, in both directories, as always. @cindex drag and drop, Dired - On the X Window System, Emacs supports the ``drag and drop'' + On the X Window System, Emacs supports the drag and drop protocol. You can drag a file object from another program, and drop it onto a Dired buffer; this either moves, copies, or creates a link to the file in that directory. Precisely which action is taken is diff --git a/doc/emacs/display.texi b/doc/emacs/display.texi index 92b0002990f..7b90e19991b 100644 --- a/doc/emacs/display.texi +++ b/doc/emacs/display.texi @@ -47,18 +47,18 @@ the text is displayed. displays only a portion of it. @dfn{Scrolling} commands change which portion of the buffer is displayed. - Scrolling ``forward'' or ``up'' advances the portion of the buffer + Scrolling forward or up advances the portion of the buffer displayed in the window; equivalently, it moves the buffer text -upwards relative to the window. Scrolling ``backward'' or ``down'' +upwards relative to the window. Scrolling backward or down displays an earlier portion of the buffer, and moves the text downwards relative to the window. - In Emacs, scrolling ``up'' or ``down'' refers to the direction that + In Emacs, scrolling up or down refers to the direction that the text moves in the window, @emph{not} the direction that the window moves relative to the text. This terminology was adopted by Emacs before the modern meaning of ``scrolling up'' and ``scrolling down'' became widespread. Hence, the strange result that @key{PageDown} -scrolls ``up'' in the Emacs sense. +scrolls up in the Emacs sense. The portion of a buffer displayed in a window always contains point. If you move point past the bottom or top of the window, scrolling @@ -468,7 +468,7 @@ and visits it with View mode enabled. @cindex synchronizing windows @dfn{Follow mode} is a minor mode that makes two windows, both -showing the same buffer, scroll as a single tall ``virtual window''. +showing the same buffer, scroll as a single tall virtual window. To use Follow mode, go to a frame with just one window, split it into two side-by-side windows using @kbd{C-x 3}, and then type @kbd{M-x follow-mode}. From then on, you can edit the buffer in either of the @@ -637,7 +637,7 @@ This face is used to highlight the current Isearch match This face is used to highlight the current Query Replace match (@pxref{Replace}). @item lazy-highlight -This face is used to highlight ``lazy matches'' for Isearch and Query +This face is used to highlight lazy matches for Isearch and Query Replace (matches other than the current one). @item region This face is used for displaying an active region (@pxref{Mark}). @@ -654,7 +654,7 @@ Whitespace}). The face for displaying control characters and escape sequences (@pxref{Text Display}). @item nobreak-space -The face for displaying ``no-break'' space characters (@pxref{Text +The face for displaying no-break space characters (@pxref{Text Display}). @end table @@ -667,7 +667,7 @@ frame: @cindex faces for mode lines This face is used for the mode line of the currently selected window, and for menu bars when toolkit menus are not used. By default, it's -drawn with shadows for a ``raised'' effect on graphical displays, and +drawn with shadows for a raised effect on graphical displays, and drawn as the inverse of the default face on non-windowed terminals. @item mode-line-inactive @cindex mode-line-inactive face @@ -1073,16 +1073,16 @@ variable @code{fringe-mode}. The most common use of the fringes is to indicate a continuation line (@pxref{Continuation Lines}). When one line of text is split into multiple screen lines, the left fringe shows a curving arrow for -each screen line except the first, indicating that ``this is not the -real beginning''. The right fringe shows a curving arrow for each -screen line except the last, indicating that ``this is not the real -end''. If the line's direction is right-to-left (@pxref{Bidirectional +each screen line except the first, indicating that this is not the +real beginning. The right fringe shows a curving arrow for each +screen line except the last, indicating that this is not the real +end. If the line's direction is right-to-left (@pxref{Bidirectional Editing}), the meanings of the curving arrows in the fringes are swapped. The fringes indicate line truncation (@pxref{Line Truncation}) with -short horizontal arrows meaning ``there's more text on this line which -is scrolled horizontally out of view''. Clicking the mouse on one of +short horizontal arrows meaning there's more text on this line which +is scrolled horizontally out of view. Clicking the mouse on one of the arrows scrolls the display horizontally in the direction of the arrow. @@ -1145,8 +1145,8 @@ setting the buffer-local variable @code{show-trailing-whitespace} to @code{trailing-whitespace}. This feature does not apply when point is at the end of the line -containing the whitespace. Strictly speaking, that is ``trailing -whitespace'' nonetheless, but displaying it specially in that case +containing the whitespace. Strictly speaking, that is trailing +whitespace nonetheless, but displaying it specially in that case looks ugly while you are typing in new text. In this special case, the location of point is enough to show you that the spaces are present. @@ -1178,7 +1178,7 @@ indicate-empty-lines t)}. @findex whitespace-mode @vindex whitespace-style Whitespace mode is a buffer-local minor mode that lets you -``visualize'' many kinds of whitespace in the buffer, by either +visualize many kinds of whitespace in the buffer, by either drawing the whitespace characters with a special face or displaying them as special glyphs. To toggle this mode, type @kbd{M-x whitespace-mode}. The kinds of whitespace visualized are determined @@ -1358,7 +1358,7 @@ the mail indicator prominent. Use @code{display-time-mail-file} to specify the mail file to check, or set @code{display-time-mail-directory} to specify the directory to check for incoming mail (any nonempty regular file in the directory is -considered as ``newly arrived mail''). +considered to be newly arrived mail). @cindex battery status (on mode line) @findex display-battery-mode @@ -1496,8 +1496,8 @@ displayed are shown as their @acronym{ASCII} approximations @samp{`}, @vindex visible-cursor On a text terminal, the cursor's appearance is controlled by the terminal, largely out of the control of Emacs. Some terminals offer -two different cursors: a ``visible'' static cursor, and a ``very -visible'' blinking cursor. By default, Emacs uses the very visible +two different cursors: a visible static cursor, and a very +visible blinking cursor. By default, Emacs uses the very visible cursor, and switches to it when you start or resume Emacs. If the variable @code{visible-cursor} is @code{nil} when Emacs starts or resumes, it uses the normal cursor. @@ -1537,7 +1537,7 @@ altogether, change the variable @code{blink-cursor-mode} to @code{nil} @noindent to your init file. Alternatively, you can change how the cursor -looks when it ``blinks off'' by customizing the list variable +looks when it blinks off by customizing the list variable @code{blink-cursor-alist}. Each element in the list should have the form @code{(@var{on-type} . @var{off-type})}; this means that if the cursor is displayed as @var{on-type} when it blinks on (where @@ -1546,7 +1546,7 @@ displayed as @var{off-type} when it blinks off. @vindex x-stretch-cursor @cindex wide block cursor - Some characters, such as tab characters, are ``extra wide''. When + Some characters, such as tab characters, are extra wide. When the cursor is positioned over such a character, it is normally drawn with the default character width. You can make the cursor stretch to cover wide characters, by changing the variable @@ -1671,14 +1671,14 @@ there is something to echo. @xref{Echo Area}. On graphical displays, Emacs displays the mouse pointer as an hourglass if Emacs is busy. To disable this feature, set the variable @code{display-hourglass} to @code{nil}. The variable -@code{hourglass-delay} determines the number of seconds of ``busy -time'' before the hourglass is shown; the default is 1. +@code{hourglass-delay} determines the number of seconds of busy +time before the hourglass is shown; the default is 1. @vindex make-pointer-invisible If the mouse pointer lies inside an Emacs frame, Emacs makes it invisible each time you type a character to insert text, to prevent it from obscuring the text. (To be precise, the hiding occurs when you -type a ``self-inserting'' character. @xref{Inserting Text}.) Moving +type a self-inserting character. @xref{Inserting Text}.) Moving the mouse pointer makes it visible again. To disable this feature, set the variable @code{make-pointer-invisible} to @code{nil}. diff --git a/doc/emacs/emacs.texi b/doc/emacs/emacs.texi index ec82a071001..8275da91a06 100644 --- a/doc/emacs/emacs.texi +++ b/doc/emacs/emacs.texi @@ -160,7 +160,7 @@ Fundamental Editing Commands * Help:: Commands for asking Emacs about its commands. Important Text-Changing Commands -* Mark:: The mark: how to delimit a ``region'' of text. +* Mark:: The mark: how to delimit a region of text. * Killing:: Killing (cutting) and yanking (copying) text. * Registers:: Saving a text string or a location in the buffer. * Display:: Controlling what text is displayed. @@ -172,7 +172,7 @@ Major Structures of Emacs * Files:: All about handling files. * Buffers:: Multiple buffers; editing several files at once. * Windows:: Viewing multiple pieces of text in one frame. -* Frames:: Using multiple ``windows'' on your display. +* Frames:: Using multiple windows on your display. * International:: Using non-@acronym{ASCII} character sets. Advanced Features @@ -200,7 +200,7 @@ Advanced Features @end ifnottex * Editing Binary Files:: Editing binary files with Hexl mode. * Saving Emacs Sessions:: Saving Emacs state from one session to the next. -* Recursive Edit:: Performing edits while ``within another command''. +* Recursive Edit:: Performing edits while within another command. * Hyperlinking:: Following links in buffers. * Amusements:: Various games and hacks. * Packages:: Installing additional features. @@ -301,7 +301,7 @@ Help * Language Help:: Help relating to international language support. * Misc Help:: Other help commands. * Help Files:: Commands to display auxiliary help files. -* Help Echo:: Help on active text and tooltips (``balloon help''). +* Help Echo:: Help on active text and tooltips. The Mark and the Region @@ -337,7 +337,7 @@ Yanking * Earlier Kills:: Yanking something killed some time ago. * Appending Kills:: Several kills in a row all yank together. -``Cut and Paste'' Operations on Graphical Displays +Cut and Paste Operations on Graphical Displays * Clipboard:: How Emacs uses the system clipboard. * Primary Selection:: The temporarily selected text selection. @@ -464,7 +464,7 @@ Saving Files * Customize Save:: Customizing the saving of files. * Interlocking:: How Emacs protects against simultaneous editing of one file by two users. -* File Shadowing:: Copying files to ``shadows'' automatically. +* File Shadowing:: Copying files to shadows automatically. * Time Stamps:: Emacs can update time stamps on saved files. Backup Files @@ -597,7 +597,7 @@ Commands for Human Languages * TeX Mode:: Editing TeX and LaTeX files. * HTML Mode:: Editing HTML and SGML files. * Nroff Mode:: Editing input to the nroff formatter. -* Enriched Text:: Editing text ``enriched'' with fonts, colors, etc. +* Enriched Text:: Editing text enriched with fonts, colors, etc. * Text Based Tables:: Commands for editing text-based tables. * Two-Column:: Splitting text columns into separate windows. @@ -638,7 +638,7 @@ Enriched Text * Enriched Indentation:: Changing the left and right margins. * Enriched Justification:: Centering, setting text flush with the left or right margin, etc. -* Enriched Properties:: The ``special'' text properties submenu. +* Enriched Properties:: The special text properties submenu. @c The automatic texinfo menu update inserts some duplicate items here @c (faces, colors, indentation, justification, properties), because @@ -895,7 +895,7 @@ Editing Pictures * Basic Picture:: Basic concepts and simple commands of Picture Mode. * Insert in Picture:: Controlling direction of cursor motion - after ``self-inserting'' characters. + after self-inserting characters. * Tabs in Picture:: Various features for tab stops and indentation. * Rectangles in Picture:: Clearing and superimposing rectangles. @end ifnottex @@ -1092,7 +1092,7 @@ Customization 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. + By changing them, you can redefine keys. * Init File:: How to write common customizations in the initialization file. diff --git a/doc/emacs/emerge-xtra.texi b/doc/emacs/emerge-xtra.texi index 25bbcaae396..836b27c5002 100644 --- a/doc/emacs/emerge-xtra.texi +++ b/doc/emacs/emerge-xtra.texi @@ -151,7 +151,7 @@ input. The mode line indicates Auto Advance mode with @samp{A}. If Skip Prefers mode is in effect, the @kbd{n} and @kbd{p} commands skip over differences in states ``prefer-A'' and ``prefer-B'' (@pxref{State of Difference}). Thus you see only differences for -which neither version is presumed ``correct''. The mode line +which neither version is presumed correct. The mode line indicates Skip Prefers mode with @samp{S}. This mode is only relevant when there is an ancestor. @@ -183,7 +183,7 @@ produces this state; the mode line indicates it with @samp{B}. The difference is showing the A or the B state by default, because you haven't made a choice. All differences start in the default-A state (and thus the merge buffer is a copy of the A buffer), except those for -which one alternative is ``preferred'' (see below). +which one alternative is preferred (see below). When you select a difference, its state changes from default-A or default-B to plain A or B@. Thus, the selected difference never has diff --git a/doc/emacs/entering.texi b/doc/emacs/entering.texi index fc9ea38fdcd..afe2b115a93 100644 --- a/doc/emacs/entering.texi +++ b/doc/emacs/entering.texi @@ -100,7 +100,7 @@ display them initially. Kill Emacs (@code{save-buffers-kill-terminal}). @item C-z On a text terminal, suspend Emacs; on a graphical display, -``minimize'' the selected frame (@code{suspend-emacs}). +iconify or minimize the selected frame (@code{suspend-emacs}). @end table @kindex C-x C-c @@ -116,7 +116,7 @@ subprocesses are still running, since killing Emacs will also kill the subprocesses (@pxref{Shell}). @kbd{C-x C-c} behaves specially if you are using Emacs as a server. -If you type it from a ``client frame'', it closes the client +If you type it from a client frame, it closes the client connection. @xref{Emacs Server}. Emacs can, optionally, record certain session information when you diff --git a/doc/emacs/files.texi b/doc/emacs/files.texi index 5985d8b840e..4bd2553b82f 100644 --- a/doc/emacs/files.texi +++ b/doc/emacs/files.texi @@ -55,8 +55,8 @@ the file name, using the minibuffer (@pxref{Minibuffer File}). history commands (@pxref{Minibuffer}). Note that file name completion ignores file names whose extensions appear in the variable @code{completion-ignored-extensions} (@pxref{Completion Options}). -Note also that most commands use ``permissive completion with -confirmation'' for reading file names: you are allowed to submit a +Note also that most commands use permissive completion with +confirmation for reading file names: you are allowed to submit a nonexistent file name, but if you type @key{RET} immediately after completing up to a nonexistent file name, Emacs prints @samp{[Confirm]} and you must type a second @key{RET} to confirm. @@ -96,9 +96,9 @@ minibuffer, with a directory omitted, specifies the file @file{/u/rms/gnu/new/foo}. When typing a file name into the minibuffer, you can make use of a -couple of shortcuts: a double slash is interpreted as ``ignore -everything before the second slash in the pair'', and @samp{~/} is -interpreted as your home directory. @xref{Minibuffer File}. +couple of shortcuts: a double slash ignores everything before the +second slash in the pair, and @samp{~/} is your home directory. +@xref{Minibuffer File}. @cindex environment variables in file names @cindex expansion of environment variables @@ -232,7 +232,7 @@ after the directory part; this is convenient if you made a slight error in typing the name. @vindex find-file-run-dired - If you ``visit'' a file that is actually a directory, Emacs invokes + If you visit a file that is actually a directory, Emacs invokes Dired, the Emacs directory browser. @xref{Dired}. You can disable this behavior by setting the variable @code{find-file-run-dired} to @code{nil}; in that case, it is an error to try to visit a directory. @@ -274,13 +274,13 @@ new frame, or selects any existing frame showing the specified file. On graphical displays, there are two additional methods for visiting files. Firstly, when Emacs is built with a suitable GUI toolkit, commands invoked with the mouse (by clicking on the menu bar or tool -bar) use the toolkit's standard ``File Selection'' dialog instead of +bar) use the toolkit's standard file selection dialog instead of prompting for the file name in the minibuffer. On GNU/Linux and Unix platforms, Emacs does this when built with GTK, LessTif, and Motif toolkits; on MS-Windows and Mac, the GUI version does that by default. For information on how to customize this, see @ref{Dialog Boxes}. - Secondly, Emacs supports ``drag and drop'': dropping a file into an + Secondly, Emacs supports drag and drop: dropping a file into an ordinary Emacs window visits the file using that window. As an exception, dropping a file into a window displaying a Dired buffer moves or copies the file into the displayed directory. For details, @@ -288,7 +288,7 @@ see @ref{Drag and Drop}, and @ref{Misc Dired Features}. On text-mode terminals and on graphical displays when Emacs was built without a GUI toolkit, you can visit files via the menu-bar -``File'' menu, which has a ``Visit New File'' item. +@samp{File} menu, which has a @samp{Visit New File} item. Each time you visit a file, Emacs automatically scans its contents to detect what character encoding and end-of-line convention it uses, @@ -340,7 +340,7 @@ that was visited in the buffer. * Customize Save:: Customizing the saving of files. * Interlocking:: How Emacs protects against simultaneous editing of one file by two users. -* Shadowing: File Shadowing. Copying files to ``shadows'' automatically. +* Shadowing: File Shadowing. Copying files to shadows automatically. * Time Stamps:: Emacs can update time stamps on saved files. @end menu @@ -443,7 +443,7 @@ minibuffer. Then it marks the buffer as visiting that file name, and changes the buffer name correspondingly. @code{set-visited-file-name} does not save the buffer in the newly visited file; it just alters the records inside Emacs in case you do save later. It also marks the -buffer as ``modified'' so that @kbd{C-x C-s} in that buffer +buffer as modified so that @kbd{C-x C-s} in that buffer @emph{will} save. @kindex C-x C-w @@ -902,7 +902,7 @@ way that, if the file was edited only slightly, you will be at approximately the same part of the text as before. But if you have made major changes, point may end up in a totally different location. - Reverting marks the buffer as ``not modified''. It also clears the + Reverting marks the buffer as not modified. It also clears the buffer's undo history (@pxref{Undo}). Thus, the reversion cannot be undone---if you change your mind yet again, you can't use the undo commands to bring the reverted changes back. @@ -941,7 +941,7 @@ buffers, type @kbd{M-x global-auto-revert-mode} to enable Global Auto-Revert mode. These minor modes do not check or revert remote files, because that is usually too slow. - One use of Auto-Revert mode is to ``tail'' a file such as a system + One use of Auto-Revert mode is to tail a file such as a system log, so that changes made to that file by other programs are continuously displayed. To do this, just move the point to the end of the buffer, and it will stay there as the file contents change. @@ -1167,7 +1167,7 @@ implies the effect of @code{find-file-existing-other-name}. @cindex directory name abbreviation @vindex directory-abbrev-alist Sometimes, a directory is ordinarily accessed through a symbolic -link, and you may want Emacs to preferentially show its ``linked'' +link, and you may want Emacs to preferentially show its linked name. To do this, customize @code{directory-abbrev-alist}. Each element in this list should have the form @code{(@var{from} . @var{to})}, which means to replace @var{from} with @var{to} whenever @@ -1255,8 +1255,8 @@ this, it runs the program specified by The command @kbd{M-x delete-directory} prompts for a directory name using the minibuffer, and deletes the directory if it is empty. If the directory is not empty, you will be asked whether you want to -delete it recursively. On systems that have a ``Trash'' (or ``Recycle -Bin'') feature, you can make this command move the specified directory +delete it recursively. On systems that have a Trash (or Recycle +Bin) feature, you can make this command move the specified directory to the Trash instead of deleting it outright, by changing the variable @code{delete-by-moving-to-trash} to @code{t}. @xref{Misc File Ops}, for more information about using the Trash. @@ -1325,7 +1325,7 @@ prefix argument turns that off. You can use @kbd{M-x smerge-mode} to turn on Smerge mode, a minor mode for editing output from the @command{diff3} program. This is typically the result of a failed merge from a version control system -``update'' outside VC, due to conflicting changes to a file. Smerge +update outside VC, due to conflicting changes to a file. Smerge mode provides commands to resolve conflicts by selecting specific changes. @@ -1364,10 +1364,10 @@ contents of the hunk. read-only, you need to make it writable first. @xref{Misc Buffer}.) Whenever you change a hunk, Diff mode attempts to automatically correct the line numbers in the hunk headers, to ensure that the patch -remains ``correct''. To disable automatic line number correction, +remains correct. To disable automatic line number correction, change the variable @code{diff-update-on-the-fly} to @code{nil}. - Diff mode treats each hunk as an ``error message'', similar to + Diff mode treats each hunk as an error message, similar to Compilation mode. Thus, you can use commands such as @kbd{C-x `} to visit the corresponding source locations. @xref{Compilation Mode}. @@ -1585,7 +1585,7 @@ rename-file}. @xref{VC Delete/Rename}. @cindex hard links (creation) @kbd{M-x add-name-to-file} adds an additional name to an existing file without removing its old name. The new name is created as a -``hard link'' to the existing file. The new name must belong on the +hard link to the existing file. The new name must belong on the same file system that the file is on. On MS-Windows, this command works only if the file resides in an NTFS file system. On MS-DOS, it works by copying the file. @@ -1612,7 +1612,7 @@ mark (@pxref{Mark Ring}). @findex insert-file-literally @kbd{M-x insert-file-literally} is like @kbd{M-x insert-file}, -except the file is inserted ``literally'': it is treated as a sequence +except the file is inserted literally: it is treated as a sequence of @acronym{ASCII} characters with no special encoding or conversion, similar to the @kbd{M-x find-file-literally} command (@pxref{Visiting}). @@ -2008,7 +2008,7 @@ enable ImageMagick for all possible image types, change @code{imagemagick-types-inhibit} lists the image types which should never be rendered using ImageMagick, regardless of the value of @code{imagemagick-enabled-types} (the default list includes types like -@code{C} and @code{HTML}, which ImageMagick can render as an ``image'' +@code{C} and @code{HTML}, which ImageMagick can render as an image but Emacs should not). To disable ImageMagick entirely, change @code{imagemagick-types-inhibit} to @code{t}. @@ -2055,7 +2055,7 @@ files in a fileset, and @kbd{M-x filesets-close} to close them. Use a fileset. These commands are also available from the @samp{Filesets} menu, where each existing fileset is represented by a submenu. - @xref{Version Control}, for a different concept of ``filesets'': + @xref{Version Control}, for a different concept of filesets: groups of files bundled together for version control operations. Filesets of that type are unnamed, and do not persist across Emacs sessions. diff --git a/doc/emacs/fixit.texi b/doc/emacs/fixit.texi index 953b22f7d54..993f0dce1cc 100644 --- a/doc/emacs/fixit.texi +++ b/doc/emacs/fixit.texi @@ -286,7 +286,7 @@ messages. @xref{Sending Mail}. When one of these commands encounters what appears to be an incorrect word, it asks you what to do. It usually displays a list of -numbered ``near-misses''---words that are close to the incorrect word. +numbered @dfn{near-misses}---words that are close to the incorrect word. Then you must type a single-character response. Here are the valid responses: @@ -331,7 +331,7 @@ file. @item l @var{word} @key{RET} Look in the dictionary for words that match @var{word}. These words -become the new list of ``near-misses''; you can select one of them as +become the new list of near-misses; you can select one of them as the replacement by typing a digit. You can use @samp{*} in @var{word} as a wildcard. diff --git a/doc/emacs/fortran-xtra.texi b/doc/emacs/fortran-xtra.texi index 155e998180c..870bfcd2169 100644 --- a/doc/emacs/fortran-xtra.texi +++ b/doc/emacs/fortran-xtra.texi @@ -13,9 +13,9 @@ @cindex Fortran 77 and Fortran 90, 95, 2003, 2008 @findex f90-mode @findex fortran-mode - Fortran mode is meant for editing ``fixed form'' (and also ``tab -format'') source code (normally Fortran 77). For editing more modern -``free form'' source code (Fortran 90, 95, 2003, 2008), use F90 mode + Fortran mode is meant for editing fixed form (and also tab +format) source code (normally Fortran 77). For editing more modern +free-form source code (Fortran 90, 95, 2003, 2008), use F90 mode (@code{f90-mode}). Emacs normally uses Fortran mode for files with extension @samp{.f}, @samp{.F} or @samp{.for}, and F90 mode for the extensions @samp{.f90}, @samp{.f95}, @samp{.f03} and @samp{.f08}. @@ -70,7 +70,7 @@ command runs the hook @code{fortran-mode-hook}. @subsection Motion Commands In addition to the normal commands for moving by and operating on -``defuns'' (Fortran subprograms---functions and subroutines, as well +defuns (Fortran subprograms---functions and subroutines, as well as modules for F90 mode, using the commands @code{fortran-end-of-subprogram} and @code{fortran-beginning-of-subprogram}), Fortran mode provides special commands to move by statements and other program units. @@ -207,8 +207,8 @@ the Fortran standard counts from 1.) The variable @code{fortran-continuation-string} specifies what character to put in column 5. A line that starts with a tab character followed by any digit except @samp{0} is also a continuation line. We call this style of -continuation @dfn{tab format}. (Fortran 90 introduced ``free form'', -with another style of continuation lines). +continuation @dfn{tab format}. (Fortran 90 introduced free-form +continuation lines.) @vindex indent-tabs-mode @r{(Fortran mode)} @vindex fortran-analyze-depth @@ -499,7 +499,7 @@ will confuse font-lock.) @table @kbd @item C-c C-r -Display a ``column ruler'' momentarily above the current line +Display a column ruler momentarily above the current line (@code{fortran-column-ruler}). @item C-c C-w Split the current window horizontally temporarily so that it is diff --git a/doc/emacs/frames.texi b/doc/emacs/frames.texi index 2ae7300e897..22f9f0eb5e5 100644 --- a/doc/emacs/frames.texi +++ b/doc/emacs/frames.texi @@ -7,7 +7,7 @@ @cindex frames When Emacs is started on a graphical display, e.g., on the X Window -System, it occupies a graphical system-level ``window''. In this +System, it occupies a graphical system-level display region. In this manual, we call this a @dfn{frame}, reserving the word ``window'' for the part of the frame used for displaying a buffer. A frame initially contains one window, but it can be subdivided into multiple windows @@ -28,7 +28,7 @@ displays (@pxref{Exiting}). To close just the selected frame, type This chapter describes Emacs features specific to graphical displays (particularly mouse commands), and features for managing multiple frames. On text terminals, many of these features are unavailable. -However, it is still possible to create multiple ``frames'' on text +However, it is still possible to create multiple frames on text terminals; such frames are displayed one at a time, filling the entire terminal screen (@pxref{Non-Window Terminals}). It is also possible to use the mouse on some text terminals (@pxref{Text-Only Mouse}, for @@ -110,7 +110,7 @@ the window and sets the cursor position. @cindex mouse, dragging @findex mouse-set-region - Holding down @kbd{Mouse-1} and ``dragging'' the mouse over a stretch + Holding down @kbd{Mouse-1} and dragging the mouse over a stretch of text activates the region around that text (@code{mouse-set-region}), placing the mark where you started holding down the mouse button, and point where you release it (@pxref{Mark}). @@ -197,7 +197,7 @@ deactivating the mark. @xref{Shift Selection}. @vindex mouse-wheel-follow-mouse @vindex mouse-wheel-scroll-amount @vindex mouse-wheel-progressive-speed - Some mice have a ``wheel'' which can be used for scrolling. Emacs + Some mice have a wheel which can be used for scrolling. Emacs supports scrolling windows with the mouse wheel, by default, on most graphical displays. To toggle this feature, use @kbd{M-x mouse-wheel-mode}. The variables @code{mouse-wheel-follow-mouse} and @@ -217,7 +217,7 @@ also copied to the kill ring. @item Double-Mouse-1 Select the text around the word which you click on. -Double-clicking on a character with ``symbol'' syntax (such as +Double-clicking on a character with symbol syntax (such as underscore, in C mode) selects the symbol surrounding that character. Double-clicking on a character with open- or close-parenthesis syntax selects the parenthetical grouping which that character starts or @@ -388,9 +388,9 @@ boundary to the left or right. The prefix key @kbd{C-x 5} is analogous to @kbd{C-x 4}. Whereas each @kbd{C-x 4} command pops up a buffer in a different window in the selected frame (@pxref{Pop Up Window}), the @kbd{C-x 5} commands use a -different frame. If an existing visible or iconified (``minimized'') +different frame. If an existing visible or iconified (minimized) frame already displays the requested buffer, that frame is raised and -deiconified (``un-minimized''); otherwise, a new frame is created on +deiconified (un-minimized); otherwise, a new frame is created on the current display terminal. The various @kbd{C-x 5} commands differ in how they find or create the @@ -444,7 +444,7 @@ error if there is only one frame. @item C-z @kindex C-z @r{(X windows)} @findex suspend-frame -Minimize (or ``iconify'') the selected Emacs frame +Minimize (or iconify) the selected Emacs frame (@code{suspend-frame}). @xref{Exiting}. @item C-x 5 o @@ -468,7 +468,7 @@ maximized, it fills the screen. @kindex <F11> @findex toggle-frame-fullscreen Toggle fullscreen mode for the current frame. (The difference -between ``fullscreen'' and ``maximized'' is normally that the former +between fullscreen and maximized is normally that the former hides window manager decorations, giving slightly more screen space to Emacs itself.) @end table @@ -476,7 +476,7 @@ Emacs itself.) @vindex frame-resize-pixelwise Note that with some window managers you may have to customize the variable @code{frame-resize-pixelwise} to a non-@code{nil} value in -order to make a frame truly ``maximized'' or ``fullscreen''. This +order to make a frame truly maximized or fullscreen. This variable, when set to a non-@code{nil} value, in general allows resizing frames at pixel resolution, rather than in integral multiples of lines and columns. @@ -485,7 +485,7 @@ of lines and columns. frame. However, it will refuse to delete the last frame in an Emacs session, to prevent you from losing the ability to interact with the Emacs session. Note that when Emacs is run as a daemon (@pxref{Emacs -Server}), there is always a ``virtual frame'' that remains after all +Server}), there is always a virtual frame that remains after all the ordinary, interactive frames are deleted. In this case, @kbd{C-x 5 0} can delete the last interactive frame; you can use @command{emacsclient} to reconnect to the Emacs session. @@ -565,7 +565,7 @@ command can be helpful. It describes the character at point, and names the font that it's rendered in. @cindex fontconfig - On X, there are four different ways to express a ``font name''. The + On X, there are four different ways to express a font name. The first is to use a @dfn{Fontconfig pattern}. Fontconfig patterns have the following form: @@ -738,8 +738,8 @@ have. Normally you should use @samp{iso8859} for @var{registry} and @samp{1} for @var{encoding}. @end table - The fourth and final method of specifying a font is to use a ``font -nickname''. Certain fonts have shorter nicknames, which you can use + The fourth and final method of specifying a font is to use a font +nickname. Certain fonts have shorter nicknames, which you can use instead of a normal font specification. For instance, @samp{6x13} is equivalent to @@ -1138,8 +1138,8 @@ suppressed all dialog boxes with the variable @code{use-dialog-box}. @vindex x-gtk-file-dialog-help-text @cindex hidden files, in GTK+ file chooser @cindex help text, in GTK+ file chooser - When Emacs is compiled with GTK+ support, it uses the GTK+ ``file -chooser'' dialog. Emacs adds an additional toggle button to this + When Emacs is compiled with GTK+ support, it uses the GTK+ file +chooser dialog. Emacs adds an additional toggle button to this dialog, which you can use to enable or disable the display of hidden files (files starting with a dot) in that dialog. If you want this toggle to be activated by default, change the variable diff --git a/doc/emacs/glossary.texi b/doc/emacs/glossary.texi index 9101f1c1331..ef186723d6b 100644 --- a/doc/emacs/glossary.texi +++ b/doc/emacs/glossary.texi @@ -100,7 +100,7 @@ A base buffer is a buffer whose text is shared by an indirect buffer Some human languages, such as English, are written from left to right. Others, such as Arabic, are written from right to left. Emacs supports both of these forms, as well as any mixture of them---this -is ``bidirectional text''. @xref{Bidirectional Editing}. +is bidirectional text. @xref{Bidirectional Editing}. @item Bind To bind a key sequence means to give it a binding (q.v.). @@ -135,7 +135,7 @@ X}). Borders are not the same as fringes (q.v.). @item Buffer The buffer is the basic editing unit; one buffer corresponds to one text being edited. You normally have several buffers, but at any time you are -editing only one, the ``current buffer'', though several can be visible +editing only one, the current buffer, though several can be visible when you are using multiple windows or frames (q.v.). Most buffers are visiting (q.v.@:) some file. @xref{Buffers}. @@ -265,7 +265,7 @@ normally (but see @ref{Glossary---Truncation}) takes up more than one screen line when displayed. We say that the text line is continued, and all screen lines used for it after the first are called continuation lines. @xref{Continuation Lines}. A related Emacs feature is -``filling'' (q.v.). +filling (q.v.). @item Control Character A control character is a character that you type by holding down the @@ -285,7 +285,7 @@ The particular form of copyleft used by the GNU project is called the GNU General Public License. @xref{Copying}. @item @key{Ctrl} -The @key{Ctrl} or ``control'' key is what you hold down +The @key{Ctrl} or control key is what you hold down in order to enter a control character (q.v.). @xref{Glossary---C-}. @item Current Buffer @@ -367,8 +367,8 @@ Deletion means erasing text without copying it into the kill ring @anchor{Glossary---Deletion of Files} @item Deletion of Files Deleting a file means erasing it from the file system. -(Note that some systems use the concept of a ``trash can'', or ``recycle -bin'', to allow you to ``undelete'' files.) +(Note that some systems use the concept of a trash can, or recycle +bin, to allow you to undelete files.) @xref{Misc File Ops,Misc File Ops,Miscellaneous File Operations}. @item Deletion of Messages @@ -396,7 +396,7 @@ Variables}. @item Dired Dired is the Emacs facility that displays the contents of a file -directory and allows you to ``edit the directory'', performing +directory and allows you to edit the directory, performing operations on the files in the directory. @xref{Dired}. @item Disabled Command @@ -580,7 +580,7 @@ For more information, see @uref{http://fsf.org/, the FSF website}. @item Fringe On a graphical display (q.v.), there's a narrow portion of the frame (q.v.@:) between the text area and the window's border. These -``fringes'' are used to display symbols that provide information about +fringes are used to display symbols that provide information about the buffer text (@pxref{Fringes}). Emacs displays the fringe using a special face (q.v.@:) called @code{fringe}. @xref{Faces,fringe}. @@ -1076,7 +1076,7 @@ command, using @kbd{C-g} (or @kbd{C-@key{BREAK}} on MS-DOS). @xref{Quitting}. Quoting means depriving a character of its usual special significance. The most common kind of quoting in Emacs is with @kbd{C-q}. What constitutes special significance depends on the context and on -convention. For example, an ``ordinary'' character as an Emacs command +convention. For example, an ordinary character as an Emacs command inserts itself; so in this context, a special character is any character that does not normally insert itself (such as @key{DEL}, for example), and quoting it makes it insert itself as if it were not special. Not @@ -1121,7 +1121,7 @@ Many commands operate on the text of the region. @xref{Mark,Region}. @item Register Registers are named slots in which text, buffer positions, or rectangles can be saved for later use. @xref{Registers}. A related -Emacs feature is ``bookmarks'' (q.v.). +Emacs feature is bookmarks (q.v.). @anchor{Glossary---Regular Expression} @item Regular Expression diff --git a/doc/emacs/help.texi b/doc/emacs/help.texi index 69842500e92..0489325184e 100644 --- a/doc/emacs/help.texi +++ b/doc/emacs/help.texi @@ -72,7 +72,7 @@ inputs, but they all support @key{F1}.) * Language Help:: Help relating to international language support. * Misc Help:: Other help commands. * Help Files:: Commands to display auxiliary help files. -* Help Echo:: Help on active text and tooltips (``balloon help''). +* Help Echo:: Help on active text and tooltips. @end menu @iftex @@ -614,7 +614,7 @@ Project (@code{describe-gnu-project}). Display information about ordering printed copies of Emacs manuals (@code{view-order-manuals}). @item C-h C-n -Display the ``news'' file, which lists the new features in this +Display the news, which lists the new features in this version of Emacs (@code{view-emacs-news}). @item C-h C-o Display how to order or download the latest version of @@ -634,7 +634,7 @@ Emacs (@code{describe-no-warranty}). @cindex tooltips @cindex balloon help - In Emacs, stretches of ``active text'' (text that does something + In Emacs, stretches of active text (text that does something special in response to mouse clicks or @key{RET}) often have associated help text. This includes hyperlinks in Emacs buffers, as well as parts of the mode line. On graphical displays, as well as diff --git a/doc/emacs/indent.texi b/doc/emacs/indent.texi index b45839e664f..76dfa55211d 100644 --- a/doc/emacs/indent.texi +++ b/doc/emacs/indent.texi @@ -35,7 +35,7 @@ mode and related major modes, @key{TAB} normally inserts some combination of space and tab characters to advance point to the next tab stop (@pxref{Tab Stops}). For this purpose, the position of the first non-whitespace character on the preceding line is treated as an -additional tab stop, so you can use @key{TAB} to ``align'' point with +additional tab stop, so you can use @key{TAB} to align point with the preceding line. If the region is active (@pxref{Using Region}), @key{TAB} acts specially: it indents each line in the region so that its first non-whitespace character is aligned with the preceding line. @@ -98,7 +98,7 @@ argument, in which case do nothing. @kindex M-^ @findex delete-indentation Merge the previous and the current line (@code{delete-indentation}). -This ``joins'' the two lines cleanly, by replacing any indentation at +This joins the two lines cleanly, by replacing any indentation at the front of the current line, together with the line boundary, with a single space. @@ -123,7 +123,7 @@ that column number. @findex indent-rigidly @cindex remove indentation This command is used to change the indentation of all lines that begin -in the region, moving the affected lines as a ``rigid'' unit. +in the region, moving the affected lines as a rigid unit. If called with no argument, the command activates a transient mode for adjusting the indentation of the affected lines interactively. While diff --git a/doc/emacs/killing.texi b/doc/emacs/killing.texi index 7581f34ead0..d629349b983 100644 --- a/doc/emacs/killing.texi +++ b/doc/emacs/killing.texi @@ -306,7 +306,7 @@ e.g., @kbd{C-u 4 C-y} reinserts the fourth most recent kill. On graphical displays, @kbd{C-y} first checks if another application has placed any text in the system clipboard more recently than the last Emacs kill. If so, it inserts the clipboard's text instead. -Thus, Emacs effectively treats ``cut'' or ``copy'' clipboard +Thus, Emacs effectively treats cut or copy clipboard operations performed in other applications like Emacs kills, except that they are not recorded in the kill ring. @xref{Cut and Paste}, for details. @@ -358,34 +358,34 @@ So, to recover the text of the next-to-the-last kill, first use with the previous kill. @kbd{M-y} is allowed only after a @kbd{C-y} or another @kbd{M-y}. - You can understand @kbd{M-y} in terms of a ``last yank'' pointer which -points at an entry in the kill ring. Each time you kill, the ``last -yank'' pointer moves to the newly made entry at the front of the ring. -@kbd{C-y} yanks the entry which the ``last yank'' pointer points to. -@kbd{M-y} moves the ``last yank'' pointer to a different entry, and the + You can understand @kbd{M-y} in terms of a last-yank pointer which +points at an entry in the kill ring. Each time you kill, the last-yank +pointer moves to the newly made entry at the front of the ring. +@kbd{C-y} yanks the entry which the last-yank pointer points to. +@kbd{M-y} moves the last-yank pointer to a different entry, and the text in the buffer changes to match. Enough @kbd{M-y} commands can move the pointer to any entry in the ring, so you can get any entry into the buffer. Eventually the pointer reaches the end of the ring; the next @kbd{M-y} loops back around to the first entry again. - @kbd{M-y} moves the ``last yank'' pointer around the ring, but it does + @kbd{M-y} moves the last-yank pointer around the ring, but it does not change the order of the entries in the ring, which always runs from the most recent kill at the front to the oldest one still remembered. @kbd{M-y} can take a numeric argument, which tells it how many entries -to advance the ``last yank'' pointer by. A negative argument moves the +to advance the last-yank pointer by. A negative argument moves the pointer toward the front of the ring; from the front of the ring, it -moves ``around'' to the last entry and continues forward from there. +moves around to the last entry and continues forward from there. Once the text you are looking for is brought into the buffer, you can stop doing @kbd{M-y} commands and it will stay there. It's just a copy of the kill ring entry, so editing it in the buffer does not change -what's in the ring. As long as no new killing is done, the ``last -yank'' pointer remains at the same place in the kill ring, so repeating +what's in the ring. As long as no new killing is done, the last-yank +pointer remains at the same place in the kill ring, so repeating @kbd{C-y} will yank another copy of the same previous kill. When you call @kbd{C-y} with a numeric argument, that also sets the -``last yank'' pointer to the entry that it yanks. +last-yank pointer to the entry that it yanks. @node Appending Kills @subsection Appending Kills @@ -445,7 +445,7 @@ be yanked back in one place. append to the text that @kbd{M-w} copied into the kill ring. @node Cut and Paste -@section ``Cut and Paste'' Operations on Graphical Displays +@section Cut and Paste Operations on Graphical Displays @cindex cut @cindex copy @cindex paste @@ -476,7 +476,7 @@ different data type by customizing @code{x-select-request-type}. @cindex clipboard The @dfn{clipboard} is the facility that most graphical applications -use for ``cutting and pasting''. When the clipboard exists, the kill +use for cutting and pasting. When the clipboard exists, the kill and yank commands in Emacs make use of it. When you kill some text with a command such as @kbd{C-w} @@ -493,7 +493,7 @@ losing the old clipboard data---at the risk of high memory consumption if that data turns out to be large. Yank commands, such as @kbd{C-y} (@code{yank}), also use the -clipboard. If another application ``owns'' the clipboard---i.e., if +clipboard. If another application owns the clipboard---i.e., if you cut or copied text there more recently than your last kill command in Emacs---then Emacs yanks from the clipboard instead of the kill ring. @@ -512,7 +512,7 @@ change the variable @code{x-select-enable-clipboard} to @code{nil}. @vindex x-select-enable-clipboard-manager Many X desktop environments support a feature called the @dfn{clipboard manager}. If you exit Emacs while it is the current -``owner'' of the clipboard data, and there is a clipboard manager +owner of the clipboard data, and there is a clipboard manager running, Emacs transfers the clipboard data to the clipboard manager so that it is not lost. In some circumstances, this may cause a delay when exiting Emacs; if you wish to prevent Emacs from transferring @@ -546,9 +546,9 @@ containing the last stretch of text selected in an X application (usually by dragging the mouse). Typically, this text can be inserted into other X applications by @kbd{mouse-2} clicks. The primary selection is separate from the clipboard. Its contents are more -``fragile''; they are overwritten each time you select text with the -mouse, whereas the clipboard is only overwritten by explicit ``cut'' -or ``copy'' commands. +fragile; they are overwritten each time you select text with the +mouse, whereas the clipboard is only overwritten by explicit cut +or copy commands. Under X, whenever the region is active (@pxref{Mark}), the text in the region is saved in the primary selection. This applies regardless @@ -727,9 +727,9 @@ rectangle, depending on the command that uses them. @table @kbd @item C-x r k Kill the text of the region-rectangle, saving its contents as the -``last killed rectangle'' (@code{kill-rectangle}). +last killed rectangle (@code{kill-rectangle}). @item C-x r M-w -Save the text of the region-rectangle as the ``last killed rectangle'' +Save the text of the region-rectangle as the last killed rectangle (@code{copy-rectangle-as-kill}). @item C-x r d Delete the text of the region-rectangle (@code{delete-rectangle}). @@ -776,7 +776,7 @@ region-rectangle is like erasing the specified text on each line of the rectangle; if there is any following text on the line, it moves backwards to fill the gap. - ``Killing'' a rectangle is not killing in the usual sense; the + Killing a rectangle is not killing in the usual sense; the rectangle is not stored in the kill ring, but in a special place that only records the most recent rectangle killed. This is because yanking a rectangle is so different from yanking linear text that @@ -786,8 +786,8 @@ for rectangles. @kindex C-x r M-w @findex copy-rectangle-as-kill @kbd{C-x r M-w} (@code{copy-rectangle-as-kill}) is the equivalent of -@kbd{M-w} for rectangles: it records the rectangle as the ``last -killed rectangle'', without deleting the text from the buffer. +@kbd{M-w} for rectangles: it records the rectangle as the last +killed rectangle, without deleting the text from the buffer. @kindex C-x r y @findex yank-rectangle diff --git a/doc/emacs/kmacro.texi b/doc/emacs/kmacro.texi index 039358b6a97..2cbcc8b3d54 100644 --- a/doc/emacs/kmacro.texi +++ b/doc/emacs/kmacro.texi @@ -194,9 +194,9 @@ C-x C-k C-p C-p C-k C-k C-k C-n C-n C-k C-p C-k C-d @end example @noindent -will rotate the keyboard macro ring to the ``second previous'' macro, +will rotate the keyboard macro ring to the second-previous macro, execute the resulting head macro three times, rotate back to the -original head macro, execute that once, rotate to the ``previous'' +original head macro, execute that once, rotate to the previous macro, execute that, and finally delete it from the macro ring. @findex kmacro-end-or-call-macro-repeat @@ -224,8 +224,8 @@ immediately by repeating just @kbd{C-n} and @kbd{C-p} until the desired macro is at the head of the ring. To execute the new macro ring head immediately, just type @kbd{C-k}. - Note that Emacs treats the head of the macro ring as the ``last -defined keyboard macro''. For instance, @key{F4} will execute that + Note that Emacs treats the head of the macro ring as the last +defined keyboard macro. For instance, @key{F4} will execute that macro, and @kbd{C-x C-k n} will give it a name. @vindex kmacro-ring-max diff --git a/doc/emacs/macos.texi b/doc/emacs/macos.texi index 97d423e1e4b..c04682586ce 100644 --- a/doc/emacs/macos.texi +++ b/doc/emacs/macos.texi @@ -66,7 +66,7 @@ file names. On GNUstep, in an X-windows environment you need to use @kbd{Cmd-c} instead of one of the @kbd{C-w} or @kbd{M-w} commands to transfer text to the X primary selection; otherwise, Emacs will use the -``clipboard'' selection. Likewise, @kbd{Cmd-y} (instead of @kbd{C-y}) +clipboard selection. Likewise, @kbd{Cmd-y} (instead of @kbd{C-y}) yanks from the X primary selection instead of the kill-ring or clipboard. @@ -131,9 +131,9 @@ at the command-line before starting Emacs: @section Windowing System Events under Mac OS / GNUstep Nextstep applications receive a number of special events which have -no X equivalent. These are sent as specially defined ``keys'', which +no X equivalent. These are sent as specially defined key events, which do not correspond to any sequence of keystrokes. Under Emacs, these -``key'' events can be bound to functions just like ordinary +key events can be bound to functions just like ordinary keystrokes. Here is a list of these events. @table @key diff --git a/doc/emacs/maintaining.texi b/doc/emacs/maintaining.texi index 8ec1cd223c3..b1c5297e7db 100644 --- a/doc/emacs/maintaining.texi +++ b/doc/emacs/maintaining.texi @@ -8,7 +8,7 @@ This chapter describes Emacs features for maintaining large programs. If you are maintaining a large Lisp program, then in addition to the features described here, you may find -the @file{ERT} (``Emacs Lisp Regression Testing'') library useful +the Emacs Lisp Regression Testing (ERT) library useful (@pxref{Top,,ERT,ert, Emacs Lisp Regression Testing}). @menu @@ -395,7 +395,7 @@ instance, @samp{jim}), that is displayed as @samp{RCS:jim:1.3}. to the master repository. On a graphical display, you can move the mouse over this mode line -indicator to pop up a ``tool-tip'', which displays a more verbose +indicator to pop up a tool-tip, which displays a more verbose description of the version control status. Pressing @kbd{Mouse-1} over the indicator pops up a menu of VC commands, identical to @samp{Tools / Version Control} on the menu bar. @@ -441,14 +441,14 @@ VC fileset. @findex vc-next-action @kindex C-x v v The principal VC command is a multi-purpose command, @kbd{C-x v v} -(@code{vc-next-action}), which performs the ``most appropriate'' +(@code{vc-next-action}), which performs the most appropriate action on the current VC fileset: either registering it with a version control system, or committing it, or unlocking it, or merging changes into it. The precise actions are described in detail in the following subsections. You can use @kbd{C-x v v} either in a file-visiting buffer or in a VC Directory buffer. - Note that VC filesets are distinct from the ``named filesets'' used + Note that VC filesets are distinct from the named filesets used for viewing and visiting files in functional groups (@pxref{Filesets}). Unlike named filesets, VC filesets are not named and don't persist across sessions. @@ -469,8 +469,8 @@ and don't persist across sessions. @item If there is more than one file in the VC fileset and the files have inconsistent version control statuses, signal an error. (Note, -however, that a fileset is allowed to include both ``newly-added'' -files and ``modified'' files; @pxref{Registering}.) +however, that a fileset is allowed to include both newly-added +files and modified files; @pxref{Registering}.) @item If none of the files in the VC fileset are registered with a version @@ -502,7 +502,7 @@ if each work file in the VC fileset is up-to-date. If any file has been changed in the repository, offer to update it. @end itemize - These rules also apply when you use RCS in its ``non-locking'' mode, + These rules also apply when you use RCS in its non-locking mode, except that changes are not automatically merged from the repository. Nothing informs you if another user has committed changes in the same file since you began editing it; when you commit your revision, his @@ -547,7 +547,7 @@ the lock and make the file read-only again. @item If each file is locked by another user, ask whether you want to -``steal the lock''. If you say yes, the file becomes locked by you, +steal the lock. If you say yes, the file becomes locked by you, and a warning message is sent to the user who had formerly locked the file. @end itemize @@ -582,11 +582,11 @@ If the fileset is unmodified (and unlocked), this checks the specified revision into the working tree. You can also specify a revision on another branch by giving its revision or branch ID (@pxref{Switching Branches}). An empty argument (i.e., @kbd{C-u C-x v v @key{RET}}) -checks out the latest (``head'') revision on the current branch. +checks out the latest (head) revision on the current branch. This signals an error on a decentralized version control system. Those systems do not let you specify your own revision IDs, nor do -they use the concept of ``checking out'' individual files. +they use the concept of checking out individual files. @end itemize @node Log Buffer @@ -634,7 +634,7 @@ support it, the header is treated as part of the log entry. @findex log-edit-show-files @kindex C-c C-d @r{(Log Edit mode)} @findex log-edit-show-diff - While in the @file{*vc-log*} buffer, the ``current VC fileset'' is + While in the @file{*vc-log*} buffer, the current VC fileset is considered to be the fileset that will be committed if you type @w{@kbd{C-c C-c}}. To view a list of the files in the VC fileset, type @w{@kbd{C-c C-f}} (@code{log-edit-show-files}). To view a diff @@ -710,7 +710,7 @@ under, it prompts for a repository type, creates a new repository, and registers the file into that repository. On most version control systems, registering a file with @kbd{C-x v -i} or @kbd{C-x v v} adds it to the ``working tree'' but not to the +i} or @kbd{C-x v v} adds it to the working tree but not to the repository. Such files are labeled as @samp{added} in the VC Directory buffer, and show a revision ID of @samp{@@@@} in the mode line. To make the registration take effect in the repository, you @@ -824,8 +824,8 @@ window. @kindex C-x v g Many version control systems allow you to view files @dfn{annotated} with per-line revision information, by typing @kbd{C-x v g} -(@code{vc-annotate}). This creates a new buffer (the ``annotate -buffer'') displaying the file's text, with each line colored to show +(@code{vc-annotate}). This creates a new annotate buffer +displaying the file's text, with each line colored to show how old it is. Red text is new, blue is old, and intermediate colors indicate intermediate ages. By default, the color is scaled over the full range of ages, such that the oldest changes are blue, and the @@ -941,13 +941,13 @@ revision at point. A second @key{RET} hides it again. On a decentralized version control system, the @kbd{C-x v I} (@code{vc-log-incoming}) command displays a log buffer showing the changes that will be applied, the next time you run the version -control system's ``pull'' command to get new revisions from another +control system's pull command to get new revisions from another repository (@pxref{Pulling / Pushing}). This other repository is the default one from which changes are pulled, as defined by the version control system; with a prefix argument, @code{vc-log-incoming} prompts for a specific repository. Similarly, @kbd{C-x v O} (@code{vc-log-outgoing}) shows the changes that will be sent to -another repository, the next time you run the ``push'' command; with a +another repository, the next time you run the push command; with a prefix argument, it prompts for a specific destination repository. In the @file{*vc-change-log*} buffer, you can use the following keys @@ -1104,7 +1104,7 @@ PCL-CVS, pcl-cvs, PCL-CVS---The Emacs Front-End to CVS}. The VC Directory buffer contains a list of version-controlled files and their version control statuses. It lists files in the current directory (the one specified when you called @kbd{C-x v d}) and its -subdirectories, but only those with a ``noteworthy'' status. Files +subdirectories, but only those with a noteworthy status. Files that are up-to-date (i.e., the same as in the repository) are omitted. If all the files in a subdirectory are up-to-date, the subdirectory is not listed either. As an exception, if a file has @@ -1169,7 +1169,7 @@ directories that are used internally by version control systems. @subsubsection VC Directory Commands Emacs provides several commands for navigating the VC Directory -buffer, and for ``marking'' files as belonging to the current VC +buffer, and for marking files as belonging to the current VC fileset. @table @kbd @@ -1291,8 +1291,8 @@ bring them back at a later time). One use of version control is to support multiple independent lines of development, which are called @dfn{branches}. Amongst other -things, branches can be used for maintaining separate ``stable'' and -``development'' versions of a program, and for developing unrelated +things, branches can be used for maintaining separate stable and +development versions of a program, and for developing unrelated features in isolation from one another. VC's support for branch operations is currently fairly limited. For @@ -1355,13 +1355,13 @@ commit will be committed to that specific branch. @table @kbd @item C-x v + On a decentralized version control system, update the current branch -by ``pulling in'' changes from another location. +by pulling in changes from another location. On a centralized version control system, update the current VC fileset. @item C-x v P -On a decentralized version control system, ``push'' changes from the +On a decentralized version control system, push changes from the current branch to another location. This concept does not exist for centralized version control systems. @end table @@ -2407,11 +2407,11 @@ information about the project. A project may contain one or more @dfn{targets}. A target can be an object file, executable program, or some other type of file, which is -``built'' from one or more of the files in the project. +built from one or more of the files in the project. To add a new @dfn{target} to a project, type @kbd{C-c . t} (@code{M-x ede-new-target}). This command also asks if you wish to -``add'' the current file to that target, which means that the target +add the current file to that target, which means that the target is to be built from that file. After you have defined a target, you can add more files to it by typing @kbd{C-c . a} (@code{ede-add-file}). diff --git a/doc/emacs/mark.texi b/doc/emacs/mark.texi index c975f6ebe6b..09c766be504 100644 --- a/doc/emacs/mark.texi +++ b/doc/emacs/mark.texi @@ -43,7 +43,7 @@ Ordinarily, only the selected window highlights its region; however, if the variable @code{highlight-nonselected-windows} is non-@code{nil}, each window highlights its own region. - There is another kind of region: the ``rectangular region''. + There is another kind of region: the rectangular region. @xref{Rectangles}. @menu @@ -105,7 +105,7 @@ region also automatically deactivate the mark, like @kbd{C-x C-u} in the above example. Instead of setting the mark in order to operate on a region, you can -also use it to ``remember'' a position in the buffer (by typing +also use it to remember a position in the buffer (by typing @kbd{C-@key{SPC} C-@key{SPC}}), and later jump back there (by typing @kbd{C-u C-@key{SPC}}). @xref{Mark Ring}, for details. @@ -275,7 +275,7 @@ active. If you change the value to @code{kill}, these commands behavior. Such commands usually have the word @code{region} in their names, like @kbd{C-w} (@code{kill-region}) and @code{C-x C-u} (@code{upcase-region}). If the mark is inactive, they operate on the -``inactive region''---that is, on the text between point and the +@dfn{inactive region}---that is, on the text between point and the position at which the mark was last set (@pxref{Mark Ring}). To disable this behavior, change the variable @code{mark-even-if-inactive} to @code{nil}. Then these commands will diff --git a/doc/emacs/mini.texi b/doc/emacs/mini.texi index f0bedf8854d..7357372f994 100644 --- a/doc/emacs/mini.texi +++ b/doc/emacs/mini.texi @@ -108,8 +108,8 @@ Find file: /u2/emacs/src//etc/termcap @cindex double slash in file name @cindex slashes repeated in file name @findex file-name-shadow-mode -Emacs interprets a double slash as ``ignore everything before the -second slash in the pair''. In the example above, +A double slash causes Emacs to ignore everything before the +second slash in the pair. In the example above, @file{/u2/emacs/src/} is ignored, so the argument you supplied is @file{/etc/termcap}. The ignored part of the file name is dimmed if the terminal allows it. (To disable this dimming, turn off File Name @@ -435,10 +435,10 @@ This behavior is used by most commands that read file names, like @cindex completion style Completion commands work by narrowing a large list of possible -completion alternatives to a smaller subset that ``matches'' what you +completion alternatives to a smaller subset that matches what you have typed in the minibuffer. In @ref{Completion Example}, we gave a simple example of such matching. The procedure of determining what -constitutes a ``match'' is quite intricate. Emacs attempts to offer +constitutes a match is quite intricate. Emacs attempts to offer plausible completions under most circumstances. Emacs performs completion using one or more @dfn{completion @@ -545,7 +545,7 @@ ignored as a completion alternative. Any element ending in a slash @code{".o"}, @code{".elc"}, and @code{"~"}. For example, if a directory contains @samp{foo.c} and @samp{foo.elc}, @samp{foo} completes to @samp{foo.c}. However, if @emph{all} possible -completions end in ``ignored'' strings, they are not ignored: in the +completions end in otherwise-ignored strings, they are not ignored: in the previous example, @samp{foo.e} completes to @samp{foo.elc}. Emacs disregards @code{completion-ignored-extensions} when showing completion alternatives in the completion list. @@ -564,7 +564,7 @@ completion list buffer. @vindex completion-cycle-threshold If @code{completion-cycle-threshold} is non-@code{nil}, completion -commands can ``cycle'' through completion alternatives. Normally, if +commands can cycle through completion alternatives. Normally, if there is more than one completion alternative for the text in the minibuffer, a completion command completes up to the longest common substring. If you change @code{completion-cycle-threshold} to @@ -620,7 +620,7 @@ fetching later entries into the minibuffer. entries in the minibuffer history (e.g., if you haven't previously typed @kbd{M-p}), Emacs tries fetching from a list of default arguments: values that you are likely to enter. You can think of this -as moving through the ``future history'' list. +as moving through the future history. If you edit the text inserted by the @kbd{M-p} or @kbd{M-n} minibuffer history commands, this does not change its entry in the @@ -754,12 +754,12 @@ input is ignored. @node Yes or No Prompts @section Yes or No Prompts - An Emacs command may require you to answer a ``yes or no'' question + An Emacs command may require you to answer a yes-or-no question during the course of its execution. Such queries come in two main varieties. @cindex y or n prompt - For the first type of ``yes or no'' query, the prompt ends with + For the first type of yes-or-no query, the prompt ends with @samp{(y or n)}. Such a query does not actually use the minibuffer; the prompt appears in the echo area, and you answer by typing either @samp{y} or @samp{n}, which immediately delivers the response. For @@ -768,7 +768,7 @@ buffer, and enter the name of an existing file, Emacs issues a prompt like this: @smallexample -File `foo.el' exists; overwrite? (y or n) +File ‘foo.el’ exists; overwrite? (y or n) @end smallexample @noindent @@ -783,7 +783,7 @@ window; and @kbd{C-M-S-v} scrolls backward in the next window. Typing (@pxref{Quitting}). @cindex yes or no prompt - The second type of ``yes or no'' query is typically employed if + The second type of yes-or-no query is typically employed if giving the wrong answer would have serious consequences; it uses the minibuffer, and features a prompt ending with @samp{(yes or no)}. For example, if you invoke @kbd{C-x k} (@code{kill-buffer}) on a diff --git a/doc/emacs/misc.texi b/doc/emacs/misc.texi index db096c7ebf7..2eee3dd33e1 100644 --- a/doc/emacs/misc.texi +++ b/doc/emacs/misc.texi @@ -331,7 +331,7 @@ Certificate Authorities which issue new certificates for third-party services, you may want to keep track of these changes. @item Diffie-Hellman low prime bits -When doing the public key exchange, the number of ``prime bits'' +When doing the public key exchange, the number of prime bits should be high to ensure that the channel can't be eavesdropped on by third parties. If this number is too low, you will be warned. @@ -1486,8 +1486,8 @@ this buffer just like it does with a terminal in ordinary Term mode. most common speed is 9600 bits per second. You can change the speed interactively by clicking on the mode line. - A serial port can be configured even more by clicking on ``8N1'' in -the mode line. By default, a serial port is configured as ``8N1'', + A serial port can be configured even more by clicking on @samp{8N1} in +the mode line. By default, a serial port is configured as @samp{8N1}, which means that each byte consists of 8 data bits, No parity check bit, and 1 stopbit. @@ -1515,7 +1515,7 @@ command history, or other kinds of information with any existing Emacs process. You can solve this problem by setting up Emacs as an @dfn{edit -server}, so that it ``listens'' for external edit requests and acts +server}, so that it listens for external edit requests and acts accordingly. There are two ways to start an Emacs server: @itemize @@ -1548,7 +1548,7 @@ variable to @samp{emacsclient +%d %s}.} @vindex server-name You can run multiple Emacs servers on the same machine by giving -each one a unique ``server name'', using the variable +each one a unique @dfn{server name}, using the variable @code{server-name}. For example, @kbd{M-x set-variable @key{RET} server-name @key{RET} foo @key{RET}} sets the server name to @samp{foo}. The @code{emacsclient} program can specify a server by @@ -1605,7 +1605,7 @@ still use Emacs to edit the file. @kbd{C-x #} (@code{server-edit}) in its buffer. This saves the file and sends a message back to the @command{emacsclient} program, telling it to exit. Programs that use @env{EDITOR} usually wait for the -``editor''---in this case @command{emacsclient}---to exit before doing +editor---in this case @command{emacsclient}---to exit before doing something else. You can also call @command{emacsclient} with multiple file name @@ -1625,7 +1625,7 @@ create it. However, if you set @code{server-kill-new-buffers} to @code{nil}, then a different criterion is used: finishing with a server buffer kills it if the file name matches the regular expression @code{server-temp-file-regexp}. This is set up to distinguish certain -``temporary'' files. +temporary files. Each @kbd{C-x #} checks for other pending external requests to edit various files, and selects the next such file. You can switch to a @@ -1716,8 +1716,8 @@ evaluate, @emph{not} as a list of files to visit. @cindex @env{EMACS_SERVER_FILE} environment variable Specify a @dfn{server file} for connecting to an Emacs server via TCP. -An Emacs server usually uses an operating system feature called a -``local socket'' to listen for connections. Some operating systems, +An Emacs server usually uses a +local socket to listen for connections. Some operating systems, such as Microsoft Windows, do not support local sockets; in that case, the server communicates with @command{emacsclient} via TCP. @@ -1808,10 +1808,10 @@ as detailed below, or using the @samp{File} menu on the menu bar. @findex htmlfontify-buffer Aside from the commands described in this section, you can also print hardcopies from Dired (@pxref{Operating on Files}) and the diary -(@pxref{Displaying the Diary}). You can also ``print'' an Emacs +(@pxref{Displaying the Diary}). You can also print an Emacs buffer to HTML with the command @kbd{M-x htmlfontify-buffer}, which converts the current buffer to a HTML file, replacing Emacs faces with -CSS-based markup. Furthermore, Org mode allows you to ``print'' Org +CSS-based markup. Furthermore, Org mode allows you to print Org files to a variety of formats, such as PDF (@pxref{Org Mode}). @table @kbd @@ -1984,7 +1984,7 @@ additional paper sizes by changing the variable @vindex ps-landscape-mode The variable @code{ps-landscape-mode} specifies the orientation of printing on the page. The default is @code{nil}, which stands for -``portrait'' mode. Any non-@code{nil} value specifies ``landscape'' +portrait mode. Any non-@code{nil} value specifies landscape mode. @vindex ps-number-of-columns @@ -2232,10 +2232,10 @@ Insert a byte with a code typed in octal. Insert a byte with a code typed in hex. @item C-x [ -Move to the beginning of a 1k-byte ``page''. +Move to the beginning of a 1k-byte page. @item C-x ] -Move to the end of a 1k-byte ``page''. +Move to the end of a 1k-byte page. @item M-g Move to an address specified in hex. @@ -2316,7 +2316,7 @@ usually turned on. However, this may be slow if there are a lot of buffers in the desktop. You can specify the maximum number of buffers to restore immediately with the variable @code{desktop-restore-eager}; the -remaining buffers are restored ``lazily'', when Emacs is idle. +remaining buffers are restored lazily, when Emacs is idle. @findex desktop-clear @vindex desktop-globals-to-clear @@ -2391,7 +2391,7 @@ stack overflow) from time to time. So remember to exit or abort the recursive edit when you no longer need it. In general, we try to minimize the use of recursive editing levels in -GNU Emacs. This is because they constrain you to ``go back'' in a +GNU Emacs. This is because they constrain you to go back in a particular order---from the innermost level toward the top level. When possible, we present different activities in separate buffers so that you can switch between them as you please. Some commands switch to a @@ -2401,7 +2401,7 @@ the order you choose. @ignore @c Apart from edt and viper, this is all obsolete. -@c (Can't believe we were saying ``most other editors'' into 2014!) +@c (Can't believe we were saying "most other editors" into 2014!) @c There seems no point having a node just for those, which both have @c their own manuals. @node Emulation @@ -2460,8 +2460,8 @@ Viper, viper}. @findex vi-mode @kbd{M-x vi-mode} enters a major mode that replaces the previously established major mode. All of the vi commands that, in real vi, enter -``input'' mode are programmed instead to return to the previous major -mode. Thus, ordinary Emacs serves as vi's ``input'' mode. +input mode are programmed instead to return to the previous major +mode. Thus, ordinary Emacs serves as vi's input mode. Because vi emulation works through major modes, it does not work to switch buffers during emulation. Return to normal Emacs first. @@ -2472,7 +2472,7 @@ to the @code{vi-mode} command. @item vi (alternate emulator) @findex vip-mode @kbd{M-x vip-mode} invokes another vi emulator, said to resemble real vi -more thoroughly than @kbd{M-x vi-mode}. ``Input'' mode in this emulator +more thoroughly than @kbd{M-x vi-mode}. Input mode in this emulator is changed from ordinary Emacs so you can use @key{ESC} to go back to emulated vi command mode. To get from emulated vi command mode back to ordinary Emacs, type @kbd{C-z}. @@ -2704,7 +2704,7 @@ bored, try an argument of 9. Sit back and watch. @findex life @cindex Life - @kbd{M-x life} runs Conway's ``Life'' cellular automaton. + @kbd{M-x life} runs Conway's Game of Life cellular automaton. @findex landmark @cindex landmark game diff --git a/doc/emacs/modes.texi b/doc/emacs/modes.texi index d442f8546fc..3bba577a5f7 100644 --- a/doc/emacs/modes.texi +++ b/doc/emacs/modes.texi @@ -251,7 +251,7 @@ In Binary Overwrite mode, digits after @kbd{C-q} specify an octal character code, as usual. @item -Visual Line mode performs ``word wrapping'', causing long lines to be +Visual Line mode performs word wrapping, causing long lines to be wrapped at word boundaries. @xref{Visual Line Mode}. @end itemize @@ -451,6 +451,6 @@ the file's @samp{-*-} line or local variables list (if any). a new major mode if the new file name implies a mode (@pxref{Saving}). (@kbd{C-x C-s} does this too, if the buffer wasn't visiting a file.) However, this does not happen if the buffer contents specify a major -mode, and certain ``special'' major modes do not allow the mode to +mode, and certain special major modes do not allow the mode to change. You can turn off this mode-changing feature by setting @code{change-major-mode-with-file-name} to @code{nil}. diff --git a/doc/emacs/msdos-xtra.texi b/doc/emacs/msdos-xtra.texi index 9996158f161..c8e266915f0 100644 --- a/doc/emacs/msdos-xtra.texi +++ b/doc/emacs/msdos-xtra.texi @@ -9,7 +9,7 @@ @cindex MS-DOS peculiarities This section briefly describes the peculiarities of using Emacs on -the MS-DOS ``operating system''. +MS-DOS. @iftex Information about Emacs and Microsoft's current operating system Windows is in the main Emacs manual diff --git a/doc/emacs/mule.texi b/doc/emacs/mule.texi index 477f24e56c0..88bbccd5b11 100644 --- a/doc/emacs/mule.texi +++ b/doc/emacs/mule.texi @@ -172,9 +172,9 @@ system encodes the character safely and with a single byte one byte, Emacs shows @samp{file ...}. As a special case, if the character lies in the range 128 (0200 -octal) through 159 (0237 octal), it stands for a ``raw'' byte that +octal) through 159 (0237 octal), it stands for a raw byte that does not correspond to any specific displayable character. Such a -``character'' lies within the @code{eight-bit-control} character set, +character lies within the @code{eight-bit-control} character set, and is displayed as an escaped octal character code. In this case, @kbd{C-x =} shows @samp{part of display ...} instead of @samp{file}. @@ -642,7 +642,7 @@ automatically. For example: @end lisp @noindent -This automatically activates the input method ``german-prefix'' in +This automatically activates the input method @code{german-prefix} in Text mode. @findex quail-set-keyboard-layout @@ -696,8 +696,8 @@ system; for example, to visit a file encoded in codepage 850, type In addition to converting various representations of non-@acronym{ASCII} characters, a coding system can perform end-of-line conversion. Emacs handles three different conventions for how to separate lines in a file: -newline (``unix''), carriage-return linefeed (``dos''), and just -carriage-return (``mac''). +newline (Unix), carriage-return linefeed (DOS), and just +carriage-return (Mac). @table @kbd @item C-h C @var{coding} @key{RET} @@ -1647,7 +1647,7 @@ so far. @cindex 8-bit display Normally non-ISO-8859 characters (decimal codes between 128 and 159 inclusive) are displayed as octal escapes. You can change this for -non-standard ``extended'' versions of ISO-8859 character sets by using the +non-standard extended versions of ISO-8859 character sets by using the function @code{standard-display-8bit} in the @code{disp-table} library. There are two ways to input single-byte non-@acronym{ASCII} @@ -1681,7 +1681,7 @@ characters present directly on the keyboard or using @key{Compose} or @cindex compose character @cindex dead character @item -You can use the key @kbd{C-x 8} as a ``compose character'' prefix for +You can use the key @kbd{C-x 8} as a compose-character prefix for entry of non-@acronym{ASCII} Latin-1 and a few other printing characters. @kbd{C-x 8} is good for insertion (in the minibuffer as well as other buffers), for searching, and in any other context where @@ -1691,7 +1691,7 @@ a key sequence is allowed. library is loaded, the @key{Alt} modifier key, if the keyboard has one, serves the same purpose as @kbd{C-x 8}: use @key{Alt} together with an accent character to modify the following letter. In addition, -if the keyboard has keys for the Latin-1 ``dead accent characters'', +if the keyboard has keys for the Latin-1 dead accent characters, they too are defined to compose with the following character, once @code{iso-transl} is loaded. @@ -1709,13 +1709,13 @@ addition to some charsets of its own (such as @code{emacs}, @code{unicode-bmp}, and @code{eight-bit}). All supported characters belong to one or more charsets. - Emacs normally ``does the right thing'' with respect to charsets, so + Emacs normally does the right thing with respect to charsets, so that you don't have to worry about them. However, it is sometimes helpful to know some of the underlying details about charsets. One example is font selection (@pxref{Fonts}). Each language -environment (@pxref{Language Environments}) defines a ``priority -list'' for the various charsets. When searching for a font, Emacs +environment (@pxref{Language Environments}) defines a priority +list for the various charsets. When searching for a font, Emacs initially attempts to find one that can display the highest-priority charsets. For instance, in the Japanese language environment, the charset @code{japanese-jisx0208} has the highest priority, so Emacs diff --git a/doc/emacs/package.texi b/doc/emacs/package.texi index 19d861a8395..1a6a735d3ae 100644 --- a/doc/emacs/package.texi +++ b/doc/emacs/package.texi @@ -111,7 +111,7 @@ Remove any installation or deletion mark previously added to the current line by an @kbd{i} or @kbd{d} command. @item U -Mark all package with a newer available version for ``upgrading'' +Mark all package with a newer available version for upgrading (@code{package-menu-mark-upgrades}). This places an installation mark on the new available versions, and a deletion mark on the old installed versions. @@ -246,7 +246,7 @@ version @var{version} of the package named @var{name}. Here, @var{version} should be a version string (corresponding to a specific version of the package), or @code{t} (which means to load any installed version), or @code{nil} (which means no version; this -``disables'' the package, preventing it from being loaded). A list +disables the package, preventing it from being loaded). A list element can also be the symbol @code{all}, which means to load the latest installed version of any package not named by the other list elements. The default value is just @code{'(all)}. diff --git a/doc/emacs/picture-xtra.texi b/doc/emacs/picture-xtra.texi index a9ad2d5d2e3..4e22d754f38 100644 --- a/doc/emacs/picture-xtra.texi +++ b/doc/emacs/picture-xtra.texi @@ -53,7 +53,7 @@ Additional extensions to Picture mode can be found in @menu * Basic Picture:: Basic concepts and simple commands of Picture Mode. * Insert in Picture:: Controlling direction of cursor motion - after ``self-inserting'' characters. + after self-inserting characters. * Tabs in Picture:: Various features for tab stops and indentation. * Rectangles in Picture:: Clearing and superimposing rectangles. @end menu @@ -143,10 +143,10 @@ Picture}). @kindex C-c ' @r{(Picture mode)} @kindex C-c / @r{(Picture mode)} @kindex C-c \ @r{(Picture mode)} - Since ``self-inserting'' characters in Picture mode overwrite and move + Since self-inserting characters in Picture mode overwrite and move point, there is no essential restriction on how point should be moved. Normally point moves right, but you can specify any of the eight -orthogonal or diagonal directions for motion after a ``self-inserting'' +orthogonal or diagonal directions for motion after a self-inserting character. This is useful for drawing lines in the buffer. @table @kbd @@ -164,18 +164,18 @@ Move up after insertion (@code{picture-movement-up}). Move down after insertion (@code{picture-movement-down}). @item C-c ` @itemx C-c @key{Home} -Move up and left (``northwest'') after insertion (@code{picture-movement-nw}). +Move up and left (northwest) after insertion (@code{picture-movement-nw}). @item C-c ' @itemx C-c @key{prior} -Move up and right (``northeast'') after insertion +Move up and right (northeast) after insertion (@code{picture-movement-ne}). @item C-c / @itemx C-c @key{End} -Move down and left (``southwest'') after insertion +Move down and left (southwest) after insertion @*(@code{picture-movement-sw}). @item C-c \ @itemx C-c @key{next} -Move down and right (``southeast'') after insertion +Move down and right (southeast) after insertion @*(@code{picture-movement-se}). @end table @@ -185,7 +185,7 @@ Move down and right (``southeast'') after insertion @findex picture-motion-reverse Two motion commands move based on the current Picture insertion direction. The command @kbd{C-c C-f} (@code{picture-motion}) moves in the -same direction as motion after ``insertion'' currently does, while @kbd{C-c +same direction as motion after insertion currently does, while @kbd{C-c C-b} (@code{picture-motion-reverse}) moves in the opposite direction. @node Tabs in Picture @@ -197,12 +197,12 @@ C-b} (@code{picture-motion-reverse}) moves in the opposite direction. Two kinds of tab-like action are provided in Picture mode. Use @kbd{M-@key{TAB}} (@code{picture-tab-search}) for context-based tabbing. With no argument, it moves to a point underneath the next -``interesting'' character that follows whitespace in the previous +interesting character that follows whitespace in the previous nonblank line. ``Next'' here means ``appearing at a horizontal position greater than the one point starts out at''. With an argument, as in @kbd{C-u M-@key{TAB}}, this command moves to the next such interesting character in the current line. @kbd{M-@key{TAB}} does not change the -text; it only moves point. ``Interesting'' characters are defined by +text; it only moves point. Interesting characters are defined by the variable @code{picture-tab-chars}, which should define a set of characters. The syntax for this variable is like the syntax used inside of @samp{[@dots{}]} in a regular expression---but without the @samp{[} diff --git a/doc/emacs/programs.texi b/doc/emacs/programs.texi index ea8f82fa2ea..00454551281 100644 --- a/doc/emacs/programs.texi +++ b/doc/emacs/programs.texi @@ -741,10 +741,10 @@ because of the parentheses. The following commands move over groupings delimited by parentheses (or whatever else serves as delimiters in the language you are working with). They ignore strings and comments, including any parentheses -within them, and also ignore parentheses that are ``quoted'' with an +within them, and also ignore parentheses that are quoted with an escape character. These commands are mainly intended for editing programs, but can be useful for editing any text containing -parentheses. They are referred to internally as ``list'' commands +parentheses. They are referred to internally as ``list commands'' because in Lisp these groupings are lists. These commands assume that the starting point is not inside a string @@ -766,7 +766,7 @@ Move down in parenthesis structure (@code{down-list}). @kindex C-M-p @findex forward-list @findex backward-list - The ``list'' commands @kbd{C-M-n} (@code{forward-list}) and + The list commands @kbd{C-M-n} (@code{forward-list}) and @kbd{C-M-p} (@code{backward-list}) move forward or backward over one (or @var{n}) parenthetical groupings. @@ -940,7 +940,7 @@ you use it. When a region is active (@pxref{Mark}), @kbd{M-;} either adds comment delimiters to the region, or removes them. If every line in -the region is already a comment, it ``uncomments'' each of those lines +the region is already a comment, it uncomments each of those lines by removing their comment delimiters. Otherwise, it adds comment delimiters to enclose the text in the region. @@ -1134,7 +1134,7 @@ You can also use @kbd{M-x info-lookup-file} to look for documentation for a file name. If you use @kbd{C-h S} in a major mode that does not support it, -it asks you to specify the ``symbol help mode''. You should enter +it asks you to specify the symbol help mode. You should enter a command such as @code{c-mode} that would select a major mode which @kbd{C-h S} does support. @@ -1340,7 +1340,7 @@ based on the spell-checker's dictionary. @xref{Spelling}. @section MixedCase Words @cindex camel case - Some programming styles make use of mixed-case (or ``CamelCase'') + Some programming styles make use of mixed-case (or CamelCase) symbols like @samp{unReadableSymbol}. (In the GNU project, we recommend using underscores to separate words within an identifier, rather than using case distinctions.) Emacs has various features to make it easier @@ -1381,8 +1381,8 @@ see @ref{Top, Semantic,, semantic, Semantic}. see the Semantic Info manual, which is distributed with Emacs. @end iftex - Most of the ``language aware'' features in Emacs, such as Font Lock -mode (@pxref{Font Lock}), rely on ``rules of thumb''@footnote{Regular + Most of the language-aware features in Emacs, such as Font Lock +mode (@pxref{Font Lock}), rely on rules of thumb@footnote{Regular expressions and syntax tables.} that usually give good results but are never completely exact. In contrast, the parsers used by Semantic have an exact understanding of programming language syntax. This @@ -1478,15 +1478,16 @@ support Outline minor mode (@pxref{Outline Mode}), which can be used with the Foldout package (@pxref{Foldout}). @ifinfo - The ``automatic typing'' features may be useful for writing programs. + The automatic typing features may be useful for writing programs. @xref{Top,,Autotyping, autotype, Autotyping}. @end ifinfo @findex prettify-symbols-mode Prettify Symbols mode is a buffer-local minor mode that replaces -certain strings with more ``attractive'' versions for display +certain strings with more attractive versions for display purposes. For example, in Emacs Lisp mode, it replaces the string -``lambda'' with the Greek lambda character. You may wish to use this +@samp{lambda} with the Greek lambda character @samp{λ}. You may wish +to use this in non-programming modes as well. You can customize the mode by adding more entries to @code{prettify-symbols-alist}. There is also a global version, @code{global-prettify-symbols-mode}, which enables the @@ -1600,7 +1601,7 @@ Move point to the end of the innermost C statement or sentence; like In C mode and related modes, certain printing characters are @dfn{electric}---in addition to inserting themselves, they also reindent the current line, and optionally also insert newlines. The -``electric'' characters are @kbd{@{}, @kbd{@}}, @kbd{:}, @kbd{#}, +electric characters are @kbd{@{}, @kbd{@}}, @kbd{:}, @kbd{#}, @kbd{;}, @kbd{,}, @kbd{<}, @kbd{>}, @kbd{/}, @kbd{*}, @kbd{(}, and @kbd{)}. @@ -1797,7 +1798,7 @@ it work. Hide-ifdef minor mode hides selected code within @samp{#if} and @samp{#ifdef} preprocessor blocks. If you change the variable @code{hide-ifdef-shadow} to @code{t}, Hide-ifdef minor mode -``shadows'' preprocessor blocks by displaying them with a less +shadows preprocessor blocks by displaying them with a less prominent face, instead of hiding them entirely. See the documentation string of @code{hide-ifdef-mode} for more information. @@ -1805,7 +1806,7 @@ documentation string of @code{hide-ifdef-mode} for more information. @cindex related files @findex ff-find-related-file @vindex ff-related-file-alist -Find a file ``related'' in a special way to the file visited by the +Find a file related in a special way to the file visited by the current buffer. Typically this will be the header file corresponding to a C/C++ source file, or vice versa. The variable @code{ff-related-file-alist} specifies how to compute related file diff --git a/doc/emacs/regs.texi b/doc/emacs/regs.texi index fd48f3412bf..d8841caa311 100644 --- a/doc/emacs/regs.texi +++ b/doc/emacs/regs.texi @@ -32,7 +32,7 @@ Display a description of what register @var{r} contains. @vindex register-preview-delay @cindex preview of registers All of the commands that prompt for a register will display a -``preview'' window that lists the existing registers (if there are +preview window that lists the existing registers (if there are any) after a short delay. To change the length of the delay, customize @code{register-preview-delay}. To prevent this display, set that option to @code{nil}. You can explicitly request a preview @@ -121,7 +121,7 @@ reactivates the mark where it was last set. The mark is deactivated at the end of this command. @xref{Mark}. @kbd{C-u C-x r s @var{r}}, the same command with a prefix argument, copies the text into register @var{r} and deletes the text from the buffer as well; you can think of -this as ``moving'' the region text into the register. +this as moving the region text into the register. @findex append-to-register @findex prepend-to-register @@ -285,7 +285,7 @@ restore a frameset.) @dfn{Bookmarks} are somewhat like registers in that they record positions you can jump to. Unlike registers, they have long names, and they persist automatically from one Emacs session to the next. The -prototypical use of bookmarks is to record ``where you were reading'' in +prototypical use of bookmarks is to record where you were reading in various files. @table @kbd diff --git a/doc/emacs/rmail.texi b/doc/emacs/rmail.texi index 6cad28099a6..6e2a60b6378 100644 --- a/doc/emacs/rmail.texi +++ b/doc/emacs/rmail.texi @@ -82,7 +82,7 @@ file after merging new mail from an inbox file (@pxref{Rmail Inbox}). You can exit Rmail with @kbd{q} (@code{rmail-quit}); this expunges and saves the Rmail file, then buries the Rmail buffer as well as its summary buffer, if present (@pxref{Rmail Summary}). But there is no -need to ``exit'' formally. If you switch from Rmail to editing in +need to exit formally. If you switch from Rmail to editing in other buffers, and never switch back, you have exited. Just make sure to save the Rmail file eventually (like any other file you have changed). @kbd{C-x s} is a suitable way to do this (@pxref{Save @@ -794,7 +794,7 @@ message as the text, and a subject of the form @code{[@var{from}: @var{subject}]}, where @var{from} and @var{subject} are the sender and subject of the original message. All you have to do is fill in the recipients and send. When you forward a message, recipients get a -message which is ``from'' you, and which has the original message in +message which is from you, and which has the original message in its contents. @vindex rmail-enable-mime-composing @@ -817,7 +817,7 @@ following the current one. @findex rmail-resend @dfn{Resending} is an alternative similar to forwarding; the -difference is that resending sends a message that is ``from'' the +difference is that resending sends a message that is from the original sender, just as it reached you---with a few added header fields (@samp{Resent-From} and @samp{Resent-To}) to indicate that it came via you. To resend a message in Rmail, use @kbd{C-u f}. (@kbd{f} runs @@ -1213,14 +1213,14 @@ Toggle between @acronym{MIME} display and raw message immediately after its tagline, as part of the Rmail buffer, while @acronym{MIME} parts of other types are represented only by their taglines, with their actual contents hidden. In either case, you can -toggle a @acronym{MIME} part between its ``displayed'' and ``hidden'' +toggle a @acronym{MIME} part between its displayed and hidden states by typing @key{RET} anywhere in the part---or anywhere in its tagline (except for buttons for other actions, if there are any). Type @key{RET} (or click with the mouse) to activate a tagline button, and @key{TAB} to cycle point between tagline buttons. The @kbd{v} (@code{rmail-mime}) command toggles between the default -@acronym{MIME} display described above, and a ``raw'' display showing +@acronym{MIME} display described above, and a raw display showing the undecoded @acronym{MIME} data. With a prefix argument, this command toggles the display of only an entity at point. @@ -1372,8 +1372,8 @@ which applies the code when displaying the text. your Rmail file (@pxref{Rmail Inbox}). When loaded for the first time, Rmail attempts to locate the @code{movemail} program and determine its version. There are two versions of the @code{movemail} program: the -native one, shipped with GNU Emacs (the ``emacs version'') and the one -included in GNU mailutils (the ``mailutils version'', +native one, shipped with GNU Emacs (the Emacs version) and the one +included in GNU mailutils (the mailutils version, @pxref{movemail,,,mailutils,GNU mailutils}). They support the same command line syntax and the same basic subset of options. However, the Mailutils version offers additional features. @@ -1489,7 +1489,7 @@ versions of POP. @cindex POP mailboxes No matter which flavor of @code{movemail} you use, you can specify a POP inbox by using a POP @dfn{URL} (@pxref{Movemail}). A POP -@acronym{URL} is a ``file name'' of the form +@acronym{URL} is of the form @samp{pop://@var{username}@@@var{hostname}}, where @var{hostname} is the host name or IP address of the remote mail server and @var{username} is the user name on that server. diff --git a/doc/emacs/screen.texi b/doc/emacs/screen.texi index 920aa089758..37e0e7e067b 100644 --- a/doc/emacs/screen.texi +++ b/doc/emacs/screen.texi @@ -8,7 +8,7 @@ @cindex frame On a graphical display, such as on GNU/Linux using the X Window -System, Emacs occupies a ``graphical window''. On a text terminal, +System, Emacs occupies a graphical window. On a text terminal, Emacs occupies the entire terminal screen. We will use the term @dfn{frame} to mean a graphical window or terminal screen occupied by Emacs. Emacs behaves very similarly on both kinds of frames. It @@ -27,7 +27,7 @@ information when Emacs asks for it. above the echo area, is called @dfn{the window}. Henceforth in this manual, we will use the word ``window'' in this sense. Graphical display systems commonly use the word ``window'' with a different -meaning; but, as stated above, we refer to those ``graphical windows'' +meaning; but, as stated above, we refer to those graphical windows as ``frames''. An Emacs window is where the @dfn{buffer}---the text you are @@ -206,11 +206,11 @@ terminal output. Furthermore, if you are using an input method, string is displayed, that indicates a nontrivial end-of-line convention for encoding a file. Usually, lines of text are separated by @dfn{newline characters} in a file, but two other conventions are -sometimes used. The MS-DOS convention uses a ``carriage-return'' -character followed by a ``linefeed'' character; when editing such +sometimes used. The MS-DOS convention uses a carriage-return +character followed by a linefeed character; when editing such files, the colon changes to either a backslash (@samp{\}) or @samp{(DOS)}, depending on the operating system. Another convention, -employed by older Macintosh systems, uses a ``carriage-return'' +employed by older Macintosh systems, uses a carriage-return character instead of a newline; when editing such files, the colon changes to either a forward slash (@samp{/}) or @samp{(Mac)}. On some systems, Emacs displays @samp{(Unix)} instead of the colon for files @@ -219,7 +219,7 @@ that use newline as the line separator. The next element on the mode line is the string indicated by @var{ch}. This shows two dashes (@samp{--}) if the buffer displayed in the window has the same contents as the corresponding file on the -disk; i.e., if the buffer is ``unmodified''. If the buffer is +disk; i.e., if the buffer is unmodified. If the buffer is modified, it shows two stars (@samp{**}). For a read-only buffer, it shows @samp{%*} if the buffer is modified, and @samp{%%} otherwise. diff --git a/doc/emacs/search.texi b/doc/emacs/search.texi index a0dfe226324..9b91421a7e6 100644 --- a/doc/emacs/search.texi +++ b/doc/emacs/search.texi @@ -146,8 +146,8 @@ you don't like this feature, you can disable it by setting After exiting a search, you can search for the same string again by typing just @kbd{C-s C-s}. The first @kbd{C-s} is the key that -invokes incremental search, and the second @kbd{C-s} means ``search -again''. Similarly, @kbd{C-r C-r} searches backward for the last +invokes incremental search, and the second @kbd{C-s} means to search +again. Similarly, @kbd{C-r C-r} searches backward for the last search string. In determining the last search string, it doesn't matter whether the string was searched for with @kbd{C-s} or @kbd{C-r}. @@ -423,7 +423,7 @@ because that is used to display the minibuffer. If an incremental search fails in the minibuffer, it tries searching the minibuffer history. @xref{Minibuffer History}. You can visualize -the minibuffer and its history as a series of ``pages'', with the +the minibuffer and its history as a series of pages, with the earliest history element on the first page and the current minibuffer on the last page. A forward search, @kbd{C-s}, searches forward to later pages; a reverse search, @kbd{C-r}, searches backwards to @@ -893,11 +893,11 @@ This last application is not a consequence of the idea of a parenthetical grouping; it is a separate feature that is assigned as a second meaning to the same @samp{\( @dots{} \)} construct. In practice there is usually no conflict between the two meanings; when there is -a conflict, you can use a ``shy'' group. +a conflict, you can use a shy group. @item \(?: @dots{} \) @cindex shy group, in regexp -specifies a ``shy'' group that does not record the matched substring; +specifies a shy group that does not record the matched substring; you can't refer back to it with @samp{\@var{d}} (see below). This is useful in mechanically combining regular expressions, so that you can add groups for syntactic purposes without interfering with the diff --git a/doc/emacs/sending.texi b/doc/emacs/sending.texi index 49a4aa7c7f3..c5ca73b40a8 100644 --- a/doc/emacs/sending.texi +++ b/doc/emacs/sending.texi @@ -136,7 +136,7 @@ Use both address and full name, as in:@* Use both address and full name, as in:@* @samp{Elvis Parsley <king@@grassland.com>}. @item any other value -Use @code{angles} normally. But if the address must be ``quoted'' to +Use @code{angles} normally. But if the address must be quoted to remain syntactically valid under the @code{angles} format but not under the @code{parens} format, use @code{parens} instead. This is the default. @@ -159,7 +159,7 @@ directed at them. @item BCC Additional mailing address(es) to send the message to, which should -not appear in the header of the message actually sent. ``BCC'' stands +not appear in the header of the message actually sent. @samp{BCC} stands for @dfn{blind carbon copies}. @item FCC @@ -276,7 +276,7 @@ of the address, such as the person's full name. Emacs puts them in if they are needed. For instance, it inserts the above address as @samp{"John Q. Smith" <none@@example.com>}. - Emacs also recognizes ``include'' commands in @file{.mailrc}. They + Emacs also recognizes include commands in @file{.mailrc}. They look like this: @example @@ -341,7 +341,7 @@ Send the message, and leave the mail buffer selected (@code{message-send}). @vindex message-kill-buffer-on-exit The usual command to send a message is @kbd{C-c C-c} (@code{mail-send-and-exit}). This sends the message and then -``buries'' the mail buffer, putting it at the lowest priority for +buries the mail buffer, putting it at the lowest priority for reselection. If you want it to kill the mail buffer instead, change the variable @code{message-kill-buffer-on-exit} to @code{t}. @@ -648,7 +648,7 @@ it all. Whether or not this is true, it at least amuses some people. @findex fortune-to-signature @cindex fortune cookies - You can use the @code{fortune} program to put a ``fortune cookie'' + You can use the @code{fortune} program to put a fortune cookie message into outgoing mail. To do this, add @code{fortune-to-signature} to @code{mail-setup-hook}: diff --git a/doc/emacs/text.texi b/doc/emacs/text.texi index 389ef5ec8d6..0ade392634d 100644 --- a/doc/emacs/text.texi +++ b/doc/emacs/text.texi @@ -33,7 +33,7 @@ publish them in many formats. @cindex mode, XML @cindex mode, nXML @findex nxml-mode - Emacs has other major modes for text which contains ``embedded'' + Emacs has other major modes for text which contains embedded commands, such as @TeX{} and @LaTeX{} (@pxref{TeX Mode}); HTML and SGML (@pxref{HTML Mode}); XML @ifinfo @@ -45,9 +45,8 @@ SGML (@pxref{HTML Mode}); XML and Groff and Nroff (@pxref{Nroff Mode}). @cindex ASCII art - If you need to edit pictures made out of text characters (commonly -referred to as ``ASCII art''), use Picture mode, a special major mode -for editing such pictures. + If you need to edit ASCII art pictures made out of text characters, +use Picture mode, a special major mode for editing such pictures. @iftex @xref{Picture Mode,,, emacs-xtra, Specialized Emacs Features}. @end iftex @@ -60,7 +59,7 @@ for editing such pictures. @cindex templates @cindex autotyping @cindex automatic typing - The ``automatic typing'' features may be useful when writing text. + The automatic typing features may be useful when writing text. @inforef{Top,The Autotype Manual,autotype}. @end ifinfo @@ -78,7 +77,7 @@ for editing such pictures. * TeX Mode:: Editing TeX and LaTeX files. * HTML Mode:: Editing HTML and SGML files. * Nroff Mode:: Editing input to the nroff formatter. -* Enriched Text:: Editing text ``enriched'' with fonts, colors, etc. +* Enriched Text:: Editing text enriched with fonts, colors, etc. * Text Based Tables:: Commands for editing text-based tables. * Two-Column:: Splitting text columns into separate windows. @end menu @@ -683,7 +682,7 @@ delimiter on each line. prefix for each paragraph automatically. This command divides the region into paragraphs, treating every change in the amount of indentation as the start of a new paragraph, and fills each of these -paragraphs. Thus, all the lines in one ``paragraph'' have the same +paragraphs. Thus, all the lines in one paragraph have the same amount of indentation. That indentation serves as the fill prefix for that paragraph. @@ -1073,7 +1072,7 @@ revealing parts of the buffer, based on the outline structure. These commands are not undoable; their effects are simply not recorded by the undo mechanism, so you can undo right past them (@pxref{Undo}). - Many of these commands act on the ``current'' heading line. If + Many of these commands act on the current heading line. If point is on a heading line, that is the current heading line; if point is on a body line, the current heading line is the nearest preceding header line. @@ -1205,7 +1204,7 @@ buffers. @cindex folding editing The Foldout package extends Outline mode and Outline minor mode with -``folding'' commands. The idea of folding is that you zoom in on a +folding commands. The idea of folding is that you zoom in on a nested portion of the outline, while hiding its relatives at higher levels. @@ -1235,7 +1234,7 @@ show-subtree}), by specifying a zero argument: @kbd{M-0 C-c C-z}. While you're zoomed in, you can still use Outline mode's exposure and hiding functions without disturbing Foldout. Also, since the buffer is -narrowed, ``global'' editing actions will only affect text under the +narrowed, global editing actions will only affect text under the zoomed-in heading. This is useful for restricting changes to a particular chapter or section of your document. @@ -1967,7 +1966,7 @@ used as a cheap preview (@code{sgml-tags-invisible}). The major mode for editing XML documents is called nXML mode. This is a powerful major mode that can recognize many existing XML schema and use them to provide completion of XML elements via -@kbd{M-@key{TAB}}, as well as ``on-the-fly'' XML +@kbd{M-@key{TAB}}, as well as on-the-fly XML validation with error highlighting. To enable nXML mode in an existing buffer, type @kbd{M-x nxml-mode}, or, equivalently, @kbd{M-x xml-mode}. Emacs uses nXML mode for files which have the extension @@ -2048,7 +2047,7 @@ number (the header level). @cindex text/enriched MIME format Enriched mode is a minor mode for editing formatted text files in a -WYSIWYG (``what you see is what you get'') fashion. When Enriched +WYSIWYG (What You See Is What You Get) fashion. When Enriched mode is enabled, you can apply various formatting properties to the text in the buffer, such as fonts and colors; upon saving the buffer, those properties are saved together with the text, using the MIME @@ -2072,7 +2071,7 @@ serves as an example of the features of Enriched mode. * Enriched Indentation:: Changing the left and right margins. * Enriched Justification:: Centering, setting text flush with the left or right margin, etc. -* Enriched Properties:: The ``special'' text properties submenu. +* Enriched Properties:: The special text properties submenu. @end menu @node Enriched Mode @@ -2832,8 +2831,8 @@ puts the text after the separator into the right-hand buffer, and deletes the separator. Lines that don't have the column separator at the proper place remain unsplit; they stay in the left-hand buffer, and the right-hand buffer gets an empty line to correspond. (This is the -way to write a line that ``spans both columns while in two-column -mode'': write it in the left-hand buffer, and put an empty line in the +way to write a line that spans both columns while in two-column +mode: write it in the left-hand buffer, and put an empty line in the right-hand buffer.) @kindex F2 RET diff --git a/doc/emacs/trouble.texi b/doc/emacs/trouble.texi index 2233376755a..35272509dbb 100644 --- a/doc/emacs/trouble.texi +++ b/doc/emacs/trouble.texi @@ -78,8 +78,8 @@ actually executed as a command if you type it while Emacs is waiting for input. In that case, the command it runs is @code{keyboard-quit}. On a text terminal, if you quit with @kbd{C-g} a second time before -the first @kbd{C-g} is recognized, you activate the ``emergency -escape'' feature and return to the shell. @xref{Emergency Escape}. +the first @kbd{C-g} is recognized, you activate the emergency-escape +feature and return to the shell. @xref{Emergency Escape}. @cindex NFS and quitting There are some situations where you cannot quit. When Emacs is @@ -118,7 +118,7 @@ it executes as an ordinary command, and Emacs doesn't notice it until it is ready for the next command. @findex top-level - The command @kbd{M-x top-level} is equivalent to ``enough'' + The command @kbd{M-x top-level} is equivalent to enough @kbd{C-]} commands to get you out of all the levels of recursive edits that you are in; it also exits the minibuffer if it is active. @kbd{C-]} gets you out one level at a time, but @kbd{M-x top-level} @@ -507,7 +507,7 @@ by the Emacs maintainers, are shown by @kbd{M-x debbugs-gnu-usertags}. The @samp{bug-gnu-emacs} mailing list (also available as the newsgroup @samp{gnu.emacs.bug}). You can read the list archives at @url{http://lists.gnu.org/mailman/listinfo/bug-gnu-emacs}. This list -works as a ``mirror'' of the Emacs bug reports and follow-up messages +works as a mirror of the Emacs bug reports and follow-up messages which are sent to the bug tracker. It also contains old bug reports from before the bug tracker was introduced (in early 2008). @@ -538,10 +538,10 @@ not feel obliged to read this list before reporting a bug. @cindex bug criteria @cindex what constitutes an Emacs bug - If Emacs accesses an invalid memory location (``segmentation -fault''), or exits with an operating system error message that -indicates a problem in the program (as opposed to something like -``disk full''), then it is certainly a bug. + If Emacs accesses an invalid memory location or exits with an +operating system error message that indicates a problem in the program +(as opposed to something like ``disk full''), then it is certainly a +bug. If the Emacs display does not correspond properly to the contents of the buffer, then it is a bug. But you should check that features like @@ -618,7 +618,7 @@ large file, and Emacs displayed @samp{I feel pretty today}.'' This is what we mean by ``guessing explanations''. The problem might be due to the fact that there is a @samp{z} in the file name. If this is so, then when we got your report, we would try out the problem with some -``large file'', probably with no @samp{z} in its name, and not see any +large file, probably with no @samp{z} in its name, and not see any problem. There is no way we could guess that we should try visiting a file with a @samp{z} in its name. @@ -964,7 +964,7 @@ More detailed advice and other useful techniques for debugging Emacs are available in the file @file{etc/DEBUG} in the Emacs distribution. That file also includes instructions for investigating problems whereby Emacs stops responding (many people assume that Emacs is -``hung'', whereas in fact it might be in an infinite loop). +hung, whereas in fact it might be in an infinite loop). To find the file @file{etc/DEBUG} in your Emacs installation, use the directory name stored in the variable @code{data-directory}. @@ -1345,16 +1345,16 @@ Emacs has additional style and coding conventions: @item @ifset WWW_GNU_ORG @ifhtml -the ``Tips'' Appendix in the Emacs Lisp Reference +the ``Tips and Conventions'' Appendix in the Emacs Lisp Reference @url{http://www.gnu.org/software/emacs/manual/html_node/elisp/Tips.html}. @end ifhtml @ifnothtml -@xref{Tips, ``Tips'' Appendix in the Emacs Lisp Reference, Tips +@xref{Tips, ``Tips and Conventions'' Appendix in the Emacs Lisp Reference, Tips Appendix, elisp, Emacs Lisp Reference}. @end ifnothtml @end ifset @ifclear WWW_GNU_ORG -@xref{Tips, ``Tips'' Appendix in the Emacs Lisp Reference, Tips +@xref{Tips, ``Tips and Conventions'' Appendix in the Emacs Lisp Reference, Tips Appendix, elisp, Emacs Lisp Reference}. @end ifclear diff --git a/doc/emacs/vc1-xtra.texi b/doc/emacs/vc1-xtra.texi index 8dccbf9f81c..3eb9b035823 100644 --- a/doc/emacs/vc1-xtra.texi +++ b/doc/emacs/vc1-xtra.texi @@ -430,7 +430,7 @@ that @kbd{C-x v ~} saves old versions to @end ifnottex except for the additional dot (@samp{.}) after the version. The relevant VC commands can use both kinds of version backups. The main -difference is that the ``manual'' version backups made by @kbd{C-x v +difference is that the manual version backups made by @kbd{C-x v ~} are not deleted automatically when you commit. @cindex locking (CVS) diff --git a/doc/emacs/windows.texi b/doc/emacs/windows.texi index 24cc946ac12..cb37222e967 100644 --- a/doc/emacs/windows.texi +++ b/doc/emacs/windows.texi @@ -334,18 +334,18 @@ heights of all the windows in the selected frame. @node Displaying Buffers @section Displaying a Buffer in a Window - It is a common Emacs operation to display or ``pop up'' some buffer + It is a common Emacs operation to display or pop up some buffer in response to a user command. There are several different ways in which commands do this. Many commands, like @kbd{C-x C-f} (@code{find-file}), display the -buffer by ``taking over'' the selected window, expecting that the +buffer by taking over the selected window, expecting that the user's attention will be diverted to that buffer. These commands usually work by calling @code{switch-to-buffer} internally (@pxref{Select Buffer}). @findex display-buffer - Some commands try to display ``intelligently'', trying not to take + Some commands try to display intelligently, trying not to take over the selected window, e.g., by splitting off a new window and displaying the desired buffer there. Such commands, which include the various help commands (@pxref{Help}), work by calling @@ -398,7 +398,7 @@ variables are @code{nil}, so this step is skipped. @item Otherwise, if the buffer is already displayed in an existing window, -``reuse'' that window. Normally, only windows on the selected frame +reuse that window. Normally, only windows on the selected frame are considered, but windows on other frames are also reusable if you change @code{pop-up-frames} (see below) to @code{t}. @@ -444,7 +444,7 @@ and display the buffer there. @cindex window configuration changes, undoing Winner mode is a global minor mode that records the changes in the window configuration (i.e., how the frames are partitioned into -windows), so that you can ``undo'' them. You can toggle Winner mode +windows), so that you can undo them. You can toggle Winner mode with @kbd{M-x winner-mode}, or by customizing the variable @code{winner-mode}. When the mode is enabled, @kbd{C-c left} (@code{winner-undo}) undoes the last window configuration change. If @@ -462,7 +462,7 @@ buffer. @xref{Follow Mode}. The Windmove package defines commands for moving directionally between neighboring windows in a frame. @kbd{M-x windmove-right} selects the window immediately to the right of the currently selected -one, and similarly for the ``left'', ``up'', and ``down'' +one, and similarly for the left, up, and down counterparts. @kbd{M-x windmove-default-keybindings} binds these commands to @kbd{S-right} etc.; doing so disables shift selection for those keys (@pxref{Shift Selection}). diff --git a/doc/emacs/xresources.texi b/doc/emacs/xresources.texi index 25552d1e895..afd27669967 100644 --- a/doc/emacs/xresources.texi +++ b/doc/emacs/xresources.texi @@ -12,10 +12,10 @@ resources, as is usual for programs that use X. graphical widgets, such as the menu-bar, scroll-bar, and dialog boxes, is determined by @ifnottex -``GTK resources'', which we will also describe. +GTK resources, which we will also describe. @end ifnottex @iftex -``GTK resources''. +GTK resources. @end iftex When Emacs is built without GTK+ support, the appearance of these widgets is determined by additional X resources. @@ -238,8 +238,8 @@ this way. @ifnottex @item @code{privateColormap} (class @code{PrivateColormap}) -If @samp{on}, use a private color map, in the case where the ``default -visual'' of class PseudoColor and Emacs is using it. +If @samp{on}, use a private color map, in the case where the default +visual of class PseudoColor and Emacs is using it. @item @code{reverseVideo} (class @code{ReverseVideo}) Switch foreground and background default colors if @samp{on}, use colors as @@ -677,7 +677,7 @@ class @code{GtkDialog}. For file selection, Emacs uses a widget named @code{emacs-filedialog}, of class @code{GtkFileSelection}. Because the widgets for pop-up menus and dialogs are free-standing -windows and not ``contained'' in the @code{Emacs} widget, their GTK+ +windows and not contained in the @code{Emacs} widget, their GTK+ absolute names do not start with @samp{Emacs}. To customize these widgets, use wildcards like this: @@ -747,8 +747,8 @@ This is the default state for widgets. @item ACTIVE This is the state for a widget that is ready to do something. It is also for the trough of a scroll bar, i.e., @code{bg[ACTIVE] = "red"} -sets the scroll bar trough to red. Buttons that have been pressed but -not released yet (``armed'') are in this state. +sets the scroll bar trough to red. Buttons that have been armed +(pressed but not released yet) are in this state. @item PRELIGHT This is the state for a widget that can be manipulated, when the mouse pointer is over it---for example when the mouse is over the thumb in |