1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2026-01-05 03:20:39 -08:00
Commit graph

1195 commits

Author SHA1 Message Date
Chong Yidong
27d1f87a35 Misc docfixes.
Suggested by Martin Rudalics.

* doc/lispref/display.texi (Face Functions): Fix define-obsolete-face-alias.

* doc/lispref/functions.texi (Obsolete Functions): Fix doc for
set-advertised-calling-convention.

* doc/lispref/modes.texi (Mode Help): Fix describe-mode.

* doc/lispref/variables.texi (Variable Aliases): Fix make-obsolete-variable.

* lisp/help.el (describe-mode): Doc fix.
2012-05-15 23:43:06 +08:00
Martin Rudalics
0b128ac426 Some minor fixes of Elisp manual.
* commands.texi (Recursive Editing): recursive-edit is a
command.
* compile.texi (Docs and Compilation):
byte-compile-dynamic-docstrings is an option.
* debugging.texi (Invoking the Debugger): debug is a command.
* display.texi (Progress): progress-reporter-update and
progress-reporter-force-update have VALUE argument optional.
(Animated Images): Use non-@code{nil} instead of non-nil.
* files.texi (Format Conversion Round-Trip): Use non-@code{nil}
instead of non-nil.
* frames.texi (Creating Frames): make-frame is a command.
(Input Focus): select-frame is a command.
(Pointer Shape): void-text-area-pointer is an option.
* help.texi (Describing Characters): read-kbd-macro is a
command.
(Help Functions): describe-prefix-bindings is a command.
* markers.texi (Creating Markers): Both arguments of copy-marker
are optional.
* minibuf.texi (Reading File Names): Use @kbd instead of @code.
* modes.texi (Mode Line Variables): mode-line-remote and
mode-line-client are not options.
(Imenu): imenu-add-to-menubar is a command.
(SMIE Indentation Helpers): Use non-@code{nil} instead of
non-nil.
* os.texi (Sound Output): play-sound-file is a command.
* package.texi (Package Archives): Use @key{RET} instead of
@kbd{RET}.
* processes.texi (Signals to Processes): Use @key{RET} instead
of @code{RET}.
(Signals to Processes): signal-process is a command.
* text.texi (Clickable Text): Use @key{RET} instead of
@kbd{RET}.
(Base 64): base64-encode-string is not a command while
base64-decode-region is.
* windows.texi (Switching Buffers): pop-to-buffer is a command.
2012-05-15 11:38:50 +02:00
Glenn Morris
0a454caf05 Move part of previous clean rule change to mostlyclean
* doc/lispref/Makefile.in (mostlyclean): Add some more vol1/2 items.
2012-05-08 15:39:29 -04:00
Glenn Morris
e6afe47b27 * doc/lispref/Makefile.in (clean): Add some more vol1/2 items. 2012-05-07 22:01:28 -04:00
Glenn Morris
143d9dd80e doc/lispref/two-volume.make small fix
* doc/lispref/two-volume.make (emacsdir): New.
(tex): Add directory with emacsver.texi to TEXINPUTS.
2012-05-07 21:57:08 -04:00
Glenn Morris
e68b393e60 * minibuf.texi (Minibuffer History, Basic Completion): Tweak page breaks. 2012-05-04 19:49:19 -07:00
Glenn Morris
3e1a3a0035 Undo part of previous change 2012-05-04 19:28:00 -07:00
Glenn Morris
9658dc2ada More small edits for doc/lispref
* internals.texi (Garbage Collection, Memory Usage)
(Writing Emacs Primitives): Tweak page breaks.
2012-05-04 19:26:45 -07:00
Glenn Morris
161c2a258a More page break tweaks for doc/lispref
* doc/lispref/edebug.texi (Edebug Display Update): Improve page break.
* doc/lispref/streams.texi (Output Variables): Improve page break.
2012-05-04 21:16:54 -04:00
Glenn Morris
51d58083d1 * doc/lispref/compile.texi (Disassembly): Condense the examples. 2012-05-04 21:05:12 -04:00
Glenn Morris
ddff335186 More small edits for doc/lispref
* control.texi: Where possible, use example rather than smallexample.
(Sequencing, Conditionals, Signaling Errors, Handling Errors):
Tweak page breaks.

* customize.texi: Where possible, use example rather than smallexample.
(Common Keywords, Variable Definitions, Applying Customizations)
(Custom Themes): Tweak page breaks.

* eval.texi, functions.texi, loading.texi, macros.texi:
Where possible, use example rather than smallexample.

* sequences.texi (Arrays): Tweak page breaks.

