Merge branch 'dynamic-docstrings' into trunk

* lisp/emacs-lisp/eieio*.el: Use (:documentation ...) feature

* lisp/emacs-lisp/eieio-compat.el (eieio--defmethod): Use new
special (:documentation ...) feature.
* lisp/emacs-lisp/eieio-core.el (eieio-make-class-predicate)
(eieio-make-child-predicate): Same.
(eieio-copy-parents-into-subclass): Remove unused arg.
(eieio-defclass-internal): Adjust call accordingly and remove redundant
`pname' var.
(eieio--slot-name-index): Remove unused arg `obj' and adjust all
callers accordingly.

Add (:documentation <form>) for dynamically-generated docstrings

* lisp/emacs-lisp/bytecomp.el:
(byte-compile-initial-macro-environment): Use macroexp-progn.
(byte-compile-cl-warn): Don't silence use of cl-macroexpand-all.
(byte-compile-file-form-defvar-function): Rename from
byte-compile-file-form-define-abbrev-table.
(defvaralias, byte-compile-file-form-custom-declare-variable): Use it.
(byte-compile): Use byte-compile-top-level rather than
byte-compile-lambda so we can compile non-values.
(byte-compile-form): Add warnings for failed uses of lexical vars via
quoted symbols.
(byte-compile-unfold-bcf): Improve message for failed inlining.
(byte-compile-make-closure): Handle new format of internal-make-closure
for dynamically-generated docstrings.

* lisp/emacs-lisp/cconv.el (cconv--convert-function):
Add `docstring' argument.
(cconv-convert): Use it to handle the new (:documentation ...) form.
(cconv-analyze-form): Handle the new (:documentation ...) form.

* src/eval.c (Ffunction): Handle the new (:documentation ...) form.
(syms_of_eval): Declare `:documentation'.

help-fns.el (describe-function-or-variable): New function on `C-h o'

* doc/misc/auth.texi (Multiple GMail accounts with Gnus): Markup fix.

* lisp/emulation/viper.el: A couple of docstring format tweaks

* lisp/delsel.el: Deprecate the `kill' option.  Use lexical-binding.

(open-line): Delete like all other commands, instead of killing.
(delete-active-region): Don't define any return any value.

* lisp/doc-view.el: Add some comments about desktop support

Remove recently added BUFFER arg of `window-text-pixel-size'.

* xdisp.c (Fwindow_text_pixel_size): Remove optional BUFFER
argument added on 2015-02-01.
* display.texi (Size of Displayed Text): Remove description of
optional argument BUFFER of `window-text-pixel-size'.

lisp/gnus/gnus-start.el: always check newsrc timestamp when saving it

doc/misc/auth.texi (Multiple GMail accounts with Gnus): Add FAQ

lisp/gnus/mail-source.el (mail-source-call-script): Pop up an error buffer if a mail script fails

lisp/gnus/gnus-sum.el (gnus-extra-headers): Add X-GM-LABELS

doc/misc/ChangeLog: Add missing entry

lisp/gnus/nnimap.el (nnimap-request-group-scan): Further `M-g' group fixes

[Gnus] Make `M-g' in the group buffer work again

* gnus-int.el (gnus-request-group-scan): Use the correct function name.
* nnimap.el (nnimap-request-group-scan): Fix the function name.

etc/GNUS-NEWS: Nore X-GM-LABELS

doc/misc/gnus.texi (Support for IMAP Extensions): Document Gmail labels

lisp/gnus/gnus-sum.el (gnus-select-newsgroup): nnimap group selection fix

* lisp/progmodes/python.el: Preserve compatibility with Emacs-24

(python-mode): Don't assume eldoc-documentation-function has a non-nil
default.

Avoid the error when computing top-level indentation.

* lisp/progmodes/python.el (python-indent-calculate-indentation):
Do not apply max to an empty list

* lisp/emacs-lisp/cl-generic.el (cl--generic-member-method): Fix paren typo.

* lisp/gnus/mm-util.el (mm-with-unibyte-current-buffer): Don't emit a warning.

