1
0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2024-12-24 10:38:38 +00:00
Commit Graph

2764 Commits

Author SHA1 Message Date
Chong Yidong
20d2304d18 * doc/emacs/anti.texi (Antinews): Add Emacs 24 antinews. 2012-01-23 14:52:18 +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
Chong Yidong
fead402ddd Emacs Lisp manual updates.
* doc/lispref/intro.texi (A Sample Function Description): Special notation
used for macros too.

* doc/lispref/objects.texi (Ctl-Char Syntax, Other Char Bits): Copyedits.
(Symbol Type): Add xref for keyword symbols.
(Sequence Type): Clarify differences between sequence types.
(Cons Cell Type): Add "linked list" index entry.
(Non-ASCII in Strings): Copyedits.
(Equality Predicates): Symbols with same name need not be eq.

* doc/lispref/numbers.texi (Float Basics): Document isnan, copysign, frexp and
ldexp.  Move float-e and float-pi to Math Functions node.
2012-01-22 00:04:55 +08:00
Glenn Morris
61086eb66b Document inhibit-local-variables-regexps in the lispref.
* doc/lispref/modes.texi (Auto Major Mode):
* doc/lispref/variables.texi (File Local Variables):
Mention inhibit-local-variables-regexps.

* etc/NEWS: Markup.
2012-01-20 19:15:07 -08:00
Eric Hanchrow
02dc2fd7cb * tramp.texi (File): Tweak wording for the `scpc' option. 2012-01-20 21:12:38 +01:00
Juanma Barranquero
1ef1768148 doc/lispref/emacs-lisp-intro.texi (count-words-in-defun): Fix bug#10544. 2012-01-19 16:04:24 +01:00
Martin Rudalics
34a02f46dc Fix handling of persistent window parameters.
* window.c (save_window_save, Fcurrent_window_configuration)
(Vwindow_persistent_parameters): Do not use Qstate.  Rewrite
doc-strings.
* window.el (window--state-get-1, window-state-get): Do not use
special state value for window-persistent-parameters.  Rename
argument IGNORE to WRITABLE.  Rewrite doc-string.
(window--state-put-2): Reset all window parameters to nil before
assigning values of persistent parameters.
* windows.texi (Window Configurations): Rewrite references to
persistent window parameters.
(Window Parameters): Fix description of persistent window
parameters.
2012-01-19 11:38:31 +01:00
Glenn Morris
7b4b130107 * doc/lispintro/emacs-lisp-intro.texi (re-search-forward): Fix typo. 2012-01-17 17:31:07 -05:00
Juanma Barranquero
f5064caef2 doc/lispref/windows.texi (Window Parameters): Use @pxref. 2012-01-16 18:00:33 +01:00
Volker Sobek
01ec1eed4e * doc/emacs/programs.texi (Comment Commands): Typo.
Fixes: debbugs:10514
2012-01-16 11:00:08 -05:00
Martin Rudalics
6a6ee00d12 Provide persistent window parameters.
* window.c (Vwindow_persistent_parameters): New variable.
(Fset_window_configuration, save_window_save): Handle persistent
window parameters.

* window.el (window-state-ignored-parameters): Remove variable.
(window--state-get-1): Rename argument MARKERS to IGNORE.
Handle persistent window parameters.  Make copy of clone-of
parameter only if requested.  (Bug#10348)
(window--state-put-2): Install a window parameter only if it has
a non-nil value or an existing parameter shall be overwritten.

* windows.texi (Window Configurations, Window Parameters):
Describe persistent window parameters.
2012-01-16 10:34:41 +01: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
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
Glenn Morris
e517eda4d0 find-ls-option doc fixes (bug#10262)
* doc/emacs/dired.texi (Dired and Find): Clarify find-ls-options.
* lisp/find-dired.el (find-ls-option): Doc fix.
2012-01-12 21:32:07 -05:00
Paul Eggert
1165ec6e4b Doc punctuation fixes. 2012-01-12 13:52:31 -08:00
Paul Eggert
5a5fa83428 Duplicate-word and spelling fixes. 2012-01-10 22:53:12 -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
6a43ef8e85 Merge changes from emacs-23 branch 2012-01-09 13:29:45 +08:00
Chong Yidong
e490b28922 Document Whitespace mode in manual, plus its use in Diff mode.
* doc/emacs/display.texi (Useless Whitespace): Add Whitespace mode.

* doc/emacs/files.texi (Diff Mode): Discuss use of Whitespace mode.

Fixes: debbugs:10300
2012-01-07 16:55:43 +08:00
Chong Yidong
9858c69b83 Fix last change. 2012-01-07 16:14:45 +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
Lars Magne Ingebrigtsen
d027f83d9c * macros.texi (Defining Macros): Document `doc-string'.
Fixes: debbugs:9668
2012-01-07 06:48:06 +01:00
Chong Yidong
c61ab18c89 Update Lossage chapter of Emacs manual.
* doc/emacs/trouble.texi (Lossage): Refer to Bugs node for problems.
(DEL Does Not Delete): Don't use "usual erasure key" teminology.
(Screen Garbled): Don't refer to terminal "manufacturers".
(Total Frustration): Node deleted.  Eliza is documented in
Amusements now.
(Known Problems): More info about using the bug tracker.  Mention
debbugs package.
(Bug Criteria): Copyedits.
(Understanding Bug Reporting): Mention emacs -Q.
2012-01-07 11:15:48 +08:00
Gnus developers
e7719ea1b2 Merge changes made in Gnus trunk.
2012-01-06  Lars Magne Ingebrigtsen  <larsi@gnus.org>
  * gnus.texi (Group Parameters): Really note precedence.
