1
0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2024-12-02 08:22:22 +00:00
Commit Graph

1121 Commits

Author SHA1 Message Date
Chong Yidong
83ef8187f4 Fixes for Mouse Menu node.
* doc/lispref/keymaps.texi (Mouse Menus): Describe non-toolkit behavior as the
non-default situation.  Describe one-submenu exception.

* doc/lispref/nonascii.texi (Character Properties): Copyedits.

Fixes: debbugs:7695
2012-03-10 11:27:10 +08:00
Glenn Morris
3266b56f81 FOR-RELEASE markup 2012-03-07 00:38:05 -08:00
Glenn Morris
763d4948ee FOR-RELEASE markup 2012-03-06 20:58:30 -05:00
Chong Yidong
ef959d3a0c * doc/lispref/positions.texi (Text Lines): Document count-words. 2012-03-05 14:12:17 +08:00
Chong Yidong
a08a07e339 Update Frames chapter of Lisp manager. Document clipboard manager.
* doc/emacs/killing.texi (Clipboard): Document clipboard manager.

* doc/lispref/windows.texi (Basic Windows, Coordinates and Windows)
(Coordinates and Windows):
* display.texi (Refresh Screen, Line Height, Face Attributes)
(Overlay Arrow, Beeping, Glyphless Chars): Likewise.

* doc/lispref/frames.texi (Frames): Remove little-used "terminal frame" and
"window frame" terminology.
(Frame Parameters, Font and Color Parameters, Initial Parameters)
(Size and Position, Visibility of Frames): Callers changed.
(Frames): Clarify which terminals in framep are graphical.
(Initial Parameters): --geometry is not the only option which adds
to initial-frame-alist.
(Position Parameters): Note that icon-left and icon-top are for
old window managers only.
(Size Parameters): Sizes are in characters even on graphical
displays.
(Management Parameters): Note that window-id and outer-window-id
can't really be changed, and that auto-raise isn't always obeyed.
(Cursor Parameters): Document cursor-type explicitly.
(Size and Position): The aliases set-screen-height and
set-screen-width have been deleted.
(Visibility of Frames): Mention "minimization".

* doc/lispref/os.texi (Startup Summary): Minor clarifications.
(Startup Summary, Suspending Emacs): Standardize on "text
terminal" terminology.
2012-03-04 14:50:18 +08:00
Glenn Morris
ea16568d87 Checked lispref/abbrevs.texi
* doc/lispref/abbrevs.texi: Small copyedits throughout.
(Abbrev Mode): Remove this section, folding it into the top-level.
(Abbrev Tables): Don't mention irrelevant return values.
(Abbrev Expansion): Add cross-ref for wrapper hooks.
(Standard Abbrev Tables): Emacs Lisp mode now has its own table.
(Abbrev Table Properties): Update nil :regexp description.

* lisp/abbrev.el (copy-abbrev-table, abbrev-table-p)
(abbrev-minor-mode-table-alist, define-abbrev, abbrev-insert)
(expand-abbrev, define-abbrev-table): Doc fixes.

* admin/FOR-RELEASE: Related markup.
2012-03-03 18:45:04 -08:00
Glenn Morris
7d2d7cc065 Checked lispref/internals.texi, somewhat
* doc/lispref/internals.texi: (Writing Emacs Primitives):
Update Fcoordinates_in_window_p and For example definitions.
Give examples of things with non-nil interactive args.  Mention eval_sub.
Remove old info about strings and GCPRO.  Mention cus-start.el.
(Buffer Internals, Window Internals, Process Internals):
Misc small updates and fixes for fields.

* admin/FOR-RELEASE: Related markup.
2012-03-03 14:13:28 -08:00
Glenn Morris
b3134b95a5 Checked lispref/tips.texi
* doc/lispref/tips.texi: Copyedits.
(Coding Conventions): Mention autoloads.
Combine partially duplicated macro items.  Fix xref.
Refer to Library Headers for copyright notice.
(Programming Tips): edit-options is long-obsolete.
(Compilation Tips): Mention loading bytecomp for byte-compile props.
(Warning Tips): Mention declare-function.
(Documentation Tips): Remove old info.
(Comment Tips): Mention comment-dwim, not indent-for-comment.
(Library Headers): General update.

