1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2025-12-25 15:00:45 -08:00
Commit graph

70 commits

Author SHA1 Message Date
Paul Eggert
c33d89cc64 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.
2015-05-01 12:06:38 -07:00
Vibhav Pant
d7f1b8af02 Add option to eshell/clear to clear scrollback.
* lisp/eshell/esh-mode.el (eshell/clear-scrollback): New function.
(eshell/clear): Add an optional SCROLLBACK argument. If non-nil,
scrollback contents are cleared.

* etc/NEWS: Describe change.

* doc/misc/eshell.texi: Add entry for `clear'.
2015-04-19 23:26:09 +05:30
Paul Eggert
279558f472 Minor quoting etc. fixes to misc manuals
Fix some minor quoting and spacing issues.  Distinguish more
clearly among grave accent and apostrophe (which are ASCII) and
single quote (which is not).  Prefer the standard terms
"apostrophe" and "grave accent" to alternative names that can be
confusing.  Use apostrophes to single-quote ASCII text.
* doc/misc/remember.texi: Spell the mystic's pseudonym in UTF-8
rather than approximating it in ASCII with grave accent.
2015-04-11 07:48:21 -07:00
Tassilo Horn
1ba357e305 Add notice to visual commands section
* doc/misc/eshell.texi (Input/Output): Add notice that some tools
such as git call less with its -F option which omits pagination if
the contents is less than one page long.  This interferes with
eshell's visual (sub-)commands.
2015-04-08 09:57:58 +02:00
Paul Eggert
41278b775b Spacing and punctuation fixes 2015-03-17 16:56:21 -07:00
Paul Eggert
52a4e87c63 Fix copyright years by hand
These are dates that admin/update-copyright did not update, or
updated incorrectly.  Also, back out the copyright-date change to
doc/misc/texinfo.tex, as upstream hasn't updated that date yet.
2015-01-01 14:27:34 -08:00
Glenn Morris
29993416fb Add .info extension to @setfilename commands in doc/
This makes no difference to anything, since we always use makeinfo -o,
but it makes automake happier, if we ever decide to use that.
2014-06-09 22:20:31 -04:00
Glenn Morris
4181427f24 Doc fixes: markup (mainly nil -> @code{nil}) 2014-06-08 16:39:23 -07:00
Glenn Morris
551a89e12d Standardize case of "Front-Cover Texts" in texi file permissions notices.
Ref: http://lists.gnu.org/archive/html/bug-texinfo/2014-05/msg00015.html
2014-05-07 13:34:53 -04:00
Glenn Morris
d29fbf47e4 Use @file for buffers, per the Texinfo manual
* doc/misc/ada-mode.texi, doc/misc/auth.texi, doc/misc/calc.texi:
* doc/misc/ebrowse.texi, doc/misc/efaq.texi, doc/misc/emacs-gnutls.texi:
* doc/misc/epa.texi, doc/misc/ert.texi, doc/misc/eshell.texi:
* doc/misc/eww.texi, doc/misc/flymake.texi, doc/misc/gnus.texi:
* doc/misc/info.texi, doc/misc/message.texi, doc/misc/mh-e.texi: 
* doc/misc/newsticker.texi, doc/misc/pcl-cvs.texi, doc/misc/rcirc.texi:
* doc/misc/sem-user.texi, doc/misc/smtpmail.texi, doc/misc/url.texi:
* doc/misc/viper.texi, doc/misc/wisent.texi, doc/misc/woman.texi: 
Use @file for buffers, per the Texinfo manual.
2014-03-12 16:52:34 -04:00
Paul Eggert
c6ab4664a6 Specify .texi encoding.
* emacs-lisp-intro.texi:
* back.texi, book-spine.texi, lay-flat.texi:
* ada-mode.texi, auth.texi, autotype.texi, bovine.texi, calc.texi:
* cc-mode.texi, cl.texi, dbus.texi, dired-x.texi, ebrowse.texi:
* ede.texi, ediff.texi, edt.texi, efaq.texi, eieio.texi:
* emacs-gnutls.texi, epa.texi, erc.texi, ert.texi:
* eshell.texi, eudc.texi, flymake.texi, forms.texi, gnus-coding.texi:
* gnus-faq.texi, htmlfontify.texi, idlwave.texi, ido.texi, info.texi:
* message.texi, mh-e.texi, newsticker.texi, nxml-mode.texi:
* octave-mode.texi, org.texi, pcl-cvs.texi, pgg.texi, rcirc.texi:
* reftex.texi, remember.texi, sasl.texi, sc.texi, semantic.texi:
* ses.texi, sieve.texi, smtpmail.texi, speedbar.texi, srecode.texi:
* todo-mode.texi, tramp.texi, url.texi, vip.texi, viper.texi:
* widget.texi, wisent.texi, woman.texi:
Add @documentencoding.
2014-01-05 21:25:46 -08:00
Paul Eggert
da5ecfa9b9 Spelling fixes.
* lib-src/Makefile.in (regex.o): Remove reference to no-longer-used macros
CONFIG_BROKETS and INHIBIT_STRING_HEADER.  "BROKETS" was a
misspelling anyway....
* src/nsterm.h (updateCollectionBehavior): Rename from
updateCollectionBehaviour.  All uses changed.
2014-01-04 18:56:08 -08:00
Aidan Gauland
22db5dd5ed * eshell.texi (What Eshell is not): Clean up confusing clause. 2014-01-04 12:14:16 +13:00
Aidan Gauland
8f9740f0e7 * eshell.text (top): Fix incorrect use of xref. 2014-01-03 14:55:15 +13:00
Aidan Gauland
112720b181 * eshell.text (top): Fix incorrect info filename in an xref. 2014-01-03 09:17:19 +13:00
Aidan Gauland
f2299e89bc * eshell.text (Command Basics): Removed `Command basics' chapter. 2014-01-02 22:32:20 +13:00
Aidan Gauland
94ee87197f * eshell.text (What is Eshell?): Add section about what not to use Eshell for. 2014-01-02 22:27:46 +13:00
Paul Eggert
6bc383b1a4 Fix copyright years by hand.
These are dates that admin/update-copyright did not update,
or updated incorrectly.
2014-01-01 00:31:29 -08:00
Eli Zaretskii
634425957a Revert @documentencoding changes in the docs. 2013-12-30 19:08:32 +02:00
Paul Eggert
dcd812be6a Specify info encoding and language.
* emacs.texi, emacs-xtra.texi:
* emacs-lisp-intro.texi:
* back.texi, book-spine.texi, elisp.texi, lay-flat.texi:
* ada-mode.texi, auth.texi, autotype.texi, bovine.texi, calc.texi:
* cc-mode.texi, cl.texi, dbus.texi, dired-x.texi, ebrowse.texi:
* ede.texi, ediff.texi, edt.texi, efaq-w32.texi, efaq.texi:
* eieio.texi, emacs-gnutls.texi, emacs-mime.texi, epa.texi, erc.texi:
* ert.texi, eshell.texi, eudc.texi, flymake.texi, forms.texi:
* gnus-coding.texi, gnus-faq.texi, gnus.texi, htmlfontify.texi:
* idlwave.texi, ido.texi, info.texi, mairix-el.texi, message.texi:
* mh-e.texi, newsticker.texi, nxml-mode.texi, octave-mode.texi:
* org.texi, pcl-cvs.texi, pgg.texi, rcirc.texi, reftex.texi:
* remember.texi, sasl.texi, sc.texi, semantic.texi, ses.texi:
* sieve.texi, smtpmail.texi, speedbar.texi, srecode.texi:
* todo-mode.texi, tramp.texi, url.texi, vip.texi, viper.texi:
* widget.texi, wisent.texi, woman.texi:
Add @documentencoding, @documentlanguage as needed.

