Fix quoting of help for functions with odd names

While investigating Bug#20759, I discovered other quoting problems:
C-h f mishandled characters like backslash and quote in function names.
This fix changes the behavior so that 'C-h f pcase RET' now
generates "... (\` QPAT) ..." instead of "... (` QPAT) ...",
because '(format "%S" '(` FOO))' returns "(\\` FOO)".  A comment
in src/lread.c's read1 function says that the backslash will be
needed starting in Emacs 25, which implies that 'format' is
correct and the old pcase documention was wrong to omit the backslash.
* lisp/emacs-lisp/nadvice.el (advice--make-docstring):
* lisp/help-fns.el (help-fns--signature):
* lisp/help.el (help-add-fundoc-usage):
* lisp/progmodes/elisp-mode.el (elisp-function-argstring):
Use help--make-usage-docstring rather than formatting
help-make-usage.
* lisp/emacs-lisp/pcase.el (pcase--make-docstring):
Return raw docstring.
* lisp/help-fns.el (help-fns--signature): New arg RAW, to return
raw docstring.  Take more care to distinguish raw from cooked dstrings.
(describe-function-1): Let help-fns--signature substitute
command keys.
* lisp/help.el (help--docstring-quote): New function.
(help-split-fundoc): Use it, to quote funny characters more
systematically.
(help--make-usage): Rename from help-make-usage, since this
should be private.  Leave an obsolete alias for the old name.
(help--make-usage-docstring): New function.
* test/automated/help-fns.el (help-fns-test-funny-names): New test.

* lisp/thingatpt.el (in-string-p): Revert last change,

since in-string-p is not used in thingatpt.el but only from outside.

Also, use lexical binding.

; * ChangeLog.2: Remove entries from a merged feature branch.

* lisp/let-alist.el (let-alist--deep-dot-search): Fix cons

* test/automated/let-alist.el (let-alist-cons): Test it.

* src/syntax.c (Fbackward_prefix_chars): Reword docstring

* build-aux/gitlog-to-emacslog: Also ignore pointless merge commits.

; * ChangeLog.2: Related fixes.

