diff options
| author | Juanma Barranquero <lekktu@gmail.com> | 2003-02-04 14:56:31 +0000 |
|---|---|---|
| committer | Juanma Barranquero <lekktu@gmail.com> | 2003-02-04 14:56:31 +0000 |
| commit | 177c0ea74342272645959b82cf219faa0b3dba16 (patch) | |
| tree | 44e22b210a9904eab25a66d12e708804b671df75 /man | |
| parent | db95369be096960245dd38678f68464627698678 (diff) | |
| download | emacs-177c0ea74342272645959b82cf219faa0b3dba16.tar.gz | |
Trailing whitespace deleted.
Diffstat (limited to 'man')
54 files changed, 855 insertions, 855 deletions
diff --git a/man/ChangeLog b/man/ChangeLog index aaaccb3efb3..1958ce65d45 100644 --- a/man/ChangeLog +++ b/man/ChangeLog @@ -299,7 +299,7 @@ * gnus.texi: File deleted. -1995-11-02 Stephen Gildea <gildea@stop.mail-abuse.org> +1995-11-02 Stephen Gildea <gildea@stop.mail-abuse.org> * mh-e.texi: "Function Index" -> "Command Index" to work with Emacs 19.30 C-h C-k support of separately-documented commands. @@ -314,7 +314,7 @@ * Makefile.in (INFO_TARGETS, DVI_TARGETS): Add viper targets. (../info/viper, viper.dvi): New targets. -1995-04-20 Kevin Rodgers <kevinr@ihs.com> +1995-04-20 Kevin Rodgers <kevinr@ihs.com> * dired-x.texi (Installation): Change the example to set buffer-local variables like dired-omit-files-p in diff --git a/man/Makefile.in b/man/Makefile.in index 987e86580ad..bbddf682522 100644 --- a/man/Makefile.in +++ b/man/Makefile.in @@ -54,7 +54,7 @@ INFOSOURCES = info.texi texi2dvi $< TEXI2DVI = texi2dvi -ENVADD = TEXINPUTS="$(srcdir):$(TEXINPUTS)" MAKEINFO="$(MAKEINFO) -I$(srcdir)" +ENVADD = TEXINPUTS="$(srcdir):$(TEXINPUTS)" MAKEINFO="$(MAKEINFO) -I$(srcdir)" EMACSSOURCES= \ ${srcdir}/emacs.texi \ @@ -176,7 +176,7 @@ forms.dvi: forms.texi ../info/gnus: gnus.texi cd $(srcdir); $(MAKEINFO) gnus.texi gnus.dvi: gnus.texi - sed -e '/@iflatex/,/@end iflatex/d' ${srcdir}/gnus.texi > gnustmp.texi + sed -e '/@iflatex/,/@end iflatex/d' ${srcdir}/gnus.texi > gnustmp.texi $(ENVADD) $(TEXI2DVI) gnustmp.texi cp gnustmp.dvi $*.dvi rm gnustmp.* diff --git a/man/ack.texi b/man/ack.texi index 79bc8a54089..0f8da05f455 100644 --- a/man/ack.texi +++ b/man/ack.texi @@ -55,7 +55,7 @@ Steven L.@: Baur wrote @c If earcon.el actually works with Emacs 21, it isn't useful for lack @c of sound files. -- fx @c @file{earcon.el}, a facility for sound effects -@c for email and news messages, +@c for email and news messages, @file{footnote.el} which lets you include footnotes in email messages, and @file{gnus-audio.el} which provides sound effects for Gnus. @@ -184,7 +184,7 @@ Matthieu Devin wrote @file{delsel.el}, a package to make newly-typed text replace the current selection. @item -Eric Ding contributed @file{goto-addr.el}, +Eric Ding contributed @file{goto-addr.el}, @item Carsten Dominik wrote @file{reftex.el}, a package for setting up @@ -660,7 +660,7 @@ Shivers. Bengt Martensson, Mark Shapiro, Mike Newton, Aaron Larson, and Stefan Schoef, wrote @file{bibtex.el}, a mode for editing Bib@TeX{} bibliography files. - + @item Charlie Martin wrote @file{autoinsert.el}, which provides automatic mode-sensitive insertion of text into new files. @@ -722,7 +722,7 @@ Richard Mlynarik wrote: @file{rfc822.el}, a parser for E-mail addresses in the RFC-822 format, used in mail messages and news articles, @item -@file{terminal.el}, a terminal emulator for Emacs subprocesses, and +@file{terminal.el}, a terminal emulator for Emacs subprocesses, and @item @file{yow.el}, an essential utility (try @kbd{M-x yow}). @end itemize @@ -821,7 +821,7 @@ Jeff Peck wrote: @item @file{sun.el}, key bindings for sunterm keys, @item -@file{sun-curs.el}, cursor definitions for Sun Windows, and +@file{sun-curs.el}, cursor definitions for Sun Windows, and @item @file{sun-fns.el} and @file{sun-mouse.el}, providing mouse support for Sun Windows. @@ -1153,7 +1153,7 @@ buffers. Tibor @v{S}imko and Milan Zamazal wrote @file{slovak.el}, support for editing text in Slovak language. -@item +@item Naoto Takahashi wrote @file{utf-8.el}, support for encoding and decoding UTF-8 data. diff --git a/man/ada-mode.texi b/man/ada-mode.texi index f88d91d0d0c..a1012b8fbff 100644 --- a/man/ada-mode.texi +++ b/man/ada-mode.texi @@ -161,7 +161,7 @@ not use these extensions and if you want Emacs to automatically start the Ada mode every time you edit an Ada file. Also, for general usage variables that you might want to set, -see +see @iftex @cite{The GNU Emacs Manual}. @end iftex @@ -337,7 +337,7 @@ choice is to use this variable settings, and otherwise @item C-c u @findex ada-customize Create or edit the project file for the current buffer (@code{ada-customize}). -@item C-c c +@item C-c c @findex ada-change-prj Change the project file associated with the current Ada buffer (@code{ada-change-prj}). @item C-c d diff --git a/man/basic.texi b/man/basic.texi index f7eb39d31de..6029b76cfea 100644 --- a/man/basic.texi +++ b/man/basic.texi @@ -262,7 +262,7 @@ if you set the variable @code{next-line-add-newlines} to a non-@code{nil} value, @kbd{C-n} on the last line of a buffer creates an additional line at the end and moves down onto it. -@node Erasing +@node Erasing @section Erasing Text @table @kbd @@ -611,7 +611,7 @@ point and the character after it. It displays a line in the echo area that looks like this: @smallexample -Char: c (0143, 99, 0x63) point=21044 of 26883(78%) column 53 +Char: c (0143, 99, 0x63) point=21044 of 26883(78%) column 53 @end smallexample @noindent @@ -641,7 +641,7 @@ additional text describing the currently accessible range. For example, it might display this: @smallexample -Char: C (0103, 67, 0x43) point=252 of 889(28%) <231 - 599> column 0 +Char: C (0103, 67, 0x43) point=252 of 889(28%) <231 - 599> column 0 @end smallexample @noindent diff --git a/man/buffers.texi b/man/buffers.texi index 8630a17bf95..6aa0c5eac2c 100644 --- a/man/buffers.texi +++ b/man/buffers.texi @@ -54,7 +54,7 @@ megabytes. * Kill Buffer:: Killing buffers you no longer need. * Several Buffers:: How to go through the list of all buffers and operate variously on several of them. -* Indirect Buffers:: An indirect buffer shares the text of another buffer. +* Indirect Buffers:: An indirect buffer shares the text of another buffer. * Buffer Convenience:: Convenience and customization features for buffer handling. @end menu @@ -155,10 +155,10 @@ current buffer. Here is an example of a buffer list:@refill MR Buffer Size Mode File -- ------ ---- ---- ---- .* emacs.tex 383402 Texinfo /u2/emacs/man/emacs.tex - *Help* 1287 Fundamental + *Help* 1287 Fundamental files.el 23076 Emacs-Lisp /u2/emacs/lisp/files.el % RMAIL 64042 RMAIL /u/rms/RMAIL - *% man 747 Dired /u2/emacs/man/ + *% man 747 Dired /u2/emacs/man/ net.emacs 343885 Fundamental /u/rms/net.emacs fileio.c 27691 C /u2/emacs/src/fileio.c NEWS 67340 Text /u2/emacs/etc/NEWS @@ -498,7 +498,7 @@ convenient to switch between buffers. @menu * Uniquify:: Buffer names can contain directory parts. * Iswitchb:: Switching between buffers with substrings. -* Buffer Menus:: Configurable buffer menu. +* Buffer Menus:: Configurable buffer menu. @end menu @node Uniquify diff --git a/man/building.texi b/man/building.texi index 9f8466eef68..37af1db844a 100644 --- a/man/building.texi +++ b/man/building.texi @@ -18,14 +18,14 @@ in the larger process of developing and maintaining programs. * Compilation Mode:: The mode for visiting compiler errors. * Compilation Shell:: Customizing your shell properly for use in the compilation buffer. -* Debuggers:: Running symbolic debuggers for non-Lisp programs. -* Executing Lisp:: Various modes for editing Lisp programs, +* Debuggers:: Running symbolic debuggers for non-Lisp programs. +* Executing Lisp:: Various modes for editing Lisp programs, with different facilities for running - the Lisp programs. + the Lisp programs. * Libraries: Lisp Libraries. Creating Lisp programs to run in Emacs. * Interaction: Lisp Interaction. Executing Lisp in an Emacs buffer. * Eval: Lisp Eval. Executing a single Lisp expression in Emacs. -* External Lisp:: Communicating through Emacs with a separate Lisp. +* External Lisp:: Communicating through Emacs with a separate Lisp. @end menu @node Compilation diff --git a/man/calc.texi b/man/calc.texi index 3ef1b449e8b..5d43afefd23 100644 --- a/man/calc.texi +++ b/man/calc.texi @@ -12436,7 +12436,7 @@ this calculation has infinity as an input. @cindex Positive infinite mode The @kbd{m i} command with a numeric prefix argument of zero, i.e., @kbd{C-u 0 m i}, turns on a ``positive infinite mode'' in -which zero is treated as positive instead of being directionless. +which zero is treated as positive instead of being directionless. Thus, @samp{1 / 0 = inf} and @samp{-1 / 0 = -inf} in this mode. Note that zero never actually has a sign in Calc; there are no separate representations for @i{+0} and @i{-0}. Positive @@ -14171,7 +14171,7 @@ Calc TeX eqn ---- --- --- acute \acute bar \bar bar -breve \breve +breve \breve check \check dot \dot dot dotdot \ddot dotdot @@ -14458,7 +14458,7 @@ Subscripts use double square brackets: @samp{a[[i]]}.@refill @cindex Maple language The @kbd{d W} (@code{calc-maple-language}) command selects the conventions of Maple, another mathematical tool from the University -of Waterloo. +of Waterloo. Maple's language is much like C. Underscores are allowed in symbol names; square brackets are used for subscripts; explicit @samp{*}s for @@ -15040,7 +15040,7 @@ as an algebraic entry. @example @group - C + C + C + C a b 7 3 @end group @end example @@ -15564,7 +15564,7 @@ and 3 (HMS). The @kbd{m d} command accepts these prefixes. @item Symbolic mode. Value is 0 or 1; default is 0. Command is @kbd{m s}. -@item +@item Fraction mode. Value is 0 or 1; default is 0. Command is @kbd{m f}. @item @@ -17626,7 +17626,7 @@ fvb(rate, n, pmt) = pmt * ---------------------------- fvl(rate, n, pmt) = pmt * (1 + rate) -n - 1 - (1 + rate) + 1 - (1 + rate) pv(rate, n, pmt) = pmt * ---------------- rate @@ -22984,7 +22984,7 @@ indefinite integral in terms of variable @code{v} instead of @code{x}. With four arguments, @samp{integ(f(x),x,a,b)} represents a definite integral from @code{a} to @code{b}. @end ifinfo -@tex +@tex If you use the @code{integ} function directly in an algebraic formula, you can also write @samp{integ(f,x,v)} which expresses the resulting indefinite integral in terms of variable @code{v} instead of @code{x}. @@ -23249,7 +23249,7 @@ Two useful commands for working with the result of @kbd{a S} are to @cite{y/3 - 2}, and @kbd{s l} (@pxref{Let Command}) which evaluates another formula with @cite{x} set equal to @cite{y/3 - 2}. -@menu +@menu * Multiple Solutions:: * Solving Systems of Equations:: * Decomposing Polynomials:: @@ -34016,7 +34016,7 @@ If composition @var{c} is a ``flat'' composition, return the last @comment @node Lisp Variables, Hooks, Formatting Lisp Functions, Internals @comment @subsubsection Lisp Variables -@comment +@comment @comment @noindent @comment (This section is currently unfinished.) @@ -34397,8 +34397,8 @@ keystrokes are not listed in this summary. @r{ @: M-# _ @: @: 36 @:calc-grab-sum-across@:} @r{ @: M-# ` @:editing @: 30 @:calc-embedded-edit@:} @r{ @: M-# 0 @:(zero) @: @:calc-reset@:} - -@c + +@c @r{ @: 0-9 @:number @: @:@:number} @r{ @: . @:number @: @:@:0.number} @r{ @: _ @:number @: @:-@:number} @@ -34409,12 +34409,12 @@ keystrokes are not listed in this summary. @r{ @: @@ ' " @: (in number)@: @:@:HMS form} @r{ @: h m s @: (in number)@: @:@:HMS form} -@c +@c @r{ @: ' @:formula @: 37,46 @:@:formula} @r{ @: $ @:formula @: 37,46 @:$@:formula} @r{ @: " @:string @: 37,46 @:@:string} - -@c + +@c @r{ a b@: + @: @: 2 @:add@:(a,b) a+b} @r{ a b@: - @: @: 2 @:sub@:(a,b) a@minus{}b} @r{ a b@: * @: @: 2 @:mul@:(a,b) a b, a*b} @@ -34432,8 +34432,8 @@ keystrokes are not listed in this summary. @r{ a@: ! @: @: 1 @:fact@:(a) a!} @r{ a@: = @: @: 1 @:evalv@:(a)} @r{ a@: M-% @: @: @:percent@:(a) a%} - -@c + +@c @r{ ... a@: @key{RET} @: @: 1 @:@:... a a} @r{ ... a@: @key{SPC} @: @: 1 @:@:... a a} @r{... a b@: @key{TAB} @: @: 3 @:@:... b a} @@ -34443,8 +34443,8 @@ keystrokes are not listed in this summary. @r{... a b@: M-@key{DEL} @: @: 1 @:@:... b} @r{ @: M-@key{RET} @: @: 4 @:calc-last-args@:} @r{ a@: ` @:editing @: 1,30 @:calc-edit@:} - -@c + +@c @r{ ... a@: C-d @: @: 1 @:@:...} @r{ @: C-k @: @: 27 @:calc-kill@:} @r{ @: C-w @: @: 27 @:calc-kill-region@:} @@ -34452,8 +34452,8 @@ keystrokes are not listed in this summary. @r{ @: C-_ @: @: 4 @:calc-undo@:} @r{ @: M-k @: @: 27 @:calc-copy-as-kill@:} @r{ @: M-w @: @: 27 @:calc-copy-region-as-kill@:} - -@c + +@c @r{ @: [ @: @: @:@:[...} @r{[.. a b@: ] @: @: @:@:[a,b]} @r{ @: ( @: @: @:@:(...} @@ -34462,15 +34462,15 @@ keystrokes are not listed in this summary. @r{ @: ; @: @: @:@:matrix or polar complex} @r{ @: .. @: @: @:@:interval} -@c +@c @r{ @: ~ @: @: @:calc-num-prefix@:} @r{ @: < @: @: 4 @:calc-scroll-left@:} @r{ @: > @: @: 4 @:calc-scroll-right@:} @r{ @: @{ @: @: 4 @:calc-scroll-down@:} @r{ @: @} @: @: 4 @:calc-scroll-up@:} @r{ @: ? @: @: @:calc-help@:} - -@c + +@c @r{ a@: n @: @: 1 @:neg@:(a) @minus{}a} @r{ @: o @: @: 4 @:calc-realign@:} @r{ @: p @:precision @: 31 @:calc-precision@:} @@ -34478,8 +34478,8 @@ keystrokes are not listed in this summary. @r{ @: w @: @: @:calc-why@:} @r{ @: x @:command @: @:M-x calc-@:command} @r{ a@: y @: @:1,28,49 @:calc-copy-to-buffer@:} - -@c + +@c @r{ a@: A @: @: 1 @:abs@:(a)} @r{ a b@: B @: @: 2 @:log@:(a,b)} @r{ a b@: I B @: @: 2 @:alog@:(a,b) b^a} @@ -34524,8 +34524,8 @@ keystrokes are not listed in this summary. @r{ a@: I H T @: @: 1 @:arctanh@:(a)} @r{ @: U @: @: 4 @:calc-undo@:} @r{ @: X @: @: 4 @:calc-call-last-kbd-macro@:} - -@c + +@c @r{ a b@: a = @: @: 2 @:eq@:(a,b) a=b} @r{ a b@: a # @: @: 2 @:neq@:(a,b) a!=b} @r{ a b@: a < @: @: 2 @:lt@:(a,b) a<b} @@ -34539,20 +34539,20 @@ keystrokes are not listed in this summary. @r{ a b c@: a : @: @: 45 @:if@:(a,b,c) a?b:c} @r{ a@: a . @: @: 1 @:rmeq@:(a)} @r{ a@: a " @: @: 7,8 @:calc-expand-formula@:} - -@c + +@c @r{ a@: a + @:i, l, h @: 6,38 @:sum@:(a,i,l,h)} @r{ a@: a - @:i, l, h @: 6,38 @:asum@:(a,i,l,h)} @r{ a@: a * @:i, l, h @: 6,38 @:prod@:(a,i,l,h)} @r{ a b@: a _ @: @: 2 @:subscr@:(a,b) a_b} - -@c + +@c @r{ a b@: a \ @: @: 2 @:pdiv@:(a,b)} @r{ a b@: a % @: @: 2 @:prem@:(a,b)} @r{ a b@: a / @: @: 2 @:pdivrem@:(a,b) [q,r]} @r{ a b@: H a / @: @: 2 @:pdivide@:(a,b) q+r/b} - -@c + +@c @r{ a@: a a @: @: 1 @:apart@:(a)} @r{ a@: a b @:old, new @: 38 @:subst@:(a,old,new)} @r{ a@: a c @:v @: 38 @:collect@:(a,v)} @@ -34573,8 +34573,8 @@ keystrokes are not listed in this summary. @r{ a@: a t @:v, n @: 31,39 @:taylor@:(a,v,n)} @r{ a@: a v @: @: 7,8 @:calc-alg-evaluate@:} @r{ a@: a x @: @: 4,8 @:expand@:(a)} - -@c + +@c @r{ data@: a F @:model, vars @: 48 @:fit@:(m,iv,pv,data)} @r{ data@: I a F @:model, vars @: 48 @:xfit@:(m,iv,pv,data)} @r{ data@: H a F @:model, vars @: 48 @:efit@:(m,iv,pv,data)} @@ -34594,8 +34594,8 @@ keystrokes are not listed in this summary. @r{ a@: a T @:i, l, h @: 6,38 @:table@:(a,i,l,h)} @r{ a g@: a X @:v @: 38 @:maximize@:(a,v,g)} @r{ a g@: H a X @:v @: 38 @:wmaximize@:(a,v,g)} - -@c + +@c @r{ a b@: b a @: @: 9 @:and@:(a,b,w)} @r{ a@: b c @: @: 9 @:clip@:(a,w)} @r{ a b@: b d @: @: 9 @:diff@:(a,b,w)} @@ -34611,8 +34611,8 @@ keystrokes are not listed in this summary. @r{ a@: b u @: @: 1 @:vunpack@:(a)} @r{ @: b w @:w @: 9,50 @:calc-word-size@:} @r{ a b@: b x @: @: 9 @:xor@:(a,b,w)} - -@c + +@c @r{c s l p@: b D @: @: @:ddb@:(c,s,l,p)} @r{ r n p@: b F @: @: @:fv@:(r,n,p)} @r{ r n p@: I b F @: @: @:fvb@:(r,n,p)} @@ -34641,8 +34641,8 @@ keystrokes are not listed in this summary. @r{ r p a@: I b # @: @: @:nperb@:(r,p,a)} @r{ r p a@: H b # @: @: @:nperl@:(r,p,a)} @r{ a b@: b % @: @: @:relch@:(a,b)} - -@c + +@c @r{ a@: c c @: @: 5 @:pclean@:(a,p)} @r{ a@: c 0-9 @: @: @:pclean@:(a,p)} @r{ a@: H c c @: @: 5 @:clean@:(a,p)} @@ -34654,15 +34654,15 @@ keystrokes are not listed in this summary. @r{ a@: c p @: @: @:polar@:(a)} @r{ a@: I c p @: @: @:rect@:(a)} @r{ a@: c r @: @: 1 @:rad@:(a)} - -@c + +@c @r{ a@: c F @: @: 5 @:pfrac@:(a,p)} @r{ a@: H c F @: @: 5 @:frac@:(a,p)} - -@c + +@c @r{ a@: c % @: @: @:percent@:(a*100)} - -@c + +@c @r{ @: d . @:char @: 50 @:calc-point-char@:} @r{ @: d , @:char @: 50 @:calc-group-char@:} @r{ @: d < @: @: 13,50 @:calc-left-justify@:} @@ -34675,14 +34675,14 @@ keystrokes are not listed in this summary. @r{ @: d " @: @: 12,50 @:calc-display-strings@:} @r{ @: d @key{SPC} @: @: @:calc-refresh@:} @r{ @: d @key{RET} @: @: 1 @:calc-refresh-top@:} - -@c + +@c @r{ @: d 0 @: @: 50 @:calc-decimal-radix@:} @r{ @: d 2 @: @: 50 @:calc-binary-radix@:} @r{ @: d 6 @: @: 50 @:calc-hex-radix@:} @r{ @: d 8 @: @: 50 @:calc-octal-radix@:} - -@c + +@c @r{ @: d b @: @:12,13,50 @:calc-line-breaking@:} @r{ @: d c @: @: 50 @:calc-complex-notation@:} @r{ @: d d @:format @: 50 @:calc-date-notation@:} @@ -34701,8 +34701,8 @@ keystrokes are not listed in this summary. @r{ @: d t @: @: 27 @:calc-truncate-stack@:} @r{ @: d w @: @: 12,13 @:calc-auto-why@:} @r{ @: d z @: @: 12,50 @:calc-leading-zeros@:} - -@c + +@c @r{ @: d B @: @: 50 @:calc-big-language@:} @r{ @: d C @: @: 50 @:calc-c-language@:} @r{ @: d E @: @: 50 @:calc-eqn-language@:} @@ -34714,12 +34714,12 @@ keystrokes are not listed in this summary. @r{ @: d T @: @: 50 @:calc-tex-language@:} @r{ @: d U @: @: 50 @:calc-unformatted-language@:} @r{ @: d W @: @: 50 @:calc-maple-language@:} - -@c + +@c @r{ a@: f [ @: @: 4 @:decr@:(a,n)} @r{ a@: f ] @: @: 4 @:incr@:(a,n)} - -@c + +@c @r{ a b@: f b @: @: 2 @:beta@:(a,b)} @r{ a@: f e @: @: 1 @:erf@:(a)} @r{ a@: I f e @: @: 1 @:erfc@:(a)} @@ -34732,8 +34732,8 @@ keystrokes are not listed in this summary. @r{ a@: f s @: @: 1 @:sign@:(a)} @r{ a b@: f x @: @: 2 @:max@:(a,b)} @r{ n a@: f y @: @: 2 @:besY@:(n,a)} - -@c + +@c @r{ a@: f A @: @: 1 @:abssqr@:(a)} @r{ x a b@: f B @: @: @:betaI@:(x,a,b)} @r{ x a b@: H f B @: @: @:betaB@:(x,a,b)} @@ -34751,8 +34751,8 @@ keystrokes are not listed in this summary. @r{ a n@: f S @: @: 2 @:scf@:(a,n)} @r{ y x@: f T @: @: @:arctan2@:(y,x)} @r{ a@: f X @: @: 1 @:xpon@:(a)} - -@c + +@c @r{ x y@: g a @: @: 28,40 @:calc-graph-add@:} @r{ @: g b @: @: 12 @:calc-graph-border@:} @r{ @: g c @: @: @:calc-graph-clear@:} @@ -34772,8 +34772,8 @@ keystrokes are not listed in this summary. @r{ @: g v @: @: @:calc-graph-view-commands@:} @r{ @: g x @:display @: @:calc-graph-display@:} @r{ @: g z @: @: 12 @:calc-graph-zero-x@:} - -@c + +@c @r{ x y z@: g A @: @: 28,40 @:calc-graph-add-3d@:} @r{ @: g C @:command @: @:calc-graph-command@:} @r{ @: g D @:device @: 43,44 @:calc-graph-device@:} @@ -34790,13 +34790,13 @@ keystrokes are not listed in this summary. @r{ @: g V @: @: @:calc-graph-view-trail@:} @r{ @: g X @:format @: @:calc-graph-geometry@:} @r{ @: g Z @: @: 12 @:calc-graph-zero-y@:} - -@c + +@c @r{ @: g C-l @: @: 12 @:calc-graph-log-z@:} @r{ @: g C-r @:range @: @:calc-graph-range-z@:} @r{ @: g C-t @:title @: @:calc-graph-title-z@:} - -@c + +@c @r{ @: h b @: @: @:calc-describe-bindings@:} @r{ @: h c @:key @: @:calc-describe-key-briefly@:} @r{ @: h f @:function @: @:calc-describe-function@:} @@ -34807,23 +34807,23 @@ keystrokes are not listed in this summary. @r{ @: h s @: @: @:calc-info-summary@:} @r{ @: h t @: @: @:calc-tutorial@:} @r{ @: h v @:var @: @:calc-describe-variable@:} - -@c + +@c @r{ @: j 1-9 @: @: @:calc-select-part@:} @r{ @: j @key{RET} @: @: 27 @:calc-copy-selection@:} @r{ @: j @key{DEL} @: @: 27 @:calc-del-selection@:} @r{ @: j ' @:formula @: 27 @:calc-enter-selection@:} @r{ @: j ` @:editing @: 27,30 @:calc-edit-selection@:} @r{ @: j " @: @: 7,27 @:calc-sel-expand-formula@:} - -@c + +@c @r{ @: j + @:formula @: 27 @:calc-sel-add-both-sides@:} @r{ @: j - @:formula @: 27 @:calc-sel-sub-both-sides@:} @r{ @: j * @:formula @: 27 @:calc-sel-mul-both-sides@:} @r{ @: j / @:formula @: 27 @:calc-sel-div-both-sides@:} @r{ @: j & @: @: 27 @:calc-sel-invert@:} - -@c + +@c @r{ @: j a @: @: 27 @:calc-select-additional@:} @r{ @: j b @: @: 12 @:calc-break-selections@:} @r{ @: j c @: @: @:calc-clear-selections@:} @@ -34838,8 +34838,8 @@ keystrokes are not listed in this summary. @r{ @: j s @: @: 4,27 @:calc-select-here@:} @r{ @: j u @: @: 27 @:calc-unselect@:} @r{ @: j v @: @: 7,27 @:calc-sel-evaluate@:} - -@c + +@c @r{ @: j C @: @: 27 @:calc-sel-commute@:} @r{ @: j D @: @: 4,27 @:calc-sel-distribute@:} @r{ @: j E @: @: 27 @:calc-sel-jump-equals@:} @@ -34852,8 +34852,8 @@ keystrokes are not listed in this summary. @r{ @: j R @: @: 4,27 @:calc-commute-right@:} @r{ @: j S @: @: 4,27 @:calc-select-here-maybe@:} @r{ @: j U @: @: 27 @:calc-sel-unpack@:} - -@c + +@c @r{ @: k a @: @: @:calc-random-again@:} @r{ n@: k b @: @: 1 @:bern@:(n)} @r{ n x@: H k b @: @: 2 @:bern@:(n,x)} @@ -34874,8 +34874,8 @@ keystrokes are not listed in this summary. @r{ n m@: k s @: @: 2 @:stir1@:(n,m)} @r{ n m@: H k s @: @: 2 @:stir2@:(n,m)} @r{ n@: k t @: @: 1 @:totient@:(n)} - -@c + +@c @r{ n p x@: k B @: @: @:utpb@:(x,n,p)} @r{ n p x@: I k B @: @: @:ltpb@:(x,n,p)} @r{ v x@: k C @: @: @:utpc@:(x,v)} @@ -34889,8 +34889,8 @@ keystrokes are not listed in this summary. @r{ m x@: I k P @: @: @:ltpp@:(x,m)} @r{ v x@: k T @: @: @:utpt@:(x,v)} @r{ v x@: I k T @: @: @:ltpt@:(x,v)} - -@c + +@c @r{ @: m a @: @: 12,13 @:calc-algebraic-mode@:} @r{ @: m d @: @: @:calc-degrees-mode@:} @r{ @: m f @: @: 12 @:calc-frac-mode@:} @@ -34905,8 +34905,8 @@ keystrokes are not listed in this summary. @r{ @: m v @: @: 12,13 @:calc-matrix-mode@:} @r{ @: m w @: @: 13 @:calc-working@:} @r{ @: m x @: @: @:calc-always-load-extensions@:} - -@c + +@c @r{ @: m A @: @: 12 @:calc-alg-simplify-mode@:} @r{ @: m B @: @: 12 @:calc-bin-simplify-mode@:} @r{ @: m C @: @: 12 @:calc-auto-recompute@:} @@ -34918,8 +34918,8 @@ keystrokes are not listed in this summary. @r{ @: m R @: @: 12,13 @:calc-mode-record-mode@:} @r{ @: m S @: @: 12 @:calc-shift-prefix@:} @r{ @: m U @: @: 12 @:calc-units-simplify-mode@:} - -@c + +@c @r{ @: s c @:var1, var2 @: 29 @:calc-copy-variable@:} @r{ @: s d @:var, decl @: @:calc-declare-variable@:} @r{ @: s e @:var, editing @: 29,30 @:calc-edit-variable@:} @@ -34936,8 +34936,8 @@ keystrokes are not listed in this summary. @r{ a@: t 0-9 @: @: @:calc-store-into-quick@:} @r{ @: s u @:var @: 29 @:calc-unstore@:} @r{ a@: s x @:var @: 29 @:calc-store-exchange@:} - -@c + +@c @r{ @: s A @:editing @: 30 @:calc-edit-AlgSimpRules@:} @r{ @: s D @:editing @: 30 @:calc-edit-Decls@:} @r{ @: s E @:editing @: 30 @:calc-edit-EvalRules@:} @@ -34951,8 +34951,8 @@ keystrokes are not listed in this summary. @r{ @: s T @:editing @: 30 @:calc-edit-TimeZone@:} @r{ @: s U @:editing @: 30 @:calc-edit-Units@:} @r{ @: s X @:editing @: 30 @:calc-edit-ExtSimpRules@:} - -@c + +@c @r{ a@: s + @:var @: 29,47 @:calc-store-plus@: (v+a)} @r{ a@: s - @:var @: 29,47 @:calc-store-minus@: (v-a)} @r{ a@: s * @:var @: 29,47 @:calc-store-times@: (v*a)} @@ -34964,15 +34964,15 @@ keystrokes are not listed in this summary. @r{ @: s ] @:var @: 29,47 @:calc-store-incr@: (v-(-1))} @r{ a b@: s : @: @: 2 @:assign@:(a,b) a @t{:=} b} @r{ a@: s = @: @: 1 @:evalto@:(a,b) a @t{=>}} - -@c + +@c @r{ @: t [ @: @: 4 @:calc-trail-first@:} @r{ @: t ] @: @: 4 @:calc-trail-last@:} @r{ @: t < @: @: 4 @:calc-trail-scroll-left@:} @r{ @: t > @: @: 4 @:calc-trail-scroll-right@:} @r{ @: t . @: @: 12 @:calc-full-trail-vectors@:} - -@c + +@c @r{ @: t b @: @: 4 @:calc-trail-backward@:} @r{ @: t d @: @: 12,50 @:calc-trail-display@:} @r{ @: t f @: @: 4 @:calc-trail-forward@:} @@ -34986,8 +34986,8 @@ keystrokes are not listed in this summary. @r{ @: t r @:string @: @:calc-trail-isearch-backward@:} @r{ @: t s @:string @: @:calc-trail-isearch-forward@:} @r{ @: t y @: @: 4 @:calc-trail-yank@:} - -@c + +@c @r{ d@: t C @:oz, nz @: @:tzconv@:(d,oz,nz)} @r{d oz nz@: t C @:$ @: @:tzconv@:(d,oz,nz)} @r{ d@: t D @: @: 15 @:date@:(d)} @@ -35007,12 +35007,12 @@ keystrokes are not listed in this summary. @r{ d@: t U @: @: 16 @:unixtime@:(d,z)} @r{ d@: t W @: @: 17 @:newweek@:(d,w)} @r{ d@: t Y @: @: 17 @:newyear@:(d,n)} - -@c + +@c @r{ a b@: t + @: @: 2 @:badd@:(a,b)} @r{ a b@: t - @: @: 2 @:bsub@:(a,b)} - -@c + +@c @r{ @: u a @: @: 12 @:calc-autorange-units@:} @r{ a@: u b @: @: @:calc-base-units@:} @r{ a@: u c @:units @: 18 @:calc-convert-units@:} @@ -35027,8 +35027,8 @@ keystrokes are not listed in this summary. @r{ @: u v @: @: @:calc-enter-units-table@:} @r{ a@: u x @: @: @:calc-extract-units@:} @r{ a@: u 0-9 @: @: @:calc-quick-units@:} - -@c + +@c @r{ v1 v2@: u C @: @: 20 @:vcov@:(v1,v2)} @r{ v1 v2@: I u C @: @: 20 @:vpcov@:(v1,v2)} @r{ v1 v2@: H u C @: @: 20 @:vcorr@:(v1,v2)} @@ -35045,13 +35045,13 @@ keystrokes are not listed in this summary. @r{ v@: I H u S @: @: 19 @:vpvar@:(v)} @r{ @: u V @: @: @:calc-view-units-table@:} @r{ v@: u X @: @: 19 @:vmax@:(v)} - -@c + +@c @r{ v@: u + @: @: 19 @:vsum@:(v)} @r{ v@: u * @: @: 19 @:vprod@:(v)} @r{ v@: u # @: @: 19 @:vcount@:(v)} - -@c + +@c @r{ @: V ( @: @: 50 @:calc-vector-parens@:} @r{ @: V @{ @: @: 50 @:calc-vector-braces@:} @r{ @: V [ @: @: 50 @:calc-vector-brackets@:} @@ -35062,19 +35062,19 @@ keystrokes are not listed in this summary. @r{ @: V > @: @: 50 @:calc-matrix-right-justify@:} @r{ @: V / @: @: 12,50 @:calc-break-vectors@:} @r{ @: V . @: @: 12,50 @:calc-full-vectors@:} - -@c + +@c @r{ s t@: V ^ @: @: 2 @:vint@:(s,t)} @r{ s t@: V - @: @: 2 @:vdiff@:(s,t)} @r{ s@: V ~ @: @: 1 @:vcompl@:(s)} @r{ s@: V # @: @: 1 @:vcard@:(s)} @r{ s@: V : @: @: 1 @:vspan@:(s)} @r{ s@: V + @: @: 1 @:rdup@:(s)} - -@c + +@c @r{ m@: V & @: @: 1 @:inv@:(m) 1/m} - -@c + +@c @r{ v@: v a @:n @: @:arrange@:(v,n)} @r{ a@: v b @:n @: @:cvec@:(a,n)} @r{ v@: v c @:n >0 @: 21,31 @:mcol@:(v,n)} @@ -35107,8 +35107,8 @@ keystrokes are not listed in this summary. @r{ v@: v v @: @: 1 @:rev@:(v)} @r{ @: v x @:n @: 31 @:index@:(n)} @r{ n s i@: C-u v x @: @: @:index@:(n,s,i)} - -@c + +@c @r{ v@: V A @:op @: 22 @:apply@:(op,v)} @r{ v1 v2@: V C @: @: 2 @:cross@:(v1,v2)} @r{ m@: V D @: @: 1 @:det@:(m)} @@ -35137,20 +35137,20 @@ keystrokes are not listed in this summary. @r{ a@: I H V U @:op @: 22 @:afixp@:(op,a)} @r{ s t@: V V @: @: 2 @:vunion@:(s,t)} @r{ s t@: V X @: @: 2 @:vxor@:(s,t)} - -@c + +@c @r{ @: Y @: @: @:@:user commands} - -@c + +@c @r{ @: z @: @: @:@:user commands} - -@c + +@c @r{ c@: Z [ @: @: 45 @:calc-kbd-if@:} @r{ c@: Z | @: @: 45 @:calc-kbd-else-if@:} @r{ @: Z : @: @: @:calc-kbd-else@:} @r{ @: Z ] @: @: @:calc-kbd-end-if@:} - -@c + +@c @r{ @: Z @{ @: @: 4 @:calc-kbd-loop@:} @r{ c@: Z / @: @: 45 @:calc-kbd-break@:} @r{ @: Z @} @: @: @:calc-kbd-end-loop@:} @@ -35158,17 +35158,17 @@ keystrokes are not listed in this summary. @r{ @: Z > @: @: @:calc-kbd-end-repeat@:} @r{ n m@: Z ( @: @: @:calc-kbd-for@:} @r{ s@: Z ) @: @: @:calc-kbd-end-for@:} - -@c + +@c @r{ @: Z C-g @: @: @:@:cancel if/loop command} - -@c + +@c @r{ @: Z ` @: @: @:calc-kbd-push@:} @r{ @: Z ' @: @: @:calc-kbd-pop@:} @r{ a@: Z = @:message @: 28 @:calc-kbd-report@:} @r{ @: Z # @:prompt @: @:calc-kbd-query@:} - -@c + +@c @r{ comp@: Z C @:func, args @: 50 @:calc-user-define-composition@:} @r{ @: Z D @:key, command @: @:calc-user-define@:} @r{ @: Z E @:key, editing @: 30 @:calc-user-define-edit@:} diff --git a/man/calendar.texi b/man/calendar.texi index 3b06d30fef4..fb486ae01c8 100644 --- a/man/calendar.texi +++ b/man/calendar.texi @@ -1350,7 +1350,7 @@ them. @example Monday 9:30am Coffee break - 12:00pm Lunch + 12:00pm Lunch @end example @noindent diff --git a/man/cc-mode.texi b/man/cc-mode.texi index 41f1be4f57e..25f39d75cd6 100644 --- a/man/cc-mode.texi +++ b/man/cc-mode.texi @@ -18,7 +18,7 @@ @comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -@comment +@comment @comment Texinfo manual for CC Mode @comment Generated from the original README file by Krishna Padmasola @comment <krishna@earth-gw.njit.edu> @@ -28,7 +28,7 @@ @comment Martin Stjernholm @comment @comment Maintained by Martin Stjernholm <bug-cc-mode@gnu.org> -@comment +@comment @comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! @copying @@ -398,7 +398,7 @@ level function block, and is indented relative to buffer position 29, which is the brace just after the function header. Here's another example: -@example +@example @group 1: int add( int val, int incr, int doit ) @@ -889,7 +889,7 @@ in: @example @group -void spam( int i ) +void spam( int i ) @{ // this is a comment-only line... if( i == 7 ) // but this is not @@ -1480,9 +1480,9 @@ that bit. @comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! The following list of commands re-indent C constructs. Note that when -you change your coding style, either interactively or through some other +you change your coding style, either interactively or through some other means, your file does @emph{not} automatically get re-indented. You -will need to execute one of the following commands to see the effects of +will need to execute one of the following commands to see the effects of your changes. @cindex GNU indent program @@ -1495,7 +1495,7 @@ among other things. Re-indenting large sections of code can take a long time. When @ccmode{} reindents a region of code, it is essentially equivalent to -hitting @kbd{TAB} on every line of the region. Especially vulnerable is +hitting @kbd{TAB} on every line of the region. Especially vulnerable is code generator output@footnote{In particular, I have had people complain about the speed with which @code{lex(1)} output is re-indented. Lex, yacc, and other code generators usually output some pretty @@ -1589,7 +1589,7 @@ in a line's indentation, otherwise only spaces can be used. @vindex c-progress-interval @vindex progress-interval (c-) @item c-progress-interval -When indenting large regions of code, this variable controls how often a +When indenting large regions of code, this variable controls how often a progress message is displayed. Set this variable to @code{nil} to inhibit the progress messages, or set it to an integer which is the interval in seconds that progress messages are displayed. @@ -2355,22 +2355,22 @@ modes. @item When @code{c-default-style} is an association list, the current major -mode is looked up to find a style name string. In this case, this style -is always used exactly as specified and an error will occur if the named +mode is looked up to find a style name string. In this case, this style +is always used exactly as specified and an error will occur if the named style does not exist. @item If @code{c-default-style} is an association list, but the current major -mode isn't found, then the special symbol @samp{other} is looked up. If +mode isn't found, then the special symbol @samp{other} is looked up. If this value is found, the associated style is used. @item If @samp{other} is not found, then the @samp{gnu} style is used. @item -In all cases, the style described in @code{c-default-style} is installed +In all cases, the style described in @code{c-default-style} is installed @emph{before} the language hooks are run, so you can always override -this setting by including an explicit call to @code{c-set-style} in your +this setting by including an explicit call to @code{c-set-style} in your language mode hook, or in @code{c-mode-common-hook}. @end enumerate @@ -2533,7 +2533,7 @@ are simply indented two spaces to the right of line 3. But perhaps we'd like @ccmode{} to be a little more intelligent so that it aligns all the @samp{<<} symbols in lines 3 through 6. To do this, we have to write a custom indentation function which finds the column of first -stream operator on the first line of the statement. Here is sample +stream operator on the first line of the statement. Here is sample lisp code implementing this: @example @group @@ -2823,7 +2823,7 @@ i.e. they want the comments to always indent as they would for normal code, regardless of whether @kbd{TAB} or @kbd{M-;} were used. This behavior is controlled by the variable @code{c-indent-comments-syntactically-p}. When @code{nil} (the -default), @kbd{M-;} indents comment-only lines to @code{comment-column}, +default), @kbd{M-;} indents comment-only lines to @code{comment-column}, otherwise, they are indented just as they would be if @kbd{TAB} were typed. @@ -3374,7 +3374,7 @@ symbols. In this example: @example @group - 1: extern "C" + 1: extern "C" 2: @{ 3: int thing_one( int ); 4: int thing_two( double ); @@ -3412,7 +3412,7 @@ symbols. In this example: @noindent line 2 is given the @code{namespace-open} syntax, while line 4 is given the @code{namespace-close} syntax. The analysis for line 3 yields: -@code{((innamespace) (topmost-intro . 17))}, where @code{innamespace} is +@code{((innamespace) (topmost-intro . 17))}, where @code{innamespace} is a modifier similar in purpose to @code{inextern-lang} and @code{inclass}. A number of syntactic symbols are associated with parenthesis lists, @@ -3423,19 +3423,19 @@ calls. This example illustrates these: 1: void a_function( int line1, 2: int line2 ); - 3: + 3: 4: void a_longer_function( 5: int line1, 6: int line2 7: ); - 8: + 8: 9: void call_them( int line1, int line2 ) 10: @{ 11: a_function( 12: line1, 13: line2 14: ); - 15: + 15: 16: a_longer_function( line1, 17: line2 ); 18: @} @@ -3475,10 +3475,10 @@ covered are illustrated by this C++ example: 3: @{ 4: /* this line starts a multi-line 5: * comment. This line should get `c' syntax */ - 6: + 6: 7: char* a_multiline_string = "This line starts a multi-line \ 8: string. This line should get `string' syntax."; - 9: + 9: 10: note: 11: @{ 12: #ifdef LOCK @@ -3567,7 +3567,7 @@ example: @end example @noindent line 1 is given the syntactic symbol @code{cpp-macro}. This first line -of a macro is always given this symbol. The second and subsequent lines +of a macro is always given this symbol. The second and subsequent lines (e.g. lines 2 through 5) are given the @code{cpp-macro-cont} syntactic symbol, with a relative buffer position pointing to the @code{#} which starts the macro definition. @@ -3778,7 +3778,7 @@ indentation is added. E.g: @group main (int, - char ** + char ** ) // c-lineup-close-paren @end group @@ -3857,7 +3857,7 @@ E.g: @group class Foo - extends + extends Bar // c-lineup-java-inher <--> c-basic-offset @@ -3921,8 +3921,8 @@ Indent a one line block @code{c-basic-offset} extra. E.g: if (n > 0) @{m+=n; n=0;@} // c-indent-one-line-block - -<--> c-basic-offset + +<--> c-basic-offset @end group @end example @@ -3954,7 +3954,7 @@ Indent a multi line block @code{c-basic-offset} extra. E.g: @group int *foo[] = @{ - NULL, + NULL, @{17@}, // c-indent-multi-line-block @end group @@ -4440,7 +4440,7 @@ in the @file{README} file. XEmacs since 19.16. Due to release schedule skew, it is likely that all of these Emacsen -have old versions of @ccmode{} and so should be upgraded. Access to the +have old versions of @ccmode{} and so should be upgraded. Access to the @ccmode{} source code, as well as more detailed information on Emacsen compatibility, etc. are all available via the Web at: diff --git a/man/cl.texi b/man/cl.texi index 6c717066e22..eebd3ae4b5f 100644 --- a/man/cl.texi +++ b/man/cl.texi @@ -1031,41 +1031,41 @@ to standard Common Lisp. The following Emacs-specific functions are also @code{setf}-able. @smallexample -buffer-file-name marker-position -buffer-modified-p match-data -buffer-name mouse-position -buffer-string overlay-end -buffer-substring overlay-get -current-buffer overlay-start -current-case-table point -current-column point-marker -current-global-map point-max -current-input-mode point-min -current-local-map process-buffer -current-window-configuration process-filter -default-file-modes process-sentinel -default-value read-mouse-position -documentation-property screen-height -extent-data screen-menubar -extent-end-position screen-width -extent-start-position selected-window -face-background selected-screen -face-background-pixmap selected-frame -face-font standard-case-table -face-foreground syntax-table -face-underline-p window-buffer -file-modes window-dedicated-p -frame-height window-display-table -frame-parameters window-height -frame-visible-p window-hscroll -frame-width window-point -get-register window-start -getenv window-width -global-key-binding x-get-cut-buffer -keymap-parent x-get-cutbuffer +buffer-file-name marker-position +buffer-modified-p match-data +buffer-name mouse-position +buffer-string overlay-end +buffer-substring overlay-get +current-buffer overlay-start +current-case-table point +current-column point-marker +current-global-map point-max +current-input-mode point-min +current-local-map process-buffer +current-window-configuration process-filter +default-file-modes process-sentinel +default-value read-mouse-position +documentation-property screen-height +extent-data screen-menubar +extent-end-position screen-width +extent-start-position selected-window +face-background selected-screen +face-background-pixmap selected-frame +face-font standard-case-table +face-foreground syntax-table +face-underline-p window-buffer +file-modes window-dedicated-p +frame-height window-display-table +frame-parameters window-height +frame-visible-p window-hscroll +frame-width window-point +get-register window-start +getenv window-width +global-key-binding x-get-cut-buffer +keymap-parent x-get-cutbuffer local-key-binding x-get-secondary-selection -mark x-get-selection -mark-marker +mark x-get-selection +mark-marker @end smallexample Most of these have directly corresponding ``set'' functions, like @@ -2001,7 +2001,7 @@ just as in Common Lisp. Because they are implemented in terms of Emacs Lisp @code{catch} and @code{throw}, blocks have the same overhead as actual @code{catch} constructs (roughly two function calls). However, -the optimizing byte compiler will optimize away the @code{catch} +the optimizing byte compiler will optimize away the @code{catch} if the block does not in fact contain any @code{return} or @code{return-from} calls that jump to it. This means that @code{do} loops and @code{defun*} diff --git a/man/cmdargs.texi b/man/cmdargs.texi index 964e943433d..497b31698c7 100644 --- a/man/cmdargs.texi +++ b/man/cmdargs.texi @@ -432,7 +432,7 @@ removed from the end if it was present. On Windows, the default value of @env{HOME} is @file{C:/}, the root directory of drive @file{C:}. @item HOSTNAME The name of the machine that Emacs is running on. -@item INCPATH +@item INCPATH A colon-separated list of directories. Used by the @code{complete} package to search for files. @item INFOPATH @@ -629,7 +629,7 @@ all users of the machine. Settings you add to the override machine wide settings. @node Display X -@appendixsec Specifying the Display Name +@appendixsec Specifying the Display Name @cindex display name (X Window System) @cindex @env{DISPLAY} environment variable @@ -913,7 +913,7 @@ text-only terminals as well as on window systems. @cindex specifying fullscreen for Emacs frame Here is a list of the command-line options for specifying size and -position of the initial Emacs frame: +position of the initial Emacs frame: @table @samp @item -g @var{width}x@var{height}@r{[@{}+-@r{@}}@var{xoffset}@r{@{}+-@r{@}}@var{yoffset}@r{]]} diff --git a/man/commands.texi b/man/commands.texi index a751b9fbf16..b0727cfa1e4 100644 --- a/man/commands.texi +++ b/man/commands.texi @@ -84,7 +84,7 @@ don't hold down @key{ESC} while typing the next character; instead, you press it and release it, then you enter the next character. @key{ESC} is allowed on terminals with @key{META} keys, too, in case you have formed a habit of using it. - + The X Window System provides several other modifier keys that can be applied to any input character. These are called @key{SUPER}, @key{HYPER} and @key{ALT}. We write @samp{s-}, @samp{H-} and @samp{A-} @@ -183,7 +183,7 @@ There are a few prefix keys for which @kbd{C-h} does not work---for historical reasons, they have other meanings for @kbd{C-h} which are not easy to change. But @key{F1} should work for all prefix keys. - + @node Commands, Text Characters, Keys, Top @section Keys and Commands diff --git a/man/custom.texi b/man/custom.texi index 50221628faf..6d803683880 100644 --- a/man/custom.texi +++ b/man/custom.texi @@ -27,17 +27,17 @@ customizations for future sessions, this actually works by editing you can control their functioning. * Keyboard Macros:: A keyboard macro records a sequence of keystrokes to be replayed with a single - command. + command. * Key Bindings:: The keymaps say what command each key runs. By changing them, you can "redefine keys". * Keyboard Translations:: If your keyboard passes an undesired code for a key, you can tell Emacs to - substitute another code. + substitute another code. * Syntax:: The syntax table controls how words and expressions are parsed. * Init File:: How to write common customizations in the - @file{.emacs} file. + @file{.emacs} file. @end menu @node Minor Modes @@ -328,10 +328,10 @@ Confirm Kill Emacs: [Hide] [Value Menu] Don't confirm [State]: this option is unchanged from its standard setting. How to ask for confirmation when leaving Emacs. [More] -Editing group: [Go to Group] +Editing group: [Go to Group] Basic text editing facilities. -External group: [Go to Group] +External group: [Go to Group] Interfacing to external utilities. @var{more second-level groups} @@ -693,7 +693,7 @@ that match @var{regexp}. @item M-x customize-changed-options @key{RET} @var{version} @key{RET} Set up a customization buffer with all the options, faces and groups whose meaning has changed since Emacs version @var{version}. -@item M-x customize-saved +@item M-x customize-saved Set up a customization buffer containing all options and faces that you have saved with customization buffers. @item M-x customize-customized @@ -1575,7 +1575,7 @@ press the key, a message like this appears so that you can confirm that you are binding the key you want: @example -Set key C-z to command: +Set key C-z to command: @end example You can redefine function keys and mouse events in the same way; just diff --git a/man/dired-x.texi b/man/dired-x.texi index 6a5ce041994..a1172019544 100644 --- a/man/dired-x.texi +++ b/man/dired-x.texi @@ -1,7 +1,7 @@ \input texinfo @comment -*-texinfo-*- @c dired-x.texi --- Sebastian Kremer's Extra DIRED hacked up for GNU Emacs19 -@c +@c @c Author: Sebastian Kremer <sk@thp.uni-koeln.de> @c Lawrence R. Dodd <dodd@roebling.poly.edu> @c [Dodd's address no longer valid.] @@ -108,10 +108,10 @@ provided by the file @file{dired-x.el}. Based on @file{dired.texi} by Sebastian Kremer <sk@@thp.uni-koeln.de> @c dired-x.el REVISION NUMBER -@item +@item For @file{dired-x.el} revision 2 -@c @item +@c @item @c Revision of this manual: 2.53 (2001/02/25 14:05:46) @c @item @@ -137,10 +137,10 @@ For @file{dired-x.el} revision 2 * Miscellaneous Commands:: * Bugs:: -* Concept Index:: -* Command Index:: -* Key Index:: -* Variable Index:: +* Concept Index:: +* Command Index:: +* Key Index:: +* Variable Index:: @end menu @@ -177,7 +177,7 @@ Some features provided by Dired Extra @enumerate @item -Omitting uninteresting files from Dired listing. +Omitting uninteresting files from Dired listing. @itemize @bullet @xref{Omitting Files in Dired}. @end itemize @@ -298,7 +298,7 @@ for these functions. In your @file{.emacs} file put @example ;;; Autoload `dired-jump' and `dired-jump-other-window'. -;;; We autoload from FILE dired.el. This will then load dired-x.el +;;; We autoload from FILE dired.el. This will then load dired-x.el ;;; and hence define `dired-jump' and `dired-jump-other-window'. (define-key global-map "\C-x\C-j" 'dired-jump) (define-key global-map "\C-x4\C-j" 'dired-jump-other-window) @@ -337,7 +337,7 @@ If you choose to have @file{dired-x.el} bind @code{dired-x-find-file} over @code{dired-x-bind-find-file} in the @code{dired-load-hook}: @example -(add-hook 'dired-load-hook +(add-hook 'dired-load-hook (lambda () (load "dired-x") ;; Bind dired-x-find-file. @@ -351,7 +351,7 @@ Alternatively, you can set the variable @emph{before} @file{dired-x.el} is loaded @example -(add-hook 'dired-load-hook +(add-hook 'dired-load-hook (lambda () ;; Bind dired-x-find-file. (setq dired-x-hands-off-my-keys nil) @@ -596,7 +596,7 @@ in your @code{dired-mode-hook}. When Dired visits a directory, it looks for a file whose name is the value of variable @code{dired-local-variables-file} (default: @file{.dired}). If such a file is found, Dired will temporarily insert it into the Dired buffer and -run @code{hack-local-variables}. +run @code{hack-local-variables}. @noindent For example, if the user puts @@ -614,7 +614,7 @@ viewed it will be @enumerate @item -sorted by date +sorted by date @item omitted automatically @end enumerate @@ -623,7 +623,7 @@ omitted automatically You can set @code{dired-local-variables-file} to @code{nil} to suppress this. The value of @code{dired-enable-local-variables} controls if and how these local variables are read. This variable exists so that if may override the -default value of @code{enable-local-variables}. +default value of @code{enable-local-variables}. @noindent Please see the GNU Emacs Manual to learn more about local variables. @@ -1273,7 +1273,7 @@ If you encounter a bug in this package, wish to suggest an enhancement, or want to make a smart remark, then type @example -@kbd{M-x dired-x-submit-report} +@kbd{M-x dired-x-submit-report} @end example @noindent @@ -1283,7 +1283,7 @@ This command also inserts information that the Dired X maintainer can use to recreate your exact setup, making it easier to verify your bug or social maladjustment. -Lawrence R. Dodd +Lawrence R. Dodd @c <dodd@@roebling.poly.edu> @node Concept Index, Command Index, Bugs, Top diff --git a/man/display.texi b/man/display.texi index 0dbd9621016..e192db56a51 100644 --- a/man/display.texi +++ b/man/display.texi @@ -529,7 +529,7 @@ back on screen. By default, @code{scroll-conservatively} is 0. @cindex aggressive scrolling @vindex scroll-up-aggressively -@vindex scroll-down-aggressively +@vindex scroll-down-aggressively When the window does scroll by a longer distance, you can control how aggressively it scrolls, by setting the variables @code{scroll-up-aggressively} and @code{scroll-down-aggressively}. diff --git a/man/ebrowse.texi b/man/ebrowse.texi index f82d1e8988f..8a500a0feba 100644 --- a/man/ebrowse.texi +++ b/man/ebrowse.texi @@ -33,7 +33,7 @@ license to the document, as described in section 6 of the license. @end copying @dircategory Emacs -@direntry +@direntry * Ebrowse: (ebrowse). A C++ class browser for Emacs. @end direntry @@ -94,7 +94,7 @@ knows what identifiers are defined in your program@dots{}. The design of Ebrowse reflects these two needs. -How does it work? +How does it work? @cindex parser for C++ sources A fast parser written in C is used to process C++ source files. @@ -288,7 +288,7 @@ might want to add this to your init file: (add-to-list 'auto-mode-alist '(@var{NAME} . ebrowse-tree-mode)) @end lisp -@noindent +@noindent where @var{NAME} is the Lisp data base name you are using. @findex --append @@ -621,7 +621,7 @@ This command is also provided in the tree buffer's context menu. @item s Display file names for the current line, or for the number of lines -given by a prefix argument. +given by a prefix argument. @end table Here is an example of a tree buffer with file names displayed. @@ -664,7 +664,7 @@ name like in the example below. @table @kbd @item - This command collapses the branch of the tree starting at the class the -cursor is on. +cursor is on. @item + This command expands the branch of the tree starting at the class the @@ -760,7 +760,7 @@ also @xref{Tags-like Functions}.)@refill @item M t Toggle the mark of the line point is in or for as many lines as given by a prefix command. This command can also be found in the class' context -menu. +menu. @cindex unmark all @item M a @@ -861,7 +861,7 @@ list. @item L f Switch to the list of member functions. -@cindex static +@cindex static @item L F Switch to the list of static member functions. @@ -880,7 +880,7 @@ Switch to the list of types. Both commands cycle through the member list. -Most of the commands are also available from the member buffer's +Most of the commands are also available from the member buffer's context menu. @@ -996,7 +996,7 @@ displayed in the member buffer. @table @kbd @cindex @code{public} members -@item F a u +@item F a u This command toggles the display of @code{public} members. The @samp{a} stands for `access'. @@ -1217,7 +1217,7 @@ This command sets the column width depending on the display form used This command forces a redisplay of the member buffer. If the width of the window displaying the member buffer is changed this command redraws the member list with the appropriate column widths and number of -columns. +columns. @end table @@ -1348,7 +1348,7 @@ This command moves forward in the position stack, setting point to the next position stored in the position stack. @item C-c b p -Displays an electric buffer showing all positions saved in the stack. +Displays an electric buffer showing all positions saved in the stack. You can select a position by pressing @kbd{SPC} in a line. You can view a position with @kbd{v}. @end table @@ -1388,7 +1388,7 @@ All three operations above stop when finding a match. You can restart the operation with this command. @item C-c b n -This restarts the last tags operation with the next file in the list. +This restarts the last tags operation with the next file in the list. @end table @@ -1410,7 +1410,7 @@ name is read from the minibuffer with completion. @node Apropos, Symbol Completion, Members in Files, Tags-like Functions @comment node-name, next, previous, up -@section Member Apropos +@section Member Apropos @cindex apropos on class members @cindex members, matching regexp diff --git a/man/emacs-mime.texi b/man/emacs-mime.texi index 0bd6909d248..ab47e5a900a 100644 --- a/man/emacs-mime.texi +++ b/man/emacs-mime.texi @@ -900,7 +900,7 @@ options. @defopt mm-inline-media-tests This is an alist where the key is a @sc{mime} type, the second element -is a function to display the part @dfn{inline} (i.e., inside Emacs), and +is a function to display the part @dfn{inline} (i.e., inside Emacs), and the third element is a form to be @code{eval}ed to say whether the part can be displayed inline. @@ -923,7 +923,7 @@ be displayed automatically. @defopt mm-attachment-override-types Some @sc{mime} agents create parts that have a content-disposition of -@samp{attachment}. This variable allows overriding that disposition and +@samp{attachment}. This variable allows overriding that disposition and displaying the part inline. (Note that the disposition is only overridden if we are able to, and want to, display the part inline.) @end defopt @@ -981,7 +981,7 @@ Here's an example viewer for displaying @samp{text/enriched} inline: @end lisp We see that the function takes a @sc{mime} handle as its parameter. It -then goes to a temporary buffer, inserts the text of the part, does some +then goes to a temporary buffer, inserts the text of the part, does some work on the text, stores the result, goes back to the buffer it was called from and inserts the result. diff --git a/man/emacs.texi b/man/emacs.texi index bc6ddbf480f..ca5ddf039ba 100644 --- a/man/emacs.texi +++ b/man/emacs.texi @@ -37,7 +37,7 @@ Software Foundation raise funds for GNU development.'' @c in general, keep the following line commented out, unless doing a @c copy of this manual that will be published. the manual should go -@c onto the distribution in the full, 8.5 x 11" size. +@c onto the distribution in the full, 8.5 x 11" size. @c @smallbook @@ -144,7 +144,7 @@ Important General Concepts * Keys:: Key sequences: what you type to request one editing action. * Commands:: Named functions run by key sequences to do editing. -* Text Characters:: Character set for text (the contents of buffers +* Text Characters:: Character set for text (the contents of buffers and strings). * Entering Emacs:: Starting Emacs from the shell. * Exiting:: Stopping or killing Emacs. @@ -282,7 +282,7 @@ Deletion and Killing blank areas. * Killing by Lines:: How to kill entire lines of text at one time. * Other Kill Commands:: Commands to kill large regions of text and - syntactic units such as words and sentences. + syntactic units such as words and sentences. Yanking @@ -376,7 +376,7 @@ Using Multiple Buffers * Kill Buffer:: Killing buffers you no longer need. * Several Buffers:: How to go through the list of all buffers and operate variously on several of them. -* Indirect Buffers:: An indirect buffer shares the text of another buffer. +* Indirect Buffers:: An indirect buffer shares the text of another buffer. Multiple Windows @@ -547,14 +547,14 @@ Compiling and Testing Programs * Compilation Mode:: The mode for visiting compiler errors. * Compilation Shell:: Customizing your shell properly for use in the compilation buffer. -* Debuggers:: Running symbolic debuggers for non-Lisp programs. -* Executing Lisp:: Various modes for editing Lisp programs, +* Debuggers:: Running symbolic debuggers for non-Lisp programs. +* Executing Lisp:: Various modes for editing Lisp programs, with different facilities for running - the Lisp programs. + the Lisp programs. * Lisp Libraries:: Creating Lisp programs to run in Emacs. * Lisp Interaction:: Executing Lisp in an Emacs buffer. * Lisp Eval:: Executing a single Lisp expression in Emacs. -* External Lisp:: Communicating through Emacs with a separate Lisp. +* External Lisp:: Communicating through Emacs with a separate Lisp. Running Debuggers Under Emacs @@ -575,10 +575,10 @@ Maintaining Programs Tags Tables -* Tag Syntax:: Tag syntax for various types of code and text files. +* Tag Syntax:: Tag syntax for various types of code and text files. * Create Tags Table:: Creating a tags table with @code{etags}. * Select Tags Table:: How to visit a tags table. -* Find Tag:: Commands to find the definition of a specific tag. +* Find Tag:: Commands to find the definition of a specific tag. * Tags Search:: Using a tags table for searching and replacing. * List Tags:: Listing and finding tags defined in a file. @@ -722,17 +722,17 @@ Customization to decide what to do; by setting variables, you can control their functioning. * Keyboard Macros:: A keyboard macro records a sequence of - keystrokes to be replayed with a single command. + keystrokes to be replayed with a single command. * Key Bindings:: The keymaps say what command each key runs. By changing them, you can "redefine keys". * Keyboard Translations:: If your keyboard passes an undesired code for a key, you can tell Emacs to - substitute another code. + substitute another code. * Syntax:: The syntax table controls how words and expressions are parsed. * Init File:: How to write common customizations in the - @file{.emacs} file. + @file{.emacs} file. Variables @@ -865,7 +865,7 @@ chapters when you need them. properly. It explains how to cope with some common problems (@pxref{Lossage}), as well as when and how to report Emacs bugs (@pxref{Bugs}). - + To find the documentation on a particular command, look in the index. Keys (character commands) and command names have separate indexes. There is also a glossary, with a cross reference for each term. @@ -1359,7 +1359,7 @@ when it starts in an interactive mode: Gnomovision version 69, Copyright (C) 20@var{yy} @var{name of author} Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. This is free software, and you are welcome -to redistribute it under certain conditions; type `show c' +to redistribute it under certain conditions; type `show c' for details. @end smallexample @@ -1377,7 +1377,7 @@ necessary. Here is a sample; alter the names: @group Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' -(which makes passes at compilers) written +(which makes passes at compilers) written by James Hacker. @var{signature of Ty Coon}, 1 April 1989 diff --git a/man/entering.texi b/man/entering.texi index f33cd739401..5b6c28472bf 100644 --- a/man/entering.texi +++ b/man/entering.texi @@ -4,7 +4,7 @@ @node Entering Emacs, Exiting, Text Characters, Top @chapter Entering and Exiting Emacs @cindex entering Emacs -@cindex starting Emacs +@cindex starting Emacs The usual way to invoke Emacs is with the shell command @command{emacs}. Emacs clears the screen and then displays an initial help message and diff --git a/man/eshell.texi b/man/eshell.texi index c5e2d517d5d..188ac520a16 100644 --- a/man/eshell.texi +++ b/man/eshell.texi @@ -1,5 +1,5 @@ \input texinfo @c -*-texinfo-*- -@c "@(#)$Name: $:$Id: eshell.texi,v 1.16 2002/10/02 23:24:31 karl Exp $" +@c "@(#)$Name: $:$Id: eshell.texi,v 1.17 2002/12/10 13:16:31 pj Exp $" @c %**start of header @setfilename ../info/eshell @settitle Eshell: The Emacs Shell @@ -82,17 +82,17 @@ handling the sort of tasks accomplished by those tools. @menu * What is Eshell?:: A brief introduction to the Emacs Shell. * Installation:: For users of Emacs 20 and XEmacs. -* Command basics:: The basics of command usage. -* Commands:: -* Arguments:: -* Input/Output:: -* Process control:: -* Extension modules:: -* Extras and Goodies:: +* Command basics:: The basics of command usage. +* Commands:: +* Arguments:: +* Input/Output:: +* Process control:: +* Extension modules:: +* Extras and Goodies:: * Bugs and ideas:: Known problems, and future ideas. -* Concept Index:: -* Function and Variable Index:: -* Key Index:: +* Concept Index:: +* Function and Variable Index:: +* Key Index:: @end menu @node What is Eshell? @@ -479,11 +479,11 @@ on your mind. Have fun! @chapter Commands @menu -* Invocation:: -* Completion:: -* Aliases:: -* History:: -* Scripts:: +* Invocation:: +* Completion:: +* Aliases:: +* History:: +* Scripts:: * Built-ins:: @end menu @@ -507,7 +507,7 @@ command, follows these steps: @enumerate @item Parse the command string into separate arguments. -@item +@item @end enumerate @node Completion @@ -572,11 +572,11 @@ With @samp{cd -42}, you can access the directory stack by number. @chapter Arguments @menu -* The Parser:: -* Variables:: -* Substitution:: -* Globbing:: -* Predicates:: +* The Parser:: +* Variables:: +* Substitution:: +* Globbing:: +* Predicates:: @end menu @node The Parser @@ -606,13 +606,13 @@ With @samp{cd -42}, you can access the directory stack by number. @chapter Extension modules @menu -* Writing a module:: -* Module testing:: -* Directory handling:: -* Key rebinding:: -* Smart scrolling:: -* Terminal emulation:: -* Built-in UNIX commands:: +* Writing a module:: +* Module testing:: +* Directory handling:: +* Key rebinding:: +* Smart scrolling:: +* Terminal emulation:: +* Built-in UNIX commands:: @end menu @node Writing a module @@ -659,7 +659,7 @@ extensions to this package, I would like to hear from you. I hope you find this package useful! @menu -* Known problems:: +* Known problems:: @end menu @node Known problems @@ -1091,7 +1091,7 @@ perform this on-thy-fly rewriting. @item Write an alias for @command{less} that brings up a @code{view-mode} buffer Such that the user can press @key{SPC} and @key{DEL}, and then @key{q} -to return to Eshell. It would be equivalent to: +to return to Eshell. It would be equivalent to: @samp{X > #<buffer Y>; view-buffer #<buffer Y>}. @item Make @code{eshell-mode} as much a full citizen as @code{shell-mode} diff --git a/man/eudc.texi b/man/eudc.texi index a32e8d43aae..511069973df 100644 --- a/man/eudc.texi +++ b/man/eudc.texi @@ -70,7 +70,7 @@ LDAP or the CCSO white pages directory system (PH/QI) * Usage:: The various usage possibilities explained * Credits:: Who's done what * Command and Function Index:: -* Variables Index:: +* Variables Index:: @end menu @@ -83,7 +83,7 @@ LDAP or the CCSO white pages directory system (PH/QI) EUDC, the @dfn{Emacs Unified Directory Client}, provides a common user interface to access directory servers using different directory -protocols. +protocols. Currently supported back-ends are: @@ -99,7 +99,7 @@ BBDB, Big Brother's Insiduous Database The main features of the EUDC interface are: @itemize @bullet -@item +@item Queries using a customizable form @item Inline query expansion (for instance you can expand a name @@ -216,10 +216,10 @@ initialization file to add a shortcut for email address expansion in email composition buffers (@pxref{Inline Query Expansion}) @lisp -(eval-after-load +(eval-after-load "message" '(define-key message-mode-map [(control ?c) (tab)] 'eudc-expand-inline)) -(eval-after-load +(eval-after-load "sendmail" '(define-key mail-mode-map [(control ?c) (tab)] 'eudc-expand-inline)) @end lisp @@ -255,7 +255,7 @@ customization options are available through the @samp{Directory Search} submenu of the @samp{Tools} submenu. @menu -* Querying Servers:: How queries are performed and handled +* Querying Servers:: How queries are performed and handled * Query Form:: How to use and customize the query form * Display of Query Results:: Controlling how query results are presented * Inline Query Expansion:: How to use and customize inline queries @@ -463,7 +463,7 @@ containing the results of the query. The fields that are returned for each record are controlled by @code{eudc-default-return-attributes} (@pxref{Return -Attributes}). +Attributes}). The display of each individual field can be performed by an arbitrary function which allows specific processing for binary values, such as @@ -484,12 +484,12 @@ This variable has protocol-local definitions (see @pxref{Server/Protocol Locals}). For instance, it is defined as follows for LDAP: @lisp -(eudc-protocol-set 'eudc-attribute-display-method-alist +(eudc-protocol-set 'eudc-attribute-display-method-alist '(("jpegphoto" . eudc-display-jpeg-inline) ("labeledurl" . eudc-display-url) ("audio" . eudc-display-sound) ("labeledurl" . eudc-display-url) - ("url" . eudc-display-url)) + ("url" . eudc-display-url)) 'ldap) @end lisp @@ -547,7 +547,7 @@ controlled by the variables @code{eudc-inline-expansion-format}, @code{eudc-expanding-overwrites-query} and @code{eudc-multiple-match-handling-method}. -If the query fails for a server, other servers may be tried successively +If the query fails for a server, other servers may be tried successively until one of them finds a match (@pxref{Multi-server Queries}). @deffn Command eudc-expand-inline replace-p @@ -564,7 +564,7 @@ is non-@code{nil} then the meaning of @var{replace-p} is negated. @end deffn @defvar eudc-inline-query-format -Format of an inline expansion query. +Format of an inline expansion query. This is actually a list of @var{format}s. A @var{format} is a list of one or more EUDC attribute names. A @var{format} applies if it contains as many attributes as individual words in the inline query string. If @@ -572,7 +572,7 @@ several @var{format}s apply then they are tried in order until a match is found. If @code{nil} all the words will be mapped onto the default server/protocol attribute name (generally @code{name}). -For instance, use the following +For instance, use the following @lisp (setq eudc-inline-query-format '((name) (firstname) @@ -582,7 +582,7 @@ For instance, use the following to indicate that single word expansion queries are to be considered as surnames and if no match is found then they should be tried as first names. Inline queries consisting of two words are considered as -consisting of a first name followed by a surname. If the query consists +consisting of a first name followed by a surname. If the query consists of more than two words, then the first one is considered as the first name and the remaining words are all considered as surname constituents. @@ -620,7 +620,7 @@ for an inline expansion. Possible values are: The first match is considered as being the only one, the others are discarded. @item select -A selection buffer pops up where you can choose a particular match. This +A selection buffer pops up where you can choose a particular match. This is the default value of the variable. @item all The expansion uses all records successively @@ -637,7 +637,7 @@ Default is @code{select} @comment node-name, next, previous, up @section The Server Hotlist -EUDC lets you maintain a list of frequently used servers so that you +EUDC lets you maintain a list of frequently used servers so that you can easily switch from one to another. This hotlist appears in the @samp{Server} submenu. You select a server in this list by clicking on its name. You can add the current server to the list with the command @@ -661,7 +661,7 @@ Add the current server to the hotlist of servers @defvar eudc-options-file The name of a file where EUDC stores its internal variables -(the hotlist and the current server). EUDC will try to load +(the hotlist and the current server). EUDC will try to load that file upon initialization so, if you choose a file name different from the defaults @file{~/.eudc-options}, be sure to set this variable to the appropriate value @emph{before} EUDC is itself @@ -775,25 +775,25 @@ The value of this variable should be a symbol naming an alist defining a mapping between BBDB field names onto directory attribute names records. This is a protocol-local variable and is initialized upon protocol switch (@pxref{Server/Protocol Locals}). The alist is made of cells of the -form @code{(@var{bbdb-field} . @var{spec-or-list})}. +form @code{(@var{bbdb-field} . @var{spec-or-list})}. @var{bbdb-field} is the name of a field that must be defined in your BBDB environment (standard field names are @code{name}, @code{company}, @code{net}, @code{phone}, @code{address} -and @code{notes}). +and @code{notes}). @var{spec-or-list} is either a single mapping specification or a list of mapping specifications. Lists of mapping specifications are valid for the @code{phone} and @code{address} BBDB fields only. @var{spec}s are actually s-expressions which are evaluated as follows: @table @asis -@item a string +@item a string evaluates to itself @item a symbol evaluates to the symbol value. Symbols corresponding to directory attribute names present in the record evaluate to the value of the field in the record @item a form -is evaluated as a function. The argument list may contain attribute +is evaluated as a function. The argument list may contain attribute names which evaluate to the corresponding values in the record. The form evaluation should return something appropriate for the particular @var{bbdb-field} (see @code{bbdb-create-internal}). @@ -816,7 +816,7 @@ The default value of the PH-specific value of that variable is This means that: @itemize @bullet -@item +@item the @code{name} field of the BBDB record gets its value from the @code{name} attribute of the directory record @item @@ -932,7 +932,7 @@ Return the value of @var{var} local to @var{protocol}. Return @end defun @defun eudc-variable-server-value var [server] -Return the value of @var{var} local to @var{server}. +Return the value of @var{var} local to @var{server}. Return @code{unbound} if @var{var} has no value local to @var{server}. @var{server} defaults to @code{eudc-server}. @end defun @@ -952,7 +952,7 @@ Update all EUDC variables according to their local settings. @comment node-name, next, previous, up @chapter Credits -EUDC was written by Oscar Figueiredo based on @file{ph.el} by the +EUDC was written by Oscar Figueiredo based on @file{ph.el} by the same author. Thanks to Soren Dayton for his suggestions, his enthusiasm and his help diff --git a/man/files.texi b/man/files.texi index e6729601b84..2c18092286c 100644 --- a/man/files.texi +++ b/man/files.texi @@ -1083,7 +1083,7 @@ links point to directories. If you visit two names for the same file, normally Emacs makes two different buffers, but it warns you about the situation. -@vindex find-file-existing-other-name +@vindex find-file-existing-other-name @vindex find-file-suppress-same-file-warnings Normally, if you visit a file which Emacs is already visiting under a different name, Emacs displays a message in the echo area and uses @@ -1112,7 +1112,7 @@ implies the effect of @code{find-file-existing-other-name}. @dfn{Version control systems} are packages that can record multiple versions of a source file, usually storing the unchanged parts of the file just once. Version control systems also record history information -such as the creation time of each version, who created it, and a +such as the creation time of each version, who created it, and a description of what was changed in that version. The Emacs version control interface is called VC. Its commands work @@ -1239,7 +1239,7 @@ check-in time. However, CVS can also be set up to require locking. @node Types of Log File @subsubsection Types of Log File @cindex types of log file -@cindex log File, types of +@cindex log File, types of @cindex version control log GNU projects under a revision control system generally possess @@ -1310,8 +1310,8 @@ in your @file{~/.emacs} file. (@xref{Init Rebinding}.) * Advanced C-x v v:: Advanced features available with a prefix argument. * Log Buffer:: Features available in log entry buffers. @end menu - -@node VC with Locking + +@node VC with Locking @subsubsection Basic Version Control with Locking If locking is used for the file (as with SCCS, and RCS in its default @@ -1540,7 +1540,7 @@ use once a day. * Registering:: Putting a file under version control. * VC Status:: Viewing the VC status of files. * VC Undo:: Cancelling changes before or after check-in. -* VC Dired Mode:: Listing files managed by version control. +* VC Dired Mode:: Listing files managed by version control. * VC Dired Commands:: Commands to use in a VC Dired buffer. @end menu @@ -1807,7 +1807,7 @@ example above have branch numbers 1.2.1 and 1.2.2. * Switching Branches:: How to get to another existing branch. * Creating Branches:: How to start a new branch. * Merging:: Transferring changes between branches. -* Multi-User Branching:: Multiple users working at multiple branches +* Multi-User Branching:: Multiple users working at multiple branches in parallel. @end menu @@ -2225,7 +2225,7 @@ won't really work as retrieved. @menu * Change Logs and VC:: Generating a change log file from log entries. -* Renaming and VC:: A command to rename both the source and master +* Renaming and VC:: A command to rename both the source and master file correctly. * Version Headers:: Inserting version control headers into working files. @end menu diff --git a/man/fixit.texi b/man/fixit.texi index a4b843f07b5..21f613a93ad 100644 --- a/man/fixit.texi +++ b/man/fixit.texi @@ -173,7 +173,7 @@ Check and correct spelling of each word in the buffer. @item M-x ispell-region Check and correct spelling of each word in the region. @item M-x ispell-message -Check and correct spelling of each word in a draft mail message, +Check and correct spelling of each word in a draft mail message, excluding cited material. @item M-x ispell-change-dictionary @key{RET} @var{dict} @key{RET} Restart the Ispell process, using @var{dict} as the dictionary. diff --git a/man/forms.texi b/man/forms.texi index 7c323094112..91a1f456f24 100644 --- a/man/forms.texi +++ b/man/forms.texi @@ -82,7 +82,7 @@ how to present it. * Forms Example:: An example: editing the password data base. * Entering and Exiting Forms Mode:: How to visit a file in Forms mode. -* Forms Commands:: Special commands to use while in Forms mode. +* Forms Commands:: Special commands to use while in Forms mode. * Data File Format:: How to format the data file. * Control File Format:: How to control forms mode. * Format Description:: How to define the forms layout. @@ -254,7 +254,7 @@ Create a new record and insert it before the current record contents for its fields; you can then edit the fields. With a numeric argument, the new record is created @emph{after} the current one. See also @code{forms-modified-record-filter} in @ref{Modifying Forms -Contents}. +Contents}. @findex forms-delete-record @kindex C-c C-k @@ -531,7 +531,7 @@ modified, just before updating the Forms data file. If it is @findex forms-insert-after @item forms-insert-after -If this variable is not @code{nil}, new records are created @emph{after} the +If this variable is not @code{nil}, new records are created @emph{after} the current record. Also, upon visiting a file, the initial position will be at the last record instead of the first one. @@ -613,7 +613,7 @@ in the beginning of this manual might look as follows: @end example When you construct the value of @code{forms-format-list}, you should -usually either quote the whole value, like this, +usually either quote the whole value, like this, @example (setq forms-format-list @@ -654,7 +654,7 @@ If @code{forms-read-only} is @code{nil}, the user can modify the fields and records of the database. All normal editing commands are available for editing the contents of the -displayed record. You cannot delete or modify the fixed, explanatory +displayed record. You cannot delete or modify the fixed, explanatory text that comes from string formatting elements, but you can modify the actual field contents. @@ -762,7 +762,7 @@ file. @item Forms control file error: `forms-number-of-fields' must be a number > 0 The variable @code{forms-number-of-fields} did not contain a positive -number. +number. @item Forms control file error: `forms-field-sep' is not a string @itemx Forms control file error: `forms-multi-line' must be nil or a one-character string @@ -835,7 +835,7 @@ An internal error prevented a specific record from being retrieved. @item No write access to @code{"}@var{file}@code{"} An attempt was made to enable edit mode on a file that has been write -protected. +protected. @item Search failed: @var{regexp} The @var{regexp} could not be found in the data file. Forward searching @@ -899,7 +899,7 @@ The optional FILL should be a character, used to fill to the column." (concat "\n" (make-string target fill)) (make-string (- target (current-column)) fill))) ;; -(defun arch-rj (target field &optional fill) +(defun arch-rj (target field &optional fill) "Produces a string to skip to column TARGET\ minus the width of field FIELD. Prepends newline if needed. diff --git a/man/frames.texi b/man/frames.texi index 2fdc1b7c4fc..4542893894c 100644 --- a/man/frames.texi +++ b/man/frames.texi @@ -273,7 +273,7 @@ particularly under OpenWindows and Gnome. The command @kbd{M-x menu-bar-enable-clipboard} makes the @code{Cut}, @code{Paste} and @code{Copy} menu items, as well as the keys of the same names, all use the clipboard. - + You can customize the option @code{x-select-enable-clipboard} to make the Emacs yank functions consult the clipboard before the primary selection, and to make the kill functions to store in the clipboard as @@ -394,7 +394,7 @@ subcommands. The difference is that @kbd{C-x 5} commands create a new frame rather than just a new window in the selected frame (@pxref{Pop Up Window}). If an existing visible or iconified frame already displays the requested material, these commands use the existing frame, after -raising or deiconifying as necessary. +raising or deiconifying as necessary. The various @kbd{C-x 5} commands differ in how they find or create the buffer to select: diff --git a/man/glossary.texi b/man/glossary.texi index bf5e1a35748..c347eb3f982 100644 --- a/man/glossary.texi +++ b/man/glossary.texi @@ -895,7 +895,7 @@ Point is the place in the buffer at which insertion and deletion occur. Point is considered to be between two characters, not at one character. The terminal's cursor (q.v.@:) indicates the location of point. @xref{Basic,Point,Basic Editing}. - + @item Prefix Argument See `numeric argument.' diff --git a/man/gnus-faq.texi b/man/gnus-faq.texi index 95ddf3234e8..acdb0edd5e4 100644 --- a/man/gnus-faq.texi +++ b/man/gnus-faq.texi @@ -100,7 +100,7 @@ Per Abrahamsen <abraham@@dina.kvl.dk> writes :@* The internal easymenu.el interface changed between 19.28 and 19.29 in order to make it possible to create byte compiled files that can be shared between Gnu Emacs and XEmacs. The change is upward -compatible, but not downward compatible. +compatible, but not downward compatible. This gives the following compatibility table: @example @@ -131,10 +131,10 @@ list is mainly for developers and testers. Gnus has a home World Wide Web page at@* @file{http://www.gnus.org/}. - + Gnus has a write up in the X Applications FAQ at@* @file{http://www.ee.ryerson.ca:8080/~elf/xapps/Q-III.html}. - + The Gnus manual is also available on the World Wide Web. The canonical source is in Norway at@* @file{http://www.gnus.org/manual/gnus_toc.html}. @@ -158,7 +158,7 @@ PostScript copies of the Gnus Reference card are available from@* United States. And@* @file{ftp://marvin.fkphy.uni-duesseldorf.de/pub/gnus/} in Germany. - + An online version of the Gnus FAQ is available at@* @file{http://www.miranova.com/~steve/gnus-faq.html}. Off-line formats are also available:@* @@ -277,7 +277,7 @@ Q2.3 How can I keep my nnvirtual:* groups sorted? How can I most efficiently arrange matters so as to keep my nnvirtual:* (etc) groups at the top of my group selection buffer, whilst keeping everything sorted in alphabetical order. - + If you don't subscribe often to new groups then the easiest way is to first sort the groups and then manually kill and yank the virtuals wherever you want them. @@ -307,7 +307,7 @@ The most vital entries in my (still young) all.SCORE: ("alt.fan.oj-simpson" -1000 nil s)) ("subject" (concat "\\<\\(make\\|fast\\|big\\)\\s-*" - "\\(money\\|cash\\|bucks?\\)\\>" + "\\(money\\|cash\\|bucks?\\)\\>" -1000 nil r) ("$$$$" -1000 nil s))) @end lisp @@ -336,7 +336,7 @@ I would like to contribute with mine. ;; $$$ Make Money $$$ ("$$" -10 nil s) ;; Empty subjects are worthless! - ("^ *\\([(<]none[>)]\\|(no subject\\( given\\)?)\\)? *$" + ("^ *\\([(<]none[>)]\\|(no subject\\( given\\)?)\\)? *$" -10 nil r) ;; Sometimes interesting announces occur! ("ANN?OU?NC\\(E\\|ING\\)" +10 nil r) @@ -571,7 +571,7 @@ like this: (gnus-auto-select-first nil))) @end lisp -and insert +and insert @lisp (setq gnus-auto-select-first t) @end lisp diff --git a/man/gnus.texi b/man/gnus.texi index 66fd0f915df..b9e6dfc84a2 100644 --- a/man/gnus.texi +++ b/man/gnus.texi @@ -627,7 +627,7 @@ Getting News Getting Mail -* Mail in a Newsreader:: Important introductory notes. +* Mail in a Newsreader:: Important introductory notes. * Getting Started Reading Mail:: A simple cookbook example. * Splitting Mail:: How to create mail groups. * Mail Sources:: How to tell Gnus where to get mail from. @@ -1188,7 +1188,7 @@ Kill all new groups. @item gnus-subscribe-topics @vindex gnus-subscribe-topics -Put the groups into the topic that has a matching @code{subscribe} topic +Put the groups into the topic that has a matching @code{subscribe} topic parameter (@pxref{Topic Parameters}). For instance, a @code{subscribe} topic parameter that looks like @@ -1196,7 +1196,7 @@ topic parameter that looks like "nnslashdot" @end example -will mean that all groups that match that regex will be subscribed under +will mean that all groups that match that regex will be subscribed under that topic. If no topics match the groups, the groups will be subscribed in the @@ -1486,7 +1486,7 @@ performance, but if the server does not support the aforementioned @code{LIST ACTIVE group} command, this isn't very nice to the server. If you think that starting up Gnus takes too long, try all the three -different values for this variable and see what works best for you. +different values for this variable and see what works best for you. In any case, if you use @code{some} or @code{nil}, you should definitely kill all groups that you aren't interested in to speed things up. @@ -2698,7 +2698,7 @@ will make @code{iso-8859-1} and @code{x-unknown} ignored; that is, the default charset will be used for decoding articles. See also @code{gnus-group-ignored-charsets-alist}. - + @item posting-style You can store additional posting style information for this group only here (@pxref{Posting Styles}). The format is that of an entry in the @@ -3278,7 +3278,7 @@ convention (@pxref{Process/Prefix}). @item T j @kindex T j (Topic) @findex gnus-topic-jump-to-topic -Go to a topic (@code{gnus-topic-jump-to-topic}). +Go to a topic (@code{gnus-topic-jump-to-topic}). @item T c @kindex T c (Topic) @@ -3523,10 +3523,10 @@ parameters: @table @code @item subscribe -When subscribing new groups by topic (@pxref{Subscription Methods}), the -@code{subscribe} topic parameter says what groups go in what topic. Its +When subscribing new groups by topic (@pxref{Subscription Methods}), the +@code{subscribe} topic parameter says what groups go in what topic. Its value should be a regexp to match the groups that should go in that -topic. +topic. @end table @@ -3642,7 +3642,7 @@ For example: @item gnus-group-name-charset-group-alist @vindex gnus-group-name-charset-group-alist -An alist of regexp of group name and the charset for group names. +An alist of regexp of group name and the charset for group names. It is used to show non-ASCII group names. For example: @@ -4498,8 +4498,8 @@ If given a numerical prefix, you can do semi-manual charset stuff. encoded in the @code{cn-gb-2312} charset. If you have @lisp -(setq gnus-summary-show-article-charset-alist - '((1 . cn-gb-2312) +(setq gnus-summary-show-article-charset-alist + '((1 . cn-gb-2312) (2 . big5))) @end lisp @@ -4731,7 +4731,7 @@ the process/prefix convention. @kindex S o p @r{(Summary)} @findex gnus-summary-post-forward Forward the current article to a newsgroup -(@code{gnus-summary-post-forward}). +(@code{gnus-summary-post-forward}). If no prefix is given, the message is forwarded according to the value of (@code{message-forward-as-mime}) and (@code{message-forward-show-mml}); if the prefix is 1, decode the @@ -6554,7 +6554,7 @@ a spool, you could @lisp (setq gnus-use-long-file-name '(not-save)) ; to get a hierarchy -(setq gnus-default-article-saver +(setq gnus-default-article-saver 'gnus-summary-save-in-file) ; no encoding @end lisp @@ -7432,7 +7432,7 @@ when filling. @item W Q @kindex W Q @r{(Summary)} -@findex gnus-article-fill-long-lines +@findex gnus-article-fill-long-lines Fill long lines (@code{gnus-article-fill-long-lines}). @item W C @@ -7480,7 +7480,7 @@ makes strings look like @samp{~@{<:Ky2;S@{#,NpJ)l6HK!#~@}}. @item W h @kindex W h @r{(Summary)} @findex gnus-article-wash-html -Treat HTML (@code{gnus-article-wash-html}). +Treat HTML (@code{gnus-article-wash-html}). Note that the this is usually done automatically by Gnus if the message in question has a @code{Content-Type} header that says that this type has been done. @@ -7824,7 +7824,7 @@ signature after all. @kindex A t @r{(Summary)} @findex gnus-article-babel Translate the article from one language to another -(@code{gnus-article-babel}). +(@code{gnus-article-babel}). @end table @@ -8529,7 +8529,7 @@ disk forever and ever, never to return again.'' Use with caution. @vindex gnus-preserve-marks Move the article from one mail group to another (@code{gnus-summary-move-article}). Marks will be preserved if -@var{gnus-preserve-marks} is non-@code{nil} (which is the default). +@var{gnus-preserve-marks} is non-@code{nil} (which is the default). @item B c @kindex B c @r{(Summary)} @@ -9277,7 +9277,7 @@ Copy the @sc{mime} object to a fresh buffer and display this buffer @findex gnus-mime-view-part-as-type @item t @r{(Article)} View the @sc{mime} object as if it were a different @sc{mime} media type -(@code{gnus-mime-view-part-as-type}). +(@code{gnus-mime-view-part-as-type}). @findex gnus-mime-pipe-part @item | @r{(Article)} @@ -9427,7 +9427,7 @@ You can, of course, write your own functions to be called from @code{gnus-part-display-hook}. The functions are called narrowed to the part, and you can do anything you like, pretty much. There is no information that you have to keep in the buffer---you can change -everything. +everything. @node Article Keymap @@ -10514,7 +10514,7 @@ manual page, but here are the salient facts: The file contains one or more line, each of which define one server. @item -Each line may contain an arbitrary number of token/value pairs. +Each line may contain an arbitrary number of token/value pairs. The valid tokens include @samp{machine}, @samp{login}, @samp{password}, @samp{default}. In addition Gnus introduces two new tokens, not present @@ -10573,7 +10573,7 @@ The default value is @lisp '(("nntpd 1\\.5\\.11t" - (remove-hook 'nntp-server-opened-hook + (remove-hook 'nntp-server-opened-hook 'nntp-send-mode-reader))) @end lisp @@ -10714,11 +10714,11 @@ define a server as follows: @lisp ;; Type `C-c C-c' after you've finished editing. ;; -;; "snews" is port 563 and is predefined +;; "snews" is port 563 and is predefined ;; in our /etc/services ;; (nntp "snews.bar.com" - (nntp-open-connection-function + (nntp-open-connection-function nntp-open-ssl-stream) (nntp-port-number "snews") (nntp-address "snews.bar.com")) @@ -10878,7 +10878,7 @@ Reading mail with a newsreader---isn't that just plain WeIrD? But of course. @menu -* Mail in a Newsreader:: Important introductory notes. +* Mail in a Newsreader:: Important introductory notes. * Getting Started Reading Mail:: A simple cookbook example. * Splitting Mail:: How to create mail groups. * Mail Sources:: How to tell Gnus where to get mail from. @@ -10897,11 +10897,11 @@ course. @node Mail in a Newsreader @subsection Mail in a Newsreader -If you are used to traditional mail readers, but have decided to switch +If you are used to traditional mail readers, but have decided to switch to reading mail with Gnus, you may find yourself experiencing something of a culture shock. -Gnus does not behave like traditional mail readers. If you want to make +Gnus does not behave like traditional mail readers. If you want to make it behave that way, you can, but it's an uphill battle. Gnus, by default, handles all its groups using the same approach. This @@ -10915,7 +10915,7 @@ Does this mean that all the messages that have been marked as read are deleted? How awful! But, no, it means that old messages are @dfn{expired} according to some -scheme or other. For news messages, the expire process is controlled by +scheme or other. For news messages, the expire process is controlled by the news administrator; for mail, the expire process is controlled by you. The expire process for mail is covered in depth in @pxref{Expiring Mail}. @@ -11071,7 +11071,7 @@ If you wish to see where the previous mail split put the messages, you can use the @kbd{M-x nnmail-split-history} command. If you wish to see where re-spooling messages would put the messages, you can use @code{gnus-summary-respool-trace} and related commands (@pxref{Mail -Group Commands}). +Group Commands}). Gnus gives you all the opportunity you could possibly want for shooting yourself in the foot. Let's say you create a group that will contain @@ -11146,8 +11146,8 @@ Or using the default file name: (file) @end lisp -If the mail spool file is not located on the local machine, it's best to -use POP or @sc{imap} or the like to fetch the mail. You can not use ange-ftp +If the mail spool file is not located on the local machine, it's best to +use POP or @sc{imap} or the like to fetch the mail. You can not use ange-ftp file names here---it has no way to lock the mail spool while moving the mail. @@ -11337,12 +11337,12 @@ from locking problems). Two example maildir mail sources: @lisp -(maildir :path "/home/user-name/Maildir/" +(maildir :path "/home/user-name/Maildir/" :subdirs ("cur" "new")) @end lisp @lisp -(maildir :path "/user@@remotehost.org:~/Maildir/" +(maildir :path "/user@@remotehost.org:~/Maildir/" :subdirs ("new")) @end lisp @@ -11435,8 +11435,8 @@ after finishing the fetch. An example @sc{imap} mail source: @lisp -(imap :server "mail.mycorp.com" - :stream kerberos4 +(imap :server "mail.mycorp.com" + :stream kerberos4 :fetchflag "\\Seen") @end lisp @@ -11476,8 +11476,8 @@ folder after finishing the fetch. An example webmail source: @lisp -(webmail :subtype 'hotmail - :user "user-name" +(webmail :subtype 'hotmail + :user "user-name" :password "secret") @end lisp @end table @@ -11495,7 +11495,7 @@ directory source to get mail, you can specify it as in this example: @lisp (setq mail-sources - '((directory :path "/home/pavel/.Spool/" + '((directory :path "/home/pavel/.Spool/" :suffix "" :plugged t))) @end lisp @@ -11704,7 +11704,7 @@ Let's look at an example value of this variable first: (any "procmail@@informatik\\.rwth-aachen\\.de" "procmail.list") (any "SmartList@@informatik\\.rwth-aachen\\.de" "SmartList.list") ;; Both lists below have the same suffix, so prevent - ;; cross-posting to mkpkg.list of messages posted only to + ;; cross-posting to mkpkg.list of messages posted only to ;; the bugs- list, but allow cross-posting when the ;; message was really cross-posted. (any "bugs-mypackage@@somewhere" "mypkg.bugs") @@ -12719,8 +12719,8 @@ itself puts *all* one's mail in one file; @code{nnfolder} provides a little bit of optimization to this so that each of one's mail groups has a Unix mail box file. It's faster than @code{nnmbox} because each group can be parsed separately, and still provides the simple Unix mail box -format requiring minimal effort in moving the mail around. In addition, -it maintains an ``active'' file making it much faster for Gnus to figure +format requiring minimal effort in moving the mail around. In addition, +it maintains an ``active'' file making it much faster for Gnus to figure out how many messages there are in each separate group. If you have groups that are expected to have a massive amount of @@ -12746,13 +12746,13 @@ and click, and there's the discussion. With mailing lists, you have to go through a cumbersome subscription procedure, and most people don't even know what a news group is. -The problem with this scenario is that web browsers are not very good at -being newsreaders. They do not keep track of what articles you've read; -they do not allow you to score on subjects you're interested in; they do +The problem with this scenario is that web browsers are not very good at +being newsreaders. They do not keep track of what articles you've read; +they do not allow you to score on subjects you're interested in; they do not allow off-line browsing; they require you to click around and drive you mad in the end. -So---if web browsers suck at reading discussion forums, why not use Gnus +So---if web browsers suck at reading discussion forums, why not use Gnus to do it instead? Gnus has been getting a bit of a collection of back ends for providing @@ -12769,7 +12769,7 @@ interfaces to these sources. All the web sources require Emacs/w3 and the url library to work. The main caveat with all these web sources is that they probably won't -work for a very long time. Gleaning information from the @sc{html} data +work for a very long time. Gleaning information from the @sc{html} data is guesswork at best, and when the layout is altered, the Gnus back end will fail. If you have reasonably new versions of these back ends, though, you should be ok. @@ -12971,7 +12971,7 @@ quite regular and nice interface, and it's possible to get the information Gnus needs to keep groups updated. The easiest way to get started with @code{nnultimate} is to say -something like the following in the group buffer: @kbd{B nnultimate @key{RET} +something like the following in the group buffer: @kbd{B nnultimate @key{RET} http://www.tcj.com/messboard/ubbcgi/ @key{RET}}. (Substitute the @sc{url} (not including @samp{Ultimate.cgi} or the like at the end) for a forum you're interested in; there's quite a list of them on the Ultimate web @@ -13032,12 +13032,12 @@ The password for your account on the web server. @cindex url @cindex Netscape -Gnus uses the url library to fetch web pages and Emacs/w3 to display web +Gnus uses the url library to fetch web pages and Emacs/w3 to display web pages. Emacs/w3 is documented in its own manual, but there are some things that may be more relevant for Gnus users. For instance, a common question is how to make Emacs/w3 follow links -using the @code{browse-url} functions (which will call some external web +using the @code{browse-url} functions (which will call some external web browser like Netscape). Here's one way: @lisp @@ -13722,7 +13722,7 @@ Here's an example: @lisp (setq gnus-post-method - '(nngateway + '(nngateway "mail2news@@replay.com" (nngateway-header-transformation nngateway-mail2news-header-transformation))) @@ -13771,7 +13771,7 @@ A server configuration in @code{~/.gnus} with a few @sc{imap} servers might look something like this: @lisp -(setq gnus-secondary-select-methods +(setq gnus-secondary-select-methods '((nnimap "simpleserver") ; no special configuration ; perhaps a ssh port forwarded server: (nnimap "dolk" @@ -13833,7 +13833,7 @@ Example server specification: @lisp (nnimap "mail.server.com" - (nnimap-list-pattern ("INBOX" "Mail/*" "alt.sex.*" + (nnimap-list-pattern ("INBOX" "Mail/*" "alt.sex.*" ("~friend/Mail/" . "list/*")))) @end lisp @@ -14041,7 +14041,7 @@ Neither did I, we need examples. @lisp (setq nnimap-split-rule - '(("INBOX.nnimap" + '(("INBOX.nnimap" "^Sender: owner-nnimap@@vic20.globalcom.se") ("INBOX.junk" "^Subject:.*MAKE MONEY") ("INBOX.private" ""))) @@ -15618,7 +15618,7 @@ returned is the local score file. Phu. For example, to do hierarchical scoring but use a non-server-specific overall score file, you could use the value @example -(list (lambda (group) ("all.SCORE")) +(list (lambda (group) ("all.SCORE")) 'gnus-score-find-hierarchical) @end example @@ -16297,7 +16297,7 @@ the @code{Xref} header. If you want to lower the score of articles that have been crossposted to more than, say, 3 groups: @lisp -("xref" +("xref" ("[^:\n]+:[0-9]+ +[^:\n]+:[0-9]+ +[^:\n]+:[0-9]+" -1000 nil r)) @end lisp @@ -17533,7 +17533,7 @@ for composing mail and news while leaving the original frame intact. To accomplish that, something like the following can be done: @lisp -(message +(message (frame 1.0 (if (not (buffer-live-p gnus-summary-buffer)) (car (cdr (assoc 'group gnus-buffer-configuration))) @@ -17575,7 +17575,7 @@ windows resized. @subsection Example Window Configurations @itemize @bullet -@item +@item Narrow left hand side occupied by group buffer. Right hand side split between summary buffer (top one-sixth) and article buffer (bottom). @@ -18090,7 +18090,7 @@ never be totally undoable. @findex gnus-undo The undoability is provided by the @code{gnus-undo-mode} minor mode. It is used if @code{gnus-use-undo} is non-@code{nil}, which is the -default. The @kbd{C-M-_} key performs the @code{gnus-undo} +default. The @kbd{C-M-_} key performs the @code{gnus-undo} command, which should feel kinda like the normal Emacs @code{undo} command. @@ -18915,7 +18915,7 @@ If was released as ``Gnus 5.6'' on March 8th 1998 (46 releases). Gnus 5.6 begat Pterodactyl Gnus on August 29th 1998 and was released as ``Gnus 5.8'' (after 99 releases and a CVS repository) on December 3rd -1999. +1999. If you happen upon a version of Gnus that has a prefixed name -- ``(ding) Gnus'', ``September Gnus'', ``Red Gnus'', ``Quassia Gnus'' -- @@ -20150,7 +20150,7 @@ If you used procmail like in (setq nnmail-procmail-suffix "\\.in") @end lisp -this now has changed to +this now has changed to @lisp (setq mail-sources @@ -20179,7 +20179,7 @@ of variables starting with @code{gnus-treat-} have been added. @item The Gnus posting styles have been redone again and now works in a subtly different manner. -@item New web-based back ends have been added: @code{nnslashdot}, +@item New web-based back ends have been added: @code{nnslashdot}, @code{nnwarchive} and @code{nnultimate}. nnweb has been revamped, again, to keep up with ever-changing layouts. @@ -20258,16 +20258,16 @@ I guess most manuals are written after-the-fact; documenting a program that's already there. This is not how this manual is written. When implementing something, I write the manual entry for that something straight away. I then see that it's difficult to explain the -functionality, so I write how it's supposed to be, and then I change the +functionality, so I write how it's supposed to be, and then I change the implementation. Writing the documentation and writing the code goes hand in hand. This, of course, means that this manual has no, or little, flow. It documents absolutely everything in Gnus, but often not where you're -looking for it. It is a reference manual, and not a guide to how to get +looking for it. It is a reference manual, and not a guide to how to get started with Gnus. -That would be a totally different book, that should be written using the +That would be a totally different book, that should be written using the reference manual as source material. It would look quite differently. @@ -21488,8 +21488,8 @@ Below is a slightly shortened version of the @code{nndir} back end. "*Non-nil means that nndir will never retrieve NOV headers." nnml-nov-is-evil) -(defvoo nndir-current-group "" - nil +(defvoo nndir-current-group "" + nil nnml-current-group nnmh-current-group) (defvoo nndir-top-directory nil nil nnml-directory nnmh-directory) (defvoo nndir-get-new-mail nil nil nnml-get-new-mail nnmh-get-new-mail) @@ -21508,7 +21508,7 @@ Below is a slightly shortened version of the @code{nndir} back end. (unless (assq 'nndir-directory defs) (push `(nndir-directory ,server) defs)) (push `(nndir-current-group - ,(file-name-nondirectory + ,(file-name-nondirectory (directory-file-name nndir-directory))) defs) (push `(nndir-top-directory diff --git a/man/idlwave.texi b/man/idlwave.texi index d812156cf48..6cd3cb0f1b9 100644 --- a/man/idlwave.texi +++ b/man/idlwave.texi @@ -87,9 +87,9 @@ shell. * Getting Started:: Tutorial * The IDLWAVE Major Mode:: The mode to edit IDL programs * The IDLWAVE Shell:: The mode to run IDL as an inferior program -* Installation:: How to Install or Upgrade +* Installation:: How to Install or Upgrade * Acknowledgements:: Who did what -* Sources of Routine Info:: How does IDLWAVE know about routine XYZ +* Sources of Routine Info:: How does IDLWAVE know about routine XYZ * Configuration Examples:: The user is king... * Windows and MacOS:: What still works, and how * Index:: Fast access @@ -99,9 +99,9 @@ shell. Getting Started (Tutorial) -* Lesson I -- Development Cycle:: -* Lesson II -- Customization:: -* Lesson III -- Library Catalog:: +* Lesson I -- Development Cycle:: +* Lesson II -- Customization:: +* Lesson III -- Library Catalog:: The IDLWAVE Major Mode @@ -121,7 +121,7 @@ The IDLWAVE Major Mode Code Formatting * Code Indentation:: Reflecting the logical structure -* Continued Statement Indentation:: +* Continued Statement Indentation:: * Comment Indentation:: Special indentation for comment lines * Continuation Lines:: Splitting statements over lines * Syntax Highlighting:: Font-lock support @@ -131,7 +131,7 @@ Completion * Case of Completed Words:: CaseOFcomPletedWords * Object Method Completion and Class Ambiguity:: obj->Method, what? -* Object Method Completion in the Shell:: +* Object Method Completion in the Shell:: * Class and Keyword Inheritance:: obj->Method, _EXTRA=e * Structure Tag Completion:: Completing state.Tag @@ -145,17 +145,17 @@ The IDLWAVE Shell * Starting the Shell:: How to launch IDL as a subprocess * Using the Shell:: Interactively working with the Shell -* Commands Sent to the Shell:: -* Debugging IDL Programs:: -* Examining Variables:: -* Custom Expression Examination:: +* Commands Sent to the Shell:: +* Debugging IDL Programs:: +* Examining Variables:: +* Custom Expression Examination:: Debugging IDL Programs -* Debug Key Bindings:: -* Compiling Programs:: -* Breakpoints and Stepping:: -* Walking the Calling Stack:: +* Debug Key Bindings:: +* Compiling Programs:: +* Breakpoints and Stepping:: +* Walking the Calling Stack:: Installation @@ -192,7 +192,7 @@ inferior shell@footnote{Note that this package has nothing to do with the Interface Definition Language, part of the Common Object Request Broker Architecture (CORBA)}. It can also be used for editing source files for the related WAVE/CL language, but with only limited -support. +support. IDLWAVE consists of two main parts: a major mode for editing IDL source files files (@code{idlwave-mode}) and a mode for running the IDL program @@ -201,11 +201,11 @@ be used without the other, both work together closely to form a complete development environment. Here is a brief summary of what IDLWAVE does: @itemize @bullet -@item +@item Code indentation and formatting. @item Three level syntax highlighting support. -@item +@item Context-sensitive display of calling sequences and keywords for more than 1000 native IDL routines, extendible to any number of additional routines in your local IDL libraries. @@ -367,9 +367,9 @@ at point. @cindex Getting Started @menu -* Lesson I -- Development Cycle:: -* Lesson II -- Customization:: -* Lesson III -- Library Catalog:: +* Lesson I -- Development Cycle:: +* Lesson II -- Customization:: +* Lesson III -- Library Catalog:: @end menu @node Lesson I -- Development Cycle, Lesson II -- Customization, Getting Started, Getting Started @@ -412,13 +412,13 @@ function daynr,d,m,y y1 = y * delta return, d + floor(m1*30.6)+floor(y1*365.25)+5 end - + function weekday,day,month,year ;; compute weekday number for date nr = daynr(day,month,year) return, nr mod 7 end - + pro plot_wday,day,month ;; Plot the weekday of a date in the first 10 years of this century. years = 2000,+indgen(10) @@ -649,7 +649,7 @@ keys f5-f8 to common debugging commands. @section Lesson III: Library Catalog We have already used the routine info display in the first part of this -tutorial. This was the key @kbd{C-c ?} which displays information about +tutorial. This was the key @kbd{C-c ?} which displays information about the IDL routine near the cursor position. Wouldn't it be nice to have the same available for your own library routines and for the huge amount of code in major extension libraries like JHUPL or the @@ -727,7 +727,7 @@ them. @menu * Code Indentation:: Reflecting the logical structure -* Continued Statement Indentation:: +* Continued Statement Indentation:: * Comment Indentation:: Special indentation for comment lines * Continuation Lines:: Splitting statements over lines * Syntax Highlighting:: Font-lock support @@ -769,7 +769,7 @@ governed by a number of variables. IDLWAVE indents blocks (between @code{PRO}/@code{FUNCTION}/@code{BEGIN} and @code{END}), and continuation lines. -@defopt idlwave-main-block-indent (@code{0}) +@defopt idlwave-main-block-indent (@code{0}) Extra indentation for the main block of code. That is the block between the FUNCTION/PRO statement and the END statement for that program unit. @@ -966,7 +966,7 @@ in the first line of a comment paragraph. @defopt idlwave-use-last-hang-indent (@code{nil}) Non-@code{nil} means use last match on line for -@code{idlwave-indent-regexp}. +@code{idlwave-indent-regexp}. @end defopt @node Syntax Highlighting, Octals and Highlighting, Continuation Lines, Code Formatting @@ -994,7 +994,7 @@ for highlighting using the variable @defopt idlwave-default-font-lock-items Items which should be fontified on the default fontification level -2. +2. @end defopt @node Octals and Highlighting, , Syntax Highlighting, Code Formatting @@ -1071,7 +1071,7 @@ plot,x,alog(x+5*sin(x) + 2), On positions 1,2 and 8, information about the @samp{plot} procedure will be shown. On positions 3,4, and 7, the @samp{alog} function will be described, while positions 5 and 6 will investigate the @samp{sin} -function. +function. When you ask for routine information about an object method, and the method exists in several classes, IDLWAVE queries for the class of the @@ -1127,7 +1127,7 @@ split into the next two. @item @i{Other} @tab Any other routine with a file not known to be on the search path. @item @i{Unresolved} -@tab An otherwise unkown routine the shell lists as unresolved +@tab An otherwise unkown routine the shell lists as unresolved (referenced, but not compiled). @end multitable @@ -1162,7 +1162,7 @@ with the middle mouse button inserts keywords or visits files: @item @i{Usage} @tab If online help is installed, a click with the @emph{right} mouse button on the @i{Usage:} line will access the help for the -routine (@pxref{Online Help}). +routine (@pxref{Online Help}). @item @i{Keyword} @tab Online help about keywords is also available with the @emph{right} mouse button. Clicking on a keyword with the @emph{middle} @@ -1489,7 +1489,7 @@ available. @menu * Case of Completed Words:: CaseOFcomPletedWords * Object Method Completion and Class Ambiguity:: obj->Method, what? -* Object Method Completion in the Shell:: +* Object Method Completion in the Shell:: * Class and Keyword Inheritance:: obj->Method, _EXTRA=e * Structure Tag Completion:: Completing state.Tag @end menu @@ -1554,7 +1554,7 @@ narrow down the number of possible completions. The variable @code{idlwave-query-class} can be configured to make such prompting the default for all methods (not recommended), or selectively for very common methods for which the number of completing keywords would be too -large (e.g. @code{Init}). +large (e.g. @code{Init}). @cindex Saving object class on @code{->} @cindex @code{->} @@ -1646,7 +1646,7 @@ class. Non-@code{nil} means consider inheritance during completion, online help etc. @end defopt -@defopt idlwave-keyword-class-inheritance +@defopt idlwave-keyword-class-inheritance A list of regular expressions to match methods for which simple class-driven keyword inheritance will be used for Completion. @end defopt @@ -1676,7 +1676,7 @@ Structure tag completion is not enabled by default. To enable it, simply add the following to your @file{.emacs}: @lisp - (add-hook 'idlwave-load-hook + (add-hook 'idlwave-load-hook (lambda () (require 'idlw-complete-structtag))) @end lisp @@ -2069,7 +2069,7 @@ your @file{.emacs} file: (idlwave-action-and-binding "\\<\\(pro\\|function\\)\\>[ \t]*\\<" '(capitalize-word 1) t) ;; Capitalize common block name - (idlwave-action-and-binding "\\<common\\>[ \t]+\\<" + (idlwave-action-and-binding "\\<common\\>[ \t]+\\<" '(capitalize-word 1) t))) @end lisp @@ -2231,10 +2231,10 @@ currently only works under Unix. @menu * Starting the Shell:: How to launch IDL as a subprocess * Using the Shell:: Interactively working with the Shell -* Commands Sent to the Shell:: -* Debugging IDL Programs:: -* Examining Variables:: -* Custom Expression Examination:: +* Commands Sent to the Shell:: +* Debugging IDL Programs:: +* Examining Variables:: +* Custom Expression Examination:: @end menu @node Starting the Shell, Using the Shell, The IDLWAVE Shell, The IDLWAVE Shell @@ -2260,7 +2260,7 @@ In order to create a separate frame for the IDLWAVE shell buffer, call @code{idlwave-shell} with a prefix argument: @kbd{C-u C-c C-s} or @kbd{C-u C-c C-l}. If you always want a dedicated frame for the shell window, configure the variable -@code{idlwave-shell-use-dedicated-frame}. +@code{idlwave-shell-use-dedicated-frame}. To launch a quick IDLWAVE shell directly from a shell prompt without an IDLWAVE buffer (e.g., as a replacement for running inside an xterm), @@ -2305,10 +2305,10 @@ Non-@code{nil} means preserve command history between sessions. @defopt idlwave-shell-command-history-file (@file{~/.idlwhist}) The file in which the command history of the idlwave shell is saved. @end defopt - + @defopt idlwave-shell-use-dedicated-frame (@code{nil}) Non-@code{nil} means IDLWAVE should use a special frame to display -shell buffer. +shell buffer. @end defopt @defopt idlwave-shell-frame-parameters @@ -2515,10 +2515,10 @@ buffers. @end defopt @menu -* Debug Key Bindings:: -* Compiling Programs:: -* Breakpoints and Stepping:: -* Walking the Calling Stack:: +* Debug Key Bindings:: +* Compiling Programs:: +* Breakpoints and Stepping:: +* Walking the Calling Stack:: @end menu @node Debug Key Bindings, Compiling Programs, Debugging IDL Programs, Debugging IDL Programs @@ -2575,12 +2575,12 @@ commands in the shell and source buffers. Can be one or more of @kindex C-c C-d C-c In order to compile the current buffer under the IDLWAVE shell, press @kbd{C-c C-d C-c} (@code{idlwave-save-and-run}). This first saves the -current buffer and then sends the command @samp{.run path/to/file} to the -shell. You can also execute @kbd{C-c C-d C-c} from the shell buffer, in +current buffer and then sends the command @samp{.run path/to/file} to the +shell. You can also execute @kbd{C-c C-d C-c} from the shell buffer, in which case the most recently compiled buffer will be saved and re-compiled. -When developing or debugging a program, it is often necessary to execute +When developing or debugging a program, it is often necessary to execute the same command line many times. A convenient way to do this is @kbd{C-c C-d C-y} (@code{idlwave-shell-execute-default-command-line}). This command first resets IDL from a state of interrupted execution by @@ -2792,14 +2792,14 @@ the expression printed by IDL. @end defopt @defopt idlwave-shell-output-face -The face for @code{idlwave-shell-output-overlay}. +The face for @code{idlwave-shell-output-overlay}. Allows to choose the font, color and other properties for the most recent output of IDL when examining an expression." @end defopt @defopt idlwave-shell-separate-examine-output (@code{t}) If non-@code{nil}, re-direct the output of examine commands to a special -@file{*Examine*} buffer, instead of in the shell itself. +@file{*Examine*} buffer, instead of in the shell itself. @end defopt @node Custom Expression Examination, , Examining Variables, The IDLWAVE Shell @@ -2840,17 +2840,17 @@ single string argument sharing the syntax of the @lisp (add-hook 'idlwave-shell-mode-hook (lambda () - (idlwave-shell-define-key-both [s-down-mouse-2] - (idlwave-shell-mouse-examine + (idlwave-shell-define-key-both [s-down-mouse-2] + (idlwave-shell-mouse-examine "print, size(___,/DIMENSIONS)")) (idlwave-shell-define-key-both [f9] (idlwave-shell-examine "print, size(___,/DIMENSIONS)")) - (idlwave-shell-define-key-both [f10] (idlwave-shell-examine + (idlwave-shell-define-key-both [f10] (idlwave-shell-examine "print,size(___,/TNAME)")) (idlwave-shell-define-key-both [f11] (idlwave-shell-examine "help,___,/STRUCTURE")))) -@end lisp - +@end lisp + @noindent Now pressing @key{f9}, or middle-mouse dragging with the @key{SUPER} key depressed, will print the dimensions of the nearby or highlighted expression. Pressing @key{f10} will give the type string, @@ -2941,7 +2941,7 @@ to get a separate frame for the IDL shell, remove that command from your @lisp (setq idlwave-shell-use-dedicated-frame t) @end lisp -@item +@item The key sequence @kbd{M-@key{TAB}} no longer inserts a TAB character. Like in many other Emacs modes, @kbd{M-@key{TAB}} now does completion. Inserting a TAB has therefore been moved to @@ -2973,7 +2973,7 @@ of the package from version 3.0, during which time he overhauled almost everything, modernized IDLWAVE with many new features, and developed the manual. -@item +@item @uref{mailto:jdsmith@@as.arizona.edu, @b{J.D. Smith}}, the current maintainer, as of version 4.10, helped shape object method completion and most new features introduced in versions 4.x. @@ -3051,14 +3051,14 @@ know about the accessible routines. several places: @enumerate -@item +@item @emph{Builtin routines} are defined inside IDL itself. The source code of such routines is not available. @item Routines which are @emph{part of the current program}, are defined in a file explicitly compiled by the user. This file may or may not be located on the IDL search path. -@item +@item @emph{Library routines} are defined in files located on IDL's search path, and will not need to be manually compiled. When a library routine is called for the first time, IDL will find the source file and compile @@ -3095,7 +3095,7 @@ by scanning the IDL manuals and is stored in the file @file{idlw-rinfo.el}. @xref{Documentation Scan}, for information on how to regenerate this file for new versions of IDL. -@item +@item It @emph{scans} all @emph{buffers} of the current Emacs session for routine definitions. This is done automatically when routine information or completion is first requested by the user. Each new @@ -3182,7 +3182,7 @@ or all directories on the search path. If you only want to have routine and completion info of some libraries, it is sufficient to scan those directories. However, if you want IDLWAVE to detect possible name conflicts with routines defined in other libraries, the whole pass -should be scanned. +should be scanned. After selecting directories, click on the @w{@samp{[Scan & Save]}} button in the widget to scan all files in the selected directories and @@ -3279,7 +3279,7 @@ Another way to find out if a specific routine has multiple definitions on the load path is routine info display (@pxref{Routine Info}). @node Documentation Scan, , Load-Path Shadows, Sources of Routine Info -@appendixsec Documentation Scan +@appendixsec Documentation Scan @cindex @file{get_rinfo} @cindex @file{idlw-rinfo.el} @cindex @file{idlw-help.txt} @@ -3370,7 +3370,7 @@ user is King! (setq idlwave-main-block-indent 3) (setq idlwave-end-offset -3) (setq idlwave-continuation-indent 1) -(setq idlwave-begin-line-comment "^;[^;]") ; Leave ";" but not ";;" +(setq idlwave-begin-line-comment "^;[^;]") ; Leave ";" but not ";;" ; anchored at start of line. (setq idlwave-surround-by-blank t) ; Turn on padding ops =,<,> (setq idlwave-pad-keyword nil) ; Remove spaces for keyword '=' @@ -3424,10 +3424,10 @@ user is King! ;; (local-set-key "\C-j" 'idlwave-newline) ; My preference. ;; Some personal abbreviations - (define-abbrev idlwave-mode-abbrev-table + (define-abbrev idlwave-mode-abbrev-table (concat idlwave-abbrev-start-char "wb") "widget_base()" (idlwave-keyword-abbrev 1)) - (define-abbrev idlwave-mode-abbrev-table + (define-abbrev idlwave-mode-abbrev-table (concat idlwave-abbrev-start-char "on") "obj_new()" (idlwave-keyword-abbrev 1)) )) @@ -3445,12 +3445,12 @@ user is King! (add-hook 'idlwave-shell-mode-hook (lambda () ;; Set up some custom key and mouse examine commands - (idlwave-shell-define-key-both [s-down-mouse-2] - (idlwave-shell-mouse-examine + (idlwave-shell-define-key-both [s-down-mouse-2] + (idlwave-shell-mouse-examine "print, size(___,/DIMENSIONS)")) (idlwave-shell-define-key-both [f9] (idlwave-shell-examine "print, size(___,/DIMENSIONS)")) - (idlwave-shell-define-key-both [f10] (idlwave-shell-examine + (idlwave-shell-define-key-both [f10] (idlwave-shell-examine "print,size(___,/TNAME)")) (idlwave-shell-define-key-both [f11] (idlwave-shell-examine "help,___,/STRUCTURE")))) @@ -3487,7 +3487,7 @@ system. I am assuming that IDLWAVE has been installed in @w{@samp{C:\RSI\IDL55}}. @lisp -;; location of the lisp files (needed if IDLWAVE is not part of +;; location of the lisp files (needed if IDLWAVE is not part of ;; the X/Emacs installation) (setq load-path (cons "c:/program files/IDLWAVE" load-path)) @@ -3510,7 +3510,7 @@ system. I am assuming that IDLWAVE has been installed in sure you check the following things: @itemize @bullet -@item When you download the IDLWAVE distribution, make sure you save the +@item When you download the IDLWAVE distribution, make sure you save the files under the names @file{idlwave.tar.gz} and @file{idlwave-help-tar.gz}. @item Be sure that your software for untarring/ungzipping is @emph{NOT} diff --git a/man/indent.texi b/man/indent.texi index 1a7310f8c80..3fb3718f85f 100644 --- a/man/indent.texi +++ b/man/indent.texi @@ -151,7 +151,7 @@ indentation for part of your text. @node Tab Stops, Just Spaces, Indentation Commands, Indentation @section Tab Stops -@cindex tab stops +@cindex tab stops @cindex using tab stops in making tables @cindex tables, indentation for @kindex M-i diff --git a/man/killing.texi b/man/killing.texi index f66fc6a20ad..4118a4c56f5 100644 --- a/man/killing.texi +++ b/man/killing.texi @@ -80,7 +80,7 @@ mode (@pxref{Transient Mark}). blank areas. * Killing by Lines:: How to kill entire lines of text at one time. * Other Kill Commands:: Commands to kill large regions of text and - syntactic units such as words and sentences. + syntactic units such as words and sentences. @end menu @need 1500 @@ -550,7 +550,7 @@ a line. @table @kbd @item C-x r k -Kill the text of the region-rectangle, saving its contents as the +Kill the text of the region-rectangle, saving its contents as the ``last killed rectangle'' (@code{kill-rectangle}). @item C-x r d Delete the text of the region-rectangle (@code{delete-rectangle}). @@ -641,6 +641,6 @@ if the string is wider than the rectangle, the text after the rectangle shifts right. @findex string-insert-rectangle - The command @kbd{M-x string-insert-rectangle} is similar to -@code{string-rectangle}, but inserts the string on each line, + The command @kbd{M-x string-insert-rectangle} is similar to +@code{string-rectangle}, but inserts the string on each line, shifting the original text to the right. diff --git a/man/macos.texi b/man/macos.texi index 6a7b291e7fa..7a266697781 100644 --- a/man/macos.texi +++ b/man/macos.texi @@ -173,7 +173,7 @@ EMACS_UNIBYTE=1 @section Volumes and Directories on the Mac @cindex file names (Mac OS) - The directory structure in the Mac OS is seen by Emacs as + The directory structure in the Mac OS is seen by Emacs as @example /@var{volumename}/@var{filename} diff --git a/man/maintaining.texi b/man/maintaining.texi index 1889ec2e725..9683ffa62d8 100644 --- a/man/maintaining.texi +++ b/man/maintaining.texi @@ -480,7 +480,7 @@ knows, and the file name rules for guessing the language. It also prints a list of all the available @code{etags} options, together with a short explanation. If followed by one or more @samp{--language=@var{lang}} options, prints detailed information about how tags are generated for -@var{lang}. +@var{lang}. @node Etags Regexps @subsection Etags Regexps diff --git a/man/mark.texi b/man/mark.texi index 09a567ea4c4..ec91e66fb21 100644 --- a/man/mark.texi +++ b/man/mark.texi @@ -162,7 +162,7 @@ This makes the mark active and thus begins highlighting of the region. As you move point, you will see the highlighted region grow and shrink. -@item +@item The mouse commands for specifying the mark also make it active. So do keyboard commands whose purpose is to specify a region, including @kbd{M-@@}, @kbd{C-M-@@}, @kbd{M-h}, @kbd{C-M-h}, @kbd{C-x C-p}, and diff --git a/man/message.texi b/man/message.texi index a4b046f8400..d26ae9a5e33 100644 --- a/man/message.texi +++ b/man/message.texi @@ -1092,8 +1092,8 @@ posting a prepared news message. Symbol naming a @sc{mime} charset. Non-ASCII characters in messages are assumed to be encoded using this charset. The default is @code{nil}, which means ask the user. (This variable is used only on non-@sc{mule} -Emacsen. -@xref{Charset Translation, , Charset Translation, emacs-mime, +Emacsen. +@xref{Charset Translation, , Charset Translation, emacs-mime, Emacs MIME Manual}, for details on the @sc{mule}-to-@sc{mime} translation process. diff --git a/man/mh-e.texi b/man/mh-e.texi index eb8ba5b8b0a..406506d36a0 100644 --- a/man/mh-e.texi +++ b/man/mh-e.texi @@ -1,5 +1,5 @@ \input texinfo @c -*-texinfo-*- -@c $Id: mh-e.texi,v 1.12 2001/09/12 20:59:49 rms Exp $ +@c $Id: mh-e.texi,v 1.13 2002/10/02 23:24:31 karl Exp $ @c %**start of header @setfilename ../info/mh-e @settitle mh-e @@ -78,9 +78,9 @@ MH}, last updated @value{UPDATED} for mh-e Version @value{VERSION}. list and FAQ. * History:: The authors speak up! * Copying:: The GNU General Public License -* Command Index:: -* Variable Index:: -* Concept Index:: +* Command Index:: +* Variable Index:: +* Concept Index:: @end menu @end ifnottex @@ -154,12 +154,12 @@ the other two as you wish. @menu * Conventions:: GNU Emacs Terms and Conventions -* Getting Started:: -* Sending Mail Tour:: -* Reading Mail Tour:: -* Processing Mail Tour:: -* Leaving mh-e:: -* More About mh-e:: +* Getting Started:: +* Sending Mail Tour:: +* Reading Mail Tour:: +* Processing Mail Tour:: +* Leaving mh-e:: +* More About mh-e:: @end menu @node Conventions, Getting Started, Tour Through mh-e, Tour Through mh-e @@ -626,13 +626,13 @@ conventions are strange to you. Let's get started! @menu -* Reading Mail:: -* Sending Mail:: -* Draft Editing:: -* Moving Mail:: -* Searching:: -* Sequences:: -* Miscellaneous:: +* Reading Mail:: +* Sending Mail:: +* Draft Editing:: +* Moving Mail:: +* Searching:: +* Sequences:: +* Miscellaneous:: @end menu @node Reading Mail, Sending Mail, Using mh-e, Using mh-e @@ -700,8 +700,8 @@ Toggle between MH-Folder and MH-Folder Show modes (@code{mh-toggle-showing}). @end table @menu -* Viewing:: -* Moving Around:: +* Viewing:: +* Moving Around:: @end menu @node Viewing, Moving Around, Reading Mail, Reading Mail @@ -724,8 +724,8 @@ to see all of them, use the @kbd{,} (comma; @code{mh-header-display}) command. @menu -* Reading Digests:: -* Reading MIME:: +* Reading Digests:: +* Reading MIME:: @end menu @node Reading Digests, Reading MIME, Viewing, Viewing @@ -896,10 +896,10 @@ buffer on top and the draft on the bottom. If you would rather preserve the window layout, use @kbd{M-x mh-smail-other-window}. @menu -* Replying:: -* Forwarding:: -* Redistributing:: -* Old Drafts:: +* Replying:: +* Forwarding:: +* Redistributing:: +* Old Drafts:: @end menu @node Replying, Forwarding, Sending Mail, Sending Mail @@ -1096,10 +1096,10 @@ Quit editing and delete draft message (@code{mh-fully-kill-draft}). @end table @menu -* Editing Textual:: -* Editing MIME:: -* Sending Message:: -* Killing Draft:: +* Editing Textual:: +* Editing MIME:: +* Sending Message:: +* Killing Draft:: @end menu @node Editing Textual, Editing MIME, Draft Editing, Draft Editing @@ -1110,11 +1110,11 @@ The commands described here are also applicable to messages that have multimedia components. @menu -* Inserting Letter:: -* Inserting Messages:: -* Header:: -* Recipients:: -* Signature:: +* Inserting Letter:: +* Inserting Messages:: +* Header:: +* Recipients:: +* Signature:: @end menu @node Inserting Letter, Inserting Messages, Editing Textual, Editing Textual @@ -1242,7 +1242,7 @@ the content types that mh-e currently knows about. Several of the mh-e commands fill in the content type for you, whereas others require you to enter one. Most of the time, it should be obvious which one to use (e.g., use @kbd{image/jpeg} to include a @sc{jpeg} image). If not, you -can refer to @sc{rfc} 1521, +can refer to @sc{rfc} 1521, @c Footnotes are very fragile. Hence the duplication. @c The line break in the footnote was necessary since TeX wasn't creating one. @ifclear html @@ -1269,11 +1269,11 @@ multimedia fields unless the content description is compelling. Remember: you can always add @code{mhn} directives by hand. @menu -* Forwarding MIME:: -* FTP:: -* Tar:: -* Other MIME Objects:: -* Sending MIME:: +* Forwarding MIME:: +* FTP:: +* Tar:: +* Other MIME Objects:: +* Sending MIME:: @end menu @node Forwarding MIME, FTP, Editing MIME, Editing MIME @@ -1518,12 +1518,12 @@ Quit (@code{mh-quit}). @end table @menu -* Incorporating:: -* Deleting:: -* Organizing:: -* Printing:: -* Files and Pipes:: -* Finishing Up:: +* Incorporating:: +* Deleting:: +* Organizing:: +* Printing:: +* Files and Pipes:: +* Finishing Up:: @end menu @node Incorporating, Deleting, Moving Mail, Moving Mail @@ -1958,7 +1958,7 @@ always be included with any bug report you submit (@pxref{Bug Reports}). @chapter Customizing mh-e Until now, we've talked about the mh-e commands as they work ``out of the -box.'' Of course, it is also possible to reconfigure mh-e +box.'' Of course, it is also possible to reconfigure mh-e to fit the needs of even the most demanding user. The following sections describe all of the customization variables, show the defaults, and make recommendations for @@ -2067,11 +2067,11 @@ avoid conflicts with existing mh-e symbols, use a prefix like @code{my-} or your initials. @menu -* Customizing Reading:: -* Customizing Sending:: -* Customizing Draft Editing:: -* Customizing Moving Mail:: -* Customizing Searching:: +* Customizing Reading:: +* Customizing Sending:: +* Customizing Draft Editing:: +* Customizing Moving Mail:: +* Customizing Searching:: @end menu @node Customizing Reading, Customizing Sending, Customizing mh-e, Customizing mh-e @@ -2279,8 +2279,8 @@ key bindings, for example: @end lisp @menu -* Customizing Viewing:: -* Customizing Moving Around:: +* Customizing Viewing:: +* Customizing Moving Around:: @end menu @node Customizing Viewing, Customizing Moving Around, Customizing Reading, Customizing Reading @@ -2526,10 +2526,10 @@ This function is passed three arguments: the contents of the @samp{To:}, @samp{Subject:}, and @samp{cc:} header fields. @menu -* Customizing Replying:: -* Customizing Forwarding:: -* Customizing Redistributing:: -* Customizing Old Drafts:: +* Customizing Replying:: +* Customizing Forwarding:: +* Customizing Redistributing:: +* Customizing Old Drafts:: @end menu @node Customizing Replying, Customizing Forwarding, Customizing Sending, Customizing Sending @@ -2665,9 +2665,9 @@ MH program used to send messages (default: @samp{"send"}). @end table @menu -* Customizing Editing Textual:: -* Customizing Editing MIME:: -* Customizing Sending Message:: +* Customizing Editing Textual:: +* Customizing Editing MIME:: +* Customizing Sending Message:: @end menu @node Customizing Editing Textual, Customizing Editing MIME, Customizing Draft Editing, Customizing Draft Editing @@ -2678,8 +2678,8 @@ edit a draft. The discussion here applies to editing multimedia messages as well. @menu -* Customizing Inserting Letter:: -* Customizing Signature:: +* Customizing Inserting Letter:: +* Customizing Signature:: @end menu @node Customizing Inserting Letter, Customizing Signature, Customizing Editing Textual, Customizing Editing Textual @@ -2711,7 +2711,7 @@ default, which means that when a message is inserted into the letter, each line is prefixed by @code{mh-ins-buf-prefix}. Otherwise, it can be set to a function that modifies an included @cindex Emacs, packages, supercite -citation. +citation. @c Footnotes are fragile; hence the redundancy. @c TeX not inserting a line break; hence the @* @ifclear html @@ -2805,7 +2805,7 @@ like: @samp{You should be <bold>very</bold>}. You may also be interested in investigating @code{sgml-mode}. @menu -* Customizing Sending MIME:: +* Customizing Sending MIME:: @end menu @node Customizing Sending MIME, , Customizing Editing MIME, Customizing Editing MIME @@ -2896,7 +2896,7 @@ Program to scan messages (default: @samp{"scan"}). @item mh-before-quit-hook Functions to run before quitting (default: @code{nil}). See also -@code{mh-quit-hook}. +@code{mh-quit-hook}. @item mh-quit-hook Functions to run after quitting (default: @code{nil}). See also @@ -2904,12 +2904,12 @@ Functions to run after quitting (default: @code{nil}). See also @end table @menu -* Customizing Incorporating:: -* Customizing Deleting:: -* Customizing Organizing:: -* Customizing Printing:: -* Customizing Files and Pipes:: -* Customizing Finishing Up:: +* Customizing Incorporating:: +* Customizing Deleting:: +* Customizing Organizing:: +* Customizing Printing:: +* Customizing Files and Pipes:: +* Customizing Finishing Up:: @end menu @node Customizing Incorporating, Customizing Deleting, Customizing Moving Mail, Customizing Moving Mail @@ -3076,7 +3076,7 @@ override any arguments given in a @code{sortm:} entry in your MH profile (@file{~/.mh_profile}). @menu -* Customizing Scan Line Formats:: +* Customizing Scan Line Formats:: @end menu @node Customizing Scan Line Formats, , Customizing Organizing, Customizing Organizing @@ -3280,7 +3280,7 @@ mh-e context, so you might use it to modify the window setup. If you find that you do the same thing over and over when editing the search template, you may wish to bind some shortcuts to keys. This can be done with the variable @code{mh-pick-mode-hook}, which is called when -@kbd{M-s} (@code{mh-search-folder}) is run on a new pattern. +@kbd{M-s} (@code{mh-search-folder}) is run on a new pattern. The string @code{mh-partial-folder-mode-line-annotation} is used to annotate the @@ -3302,10 +3302,10 @@ you how to report bugs and how to get on the mh-e mailing list. I also point out some additional sources of information. @menu -* Bug Reports:: -* Mailing List:: -* MH FAQ:: -* Getting mh-e:: +* Bug Reports:: +* Mailing List:: +* MH FAQ:: +* Getting mh-e:: @end menu @node Bug Reports, Mailing List, Odds and Ends, Odds and Ends @@ -3413,9 +3413,9 @@ Bill Wohler then took over in 2000 and moved its development to @uref{http://sourceforge.net/, SourceForge}. @menu -* From Brian Reid:: -* From Jim Larus:: -* From Stephen Gildea:: +* From Brian Reid:: +* From Jim Larus:: +* From Stephen Gildea:: @end menu @node From Brian Reid, From Jim Larus, History, History @@ -3899,7 +3899,7 @@ when it starts in an interactive mode: Gnomovision version 69, Copyright (C) 20@var{yy} @var{name of author} Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. This is free software, and you are welcome -to redistribute it under certain conditions; type `show c' +to redistribute it under certain conditions; type `show c' for details. @end smallexample @@ -3917,7 +3917,7 @@ necessary. Here is a sample; alter the names: @group Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' -(which makes passes at compilers) written +(which makes passes at compilers) written by James Hacker. @var{signature of Ty Coon}, 1 April 1989 diff --git a/man/misc.texi b/man/misc.texi index 8f9ba69a06b..9ee73fcf007 100644 --- a/man/misc.texi +++ b/man/misc.texi @@ -47,7 +47,7 @@ To start Gnus, type @kbd{M-x gnus @key{RET}}. As opposed to most normal Emacs packages, Gnus uses a number of different buffers to display information and to receive commands. The three buffers users spend most of their time in are the @dfn{group -buffer}, the @dfn{summary buffer} and the @dfn{article buffer}. +buffer}, the @dfn{summary buffer} and the @dfn{article buffer}. The @dfn{group buffer} contains a list of groups. This is the first buffer Gnus displays when it starts up. It normally displays only the @@ -161,7 +161,7 @@ In the group buffer, select the group on the line under the cursor and display the first unread article in that group. @need 1000 -In the summary buffer, +In the summary buffer, @itemize @bullet @item @@ -291,7 +291,7 @@ Save articles. @xref{Saving Articles, , , gnus, The Gnus Manual}. @item Have Gnus score articles according to various criteria, like author name, subject, or string in the body of the articles.@* -@xref{Scoring, , , gnus, The Gnus Manual}. +@xref{Scoring, , , gnus, The Gnus Manual}. @item Send an article to a newsgroup.@* diff --git a/man/msdog.texi b/man/msdog.texi index 5273b28f7d6..6be4f703f79 100644 --- a/man/msdog.texi +++ b/man/msdog.texi @@ -1,9 +1,9 @@ @c This is part of the Emacs manual. -@c Copyright (C) 1985,86,87,93,94,95,1997,2000,2001 +@c Copyright (C) 1985,86,87,93,94,95,1997,2000,2001 @c Free Software Foundation, Inc. @c See file emacs.texi for copying conditions. @node MS-DOS, Manifesto, Mac OS, Top -@appendix Emacs and MS-DOS +@appendix Emacs and MS-DOS @cindex MS-DOG @cindex MS-DOS peculiarities @@ -837,7 +837,7 @@ key invokes the Windows menu. The reason is that the @key{ALT} also serves as @key{META} in Emacs. When using Emacs, users often press the @key{META} key temporarily and then change their minds; if this has the effect of bringing up the Windows menu, it alters the meaning of -subsequent commands. Many users find this frustrating. +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 diff --git a/man/mule.texi b/man/mule.texi index 6c401417703..ccba75e9327 100644 --- a/man/mule.texi +++ b/man/mule.texi @@ -477,7 +477,7 @@ Display a list of all the supported input methods. input method name from the minibuffer; the name normally starts with the language environment that it is meant to be used with. The variable @code{current-input-method} records which input method is selected. - + @findex toggle-input-method @kindex C-\ Input methods use various sequences of ASCII characters to stand for diff --git a/man/pcl-cvs.texi b/man/pcl-cvs.texi index c6457237842..04952efd3cb 100644 --- a/man/pcl-cvs.texi +++ b/man/pcl-cvs.texi @@ -1,5 +1,5 @@ \input texinfo @c -*-texinfo-*- -@c "@(#)$Name: $:$Id: pcl-cvs.texi,v 1.17 2002/10/02 23:24:31 karl Exp $" +@c "@(#)$Name: $:$Id: pcl-cvs.texi,v 1.18 2002/12/07 13:38:26 pj Exp $" @c %**start of header @setfilename ../info/pcl-cvs @settitle PCL-CVS --- Emacs Front-End to CVS @@ -101,18 +101,18 @@ of the various commands and major modes for further information. About PCL-CVS * Contributors:: Contributors to PCL-CVS. -* Installation:: +* Installation:: Commands * Entering PCL-CVS:: Commands to invoke PCL-CVS * Setting flags:: Setting flags for CVS commands -* Updating the buffer:: +* Updating the buffer:: * Movement commands:: How to move up and down in the buffer * Marking files:: How to mark files that other commands will later operate on. * Committing changes:: Checking in your modifications to the - CVS repository. + CVS repository. * Editing files:: Loading files into Emacs. * Getting info about files:: Display the log and status of files. * Adding and removing files:: Adding and removing files @@ -127,7 +127,7 @@ Commands Customization -* Customizing Faces:: +* Customizing Faces:: @end detailmenu @end menu @@ -157,7 +157,7 @@ As of Emacs 21, PCL-CVS is part of the standard Emacs distribution. @menu * Contributors:: Contributors to PCL-CVS. -* Installation:: +* Installation:: @end menu @node Contributors, Installation, About PCL-CVS, About PCL-CVS @@ -250,7 +250,7 @@ If you are running XEmacs 21.0 or later, PCL-CVS is available in pre-compiled package form. Please refer to the XEmacs manual for instructions regarding package selection and installation. Currently, that PCL-CVS package also requires you to have installed the -@file{xemacs-base}, @file{elib}, and @file{dired} packages. +@file{xemacs-base}, @file{elib}, and @file{dired} packages. If you have @TeX{} installed at your site, you can make a typeset manual from @file{pcl-cvs.texi}. @@ -318,7 +318,7 @@ In directory sub: In this example, your repository is in @file{/usr/CVSroot} and CVS has been run in the directory @file{/users/ceder/FOO/test}. The three files -(@file{bar}, @file{file.txt} and +(@file{bar}, @file{file.txt} and @file{newer}) that are marked with @samp{Need-Update} have been changed by someone else in the CVS repository. Two files (@file{namechange} and @file{sub/ChangeLog}) have been modified locally, and need to be @@ -523,12 +523,12 @@ you can use in PCL-CVS. They are grouped together by type. @menu * Entering PCL-CVS:: Commands to invoke PCL-CVS * Setting flags:: Setting flags for CVS commands -* Updating the buffer:: +* Updating the buffer:: * Movement commands:: How to move up and down in the buffer * Marking files:: How to mark files that other commands will later operate on. * Committing changes:: Checking in your modifications to the - CVS repository. + CVS repository. * Editing files:: Loading files into Emacs. * Getting info about files:: Display the log and status of files. * Adding and removing files:: Adding and removing files @@ -554,13 +554,13 @@ you can use in PCL-CVS. They are grouped together by type. Most commands in PCL-CVS require that you have a @samp{*cvs*} buffer. The commands that you use to get one are listed below. -For each, a @samp{cvs} process will be run, the output will be parsed by +For each, a @samp{cvs} process will be run, the output will be parsed by PCL-CVS, and the result will be printed in the @samp{*cvs*} buffer (see @ref{Buffer contents}, for a description of the buffer's contents). @table @kbd @item M-x cvs-update -Run a @samp{cvs update} command. You will be asked for the directory +Run a @samp{cvs update} command. You will be asked for the directory in which the @samp{cvs update} will be run. @item M-x cvs-examine @@ -570,7 +570,7 @@ not change anything. You will be asked for the directory in which the @samp{cvs -n update} will be run. @item M-x cvs-status -Run a @samp{cvs status} command. You will be asked for the directory +Run a @samp{cvs status} command. You will be asked for the directory in which the @samp{cvs status} will be run. @item M-x cvs-checkout @@ -1307,7 +1307,7 @@ newline in the commit message buffer. @findex cvs-mode-changelog-commit @item log-edit-changelog-full-paragraphs If this variable is non-@code{nil}, include full @file{ChangeLog} -paragraphs in the CVS log created by @samp{cvs-mode-changelog-commit}. +paragraphs in the CVS log created by @samp{cvs-mode-changelog-commit}. This may be set in the local variables section of a @file{ChangeLog} file, to indicate the policy for that @file{ChangeLog}. @@ -1338,7 +1338,7 @@ default. @menu -* Customizing Faces:: +* Customizing Faces:: @end menu @node Customizing Faces, , Customization, Customization @@ -1365,7 +1365,7 @@ used to highlight file names. used to highlight the status of files which are @samp{Unknown}. @item cvs-handled-face -used to highlight the status of files which are handled and +used to highlight the status of files which are handled and need no further action. @item cvs-need-action-face diff --git a/man/programs.texi b/man/programs.texi index ab557d4522d..1e15aa985c8 100644 --- a/man/programs.texi +++ b/man/programs.texi @@ -1400,7 +1400,7 @@ display, so you can use it even on read-only buffers. You can use the command @kbd{M-x glasses-mode} to enable or disable the mode in the current buffer; you can also add @code{glasses-mode} to the mode hook of the programming language major modes in which you normally want -to use Glasses mode. +to use Glasses mode. @node Misc for Programs @section Other Features Useful for Editing Programs diff --git a/man/reftex.texi b/man/reftex.texi index 9d388d66b60..449efce9ce5 100644 --- a/man/reftex.texi +++ b/man/reftex.texi @@ -116,7 +116,7 @@ Introduction * Installation:: How to install and activate RefTeX. * RefTeX in a Nutshell:: A brief summary and quick guide. - + Labels and References * Creating Labels:: @@ -287,7 +287,7 @@ additional labeled environments you have defined yourself (variable @itemize @bullet @item -@b{Creating Labels}@* +@b{Creating Labels}@* Type @kbd{C-c (} (@code{reftex-label}) to insert a label at point. @b{Ref@TeX{}} will either @itemize @minus @@ -295,7 +295,7 @@ Type @kbd{C-c (} (@code{reftex-label}) to insert a label at point. derive a label from context (default for section labels) @item prompt for a label string (default for figures and tables) or -@item +@item insert a simple label made of a prefix and a number (all other environments)@refill @end itemize @@ -415,7 +415,7 @@ can do in each of the different special buffers, press @kbd{?}. Read the manual if you get stuck, of if you are curious what else might be available. The first part of the manual explains in a tutorial way how to use and customize @b{Ref@TeX{}}. The second -part is a command and variable reference.@refill +part is a command and variable reference.@refill @end enumerate @node Table of Contents, Labels and References, Introduction, Top @@ -514,7 +514,7 @@ Kill the @file{*toc*} buffer, return to the position where @item C-c > Switch to the @file{*Index*} buffer of this document. With prefix -@samp{2}, restrict the index to the section at point in the @file{*toc*} +@samp{2}, restrict the index to the section at point in the @file{*toc*} buffer. @tablesubheading{Controlling what gets displayed} @@ -550,7 +550,7 @@ Toggle the display of index entries in the @file{*toc*} buffer. The default for this flag can be set with the variable @code{reftex-toc-include-index-entries}. When called with a prefix argument, @b{Ref@TeX{}} will prompt for a specific index and include -only entries in the selected index in the @file{*toc*} buffer. The mode +only entries in the selected index in the @file{*toc*} buffer. The mode line @samp{I<>} indicator shows which index is used.@refill @item c @@ -799,7 +799,7 @@ Goto next section heading. Goto previous section heading. @item N z -Jump to section N, using the prefix arg. For example @kbd{3 z} jumps to +Jump to section N, using the prefix arg. For example @kbd{3 z} jumps to section 3.@refill @tablesubheading{Displaying Context} @@ -893,7 +893,7 @@ buffer.@refill @tablesubheading{Controlling what gets displayed} @vindex reftex-label-menu-flags -The defaults for the following flags can be configured with the variable +The defaults for the following flags can be configured with the variable @code{reftex-label-menu-flags} (@pxref{Options (Referencing Labels)}). @item c @@ -906,7 +906,7 @@ selection buffer.@refill @item t Toggle the display of the table of contents in the selection buffer. -With prefix @var{arg}, change the maximum level of toc entries displayed +With prefix @var{arg}, change the maximum level of toc entries displayed to @var{arg}. Chapters are level 1, section are level 2.@refill @item # @@ -1320,7 +1320,7 @@ Again, here the configuration in the customization buffer: @example [INS] [DEL] Package or Detailed : [Value Menu] Detailed: Environment or \macro : [Value Menu] String: \myfig[]@{@}@{@}@{*@}@{@} - Type specification : [Value Menu] Char : f + Type specification : [Value Menu] Char : f Label prefix string : [Value Menu] Default Label reference format: [Value Menu] Default Context method : [Value Menu] Macro arg nr: 3 @@ -1417,7 +1417,7 @@ Here is the setup:@refill (defun detect-be-ee (bound) ;; Search backward for the macros or an empty line - (if (re-search-backward + (if (re-search-backward "\\(^[ \t]*\n\\|\\\\ee\\>\\)\\|\\(\\\\be\\>\\)" bound t) (if (match-beginning 2) (match-beginning 2) ; Return start of environment @@ -1456,14 +1456,14 @@ for @b{Ref@TeX{}}. (defun detect-linguex (bound) (let ((cnt 0)) (catch 'exit - (while + (while ;; Search backward for all possible delimiters (re-search-backward (concat "\\(^[ \t]*\n\\)\\|\\(\\\\z\\.\\)\\|" "\\(\\ex[ig]?\\.\\)\\|\\(\\\\a\\.\\)") nil t) ;; Check which delimiter was matched. - (cond + (cond ((match-beginning 1) ;; empty line terminates all - return nil (throw 'exit nil)) @@ -1784,7 +1784,7 @@ SELECT A CITATION FORMAT Following the most generic of these packages, @code{natbib}, the builtin citation packages always accept the @kbd{t} key for a @emph{textual} -citation (like: @code{Jones et al. (1997) have shown...}) as well as +citation (like: @code{Jones et al. (1997) have shown...}) as well as the @kbd{p} key for a parenthetical citation (like: @code{As shown earlier (Jones et al, 1997)}).@refill @@ -2015,13 +2015,13 @@ repeat @var{word} outside the macro.@refill Phrases for indexing can be collected while writing the document. The command @kbd{C-c \} (@code{reftex-index-phrase-selection-or-word}) -copies the current selection (if active) or the word near point into the +copies the current selection (if active) or the word near point into the phrases buffer. It then selects this buffer, so that the phrase line can be edited. To return to the LaTeX document, press @kbd{C-c C-c} (@code{reftex-index-phrases-save-and-return}). You can also prepare the list of index phrases in a different way and -copy it into the phrases file. For example you might want to start from +copy it into the phrases file. For example you might want to start from a word list of the document and remove all words which should not be indexed. @@ -2030,7 +2030,7 @@ The phrase lines in the phrase buffer must have a specific format. format. A phrase line looks like this: @example -[@var{key}] <TABs> @var{phrase} [<TABs> @var{arg}[&&@var{arg}]... [ || @var{arg}]...] +[@var{key}] <TABs> @var{phrase} [<TABs> @var{arg}[&&@var{arg}]... [ || @var{arg}]...] @end example @code{<TABs>} stands for white space containing at least one @key{TAB}. @@ -2124,7 +2124,7 @@ may not last long enough to do everything in one go.@refill @b{Ref@TeX{}} will start at the first phrase line and search the phrase globally in the whole document. At each match it will stop, compute the replacement string and offer you the following choices@footnote{Windows -users: Restrict yourself to the described keys during indexing. Pressing +users: Restrict yourself to the described keys during indexing. Pressing @key{Help} at the indexing prompt can apparently hang Emacs.}:@refill @table @kbd @@ -2238,7 +2238,7 @@ Prefix argument. @tablesubheading{Moving around} @item ! A..Z Pressing any capital letter will jump to the corresponding section in -the @file{*Index*} buffer. The exclamation mark is special and jumps to +the @file{*Index*} buffer. The exclamation mark is special and jumps to the first entries alphabetically sorted below @samp{A}. These are usually non-alphanumeric characters.@refill @item n @@ -2248,7 +2248,7 @@ Go to previous entry.@refill @tablesubheading{Access to document locations} @item @key{SPC} -Show the place in the document where this index entry is defined.@refill +Show the place in the document where this index entry is defined.@refill @item @key{TAB} Go to the definition of the current index entry in another @@ -2299,19 +2299,19 @@ prefix, kill the entire @var{visual} part.@refill @item ( Toggle the beginning of page range property @samp{|(} of the -entry.@refill +entry.@refill @item ) -Toggle the end of page range property @samp{|)} of the entry.@refill +Toggle the end of page range property @samp{|)} of the entry.@refill @item _ Make the current entry a subentry. This command will prompt for the superordinate entry and insert it.@refill @item ^ -Remove the highest superordinate entry. If the current entry is a +Remove the highest superordinate entry. If the current entry is a subitem (@samp{aaa!bbb!ccc}), this function moves it up the hierarchy -(@samp{bbb!ccc}).@refill +(@samp{bbb!ccc}).@refill @tablesubheading{Exiting} @item q @@ -2364,7 +2364,7 @@ buffer.@refill @item s Switch to a different index (for documents with multiple -indices).@refill +indices).@refill @end table @@ -2427,7 +2427,7 @@ quick identification of these macros when @b{Ref@TeX{}} inserts new index entries with @code{reftex-index}. These codes need to be unique. @code{?i}, @code{?I}, and @code{?g} are reserved for the @code{\index}, @code{\index*}, and @code{\glossary} macros, -respectively. +respectively. The following string is empty unless your macro adds a superordinate entry to the index key - this is the case for the @code{\astobj} macro. @@ -2450,14 +2450,14 @@ Repeat: Macro with args: \ix@{*@} Index Tag : [Value Menu] String: idx Access Key : x - Key Prefix : + Key Prefix : Exclusion hook : nil Repeat Outside : [Toggle] off (nil) [INS] [DEL] List: Macro with args: \nindex@{*@} Index Tag : [Value Menu] String: name Access Key : n - Key Prefix : + Key Prefix : Exclusion hook : nil Repeat Outside : [Toggle] off (nil) [INS] [DEL] List: @@ -2558,7 +2558,7 @@ and @code{\glossary} macros, all macros configured in While the display of cross referencing information for the above mentioned macros is hard--coded, you can configure additional relations in the variable @code{reftex-view-crossref-extra}. - + @iftex @chapter All the Rest @end iftex @@ -2748,7 +2748,7 @@ see @ref{Adding Magic Words}. @vindex reftex-multiref-punctuation @vindex reftex-cite-punctuation -@item +@item @b{Ref@TeX{}} inserts ``punctuation'' for multiple references and for the author list in citations. Some of this may be language dependent. See the variables @code{reftex-multiref-punctuation} and @@ -2802,7 +2802,7 @@ variables and configure @b{Ref@TeX{}} to use them instead: Specify the full search path directly in @b{Ref@TeX{}}'s variables. @lisp -(setq reftex-texpath-environment-variables +(setq reftex-texpath-environment-variables '("./inp:/home/cd/tex//:/usr/local/tex//")) (setq reftex-bibpath-environment-variables '("/home/cd/tex/lit/")) @@ -2820,7 +2820,7 @@ command depends upon the version of that program. (setq reftex-use-external-file-finders t) (setq reftex-external-file-finders '(("tex" . "kpsewhich -format=.tex %f") - ("bib" . "kpsewhich -format=.bib %f"))) + ("bib" . "kpsewhich -format=.bib %f"))) @end lisp @end itemize @@ -2835,9 +2835,9 @@ the new extension must also be known to AUCTeX via the variable @code{TeX-file-extension}. For example: @lisp -(setq reftex-file-extensions +(setq reftex-file-extensions '(("nw" "tex" ".tex" ".ltx") ("bib" ".bib"))) -(setq TeX-file-extensions +(setq TeX-file-extensions '( "nw" "tex" "sty" "cls" "ltx" "texi" "texinfo")) @end lisp @@ -3148,7 +3148,7 @@ file @file{natbib.el} for the Natbib citation style does switch (reftex-set-cite-format 'natbib)))) @end lisp -@findex reftex-add-index-macros +@findex reftex-add-index-macros The hook may contain a call to @code{reftex-add-index-macros} to define additional @code{\index}-like macros. The argument must have the same format as @code{reftex-index-macros}. It may be a symbol, to @@ -3282,7 +3282,7 @@ literally for speed reasons. Then both short context and section headings may look different from what you usually see on your screen. In rare cases @code{reftex-toc} may have problems to jump to an affected section heading. There are three possible ways to deal with -this:@refill +this:@refill @itemize @minus @item @vindex reftex-keep-temporary-buffers @@ -3332,7 +3332,7 @@ The first line is just a normal configuration for a macro. For the argument (which really is a second argument to the macro @code{\begin}) as a label of type @code{?p}. Argument count for this macro starts only after the @samp{@{step+@}}, also when specifying how to get -context.@refill +context.@refill @item @b{Idle timers in XEmacs}@* @@ -3455,7 +3455,7 @@ When called with one or two @kbd{C-u} prefixes, first rescans the document. When called with a numeric prefix, make that many citations. When called with point inside the braces of a @code{\cite} command, it will add another key, ignoring the value of -@code{reftex-cite-format}.@refill @* +@code{reftex-cite-format}.@refill @* The regular expression uses an expanded syntax: @samp{&&} is interpreted as @code{and}. Thus, @samp{aaaa&&bbb} matches entries which contain both @samp{aaaa} and @samp{bbb}. While entering the regexp, completion @@ -3668,7 +3668,7 @@ Non-@code{nil} means, initially turn automatic recentering of toc on. When active, the @file{*TOC*} buffer will always show the section you are currently working in. Recentering happens whenever Emacs is idle for more than `reftex-idle-time' seconds. -This feature can be turned on and off from the menu +This feature can be turned on and off from the menu (Ref->Options). @end defopt @@ -4154,7 +4154,7 @@ called.@refill @deffn {Normal Hook} reftex-select-label-mode-hook Normal hook which is run when a selection buffer enters -@code{reftex-select-label-mode}.@refill +@code{reftex-select-label-mode}.@refill @end deffn @deffn Keymap reftex-select-label-map @@ -4287,14 +4287,14 @@ normal names separator, like @samp{, } in Jones, Brown and Miller @item final names separator, like @samp{ and } in Jones, Brown and Miller @item -The @samp{et al.} string, like @samp{ @{\it et al.@}} in +The @samp{et al.} string, like @samp{ @{\it et al.@}} in Jones @{\it et al.@} @end enumerate @end defopt @deffn {Normal Hook} reftex-select-bib-mode-hook Normal hook which is run when a selection buffer enters -@code{reftex-select-bib-mode}.@refill +@code{reftex-select-bib-mode}.@refill @end deffn @deffn Keymap reftex-select-bib-map @@ -4318,7 +4318,7 @@ document.@refill @defopt reftex-index-special-chars List of special characters in index entries, given as strings. These -correspond to the @code{MakeIndex} keywords +correspond to the @code{MakeIndex} keywords @code{(@var{level} @var{encap} @var{actual} @var{quote} @var{escape})}. @end defopt @@ -4533,7 +4533,7 @@ This is used when `reftex-view-crossref' is called with point in an argument of a macro. Note that crossref viewing for citations, references (both ways) and index entries is hard-coded. This variable is only to configure additional structures for which crossreference -viewing can be useful. Each entry has the structure +viewing can be useful. Each entry has the structure @example (@var{macro-re} @var{search-re} @var{highlight}). @end example @@ -4556,7 +4556,7 @@ display. This feature can be turned on and off from the menu @end defopt @defopt reftex-idle-time -Time (secs) Emacs has to be idle before automatic crossref display +Time (secs) Emacs has to be idle before automatic crossref display or toc recentering is done.@refill @end defopt @@ -4626,7 +4626,7 @@ be expanded recursively. See also @code{reftex-use-external-file-finders}. @defopt reftex-file-extensions Association list with file extensions for different file types. -This is a list of items, each item is like: +This is a list of items, each item is like: @code{(@var{type} . (@var{def-ext} @var{other-ext} ...))} @example @var{type}: @r{File type like @code{"bib"} or @code{"tex"}.} @@ -5250,7 +5250,7 @@ Fixed bug with empty context strings. @item Parse files @file{MASTER.rel} made compatible between Emacs and XEmacs. @item -@code{kill-emacs-hook} and @code{kill-buffer-hook} now write the parse +@code{kill-emacs-hook} and @code{kill-buffer-hook} now write the parse file. @item The cursor inside a @code{\ref} or @code{\cite} macro can now trigger @@ -5357,7 +5357,7 @@ labels like @samp{eq:13} sequentially through a document. @item Multiple selection buffers are now hidden buffers (they start with a SPACE). -@item +@item Fixed bug with file search when TEXINPUTS environment variable is empty. @end itemize @noindent @b{Version 3.34} @@ -5392,9 +5392,9 @@ to be on the macro argument. @itemize @bullet @item New options @code{reftex-texpath-environment-variables}, -@code{reftex-use-external-file-finders}, -@code{reftex-external-file-finders}, -@code{reftex-search-unrecursed-path-first}. +@code{reftex-use-external-file-finders}, +@code{reftex-external-file-finders}, +@code{reftex-search-unrecursed-path-first}. @item @emph{kpathsearch} support. See new options and @code{reftex-bibpath-environment-variables}. @@ -5430,7 +5430,7 @@ Reading a parse file now checks consistency. @noindent @b{Version 4.00} @itemize @bullet @item -RefTeX has been split into several smaller files which are autoloaded on +RefTeX has been split into several smaller files which are autoloaded on demand. @item Index support, along with many new options. @@ -5480,9 +5480,9 @@ Multiple @code{thebibliography} environments recognized. @item New option @code{reftex-toc-max-level} to limit the depth of the toc. New key binding @kbd{t} in the @file{*toc*} buffer to change this -setting.@refill +setting.@refill @item -RefTeX maintains an @file{Index Phrases} file in which phrases can be +RefTeX maintains an @file{Index Phrases} file in which phrases can be collected. When the document is ready, RefTeX can search all these phrases and assist indexing all matches.@refill @item @@ -5497,7 +5497,7 @@ default stuff which has been moved to a constant.@refill @item Environments like theorems can be placed into the TOC by putting entries for @samp{"begin@{theorem@}"} in -@code{reftex-setion-levels}.@refill +@code{reftex-setion-levels}.@refill @end itemize @noindent @b{Version 4.10} @itemize @bullet @@ -5531,7 +5531,7 @@ Improved interaction with Emacs LaTeX mode. @end ignore @noindent @b{Version 4.17} @itemize @bullet -@item +@item The toc window can be split off horizontally. See new options @code{reftex-toc-split-windows-horizontally}, @code{reftex-toc-split-windows-horizontally-fraction}. diff --git a/man/rmail.texi b/man/rmail.texi index 150145dfad1..9e6db0b9df5 100644 --- a/man/rmail.texi +++ b/man/rmail.texi @@ -94,7 +94,7 @@ changed). @kbd{C-x s} is a good enough way to do this @section Scrolling Within a Message When Rmail displays a message that does not fit on the screen, you -must scroll through it to read the rest. You could do this with +must scroll through it to read the rest. You could do this with @kbd{C-v}, @kbd{M-v} and @kbd{M-<}, but in Rmail scrolling is so frequent that it deserves to be easier to type. diff --git a/man/sc.texi b/man/sc.texi index c702c9fb9cf..c9f03d8f906 100644 --- a/man/sc.texi +++ b/man/sc.texi @@ -41,7 +41,7 @@ license to the document, as described in section 6 of the license. @dircategory Emacs @direntry -* SC: (sc). Supercite lets you cite parts of messages you're +* SC: (sc). Supercite lets you cite parts of messages you're replying to, in flexible ways. @end direntry @@ -1178,7 +1178,7 @@ Executing @code{sc-cite-original} performs the following steps as it initializes the reply buffer: @enumerate -@item +@item @vindex sc-pre-hook @vindex pre-hook (sc-) @emph{Runs @code{sc-pre-hook}.} @@ -1222,7 +1222,7 @@ Supercite sets an undo boundary before it begins to modify the original yanked text. This allows you to easily undo Supercite's changes to affect alternative citing styles. -@item +@item @emph{Processes the mail headers.} @vindex sc-confirm-always-p @vindex confirm-always-p (sc-) @@ -1275,7 +1275,7 @@ Once the mail headers have been processed, Supercite selects a attribution string and a citation string which it will use to cite the original message. @xref{Selecting an Attribution}, for details. -@item +@item @emph{Cites the message body.} @vindex sc-cite-region-limit @vindex cite-region-limit (sc-)b @@ -1316,7 +1316,7 @@ wouldn't encounter them all anyway. But you can configure Supercite to recognize those styles you see often. @xref{Configuring the Citation Engine}, for details.@refill -@item +@item @emph{Runs @code{sc-post-hook}.} @vindex sc-post-hook @vindex post-hook (sc-) @@ -1581,7 +1581,7 @@ Use the last selected attribution, if there is one. @item Use the value of the @code{"x-attribution"} key. -@item +@item Use the author's first name. @item @@ -1590,11 +1590,11 @@ Use the author's last name. @item Use the author's initials. -@item +@item Find the first non-@code{nil}, non-empty attribution string in the attribution alist. -@item +@item @code{sc-default-attribution} is used. @end enumerate @@ -2135,7 +2135,7 @@ together is bound on @kbd{C-c C-p C-p}.@refill Finally, the command @kbd{C-c C-p C-t h} (also @kbd{C-c C-p C-t ?}) brings up a Help message on the toggling keymap. - + @node Mail Field Commands, Miscellaneous Commands, Variable Toggling Shortcuts, Post-yank Formatting Commands @comment node-name, next, previous, up @@ -2299,7 +2299,7 @@ setting up a reply or forward buffer, your MUA should follow these steps: @enumerate -@item +@item Insert the original message, including the mail headers into the reply buffer. At this point you should not modify the raw text in any way, and you should place all the original headers into the body of the reply. @@ -2307,7 +2307,7 @@ This means that many of the mail headers will be duplicated, one copy above the @code{mail-header-separator} line and one copy below, however there will probably be more headers below this line.@refill -@item +@item Set @samp{point} to the beginning of the line containing the first mail header in the body of the reply. Set @samp{mark} at the end of the message text. It is very important that the region be set around the @@ -2319,7 +2319,7 @@ Emacs 19, the region need not be set active. Supercite will work properly when the region is inactive, as should any other like-minded package.@refill -@item +@item Run the hook @code{mail-citation-hook}. You will probably want to provide some kind of default citation functions in cases where the user does not have Supercite installed. By default, your MUA should diff --git a/man/screen.texi b/man/screen.texi index fc364d86071..2f5b66936be 100644 --- a/man/screen.texi +++ b/man/screen.texi @@ -107,7 +107,7 @@ for accessing the value now called ``point.'' @node Echo Area @section The Echo Area @cindex echo area -@c +@c The line at the bottom of the frame (below the mode line) is the @dfn{echo area}. It is used to display small amounts of text for diff --git a/man/texinfo.tex b/man/texinfo.tex index b0a1cfc3e72..35b3020e628 100644 --- a/man/texinfo.tex +++ b/man/texinfo.tex @@ -35,10 +35,10 @@ % ftp://tug.org/tex/texinfo.tex % (and all CTAN mirrors, see http://www.ctan.org), % and /home/gd/gnu/doc/texinfo.tex on the GNU machines. -% +% % The texinfo.tex in any given Texinfo distribution could well be out % of date, so if that's what you're using, please check. -% +% % Texinfo has a small home page at http://texinfo.org/ and also % http://www.gnu.org/software/texinfo. % @@ -175,7 +175,7 @@ % add check for \lastpenalty to plain's definitions. If the last thing % we did was a \nobreak, we don't want to insert more space. -% +% \def\smallbreak{\ifnum\lastpenalty<10000\par\ifdim\lastskip<\smallskipamount \removelastskip\penalty-50\smallskip\fi\fi} \def\medbreak{\ifnum\lastpenalty<10000\par\ifdim\lastskip<\medskipamount @@ -730,10 +730,10 @@ where each line of input produces a line of output.} % @inmargin{TEXT [, RIGHT-TEXT]} % (if RIGHT-TEXT is given, use TEXT for left page, RIGHT-TEXT for right; % else use TEXT for both). -% +% \def\inmargin#1{\parseinmargin #1,,\finish} \def\parseinmargin#1,#2,#3\finish{% not perfect, but better than nothing. - \setbox0 = \hbox{\ignorespaces #2}% + \setbox0 = \hbox{\ignorespaces #2}% \ifdim\wd0 > 0pt \def\lefttext{#1}% have both texts \def\righttext{#2}% @@ -797,7 +797,7 @@ where each line of input produces a line of output.} % @paragraphindent NCHARS % We'll use ems for NCHARS, close enough. % We cannot implement @paragraphindent asis, though. -% +% \def\asisword{asis} % no translation, these are keywords \def\noneword{none} % @@ -840,7 +840,7 @@ where each line of input produces a line of output.} % We don't use $'s directly in the definition of \math because we need % to set catcodes according to plain TeX first, to allow for subscripts, % superscripts, special math chars, etc. -% +% % @math does not do math typesetting in section titles, index % entries, and other such contexts where the catcodes are set before % @math gets a chance to work. This could perhaps be fixed, but for now @@ -852,7 +852,7 @@ where each line of input produces a line of output.} % an actual _ character, as in @math{@var{some_variable} + 1}. So make % _ within @math be active (mathcode "8000), and distinguish by seeing % if the current family is \slfam, which is what @var uses. -% +% {\catcode95 = \active % 95 = _ \gdef\mathunderscore{% \catcode95=\active @@ -863,7 +863,7 @@ where each line of input produces a line of output.} % FYI, plain.tex uses \\ as a temporary control sequence (why?), but % this is not advertised and we don't care. Texinfo does not % otherwise define @\. -% +% % The \mathchar is class=0=ordinary, family=7=ttfam, position=5C=\. \def\mathbackslash{\ifnum\fam=\ttfam \mathchar"075C \else\backslash \fi} % @@ -986,11 +986,11 @@ where each line of input produces a line of output.} \def\pdfmakeoutlines{{% \openin 1 \jobname.toc \ifeof 1\else\begingroup - \closein 1 + \closein 1 \indexnofonts \def\tt{} \let\_ = \normalunderscore - % Thanh's hack / proper braces in bookmarks + % Thanh's hack / proper braces in bookmarks \edef\mylbrace{\iftrue \string{\else}\fi}\let\{=\mylbrace \edef\myrbrace{\iffalse{\else\string}\fi}\let\}=\myrbrace % @@ -1032,7 +1032,7 @@ where each line of input produces a line of output.} \let\nextmakelinks=\makelinks \ifnum\lnkcount>0,\fi \picknum{#1}% - \startlink attr{/Border [0 0 0]} + \startlink attr{/Border [0 0 0]} goto name{\pdfmkpgn{\the\pgn}}% \linkcolor #1% \advance\lnkcount by 1% @@ -1087,7 +1087,7 @@ where each line of input produces a line of output.} \ifx\first0\adn0 \else\ifx\first1\adn1 \else\ifx\first2\adn2 \else\ifx\first3\adn3 \else\ifx\first4\adn4 \else\ifx\first5\adn5 \else\ifx\first6\adn6 - \else\ifx\first7\adn7 \else\ifx\first8\adn8 \else\ifx\first9\adn9 + \else\ifx\first7\adn7 \else\ifx\first8\adn8 \else\ifx\first9\adn9 \else \ifnum0=\countA\else\makelink\fi \ifx\first.\let\next=\done\else @@ -1521,7 +1521,7 @@ where each line of input produces a line of output.} % rms does not like angle brackets --karl, 17may97. % So now @email is just like @uref, unless we are pdf. -% +% %\def\email#1{\angleleft{\tt #1}\angleright} \ifpdf \def\email#1{\doemail#1,,\finish} @@ -2742,10 +2742,10 @@ width0pt\relax} \fi % @synindex foo bar makes index foo feed into index bar. % Do this instead of @defindex foo if you don't want it as a separate index. -% +% % @syncodeindex foo bar similar, but put all entries made for index foo % inside @code. -% +% \def\synindex#1 #2 {\dosynindex\doindex{#1}{#2}} \def\syncodeindex#1 #2 {\dosynindex\docodeindex{#1}{#2}} @@ -2787,13 +2787,13 @@ width0pt\relax} \fi % Take care of texinfo commands likely to appear in an index entry. % (Must be a way to avoid doing expansion at all, and thus not have to % laboriously list every single command here.) -% +% \def\indexdummies{% \def\ { }% \def\@{@}% change to @@ when we switch to @ as escape char in aux files. % Need these in case \tex is in effect and \{ is a \delimiter again. % But can't use \lbracecmd and \rbracecmd because texindex assumes -% braces and backslashes are used only as delimiters. +% braces and backslashes are used only as delimiters. \let\{ = \mylbrace \let\} = \myrbrace \def\_{{\realbackslash _}}% @@ -3348,7 +3348,7 @@ width0pt\relax} \fi \wd0=\hsize \wd2=\hsize \hbox to\pagewidth{\box0\hfil\box2}% } -% +% % All done with double columns. \def\enddoublecolumns{% \output = {% @@ -4149,7 +4149,7 @@ width0pt\relax} \fi % @foo ... @end foo. % @point{}, @result{}, @expansion{}, @print{}, @equiv{}. -% +% % Since these characters are used in examples, it should be an even number of % \tt widths. Each \tt character is 1en, so two makes it 1em. % @@ -4161,7 +4161,7 @@ width0pt\relax} \fi % The @error{} command. % Adapted from the TeXbook's \boxit. -% +% \newbox\errorbox % {\tentt \global\dimen0 = 3em}% Width of the box. @@ -4469,7 +4469,7 @@ width0pt\relax} \fi % LaTeX-like @verbatim...@end verbatim and @verb{<char>...<char>} -% If we want to allow any <char> as delimiter, +% If we want to allow any <char> as delimiter, % we need the curly braces so that makeinfo sees the @verb command, eg: % `@verbx...x' would look like the '@verbx' command. --janneke@gnu.org % @@ -4543,8 +4543,8 @@ width0pt\relax} \fi \everypar{\starttabbox}% } -% Do the @verb magic: verbatim text is quoted by unique -% delimiter characters. Before first delimiter expect a +% Do the @verb magic: verbatim text is quoted by unique +% delimiter characters. Before first delimiter expect a % right brace, after last delimiter expect closing brace: % % \def\doverb'{'<char>#1<char>'}'{#1} @@ -4563,7 +4563,7 @@ width0pt\relax} \fi % % \def\doverbatim#1@end verbatim{#1} % -% For Texinfo it's a lot easier than for LaTeX, +% For Texinfo it's a lot easier than for LaTeX, % because texinfo's \verbatim doesn't stop at '\end{verbatim}': % we need not redefine '\', '{' and '}' % @@ -4621,7 +4621,7 @@ width0pt\relax} \fi % @copying ... @end copying. % Save the text away for @insertcopying later. -% +% \newbox\copyingbox % \def\copying{\begingroup @@ -4631,7 +4631,7 @@ width0pt\relax} \fi } % @insertcopying. -% +% \def\insertcopying{\unvcopy\copyingbox} @@ -4734,7 +4734,7 @@ width0pt\relax} \fi % #1 is the \E... control sequence to end the definition (which we define). % #2 is the \...x control sequence (which our caller defines). % #3 is the control sequence to process the header, such as \defunheader. -% +% \def\parsebodycommon#1#2#3{% \begingroup\inENV % If there are two @def commands in a row, we'll have a \nobreak, @@ -4791,7 +4791,7 @@ width0pt\relax} \fi % to account for this both in the \...x definition and in parsing the % input at hand. Thus also need a control sequence (passed as #5) for % the \E... definition to assign the category name to. -% +% \def\deftypeopparsebody#1#2#3#4#5 #6 {% \parsebodycommon{#1}{#2}{#3}% \def#2##1 ##2 ##3 {% @@ -5148,7 +5148,7 @@ width0pt\relax} \fi % These definitions are used if you use @defunx (etc.) % anywhere other than immediately after a @defun or @defunx. -% +% \def\defcvx#1 {\errmessage{@defcvx in invalid context}} \def\deffnx#1 {\errmessage{@deffnx in invalid context}} \def\defivarx#1 {\errmessage{@defivarx in invalid context}} @@ -5949,7 +5949,7 @@ width0pt\relax} \fi \nobreak\bigskip % Usually we'll have text after the image which will insert % \parskip glue, so insert it here too to equalize the space - % above and below. + % above and below. \nobreak\vskip\parskip \nobreak \line\bgroup\hss @@ -6065,7 +6065,7 @@ should work if nowhere else does.} } % Use `small' versions. -% +% \def\smallenvironments{% \let\smalldisplay = \smalldisplayx \let\smallexample = \smalllispx @@ -6322,7 +6322,7 @@ should work if nowhere else does.} % Say @foo, not \foo, in error messages. @escapechar = `@@ -% These look ok in all fonts, so just make them not special. +% These look ok in all fonts, so just make them not special. @catcode`@& = @other @catcode`@# = @other @catcode`@% = @other diff --git a/man/text.texi b/man/text.texi index d80cb087a8f..08b9e625b3c 100644 --- a/man/text.texi +++ b/man/text.texi @@ -918,7 +918,7 @@ the hook @code{outline-mode-hook} (@pxref{Hooks}). @menu * Format: Outline Format. What the text of an outline looks like. * Motion: Outline Motion. Special commands for moving through - outlines. + outlines. * Visibility: Outline Visibility. Commands to control what is visible. * Views: Outline Views. Outlines and multiple views. * Foldout:: Folding editing. @@ -1060,7 +1060,7 @@ Make the body of this heading line, and of all its subheadings, invisible (@code{hide-leaves}). @item C-c C-k Make all subheadings of this heading line, at all levels, visible -(@code{show-branches}). +(@code{show-branches}). @item C-c C-i Make immediate subheadings (one level down) of this heading line visible (@code{show-children}). @@ -1847,7 +1847,7 @@ contains a list of ideas for future enhancements. * Color: Format Colors. Changing the color of text. * Indent: Format Indentation. Changing the left and right margins. * Justification: Format Justification. - Centering, setting text flush with the + Centering, setting text flush with the left or right margin, etc. * Other: Format Properties. The "special" text properties submenu. * Forcing Enriched Mode:: How to force use of Enriched mode. @@ -2146,7 +2146,7 @@ Prefix}. @node Format Justification @subsection Justification in Formatted Text - + When editing formatted text, you can specify various styles of justification for a paragraph. The style you specify automatically affects the Emacs fill commands. @@ -2218,7 +2218,7 @@ 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}. - + @node Format Properties @subsection Setting Other Text Properties @@ -2258,7 +2258,7 @@ 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}. -@end itemize +@end itemize The command @code{format-decode-buffer} translates text in various formats into Emacs's internal format. It asks you to specify the format diff --git a/man/tramp.texi b/man/tramp.texi index 93cba2fea17..de819e9c454 100644 --- a/man/tramp.texi +++ b/man/tramp.texi @@ -67,7 +67,7 @@ Copyright @copyright{} 1999, 2000, 2001, 2002 Free Software Foundation, Inc. -@quotation +@quotation Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no @@ -1202,7 +1202,7 @@ Example: @defun tramp-set-completion-function method function-list This function sets @var{function-list} as list of completion functions -for @var{method}. +for @var{method}. Example: @example @@ -1620,7 +1620,7 @@ If you, for example, type @kbd{C-x C-f @value{tramp-prefix}t @value{tramp-prefix-single-hop}telnet@value{tramp-postfix-single-hop} @value{tramp-prefix-single-hop}toto@value{tramp-postfix} @end ifset @end example - + @samp{@value{tramp-prefix-single-hop}telnet@value{tramp-postfix-single-hop}} is a possible completion for the respective method, @ifset emacs @@ -1898,7 +1898,7 @@ operations on files accessed via @tramp{}. In the case of a remote file, the @code{shell-command} interface is used, with some wrapper code, to provide the same functionality on the -remote machine as would be seen on the local machine. +remote machine as would be seen on the local machine. @node Changed workfiles diff --git a/man/trouble.texi b/man/trouble.texi index 510176560f6..737fcf12fb0 100644 --- a/man/trouble.texi +++ b/man/trouble.texi @@ -818,7 +818,7 @@ To make Lisp errors stop Emacs and return to GDB, put a breakpoint at @code{Fsignal}. For a short listing of Lisp functions running, type the GDB -command @code{xbacktrace}. +command @code{xbacktrace}. The file @file{.gdbinit} defines several other commands that are useful for examining the data types and contents of Lisp objects. Their names diff --git a/man/vip.texi b/man/vip.texi index 6a977029e29..fc34eacc865 100644 --- a/man/vip.texi +++ b/man/vip.texi @@ -1750,7 +1750,7 @@ Place a copy of specified lines after @var{addr}. If @var{addr} is @item (.,.@:) d[elete] @var{register} @var{count} @var{flags} Delete specified lines. Text will be saved in a named @var{register} if a lower-case letter is given, and appended to a register if a capital letter is -given. +given. @item e[dit] !@: +@var{addr} @var{file} @itemx e[x] !@: +@var{addr} @var{file} @itemx vi[sual] !@: +@var{addr} @var{file} diff --git a/man/viper.texi b/man/viper.texi index 88387c1f919..a5b102acd56 100644 --- a/man/viper.texi +++ b/man/viper.texi @@ -1194,7 +1194,7 @@ way to do this is to use Emacs customization widget, which is accessible from the menubar. Viper customization group is located under the @emph{Emulations} customization group, which in turn is under the @emph{Editing} group (or simply by typing @kbd{:customize}). All Viper -faces are grouped together under Viper's +faces are grouped together under Viper's @emph{Highlighting} group. Try it: it is really simple! @@ -1748,7 +1748,7 @@ defined in the low-level key-translation-map or function-key-map, such as those emitted by the arrow and function keys. Other sequences, e.g., @kbd{\\e/}, are treated as @kbd{ESC} command followed by a @kbd{/}. This is good for people who type fast and tend to hit other characters right after they hit -ESC. Other people like Emacs to translate @kbd{ESC} sequences all the time. +ESC. Other people like Emacs to translate @kbd{ESC} sequences all the time. The default is to translate all sequences only when using a dumb terminal. This permits you to use @kbd{ESC} as a meta key in insert mode. For instance, hitting @kbd{ESC x} fast would have the effect of typing @kbd{M-x}. @@ -2035,7 +2035,7 @@ If you wish to change a Viper binding, you can use the @code{viper-insert-global-user-map}, and @code{viper-emacs-global-user-map}, as explained below. Each of these key maps affects the corresponding Viper state. The keymap @code{viper-insert-global-user-map} also affects Viper's Replace -state. +state. @noindent If you want to @@ -2219,7 +2219,7 @@ means that bindings set by those modes are generally available with Viper @code{viper-want-emacs-keys-in-vi} and @code{viper-want-emacs-keys-in-insert} to @code{nil}). If @code{viper-always} is set to @code{t} (which is the default), Viper -will try to bring each buffer +will try to bring each buffer in the Viper state that is most appropriate for that buffer. Usually, this would be the Vi state, but sometimes it could be the Insert state or the Emacs state. @@ -2661,7 +2661,7 @@ This variable controls the rate at which double-clicking must occur for the purpose of mouse search and mouse insert. By default, this is set to @code{double-click-time} in Emacs and to @code{mouse-track-multi-click-time} milliseconds in XEmacs. -@end table +@end table @kindex @kbd{S-Mouse-1} @kindex @kbd{S-Mouse-2} @kindex @kbd{meta shift button1up} @@ -2731,7 +2731,7 @@ the meaning of key sequences: keys typed in fast succession are treated specially, if this key sequence is bound to a macro. Viper provides Vi-style keyboard macros through the usual Ex commands, -@kbd{:map} and +@kbd{:map} and @kbd{:map!}. These macros are much more powerful in Viper than they are in the original Vi and in other emulators. This is because Viper implements an enhanced vi-style @@ -4044,8 +4044,8 @@ Obsolete @item :args List files not shown anywhere with counts for next @item :n [count] [+<cmd>] [<files>] -Edit <count> file, or edit files. The count comes from @kbd{:args}. -@item :N [count] [+<cmd>] [<files>] +Edit <count> file, or edit files. The count comes from @kbd{:args}. +@item :N [count] [+<cmd>] [<files>] Like @kbd{:n}, but the meaning of the variable @var{ex-cycle-other-window} is reversed. @item :b diff --git a/man/widget.texi b/man/widget.texi index 0a8b0f4b8c3..d1d7bae0315 100644 --- a/man/widget.texi +++ b/man/widget.texi @@ -44,18 +44,18 @@ Software Foundation raise funds for GNU development.'' @top The Emacs Widget Library @menu -* Introduction:: -* User Interface:: -* Programming Example:: -* Setting Up the Buffer:: -* Basic Types:: -* Sexp Types:: -* Widget Properties:: -* Defining New Widgets:: -* Widget Browser:: -* Widget Minor Mode:: -* Utilities:: -* Widget Wishlist:: +* Introduction:: +* User Interface:: +* Programming Example:: +* Setting Up the Buffer:: +* Basic Types:: +* Sexp Types:: +* Widget Properties:: +* Defining New Widgets:: +* Widget Browser:: +* Widget Minor Mode:: +* Utilities:: +* Widget Wishlist:: * Index:: @end menu @@ -78,7 +78,7 @@ The basic widgets are: @item link Areas of text with an associated action. Intended for hypertext links embedded in text. -@item push-button +@item push-button Like link, but intended for stand-alone buttons. @item editable-field An editable text field. It can be either variable or fixed length. @@ -92,14 +92,14 @@ buttons. The options are implemented as widgets. All options will be visible in the buffer. @item item A simple constant widget intended to be used in the @code{menu-choice} and -@code{radio-button-choice} widgets. +@code{radio-button-choice} widgets. @item choice-item A button item only intended for use in choices. When invoked, the user will be asked to select another option from the choice widget. @item toggle A simple @samp{on}/@samp{off} switch. @item checkbox -A checkbox (@samp{[ ]}/@samp{[X]}). +A checkbox (@samp{[ ]}/@samp{[X]}). @item editable-list Create an editable list. The user can insert or delete items in the list. Each list item is itself a widget. @@ -112,7 +112,7 @@ supposed to fill out a number of fields, each of which has a specific meaning. The user is not supposed to change or delete any of the text between the fields. Examples of forms in Emacs are the @file{forms} package (of course), the customize buffers, the mail and news compose -modes, and the @sc{html} form support in the @file{w3} browser. +modes, and the @sc{html} form support in the @file{w3} browser. @cindex widget library, why use it The advantages for a programmer of using the @code{widget} package to @@ -120,21 +120,21 @@ implement forms are: @enumerate @item -More complex fields than just editable text are supported. +More complex fields than just editable text are supported. @item You can give the users immediate feedback if they enter invalid data in a text field, and sometimes prevent entering invalid data. -@item +@item You can have fixed sized fields, thus allowing multiple fields to be lined up in columns. @item -It is simple to query or set the value of a field. -@item +It is simple to query or set the value of a field. +@item Editing happens in the buffer, not in the mini-buffer. -@item +@item Packages using the library get a uniform look, making them easier for the user to learn. -@item +@item As support for embedded graphics improve, the widget library will be extended to use the GUI features. This means that your code using the widget library will also use the new graphic features automatically. @@ -147,7 +147,7 @@ create any widgets, the code has been split in two files: @table @file @item widget.el This will declare the user variables, define the function -@code{define-widget}, and autoload the function @code{widget-create}. +@code{define-widget}, and autoload the function @code{widget-create}. @item wid-edit.el Everything else is here, there is no reason to load it explicitly, as it will be autoloaded when needed. @@ -177,7 +177,7 @@ Numbers: count to three below @b{[INS]} @b{[DEL]} @i{One} @b{[INS]} @b{[DEL]} @i{Eh, two?} @b{[INS]} @b{[DEL]} @i{Five!} -@b{[INS]} +@b{[INS]} Select multiple: @@ -258,7 +258,7 @@ field. Option fields are created by the @code{menu-choice} widget. In the example, @samp{@b{Choose}} is an option field tag. @item The @samp{@b{[INS]}} and @samp{@b{[DEL]}} buttons Activating these will insert or delete elements from an editable list. -The list is created by the @code{editable-list} widget. +The list is created by the @code{editable-list} widget. @cindex embedded buttons @item Embedded Buttons The @samp{@b{_other work_}} is an example of an embedded @@ -280,7 +280,7 @@ main difference from the @code{link} widget is that the buttons will be displayed as GUI buttons when possible. @end table -To make them easier to locate, buttons are emphasized in the buffer. +To make them easier to locate, buttons are emphasized in the buffer. @deffn Face widget-button-face Face used for buttons. @@ -352,11 +352,11 @@ Interface}). (widget-insert "\nSee also ") (widget-create 'link :notify (lambda (&rest ignore) - (widget-value-set widget-example-repeat + (widget-value-set widget-example-repeat '("En" "To" "Tre")) (widget-setup)) "other work") - (widget-insert + (widget-insert " for more information.\n\nNumbers: count to three below\n") (setq widget-example-repeat (widget-create 'editable-list @@ -387,7 +387,7 @@ Interface}). '(item "One") '(item "Another One.") '(item "A Final One.")) (widget-insert "\n") (widget-create 'push-button - :notify (lambda (&rest ignore) + :notify (lambda (&rest ignore) (if (= (length (widget-value widget-example-repeat)) 3) (message "Congratulation!") @@ -425,8 +425,8 @@ that are part of @var{type}. Delete @var{widget} and remove it from the buffer. @end defun -@defun widget-setup -Set up a buffer to support widgets. +@defun widget-setup +Set up a buffer to support widgets. This should be called after creating all the widgets and before allowing the user to edit them. @@ -436,7 +436,7 @@ the user to edit them. If you want to insert text outside the widgets in the form, the recommended way to do that is with @code{widget-insert}. -@defun widget-insert +@defun widget-insert Insert the arguments, either strings or characters, at point. The inserted text will be read-only. @end defun @@ -492,7 +492,7 @@ The following @samp{%} escapes are available: The text inside will be marked as a button. By default, the text will be shown in @code{widget-button-face}, and -surrounded by brackets. +surrounded by brackets. @defopt widget-button-prefix String to prefix buttons. @@ -505,7 +505,7 @@ String to suffix buttons. @item %@{ @itemx %@} The text inside will be displayed with the face specified by -@code{:sample-face}. +@code{:sample-face}. @item %v This will be replaced with the buffer representation of the widget's @@ -528,7 +528,7 @@ Insert the string specified by @code{:tag} here, or the @code{princ} representation of the value if there is no tag. @item %% -Insert a literal @samp{%}. +Insert a literal @samp{%}. @end table @vindex button-face@r{ keyword} @@ -556,12 +556,12 @@ The value of the symbol is expanded according to this table. @vindex doc@r{ keyword} @item :doc The string inserted by the @samp{%d} escape in the format -string. +string. @vindex tag@r{ keyword} @item :tag The string inserted by the @samp{%t} escape in the format -string. +string. @vindex tag-glyph@r{ keyword} @item :tag-glyph @@ -597,7 +597,7 @@ A function called each time the widget or a nested widget is changed. The function is called with two or three arguments. The first argument is the widget itself, the second argument is the widget that was changed, and the third argument is the event leading to the change, if -any. +any. @vindex menu-tag@r{ keyword} @item :menu-tag @@ -639,7 +639,7 @@ implemented. @item Widgets with tabbing order @code{-1} are ignored. -@item +@item (Unimplemented) When on a widget with tabbing order @var{n}, go to the next widget in the buffer with tabbing order @var{n+1} or @code{nil}, whichever comes first. @@ -664,7 +664,7 @@ arguments, which will be used when creating the @code{radio-button} or @end table @deffn {User Option} widget-glyph-directory -Directory where glyphs are found. +Directory where glyphs are found. Widget will look here for a file with the same name as specified for the image, with either a @file{.xpm} (if supported) or @file{.xbm} extension. @end deffn @@ -675,21 +675,21 @@ If non-nil, allow glyphs to appear on displays where they are supported. @menu -* link:: -* url-link:: -* info-link:: -* push-button:: -* editable-field:: -* text:: -* menu-choice:: -* radio-button-choice:: -* item:: -* choice-item:: -* toggle:: -* checkbox:: -* checklist:: -* editable-list:: -* group:: +* link:: +* url-link:: +* info-link:: +* push-button:: +* editable-field:: +* text:: +* menu-choice:: +* radio-button-choice:: +* item:: +* choice-item:: +* toggle:: +* checkbox:: +* checklist:: +* editable-list:: +* group:: @end menu @node link, url-link, Basic Types, Basic Types @@ -705,7 +705,7 @@ TYPE ::= (link [KEYWORD ARGUMENT]... [ VALUE ]) The @var{value}, if present, is used to initialize the @code{:value} property. The value should be a string, which will be inserted in the -buffer. +buffer. By default the link will be shown in brackets. @@ -730,7 +730,7 @@ TYPE ::= (url-link [KEYWORD ARGUMENT]... URL) @findex browse-url-browser-function@r{, and @code{url-link} widget} When this link is invoked, the @sc{www} browser specified by -@code{browse-url-browser-function} will be called with @var{url}. +@code{browse-url-browser-function} will be called with @var{url}. @node info-link, push-button, url-link, Basic Types @comment node-name, next, previous, up @@ -744,7 +744,7 @@ TYPE ::= (info-link [KEYWORD ARGUMENT]... ADDRESS) @end example When this link is invoked, the built-in Info reader is started on -@var{address}. +@var{address}. @node push-button, editable-field, info-link, Basic Types @comment node-name, next, previous, up @@ -759,7 +759,7 @@ TYPE ::= (push-button [KEYWORD ARGUMENT]... [ VALUE ]) The @var{value}, if present, is used to initialize the @code{:value} property. The value should be a string, which will be inserted in the -buffer. +buffer. By default the tag will be shown in brackets. @@ -797,7 +797,7 @@ By default the field will reach to the end of the line. @vindex value-face@r{ keyword} @item :value-face Face used for highlighting the editable field. Default is -@code{widget-field-face}, see @ref{User Interface}. +@code{widget-field-face}, see @ref{User Interface}. @vindex secret@r{ keyword} @item :secret @@ -849,7 +849,7 @@ arguments. @table @code @vindex void@r{ keyword} -@item :void +@item :void Widget type used as a fallback when the value does not match any of the specified @var{type} arguments. @@ -868,8 +868,8 @@ type in the buffer. The current chosen type. @vindex args@r{ keyword} -@item :args -The list of types. +@item :args +The list of types. @end table @node radio-button-choice, item, menu-choice, Basic Types @@ -901,7 +901,7 @@ Replace with the buffer representation of the @var{type} widget. @item %b Replace with the radio button. @item %% -Insert a literal @samp{%}. +Insert a literal @samp{%}. @end table @vindex button-args@r{ keyword} @@ -922,13 +922,13 @@ The widgets representing each type. The current chosen type @vindex args@r{ keyword} -@item :args -The list of types. +@item :args +The list of types. @end table You can add extra radio button items to a @code{radio-button-choice} widget after it has been created with the function -@code{widget-radio-add-item}. +@code{widget-radio-add-item}. @defun widget-radio-add-item widget type Add to @code{radio-button-choice} widget @var{widget} a new radio button @@ -969,7 +969,7 @@ The @var{value}, if present, is used to initialize the @code{:value} property. The value should be a string, which will be inserted in the buffer as a button. Activating the button of a @code{choice-item} is equivalent to activating the parent widget. This widget will only match -the specified value. +the specified value. @node toggle, checkbox, choice-item, Basic Types @comment node-name, next, previous, up @@ -991,7 +991,7 @@ The following extra properties are recognized: @item :on A string representing the @samp{on} state. By default the string @samp{on}. -@item :off +@item :off A string representing the @samp{off} state. By default the string @samp{off}. @vindex on-glyph@r{ keyword} @@ -1047,7 +1047,7 @@ Replaced with the buffer representation of the @var{type} widget. @item %b Replace with the checkbox. @item %% -Insert a literal @samp{%}. +Insert a literal @samp{%}. @end table @vindex greedy@r{ keyword} @@ -1072,8 +1072,8 @@ The widgets representing the checkboxes. The widgets representing each type. @vindex args@r{ keyword} -@item :args -The list of types. +@item :args +The list of types. @end table @node editable-list, group, checklist, Basic Types @@ -1088,7 +1088,7 @@ TYPE ::= (editable-list [KEYWORD ARGUMENT]... TYPE) @end example The value is a list, where each member represents one widget of type -@var{type}. +@var{type}. The following extra properties are recognized: @@ -1106,7 +1106,7 @@ Insert the @b{[INS]} button. @item %d Insert the @b{[DEL]} button. @item %% -Insert a literal @samp{%}. +Insert a literal @samp{%}. @end table @vindex insert-button-args@r{ keyword} @@ -1147,7 +1147,7 @@ Syntax: TYPE ::= (group [KEYWORD ARGUMENT]... TYPE...) @end example -The value is a list, with one member for each @var{type}. +The value is a list, with one member for each @var{type}. @node Sexp Types, Widget Properties, Basic Types, Top @comment @@ -1159,10 +1159,10 @@ for short, are also available. These basically fall in several categories described in this section. @menu -* constants:: -* generic:: -* atoms:: -* composite:: +* constants:: +* generic:: +* atoms:: +* composite:: @end menu @node constants, generic, Sexp Types, Sexp Types @@ -1185,7 +1185,7 @@ property and can be any s-expression. @deffn Widget const This will display any valid s-expression in an immutable part of the -buffer. +buffer. @end deffn There are two variations of the @code{const} widget, namely @@ -1218,7 +1218,7 @@ TYPE ::= (sexp [KEYWORD ARGUMENT]... [ VALUE ]) @deffn Widget sexp This will allow you to edit any valid s-expression in an editable buffer -field. +field. The @code{sexp} widget takes the same keyword arguments as the @code{editable-field} widget. @xref{editable-field}. @@ -1262,7 +1262,7 @@ Allows you to enter a character in an editable field. @deffn Widget file Allows you to edit a file name in an editable field. If you invoke the tag button, you can edit the file name in the mini-buffer with -completion. +completion. Keywords: @table @code @@ -1353,7 +1353,7 @@ specification: string string))) @end example -The value of a widget of this type will either have the form +The value of a widget of this type will either have the form @code{(file t)} or @code{(file string string)}. This concept of inline is probably hard to understand. It was certainly @@ -1403,7 +1403,7 @@ modifying the value of a widget before the user is allowed to edit the widget again. It is enough to call @code{widget-setup} once if you modify multiple widgets. This is currently only necessary if the widget contains an editing field, but may be necessary for other widgets in the -future. +future. If your application needs to associate some information with the widget objects, for example a reference to the item being edited, it can be @@ -1426,7 +1426,7 @@ Non-nil if @var{widget} has a value (even nil) for property @var{property}. @end defun Occasionally it can be useful to know which kind of widget you have, -i.e.@: the name of the widget type you gave when the widget was created. +i.e.@: the name of the widget type you gave when the widget was created. @defun widget-type widget Return the name of @var{widget}, a symbol. @@ -1459,7 +1459,7 @@ a widget is really active, you must therefore activate both it and all its ancestors. @lisp -(while widget +(while widget (widget-apply widget :activate) (setq widget (widget-get widget :parent))) @end lisp @@ -1482,13 +1482,13 @@ its ancestors have been deactivated. Do not attempt to set the You can define specialized widgets with @code{define-widget}. It allows you to create a shorthand for more complex widgets, including specifying component widgets and new default values for the keyword -arguments. +arguments. @defun define-widget name class doc &rest args Define a new widget type named @var{name} from @code{class}. @var{name} and class should both be symbols, @code{class} should be one -of the existing widget types. +of the existing widget types. The third argument @var{DOC} is a documentation string for the widget. @@ -1517,14 +1517,14 @@ If you only want to specify defaults for keywords with no complex conversions, you can use @code{identity} as your conversion function. The following additional keyword arguments are useful when defining new -widgets: +widgets: @table @code @vindex convert-widget@r{ keyword} @item :convert-widget Function to convert a widget type before creating a widget of that type. It takes a widget type as an argument, and returns the converted widget type. When a widget is created, this function is called for the -widget type and all the widget's parent types, most derived first. +widget type and all the widget's parent types, most derived first. The following predefined functions can be used here: @@ -1596,9 +1596,9 @@ Delete all @code{:children} and @code{:buttons} in @var{widget}. @end defun @vindex value-get@r{ keyword} -@item :value-get +@item :value-get Function to extract the value of a widget, as it is displayed in the -buffer. +buffer. The following predefined function can be used here: @@ -1621,7 +1621,7 @@ escape sequences, as well as give an error for unknown escapes. @vindex action@r{ keyword} @item :action Function to handle user initiated events. By default, @code{:notify} -the parent. +the parent. The following predefined function can be used here: @@ -1644,11 +1644,11 @@ for this widget, and does not have to check that it matches. If you want to define a new widget from scratch, use the @code{default} widget as its base. -@deffn Widget default -Widget used as a base for other widgets. +@deffn Widget default +Widget used as a base for other widgets. It provides most of the functionality that is referred to as ``by -default'' in this text. +default'' in this text. @end deffn @node Widget Browser, Widget Minor Mode, Defining New Widgets, Top @@ -1683,7 +1683,7 @@ When called interactively, use the position of point. There is a minor mode for manipulating widgets in major modes that don't provide any support for widgets themselves. This is mostly -intended to be useful for programmers doing experiments. +intended to be useful for programmers doing experiments. @deffn Command widget-minor-mode Toggle minor mode for traversing widgets. @@ -1716,11 +1716,11 @@ This is only meaningful for radio buttons or checkboxes in a list. @cindex todo @itemize @bullet -@item +@item It should be possible to add or remove items from a list with @kbd{C-k} and @kbd{C-o} (suggested by @sc{rms}). -@item +@item The @samp{[INS]} and @samp{[DEL]} buttons should be replaced by a single dash (@samp{-}). The dash should be a button that, when invoked, asks whether you want to add or delete an item (@sc{rms} wanted to git rid of @@ -1738,9 +1738,9 @@ Make indentation work with glyphs and proportional fonts. @item Add commands to show overview of object and class hierarchies to the -browser. +browser. -@item +@item Find a way to disable mouse highlight for inactive widgets. @item @@ -1762,10 +1762,10 @@ Add @code{widget} widget for editing widget specifications. Find clean way to implement variable length list. See @code{TeX-printer-list} for an explanation. -@item +@item @kbd{C-h} in @code{widget-prompt-value} should give type specific help. -@item +@item Add a @code{mailto} widget. @end itemize diff --git a/man/xresources.texi b/man/xresources.texi index e6451e76998..aa9fd818e55 100644 --- a/man/xresources.texi +++ b/man/xresources.texi @@ -458,7 +458,7 @@ Emacs.pane.menubar.popup_*.popup_*.Spell Checking.Complete Word: @var{value} @noindent (This should be one long line.) - + It's impossible to specify a resource for all the menu-bar items without also specifying it for the submenus as well. So if you want the submenu items to look different from the menu bar itself, you must ask @@ -533,7 +533,7 @@ The color for the border shadow, on the top and the left. If the Emacs installed at your site was built to use the GTK widget set, then the menu bar, scroll bar and the dialogs can be customized with the standard GTK @file{~/.gtkrc-2.0} file or with the Emacs specific -@file{~/.emacs.d/gtkrc} file; note that these files are only for +@file{~/.emacs.d/gtkrc} file; note that these files are only for customizing specific GTK widget features. To customize Emacs font, background, faces etc., use the normal X resources, see @ref{Resources}. @@ -568,7 +568,7 @@ gtk-font-name = "courier 12" If GTK at your site is installed under @var{prefix}, the resource file syntax is fully described in the GTK API -document +document @file{@var{prefix}/share/gtk-doc/html/gtk/gtk-resource-files.html}. @var{prefix} is usually @file{/usr} or @file{/usr/local}. You can find the same document online at @@ -586,7 +586,7 @@ You can find the same document online at @appendixsubsec GTK widget names @cindex GTK widget names - Widgets are specified by widget class or by widget name. + Widgets are specified by widget class or by widget name. The widget class is the type of the widget, for example @code{GtkMenuBar}. The widget name is the name given to a specific widget within a program. A widget always have a class but it is not mandatory to give a name to @@ -649,8 +649,8 @@ widget "*menu*" style "my_style" @cindex GTK widget classes In Emacs the top level widget for a frame is a @code{GtkWindow} that -contains a @code{GtkVBox}. The @code{GtkVBox} contains the -@code{GtkMenuBar} and a @code{GtkFixed} widget. +contains a @code{GtkVBox}. The @code{GtkVBox} contains the +@code{GtkMenuBar} and a @code{GtkFixed} widget. The vertical scroll bars, @code{GtkVScrollbar}, are contained in the @code{GtkFixed} widget. The text you write in Emacs is drawn in the @code{GtkFixed} widget. @@ -669,7 +669,7 @@ widget_class "GtkWindow.GtkVBox.GtkMenuBar" style "my_style" For the scroll bar, the absolute class name is: @smallexample -widget_class +widget_class "GtkWindow.GtkVBox.GtkFixed.GtkVScrollbar" style "my_style" @end smallexample @@ -705,7 +705,7 @@ widget "Emacs.pane.emacs.verticalScrollbar" style "my_style" @end smallexample GTK absolute names are quite strange when it comes to menus -and dialogs. The names do not start with @samp{Emacs}, as they are +and dialogs. The names do not start with @samp{Emacs}, as they are free-standing windows and not contained (in the GTK sense) by the Emacs GtkWindow. To customize the dialogs and menus, use wildcards like this: @@ -720,7 +720,7 @@ This file is only read by Emacs, so anything in @file{~/.emacs.d/gtkrc} affects Emacs but leaves other applications unaffected. For example, the drop down menu in the file dialog can not be customized by any absolute widget name, only by an absolute -class name. This is so because the widgets in the drop down menu does not +class name. This is so because the widgets in the drop down menu does not have names and the menu is not contained in the Emacs GtkWindow. To have all menus in Emacs look the same, use this in @file{~/.emacs.d/gtkrc}: @@ -766,7 +766,7 @@ style "default" bg_pixmap[NORMAL] = "background.xpm" bg_pixmap[INSENSITIVE] = "background.xpm" bg_pixmap[ACTIVE] = "background.xpm" - bg_pixmap[PRELIGHT] = "<none>" + bg_pixmap[PRELIGHT] = "<none>" @} @@ -788,7 +788,7 @@ The possible states are 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"} +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. @item PRELIGHT @@ -817,7 +817,7 @@ editable text, use @code{base} for that. @item base[@var{state}] = @var{color} This is the background color for editable text. -In Emacs, this color is used for the background of the text fields in the +In Emacs, this color is used for the background of the text fields in the file dialog. @item bg_pixmap[@var{state}] = "@var{pixmap}" @@ -844,7 +844,7 @@ of text in menus and buttons. It is also the color for the arrows in the scroll bar. For editable text, use @code{text}. @item text[@var{state}] = @var{color} -This is the color for editable text. In Emacs, this color is used for the +This is the color for editable text. In Emacs, this color is used for the text fields in the file dialog. @item font_name = "@var{font}" @@ -861,7 +861,7 @@ A color name is written within double quotes, for example @code{"red"}. @noindent A hexadecimal form is written within double quotes. There are four forms, -@code{#rrrrggggbbbb}, @code{#rrrgggbbb}, +@code{#rrrrggggbbbb}, @code{#rrrgggbbb}, @code{#rrggbb}, or @code{#rgb}. In each of these r, g and b are hex digits. @noindent |