Commit graph

108 commits

Author SHA1 Message Date
Paul Eggert
0e963201d0 Update copyright year to 2016
Run admin/update-copyright.
2016-01-01 01:34:24 -08:00
Eli Zaretskii
3323ee7ad0 Document how to avoid file-local variables that aren't
* doc/emacs/custom.texi (Specifying File Variables): Describe how
to prevent Emacs from interpreting unrelated text as file-local
variables.  (Bug#22166)
2015-12-19 12:37:49 +02:00
Eli Zaretskii
74646d1d1c Finalize documentation of 'custom-prompt-customize-unsaved-options'
* doc/emacs/custom.texi (Saving Customizations): Index the new
function 'custom-prompt-customize-unsaved-options'.

* etc/NEWS: Mention when 'custom-prompt-customize-unsaved-options'
is useful.
2015-11-28 15:43:07 +02:00
Artur Malabarba
d149ca81c3 * doc/lispref/variables.texi (Directory Local Variables):
Document dir-locals wildcards

* lisp/files.el (dir-locals-file): Point to Info node.

* doc/emacs/custom.texi (Directory Variables):
Document dir-locals wildcards.

* etc/NEWS: Document new functionality.
2015-11-10 14:45:50 +00:00
Eli Zaretskii
0d31eeb796 Avoid non-ASCII decoding errors in Texinfo files
* doc/misc/tramp.texi:
* doc/lispref/strings.texi:
* doc/lispref/positions.texi:
* doc/lispref/help.texi:
* doc/lispref/functions.texi:
* doc/lispintro/emacs-lisp-intro.texi:
* doc/emacs/text.texi:
* doc/emacs/modes.texi:
* doc/emacs/mini.texi:
* doc/emacs/display.texi:
* doc/emacs/custom.texi:
* doc/emacs/basic.texi: Add 'coding' cookies -- these files use
Unicode characters and should be decoded as UTF-8.
* doc/lispref/frames.texi (Size Parameters): Don't use a non-ASCII
apostrophe unnecessarily.
2015-09-25 12:32:13 +03:00
Paul Eggert
ef7dbdf587 Quote less in manuals
The manuals often used quotes ``...'' when it is better to use @dfn or
@code or capitalized words or no quoting at all.  For example, there is
no need for the `` and '' in “if a variable has one effect for
@code{nil} values and another effect for ``non-@code{nil}'' values”.
Reword the Emacs, Lisp intro, and Lisp reference manuals to eliminate
unnecessary quoting like this, and to use @dfn etc. instead when called
for (Bug#21472).
2015-09-15 08:48:44 -07:00
Paul Eggert
8a6260e1e1 Fix minor problems with " in manual 2015-09-04 13:32:18 -07:00
Glenn Morris
e84d1ca3c6 Minor doc copyedits
* doc/emacs/custom.texi (Init Examples): Tweak example, replace typo.

* doc/lispintro/emacs-lisp-intro.texi (condition-case): Typo fix.
2015-04-13 23:20:48 -07:00
Paul Eggert
4f08fb5aaa Minor quoting etc. fixes to Emacs manual
* doc/emacs/Makefile.in, doc/emacs/ack.texi, doc/emacs/building.texi:
* doc/emacs/calendar.texi, doc/emacs/cmdargs.texi:
* doc/emacs/custom.texi, doc/emacs/dired.texi, doc/emacs/emacs.texi:
* doc/emacs/files.texi, doc/emacs/glossary.texi, doc/emacs/gnu.texi:
* doc/emacs/indent.texi, doc/emacs/macos.texi:
* doc/emacs/maintaining.texi, doc/emacs/makefile.w32-in:
* doc/emacs/programs.texi, doc/emacs/rmail.texi:
* doc/emacs/search.texi, doc/emacs/trouble.texi:
* doc/emacs/vc1-xtra.texi:
Use American-style double quoting in ordinary text,
and quote 'like this' when single-quoting in ASCII text.
Also, fix some minor spacing issues.
2015-04-08 18:03:37 -07:00
Paul Eggert
d8e9122115 Merge from origin/emacs-24
e726f20 Handle "#" operator properly inside macro.  Fix coding bug.
618931b Handle dead frame in menu-bar-non-minibuffer-window-p.  (Bug#19728)
017a03a Document MS-Windows file-name idiosyncrasies  (Bug#19463)
f3faf4f Fix description of Customize buffer in Emacs manual.
1c1d0b7 Fix a typo in the Emacs manual's Hungry Delete description.
be7fb82 src/dispextern.h (FACE_FOR_CHAR): Fix the commentary.
33c4409 Spelling fixes
6c8231e python.el: Handle tabs in python-indent-dedent-line.
41c3b92 * lisp/progmodes/python.el: Respect user indentation after comment.
868df45 Avoid compiler warnings in decode_env_path.
b28c979 Fix XEmacs version typo in comment and ChangeLog
989fb32 Improve solution of bug #19701
6310530 Fix refilling of list of language environments in User Manual
c4c447d Restore XEmacs compatibility

Conflicts:
	doc/emacs/ChangeLog
	lisp/ChangeLog
	src/ChangeLog
	test/ChangeLog
2015-02-25 22:53:56 -08:00
Eli Zaretskii
f3faf4f027 Fix description of Customize buffer in Emacs manual.
doc/emacs/custom.texi (Customization Groups): Update the looks of the
 Customize Group buffer.
2015-01-31 18:05:38 +02:00
Paul Eggert
7e09ef09a4 Update copyright year to 2015
Run admin/update-copyright.
2015-01-01 14:26:41 -08:00
Paul Eggert
732fd4c7e1 Update copyright year to 2015
Run admin/update-copyright.
2015-01-01 09:18:06 -08:00
Cameron Desautels
4c4f970c8d Provide custom-prompt-customize-unsaved-options.
* doc/emacs/custom.texi (Saving Customizations): Mention
`custom-prompt-customize-unsaved-options'.

* etc/NEWS: Mention `custom-prompt-customize-unsaved-options'.

* etc/TODO: Remove its entry.

* lisp/cus-edit.el (custom-prompt-customize-unsaved-options): Add a
mechanism for prompting user about unsaved customizations.
(Bug#19328)
2014-12-14 06:51:17 -05:00
Juanma Barranquero
09b911adf4 Merge from emacs-24; up to 2014-05-01T10:21:17Z!rgm@gnu.org 2014-04-30 21:54:52 +02:00
Eli Zaretskii
119bf2f4b1 Few more doc fixes for bug #17362. 2014-04-29 18:17:02 +03:00
Eli Zaretskii
d7e9a7f87a Fix bug #17362 with inconsistent usage of @key and @kbd, and key names.
doc/emacs/trouble.texi (Quitting, DEL Does Not Delete, Emergency Escape)
 (Bug Criteria): Fix usage of @kbd and @key.  (Bug#17362)
 doc/emacs/text.texi (Words, Pages, Foldout, HTML Mode): Fix usage of @kbd
 and @key.
 doc/emacs/search.texi (Special Isearch, Regexp Search): Fix usage of @kbd
 and @key.
 doc/emacs/screen.texi (Echo Area, Menu Bar): Fix usage of @kbd and @key.
 doc/emacs/rmail.texi (Rmail Scrolling): Fix usage of @kbd and @key.
 doc/emacs/programs.texi (Hungry Delete, Other C Commands): Fix usage of
 @kbd and @key.
 doc/emacs/picture-xtra.texi (Insert in Picture): Fix usage of @kbd and
 @key.
 doc/emacs/mule.texi (Unibyte Mode, Bidirectional Editing): Fix usage of
 @kbd and @key.
 doc/emacs/msdog.texi (Windows Keyboard, Windows Processes): Fix usage of
 @kbd and @key.
 doc/emacs/msdog-xtra.texi (MS-DOS Keyboard, MS-DOS Printing)
 (MS-DOS Processes): Fix usage of @kbd and @key.
 doc/emacs/misc.texi (Shell Ring, Printing Package): Fix usage of @kbd and
 @key.
 doc/emacs/mini.texi (Completion Commands, Minibuffer History): Fix usage
 of @kbd and @key.
 doc/emacs/kmacro.texi (Keyboard Macro Step-Edit): Fix usage of @kbd and
 @key.
 doc/emacs/killing.texi (Deletion, Rectangles, CUA Bindings): Fix usage of
 @kbd and @key.
 doc/emacs/indent.texi (Indentation Commands): Fix usage of @kbd and @key.
 doc/emacs/help.texi (Help Mode, Misc Help): Fix usage of @kbd and @key.
 doc/emacs/glossary.texi (Glossary): Fix usage of @kbd and @key.
 doc/emacs/frames.texi (Speedbar): Fix usage of @kbd and @key.
 doc/emacs/files.texi (Misc File Ops, File Name Cache, File Conveniences)
 (Filesets): Fix usage of @kbd and @key.
 doc/emacs/display.texi (View Mode): Fix usage of @kbd and @key.
 doc/emacs/dired.texi (Image-Dired): Fix usage of @kbd and @key.
 doc/emacs/custom.texi (Modifier Keys, Function Keys, Named ASCII Chars)
 (Init Syntax): Fix usage of @kbd and @key.
 doc/emacs/commands.texi (User Input): Fix usage of @kbd and @key.
 doc/emacs/calendar.texi (Counting Days, General Calendar): Fix usage of
 @kbd and @key.
 doc/emacs/building.texi (Threads Buffer): Fix usage of @kbd and @key.
 doc/emacs/buffers.texi (Select Buffer, Icomplete): Fix usage of @kbd and
 @key.
 doc/emacs/basic.texi (Inserting Text, Erasing, Arguments): Fix usage of
 @kbd and @key.
2014-04-29 17:45:24 +03:00
Glenn Morris
95de732d84 Introduce `term-file-aliases', replacing some small lisp/term files
* lisp/faces.el (term-file-aliases): New variable.
(tty-run-terminal-initialization): Respect term-file-aliases.

* lisp/term/apollo.el, lisp/term/vt102.el, lisp/term/vt125.el:
* lisp/term/vt201.el, lisp/term/vt220.el, lisp/term/vt240.el:
* lisp/term/vt300.el, lisp/term/vt320.el, lisp/term/vt400.el:
* lisp/term/vt420.el: Remove files, replaced by aliases.

* lisp/term/README: Mention term-file-aliases.

* lisp/term/AT386.el, lisp/term/news.el, lisp/term/tvi970.el:
* lisp/term/vt100.el, lisp/term/wyse50.el: Remove obsolete comment.

* doc/emacs/custom.texi (Terminal Init): Mention term-file-aliases.

* doc/lispref/os.texi (Terminal-Specific): Mention term-file-aliases.

* etc/NEWS: Mention this.
2014-03-27 21:29:54 -04:00
Glenn Morris
4953b112b8 * doc/emacs/custom.texi: Typo fix. 2014-02-27 21:30:28 -08:00
Glenn Morris
98bd6b321c Doc updates related to tty-setup-hook
* doc/emacs/custom.texi (Terminal Init):
Replace term-setup-hook with tty-setup-hook.

* doc/lispref/display.texi (Window Systems):
* doc/lispref/hooks.texi (Standard Hooks):
Replace term-setup-hook with tty-setup-hook.

* doc/lispref/os.texi (Startup Summary, Init File, Terminal-Specific):
Replace term-setup-hook with tty-setup-hook, and update.

* doc/misc/edt.texi (Quick start, Starting emulation):
* doc/misc/efaq.texi (Fullscreen mode on MS-Windows)
(Terminal setup code works after Emacs has begun): Update hook details.

* doc/misc/vip.texi (Loading VIP): Fix hook example.

* lisp/faces.el (tty-setup-hook, tty-run-terminal-initialization): Doc fixes.

* lisp/startup.el (term-setup-hook): Doc fix.  Make obsolete.

* lisp/emulation/edt.el: Comment update.

* lisp/term/sun.el (sun-raw-prefix-hooks):
Use tty-setup-hook instead of term-setup-hook.
(terminal-init-sun): Construct message from bytecomp plist.

* lisp/term/wyse50.el (enable-arrow-keys): Doc fix.

* etc/refcards/vipcard.tex: Hook fix.

* etc/NEWS: Related edit.
2014-02-25 00:41:47 -08:00
Paul Eggert
ba3189039a Update copyright year to 2014 by running admin/update-copyright. 2014-01-01 07:43:34 +00:00
Xue Fuqiao
8715f5a6aa Remove unnecessary @refill. 2013-10-21 06:33:05 +08:00
Xue Fuqiao
64a695bd91 Doc fix.
* doc/emacs/custom.texi (Specifying File Variables): Fix cross-references.

* doc/emacs/mule.texi (Unibyte Mode): Fix cross-references.

* doc/lispref/nonascii.texi (Non-ASCII Characters): Update menu.
(Disabling Multibyte): Move here from doc/emacs/mule.texi.  Fix cross-references.

* doc/lispref/elisp.texi (Top): Update menu.
2013-07-31 20:59:10 +08:00
Glenn Morris
90ed99d54c * doc/emacs/custom.texi (Changing a Variable): Fix typo. 2013-05-06 23:43:34 -07:00
Glenn Morris
e17b97778d * doc/emacs/custom.texi (Directory Variables): Fix paren typo. 2013-01-17 20:53:34 -05:00
Glenn Morris
827253f738 * doc/emacs/custom.texi (Custom Themes): Fix typo. 2013-01-15 20:47:40 -05:00
Paul Eggert
ab422c4d68 Update copyright notices for 2013. 2013-01-01 09:11:05 +00:00
Paul Eggert
1df7defd80 Fix minor whitespace issues after "." in manual.
Be more systematic about using "@." (not ".") at end of sentence that
ends in a capital letter, and about appending "@:" after non-ends of
sentences that end in a lower case letter followed by "." followed by
whitespace.  Omit unnecessary use of "@:" and "@.".  Similarly for "?"
and "!".  Be more consistent about putting a comma after "i.e." and
"e.g."; this is the typical American style and it's easier to code in
Texinfo.

Fixes: debbugs:12973
2012-12-05 14:27:56 -08:00
Chong Yidong
547d686504 Document the conversion of kbd into a function.
* doc/emacs/custom.texi (Init Rebinding): kbd is now a function.

* doc/lispref/keymaps.texi (Key Sequences): kbd is now a function.

Fixes: debbugs:13052
2012-12-02 15:13:44 +08:00
Stefan Monnier
d106953274 Cleanup uses of "-hooks".
* doc/emacs/custom.texi (Hooks):
* doc/lispref/hooks.texi (Standard Hooks): Clarify that -hooks is deprecated.

* lisp/gnus/nndiary.el (nndiary-request-create-group-functions)
(nndiary-request-update-info-functions)
(nndiary-request-accept-article-functions):
* lisp/gnus/gnus-start.el (gnus-subscribe-newsgroup-functions):
* lisp/cedet/semantic/db-file.el (semanticdb-save-database-functions):
* lisp/cedet/semantic/lex.el (semantic-lex-reset-functions):
* lisp/cedet/semantic/edit.el (semantic-change-functions)
(semantic-edits-new-change-functions)
(semantic-edits-delete-change-functions)
(semantic-edits-reparse-change-functions):
* lisp/htmlfontify.el (hfy-post-html-hook):
* lisp/filesets.el (filesets-cache-fill-content-hook):
* lisp/arc-mode.el (archive-extract-hook):
* lisp/progmodes/cc-mode.el (c-prepare-bug-report-hook):
* lisp/net/rcirc.el (rcirc-sentinel-functions)
(rcirc-receive-message-functions, rcirc-activity-functions)
(rcirc-print-functions):
* lisp/net/dbus.el (dbus-event-error-functions):
* lisp/emacs-lisp/eieio.el (eieio-pre-method-execution-functions):
* lisp/emacs-lisp/checkdoc.el (checkdoc-style-functions)
(checkdoc-comment-style-functions): Don't use "-hooks" suffix.

* lisp/term/sun.el (sun-raw-prefix-hooks):
* lisp/mail/sendmail.el (mail-yank-hooks):
* lisp/mh-e/mh-letter.el (mh-yank-hooks): Use make-obsolete-variable.
2012-10-23 11:06:07 -04:00
Chong Yidong
35b6586e9d Manual fixes for frame-background-mode.
* doc/custom.texi (Face Customization): Move discussion of face
inheritance here, from Faces section.

* doc/display.texi (Faces): Document frame-background-mode.

* doc/lispref/display.texi (Defining Faces): Move documentation of
frame-background-mode to the Emacs manual (Bug#7774).
2012-08-05 17:24:55 +08:00
Chong Yidong
dea31bd311 Give permanent-local property to per-buffer variables without defaults.
* doc/emacs/custom.texi (Examining): Update C-h v message.

* lisp/bindings.el: Assign a non-nil permanent-local property to
per-buffer variables which lack a default value.

* lisp/help-fns.el (describe-variable): In the "automatically becomes
local" notice, take note of permanent-local variables.

Fixes: debbugs:11930
2012-07-13 22:25:59 +08:00
Chong Yidong
ab4c47d382 Add "site-lisp" to manual indices.
* custom.texi (Init File): Index site-lisp.

* doc/lispref/loading.texi (Library Search): Index site-lisp directories.

Fixes: debbugs:11435
2012-07-07 17:51:59 +08:00
Chong Yidong
41b7f8bc6c Merge changes from emacs-24; up to 2012-04-26T02:03:19Z!ueno@unixuser.org 2012-06-17 13:13:40 +08:00
Chong Yidong
84f4a53180 More minor manual copyedits to fix 7x9 manual underfull/overfull hboxes.
* doc/emacs/emacs.texi: Remove urlcolor setting.

* doc/lispref/elisp.texi, vol1.texi, vol2.texi: Remove urlcolor setting.

* doc/lispref/vol2.texi: Include package.texi.
2012-06-11 14:48:47 +08:00
Chong Yidong
166bc0c84e Emacs manual tweaks to accomodate 7x9 pdf.
* emacs.texi: Update ISBN and edition number.

* anti.texi:
* building.texi:
* cmdargs.texi:
* custom.texi:
* display.texi:
* files.texi:
* frames.texi:
* glossary.texi:
* misc.texi:
* mule.texi:
* programs.texi:
* sending.texi:
* text.texi: Copyedits to avoid underfull/overfull in 7x9 manual.
2012-06-10 22:02:52 +08:00
Michael Albinus
85973ba08b * custom.texi (Directory Variables): Mention enable-remote-dir-locals. 2012-06-06 16:57:16 +02:00
Glenn Morris
c1dabff00c * emacs/ack.texi, emacs/building.texi, emacs/calendar.texi
* emacs/custom.texi, emacs/maintaining.texi, emacs/text.texi:
* misc/calc.texi, misc/dired-x.texi:
Use @LaTeX rather than La@TeX.

Fixes: debbugs:10910
2012-05-28 16:35:09 -07:00
Chong Yidong
eceeb5fca6 Merge from emacs-24; up to 2012-04-20T05:47:55Z!eliz@gnu.org 2012-05-05 12:32:58 +08:00
Glenn Morris
d1714b9420 More page break tweaks for the manual
* doc/emacs/custom.texi (Customization Groups, Custom Themes, Examining):
Improve page breaks.
2012-05-03 00:23:27 -07:00
Glenn Morris
9eb25ee858 Reword some doc/emacs to remove/reduce some overly long/short lines.
* xresources.texi (Resources):
* mule.texi (Language Environments):
* misc.texi (Amusements):
* maintaining.texi (VC Change Log):
* frames.texi (Fonts):
* custom.texi (Specifying File Variables, Minibuffer Maps):
* cmdargs.texi (Initial Options):
* building.texi (Flymake):
Reword to remove/reduce some overly long/short lines.
2012-04-28 00:45:03 -07:00
Glenn Morris
16152b76a4 Use Texinfo recommended convention for quotes+punctuation. 2012-04-25 20:31:47 -04: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
Glenn Morris
8edb942b9f Doc and manual fixes related to mule
* doc/emacs/mule.texi (International): Copyedits.
(International Chars): Update C-x = example output.
(Disabling Multibyte): Rename from "Enabling Multibyte".
Clarify what "unibyte: t" does, and mode-line description.
(Unibyte Mode): Update for "Disabling Multibyte" node name change.
Use Texinfo recommended convention for quotes+punctuation.

* doc/emacs/custom.texi (Specifying File Variables):
Fix "unibyte" description.
Update for "Disabling Multibyte" node name change.

* doc/emacs/emacs.texi: Update for "Disabling Multibyte" node name change.

* doc/lispref/loading.texi (Loading Non-ASCII):
"unibyte:" can also be at the end.

* lisp/international/mule.el (set-auto-coding-for-load): Doc fix.
2012-04-11 21:09:15 -04:00
Glenn Morris
1c64e6ed6d In doc/emacs, use @file for buffers, per the Texinfo manual.
It renders the same as @samp, so there is no visible change in most cases.
2012-04-09 23:54:43 -07:00
Dani Moncayo
dc663c794c * doc/emacs/custom.texi (Changing a Variable): Fix example. 2012-04-02 12:18:06 +08:00
Glenn Morris
44e97401cd Standardize possessive apostrophe usage in manuals, docs, and comments
Ref: http://lists.gnu.org/archive/html/emacs-devel/2012-02/msg00649.html
2012-02-28 00:17:21 -08:00
Paul Eggert
27e428e758 Spelling fixes. 2012-01-09 22:20:22 -08:00
Chong Yidong
1de76afef2 * lisp/custom.el (custom-safe-themes): Use SHA-256 for hashing.
* doc/emacs/custom.texi (Custom Themes): Switched custom-safe-themes
to use SHA-256.
2012-01-09 15:48:51 +08:00
Chong Yidong
1de77c4c09 * doc/emacs/files.texi (Diff Mode): Discuss diff-auto-refine-mode.
* doc/emacs/custom.texi (Hooks): Discuss how to disable minor modes.

Fixes: debbugs:10309
2012-01-07 16:12:27 +08:00