Improve generated ChangeLog for gitmerge.el commits.  (Bug#20717)

* build-aux/gitlog-to-changelog: Handle gitmerge.el skipped commits.

* admin/gitmerge.el (gitmerge-commit-message):
Exclude "skipped" messages from ChangeLog once again.

; * ChangLog.2: Related fixes.

Slight namespace cleanup for thingatpt.el.

* lisp/thingatpt.el (thing-at-point--in-string-p)
(thing-at-point--end-of-sexp, thing-at-point--beginning-of-sexp)
(thing-at-point--read-from-whole-string): Rename from
old versions without "thing-at-point--" prefix.
Keep old versions as obsolete aliases.  Update all uses.

* lisp/emacs-lisp/checkdoc.el (checkdoc-get-keywords):

Move requiring of finder from here...
(checkdoc-package-keywords): ... to here.

Use 'user-error' in a few calendar files.

* lisp/calendar/appt.el (appt-add):
* lisp/calendar/calendar.el (calendar-absolute-from-gregorian)
(calendar-generate):
* lisp/calendar/diary-lib.el (diary-mail-entries, diary-cyclic):
Replace 'error' with 'user-error'.

* lisp/progmodes/f90.el (f90-backslash-not-special): Use user-error.

* lisp/files-x.el (add-file-local-variable):

Special-case 'lexical-binding'.  (Bug#20641)

* lisp/progmodes/executable.el (executable-self-display): Obsolete.

No longer autoload.

* doc/misc/autotype.texi (Executables):
Undocument executable-self-display.

* lisp/progmodes/executable.el (executable-self-display):

Use non-obsolete tail syntax.  (Bug#20779)
(executable-self-display): Doc update.

* lisp/emacs-lisp/checkdoc.el: Use lexical-binding

(finder-known-keywords): Silence byte-compiler.

; * lisp/simple: Revert presumably unintentional deletion of special-mode.

* lisp/simple.el (eval-expression): Macroexpand before evaluating (bug#20730)

* lisp/progmodes/sh-script.el: Better handle nested quotes

(sh-here-doc-open-re): Don't mis-match the <<< operator (bug#20683).
(sh-font-lock-quoted-subshell): Make sure double quotes within single
quotes don't mistakenly end prematurely the surrounding string.

* lisp/progmodes/elisp-mode.el: Require cl-lib for cl-defstruct.

* test/automated/Makefile.in (ELFILES): Sort.

* Makefile.in (SUBDIR_MAKEFILES):

* lwlib/Makefile.in (WARN_CFLAGS):
Use built-in Make functions rather than echo+sed.

Update char-script-table

* lisp/international/characters.el (char-script-table): Update
from Unicode 8.0 Draft.

Improve font selection for punctuation and other symbols

* src/fontset.c (face_for_char): If the character's script is
'symbol', and the font used for ASCII face has a glyph for it, use
the font for the ASCII face instead of searching the fontsets.
This comes instead of NS-specific code that used the current
face's font instead, which is now disabled due to undesirable
consequences.  (Bug#20727)

Skip past `#' to find BEG

* lisp/progmodes/elisp-mode.el (elisp-completion-at-point): Skip
past `#' to find BEG (bug#20771).

* test/automated/elisp-mode-tests.el
(elisp-completes-functions-after-hash-quote): New test.

Fix compilation warning/error in --without-x builds

* src/xdisp.c (append_space_for_newline): Condition GUI-specific
code on HAVE_WINDOW_SYSTEM.

Improve the default fontset wrt symbols

* lisp/international/fontset.el (setup-default-fontset): Better
setup of fontset-default for symbols: use Symbola and FreeMono.
(Bug#20727)

Add new command checkdoc-package-keywords

* lisp/emacs-lisp/checkdoc.el (checkdoc-package-keywords-flag): New
  defcustom.
(checkdoc-list-of-strings-p): Add doc.
(checkdoc-current-buffer): When `checkdoc-package-keywords-flag' is
non-nil, call `checkdoc-package-keywords'.
(checkdoc-get-keywords): New defun.
(checkdoc-package-keywords): New command. Warns if the current file
has package.el-style keywords that aren't in `finder-known-keywords'.

* etc/NEWS: Add entry.

Avoid crashes when key-binding is called from a timer

* src/keymap.c (Fkey_binding): Don't segfault if called with an
empty vector as KEY.  (Bug#20705)

Fix a thinko in arc-mode.el

* lisp/arc-mode.el (archive-zip-summarize): Fix last change in the
non-Zip64 case.  (Bug#20769)

* lisp/emacs-lisp/package.el (package-delete): Make interactive

checkdoc.el (checkdoc-file): New function

* lisp/emacs-lisp/checkdoc.el (checkdoc-error): When
  `checkdoc-diagnostic-buffer' is set to "*warn*", print the warning
  to the standard output.

(bug#20754)

; * src/font.c (syms_of_font) <font-log>: Tweak previous doc fix.

* admin/update_autogen (changelog_files): Remove gitlog-to-emacslog.

* src/font.c (syms_of_font) <font-log>: Doc fix.

Remove the obsolete leading "*" from some C doc strings.

* src/coding.c (syms_of_coding):
* src/font.c (syms_of_font): Remove leading "*" from docs.

* lisp/cus-start.el (enable-character-translation): Add it.

Move gen_origin from program to data

That way, 'make change-history' needs to change only ChangeLog.2,
instead of having to change two files.
* ChangeLog.2: Add commit info for range that this file covers.
* Makefile.in (new_commit_regexp): New macro.
(change-history-nocommit): Simplify, by putting what used to be
the gen_origin value into the data (ChangeLog.2) rather than
into the program (gitlog-to-emacslog).
* build-aux/gitlog-to-emacslog (gen_origin): Calculate from
the input file (e.g., ChangeLog.2) rather than by having a
constant in the program.  Substitute it into the output.

Escape any quotes in the function name

* lisp/help-fns.el (help-fns--signature): Quote any quotes in the
function name (bug#20759).

Adapt 'struct timespec' to next release of MinGW runtime

* nt/inc/ms-w32.h (struct timespec): Don't declare if
__struct_timespec_defined is defined.

; Auto-commit of ChangeLog files.

Merge from gnulib

This incorporates:
2015-06-06 acl-permissions: pacify -Wsuggest-attribute=const
2015-06-05 stdio: Don't redefine gets when using C++
2015-06-05 acl-permissions: port to AIX, C89 HP-UX
2015-06-02 file-has-acl: fix build on Mac OS X 10
2015-06-01 gnulib-tool: concatenate lib_SOURCES to a single line
2015-06-01 pthread_sigmask: discount system version if a simple macro
2015-05-31 readlinkat: avoid OS X 10.10 trailing slash bug
* doc/misc/texinfo.tex, lib/acl-internal.h, lib/get-permissions.c:
* lib/readlinkat.c, lib/set-permissions.c, lib/stdio.in.h:
* m4/acl.m4, m4/pthread_sigmask.m4, m4/readlinkat.m4: Copy from gnulib.
* lib/gnulib.mk: Regenerate.

* lisp/progmodes/grep.el (zrgrep): Let-bind grep-highlight-matches

before calling grep-compute-defaults because now it affects the
command lines computed in grep-compute-defaults. (Bug#20728)

Address some compilation warnings.

* lisp/international/mule-cmds.el (w32-get-console-codepage)
(w32-get-console-output-codepage):
* lisp/progmodes/elisp-mode.el (xref-collect-references):
* lisp/version.el (cairo-version-string): Declare.

* lisp/erc/erc.el (erc-nickname-in-use): Fix typo.

Fix display when a font claims large values of ascent and descent

This fixes bug#20628.

* src/xdisp.c (get_phys_cursor_geometry): Correct the Y
coordinate of a hollow cursor glyph when the original glyph's
ascent is too small.
(get_font_ascent_descent, normal_char_ascent_descent)
(normal_char_height): New functions.
(handle_single_display_spec, append_space_for_newline)
(calc_pixel_width_or_height, produce_stretch_glyph)
(calc_line_height_property): Use normal_char_ascent_descent and
normal_char_height.
(x_produce_glyphs): When font-global values of ascent and descent
are too large, use per-character glyph metrics instead, if
possible.  But don't allow the glyph row's ascent and descent
values become smaller than the values from the metrics of the
font's "normal" character.

* src/xftfont.c (xftfont_draw):
* src/w32font.c (w32font_draw): Correct the values of ascent and
descent used to draw glyphless characters' hex code in a box.

* src/xterm.c (x_draw_glyph_string_background):
* src/xdisp.c (x_produce_glyphs):
* src/w32term.c (x_draw_glyph_string_background):
* src/nsterm.m (ns_maybe_dumpglyphs_background): Use FONT_TOO_HIGH
to detect fonts whose global ascent and descent values are too
large to be used in layout decision, and redraw the background
when that happens.

* src/dispextern.h (FONT_TOO_HIGH): New macro.
(get_font_ascent_descent): Add prototype.

* src/xterm.c (x_new_font):
* src/w32term.c (x_new_font):
* src/nsterm.m (x_new_font):
* src/font.c (font_open_entity):
* src/composite.c (composition_gstring_width): Use
get_font_ascent_descent to obtain reasonable values for ascent and
descent of a font.

Add assertion in adjust_point_for_property

* src/keyboard.c (adjust_point_for_property): Add eassert for
current buffer being shown in selected window.

Replace uses of in-string-p; make it obsolete

* lisp/thingatpt.el (in-string-p): Declare obsolete (bug#20732).
(end-of-sexp, beginning-of-sexp): Use syntax-ppss instead.

Fix Dired display of an explicit list of files by ls-lisp.el

* lisp/ls-lisp.el (ls-lisp-uid-d-fmt, ls-lisp-uid-s-fmt)
(ls-lisp-gid-d-fmt, ls-lisp-gid-s-fmt): Make the initial values be
correct for when displaying individual files separately, not as
part of listing a directory, in which case these values are not
recomputed by 'ls-lisp-insert-directory', but used verbatim.

* lisp/dired.el (dired): Doc fix.  (Bug#20739)

Do not adjust point in a non-selected window

* src/keyboard.c (command_loop_1): Do not adjust point when
current buffer is not shown in selected window (Bug#20590).

* etc/DEBUG: Mention 'maybe_call_debugger'

Fix a unit test for map.el

* test/automated/map-tests.el (test-map-let): Fix the test to work
with the new syntax of `map-let'.

* lisp/emacs-lisp/map.el (map-let): Better docstring.

Better syntax for the map pcase pattern

* lisp/emacs-lisp/map.el: Improves the map pcase pattern to take
bindings of the form (KEY PAT) or SYMBOL. KEY is not quoted.

* lisp/emacs-lisp/map.el (map--dispatch): Better docstring.

; * lisp/emacs-lisp/map.el: Fix formatting.

Fix a byte-compiler error in map-put and map-delete

* lisp/emacs-lisp/map.el (map-put, map-delete): Ensure that `setq' is
called with a symbol.

* admin/gitmerge.el (gitmerge-commit-message):

Revert to including "skipped" messages in ChangeLog once again.

Use string> instead of equiv lambda with string<

* lisp/help.el (view-emacs-news): Use string> instead of equivalent
lambda with string<.

* lisp/emacs-lisp/map.el (map--dispatch): Move before use.

(map--delete-array): Fix typo.

* test/automated/map-tests.el: Replace "assert" with "should".

* lisp/Makefile.in (SUBDIRS): Rename from SUBDIRS_ABS.

(SUBDIRS_REL): Derive from SUBDIRS.

Tweak some build messages.

* lisp/Makefile.in ($(lisp)/loaddefs.el):
* lisp/cus-dep.el (custom-make-dependencies):
* lisp/finder.el (finder-compile-keywords): Say what we are doing.
* lisp/international/titdic-cnv.el (batch-titdic-convert):
Don't say how to compile.

; etc/DEBUG copedits

* etc/DEBUG: Improve the section on debugging redisplay issues.
Also other minor copyedits.

Omit U+0332 COMBINING LOW LINE in previous change

It turns out that it does not work on Ubuntu 15.04.

Fix transliteration of Bahá'í months

* lisp/calendar/cal-bahai.el (calendar-bahai-month-name-array):
Improve quality of Latin transliteration of Bahá'í month names.

Fix curved quotes in a few places

* lisp/calc/calc-misc.el (calc-help): Fix quoting.
The strings in question are not doc strings, so this partially
undoes the recent change that assumed they were doc strings.
* lisp/cedet/srecode/srt-mode.el (srecode-macro-help):
* lisp/info.el (Info-finder-find-node):
Use curved quotes.
* lisp/emacs-lisp/derived.el (derived-mode-make-docstring):
Also allow curved quotes in doc strings.

* lisp/Makefile.in (AM_V_at): Add missing definition.

* lisp/Makefile.in: Quieten output a bit.

($(lisp)/cus-load.el, $(lisp)/finder-inf.el):
Don't echo directories, since the commands we invoke print them.

* lisp/Makefile.in: Replace shell fragments in variables with $(shell).

(SUBDIRS_REL, SUBDIRS_ABS, SUBDIRS_ALMOST, SUBDIRS_FINDER)
(SUBDIRS_SUBDIRS): New variables.
(setwins, setwins_almost, setwins_finder, setwins_for_subdirs):
Remove.
($(lisp)/cus-load.el, $(lisp)/finder-inf.el, $(lisp)/loaddefs.el)
(update-subdirs, compile-main, compile-clean):
Replace "setwins" usage with new "SUBDIRS" variables.

* lisp/vc/compare-w.el (compare-windows-get-window-function):

Fix :version tag.

* src/ftfont.c (ftfont_open2): Round divisions by upEM.

Undo removal of x_clear_area call on expose for GTK3 or cairo.

* src/xterm.c (handle_one_xevent) [HAVE_GTK3 || USE_CAIRO]: Clear
exposed area.  (Bug#20677)

* doc/lispref/hash.texi (Creating Hash): Remove obsolete makehash.

* lisp/Makefile.in (check-defun-dups): Also skip ldefs-boot.

* lisp/leim/quail/lrt.el (quail-lrt-update-translation):

Rename from quail-lao-update-translation, since lao.el defines that.

Handle new-style advice in find-funct

* lisp/emacs-lisp/find-func.el (find-function-advised-original):
Handle new-style advice.  Return the symbol's function definition.
(Bug#20718)
(find-function-library): Update accordingly.

Merge branch 'map'

* lisp/emacs-lisp/map.el: Better docstring for the map pcase macro.

; * etc/NEWS: Add string-greaterp

Add new function string-greaterp

* lisp/subr.el (string-greaterp): New function.  Also aliased to
`string>'.
* test/automated/subr-tests.el (string-comparison-test): Add unit
tests for `string>'and `string<'.
* src/fns.c (string-lessp): Better docstring.

Fix timezone-related functions on MS-Windows

* src/editfns.c (set_time_zone_rule) [WINDOWSNT]: Always call
'xputenv', even if no reallocation of tzvalbuf was necessary.
This fixes a bug in timezone-related functions on MS-Windows.
Reported by Fabrice Popineau <fabrice.popineau@gmail.com>.

Don't pass raw directory name to 'error'

* lisp/files.el (basic-save-buffer-2): Avoid format error if
a directory name contains a string like "%s".

Override 'grep --color=always'

* lisp/progmodes/xref.el (xref-collect-matches):
Override --color=always in grep-find-template.

Fix error introduced recently in file-notify-tests.el

* test/automated/file-notify-tests.el
(file-notify--test-remote-enabled): Do not use `file-notify--test-desc'.
(file-notify--deftest-remote): Revert previous patch, not
necessary anymore.

* src/indent.c (Fvertical_motion): Amend motion by 0 lines.

Starting from a display string after a newline, point went to the
previous line.  Also, fix an inadvertent use of a buffer position
with FETCH_BYTE.  (Bug#20701)

Instrument file-notify-test.el in order to catch hydra error.

* test/automated/file-notify-tests.el (file-notify--deftest-remote):
Wrap body by `ignore-case', in order to trap non-local errors.

Undo previous changes in non-toolkit scroll bar drawing.

* src/xterm.c (x_scroll_bar_set_handle, x_scroll_bar_expose)
[!USE_TOOLKIT_SCROLL_BARS]: Draw into scroll bar window.  (Bug#20668)

* .gitignore: Also ignore doc/*/*/*.html and .ps.

Support quotes 'like this' in info files

This is possible when 'makeinfo --disable-encoding' is used
in Texinfo 5.
* lisp/calc/calc-help.el (calc-describe-thing):
* lisp/gnus/gnus-art.el (gnus-button-alist):
* lisp/info.el (Info-find-index-name):
* lisp/vc/ediff-help.el (ediff-help-for-quick-help):
Also support quotes 'like this'.
* lisp/calc/calc-help.el (calc-describe-thing): Simplify.
* lisp/finder.el (finder-font-lock-keywords): Remove var that
hasn't been used in years, instead of bothering to fix its quoting.

* .gitignore: Remove !test/etags/html-src/*.html.

It's no longer needed, since *.html was removed.  Sort.

Restore <D> instead of '.' in grep-find-template

* lisp/cedet/semantic/symref/grep.el
(semantic-symref-grep-use-template): Update a comment.

* lisp/progmodes/grep.el (grep-compute-defaults): Restore <D>
instead of '.' in grep-find-template (bug#20719).
(rgrep): Pass nil as the directory to rgrep-default-command.

* lisp/progmodes/grep.el (grep-expand-keywords): Use '.' as the
default value for DIR.

* lisp/progmodes/xref.el (xref-collect-matches): Drop the
workaround.

* configure.ac (emacs_config_features): Add X toolkit and scroll-bars.

; * etc/NEWS: Tiny edit.

* configure.ac (emacs_config_features): Add Cairo.

; * etc/NEWS: Add Cairo placeholder.

* configure.ac [HAVE_GTK3]: Remove USE_CAIRO that gets reset later.

Ensure, that autorevert works for remote files in file-notify-tests.el

* test/automated/file-notify-tests.el (file-notify--test-desc):
New defvar.
(file-notify--test-remote-enabled)
(file-notify-test00-availability, file-notify-test01-add-watch)
(file-notify-test02-events): Use it.
(file-notify--test-event-test): Check proper descriptor.
(file-notify-test03-autorevert): Ensure, that
`visited-file-modtime' has changed.

Fixes: debbugs:20392

Add a pcase pattern for maps and `map-let' based on it

* lisp/emacs-lisp/map.el (map-let): New macro.
(map--make-pcase-bindings, map--make-pcase-patterns): New functions.
* test/automated/map-tests.el: New test for `map-let'.

Reuse rgrep mechanics in xref-find-regexp

* lisp/progmodes/grep.el (rgrep-default-command):
Extract from `rgrep'.

* lisp/progmodes/xref.el (xref-collect-references): Split from
`xref-collect-matches'.  Only handle the case of symbol search.
(xref-collect-matches): Instead of Semantic Symref, use
`rgrep-default-command', to take advantage of its directory and
file ignore settings.
(xref--collect-match): Remove the last argument, leaving the
regexp construction up to the caller.

* lisp/progmodes/elisp-mode.el (elisp--xref-find-matches):
Change to take the xref-collect- function to use as an argument.
(elisp-xref-find): Update accordingly.

* lisp/progmodes/etags.el (etags--xref-find-matches)
(etags-xref-find): Same.

Move xref-elisp-location to elisp-mode.el

* lisp/progmodes/xref.el (xref-elisp-location)
(xref-make-elisp-location, xref-location-marker): Remove here.
(xref--xref): Don't limit the type of the location slot.

* lisp/progmodes/elisp-mode.el (xref-elisp-location):
Define as a cl-struct here.
(xref-location-marker): Move here.

Minor tweaks for .gitignore

* .gitignore: Don't ignore versioned *.html and *.ps files.  Don't
ignore admin/notes/tags that might be ignored as TAGS on
case-insensitive filesystems.  (Bug#20710)