* symbols.texi: Where possible, use example rather than smallexample.
(Symbol Components): Fix typo.
(Other Plists): Tweak page break.
2012-05-04 20:37:30 -04:00
Glenn Morris
8d8d67aee8 Small edits for doc/lispref/lists.texi
* lists.texi (List-related Predicates, List Variables): Tweak page-breaks.
(Sets And Lists): Convert inforef to xref.
2012-05-04 00:38:33 -07:00
Glenn Morris
cd8d025346 * text.texi (Auto Filling): Don't mention Emacs 19. 2012-05-04 00:29:52 -07:00
Glenn Morris
50f0084172 A belated farewell to documenting Emacs 18 features
* commands.texi (Event Input Misc): Don't mention unread-command-char.
* numbers.texi (Predicates on Numbers): Don't mention Emacs 18.
2012-05-04 00:27:29 -07:00
Glenn Morris
06793fea52 * objects.texi (Process Type, Overlay Type): Tweak page-breaks. 2012-05-04 00:24:02 -07:00
Glenn Morris
2da3a0d232 Small edits for lispref/intro.texi
* intro.texi (Caveats): Copyedit.
(Lisp History): Convert inforef to xref.
(Lisp History, Printing Notation, Version Info): Improve page-breaks.
2012-05-04 00:14:51 -07:00
Glenn Morris
cfed8eeb2f * elisp.texi (DATE): Forgot to change the month in 2012-04-21 change. 2012-05-04 00:04:40 -07:00
Glenn Morris
bbba8869a2 Only print the edition number of the manuals in the TeX version
Frankly, I think the edition conveys little to no information.
The version number of Emacs is much more relevant.
No-one seems to know what the rules are for updating the edition anyway...

* doc/emacs/emacs.texi (@copying): Only print EDITION in the TeX version.

* doc/lispref/elisp.texi (@copying):
* doc/lispref/intro.texi (Introduction): Only print VERSION in the TeX version.
2012-05-01 00:38:15 -07:00
Chong Yidong
5a5fd9f33a * doc/lispref/text.texi (Change Hooks): Minor fix for after-change-functions. 2012-04-29 14:56:58 +08:00
Glenn Morris
7eac3782ca Reword some doc/lispref to remove/reduce some overly long/short lines.
* package.texi (Packaging Basics):
* loading.texi (Autoload):
* files.texi (Magic File Names):
Reword to remove/reduce some overly long/short lines.
2012-04-28 01:05:01 -07:00
Glenn Morris
cf98857824 Some menu fixes for doc/lispref
* doc/lispref/elisp.texi, doc/lispref/vol1.texi, doc/lispref/vol2.texi:
Some fixes for detailed menu.

* doc/lispref/modes.texi (Major Modes, Auto-Indentation):
* doc/lispref/buffers.texi (Buffers): Some fixes for menu descriptions.
2012-04-26 13:56:38 -04:00
Stefan Monnier
88ed9e87e5 Deprecate the ((lambda ...) ...) form.
* doc/lispref/functions.texi (Simple Lambda, Argument List):
* doc/lispref/eval.texi (Function Indirection): Avoid deprecated form.
2012-04-25 23:06:36 -04:00
Glenn Morris
1a72be4624 Add "et al." to authors for emacs and elisp manuals.
This seems only fair, since there have been a large number of
contributors since the original ones.

* doc/emacs/emacs.texi:
* doc/lispref/book-spine.texi, doc/lispref/elisp.texi, doc/lispref/vol1.texi:
* doc/lispref/vol2.texi:
Add "et al." to authors.
2012-04-25 20:48:08 -04:00
Glenn Morris
16152b76a4 Use Texinfo recommended convention for quotes+punctuation. 2012-04-25 20:31:47 -04:00
Chong Yidong
775ab3953f Fix last fix. 2012-04-23 11:44:13 +08:00
Chong Yidong
9ec7751f83 Doc fixes for where-is-internal.
* doc/lispref/keymaps.texi (Scanning Keymaps): Fix description of
NO-REMAP arg to where-is-internal.