* admin/FOR-RELEASE: Related markup.
2012-03-02 20:29:55 -05:00
Glenn Morris
2064cc6ade Checked lispref/hooks.texi
* doc/lispref/hooks.texi (Standard Hooks): General update.
Put related hooks together.

* doc/lispref/commands.texi (Keyboard Macros):
Remove cross-ref to Standard Hooks.

* doc/lispref/modes.texi (Hooks): Tweak cross-ref description.
Remove non-standard file-local fill-column (2010-05-13T03:55:46Z!rgm@gnu.org).

* admin/FOR-RELEASE: Related markup.
2012-03-01 21:52:40 -05:00
Glenn Morris
53a1239b31 Update lispref/maps.texi
Ref http://lists.gnu.org/archive/html/emacs-devel/2012-02/msg00702.html

* doc/lispref/maps.texi (Standard Keymaps): General update.
Remove mode-specific maps, talk about the more general keymaps.
* doc/lispref/help.texi (Help Functions): Add vindex for Helper-help-map.
* doc/lispref/keymaps.texi (Active Keymaps): Minor rephrasing.
* admin/FOR-RELEASE: Related markup.
2012-02-29 23:29:48 -08:00
Glenn Morris
2915737190 Remove lispref/locals.texi
Ref: http://lists.gnu.org/archive/html/emacs-devel/2012-02/msg00702.html

* doc/lispref/locals.texi: Remove file.
* doc/lispref/elisp.texi, doc/lispref/vol1.texi, doc/lispref/vol2.texi:
Don't include locals.texi.  Remove menu entry.
* doc/lispref/errors.texi, doc/lispref/maps.texi: Adjust node pointers.
* doc/lispref/internals.texi (Buffer Internals):
Remove cross-refs to locals.texi.
* doc/lispref/Makefile.in (srcs): Remove locals.texi.

* admin/FOR-RELEASE: Related markup.
2012-02-27 20:17:02 -08:00
Chong Yidong
431ee44bbe More updates for Buffers and Files chapters of Lisp manual.
* doc/emacs/buffers.texi (Creating Buffers): Clarify that
generate-new-buffer uses generate-new-buffer-names.
(Killing Buffers): Remove bogus example duplicating buffer-live-p.

* doc/emacs/files.texi (Directory Names): Index entry for file name abbreviations.
(Relative File Names, File Name Expansion): Refer to it.
(Locating Files): Move locate-user-emacs-file documentation to
Standard File Names.
(Standard File Names): Add locate-user-emacs-file; update examples.
2012-02-27 15:26:13 +08:00
Glenn Morris
7e05b1ec63 Checked errors.texi
* doc/lispref/errors.texi: Don't try to list _all_ the error symbols.
Add circular-list, cl-assertion-failed, compression-error.
* doc/lispref/elisp.texi, doc/lispref/vol1.texi, doc/lispref/vol2.texi:
* doc/lispref/control.texi (Error Symbols): Tweak "Standard Errors" description.
* admin/FOR-RELEASE: Related markup.
2012-02-25 12:59:46 -08:00
Chong Yidong
d268b4fe42 Update Backups chapter of Lisp manual.
* doc/lispref/backups.texi (Making Backups): Mention default value of backup-directory-alist.
(Rename or Copy): Note that backup-by-copying-when-mismatch is t.
(Auto-Saving): New minor mode behavior for auto-save-mode.
(Reverting): Add defvar for revert-buffer-in-progress-p.
2012-02-25 17:32:33 +08:00
Glenn Morris
49fe4321fb Checked mini.texi
* doc/emacs/mini.texi (Minibuffer File, Completion Options, Repetition):
Copyedits.
(Completion Example): Other M-x au* commands may be defined.
(Completion Styles): Mention emacs21 and completion-category-overrides.

