Commit c33d89cc authored by Paul Eggert's avatar Paul Eggert

Fix single-quoting style in PDF manuals

The PDF versions of the GNU manuals used curved single quotes to
represent grave accent and apostrophe, which made it a pain to cut
and paste code examples from them.  Fix the PDF versions to use
grave accent and apostrophe for Lisp source code, keystrokes, etc.
This change does not affect the info files, nor does it affect
ordinary uses of curved single quotes in PDF.
* doc/emacs/docstyle.texi: New file, which specifies treatment for
grave accent and apostrophe, as well as the document encoding.
* doc/emacs/emacs-xtra.texi, doc/emacs/emacs.texi:
* doc/lispintro/emacs-lisp-intro.texi:
* doc/lispref/back.texi, doc/lispref/book-spine.texi:
* doc/lispref/elisp.texi, doc/lispref/lay-flat.texi:
* doc/misc/ada-mode.texi, doc/misc/auth.texi:
* doc/misc/autotype.texi, doc/misc/bovine.texi, doc/misc/calc.texi:
* doc/misc/cc-mode.texi, doc/misc/cl.texi, doc/misc/dbus.texi:
* doc/misc/dired-x.texi, doc/misc/ebrowse.texi, doc/misc/ede.texi:
* doc/misc/ediff.texi, doc/misc/edt.texi, doc/misc/efaq-w32.texi:
* doc/misc/efaq.texi, doc/misc/eieio.texi, doc/misc/emacs-gnutls.texi:
* doc/misc/emacs-mime.texi, doc/misc/epa.texi, doc/misc/erc.texi:
* doc/misc/ert.texi, doc/misc/eshell.texi, doc/misc/eudc.texi:
* doc/misc/eww.texi, doc/misc/flymake.texi, doc/misc/forms.texi:
* doc/misc/gnus-coding.texi, doc/misc/gnus-faq.texi:
* doc/misc/gnus.texi, doc/misc/htmlfontify.texi:
* doc/misc/idlwave.texi, doc/misc/ido.texi, doc/misc/info.texi:
* doc/misc/mairix-el.texi, doc/misc/message.texi, doc/misc/mh-e.texi:
* doc/misc/newsticker.texi, doc/misc/nxml-mode.texi:
* doc/misc/octave-mode.texi, doc/misc/org.texi, doc/misc/pcl-cvs.texi:
* doc/misc/pgg.texi, doc/misc/rcirc.texi, doc/misc/reftex.texi:
* doc/misc/remember.texi, doc/misc/sasl.texi, doc/misc/sc.texi:
* doc/misc/semantic.texi, doc/misc/ses.texi, doc/misc/sieve.texi:
* doc/misc/smtpmail.texi, doc/misc/speedbar.texi:
* doc/misc/srecode.texi, doc/misc/todo-mode.texi, doc/misc/tramp.texi:
* doc/misc/url.texi, doc/misc/vhdl-mode.texi, doc/misc/vip.texi:
* doc/misc/viper.texi, doc/misc/widget.texi, doc/misc/wisent.texi:
* doc/misc/woman.texi:
Use it instead of '@documentencoding UTF-8', to lessen the need for
global changes like this in the future.
* doc/emacs/Makefile.in (EMACS_XTRA):
* doc/lispintro/Makefile.in (srcs):
* doc/lispref/Makefile.in (srcs):
Add dependency on docstyle.texi.
* doc/misc/Makefile.in (style): New macro.
(${buildinfodir}/%.info, %.dvi, %.pdf, %.html)
(${buildinfodir}/ccmode.info, ${buildinfodir}/efaq%.info, gnus_deps):
Use it.
parent be8cdfaa
......@@ -94,6 +94,7 @@ EMACS_XTRA= \
$(srcdir)/arevert-xtra.texi \
$(srcdir)/cal-xtra.texi \
$(srcdir)/dired-xtra.texi \
${srcdir}/docstyle.texi \
$(srcdir)/picture-xtra.texi \
$(srcdir)/emerge-xtra.texi \
$(srcdir)/vc-xtra.texi \
......
@c Emacs documentation style settings
@documentencoding UTF-8
@codequotebacktick on
@codequoteundirected on
......@@ -2,6 +2,7 @@
@comment %**start of header
@setfilename ../../info/emacs-xtra.info
@settitle Specialized Emacs Features
@include docstyle.texi
@c Merge all functions, variables, and keys into the concept index.
@syncodeindex fn cp
@syncodeindex vr cp
......@@ -26,8 +27,6 @@ modify this GNU manual.''
@end quotation
@end copying
@documentencoding UTF-8
@dircategory Emacs
@direntry
* Emacs-Xtra: (emacs-xtra). Specialized Emacs features.
......
......@@ -2,6 +2,7 @@
@setfilename ../../info/emacs.info
@settitle GNU Emacs Manual
@include docstyle.texi
@c The edition number appears in more than one place in this file
@c I don't really know what it means...
......@@ -44,8 +45,6 @@ developing GNU and promoting software freedom.''
@end quotation
@end copying
@documentencoding UTF-8
@dircategory Emacs
@direntry
* Emacs: (emacs). The extensible self-documenting text editor.
......
......@@ -24,7 +24,7 @@ srcdir = @srcdir@
buildinfodir = $(srcdir)/../../info
# Directory with the (customized) texinfo.tex file.
texinfodir = $(srcdir)/../misc
# Directory with emacsver.texi.
# Directory with docstyle.texi and emacsver.texi.
emacsdir = $(srcdir)/../emacs
prefix = @prefix@
......@@ -73,7 +73,7 @@ PDF_TARGETS = emacs-lisp-intro.pdf
PS_TARGETS = emacs-lisp-intro.ps
srcs = ${srcdir}/emacs-lisp-intro.texi ${srcdir}/doclicense.texi \
${emacsdir}/emacsver.texi
${emacsdir}/docstyle.texi ${emacsdir}/emacsver.texi
## Disable implicit rules.
%.texi: ;
......
......@@ -4,7 +4,7 @@
@c setfilename emacs-lisp-intro.info
@c sethtmlfilename emacs-lisp-intro.html
@settitle Programming in Emacs Lisp
@documentencoding UTF-8
@include docstyle.texi
@syncodeindex vr cp
@syncodeindex fn cp
@finalout
......
......@@ -28,7 +28,7 @@ srcdir = @srcdir@
buildinfodir = $(srcdir)/../../info
# Directory with the (customized) texinfo.tex file.
texinfodir = $(srcdir)/../misc
# Directory with emacsver.texi.
# Directory with docstyle.tex and emacsver.texi.
emacsdir = $(srcdir)/../emacs
prefix = @prefix@
......@@ -80,6 +80,7 @@ PS_TARGETS = elisp.ps
srcs = \
$(srcdir)/elisp.texi \
$(emacsdir)/docstyle.texi \
$(emacsdir)/emacsver.texi \
$(srcdir)/abbrevs.texi \
$(srcdir)/anti.texi \
......
......@@ -6,7 +6,7 @@
@c %**start of header
@setfilename back-cover
@settitle GNU Emacs Lisp Reference Manual
@documentencoding UTF-8
@include docstyle.texi
@c %**end of header
.
@sp 7
......
......@@ -2,7 +2,7 @@
@c %**start of header
@setfilename book-spine
@settitle book-spine
@documentencoding UTF-8
@include docstyle.texi
@c %**end of header
@include emacsver.texi
......
......@@ -18,6 +18,7 @@
@ifclear volflag
@settitle GNU Emacs Lisp Reference Manual
@end ifclear
@include docstyle.texi
@c %**end of header
......@@ -115,8 +116,6 @@ developing GNU and promoting software freedom.''
@end quotation
@end copying
@documentencoding UTF-8
@dircategory Emacs lisp
@direntry
* Elisp: (elisp). The Emacs Lisp Reference Manual.
......
......@@ -6,8 +6,8 @@
@comment %**start of header
@setfilename inner-covers.info
@settitle Inner Covers
@include docstyle.texi
@smallbook
@documentencoding UTF-8
@comment %**end of header
@headings off
......
......@@ -29,7 +29,7 @@ srcdir=@srcdir@
## In a tarfile of Emacs, the Info files should be up to date.
buildinfodir = $(srcdir)/../../info
## Directory with emacsver.texi.
## Directory with docstyle.texi and emacsver.texi.
emacsdir = $(srcdir)/../emacs
prefix = @prefix@
......@@ -108,6 +108,7 @@ ENVADD = $(AM_V_GEN)TEXINPUTS="$(srcdir):$(emacsdir):$(TEXINPUTS)" \
MAKEINFO="$(MAKEINFO) $(MAKEINFO_OPTS)"
gfdl = ${srcdir}/doclicense.texi
style = ${emacsdir}/docstyle.texi
.PHONY: info dvi html pdf ps echo-info $(INFO_TARGETS)
## Prevent implicit rule triggering for foo.info.
......@@ -140,7 +141,7 @@ ${buildinfodir}:
EXTRA_OPTS =
${buildinfodir}/%.info: ${srcdir}/%.texi ${gfdl} | ${buildinfodir}
${buildinfodir}/%.info: ${srcdir}/%.texi ${gfdl} ${style} | ${buildinfodir}
$(AM_V_GEN)$(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) $(EXTRA_OPTS) \
-o $@ $<
......@@ -155,13 +156,13 @@ info.info: $(buildinfodir)/info.info
$(foreach ifile,$(filter-out info.info,$(INFO_TARGETS)),$(eval $(call info_template,$(ifile))))
%.dvi: ${srcdir}/%.texi ${gfdl}
%.dvi: ${srcdir}/%.texi ${gfdl} ${style}
$(ENVADD) $(TEXI2DVI) $<
%.pdf: ${srcdir}/%.texi ${gfdl}
%.pdf: ${srcdir}/%.texi ${gfdl} ${style}
$(ENVADD) $(TEXI2PDF) $<
%.html: ${srcdir}/%.texi ${gfdl}
%.html: ${srcdir}/%.texi ${gfdl} ${style}
$(AM_V_GEN)$(MAKEINFO) $(MAKEINFO_OPTS) $(HTML_OPTS) $(EXTRA_OPTS) \
-o $@ $<
......@@ -184,12 +185,13 @@ $(buildinfodir)/semantic.info semantic.dvi semantic.pdf semantic.html: ${srcdir}
## Please can we just rename cc-mode.texi to ccmode.texi...
${buildinfodir}/ccmode.info: ${srcdir}/cc-mode.texi ${gfdl} | ${buildinfodir}
${buildinfodir}/ccmode.info: \
${srcdir}/cc-mode.texi ${gfdl} ${style} | ${buildinfodir}
$(AM_V_GEN)$(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ $<
## efaq, efaq_w32 do not depend on gfdl.
## Maybe we can use .SECONDEXPANSION for this.
${buildinfodir}/efaq%.info: ${srcdir}/efaq%.texi | ${buildinfodir}
${buildinfodir}/efaq%.info: ${srcdir}/efaq%.texi ${style} | ${buildinfodir}
$(AM_V_GEN)$(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ $<
efaq%.dvi: ${srcdir}/efaq%.texi
......@@ -203,7 +205,7 @@ efaq%.html: ${srcdir}/efaq%.texi
${buildinfodir}/emacs-mime.info emacs-mime.html: EXTRA_OPTS = --enable-encoding
gnus_deps = ${srcdir}/gnus.texi ${srcdir}/gnus-faq.texi ${gfdl}
gnus_deps = ${srcdir}/gnus.texi ${srcdir}/gnus-faq.texi ${gfdl} ${style}
gnus.dvi: $(gnus_deps)
sed -e '/@iflatex/,/@end iflatex/d' $< > gnustmpdvi.texi
$(ENVADD) $(TEXI2DVI) gnustmpdvi.texi
......
\input texinfo @c -*-texinfo-*-
@setfilename ../../info/ada-mode.info
@settitle Ada Mode
@documentencoding UTF-8
@include docstyle.texi
@copying
Copyright @copyright{} 1999--2015 Free Software Foundation, Inc.
......
......@@ -6,7 +6,7 @@
@setfilename ../../info/auth.info
@settitle Emacs auth-source Library @value{VERSION}
@documentencoding UTF-8
@include docstyle.texi
@copying
This file describes the Emacs auth-source library.
......
......@@ -5,7 +5,7 @@
@c @node Autotypist, Picture, Abbrevs, Top
@c @chapter Features for Automatic Typing
@settitle Features for Automatic Typing
@documentencoding UTF-8
@include docstyle.texi
@c @cindex text
@c @cindex selfinserting text
@c @cindex autotypist
......
......@@ -4,7 +4,7 @@
@set TITLE Bovine parser development
@set AUTHOR Eric M. Ludlam, David Ponce, and Richard Y. Kim
@settitle @value{TITLE}
@documentencoding UTF-8
@include docstyle.texi
@c *************************************************************************
@c @ Header
......
......@@ -4,7 +4,7 @@
@setfilename ../../info/calc.info
@c [title]
@settitle GNU Emacs Calc Manual
@documentencoding UTF-8
@include docstyle.texi
@setchapternewpage odd
@comment %**end of header (This is for running Texinfo on a region.)
......@@ -83,7 +83,7 @@ the second with them pointing to the XEmacs manuals.
@setfilename ../../info/ccmode.info
@settitle CC Mode Manual
@documentencoding UTF-8
@include docstyle.texi
@footnotestyle end
@c The following four macros generate the filenames and titles of the
......
\input texinfo @c -*-texinfo-*-
@setfilename ../../info/cl.info
@settitle Common Lisp Extensions
@documentencoding UTF-8
@include docstyle.texi
@include emacsver.texi
@copying
......
......@@ -2,7 +2,7 @@
@setfilename ../../info/dbus.info
@c %**start of header
@settitle Using of D-Bus
@documentencoding UTF-8
@include docstyle.texi
@c @setchapternewpage odd
@c %**end of header
......
......@@ -9,7 +9,7 @@
@comment %**start of header (This is for running Texinfo on a region.)
@setfilename ../../info/dired-x.info
@settitle Dired Extra User's Manual
@documentencoding UTF-8
@include docstyle.texi
@include emacsver.texi
......
......@@ -3,7 +3,7 @@
@comment %**start of header
@setfilename ../../info/ebrowse.info
@settitle A Class Browser for C++
@documentencoding UTF-8
@include docstyle.texi
@setchapternewpage odd
@syncodeindex fn cp
@comment %**end of header
......
\input texinfo
@setfilename ../../info/ede.info
@settitle Emacs Development Environment
@documentencoding UTF-8
@include docstyle.texi
@copying
This file describes EDE, the Emacs Development Environment.
......
......@@ -10,7 +10,7 @@
@setfilename ../../info/ediff.info
@settitle Ediff User's Manual
@documentencoding UTF-8
@include docstyle.texi
@synindex vr cp
@synindex fn cp
@synindex pg cp
......
\input texinfo
@setfilename ../../info/edt.info
@settitle EDT Emulation for Emacs
@documentencoding UTF-8
@include docstyle.texi
@copying
This file documents the EDT emulation package for Emacs.
......
\input texinfo @c -*-coding:utf-8 -*-
@setfilename ../../info/efaq-w32.info
@settitle GNU Emacs FAQ For MS Windows
@include docstyle.texi
@setchapternewpage odd
@syncodeindex pg cp
@syncodeindex ky cp
......@@ -13,9 +14,6 @@ Answers to Frequently asked Questions about using Emacs on Microsoft Windows.
@include emacsver.texi
@documentencoding utf-8
@documentlanguage en
@copying
Copyright @copyright{} 2008, 2010-2015 Free Software Foundation, Inc.
......
......@@ -2,7 +2,7 @@
@c %**start of header
@setfilename ../../info/efaq.info
@settitle GNU Emacs FAQ
@documentencoding UTF-8
@include docstyle.texi
@c %**end of header
@include emacsver.texi
......
......@@ -3,7 +3,7 @@
@set TITLE Enhanced Implementation of Emacs Interpreted Objects
@set AUTHOR Eric M. Ludlam
@settitle @value{TITLE}
@documentencoding UTF-8
@include docstyle.texi
@c *************************************************************************
@c @ Header
......
......@@ -4,7 +4,7 @@
@setfilename ../../info/emacs-gnutls.info
@settitle Emacs GnuTLS Integration @value{VERSION}
@documentencoding UTF-8
@include docstyle.texi
@copying
This file describes the Emacs GnuTLS integration.
......
......@@ -4,6 +4,7 @@
@setfilename ../../info/emacs-mime.info
@settitle Emacs MIME Manual
@include docstyle.texi
@synindex fn cp
@synindex vr cp
@synindex pg cp
......@@ -27,7 +28,6 @@ modify this GNU manual.''
@end copying
@c Node ``Interface Functions'' uses non-ASCII characters
@documentencoding UTF-8
@dircategory Emacs lisp libraries
@direntry
......
......@@ -2,7 +2,7 @@
@c %**start of header
@setfilename ../../info/epa.info
@settitle EasyPG Assistant User's Manual
@documentencoding UTF-8
@include docstyle.texi
@c %**end of header
@set VERSION 1.0.0
......
......@@ -2,9 +2,9 @@
@c %**start of header
@setfilename ../../info/erc.info
@settitle ERC Manual
@include docstyle.texi
@syncodeindex fn cp
@include emacsver.texi
@documentencoding UTF-8
@c %**end of header
@copying
......
......@@ -2,7 +2,7 @@
@c %**start of header
@setfilename ../../info/ert.info
@settitle Emacs Lisp Regression Testing
@documentencoding UTF-8
@include docstyle.texi
@c %**end of header
@dircategory Emacs misc features
......
......@@ -2,9 +2,9 @@
@c %**start of header
@setfilename ../../info/eshell.info
@settitle Eshell: The Emacs Shell
@include docstyle.texi
@defindex cm
@synindex vr fn
@documentencoding UTF-8
@c %**end of header
@copying
......
......@@ -2,8 +2,8 @@
@c %**start of header
@setfilename ../../info/eudc.info
@settitle Emacs Unified Directory Client (EUDC) Manual
@include docstyle.texi
@afourpaper
@documentencoding UTF-8
@syncodeindex fn cp
@syncodeindex vr cp
@c %**end of header
......
......@@ -2,7 +2,7 @@
@c %**start of header
@setfilename ../../info/eww.info
@settitle Emacs Web Wowser
@documentencoding UTF-8
@include docstyle.texi
@c %**end of header
@copying
......
......@@ -4,8 +4,8 @@
@set VERSION 0.3
@set UPDATED April 2004
@settitle GNU Flymake @value{VERSION}
@include docstyle.texi
@syncodeindex pg cp
@documentencoding UTF-8
@comment %**end of header
@copying
......
......@@ -5,6 +5,7 @@
@comment %**start of header (This is for running Texinfo on a region.)
@setfilename ../../info/forms.info
@settitle Forms Mode User's Manual
@include docstyle.texi
@syncodeindex vr cp
@syncodeindex fn cp
@syncodeindex ky cp
......@@ -14,7 +15,6 @@
@end iftex
@c @smallbook
@comment %**end of header (This is for running Texinfo on a region.)
@documentencoding UTF-8
@copying
This file documents Forms mode, a form-editing major mode for GNU Emacs.
......
......@@ -2,7 +2,7 @@
@setfilename gnus-coding.info
@settitle Gnus Coding Style and Maintenance Guide
@documentencoding UTF-8
@include docstyle.texi
@syncodeindex fn cp
@syncodeindex vr cp
@syncodeindex pg cp
......
......@@ -5,7 +5,7 @@
@c
@c @setfilename gnus-faq.info
@c @settitle Frequently Asked Questions
@c @documentencoding UTF-8
@c @include docstyle.texi
@c %**end of header
@c
......
......@@ -4,12 +4,11 @@
@setfilename ../../info/gnus.info
@settitle Gnus Manual
@include docstyle.texi
@syncodeindex fn cp
@syncodeindex vr cp
@syncodeindex pg cp
@documentencoding UTF-8
@copying
Copyright @copyright{} 1995--2015 Free Software Foundation, Inc.
......@@ -2,8 +2,8 @@
@comment %**start of header
@setfilename ../../info/htmlfontify.info
@settitle Htmlfontify User Manual
@include docstyle.texi
@exampleindent 2
@documentencoding UTF-8
@comment %**end of header
@copying
......
......@@ -2,6 +2,7 @@
@c %**start of header
@setfilename ../../info/idlwave.info
@settitle IDLWAVE User Manual
@include docstyle.texi
@synindex ky cp
@syncodeindex vr cp
@syncodeindex fn cp
......@@ -12,7 +13,6 @@
@set DATE April, 2007
@set AUTHOR J.D. Smith & Carsten Dominik
@set MAINTAINER J.D. Smith
@documentencoding UTF-8
@c %**end of header
@finalout
......
\input texinfo @c -*-texinfo-*-
@setfilename ../../info/ido.info
@settitle Interactive Do
@documentencoding UTF-8
@include docstyle.texi
@include emacsver.texi
@copying
......
......@@ -5,10 +5,10 @@
@comment %**start of header
@setfilename info.info
@settitle Info
@include docstyle.texi
@syncodeindex fn cp
@syncodeindex vr cp
@syncodeindex ky cp
@documentencoding UTF-8
@comment %**end of header
@copying
......
......@@ -2,8 +2,7 @@
@setfilename ../../info/mairix-el.info
@settitle Emacs Interface for Mairix
@documentencoding UTF-8
@include docstyle.texi
@copying
Copyright @copyright{} 2008--2015 Free Software Foundation, Inc.
......
......@@ -4,7 +4,7 @@
@setfilename ../../info/message.info
@settitle Message Manual
@documentencoding UTF-8
@include docstyle.texi
@synindex fn cp
@synindex vr cp
@synindex pg cp
......
......@@ -5,7 +5,7 @@
@c %**start of header
@setfilename ../../info/mh-e.info
@settitle The MH-E Manual
@documentencoding UTF-8
@include docstyle.texi
@c %**end of header
@c Version of the software and manual.
......
......@@ -4,10 +4,10 @@
@include emacsver.texi
@set VERSION @value{EMACSVER}
@settitle Newsticker @value{VERSION}
@include docstyle.texi
@syncodeindex vr cp
@syncodeindex fn cp
@syncodeindex pg cp
@documentencoding UTF-8
@comment %**end of header
@copying
......
......@@ -2,7 +2,7 @@
@c %**start of header
@setfilename ../../info/nxml-mode.info
@settitle nXML Mode
@documentencoding UTF-8
@include docstyle.texi
@c %**end of header
@copying
......
......@@ -2,7 +2,7 @@
@c %**start of header
@setfilename ../../info/octave-mode.info
@settitle Octave Mode
@documentencoding UTF-8
@include docstyle.texi
@c %**end of header
@copying
......
......@@ -2,6 +2,7 @@
@c %**start of header
@setfilename ../../info/org.info
@settitle The Org Manual
@include docstyle.texi
@set VERSION 8.2.9
......@@ -11,7 +12,6 @@
@set MAINTAINER Carsten Dominik
@set MAINTAINEREMAIL @email{carsten at orgmode dot org}
@set MAINTAINERCONTACT @uref{mailto:carsten at orgmode dot org,contact the maintainer}
@documentencoding UTF-8
@c %**end of header
@finalout
......