[latexrefman-commits] r333 - in /trunk: ChangeLog Makefile NEWS aspell.en.pws latex2e.texi
karl at domain.hid
karl at domain.hid
Tue May 12 19:12:38 CEST 2015
Author: karl
Date: Tue May 12 19:12:37 2015
New Revision: 333
URL: http://svn.gna.org/viewcvs/latexrefman?rev=333&view=rev
Log:
prepare for dist; new target check-dw; tweak intro text
Modified:
trunk/ChangeLog
trunk/Makefile
trunk/NEWS
trunk/aspell.en.pws
trunk/latex2e.texi
Modified: trunk/ChangeLog
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/ChangeLog?rev=333&r1=332&r2=333&view=diff
==============================================================================
--- trunk/ChangeLog (original)
+++ trunk/ChangeLog Tue May 12 19:12:37 2015
@@ -1,3 +1,16 @@
+2015-05-12 Karl Berry <karl at domain.hid>
+
+ * latex2e.texi (@settitle): unofficial.
+ (About this document): reword a bit.
+ (UPDATED): now it's May.
+ More indexing.
+
+ * Makefile (check-dw): new target.
+ * latex2e.texi: remove doubled words.
+
+ * Makefile (txt_files): add aspell.en.pws.
+ (check-en): try spell-en first.
+
2015-05-08 Karl Berry <karl at domain.hid>
* latex2e.texi (Non-English characters): tersely define \dj \DJ
Modified: trunk/Makefile
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/Makefile?rev=333&r1=332&r2=333&view=diff
==============================================================================
--- trunk/Makefile (original)
+++ trunk/Makefile Tue May 12 19:12:37 2015
@@ -51,7 +51,7 @@
# exercise significantly different code paths), and pdf for tex.
check_suffixes = html info pdf
#
-check-en: $(addprefix latex2e., $(check_suffixes))
+check-en: spell-en $(addprefix latex2e., $(check_suffixes))
check-es: $(addprefix latex2e-es., $(check_suffixes))
check-fr: $(addprefix latex2e-fr., $(check_suffixes))
check: check-en check-es check-fr
@@ -71,18 +71,14 @@
realclean maintainer-clean: distclean
rm -f $(addprefix latex2e*., pdf dvi $(mi_suffixes))
-# remove \commandnames, but not {args} or [args], they are often words.
-spell spell-en:
- sed -e 's/\\[a-zA-z]*//g' latex2e.texi \
- | aspell list --mode=texinfo --add-extra-dicts=`pwd`/aspell.en.pws \
- | sort -f -u
-
-#
-# We combine all into one zip for upload. Will change if the
+
+#
dist.
+#
+# We combine languages into one zip for upload. Will change if the
# translations ever become separately uploaded.
# Don't bother including .dvi files.
#
-txt_files = ChangeLog Makefile NEWS README ltx-help.el
+txt_files = ChangeLog Makefile NEWS README aspell.en.pws ltx-help.el
dist = latex2e-help-texinfo.zip
#
dist: all
@@ -96,8 +92,21 @@
rm -rf latex2e-help-texinfo spanish
@ls -l $(dist); unzip -t $(dist)
-# convenience targets to svn revert the generated files,
-# and diff the source files.
+# A hacky spell check target.
+# Remove \commandnames to reduce exception list, but not {args} or
+# [args], since they are often words.
+spell spell-en:
+ sed -e 's/\\[a-zA-z]*//g' latex2e.texi \
+ | aspell list --mode=texinfo --add-extra-dicts=`pwd`/aspell.en.pws \
+ | sort -f -u
+
+# Check for doubled words.
+# http://www.math.utah.edu/~beebe/software/file-tools.html#dw
+check-dw:
+ grep -v '^@item' latex2e.texi | dw
+
+# Convenience targets to svn revert the generated files,
+# and svn diff the source files.
svr:
svn revert $(addprefix latex2e*., $(all_suffixes))
svd:
Modified: trunk/NEWS
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/NEWS?rev=333&r1=332&r2=333&view=diff
==============================================================================
--- trunk/NEWS (original)
+++ trunk/NEWS Tue May 12 19:12:37 2015
@@ -9,12 +9,12 @@
Usual bug fixes, more indexing, template updates.
Improve document and LaTeX overview, including general syntax.
-Mention common engines, core classes, output files, italic corrections,
- pict2e.
+Mention common engines, core classes, output files, italic corrections, pict2e.
Clarify optional arguments.
Avoid using plain's \sup, since @sup will be a Texinfo command.
For HTML, make the Up from Top be http://tug.org/texinfohtml.
-Exception word list for spell checking, and make target.
+Exception word list for spell checking, and make target for spell
+ checking and doubled words.
-
French translation begun (only in sources); Spanish translation updated.
Thanks to Vincent Belaiche and Jim Hefferon for their many contributions.
@@ -24,7 +24,7 @@
Usual bug fixes, template updates.
Add filecontents description, fnsymbol info, non-obsolescence of \tt et al.,
-mostly due to Vincent Belaiche.
+ mostly due to Vincent Belaiche.
Updates to Spanish translation, also from Vincent.
----------------------------------------------------------------
Modified: trunk/aspell.en.pws
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/aspell.en.pws?rev=333&r1=332&r2=333&view=diff
==============================================================================
--- trunk/aspell.en.pws (original)
+++ trunk/aspell.en.pws Tue May 12 19:12:37 2015
@@ -11,6 +11,7 @@
dvitype
eg
ek
+eng
eth
executivepaper
f's
@@ -56,3 +57,5 @@
xelatex
xyz
zet
+ptr
+usrguide
Modified: trunk/latex2e.texi
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/latex2e.texi?rev=333&r1=332&r2=333&view=diff
==============================================================================
--- trunk/latex2e.texi (original)
+++ trunk/latex2e.texi Tue May 12 19:12:37 2015
@@ -2,8 +2,8 @@
@c $Id$
@comment %**start of header (This is for running Texinfo on a region.)
@setfilename latex2e.info
- at domain.hid UPDATED April 2015
- at domain.hid @LaTeX{}2e reference manual (@value{UPDATED})
+ at set UPDATED May 2015
+ at settitle @LaTeX{}2e unofficial reference manual (@value{UPDATED})
@comment %**end of header (This is for running Texinfo on a region.)
@c latex 2.09 commands should all be present now,
@@ -22,7 +22,7 @@
@c xx The typeset source2e has an index with all kernel
@c xx commands, though some are internal and shouldn't be included.
@c xx classes.dtx et al. define additional commands.
- at domain.hid xx See also http://www.ctan.org/pkg/macros2e.
+ at c xx See also http://ctan.org/pkg/macros2e.
@copying
This document is an unofficial reference manual for @LaTeX{}, a
@@ -75,7 +75,7 @@
@end tex
@titlepage
- at domain.hid @LaTeX{}: An unofficial reference manual
+ at title @LaTeX{}2e: An unofficial reference manual
@subtitle @value{UPDATED}
@author @url{http://home.gna.org/latexrefman}
@page
@@ -87,12 +87,10 @@
@contents
@node Top
- at domain.hid @LaTeX{}2e
-
-This document is an unofficial reference manual for @LaTeX{}, a
-document preparation system, version as of @value{UPDATED}. It is
-intended to cover @LaTeX{}2e, which has been the standard version of
- at domain.hid{} for many years.
+ at top @LaTeX{}2e: An unofficial reference manual
+
+This document is an unofficial reference manual (version of
+ at value{UPDATED}) for @LaTeX{}2e, a document preparation system.
@menu
* About this document:: Bug reporting, etc.
@@ -130,14 +128,24 @@
@node About this document
@chapter About this document
- at domain.hid @LaTeX{} Project team
@cindex bug reporting
@cindex reporting bugs
+ at findex @url{http://home.gna.org/latexrefman} @r{home page}
+This is an unofficial reference manual for the @LaTeX{}2e document
+preparation system, which is a macro package for the @TeX{}
+typesetting program (@pxref{Overview}). This document's home page is
+ at url{http://home.gna.org/latexrefman}. That page has links to the
+current output in various formats, sources, mailing list archives and
+subscriptions, and other infrastructure.
+
+ at cindex @LaTeX{} vs.@: @LaTeX{}2e
+In this document, we will mostly just use `@LaTeX{}' rather than
+`@LaTeX{}2e', since the previous version of @LaTeX{}@tie{}(2.09) was
+retired many years ago.
+
+ at cindex unofficial nature of this manual
+ at cindex @LaTeX{} Project team
@findex @email{latexrefman-discuss at domain.hid} @r{email address}
-This is an unofficial reference manual for the the @LaTeX{} document
-preparation system, which is a macro package for the @TeX{} typesetting
-program (@pxref{Overview}).
-
@LaTeX{} is currently maintained by a group of volunteers
(@url{http://latex-project.org}). The official documentation written by
the @LaTeX{} project is available from their web site. This document is
@@ -146,30 +154,31 @@
document to them. Instead, please send all comments to
@email{latexrefman-discuss at domain.hid}.
-The home page for this document is
- at domain.hid}. That page has links to the
-current output in various formats, sources, mailing lists, and other
-infrastructure.
-
-Besides this document there are many, many other sources of information
-about @LaTeX{}. Here are a few for beginners.
+This document is a reference. There is a vast array of other sources
+of information about @LaTeX{}, at all levels. Here are a few
+introductions.
@table @url
- at domain.hid http://www.ctan.org/pkg/latex-doc-ptr
+ at item http://ctan.org/pkg/latex-doc-ptr
+ at findex latex-doc-ptr @r{document}
Two pages of recommended references to @LaTeX{} documentation.
- at domain.hid http://www.ctan.org/pkg/first-latex-doc
+ at item http://ctan.org/pkg/first-latex-doc
+ at findex first-latex-doc @r{document}
Writing your first document, with a bit of both text and math.
- at domain.hid http://www.ctan.org/pkg/usrguide
+ at item http://ctan.org/pkg/usrguide
+ at findex usrguide @r{official documentation}
The guide for document authors that is maintained as part of @LaTeX{};
there are plenty of others available elsewhere.
- at domain.hid http://www.ctan.org/pkg/lshort
+ at item http://ctan.org/pkg/lshort
+ at findex lshort @r{document}
A short introduction to @LaTeX{}, translated to many languages.
@item http://tug.org/begin.html
-Introduction to the @TeX{} system, including @LaTeX{}.
+Introduction to the @TeX{} system, including @LaTeX{}, with further
+references.
@end table
@@ -272,9 +281,9 @@
@findex dvitype @r{command}
If @LaTeX{} is invoked with the system command @command{latex} then it
produces a DeVice Independent file, with extension @file{.dvi}. You
-you can view this file with a command such as @command{xdvi}, or
-convert it to a PostScript @code{.ps} file with @command{dvips} or to
-a Portable Document Format @code{.pdf} file with @command{dvipdfmx}.
+can view this file with a command such as @command{xdvi}, or convert
+it to a PostScript @code{.ps} file with @command{dvips} or to a
+Portable Document Format @code{.pdf} file with @command{dvipdfmx}.
The contents of the file can be dumped in human-readable form with
@command{dvitype}. A vast array of other DVI utility programs are
available (@url{http://mirror.ctan.org/tex-archive/dviware}).
More information about the latexrefman-commits
mailing list