* lisp/minibuffer.el (completion-category-overrides): Doc fix.

* admin/FOR-RELEASE: Related markup.
2012-02-23 00:32:18 -08:00
Glenn Morris
8f4042d244 Read msdog.texi
* doc/emacs/msdog.texi (Text and Binary, ls in Lisp, Windows HOME)
(Windows Keyboard, Windows Mouse, Windows Processes)
(Windows Printing, Windows Misc): Copyedits.
(ls in Lisp): Update switches list.
* admin/FOR-RELEASE: Related markup.
2012-02-22 21:36:08 -08:00
Glenn Morris
371fb83399 Checked msdog-xtra.texi
* doc/emacs/msdog-xtra.texi (MS-DOS Display): Update list-colors-display xref.
Update dos-mode* function names.
(MS-DOS Printing, MS-DOS and MULE): Copyedits.
(MS-DOS Processes): Add xref to main ls-lisp section.
* admin/FOR-RELEASE: Related markup.
2012-02-22 20:32:18 -08:00
Glenn Morris
40ace058dc Checked macos.texi (somewhat)
* doc/emacs/macos.texi: Copyedits.  Fix @key/@kbd usage.
(Mac / GNUstep Basics): Don't mention the panels, since the next
section covers them.
(Mac / GNUstep Customization): Merge some panel info from previous.
* admin/FOR-RELEASE: Related markup.
2012-02-22 00:16:48 -08:00
Glenn Morris
68af8d4fc3 Checked emerge-xtra.texi
* doc/emacs/emerge-xtra.texi (Emerge, Submodes of Emerge, Combining in Emerge):
Small fixes.
* admin/FOR-RELEASE: Related markup.
2012-02-21 16:43:51 -05:00
Glenn Morris
2e03845d1b * doc/emacs/emacs-xtra.texi: Picture mode is no longer a chapter.
* admin/FOR-RELEASE: Related markup.
2012-02-21 14:56:14 -05:00
Glenn Morris
5f8dc2cad6 Fix picture-mode C-c C-d binding
* lisp/textmodes/picture.el (picture-delete-char): Newalias.
(picture-mode-map): Use it. 
(picture-mode): Doc fix.
* admin/FOR-RELEASE: Related markup.

Fixes: debbugs:10860
2012-02-21 09:09:19 -08:00
Chong Yidong
a59225b146 Update Files chapter in Lisp manual.
* doc/lispref/files.texi (Files): Mention magic file names as arguments.
(Reading from Files): Copyedits.
(File Attributes): Mention how to change file modes.
(Changing Files): Use standard "file permissions" terminology.
Add xref to File Attributes node.
(Locating Files): Document locate-user-emacs-file.
(Unique File Names): Recommend against using make-temp-name.

* src/buffer.c (Fget_file_buffer): Protect against invalid file
handler return value.

* src/fileio.c (Vfile_name_handler_alist): Doc fix.
2012-02-21 21:24:48 +08:00
Glenn Morris
f9a998c365 Checked picture-xtra.texi
* doc/emacs/picture-xtra.texi (Basic Picture): C-a does get remapped.

* lisp/textmodes/picture.el (picture-motion, picture-motion-reverse)
(picture-self-insert, picture-tab-chars): Doc fix.
(picture-mode-map): Fix C-a, C-e.

* admin/FOR-RELEASE: Related markup.
2012-02-21 00:28:18 -08:00
Glenn Morris
41f1e86867 Checked ack.texi
* doc/emacs/ack.texi (Acknowledgments): Small changes, including resorting,
and removal of things no longer distributed.
* admin/FOR-RELEASE: Related markup.
2012-02-20 16:26:56 -08:00
Glenn Morris
2d2f658128 Checked emacs.texi
* doc/emacs/emacs.texi (Top, Preface): Small rephrasings.
(menu, detailmenu): Update entries, and reformat some descriptions.
* doc/emacs/building.texi, doc/emacs/display.texi:
* doc/emacs/emacs-xtra.texi, doc/emacs/files.texi:
* doc/emacs/frames.texi, doc/emacs/kmacro.texi, doc/emacs/msdog.texi:
* doc/emacs/programs.texi, doc/emacs/text.texi:
Reformat some menu descriptions.