* src/keymap.c (where_is_internal): Doc fix (Bug#10872).
2012-04-23 11:11:28 +08:00
Glenn Morris
a271566979 * doc/lispref/macros.texi (Indenting Macros): Fix typo. 2012-04-21 12:34:05 -07:00
Glenn Morris
09ebefe1e0 More small edits for doc/lispref/windows.texi
* doc/lispref/windows.texi (Textual Scrolling, Coordinates and Windows)
(Window Configurations, Window Parameters, Window Hooks): Copyedits.
(Textual Scrolling): Mention recenter-redisplay, recenter-top-bottom,
and recenter-positions.  Remove recenter example.

* admin/FOR-RELEASE: Related markup.
2012-04-21 12:31:05 -07:00
Glenn Morris
e78d873d90 More small edits for doc/lispref/windows.texi
* doc/lispref/windows.texi (Cyclic Window Ordering, Window History)
(Dedicated Windows, Quitting Windows, Window Configurations): Copyedits.
(Window Start and End): Remove pointless example.
Remove cross-reference to deleted count-lines content.
2012-04-20 22:15:27 -04:00
Glenn Morris
0b27932b2d Small edits for doc/lispref/windows.texi
* doc/lispref/windows.texi (Basic Windows, Windows and Frames, Window Sizes)
(Resizing Windows, Deleting Windows, Selecting Windows)
(Choosing Window Options, Horizontal Scrolling): Copyedits.
(Splitting Windows, Deleting Windows): Fix ignore-window-parameters logic.
(Selecting Windows, Choosing Window Options): Markup fixes.
2012-04-20 21:49:43 -04:00
Glenn Morris
384ec638e6 Standardize case of "GTK+" in a few manuals 2012-04-20 20:52:08 -04:00
Glenn Morris
0dc91072e3 Bump lispref version
* doc/lispref/elisp.texi, doc/lispref/vol1.texi, doc/lispref/vol2.texi:
Bump VERSION and DATE (in case we forgoet to do it later).
I don't know what VERSION means, but it should be bigger than before.
Note that README no longer mentions these.
2012-04-20 20:46:58 -04:00
Glenn Morris
9c51bbaa92 lispref minibuf.texi small edit
* doc/lispref/minibuf.texi (Intro to Minibuffers):
Tweak discussion of resizing minibuffer window.
2012-04-20 20:14:11 -04:00
Chong Yidong
f30d612a7a Fixes for pty handling in gdb-mi.el and process.c.
* lisp/progmodes/gdb-mi.el (gdb): Revert 2012-04-19 change.
(gdb-inferior-io--init-proc): New function.
(gdb-init-1): Use it.
(gdb-inferior-io-sentinel): New sentinel for the gdb-inferior pty,
responsible for allocating a new pty and hooking it to gdb when
the old pty gets an EIO due to process exit.
(gdb-delchar-or-quit): New command.  Bind it in gdb-mi buffers.
(gdb-tooltip-print): Don't use obsolete tooltip-use-echo-area.
(gdb-inferior-io--maybe-delete-pty): Move into gdb-reset.

* src/process.c (wait_reading_process_output): If EIO occurs on a pty,
set the status to "failed" and ensure that sentinel is run.

* doc/lispref/processes.texi (Asynchronous Processes): Mention nil
argument to start-process.
2012-04-20 14:39:29 +08:00
Glenn Morris
b58b1df840 More small edits for doc/lispref/minibuf.texi
* doc/lispref/elisp.texi, doc/lispref/vol1.texi, doc/lispref/vol2.texi:
* doc/lispref/minibuf.texi (Completion):
Update "High-Level Completion" description.

* doc/lispref/minibuf.texi (Basic Completion):
No need to describe obarrays here.
Don't mention obsolete `nospace' argument of all-completions.
(Minibuffer Completion, Completion Commands, Reading File Names)
(Completion Variables): Copyedits.
(Completion Commands): Mention parent keymaps.
Remove obsolete minibuffer-local-filename-must-match-map.
(High-Level Completion): Remove read-variable's almost
word-for-word duplication of read-command.
2012-04-19 21:37:14 -04:00
Glenn Morris
c5467d73ae ChangeLog fix 2012-04-18 23:05:58 -07:00
Glenn Morris
c0ea08d2d1 More small edits for doc/lispref/minibuf.texi
* doc/lispref/minibuf.texi (Object from Minibuffer):
Remove overly pedantic paragraph.
(Minibuffer History): Copyedits.  Add face-name-history.
(Initial Input, Yes-or-No Queries, Multiple Queries)
(Minibuffer Windows, Minibuffer Misc): Copyedits.
(Yes-or-No Queries): Tweak example.
(Minibuffer Commands): Add next-complete-history-element.
(Minibuffer Misc): Mention minibuffer-message-timeout, and
minibuffer-inactive-mode.

* doc/lispref/minibuf.texi (Minibuffers):
* doc/lispref/elisp.texi, doc/lispref/vol1.texi, doc/lispref/vol2.texi:
Fix minibuffer subsection order.

* lisp/subr.el: Comment.
2012-04-18 23:04:05 -07:00
Glenn Morris
78c1f4901d Shameful typo 2012-04-18 19:44:48 -07:00
Glenn Morris
9d2754f50c Small edits for doc/lispref/minibuf.texi
* doc/lispref/minibuf.texi: Standardize metasyntactic variables
("history", etc).
Use Texinfo-recommended form of quote+punctuation.
(Intro to Minibuffers): First minibuffer is #1, not #0.
Mention minibuffer-inactive-mode.
(Text from Minibuffer): Copyedits.
(Minibuffer History, Programmed Completion): Fix @var usage.
2012-04-18 22:00:23 -04:00
Glenn Morris
4373fd4326 More small doc and lispref edits related to processes
* doc/lispref/processes.texi (Serial Ports, Byte Packing, Bindat Spec)
(Bindat Functions): Copyedits.

* src/process.c (Fset_process_inherit_coding_system_flag)
(Fset_process_query_on_exit_flag): Doc fix (mention return value).
(Fmake_network_process, Fmake_serial_process): Doc fix.

* admin/FOR-RELEASE: Related markup.
2012-04-18 00:21:18 -07:00
Christopher Schmidt
0e80650b8b Docfix for require-final-newline in Lisp manual.
* doc/lispref/files.texi (Saving Buffers): Document `visit and `visit-save'
values of require-final-newline.
2012-04-18 14:20:47 +08:00
Glenn Morris
016a35dfa7 More process-related doc and manual small edits
* doc/lispref/processes.texi (Output from Processes, Filter Functions):
Mention waiting-for-user-input-p.
(Sentinels, Query Before Exit, System Processes, Transaction Queues):
(Network Servers, Datagrams, Network Processes, Network Options)
(Network Feature Testing, Serial Ports): Copyedits.
(Network): Add encrypted network overview paragraph.
Cross-reference the Emacs-GnuTLS manual.  Use @acronym.

* lisp/net/network-stream.el (open-network-stream): Doc fix.

* src/process.c (Fset_process_inherit_coding_system_flag)
(Fset_process_query_on_exit_flag): Doc fix (mention return value).
(Fmake_network_process): Doc fix.
2012-04-17 20:48:43 -07:00
Chong Yidong
21ffa320b1 Improve description of :advertised-binding in Lisp manual.
* doc/lispref/keymaps.texi (Menu Bar): Move most of the :advertised-binding
description to help.texi.

* doc/lispref/help.texi (Keys in Documentation): Mention :advertised-binding.
2012-04-17 13:58:34 +08:00
Glenn Morris
4f5d565ff3 * processes.texi (Accepting Output): Discourage use of `millisec' argument. 2012-04-15 17:55:06 -07:00
Glenn Morris
62f4b18cfd More small edits for doc/lispref/processes.texi
* doc/lispref/processes.texi (Process Information, Input to Processes)
(Signals to Processes, Output from Processes, Process Buffers)
(Filter Functions, Decoding Output): Copyedits.
2012-04-15 17:50:58 -07:00
Glenn Morris
12acf78334 More small edits for doc/lispref/processes.texi
* doc/lispref/processes.texi (Asynchronous Processes, Deleting Processes):
Copyedits.
(Asynchronous Processes): Update some example output.
2012-04-14 18:58:41 -07:00
Glenn Morris
e153c13643 Doc and manual fixes related to processes
* doc/lispref/processes.texi (Processes, Subprocess Creation, Shell Arguments):
(Synchronous Processes): Copyedits.
(Subprocess Creation): Discourage modifying exec-path directly.
(Synchronous Processes): Update some example output.
(Process Information): Fix typo.
(Bindat Spec): Use Texinfo-recommended form of quote+punctuation.

* lisp/simple.el (process-file-side-effects): Doc fix.
2012-04-14 18:37:16 -07:00
Glenn Morris
764a3017e2 doc/lispref/anti.texi small edits
* doc/lispref/anti.texi (Antinews): Copyedits.  Don't @dfn anything here.
open-network-stream does exist in Emacs 23, but is simpler.

* admin/FOR-RELEASE: Related markup.
2012-04-14 13:43:11 -07:00
Chong Yidong
03ed9e82ad * doc/lispref/customize.texi (Custom Themes): Also document load-theme etc. 2012-04-13 12:18:40 +08:00
Chong Yidong
81927dd2a4 New Lisp manual nodes, Applying Customizations and Custom Themes.
* doc/lispref/customize.texi (Applying Customizations):
(Custom Themes): New nodes.

* doc/lispref/display.texi (Defining Faces): Reference custom-set-faces.

* doc/lispref/modes.texi (Defining Minor Modes, Defining Minor Modes):
* doc/lispref/os.texi (Startup Summary): Copyedits.

* doc/emacs/custom.texi (Creating Custom Themes): Add reference to Custom
Themes node in Lisp manual.

* lisp/custom.el (custom-theme-set-variables): Doc fix.
2012-04-12 22:50:58 +08:00