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

* 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

Use bool, not int, to track face changes

* xfaces.c (face_change): Rename from face_change_count, and
change from int to bool.  The var is now true (instead of nonzero)
if attributes have changed; this is simpler.  All uses changed.
Fixes: bug#19698

Improve the fix for bug #19701

 src/dired.c (directory_files_internal, file_name_completion)
 [WINDOWSNT]: Signal an error when errno is set non-zero by
 'readdir', regardless of its value.
 src/w32.c (sys_readdir): Set errno to ENOENT when the directory
 doesn't exist and to EACCES when it's not accessible to the
 current user.  Set errno to zero when FindNextFile exhausts the
 directory, so that callers don't interpret that as an error and
 don't signal a file-error.
 (open_unc_volume): Set errno to ENOENT if WNetOpenEnum fails.

* lisp/emacs-lisp/cl.el (cl--function-convert): Simplify.

Fix issues with BibTeX entries containing ")".

* textmodes/reftex.el (reftex-syntax-table-for-bib): Give ( and )
punctuation syntax since to allow bibtex fields with values such
as {Test 1) and 2)} (bug#19205, bug#19707).
(reftex--prepare-syntax-tables): New function.
(reftex-mode): Use it.

[backport from trunk]