We already get an obsolescence message.  Use `declare'.

* lisp/textmodes/flyspell.el: Use lexical-binding and cl-lib.

(mail-mode-flyspell-verify): Fix last change.
(flyspell-external-point-words, flyspell-large-region):
Avoid add-to-list on local vars.

Fix typo causing a void-variable error: pkg-desc

* emacs-lisp/package.el (package-installed-p): Fix typo causing
void-variable error.

* lisp/cedet: Use cl-generic instead of EIEIO's defgeneric/defmethod

* lisp/cedet/**/*.el: Mechanically replace all calls to defmethod/defgeneric
by calls to cl-defmethod/cl-defgeneric.
* lisp/cedet/srecode/table.el:
* lisp/cedet/srecode/fields.el:
* lisp/cedet/srecode/dictionary.el:
* lisp/cedet/srecode/compile.el:
* lisp/cedet/semantic/debug.el:
* lisp/cedet/semantic/db-ref.el:
* lisp/cedet/ede/base.el:
* lisp/cedet/ede/auto.el:
* lisp/cedet/ede.el: Require `cl-generic'.

emacs-lisp/package.el (package-reinstall): Accept package-desc objects.

emacs-lisp/package.el (package-install): Mark dependencies as selected.

In particular, when given a package-desc object which is already
installed, the package is not downloaded again.

emacs-lisp/package.el (package-delete): Always unselect package.

lisp/gnus/nnir.el: Revert "Enable non-ASCII IMAP searches"

Remove no-longer-used two_byte_p calculations

* dispextern.h (struct glyph_string): Remove member two_byte_p.
All uses removed.
* xdisp.c (get_glyph_face_and_encoding): Remove arg two_byte_p.
All callers changed.

* texinfo.tex: Update from gnulib.

* .gitattributes: Ignore blanks at EOL in texinfo.tex.

emacs-lisp/package.el (package--read-pkg-desc): Fix tar-desc reference.

emacs-lisp/package.el (package-menu-execute): Offer to remove packages.

emacs-lisp/package.el (package-desc-status): Add "dependency" status to Package Menu.

emacs-lisp/package.el (package--user-selected-p): New function.

Populates `package-selected-packages' if necessary, and then checks if
symbol PKG is contained in it.

automated/package-test.el (package-test-get-deps): New test.

emacs-lisp/package.el (package--get-deps): delete-dups when ONLY is nil.

emacs-lisp/package.el (package-delete): Document NOSAVE.

emacs-lisp/package.el (package-reinstall): Don't change selected status.

NEWS: Document package.el's improved dependency-handling.

Further work on suppressing shell history in Tramp

Fixes: debbugs:19731
* net/tramp-sh.el (tramp-histfile-override): Fix docstring.
(tramp-open-shell, tramp-maybe-open-connection): Set also
HISTFILESIZE and HISTSIZE when needed.

Omit unnecessary var if GTK or NS

* frame.c, frame.h (frame_default_tool_bar_height) [USE_GTK||HAVE_NS]:
Now a constant zero on these platforms.

* net/tramp-sh.el (tramp-histfile-override): Use t instead of `unset'.

* net/tramp-sh.el (tramp-histfile-override): Use `unset' as default.

emacs-lisp/package.el (package--get-deps): Fix returning duplicates.

emacs-lisp/package.el (package-menu-execute): Clean unnecessary `and'.

Fix last tramp-sh.el commit

emacs-lisp/package.el (package-initialize): Populate `package-selected-packages'.

Tramp: Support unsetting HISTFILE.

Fixes: debbugs:19731
* lisp/net/tramp-sh.el (tramp-histfile-override): Add another choice 'unset.
(tramp-open-shell, tramp-maybe-open-connection): Support it.

emacs-lisp/package.el: Fix previous patch

emacs-lisp/package.el: Many style changes

package.el (package--get-deps): Fix for indirect dependencies.

emacs-lisp/package.el (package-install): Rename ARG to MARK-SELECTED.

emacs-lisp/package.el (package-selected-packages): Fix :type

emacs-lisp/package.el: Don't allow deleting dependencies.

Give `window-text-pixel-size' optional BUFFER argument.

[This reinstalls commit 1d1162479caf1fdf48564f1486fa84e3cdacaa9b,
which I mistakenly reverted.  --eggert]
* xdisp.c (Fwindow_text_pixel_size): Add optional argument BUFFER.
* display.texi (Size of Displayed Text): Describe optional
argument BUFFER of `window-text-pixel-size'.

Revert changes installed by xwidgets merge

Give `window-text-pixel-size' optional BUFFER argument.