* admin/FOR-RELEASE: Related markup.
2012-02-20 15:50:52 -08:00
Chong Yidong
8376d7c25a Updates to Documentation chapter of Lisp manual.
* doc/lispref/help.texi (Documentation, Documentation Basics, Help Functions):
Minor clarifications.
(Accessing Documentation): Clarify what documentation-property is
for.  Add xref to Keys in Documentation.

* doc/lispref/macros.texi (Defining Macros):
* doc/lispref/modes.texi (Derived Modes): Say "documentation string" instead
of docstring.

* doc/lispref/tips.texi (Documentation Tips): Don't recommend using * in
docstrings.
2012-02-19 13:54:33 +08:00
Glenn Morris
8f4fb15f80 Can't remember why this matters, but Rmail binds M-s too 2012-02-18 19:39:04 -08:00
Glenn Morris
b474519ebe Checked rmail.texi
* doc/emacs/rmail.texi: Copyedits.  Use 'mail composition buffer' in place
of '*mail*', since Message does not call it that.
(Rmail Reply): Rename rmail-dont-reply-to-names.
\\`info- no longer handled specially.
Update for rmail-enable-mime-composing.
Don't mention 'm' for replies.
Don't mention rmail-mail-new-frame and cancelling, since it does
not work for Message at the moment.

* lisp/mail/rmail.el (rmail-dont-reply-to-names): Mark as obsolete.

* lisp/mail/undigest.el (unforward-rmail-message): Doc fix.

* admin/FOR-RELEASE: Related markup.
2012-02-18 13:57:00 -08:00
Glenn Morris
a5987767c5 * doc/emacs/cal-xtra.texi: Copyedits.
* admin/FOR-RELEASE: Related markup.
2012-02-17 22:02:12 -05:00
Glenn Morris
bcc657043d Adjust info-xref-check-all instructions in FOR-RELEASE 2012-02-16 20:54:56 -08:00
Glenn Morris
112d1241d8 Check calendar.texi
* doc/emacs/calendar.texi: Misc small changes, including updating the
dates of examples.

* admin/FOR-RELEASE: Related markup.
2012-02-16 20:28:53 -08:00
Chong Yidong
4230351b56 Update Syntax chapter of Lisp manual.
* doc/lispref/syntax.texi (Syntax Tables, Syntax Descriptors)
(Syntax Table Functions): Copyedits.
(Syntax Basics): Don't repeat the material in the preceding node.
(Syntax Class Table): Use a table.
(Syntax Properties): Document syntax-propertize-function and
syntax-propertize-extend-region-functions.
(Motion via Parsing): Fix indentation.
(Parser State): Update for the new "c" comment style.  Fix
description of item 7 (comment style).

* doc/lispref/modes.texi (Syntactic Font Lock): Add xref to Syntactic Font Lock node.
2012-02-16 22:43:41 +08:00
Glenn Morris
3b19a30db8 * doc/emacs/dired-xtra.texi (Subdir Switches): Small fixes.
* admin/FOR-RELEASE: Related markup.
2012-02-15 23:15:27 -08:00
Glenn Morris
d400b295d7 FOR-RELEASE updates 2012-02-15 22:53:50 -08:00
Chong Yidong
3d8badf411 Update Keymaps chapter of Lisp manual.
* doc/emacs/keymaps.texi (Format of Keymaps): The CACHE component of keymaps
was removed on 2009-09-10.  Update lisp-mode-map example.
(Inheritance and Keymaps): Minor clarification.
(Searching Keymaps): Remove out-of-place enumeration.
(Key Lookup): Remove unnecessary example (one was already given in
Format of Keymaps).
(Changing Key Bindings): Update suppress-keymap example.
(Menu Bar, Tool Bar): Copyedits.
(Tool Bar): Update tool-bar-map example.
2012-02-15 00:41:16 +08:00
Chong Yidong
faccede13a * debugging.texi (Debugger Commands): Continuing is now allowed for errors. 2012-02-12 17:51:03 +08:00
Chong Yidong
25dec36509 Update Compilation and Advice chapters in Lisp manual.
* doc/lispref/advice.texi (Defining Advice): Clarify ad-unadvise.
(Activation of Advice): Specifying the ACTIVATE flag in defadvice
is not abnormal.
(Advising Primitives): Node deleted; ad-define-subr-args has been
removed.

* doc/lispref/compile.texi (Speed of Byte-Code): Use float-time in example.
(Compilation Functions): Note that the log uses Compilation mode.
Don't discuss the contents of byte-code function object here.
(Compilation Functions): De-document internal function byte-code.
(Docs and Compilation): Minor clarifications.

* doc/lispref/objects.texi (Byte-Code Type): Add xref to Byte-Code Function
Objects.

* lisp/emacs-lisp/advice.el: Update commentary to reflect deletion of
ad-define-subr-args
2012-02-10 23:50:11 +08:00
Chong Yidong
6c1e4b4642 Update Loading chapter of Emacs manual.
* doc/emacs/loading.texi (Loading): Don't emphasize "library" terminology.
(Library Search): load-path is not a user option.  Mention role of
-L option and packages.  Improve examples.
(Loading Non-ASCII): Don't mention unibyte Emacs, which is
obsolete.
(Autoload): Minor clarifications.
2012-02-10 15:57:21 +08:00
Alex Ott
5eb7536f50 * tutorials/TUTORIAL.ru: Updated; synchronize with TUTORIAL.
Coding system changed to UTF-8.
2012-02-08 10:05:02 +08:00
Chong Yidong
e1161b06fc Update Customization chapter of Lisp manual.
* doc/lispref/customize.texi (Common Keywords): Minor clarifications.
Document custom-unlispify-remove-prefixes.
(Variable Definitions): Backquotes in defcustom seem to work fine
now.  Various other copyedits.
(Simple Types): Copyedits.  Document color selector.
(Composite Types): Copyedits.
(Splicing into Lists): Clarifications.
2012-02-05 22:27:06 +08:00
Chong Yidong
03988c98df Updates to Macros and Customization chapters of Lisp manual.
* doc/lispref/customize.texi (Common Keywords): Minor clarifications.
Document custom-unlispify-remove-prefixes.
(Variable Definitions): Backquotes in defcustom seem to work fine
now.  Various other copyedits.

* doc/lispref/macros.texi (Expansion): Minor clarification.
(Backquote): Move node to eval.texi.
(Defining Macros): Move an example from Backquote node.
(Argument Evaluation): No need to mention Pascal.
(Indenting Macros): Add xref to Defining Macros.

* doc/lispref/eval.texi (Backquote): Move from macros.texi.

* lisp/custom.el (defcustom): Doc fix.
2012-02-05 14:44:47 +08:00
Chong Yidong
735cc5ca6f Update Functions chapter of Lisp manual; document closures.
* doc/emacs/functions.texi (What Is a Function): Add closures.  Mention
"return value" terminology.  Add xref for command-execute.  Remove
unused "keystroke command" terminology.
(Lambda Expressions): Give a different example than in the
following subsection.  Add xref to Anonymous Functions.
(Function Documentation): Remove gratuitous markup.
(Function Names): Move introductory text to `What Is a Function'.
(Defining Functions): Fix defun argument spec.
(Anonymous Functions): Document lambda macro explicitly.  Mention
effects on lexical binding.
(Function Cells): Downplay direct usage of fset.
(Closures): New node.
(Inline Functions): Remove "open-code" terminology.
(Declaring Functions): Minor tweak; .m is not C code.

