[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 02/02: Version 1.22.3 released =======================
|
From: |
Werner LEMBERG |
|
Subject: |
[groff] 02/02: Version 1.22.3 released ======================= |
|
Date: |
Tue, 04 Nov 2014 07:48:40 +0000 |
wl pushed a commit to branch master
in repository groff.
commit 1972622d770b6c6ab68ae48ebf44af037aff9f1c
Author: Werner Lemberg <address@hidden>
Date: Tue Nov 4 07:55:53 2014 +0100
Version 1.22.3 released
=======================
* NEWS, README, doc/webpage.ms: Updated.
* doc/texinfo.tex: Updated from `texinfo' repository.
---
ChangeLog | 9 ++
NEWS | 22 +++---
README | 16 ++--
arch/mingw/zzz | 17 ----
doc/texinfo.tex | 27 +++++--
doc/webpage.ms | 230 ++++++++++++++++++++++++++++++++++++++++++-------------
6 files changed, 221 insertions(+), 100 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index 86b82a2..0fc5254 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2014-11-04 Werner LEMBERG <address@hidden>
+
+Version 1.22.3 released
+=======================
+
+ * NEWS, README, doc/webpage.ms: Updated.
+
+ * doc/texinfo.tex: Updated from `texinfo' repository.
+
2014-10-29 Bertrand Garrigues <address@hidden>
* Makefile.in (OTHERDIRS): Mention `afmtodit' first.
diff --git a/NEWS b/NEWS
index cc615f0..eeb4090 100644
--- a/NEWS
+++ b/NEWS
@@ -13,19 +13,19 @@ VERSION 1.22.3
Gxditview
---------
-o X11 resources for gxditview, which were previously installed in
+o X11 resources for `gxditview', which were previously installed in
/usr/X11/lib/X11/app-defaults no matter which `prefix' was set, are
now installed in appresdir=$prefix/lib/X11/app-defaults. If
- appresdir is not a standard X11 resource directory, the environment
+ `appresdir' is not a standard X11 resource directory, the environment
variable XFILESEARCHPATH should be set to this path. The standard
- default directories depends on the system libXt. Common directories
+ default directories depends on the system `libXt'. Common directories
include:
/usr/lib/X11/app-defaults
/usr/share/X11/app-defaults
/etc/X11/app-defaults
- Note that if the option --with-appresdir is passed to `configure',
+ Note that if the option `--with-appresdir' is passed to `configure',
the `prefix' will not be added to `appresdir'.
@@ -33,8 +33,8 @@ Glilypond
---------
o This new preprocessor (contributed by Bernd Warken) allows embedding of
- code for GNU Lilypond, a music typesetter. The data gets automatically
- processed and embedded as EPS images.
+ code for GNU LilyPond (http://www.lilypond.org), a music typesetter. The
+ data gets automatically processed and embedded as EPS images.
Gperl
@@ -47,8 +47,8 @@ o Bernd Warken contributed a new preprocessor to handle Perl
code that can
Gpinyin
-------
-o Another preprocessor from Bernd Warken to pretty-print Pinyin syllables like
- `guo2wang2' as `guówáng'.
+o Another preprocessor from Bernd Warken to pretty-print Pinyin syllables
+ like `guo2wang2' as `guówáng'.
Pdfroff
@@ -64,9 +64,9 @@ o The pdfroff utility script now activates its
`--no-toc-relocation' option
phase of processing, as pdfroff sets it to 1 or 2 in the output phase,
but leaves it unset in the setup phase).
- The bundled spdf.tmac macro package, which implicitly activates `-mpdfmark'
- for `ms' macro users, ensures that TOC relocation is appropriately enabled,
- when the `.TC' macro is invoked.
+ The bundled `spdf.tmac' macro package, which implicitly activates
+ `-mpdfmark' for `ms' macro users, ensures that TOC relocation is
+ appropriately enabled, when the `.TC' macro is invoked.
Macro Packages
diff --git a/README b/README
index 3a629c0..951fedb 100644
--- a/README
+++ b/README
@@ -14,7 +14,7 @@ printers, `Canon CAPSL' printers, `HTML' and `XHTML' formats
(beta
status), and typewriter-like devices. Also included is a modified
version of the Berkeley `-me' macros, the enhanced version `gxditview'
of the X11 `xditview' previewer, and an implementation of the `-mm'
-macros contributed by Joergen Haegg (address@hidden).
+macros contributed by Joergen Haegg.
See the file `INSTALL' for instructions on how to install from a
release. You will require a C++ compiler.
@@ -32,7 +32,7 @@ The file `PROBLEMS' describes various problems that have been
encountered in compiling, installing, and running `groff'.
The file `MORE.STUFF' contains information about add-on packages
-useful for groff.
+useful for `groff'.
The most recent released version of `groff' is always available by
anonymous ftp from `ftp.gnu.org' in the directory `gnu/groff'.
@@ -52,7 +52,7 @@ line to get the URL.
Depending on your requirements, you may need at least some of the
following tools to build `groff' directly from its source:
- perl >= v5.6.1 (see macro GROFF_PERL in m4/groff.m4)
+ perl >= v5.6.1 (see macro GROFF_PERL in file `m4/groff.m4')
ghostscript
the psutils package
the netpbm package
@@ -68,15 +68,15 @@ original release of `bison' 1.875 is known not to work; you
*may* find
that `bison' releases < 1.875 work, but in case of difficulty, please
update to a later version *before* posting a bug report.
-For *all* sources, you need ghostscript for creation of either `PDF'
+For *all* sources, you need `ghostscript' for creation of either `PDF'
or `HTML' output; the `netpbm' and `psutils' packages are required
only for `HTML' output (and for compilation from the repository). If
you don't intend to produce output in either of these formats, then
these packages are unnecessary.
-Additionally, producing `PDF' output directly with the `gropdf' device
-needs a working installation of Perl. The same is true for the `chem'
-preprocessor.
+Additionally, producing `PDF' output directly with the `gropdf' device needs
+a working installation of `perl'. The same is true for some other
+preprocessors like `chem'.
In Linux Debian, the installation of `texinfo' is dangerous. For it
creates a file `install-info' that blocks the system installation. So
@@ -111,7 +111,7 @@ Three mailing lists are available:
To subscribe, send a mail to <list>-request@<domain> (example:
address@hidden for the `groff' list) with the word `subscribe'
-in either the subject or body of the email (don't include the quotes).
+in either the subject or body of the e-mail (don't include the quotes).
Alternatively, you may subscribe by visiting the web pages at
http://lists.gnu.org/mailman/listinfo/bug-groff
diff --git a/arch/mingw/zzz b/arch/mingw/zzz
deleted file mode 100644
index f6c6f3c..0000000
--- a/arch/mingw/zzz
+++ /dev/null
@@ -1,17 +0,0 @@
-afmtodit.cmd
-chem.cmd
-gperl.cmd
-gpinyin.cmd
-grap2graph.cmd
-groffer.cmd
-grog.cmd
-gropdf.cmd
-mmroff.cmd
-neqn.cmd
-pdfmom.cmd
-roff2dvi.cmd
-roff2html.cmd
-roff2pdf.cmd
-roff2ps.cmd
-roff2text.cmd
-roff2x.cmd
diff --git a/doc/texinfo.tex b/doc/texinfo.tex
index 6312dad..72c8cf4 100644
--- a/doc/texinfo.tex
+++ b/doc/texinfo.tex
@@ -3,7 +3,7 @@
% Load plain if necessary, i.e., if running under initex.
\expandafter\ifx\csname fmtname\endcsname\relax\input plain\fi
%
-\def\texinfoversion{2014-05-20.16}
+\def\texinfoversion{2014-10-29.10}
%
% Copyright 1985, 1986, 1988, 1990, 1991, 1992, 1993, 1994, 1995,
% 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
@@ -5739,13 +5739,16 @@ end
%
% #1 is the text, #2 is the section type (Ynumbered, Ynothing,
% Yappendix, Yomitfromtoc), #3 the chapter number.
+% Not used for @heading series.
%
% To test against our argument.
\def\Ynothingkeyword{Ynothing}
-\def\Yomitfromtockeyword{Yomitfromtoc}
\def\Yappendixkeyword{Yappendix}
+\def\Yomitfromtockeyword{Yomitfromtoc}
%
\def\chapmacro#1#2#3{%
+ \checkenv{}% chapters, etc., should not start inside an environment.
+ %
% Insert the first mark before the heading break (see notes for \domark).
\let\prevchapterdefs=\lastchapterdefs
\let\prevsectiondefs=\lastsectiondefs
@@ -5891,22 +5894,28 @@ end
% Print any size, any type, section title.
%
-% #1 is the text, #2 is the section level (sec/subsec/subsubsec), #3 is
-% the section type for xrefs (Ynumbered, Ynothing, Yappendix), #4 is the
-% section number.
+% #1 is the text of the title,
+% #2 is the section level (sec/subsec/subsubsec),
+% #3 is the section type (Ynumbered, Ynothing, Yappendix, Yomitfromtoc),
+% #4 is the section number.
%
\def\seckeyword{sec}
%
\def\sectionheading#1#2#3#4{%
{%
- \checkenv{}% should not be in an environment.
+ \def\sectionlevel{#2}%
+ \def\temptype{#3}%
+ %
+ % It is ok for the @heading series commands to appear inside an
+ % environment (it's been historically allowed, though the logic is
+ % dubious), but not the others.
+ \ifx\temptype\Yomitfromtockeyword\else
+ \checkenv{}% address@hidden should not be in an environment.
+ \fi
%
% Switch to the right set of fonts.
\csname #2fonts\endcsname \rmisbold
%
- \def\sectionlevel{#2}%
- \def\temptype{#3}%
- %
% Insert first mark before the heading break (see notes for \domark).
\let\prevsectiondefs=\lastsectiondefs
\ifx\temptype\Ynothingkeyword
diff --git a/doc/webpage.ms b/doc/webpage.ms
index 816d05d..2c75858 100644
--- a/doc/webpage.ms
+++ b/doc/webpage.ms
@@ -82,7 +82,7 @@ and its mirrors;
the current development version is available from a
.URL "https://\:savannah.gnu.org/\:git/\:?group=groff"; "git repository" .
.
-The current version is 1.22.2 (07-Feb-2013).
+The current version is 1.22.3 (04-Nov-2014).
To view the git repository in your browser, use
.URL "http://\:git.savannah.gnu.org/\:cgit/\:groff.git"; \
@@ -108,11 +108,11 @@ and
.HR
.
\s[-4]\f[I]This document was produced using
-.URL http://www.gnu.org/\:software/\:groff groff-\n[.x].\n[.y].\n[.Y] .
+.URL http://\:www.gnu.org/\:software/\:groff groff-\n[.x].\n[.y].\n[.Y] .
.br
The image at the top has been contributed by Imogen Mulley,
based on a similar picture found on the
-.URL http://www.gnu.org "GNU server" .
+.URL http://\:www.gnu.org "GNU server" .
.
.
.SH
@@ -130,49 +130,58 @@ README
This is the GNU groff document formatting system.
The version number is given in the file VERSION.
-Included in this release are implementations of troff, pic, eqn, tbl, grn,
-refer, \-man, \-mdoc, \-mom, and \-ms macros, and drivers for PostScript,
-PDF, TeX DVI format, HP LaserJet\~4 printers, Canon CAPSL printers, HTML and
-XHTML formats (beta status), and typewriter-like devices.
-Also included is a modified version of the Berkeley \-me macros, the enhanced
-version gxditview of the X11 xditview previewer, and an implementation of the
-\-mm macros contributed by
-.MTO address@hidden:axis.se "J\[:o]rgen H\[:a]gg" .
-
-See the file INSTALL for installation instructions.
+Included in this release are implementations of `troff', `pic', `eqn',
+`tbl', `grn', `refer', `\-man', `\-mdoc', `\-mom', and `\-ms' macros, and
+drivers for `PostScript', `PDF', `TeX DVI' format, `HP LaserJet\~4'
+printers, `Canon CAPSL' printers, `HTML' and `XHTML' formats (beta status),
+and typewriter-like devices. Also included is a modified version of the
+Berkeley `\-me' macros, the enhanced version `gxditview' of the X11
+`xditview' previewer, and an implementation of the `\-mm' macros contributed
+by J\[:o]rgen H\[:a]gg.
+
+See the file `INSTALL' for installation instructions on how to install from
+a release.
You require a C++ compiler.
-The file NEWS describes recent user-visible changes to groff.
+The file `INSTALL.REPO' contains supplementary instructions for building
+directly from a clone of the repository or a snapshot tarball.
+
+The file `NEWS' describes recent user-visible changes to `groff'.
-Groff is free software.
-See the file COPYING for copying permission.
+`groff' is free software.
+See the file `COPYING' for copying permission.
-The file PROBLEMS describes various problems that have been encountered in
-compiling, installing, and running groff.
+The file `PROBLEMS' describes various problems that have been encountered in
+compiling, installing, and running `groff'.
-The file MORE.STUFF contains information about add-on packages useful for
-groff.
+The file `MORE.STUFF' contains information about add-on packages useful for
+`groff'.
.
.
.SH
Repository and FTP access
.LP
-The most recent released version of groff is always available by
+The most recent released version of `groff' is always available by
.URL "ftp://\:ftp.gnu.org/\:gnu/\:groff"; "anonymous ftp" .
-The current development version of groff is available from a
-repository which you can find through the Savannah project page for groff:
-.URL http://savannah.gnu.org/projects/groff .
+The current development version of `groff' is available from a
+.URL http://\:savannah.gnu.org/\:git/\:?group=groff "git repository" .
+
+To view the git repository in your browser, go to its
+.URL http://\:git.savannah.gnu.org/\:cgit/\:groff.git "browser interface" .
+There you can also download snapshots; simply click on a commit entry
+line to get the URL.
.
.
.SH
Groff dependencies
.LP
Depending on your requirements, you may need at least some of the
-following tools to build groff directly from its source:
+following tools to build `groff' directly from its source:
.in 2m
.nf
+perl >= v5.6.1 (see macro GROFF_PERL in file `m4/groff.m4')
ghostscript
the psutils package
the netpbm package
@@ -181,44 +190,49 @@ bison \[>=] 1.875b or byacc
.fi
.in
-Note that texinfo and bison or byacc are required only for building from
-repository sources (either a working copy, or a daily snapshot).
+Note that `texinfo' and `bison' or `byacc' are required only for building
+from repository sources (either a checked out working copy, or a commit
+snapshot).
They are not required for building from a stable release tarball.
Also note that the version numbers stated are the minimum supported.
-No version of texinfo < 4.8 works, and the original release of bison
-1.875 is known not to work; you \fImay\fP find that bison releases < 1.875
+No version of `texinfo' < 4.8 works, and the original release of `bison'
+1.875 is known not to work; you \fImay\fP find that `bison' releases < 1.875
work, but in case of difficulty, please update to a later version
\fIbefore\fP posting a bug report.
-
-For \fIall\fP sources, you need ghostscript for creation of either PDF or
-HTML output; the netpbm and psutils packages are required only for HTML
-output.
+For \fIall\fP sources, you need `ghostscript' for creation of either `PDF'
+or `HTML' output; the `netpbm' and `psutils' packages are required only for
+`HTML' output.
If you don't intend to produce output in either of these formats, then
these packages are unnecessary.
-Additionally, producing `PDF' output directly with the `gropdf' device
-needs a working installation of Perl.
+Additionally, producing `PDF' output directly with the `gropdf' device needs
+a working installation of `perl'.
+The same is true for some other preprocessors like `chem'.
-In Linux Debian, the installation of texinfo is dangerous, for it creates a
-file install-info that blocks the system installation.
-So the created /usr/local/bin/install-info must be renamed.
+In Linux Debian, the installation of `texinfo' is dangerous, for it creates
+a file `install-info' that blocks the system installation.
+So the created `/usr/local/bin/install-info' must be renamed.
-The groff configure script searches for the X11 headers and libraries Xaw
-and Xmu.
+The `groff' configure script searches for the X11 headers and libraries
+`Xaw' and `Xmu'.
So the corresponding developer packages of your system must be installed,
-otherwise groff does not install gxditview and the -TX* devices.
-In Debian, the developer packages are libxaw7-dev and libxmu-dev.
+otherwise `groff' does not install `gxditview' and the `-TX*' devices.
+In Debian, the developer packages are `libxaw7-dev' and `libxmu-dev'.
.
.
.SH
Bug reports
.LP
-Please report bugs using the form in the file BUG-REPORT; the idea of this
-is to make sure that FSF has all the information it needs to fix the bug.
-At the very least, read the BUG-REPORT form and make sure that you supply
+Please report bugs using the project's
+.URL https://\:savannah.gnu.org/\:projects/\:groff "bug tracker" .
+
+Alternatively, but less preferable, you may use the form in the file
+`BUG-REPORT'; the idea of this is to make sure that FSF has all the
+information it needs to fix the bug.
+At the very least, read the `BUG-REPORT' form and make sure that you supply
all the information that it asks for.
Even if you are not sure that something is a bug, report it using
-BUG-REPORT: this enables us to determine whether it really is a bug or
+`BUG-REPORT': this enables us to determine whether it really is a bug or
not.
.
.
@@ -230,7 +244,7 @@ Three mailing lists are available:
.ULS
.LI
.MTO address@hidden address@hidden
-for reporting bugs
+for reporting bugs and following bug reports
.LI
.MTO address@hidden address@hidden
@@ -238,10 +252,10 @@ for general discussion of groff
.LI
.MTO address@hidden address@hidden
-a read-only list showing commitments to the development repository
+a read-only list showing commits to the git repository
.ULE
-To subscribe, send e-mail to address@hidden
+To subscribe, send a mail to address@hidden
(example:
.MTO address@hidden:gnu.org address@hidden:gnu.org
for the `groff' list) with the word `subscribe' in either the
@@ -261,6 +275,112 @@ postings to the corresponding mailing list.
.
.
.SH
+NEWS VERSION 1.22.3
+.LP
+.SH 2
+gxditview
+
+.ULS
+.LI
+X11 resources for gxditview, which were previously installed in
+/usr/X11/lib/X11/app-defaults no matter which `prefix' was set, are
+now installed in appresdir=$prefix/lib/X11/app-defaults.
+If `appresdir' is not a standard X11 resource directory, the environment
+variable XFILESEARCHPATH should be set to this path.
+The standard default directories depends on the system `libXt'.
+Common directories include:
+
+.in 2m
+.nf
+/usr/lib/X11/app-defaults
+/usr/share/X11/app-defaults
+/etc/X11/app-defaults
+.fi
+.in
+
+Note that if the option `\-\-with\-appresdir' is passed to `configure', the
+`prefix' will not be added to `appresdir'.
+.ULE
+.
+.
+.SH 2
+glilypond
+
+.ULS
+.LI
+This new preprocessor (contributed by Bernd Warken) allows embedding of code
+for
+.URL http://\:www.lilypond.org "GNU LilyPond" ,
+a music typesetter.
+The data gets automatically processed and embedded as EPS images.
+.ULE
+.
+.
+.SH 2
+gperl
+
+.ULS
+.LI
+Bernd Warken contributed a new preprocessor to handle Perl code that can be
+evaluated and then processed by groff.
+.ULE
+.
+.
+.SH 2
+gpinyin
+
+.ULS
+.LI
+Another preprocessor from Bernd Warken to pretty-print Pinyin syllables like
+`guo2wang2' as `gu\['o]w\['a]ng'.
+.ULE
+.
+.
+.SH 2
+pdfroff
+
+.ULS
+.LI
+The pdfroff utility script now activates its `\-\-no\-toc\-relocation'
+option by default, unless a request similar to:
+
+.in 2m
+.nf
+\&.if !\en[PHASE] .tm pdfroff-option:set toc_relocation=enabled
+.fi
+.in
+
+is invoked during input file processing; (`.if !\en[PHASE] ...' ensures
+that the effect of the `.tm' request is restricted to the document setup
+phase of processing, as pdfroff sets it to 1 or\~2 in the output phase,
+but leaves it unset in the setup phase).
+
+The bundled `spdf.tmac' macro package, which implicitly activates
+`\-mpdfmark' for `ms' macro users, ensures that TOC relocation is
+appropriately enabled, when the `.TC' macro is invoked.
+.ULE
+.
+.
+.SH 2
+macro packages
+
+.ULS
+.LI
+The \-mom macro package now has full support for eqn, pic, and tbl, as well
+as captioning and labelling of pdf images and preprocessor output.
+Lists of Figures, Equations, and Tables can now be autogenerated.
+PDF_IMAGE has a new FRAME option.
+
+.LI
+A French introduction to the \-me macro package has been added (file
+`meintro_fr.me').
+
+.LI
+In -mdoc, command %C is now available, providing a city or place reference.
+.ULE
+.
+.
+.SH
NEWS VERSION 1.22.2
.LP
.SH 2
@@ -502,7 +622,7 @@ This allows to reliably modify requests.
.in 2m
.nf
-.ft C
+.ft C
\&.als address@hidden bp
\&.de bp
\&. tm before bp
@@ -741,7 +861,7 @@ For example, a table with two cells and two rows looks like
this:
.in 2m
.nf
-.ft C
+.ft C
\&.TBL cols=2
\&. TR .TD 1*1 .TD 1*2
\&. TR .TD 2*1 .TD 2*2
@@ -755,7 +875,7 @@ Here the same table using a more expanded syntax:
.in 2m
.nf
-.ft C
+.ft C
\&.TBL cols=2
\&. TR
\&. TD 1*1
@@ -1333,8 +1453,8 @@ Out of the box, the groff package supports \%latin-9 only
for \-Tps,
.LI
Composite glyphs are now supported.
To do this, a subset of the Adobe Glyph List (AGL) Algorithm as described in
-.URL http://partners.adobe.com/public/developer/opentype/index_glyph.html \
- http://partners.adobe.com/public/developer/opentype/index_glyph.html
+.URL
http://\:partners.adobe.com/\:public/\:developer/\:opentype/\:index_glyph.html \
+
http://\:partners.adobe.com/\:public/\:developer/\:opentype/\:index_glyph.html
is used to construct glyph names based on Unicode character codes.
The existing groff glyph names are frozen; no glyph names which can't be
constructed algorithmically will be added in the future.
@@ -1400,7 +1520,7 @@ In groff versions 1.18 and 1.18.1, \eD'f\~...'\& didn't
move the current
point horizontally.
Despite of being silly, this change has been reverted for backwards
compatibility.
-Consequently, the intermediate output command `Df' also moves the
+Consequently, the intermediate output command `Df' also moves the
position horizontally again.
\eD'f\~...'\& is deprecated since it depends on the horizontal resolution
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 02/02: Version 1.22.3 released =======================,
Werner LEMBERG <=