Fixes: debbugs:16292
2013-12-29 19:19:25 -08:00
Glenn Morris
76f1a3c314 Remove remaining @refills from doc/*/*.texi files 2013-10-23 13:20:09 -04:00
Glenn Morris
fe30962e0b * doc/misc/eshell.texi: Markup fixes. 2013-09-14 16:47:54 -07:00
Glenn Morris
6ccb9cab43 Merge from emacs-24; up to 2013-01-01T11:02:14Z!rudalics@gmx.at 2013-07-25 00:10:56 -07:00
Glenn Morris
7add5a8a7a Reduce use of @email in doc/misc
In many cases it serves no purpose.  It gets converted to mailto:
in html output, which is mainly just an invitation to get spam.

* doc/misc/erc.texi (Special Features): Update contact information.
(History): Avoid using @email.

* doc/misc/eshell.texi (Bugs and ideas): Minor updates.

* doc/misc/faq.texi (Reporting bugs, Origin of the term Emacs)
(Setting up a customization file)
(Using an already running Emacs process, Turning off beeping)
(Packages that do not come with Emacs)
(Replying to the sender of a message): Avoid using @email.

* doc/misc/pcl-cvs.texi (Contributors, Bugs): Avoid using @email.

* doc/misc/reftex.texi (Imprint): Avoid using @email.

* doc/misc/ses.texi (Top): Update bug reporting instructions.
(Acknowledgments): Avoid using @email.

* doc/misc/woman.texi (Introduction, Background): Remove outdated information.
(Bugs, Acknowledgments): Avoid using @email.
2013-07-24 21:25:18 -04:00
Glenn Morris
f99f7826a0 Merge from emacs-24; up to 2012-12-29T06:14:00Z!cyd@gnu.org 2013-06-23 23:58:52 -07:00
Glenn Morris
7eeeb7ddc9 * doc/misc/eshell.texi: Fix cross-references to other manuals. 2013-06-23 17:42:12 -07:00
Aidan Gauland
fa4729064f Update Ehsell visual-commands documentation
* eshell.texi (Input/Output): Expand to cover new visual-command
options, eshell-visual-subcommands and eshell-visual-options.
Divide into separate Visual Commands and Redirection sections.
* eshell/em-term.el (eshell-visual-commands)
(eshell-visual-subcommands)
(eshell-visual-options): Add summary line to docstrings.  Add
cross-references.
2013-06-10 14:41:49 +12:00
Aidan Gauland
15e4ed9c6a Added eshell-tramp module
* lisp/eshell/em-unix.el: Moved su and sudo to...
* lisp/eshell/em-tramp.el: ...Eshell tramp module
* doc/misc/eshell.texi: Updated manual to reflect changes.

External su and sudo commands are now the default; the internal,
TRAMP-using variants can still be used by enabling the eshell-tramp
module.
2013-03-27 11:08:58 +13:00
Paul Eggert
e26aa21a46 Port to Texinfo 5.0 by backporting trunk 2012-12-22T19:57:35Z!rgm@gnu.org and 2013-02-21T02:42:30Z!eggert@cs.ucla.edu. 2013-02-21 13:33:04 -08:00
Paul Eggert
2fce4cd861 Port documentation to Texinfo 5.0. 2013-02-20 18:42:30 -08:00
Aidan Gauland
6a0fda530d Documented Eshell's insert output-redirection operator 2013-02-19 07:27:51 +13:00
Glenn Morris
01fcc3a532 Merge from emacs-24; up to 2012-12-17T11:17:34Z!rgm@gnu.org 2013-02-12 20:31:09 -08:00
Paul Eggert
65e7ca35a6 In doc, use standard American English style for e.g., etc., i.e. 2013-02-12 09:36:54 -08:00
Glenn Morris
078891963d Merge from emacs-24; up to 2012-12-14T21:27:39Z!rgm@gnu.org 2013-02-08 09:23:24 -08:00
Aidan Gauland
dacbc44ca3 * doc/misc/eshell.texi: Fill most of the missing sections. 2013-02-08 09:59:24 -05:00
Aidan Gauland
c7205e5387 * doc/misc/eshell.texi: Fill most of the missing sections. 2013-02-08 09:44:17 -05:00
Glenn Morris
7a2657fa3b Merge from emacs-24; up to 2012-12-07T08:13:49Z!dmantipov@yandex.ru 2013-01-05 13:18:01 -08:00
Andreas Schwab
db671917a8 Fix manual formatting errors
* lispref/hooks.texi (Standard Hooks): Fix use of @itemx.

* misc/ada-mode.texi: Remove braces from @title argument.
* misc/eudc.texi: Likewise.
* misc/smtpmail.texi: Likewise.
* misc/auth.texi (VERSION): Set before first use.
* misc/emacs-gnutls.texi (VERSION): Likewise.
* misc/pgg.texi (VERSION): Likewise.
* misc/ede.texi (Top): Rename from top, all uses changed.
* misc/eshell.texi: Add missing argument to @sp.
* misc/forms.texi (Top): Reorder menu to match structure.
* misc/htmlfontify.texi (Customisation): Add missing @item in
@enumerate.
* misc/org.texi (Advanced features): Add missing argument for @item.
(Property searches): Use @backslashchar{} in macro argument.
* misc/pcl-cvs.texi: Add missing argument to @sp.
(Movement commands): Fix use of @itemx.
* misc/vip.texi (Misc Commands, Viewing the Buffer): Likewise.
* misc/reftex.texi (Options (Creating Citations)): Add missing newline
before @end.
* misc/tramp.texi (Obtaining Tramp): Remove extra dots.
(Configuration): Reorder menu to match structure.
* misc/viper.texi (Marking): Add missing argument for @item.
2013-01-05 17:19:53 +01:00
Paul Eggert
0877d0dc24 Merge from emacs-24; up to 2012-12-06T01:39:03Z!monnier@iro.umontreal.ca 2013-01-02 08:13:04 -08:00
Paul Eggert
ab422c4d68 Update copyright notices for 2013. 2013-01-01 09:11:05 +00:00
Glenn Morris
563a450c01 Remove more hand-written node pointers in doc/misc 2012-12-22 11:49:54 -08:00
Paul Eggert
f99f164170 Hyphen and dash fixes in texinfo files. 2012-12-22 08:25:40 -08:00
Glenn Morris
6bf430d146 Don't say "buying copies from the FSF" for manuals they do not publish
Ref "License Notices for Documentation" in maintain.info
2012-12-21 10:36:41 -08:00
Paul Eggert
1df7defd80 Fix minor whitespace issues after "." in manual.
Be more systematic about using "@." (not ".") at end of sentence that
ends in a capital letter, and about appending "@:" after non-ends of
sentences that end in a lower case letter followed by "." followed by
whitespace.  Omit unnecessary use of "@:" and "@.".  Similarly for "?"
and "!".  Be more consistent about putting a comma after "i.e." and
"e.g."; this is the typical American style and it's easier to code in
Texinfo.

Fixes: debbugs:12973
2012-12-05 14:27:56 -08:00
Glenn Morris
44e97401cd Standardize possessive apostrophe usage in manuals, docs, and comments
Ref: http://lists.gnu.org/archive/html/emacs-devel/2012-02/msg00649.html
2012-02-28 00:17:21 -08:00
Glenn Morris
49f70d46ea Add 2012 to FSF copyright years for Emacs files (do not merge to trunk) 2012-01-10 23:52:35 -08:00
Glenn Morris
acaf905b11 Add 2012 to FSF copyright years for Emacs files 2012-01-05 01:46:05 -08:00
Paul Eggert
fa46310344 Spelling fixes. 2011-12-05 00:55:25 -08:00
Paul Eggert
5396468298 Spelling fixes. 2011-11-19 01:18:31 -08:00
Paul Eggert
91af3942e9 Spelling fixes. 2011-11-14 15:59:56 -08:00