* doc/emacs/variables.texi (Variables): Don't refer to "global value".
(Local Variables, Void Variables): Copyedits.
(Lexical Binding): Minor clarification of example.
(File Local Variables): Mention :safe and :risky defcustom args.
(Lexical Binding): Add xref to Closures node.
2012-02-04 22:56:32 +08:00
Mats Lidell
21f5018395 Update TUTORIAL.sv. 2012-01-25 14:12:10 +08:00
Chong Yidong
0b21c100be Tweak custom-variable-p and user-variable-p docs.
* lisp/custom.el (custom-variable-p): Doc fix.

* src/eval.c (Fuser_variable_p): Doc fix; mention custom-variable-p.
2012-01-25 13:48:11 +08:00
Chong Yidong
31cbea1d3d Update several Lisp manual chapters.
* doc/lispref/eval.texi (Intro Eval, Symbol Forms): Minor tweaks for
correctness with lexical scoping.
(Eval): Copyedits.

* doc/lispref/sequences.texi (Sequence Functions): Don't repeat the
introduction already given in the parent.
(Vectors): Copyedits.
(Rings): Move from lists.texi.  Note that this is specific to the
ring package.

* doc/lispref/lists.texi (Cons Cells): Copyedits.
(List Elements): Mention push.
(List Variables): Mention pop.
(Rings): Move to sequences.texi.