* xdisp.c (Fwindow_text_pixel_size): Add optional argument BUFFER.
* display.texi (Size of Displayed Text): Describe optional
argument BUFFER of `window-text-pixel-size'.

configure.ac: Fix a typo.

# Auto-commit of loaddefs files.

Better changelog for xwidgets

NEWS entry and Changelog xwidgets

Merge branch 'master' into xwidget

Fix compile warnings xwidget.el

Fix for crash when displaying xwidget in a tty

Xwidgets are now handled the same as images in the tty case,
they are ignored.

Avoid aborts when keyboard-coding-system is raw-text  (Bug#19532)

 src/coding.c (raw_text_coding_system_p): New function.
 src/keyboard.c (read_decoded_event_from_main_queue): Use it when the
 keyboard coding-system is 'raw-text'.
 src/coding.h (raw_text_coding_system_p): Add prototype.

Don't reimplement move-if-change badly

* Makefile.in (gl-stamp): Generate globals.h through the use of
move-if-change.
(globals.h): Replace with empty command.

Fix while-no-input loops  (Bug#19547)

 src/keyboard.c (kbd_buffer_store_event_hold): Ignore FOCUS_OUT_EVENT
 and ICONIFY_EVENT for the purposes of breaking while-no-input
 loops.

Fix last commit, which confused WINDOWSNT with MSDOS.

 src/dired.c (read_dirent): Correct the "MSDOS hacks" hack: the
 special code for errno = ENOENT or EACCES is needed for WINDOWSNT,
 not for MSDOS.

Simplify read_dirent's MSDOS hacks

* dired.c (read_dirent): Simplify by removing the need for the
DIR_ENTRY argument.  All callers changed.  This separates the
MS-DOS idiosyncrasies better from the rest of the code.

EIEIO: Simplify help hyperlinks; Try and reduce hardcoding in .elc

* lisp/emacs-lisp/cl-generic.el (cl--generic-search-method): Fix regexp.

* lisp/emacs-lisp/eieio-core.el (eieio--check-type): Remove.
Use cl-check-type everywhere instead.
(eieio-class-object): Remove, use find-class instead when needed.
(class-p): Don't inline.
(eieio-object-p): Check more thoroughly, so we don't treat cl-structs,
such as eieio classes, as objects.  Don't inline.
(object-p): Mark as obsolete.
(eieio-defclass-autoload, eieio-defclass-internal, eieio-oref)
(eieio--generic-tagcode): Avoid `class-p'.
(eieio-make-class-predicate, eieio-make-child-predicate): New functions.
(eieio-defclass-internal): Use current-load-list rather than
`class-location'.

* lisp/emacs-lisp/eieio-opt.el (eieio-help-class, eieio-help-constructor):
Use find-lisp-object-file-name, help-fns-short-filename and new calling
convention for eieio-class-def.
(eieio-build-class-list): Remove function, unused.
(eieio-method-def): Remove button type, unused.
(eieio-class-def): Inherit from help-function-def.
(eieio--defclass-regexp): New constant.
(find-function-regexp-alist): Use it.
(eieio--specializers-apply-to-class-p): Handle eieio--static as well.
(eieio-help-find-method-definition, eieio-help-find-class-definition):
Remove functions.

* lisp/emacs-lisp/eieio.el (defclass): Use new eieio-make-class-predicate
and eieio-make-child-predicate.
(eieio-class-parents): Use eieio--class-object.
(slot-boundp, find-class, eieio-override-prin1): Avoid class-p.
(slot-exists-p): Use find-class.

* test/automated/eieio-tests.el (eieio-test-23-inheritance-check): Simplify.

* lisp/emacs-lisp/backquote.el: Fix bug with unoptimized exp.

Fixes: debbugs:19734
* lisp/emacs-lisp/backquote.el (backquote-delay-process): Don't reuse `s'
since it may be "equivalent" in some sense, yet different.
* test/automated/core-elisp-tests.el (core-elisp-tests-3-backquote): New test.

lisp/outline.el: Improve docstrings.

lisp/outline.el: Add namespace prefixes.

* outline.el (outline-hide-entry): Rename from `hide-entry'.
(outline-show-entry): rename from `show-entry'
(outline-hide-body): Rename from `hide-body'.
(outline-hide-region-body): Rename from `hide-region-body'.
(outline-show-all): Rename from `show-all'.
(outline-hide-subtree): Rename from `hide-subtree'.
(outline-hide-leaves): Rename from `hide-leaves'.
(outline-show-subtree): Rename from `show-subtree'.
(outline-hide-sublevels): Rename from `hide-sublevels'.
(outline-hide-other): Rename from `hide-other'.
(outline-show-children): Rename from `show-children'.
(outline-show-branches): Rename from `show-branches'.

