diff options
Diffstat (limited to 'man')
| -rw-r--r-- | man/ChangeLog | 89 | ||||
| -rw-r--r-- | man/building.texi | 12 | ||||
| -rw-r--r-- | man/calc.texi | 16 | ||||
| -rw-r--r-- | man/calendar.texi | 54 | ||||
| -rw-r--r-- | man/files.texi | 2 | ||||
| -rw-r--r-- | man/gnus-faq.texi | 11 | ||||
| -rw-r--r-- | man/gnus.texi | 28 | ||||
| -rw-r--r-- | man/info.texi | 34 | ||||
| -rw-r--r-- | man/msdog.texi | 2 | ||||
| -rw-r--r-- | man/sc.texi | 2 | ||||
| -rw-r--r-- | man/search.texi | 24 | ||||
| -rw-r--r-- | man/text.texi | 213 | ||||
| -rw-r--r-- | man/tramp.texi | 3 | ||||
| -rw-r--r-- | man/trampver.texi | 2 |
14 files changed, 324 insertions, 168 deletions
diff --git a/man/ChangeLog b/man/ChangeLog index fc0bd61497..8aec01712e 100644 --- a/man/ChangeLog +++ b/man/ChangeLog @@ -1,3 +1,90 @@ +2004-10-12 Reiner Steib <[email protected]> + + * gnus-faq.texi ([5.9]): Improve code for reply-in-news. + +2004-10-12 Michael Albinus <[email protected]> + + Sync with Tramp 2.0.45. + + * tramp.texi (Frequently Asked Questions): Comment paragraph about + plink link. The URL is outdated. Originator contacted for + clarification. + +2004-10-10 Juri Linkov <[email protected]> + + * gnus.texi (Top, Marking Articles): Join two menus in one node + because a node can have only one menu. + +2004-10-09 Luc Teirlinck <[email protected]> + + * files.texi (Misc File Ops): View mode is a minor mode. + +2004-10-09 Juri Linkov <[email protected]> + + * gnus.texi (Fancy Mail Splitting): Remove backslash in the + example of nnmail-split-fancy. + +2004-10-08 Glenn Morris <[email protected]> + + * calendar.texi (iCalendar): Style changes. + +2004-10-07 Luc Teirlinck <[email protected]> + + * search.texi (Regexps): The regexp described in the example is no + longer stored in the variable `sentence-end'. + +2004-10-06 Karl Berry <[email protected]> + + * info.texi (@kbd{1}--@kbd{9}): no space around --, for + consistency with other uses of dashes. + +2004-10-06 Nick Roberts <[email protected]> + + * building.texi (Starting GUD): Note that multiple debugging + sessions requires `gdb --fullname'. + +2004-10-05 Ulf Jasper <[email protected]> + + * calendar.texi (iCalendar): New section for a new package. + +2004-10-05 Karl Berry <[email protected]> + + * info.texi: consistently use --- throughout, periods at end of + menu descriptions, and a couple typos. + +2004-10-05 Luc Teirlinck <[email protected]> + + * text.texi: Various small changes in addition to the following. + (Text): Replace xref for autotype with inforef. + (Sentences): Explain nil value for `sentence-end'. + (Paragraphs): Update default values for `paragraph-start' and + `paragraph-separate'. + (Text Mode): Correct description of Text mode's effect on the + syntax table. + (Outline Visibility): `hide-other' does not hide top level headings. + `selective-display-ellipses' no longer has an effect on Outline mode. + (TeX Misc): Add missing @cindex. + Replace xref for RefTeX with inforef. + (Requesting Formatted Text): the variable + `enriched-fill-after-visiting' no longer exists. + (Editing Format Info): Update names of menu items and commands. + (Format Faces): Mention special effect of specifying the default face. + Describe inheritance of text properties. + Correct description of `fixed' face. + (Format Indentation): Correct description of effect of setting + margins. Mention `set-left-margin' and `set-right-margin'. + (Format Justification): Update names of menu items. + `set-justification-full' is now bound to `M-j b'. + Mention that `default-justification' is a per buffer variable. + (Format Properties): Update name of menu item. + (Forcing Enriched Mode): `format-decode-buffer' automatically + turns on Enriched mode if the buffer is in text/enriched format. + + +2004-10-05 Emilio C. Lopes <[email protected]> + + * calendar.texi (From Other Calendar): Add calendar-goto-iso-week. + 2004-09-28 Kim F. Storm <[email protected]> * display.texi (Display Custom) <indicate-buffer-boundaries>: @@ -893,7 +980,7 @@ * misc.texi: Section "Saving Emacs Sessions" rewritten. -2003-09-29 Jan D. <[email protected]> +2003-09-29 Jan Dj,Ad(Brv. <[email protected]> * xresources.texi (GTK names in Emacs): Correct typo. diff --git a/man/building.texi b/man/building.texi index 972f88abbd..2ec96b0f6b 100644 --- a/man/building.texi +++ b/man/building.texi @@ -336,11 +336,13 @@ to a particular debugger program. @findex gdb Run GDB as a subprocess of Emacs. If the variable @code{gud-gdb-command-name} is ``gdb --annotate=3'' (the default -value) then GDB starts as for @kbd{M-x gdba} below. If you want to -GDB to start as in Emacs 21.3 and earlier then set -@code{gud-gdb-command-name} to ``gdb --fullname''. In this case, the -command creates a buffer for input and output to GDB, and switches to -it. If a GDB buffer already exists, it just switches to that buffer. +value) then GDB starts as for @kbd{M-x gdba} below. If you want GDB +to start as in Emacs 21.3 and earlier then edit the string in the +minibuffer or set @code{gud-gdb-command-name} to ``gdb --fullname''. +You need to do this if you want to run multiple debugging sessions +within one Emacs session. In this case, the command creates a buffer +for input and output to GDB, and switches to it. If a GDB buffer +already exists, it just switches to that buffer. @item M-x gdba @key{RET} @var{file} @key{RET} Run GDB as a subprocess of Emacs, providing a graphical interface diff --git a/man/calc.texi b/man/calc.texi index 8c3a3c5f92..a77ba4eb26 100644 --- a/man/calc.texi +++ b/man/calc.texi @@ -10026,19 +10026,17 @@ additional notes from the summary that apply to this command. @kindex h f @pindex calc-describe-function The @kbd{h f} (@code{calc-describe-function}) command looks up an -algebraic function or a command name in the Calc manual. The -prompt initially contains @samp{calcFunc-}; follow this with an +algebraic function or a command name in the Calc manual. Enter an algebraic function name to look up that function in the Function -Index. Or, backspace and enter a command name beginning with -@samp{calc-} to look it up in the Command Index. This command -will also look up operator symbols that can appear in algebraic -formulas, like @samp{%} and @samp{=>}. +Index or enter a command name beginning with @samp{calc-} to look it +up in the Command Index. This command will also look up operator +symbols that can appear in algebraic formulas, like @samp{%} and +@samp{=>}. @kindex h v @pindex calc-describe-variable The @kbd{h v} (@code{calc-describe-variable}) command looks up a -variable in the Calc manual. The prompt initially contains the -@samp{var-} prefix; just add a variable name like @code{pi} or +variable in the Calc manual. Enter a variable name like @code{pi} or @code{PlotRejects}. @kindex h b @@ -21981,7 +21979,7 @@ back on. The most basic default simplification is the evaluation of functions. For example, @cite{2 + 3} is evaluated to @cite{5}, and @cite{@t{sqrt}(9)} is evaluated to @cite{3}. Evaluation does not occur if the arguments -to a function are somehow of the wrong type (@cite{@t{tan}([2,3,4])}, +to a function are somehow of the wrong type (@cite{@t{tan}([2,3,4])}), range (@cite{@t{tan}(90)}), or number (@cite{@t{tan}(3,5)}), or if the function name is not recognized (@cite{@t{f}(5)}), or if ``symbolic'' mode (@pxref{Symbolic Mode}) prevents evaluation (@cite{@t{sqrt}(2)}). diff --git a/man/calendar.texi b/man/calendar.texi index 9e3d3cf9f4..45b3ed318b 100644 --- a/man/calendar.texi +++ b/man/calendar.texi @@ -37,6 +37,7 @@ information about the calendar and diary. * Other Calendars:: Converting dates to other calendar systems. * Diary:: Displaying events from your diary. * Appointments:: Reminders when it's time to do something. +* iCalendar:: Converting diary events to/from iCalendar format. * Daylight Savings:: How to specify when daylight savings time is active. * Time Intervals:: Keeping track of time intervals. @end menu @@ -754,6 +755,7 @@ other than Mayan; for the Mayan calendar, see the following section. @kindex g @var{char} @r{(Calendar mode)} @findex calendar-goto-iso-date +@findex calendar-goto-iso-week @findex calendar-goto-julian-date @findex calendar-goto-astro-day-number @findex calendar-goto-hebrew-date @@ -767,6 +769,9 @@ other than Mayan; for the Mayan calendar, see the following section. @item g c Move to a date specified in the ISO commercial calendar (@code{calendar-goto-iso-date}). +@item g w +Move to a week specified in the ISO commercial calendar +(@code{calendar-goto-iso-week}). @item g j Move to a date specified in the Julian calendar (@code{calendar-goto-julian-date}). @@ -1379,6 +1384,55 @@ clock. The command @kbd{M-x appt-add} adds entries to the appointment list without affecting your diary file. You delete entries from the appointment list with @kbd{M-x appt-delete}. +@node iCalendar +@section iCalendar +@cindex iCalendar support + + The icalendar package aims at providing an implementation of the +iCalendar standard, as defined in ``RFC 2445 -- Internet Calendaring and +Scheduling Core Object Specification (iCalendar)''. It provides a means +for importing iCalendar (and the earlier vCalendar format) data into +Emacs diary files and vice versa. + + Importing works for ``ordinary'' (i.e. non-recurring) events, but (at +present) may not work correctly (if at all) for recurring events. +Exporting of diary files into iCalendar files should work correctly for +most diary entries. Please note that @file{icalendar.el} is work in +progress, so usage may evolve in future. + + To activate the package, use @code{(require 'icalendar)}. + +@findex icalendar-extract-ical-from-buffer + The command @code{icalendar-extract-ical-from-buffer} extracts +iCalendar data from the current buffer and adds it to your (default) +diary file. This function is also suitable for automatic extraction of +iCalendar data; for example with the Rmail mail client one could use: + +@example +(add-hook 'rmail-show-message-hook 'icalendar-extract-ical-from-buffer) +@end example + +@findex icalendar-import-file + The command @code{icalendar-import-file} imports an iCalendar file. +@strong{Caution:} the contents of the target diary file are +@emph{deleted} by default! It is highly recommended to use a dedicated +diary file for importing. For example: + +@example +(icalendar-import-file "/here/is/calendar.ics" "/there/goes/ical-diary") +@end example + +@noindent +You can use an @code{#include} directive to add the import file contents +to the diary. @xref{Fancy Diary Display,,, elisp, The Emacs Lisp +Reference Manual}. + +@findex icalendar-convert-diary-to-ical + The command @code{icalendar-convert-diary-to-ical} exports an Emacs +diary file to iCalendar format. @strong{Caution:} the contents of the +target file are @emph{deleted} by default! + + @node Daylight Savings @section Daylight Savings Time @cindex daylight savings time diff --git a/man/files.texi b/man/files.texi index b5ebf7cf82..4e36c2ab2f 100644 --- a/man/files.texi +++ b/man/files.texi @@ -2858,7 +2858,7 @@ or @key{DEL} to scroll backward. Various other commands are provided for moving around in the file, but none for changing it; type @kbd{?} while viewing for a list of them. They are mostly the same as normal Emacs cursor motion commands. To exit from viewing, type @kbd{q}. -The commands for viewing are defined by a special major mode called View +The commands for viewing are defined by a special minor mode called View mode. A related command, @kbd{M-x view-buffer}, views a buffer already present diff --git a/man/gnus-faq.texi b/man/gnus-faq.texi index 6f0fddc556..5d243f8a02 100644 --- a/man/gnus-faq.texi +++ b/man/gnus-faq.texi @@ -1776,11 +1776,14 @@ Answer: @example -(defadvice gnus-summary-reply (around reply-in-news activate) +(eval-after-load "gnus-msg" + '(unless (boundp 'gnus-confirm-mail-reply-to-news) + (defadvice gnus-summary-reply (around reply-in-news activate) + "Request confirmation when replying to news." (interactive) - (when (or (not (gnus-news-group-p gnus-newsgroup-name)) - (y-or-n-p "Really reply? ")) - ad-do-it)) + (when (or (not (gnus-news-group-p gnus-newsgroup-name)) + (y-or-n-p "Really reply by mail to article author? ")) + ad-do-it)))) @end example @ifnottex diff --git a/man/gnus.texi b/man/gnus.texi index c94845c7a8..a62e9bcf14 100644 --- a/man/gnus.texi +++ b/man/gnus.texi @@ -535,12 +535,9 @@ Marking Articles * Unread Articles:: Marks for unread articles. * Read Articles:: Marks for read articles. * Other Marks:: Marks that do not affect readedness. - -Marking Articles - -* Setting Marks:: How to set and remove marks. -* Generic Marking Commands:: How to customize the marking. -* Setting Process Marks:: How to mark articles for later processing. +* Setting Marks:: How to set and remove marks. +* Generic Marking Commands:: How to customize the marking. +* Setting Process Marks:: How to mark articles for later processing. Threading @@ -5686,20 +5683,17 @@ neologism ohoy!) of the article. Alphabetic marks generally mean In addition, you also have marks that do not affect readedness. -@menu -* Unread Articles:: Marks for unread articles. -* Read Articles:: Marks for read articles. -* Other Marks:: Marks that do not affect readedness. -@end menu - @ifinfo -There's a plethora of commands for manipulating these marks: +There's a plethora of commands for manipulating these marks. @end ifinfo @menu -* Setting Marks:: How to set and remove marks. -* Generic Marking Commands:: How to customize the marking. -* Setting Process Marks:: How to mark articles for later processing. +* Unread Articles:: Marks for unread articles. +* Read Articles:: Marks for read articles. +* Other Marks:: Marks that do not affect readedness. +* Setting Marks:: How to set and remove marks. +* Generic Marking Commands:: How to customize the marking. +* Setting Process Marks:: How to mark articles for later processing. @end menu @@ -14002,7 +13996,7 @@ Let's look at an example value of this variable first: ;; @r{the bugs- list, but allow cross-posting when the} ;; @r{message was really cross-posted.} (any "bugs-mypackage@@somewhere" "mypkg.bugs") - (any "mypackage@@somewhere\" - "bugs-mypackage" "mypkg.list") + (any "mypackage@@somewhere" - "bugs-mypackage" "mypkg.list") ;; @r{People@dots{}} (any "larsi@@ifi\\.uio\\.no" "people.Lars_Magne_Ingebrigtsen")) ;; @r{Unmatched mail goes to the catch all group.} diff --git a/man/info.texi b/man/info.texi index 2e42a0b9ed..014e916508 100644 --- a/man/info.texi +++ b/man/info.texi @@ -130,15 +130,15 @@ the screen. @end ifnotinfo @menu -* Help-Small-Screen:: Starting Info on a Small Screen -* Help:: How to use Info -* Help-P:: Returning to the Previous node +* Help-Small-Screen:: Starting Info on a Small Screen. +* Help:: How to use Info. +* Help-P:: Returning to the Previous node. * Help-^L:: The Space, DEL, B and ^L commands. * Help-Inv:: Invisible text in Emacs Info. -* Help-M:: Menus -* Help-Xref:: Following cross-references -* Help-Int:: Some intermediate Info commands -* Help-Q:: Quitting Info +* Help-M:: Menus. +* Help-Xref:: Following cross-references. +* Help-Int:: Some intermediate Info commands. +* Help-Q:: Quitting Info. @end menu @node Help-Small-Screen @@ -212,8 +212,8 @@ This is line 59 If you have managed to get here, go back to the beginning with @kbd{DEL} (or @key{BACKSPACE}), and come back here again, then you understand the about the @samp{Space} and @samp{Backspace} keys. So -now type an @kbd{n} ---just one character; don't type the quotes and -don't type the Return key afterward--- to get to the normal start of +now type an @kbd{n}---just one character; don't type the quotes and +don't type the Return key afterward---to get to the normal start of the course. @end ifinfo @@ -243,8 +243,8 @@ well. In Emacs, the header line is duplicated in a special typeface, and the duplicate remains at the top of the window all the time even if you scroll through the node. - Besides a @samp{Next}, a node can have a @samp{Previous} or an -@samp{Up} links, or both. As you can see, this node has all of these + Besides a @samp{Next}, a node can have a @samp{Previous} link, or an +@samp{Up} link, or both. As you can see, this node has all of these links. @kindex n @r{(Info mode)} @@ -375,7 +375,7 @@ scroll beyond the beginning or the end of the current node. @kindex C-l @r{(Info mode)} If your screen is ever garbaged, you can tell Info to display it -again by typing @kbd{C-l} (@kbd{Control-L}, that is---hold down +again by typing @kbd{C-l} (@kbd{Control-L}---that is, hold down @key{CTRL} and type @kbd{L} or @kbd{l}). @format @@ -414,8 +414,8 @@ the list, make it go away by typing a @key{SPC} repeatedly. (If you are using the stand-alone Info reader, type @kbd{C-x 0} to return here, that is---press and hold @key{CTRL}, type an @kbd{x}, -then release @key{CTRL} and @kbd{x}, and press @kbd{0}---a zero, not -the letter ``o''.) +then release @key{CTRL} and @kbd{x}, and press @kbd{0}; that's a zero, +not the letter ``o''.) From now on, you will encounter large nodes without warning, and will be expected to know how to use @key{SPC} and @key{BACKSPACE} to @@ -971,7 +971,7 @@ the node @samp{Top} in the Info file @file{dir}. Likewise, all of the current file by typing @kbd{g*@key{RET}} or all of any other file with @kbd{g(@var{filename})@key{RET}}. -@subheading @kbd{1} -- @kbd{9} choose a menu subtopic by its number +@subheading @kbd{1}--@kbd{9} choose a menu subtopic by its number @kindex 1 @r{through} 9 @r{(Info mode)} @findex Info-nth-menu-item @@ -1061,7 +1061,7 @@ you typed @emph{as a substring}. For each match, Info shows in the echo area the full index entry it found. Often, the text of the full index entry already gives you enough information to decide whether it is relevant to what you are looking for, so we recommend that you read -what Emacs shows in the echo area before looking at the node it +what Info shows in the echo area before looking at the node it displays. Since @kbd{i} looks for a substring, you can search for subjects even @@ -1205,7 +1205,7 @@ reads from the terminal. A menu begins with a line starting with @w{@samp{* Menu:}}. The rest of the line is a comment. After the starting line, every line that begins with a @samp{* } lists a single topic. The name of the -topic--what the user must type at the @kbd{m}'s command prompt to +topic---what the user must type at the @kbd{m}'s command prompt to select this topic---comes right after the star and space, and is followed by a colon, spaces and tabs, and the name of the node which discusses that topic. The node name, like node names following diff --git a/man/msdog.texi b/man/msdog.texi index 157eba2884..dec258ec67 100644 --- a/man/msdog.texi +++ b/man/msdog.texi @@ -840,7 +840,7 @@ effect of bringing up the Windows menu, it alters the meaning of subsequent commands. Many users find this frustrating. @vindex w32-pass-alt-to-system -You can reenable Windows's default handling of tapping the @key{ALT} key +You can re-enable Windows' default handling of tapping the @key{ALT} key by setting @code{w32-pass-alt-to-system} to a non-@code{nil} value. @ignore diff --git a/man/sc.texi b/man/sc.texi index 5e911e2df7..11ae3d139c 100644 --- a/man/sc.texi +++ b/man/sc.texi @@ -1565,7 +1565,7 @@ incorrectly. @vindex sc-use-only-preference-p @vindex use-only-preference-p (sc-) Also, if the preferred attribution, which you specified in your -@code{sc-preferred-attribution-alist} variable cannot be found, a +@code{sc-preferred-attribution-list} variable cannot be found, a secondary method can be employed to find a valid attribution string. The variable @code{sc-use-only-preference-p} controls what happens in this case. If the variable's value is non-@code{nil}, then diff --git a/man/search.texi b/man/search.texi index 58265341c2..0f5e871630 100644 --- a/man/search.texi +++ b/man/search.texi @@ -1,5 +1,5 @@ @c This is part of the Emacs manual. -@c Copyright (C) 1985, 86, 87, 93, 94, 95, 97, 2000, 2001 +@c Copyright (C) 1985, 86, 87, 93, 94, 95, 97, 2000, 2001, 2004 @c Free Software Foundation, Inc. @c See file emacs.texi for copying conditions. @node Search, Fixit, Display, Top @@ -193,9 +193,11 @@ repeat the search will then search for a string including that character or word. @kbd{C-y} is similar to @kbd{C-w} but copies all the rest of the -current line into the search string. Both @kbd{C-y} and @kbd{C-w} -convert the text they copy to lower case if the search is currently -not case-sensitive; this is so the search remains case-insensitive. +current line into the search string. If point is already at the end +of a line, it grabs the entire next line. Both @kbd{C-y} and +@kbd{C-w} convert the text they copy to lower case if the search is +currently not case-sensitive; this is so the search remains +case-insensitive. @kbd{C-M-w} and @kbd{C-M-y} modify the search string by only one character at a time: @kbd{C-M-w} deletes the last character from the @@ -777,13 +779,13 @@ matches any character that does @emph{not} belong to category The constructs that pertain to words and syntax are controlled by the setting of the syntax table (@pxref{Syntax}). - Here is a complicated regexp, stored in @code{sentence-end} and used -by Emacs to recognize the end of a sentence together with any -whitespace that follows. We show its Lisp syntax to distinguish the -spaces from the tab characters. In Lisp syntax, the string constant -begins and ends with a double-quote. @samp{\"} stands for a -double-quote as part of the regexp, @samp{\\} for a backslash as part -of the regexp, @samp{\t} for a tab, and @samp{\n} for a newline. + Here is a complicated regexp. It is a simplified version of the +regexp that Emacs uses, by default, to recognize the end of a sentence +together with any whitespace that follows. We show its Lisp syntax to +distinguish the spaces from the tab characters. In Lisp syntax, the +string constant begins and ends with a double-quote. @samp{\"} stands +for a double-quote as part of the regexp, @samp{\\} for a backslash as +part of the regexp, @samp{\t} for a tab, and @samp{\n} for a newline. @example "[.?!][]\"')]*\\($\\| $\\|\t\\| \\)[ \t\n]*" diff --git a/man/text.texi b/man/text.texi index dbf990a2b5..01405ae525 100644 --- a/man/text.texi +++ b/man/text.texi @@ -1,5 +1,5 @@ @c This is part of the Emacs manual. -@c Copyright (C) 1985,86,87,93,94,95,97,2000,2001, 2002 +@c Copyright (C) 1985,86,87,93,94,95,97,2000,2001, 2002, 2004 @c Free Software Foundation, Inc. @c See file emacs.texi for copying conditions. @node Text, Programs, Indentation, Top @@ -55,7 +55,7 @@ Then the formatting appears on the screen in Emacs while you edit. @cindex autotyping @cindex automatic typing The ``automatic typing'' features may be useful when writing text. -@xref{Top,, Autotyping, autotype, Features for Automatic Typing}. +@inforef{Top,, autotype}. @menu * Words:: Moving over and killing words. @@ -215,10 +215,12 @@ followed by the end of a line or two spaces, with any number of A sentence also begins or ends wherever a paragraph begins or ends. @vindex sentence-end - The variable @code{sentence-end} controls recognition of the end of a -sentence. It is a regexp that matches the last few characters of a -sentence, together with the whitespace following the sentence. Its -normal value is + The variable @code{sentence-end} controls recognition of the end of +a sentence. If non-@code{nil}, it is a regexp that matches the last +few characters of a sentence, together with the whitespace following +the sentence. If the value is @code{nil}, the default, then Emacs +computes the regexp according to various criteria. The result is +normally similar to the following regexp: @example "[.?!][]\"')]*\\($\\| $\\|\t\\| \\)[ \t\n]*" @@ -298,9 +300,10 @@ that either starts or separates paragraphs. The value of that separate paragraphs without being part of any paragraph (for example, blank lines). Lines that start a new paragraph and are contained in it must match only @code{paragraph-start}, not -@code{paragraph-separate}. For example, in Fundamental mode, -@code{paragraph-start} is @w{@code{"[ \t\n\f]"}}, and -@code{paragraph-separate} is @w{@code{"\f\\|[ \t]*$"}}. +@code{paragraph-separate}. Each regular expression must match at the +left margin. For example, in Fundamental mode, @code{paragraph-start} +is @w{@code{"\f\\|[ \t]*$"}}, and @code{paragraph-separate} is +@w{@code{"[ \t\f]*$"}}. Normally it is desirable for page boundaries to separate paragraphs. The default values of these variables recognize the usual separator for @@ -312,9 +315,9 @@ pages. @cindex pages @cindex formfeed Files are often thought of as divided into @dfn{pages} by the -@dfn{formfeed} character (@acronym{ASCII} control-L, octal code 014). When you -print hardcopy for a file, this character forces a page break; thus, -each page of the file goes on a separate page on paper. Most Emacs +@dfn{formfeed} character (@acronym{ASCII} control-L, octal code 014). +When you print hardcopy for a file, this character forces a page break; +thus, each page of the file goes on a separate page on paper. Most Emacs commands treat the page-separator character just like any other character: you can insert it with @kbd{C-q C-l}, and delete it with @key{DEL}. Thus, you are free to paginate your file or not. However, @@ -575,7 +578,7 @@ period. Set the variable @code{sentence-end-without-period} to conditions for where line-breaking is allowed. Its value is either @code{nil} or a Lisp function; the function is called with no arguments, and if it returns a non-@code{nil} value, then point is not -a good place to break the line. The standard functions you can use +a good place to break the line. Two standard functions you can use are @code{fill-single-word-nobreak-p} (don't break after the first word of a sentence or before the last) and @code{fill-french-nobreak-p} (don't break after @samp{(} or before @samp{)}, @samp{:} or @samp{?}). @@ -606,11 +609,12 @@ a new paragraph. @kindex C-x . @findex set-fill-prefix - To specify a fill prefix, move to a line that starts with the desired -prefix, put point at the end of the prefix, and give the command -@w{@kbd{C-x .}}@: (@code{set-fill-prefix}). That's a period after the -@kbd{C-x}. To turn off the fill prefix, specify an empty prefix: type -@w{@kbd{C-x .}}@: with point at the beginning of a line.@refill + To specify a fill prefix for the current buffer, move to a line that +starts with the desired prefix, put point at the end of the prefix, +and give the command @w{@kbd{C-x .}}@: (@code{set-fill-prefix}). +That's a period after the @kbd{C-x}. To turn off the fill prefix, +specify an empty prefix: type @w{@kbd{C-x .}}@: with point at the +beginning of a line.@refill When a fill prefix is in effect, the fill commands remove the fill prefix from each line before filling and insert it on each line after @@ -824,14 +828,14 @@ filling determines what indentation to use when filling a paragraph. @kindex TAB @r{(Text mode)} Text mode defines @key{TAB} to run @code{indent-relative} (@pxref{Indentation}), so that you can conveniently indent a line like -the previous line. When the previous line is not indented, -@code{indent-relative} runs @code{tab-to-tab-stop}, which uses Emacs tab -stops that you can set (@pxref{Tab Stops}). +the previous line. Text mode turns off the features concerned with comments except when -you explicitly invoke them. It changes the syntax table so that periods -are not considered part of a word, while apostrophes, backspaces and -underlines are considered part of words. +you explicitly invoke them. It changes the syntax table so that +single-quotes are considered part of words. However, if a word starts +with single-quotes, then these are treated as a prefix for purposes +such as capitalization. That is, @kbd{M-c} will convert +@samp{'hello'} into @samp{'Hello'}, as expected. @cindex Paragraph-Indent Text mode @cindex mode, Paragraph-Indent Text @@ -896,8 +900,8 @@ invisible lines follow). Editing commands that operate on lines, such as @kbd{C-n} and @kbd{C-p}, treat the text of the invisible line as part of the previous -visible line. Killing an entire visible line, including its terminating -newline, really kills all the following invisible lines along with it. +visible line. Killing the ellipsis at the end of a visible line +really kills all the following invisible lines. Outline minor mode provides the same commands as the major mode, Outline mode, but you can use it in conjunction with other major modes. @@ -1137,12 +1141,9 @@ except the top @var{n} levels of heading lines. @findex hide-other @kindex C-c C-o @r{(Outline mode)} The command @kbd{C-c C-o} (@code{hide-other}) hides everything except -the heading or body text that point is in, plus its parents (the headers -leading up from there to top level in the outline). - - You can turn off the use of ellipses at the ends of visible lines by -setting @code{selective-display-ellipses} to @code{nil}. Then there is -no visible indication of the presence of invisible lines. +the heading and body text that point is in, plus its parents (the headers +leading up from there to top level in the outline) and the top level +headings. @findex reveal-mode When incremental search finds text that is hidden by Outline mode, @@ -1180,7 +1181,7 @@ buffers. nested portion of the outline, while hiding its relatives at higher levels. - Consider an Outline mode buffer all the text and subheadings under + Consider an Outline mode buffer with all the text and subheadings under level-1 headings hidden. To look at what is hidden under one of these headings, you could use @kbd{C-c C-e} (@kbd{M-x show-entry}) to expose the body, or @kbd{C-c C-i} to expose the child (level-2) headings. @@ -1215,8 +1216,8 @@ particular chapter or section of your document. To unzoom (exit) a fold, use @kbd{C-c C-x} (@kbd{M-x foldout-exit-fold}). This hides all the text and subheadings under the top-level heading and returns you to the previous view of the buffer. Specifying a numeric -argument exits that many levels of folds. Specifying a zero argument exits all -folds. +argument exits that many levels of folds. Specifying a zero argument +exits all folds. To cancel the narrowing of a fold without hiding the text and subheadings, specify a negative argument. For example, @kbd{M--2 C-c @@ -1633,7 +1634,7 @@ current buffer's file. Generally, you need to do @kbd{C-c C-f} @findex iso-iso2gtex @findex iso-gtex2iso @cindex Latin-1 @TeX{} encoding -@TeX{} encoding +@cindex @TeX{} encoding The commands @kbd{M-x iso-iso2tex}, @kbd{M-x iso-tex2iso}, @kbd{M-x iso-iso2gtex} and @kbd{M-x iso-gtex2iso} can be used to convert between Latin-1 encoded files and @TeX{}-encoded equivalents. @@ -1659,7 +1660,7 @@ required. This is set up for Czech---customize the group @cindex references, La@TeX{} @cindex La@TeX{} references For managing all kinds of references for La@TeX{}, you can use -Ref@TeX{}. @xref{Top, , RefTeX, reftex}. +Ref@TeX{}. @inforef{Top,, reftex}. @node HTML Mode @section SGML, XML, and HTML Modes @@ -1880,16 +1881,6 @@ into the file. When you visit the file again, Emacs will automatically recognize the format, reconvert the text, and turn on Enriched mode again. -@vindex enriched-fill-after-visiting - Normally, after visiting a file in text/enriched format, Emacs refills -each paragraph to fit the specified right margin. You can turn off this -refilling, to save time, by setting the variable -@code{enriched-fill-after-visiting} to @code{nil} or to @code{ask}. - - However, when visiting a file that was saved from Enriched mode, there -is no need for refilling, because Emacs saves the right margin settings -along with the text. - @vindex enriched-translations You can add annotations for saving additional text properties, which Emacs normally does not save, by adding to @code{enriched-translations}. @@ -1951,22 +1942,22 @@ commands directly: @table @code @findex facemenu-remove-face-props @item Remove Face Properties -Delete from the region all the text properties that the Text Properties -menu works with (@code{facemenu-remove-face-props}). +Delete from the region all face and color text properties +(@code{facemenu-remove-face-props}). @findex facemenu-remove-all -@item Remove All +@item Remove Text Properties Delete @emph{all} text properties from the region (@code{facemenu-remove-all}). -@findex describe-text-at +@findex describe-text-properties @cindex text properties of characters @cindex overlays at character position @cindex widgets at buffer position @cindex buttons at buffer position -@item Describe Text +@item Describe Properties List all the text properties, widgets, buttons, and overlays of the -character following point (@code{describe-text-at}). +character following point (@code{describe-text-properties}). @item Display Faces Display a list of all the defined faces (@code{list-faces-display}). @@ -2018,8 +2009,20 @@ Set the region, or the next inserted character, to the face @var{face} If you use these commands with a prefix argument---or, in Transient Mark mode, if the region is not active---then these commands specify a face -to use for your next self-inserting input. @xref{Transient Mark}. This -applies to both the keyboard commands and the menu commands. +to use for any immediately following self-inserting input. +@xref{Transient Mark}. This applies to both the keyboard commands and +the menu commands. + + Specifying the @code{default} face also resets foreground and +background color to their defaults.(@pxref{Format Colors}). + + Any self-inserting character you type inherits, by default, the face +properties (as well as most other text properties) of the preceding +character. Specifying any face property, including foreground or +background color, for your next self-inserting character will prevent +it from inheriting any face properties from the preceding character, +although it will still inherit other text properties. Characters +inserted by yanking do not inherit text properties. Enriched mode defines two additional faces: @code{excerpt} and @code{fixed}. These correspond to codes used in the text/enriched file @@ -2029,20 +2032,17 @@ format. same as @code{italic} unless you customize it (@pxref{Face Customization}). The @code{fixed} face means, ``Use a fixed-width font for this part -of the text.'' This makes a visible difference only if you have -specified a variable-width font in the default face; however, even if -the default font is fixed-width, applying the @code{fixed} face to a -part of the text will cause that part of the text to appear in a -fixed-width font, if the file is ever displayed with a variable-width -default font. This applies to Emacs and to other systems that display -text/enriched format. So if you specifically want a certain part of -the text to use a fixed-width font, you should specify the -@code{fixed} face for that part. - - The @code{fixed} face is normally set up to use a different font -from the default, even if the default face is also fixed-width. -Different systems have different fonts installed, so you may need to -customize this. @xref{Face Customization}. +of the text.'' Applying the @code{fixed} face to a part of the text +will cause that part of the text to appear in a fixed-width font, even +if the default font is variable-width. This applies to Emacs and to +other systems that display text/enriched format. So if you +specifically want a certain part of the text to use a fixed-width +font, you should specify the @code{fixed} face for that part. + + By default, the @code{fixed} face looks the same as @code{bold}. +This is an attempt to distinguish it from @code{default}. You may +wish to customize @code{fixed} to some other fixed-width medium font. +@xref{Face Customization}. If your terminal cannot display different faces, you will not be able to see them, but you can still edit documents containing faces, @@ -2058,20 +2058,20 @@ text. There is a menu for specifying the foreground color and a menu for specifying the background color. Each color menu lists all the colors that you have used in Enriched mode in the current Emacs session. - If you specify a color with a prefix argument---or, in Transient Mark -mode, if the region is not active---then it applies to your next -self-inserting input. @xref{Transient Mark}. Otherwise, the command -applies to the region. + If you specify a color with a prefix argument---or, in Transient +Mark mode, if the region is not active---then it applies to any +immediately following self-inserting input. @xref{Transient Mark}. +Otherwise, the command applies to the region. Each color menu contains one additional item: @samp{Other}. You can use this item to specify a color that is not listed in the menu; it reads -the color name with the minibuffer. To display list of available colors +the color name with the minibuffer. To display a list of available colors and their names, use the @samp{Display Colors} menu item in the Text Properties menu (@pxref{Editing Format Info}). Any color that you specify in this way, or that is mentioned in a -formatted text file that you read in, is added to both color menus for -the duration of the Emacs session. +formatted text file that you read in, is added to the corresponding +color menu for the duration of the Emacs session. @findex facemenu-set-foreground @findex facemenu-set-background @@ -2113,33 +2113,42 @@ Remove 4 columns of indentation from the right margin. You can use these commands repeatedly to increase or decrease the indentation. - The most common way to use these commands is to change the indentation -of an entire paragraph. However, that is not the only use. You can -change the margins at any point; the new values take effect at the end -of the line (for right margins) or the beginning of the next line (for -left margins). + The most common way to use them is to change the indentation of an +entire paragraph. For other uses, the effects of refilling can be +hard to predict, except in some special cases like the one described +next. - This makes it possible to format paragraphs with @dfn{hanging indents}, -which means that the first line is indented less than subsequent lines. -To set up a hanging indent, increase the indentation of the region -starting after the first word of the paragraph and running until the end -of the paragraph. + The most common other use is to format paragraphs with @dfn{hanging +indents}, which means that the first line is indented less than +subsequent lines. To set up a hanging indent, increase the +indentation of the region starting after the first word of the +paragraph and running until the end of the paragraph. Indenting the first line of a paragraph is easier. Set the margin for the whole paragraph where you want it to be for the body of the paragraph, then indent the first line by inserting extra spaces or tabs. - Sometimes, as a result of editing, the filling of a paragraph becomes -messed up---parts of the paragraph may extend past the left or right -margins. When this happens, use @kbd{M-q} (@code{fill-paragraph}) to -refill the paragraph. - @vindex standard-indent The variable @code{standard-indent} specifies how many columns these commands should add to or subtract from the indentation. The default value is 4. The overall default right margin for Enriched mode is controlled by the variable @code{fill-column}, as usual. +@kindex C-c [ @r{(Enriched mode)} +@kindex C-c ] @r{(Enriched mode)} +@findex set-left-margin +@findex set-right-margin + There are also two commands for setting the left or right margin of +the region absolutely: @code{set-left-margin} and +@code{set-right-margin}. Enriched mode binds these commands to +@kbd{C-c [} and @kbd{C-c ]}, respectively. You can specify the +margin width either with a numeric argument or in the minibuffer. + + Sometimes, as a result of editing, the filling of a paragraph becomes +messed up---parts of the paragraph may extend past the left or right +margins. When this happens, use @kbd{M-q} (@code{fill-paragraph}) to +refill the paragraph. + The fill prefix, if any, works in addition to the specified paragraph indentation: @kbd{C-x .} does not include the specified indentation's whitespace in the new value for the fill prefix, and the fill commands @@ -2157,11 +2166,11 @@ affects the Emacs fill commands. the style. The submenu contains five items: @table @code -@item Flush Left +@item Left This is the most common style of justification (at least for English). Lines are aligned at the left margin but left uneven at the right. -@item Flush Right +@item Right This aligns each line with the right margin. Spaces and tabs are added on the left, if necessary, to make lines line up on the right. @@ -2175,7 +2184,7 @@ the width of spaces in a line to achieve elegant justification. @item Center This centers every line between the current margins. -@item None +@item Unfilled This turns off filling entirely. Each line will remain as you wrote it; the fill and auto-fill functions will have no effect on text which has this setting. You can, however, still indent the left margin. In @@ -2195,9 +2204,9 @@ Make the region left-filled (@code{set-justification-left}). @findex set-justification-right @item M-j r Make the region right-filled (@code{set-justification-right}). -@kindex M-j f @r{(Enriched mode)} +@kindex M-j b @r{(Enriched mode)} @findex set-justification-full -@item M-j f +@item M-j b Make the region fully justified (@code{set-justification-full}). @kindex M-j c @r{(Enriched mode)} @kindex M-S @r{(Enriched mode)} @@ -2220,11 +2229,15 @@ region. The default justification style is specified by the variable @code{default-justification}. Its value should be one of the symbols @code{left}, @code{right}, @code{full}, @code{center}, or @code{none}. +This is a per-buffer variable. Setting the variable directly affects +only the current buffer. However, customizing it in a Custom buffer +sets (as always) the default value for buffers that do not override it. +@xref{Locals}, and @ref{Easy Customization}. @node Format Properties @subsection Setting Other Text Properties - The Other Properties menu lets you add or remove three other useful text + The Special Properties menu lets you add or remove three other useful text properties: @code{read-only}, @code{invisible} and @code{intangible}. The @code{intangible} property disallows moving point within the text, the @code{invisible} text property hides text from display, and the @@ -2253,10 +2266,10 @@ When you visit a file that was created with some other editor, Emacs may not recognize the file as being in the text/enriched format. In this case, when you visit the file you will see the formatting commands rather than the formatted text. Type @kbd{M-x format-decode-buffer} to -translate it. +translate it. This also automatically turns on Enriched mode. @item -When you @emph{insert} a file into a buffer, rather than visiting it. +When you @emph{insert} a file into a buffer, rather than visiting it, Emacs does the necessary conversions on the text which you insert, but it does not enable Enriched mode. If you wish to do that, type @kbd{M-x enriched-mode}. @@ -2268,7 +2281,7 @@ to translate from; however, normally you can type just @key{RET}, which tells Emacs to guess the format. @findex format-find-file - If you wish to look at text/enriched file in its raw form, as a + If you wish to look at a text/enriched file in its raw form, as a sequence of characters rather than as formatted text, use the @kbd{M-x find-file-literally} command. This visits a file, like @code{find-file}, but does not do format conversion. It also inhibits diff --git a/man/tramp.texi b/man/tramp.texi index ebba03d626..e8577af498 100644 --- a/man/tramp.texi +++ b/man/tramp.texi @@ -1952,9 +1952,12 @@ There is some informations on @value{tramp} on NT at the following URL; many thanks to Joe Stoy for providing the information: @uref{ftp://ftp.comlab.ox.ac.uk/tmp/Joe.Stoy/} +@c The link is broken. I've contacted Tom for clarification. Michael. +@ignore The above mostly contains patches to old ssh versions; Tom Roche has a Web page with instructions: @uref{http://www4.ncsu.edu/~tlroche/plinkTramp.html} +@end ignore ??? Is the XEmacs info correct? diff --git a/man/trampver.texi b/man/trampver.texi index a5cc874b3f..743b49388f 100644 --- a/man/trampver.texi +++ b/man/trampver.texi @@ -4,7 +4,7 @@ @c In the Tramp CVS, the version number is auto-frobbed from @c configure.ac, so you should edit that file and run @c "autoconf && ./configure" to change the version number. -@set trampver 2.0.44 +@set trampver 2.0.45 @c Other flags from configuration @set prefix /usr/local |