2012-01-07  Lars Magne Ingebrigtsen  <larsi@gnus.org>
  * mm-decode.el (mm-interactively-view-part): Use `completing-read',
  since ido doesn't work on symbols (bug#9632).
  * gnus.el (gnus-group-fast-parameter): Use the same precedence rules
  when getting a single value as when getting all the values.  This means
  that atoms like `gcc-self' work cumulatively, like variable settings,
  instead of getting the value from the last matching clause.
  (gnus-group-find-parameter): Protect against the group buffer not
  existing (bug#9585).
2012-01-06  Lars Magne Ingebrigtsen  <larsi@gnus.org>
  * gnus-start.el (gnus-activate-group): Document more parameters
  (bug#9694).
  * gnus-group.el (gnus-group-read-ephemeral-group): Doc clarification
  (bug#9692).
  * gnus-agent.el (gnus-agent-store-article): Tell the Agent when the
  article was fetched, so that it can be expired later (bug#9958).
  (gnus-agent-summary-fetch-series): Add doc string.
  (gnus-agent-summary-fetch-group): Don't remove tick and dormant marks
  (bug#9517).
  * nntp.el (nntp-retrieve-groups): Refuse to do retrieval when an async
  retrieval is happening.
  * gnus.el (gnus-parameters): Doc fix.
2012-01-06  Dave Abrahams  <dave@boostpro.com>  (tiny change)
  * gnus-sum.el (gnus-summary-refer-thread): If the subtree is hidden,
  show the thread after expansion.
2012-01-06  Lars Magne Ingebrigtsen  <larsi@gnus.org>
  * gnus-art.el (article-narrow-to-head): If the head is completely
  empty, narrow to the empty region (bug#9764).
  * gnus-sum.el (gnus-summary-mark-article-as-unread): Mark articles as
  read, and then mark them as unread only when the unread mark is used.
  This makes `C-- T k' actually work, even though it's confusing.
  * gnus-win.el (gnus-all-windows-visible-p): Ensure that the buffer is
  alive before we try to find its window.
2012-01-06  Brian Sniffen  <bsniffen@akamai.com>  (tiny change)
  * mm-decode.el (mm-display-external): Use a longer timeout for the
  deletion to allow slow programs to display the file.
2012-01-06  Lars Magne Ingebrigtsen  <larsi@gnus.org>
  * gnus-art.el (gnus-article-browse-delete-temp-files): Fix up the
  prompt to be less confusing.
2012-01-07 01:13:52 +00:00
Chong Yidong
89bd9ccd5b More customization-related documentation updates.
* doc/emacs/custom.texi (Specifying File Variables): The mode: keyword
doesn't have to be first anymore.  Add example of specifying minor
modes.
(Directory Variables): Simplify example.  Mention application to
non-file buffers.
(Disabling): Use "initialization file" terminology.
(Init Examples): Fix hook example.

* doc/lispref/variables.texi (Directory Local Variables): Document
hack-dir-local-variables-non-file-buffer.

* lisp/files.el (hack-dir-local-variables-non-file-buffer): Add doc.
(hack-one-local-variable-eval-safep): Allow 0 arg for minor mode
functions, along with 1 and -1.
2012-01-06 18:53:41 +08:00
Eli Zaretskii
8034735f6f Fix bug #10422 with Registry-related index entries.
doc/emacs/cmdargs.texi (MS-Windows Registry): Shorten the index entry.
 Move the stuff about resources to xresources.texi.
 doc/emacs/xresources.texi (Resources): Move information about setting X
 resources in the Registry from cmdargs.texi.  Make the index entry
 be similar to the one in cmdargs.texi.
2012-01-06 12:17:23 +02:00
Glenn Morris
c869783d91 Change the binding of "e" in info-mode.
* doc/lispref/maps.texi (Standard Keymaps): Refer to Info-edit by name
rather than by keybinding.

* lisp/info.el (Info-mode-map): Bind e to end-of-buffer, rather
than Info-edit.

Fixes: debbugs:10385
2012-01-06 00:10:22 -08:00
Chong Yidong
b0d7d8af07 Update the Customization chapter of Emacs manual.
* doc/emacs/custom.texi (Customization Groups): Update example.
(Browsing Custom): Document the new search field.
(Changing a Variable): Update example for Emacs 24 changes.
Document Custom-set and Custom-save commands.
(Face Customization): Document Emacs 24 changes.  De-document
modify-face.
(Specific Customization): Mention customize-variable.
(Custom Themes): Add customize-themes, custom-theme-load-path,
custom-theme-directory, and describe-theme.
(Creating Custom Themes): New node.
(Examining): Mention M-:.

* doc/emacs/package.texi (Packages): Fix typo.
2012-01-05 19:09:27 +08:00
Glenn Morris
acaf905b11 Add 2012 to FSF copyright years for Emacs files 2012-01-05 01:46:05 -08:00
Glenn Morris
7497ef13c9 Convert some consecutive FSF copyright years to ranges; add 2012. 2012-01-05 01:44:36 -08:00
Gnus developers
9937bef4b8 Merge changes made in Gnus trunk.
2012-01-04  Lars Magne Ingebrigtsen  <larsi@gnus.org>
 * gnus.texi (Group Parameters): Note precedence.
2012-01-04  Chris Gray  <chrismgray@gmail.com>  (tiny change)
 * mm-decode.el (mm-shr): Check that `gnus-summary-buffer' really is a
 live buffer.
2012-01-04  Lars Magne Ingebrigtsen  <larsi@gnus.org>
 * nnir.el (nnir-retrieve-headers): Protect against the article not
 existing on the server (bug#10335).
2012-01-04  Wolfgang Jenkner  <wjenkner@inode.at>  (tiny change)
 * gnus-agent.el (gnus-agent-load-local): Recompute
 gnus-agent-article-local on changing method.
2012-01-04  Lars Magne Ingebrigtsen  <larsi@gnus.org>
 * gnus.el (gnus-parameters): Note precedence.
2012-01-04  Leo  <sdl.web@gmail.com>
 * nndraft.el (nndraft-update-unread-articles): Don't move point around
 in the group buffer.
2012-01-04 22:14:09 +00:00
Bastien Guerry
e66ba1dfc4 Merge Org 7.8.03 2012-01-03 18:27:21 +01:00
Chong Yidong
88c5c7c831 More updates to misc.texi.
* doc/emacs/misc.texi (Single Shell): Don't document Lisp usage of
shell-command.  Tidy up discussion of synchronicity.  Add index
entries for async-shell-command.
(Interactive Shell): Note that M-x shell uses shell-file-name.
Note change in behavior in Emacs 24.
(Shell Mode): Shell mode now uses completion-at-point.
(Shell Prompts): Emphasize that comint-use-prompt-regexp isn't the
default method for recognizing prompts nowadays.
(Shell Ring): Add xref to Minibuffer History.
(Directory Tracking): Explain Dirtrack mode in more detail.
(Term Mode): Fix index entries.
(Paging in Term): Merge into Term Mode.
(Serial Terminal, Emacs Server, emacsclient Options): Copyedits.
(Printing): Fix xref.  State default of lpr-switches.
(PostScript): Remove obsolete sentence.  Omit description of
non-interactive behaviors.
(Hyperlinking): Improve description.
(Browse-URL): Using compose-mail for mailto URLs is the default.
Document browse-url-mailto-function.
(Goto Address mode): Add index entries.  Add xref to Browse-URL.
(FFAP): FFAP is not a minor mode.
(Amusements): M-x lm was renamed to M-x landmark.  Document
nato-region.
2012-01-03 16:55:00 +08:00
Chong Yidong
b8ecfdfefb Updates to misc.texi in Emacs manual.
* misc.texi (Gnus, Buffers of Gnus): Copyedits.
(Gnus Startup): Note that the system might not be set up for news.
Describe group levels more clearly.
(Gnus Group Buffer, Gnus Summary Buffer): New nodes, split from
Summary of Gnus.
(Document View): Copyedits.  Move zoom commads to DocView
Navigation node.
(DocView Navigation, DocView Searching, DocView Slicing)
(DocView Conversion): Nodes renamed from Navigation, etc.

* sending.texi (Mail Sending): Add message-kill-buffer-on-exit.
2012-01-01 16:21:38 +08:00
Eli Zaretskii
7bc7d2aa1b Fix bug #10380 with description of C-n and C-p.
doc/emacs/basic.texi (Moving Point): Fix the description of C-n and C-p.
2011-12-31 13:33:09 +02:00
Paul Eggert
22bcf20469 Spelling fixes. 2011-12-30 17:27:15 -08:00
Chong Yidong
b30941dba0 Update Sending Mail chapter of Emacs manual.
* sending.texi (Sending Mail): Document initial mail buffer name,
and changed multiple mail buffer behavior.
(Mail Format): Put the example at the top of the section.
(Mail Headers): Move discussion of "From" to the top.
(Mail Sending): Document sendmail-query-once.
(Citing Mail): Make it less Rmail-specific.
2011-12-30 18:19:42 +08:00
Paul Eggert
9858f6c326 Spelling fixes. 2011-12-29 18:52:49 -08:00
Juanma Barranquero
2cae5ba432 doc/lispref/frames.texi (Font and Color Parameters): Add @pxref. 2011-12-29 19:08:46 +01:00
Daniel Colascione
43da4d0843 doc/lispref/frames.texi: Document w32 font backends (bug#10399). 2011-12-29 17:20:26 +01:00
Chong Yidong
0ed49f9399 Cleanups for the new Org section in the Emacs manual.
* doc/emacs/text.texi (Org Mode): Copyedits.  Refer to Outline Format for
example.  Add index entries.
(Org Organizer, Org Authoring): Nodes renamed.  Copyedits.
2011-12-29 23:58:42 +08:00
Paul Eggert
8d80ef01d9 doc: Use clearer notations for permissions.
* doc/lispref/files.texi (File Attributes, Changing Files):
Use a more-natural notation for octal numbers.
* doc/misc/gnus.texi (Mail Source Customization, Mail Back End Variables):
Use octal notation for file permissions, which are normally
thought of in octal.
(Mail Back End Variables): Use more-plausible modes in example.
2011-12-27 22:59:21 -08:00
Stefan Monnier
9ca4c014c8 * variables.texi (Creating Buffer-Local): Warn against misuses of
make-variable-buffer-local.

Fixes: debbugs:10258
2011-12-27 18:48:53 -05:00
Chong Yidong
c40a7de781 Update Abbrevs and Dired chapters of Emacs manual.
* dired.texi (Dired Enter, Misc Dired Features): Document
dired-use-ls-dired changes.  Mention quit-window.
(Dired Navigation): Add index entries.
(Dired Visiting): Fix View Mode xref.
(Marks vs Flags): Prefer C-/ binding for undo.
(Subdirectories in Dired): Add xrefs.
(Misc Dired Features): Document some Emacs 24 changes.  Add index
entries.

* abbrevs.texi (Abbrev Concepts): No need to mention abbrev-mode
variable, since it is explained in Minor Modes node.
(Defining Abbrevs): Copyedits.
(Expanding Abbrevs): State default of abbrev-all-caps.  Prefer the
C-/ binding for undo.
(Dabbrev Customization): Add xrefs for case-fold-search and
case-replace.

* dired-xtra.texi (Subdir Switches): Add xref.

* maintaining.texi (VC Directory Commands): Mention quit-window.
2011-12-26 18:36:41 +08:00
Chong Yidong
3d992aa070 More updates to Maintaining chapter of Emacs manual.
* files.texi (Misc File Ops): Mention vc-delete-file.

* maintaining.texi (Tags): Mention Semantic.
(Create Tags Table, Etags Regexps): Copyedits.
(Find Tag): Mention minibuffer completion.
(List Tags): Mention completion-at-point.  Completion is actually
available in M-x list-tags.

* programs.texi (Symbol Completion): Mention completion-at-point
explicitly.

* vc1-xtra.texi (VC Delete/Rename): Rename from Renaming and VC.
Document vc-delete-file.
2011-12-25 22:16:00 +08:00
Juanma Barranquero
9022ae07ee Fix bug#10354.
* doc/lispref/variables.texi (Variables with Restricted Values):
  Change reference to variable.
2011-12-23 14:14:12 +01:00
Juri Linkov
db7ab02fe1 Small doc fixes. 2011-12-23 01:30:10 +02:00
Chong Yidong
2785d02431 More updates for VC documentation.
* doc/emacs/vc1-xtra.texi (Version Headers): Note that these are for
Subversion, CVS, etc. only.
(General VC Options): De-document vc-keep-workfiles.  Fix RCS-isms.

* doc/emacs/maintaining.texi (Change Log Commands): Don't specially mention
vc-update-change-log which is CVS-only.
2011-12-22 18:14:41 +08:00
Eli Zaretskii
0ab393996c doc/emacs/building.texi (Debugger Operation): Fix a typo in "@end iftex". 2011-12-22 05:56:49 +02:00