GitLab

* 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.

* 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.

* 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.

* 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.

* 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.

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.

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.

* 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.

* 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.

* 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.

* 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.

* 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.

* 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.

* 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.

* doc/emacs/emerge-xtra.texi (Emerge, Submodes of Emerge, Combining in Emerge):
Small fixes.
* admin/FOR-RELEASE: Related markup.

* admin/FOR-RELEASE: Related markup.

* 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

* 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.

* 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.

* doc/emacs/ack.texi (Acknowledgments): Small changes, including resorting,
and removal of things no longer distributed.
* admin/FOR-RELEASE: Related markup.

* 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.

* 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.

* 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.

* admin/FOR-RELEASE: Related markup.

* doc/emacs/calendar.texi: Misc small changes, including updating the
dates of examples.

* admin/FOR-RELEASE: Related markup.

* 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.

* admin/FOR-RELEASE: Related markup.

* 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.

* 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

* 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.

Coding system changed to UTF-8.

* 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.

* 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.