lisp/outline.el (outline-mode): Clean up docstring

* lisp/outline.el (font-lock-warning-face): Remove unused declare.
(outline-mode-prefix-map): Remove obsolete comment.
(outline-font-lock-face): Remove obsolete comment.

lisp/custom.el (defface): Set indent to 1.

lisp/emacs-lisp/easy-mmode.el (define-minor-mode): Set `indent' to 1.

files.el: avoid asking whether to kill Emacs multiple times

* lisp/files.el (save-buffers-kill-emacs): If `confirm-kill-emacs' is
set, but user has just been asked whether they really want to kill Emacs
(for example with a ‘Modified buffers exist; exit anyway?’ prompt) , do
not ask them for another confirmation.

Tweak recent gnus-registry.el changes

Ref: http://lists.gnu.org/archive/html/emacs-devel/2014-12/msg01748.html

* lisp/gnus/gnus-registry.el (gnus-registry-max-pruned-entries)
(gnus-registry-prune-factor, gnus-registry-default-sort-function):
Fix :version.
(gnus-registry-default-sort-function): Improve :type.

# ChangeLog fix
That's not the right format for multi-file changes,
and such things don't need ChangeLog entries anyway.

# ChangeLog fix
If you revert a change a few days after making it,
don't delete the ChangeLog entry.

# ChangeLog fixes
Merged ChangeLog entries go to the top, with the date of the merge.
It's a simple rule.

Fix error messages when readdir cannot open a directory on MS-Windows

 src/dired.c (read_dirent): Accept an additional argument
 FIRST_ENTRY.  If readdir fails with ENOENT or EACCES the first
 time it is called, report the error as if it happened in
 open_directory.
 (directory_files_internal, file_name_completion): Adjust callers
 or read_dirent.

Spelling fix

Refactor calls to opendir for simplicity

* dired.c (open_directory): Accept Lisp_Object, not char *, for
dirname.  Signal an error if the open fails.  All callers changed.

Merge branch 'master' of git.sv.gnu.org:/srv/git/emacs

Splash images refurbished

Report readdir failures

Previously, on non-MS-Windows platforms the code treated most
readdir failures as EOF.  This was incorrect, e.g., when readdir
fails with errno == EOVERFLOW.  Signal an error instead.
* dired.c (read_dirent):
New function, which signals an error when readdir fails.
(directory_files_internal, file_name_completion): Use it.

Merge from origin/emacs-24

ad588af Improve the fix for bug #19701

Conflicts:
src/ChangeLog

Merge from origin/emacs-24

The following commit was skipped:

ba10f4b Fix issues with BibTeX entries containing ")".

Commit src/ChangeLog for previous commit.

Use bool for boolean in w32menu.c, w32font.c, w32uniscribe.c.

 src/w32uniscribe.c (uniscribe_list, uniscribe_match): Use bool where
 appropriate.
 src/w32font.c (struct font_callback_data, w32font_list_internal)
 (w32font_driver, w32font_match_internal): Use bool where appropriate.
 src/w32menu.c (x_activate_menubar, set_frame_menubar)
 (w32_dialog_show, initialize_frame_menubar, w32_menu_show)
 (is_simple_dialog): Use bool where appropriate.

lisp/gnus/nnimap.el (nnimap-request-group): Make it possible to enter nnimap groups again

lisp/gnus/nnimap.el (nnimap-request-group): nnimap group activation problems fixed

* lisp/calc/calc-units.el (calc-convert-exact-units): Improve the
  simplification.

* lisp/calc/calc-units.el (math-consistent-units-p): Strengthen the
  test for consistent units.

* lisp/calc/calc-units.el (calc-convert-exact-units): New function.
(calc-convert-units): Check for missing units.

* lisp/calc/calc-ext.el (calc-init-extensions):  Autoload
`calc-convert-exact-units' and assign it a keybinding.

* lisp/calc/calc-help (calc-u-prefix-help): Add help for the
"un" keybinding.

lisp/gnus/message.el (message-smtpmail-send-it): Make non-standard mail header separators work with smtpmail