* doc/lispref/strings.texi (Text Comparison): Minor qualification.

* doc/lispref/symbols.texi (Definitions, Symbol Components): Mention variable
scoping issues.
(Plists and Alists): Copyedits.
2012-01-23 12:23:50 +08:00
Ognyan Kulev
7a22e70011 Update TUTORIAL.bg. 2012-01-21 22:58:38 +08:00
Primoz PETERLIN
6d0bd9ba72 Update Slovenian tutorial. 2012-01-17 22:16:42 +08:00
Chong Yidong
06848b82dc Update X Resources chapter of Emacs manual.
* doc/emacs/xresources.texi (X Resources): Describe GTK+ case first.
(Resources): Don't use borderWidth as an example, since it doesn't
work with GTK+.
(Table of Resources): Clarify role of several resources, including
the Emacs 24 behavior of cursorBlink etc.
(Face Resources): Node deleted.  Recommend using Customize
instead.  Add paragraph to `Table of Resources' node summarizing
how to use X resources for changing faces.
(Lucid Resources): Rewrite, omitting description of font names,
referring to the Fonts node instead.
(LessTif Resources): Copyedits.
(GTK resources): Rewrite, describing the difference between gtk2
and gtk3.
(GTK Resource Basics): New node.
(GTK Widget Names, GTK Names in Emacs): Rewrite.
(GTK styles): Just refer to Fonts node for GTK font format.

* doc/emacs/display.texi (Faces): Document the cursor face.
2012-01-15 23:26:39 +08:00
Eli Zaretskii
0dc18ae0ea Update the Hebrew tutorial.
etc/tutorials/TUTORIAL.he: Update to follow changes to TUTORIAL in
 2012-01-10T08:27:22Z!cyd@gnu.org.
 admin/FOR-RELEASE (Check the Emacs Tutorial): Mark TUTORIAL.he as
 updated and checked.
2012-01-14 13:23:45 +02:00
Chong Yidong
a73a3461db Update Emacs Invocation chapter of Emacs manual.
* doc/emacs/cmdargs.texi (Action Arguments): No need to mention
EMACSLOADPATH.
(General Variables): Add xref to Lisp Libraries.
(Initial Options): Copyedits.
(Resume Arguments): Node deleted; emacs.bash/csh are obsolete.
(Environment): Clarify what getenv does.
(General Variables): Clarify EMACSPATH etc.  Emacs does not assume
light backgrounds on xterms.
(Misc Variables): TEMP and TMP are not Windows-specific.
(Display X): Copyedits.
(Colors X): -bd does nothing for GTK.
(Icons X): Gnome 3 doesn't use taskbars.

* doc/emacs/misc.texi (Shell): Document exec-path here.

* doc/emacs/rmail.texi (Movemail): Add xref for exec-path.
2012-01-14 17:17:25 +08:00