From 1972622d770b6c6ab68ae48ebf44af037aff9f1c Mon Sep 17 00:00:00 2001 From: Werner Lemberg Date: Tue, 4 Nov 2014 07:55:53 +0100 Subject: 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(-) delete mode 100644 arch/mingw/zzz diff --git a/ChangeLog b/ChangeLog index 86b82a2b6..0fc5254ee 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,12 @@ +2014-11-04 Werner LEMBERG + +Version 1.22.3 released +======================= + + * NEWS, README, doc/webpage.ms: Updated. + + * doc/texinfo.tex: Updated from `texinfo' repository. + 2014-10-29 Bertrand Garrigues * Makefile.in (OTHERDIRS): Mention `afmtodit' first. diff --git a/NEWS b/NEWS index cc615f0e8..eeb409061 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 3a629c030..951fedb0e 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 (jh@axis.se). +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 -request@ (example: groff-request@gnu.org 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 f6c6f3c5f..000000000 --- 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 6312dadbc..72c8cf4ee 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{}% non-@*heading 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 816d05dc1..2c758586a 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 jh@\: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 bug-groff@gnu.org bug-groff@gnu.org -for reporting bugs +for reporting bugs and following bug reports .LI .MTO groff@gnu.org groff@gnu.org @@ -238,10 +252,10 @@ for general discussion of groff .LI .MTO groff-commit@gnu.org groff-commit@gnu.org -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 \[la]list\[ra]-request@\[la]domain\[ra] +To subscribe, send a mail to \[la]list\[ra]-request@\[la]domain\[ra] (example: .MTO groff-request@\:gnu.org groff-request@\: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 bp@orig 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 -- cgit v1.2.1