[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
texinfo ChangeLog doc/texinfo.txi doc/refcard/t...
|
From: |
Karl Berry |
|
Subject: |
texinfo ChangeLog doc/texinfo.txi doc/refcard/t... |
|
Date: |
Sun, 20 Feb 2011 18:39:40 +0000 |
CVSROOT: /sources/texinfo
Module name: texinfo
Changes by: Karl Berry <karl> 11/02/20 18:39:40
Modified files:
. : ChangeLog
doc : texinfo.txi
doc/refcard : txicmdcheck txirefcard-a4.pdf txirefcard.pdf
txirefcard.tex
Added files:
util : txicmdlist
Log message:
more commands missing from summary
CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1215&r2=1.1216
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.370&r2=1.371
http://cvs.savannah.gnu.org/viewcvs/texinfo/util/txicmdlist?cvsroot=texinfo&rev=1.1
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/refcard/txicmdcheck?cvsroot=texinfo&r1=1.2&r2=1.3
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/refcard/txirefcard-a4.pdf?cvsroot=texinfo&rev=1.9
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/refcard/txirefcard.pdf?cvsroot=texinfo&rev=1.9
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/refcard/txirefcard.tex?cvsroot=texinfo&r1=1.14&r2=1.15
Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1215
retrieving revision 1.1216
diff -u -b -r1.1215 -r1.1216
--- ChangeLog 18 Feb 2011 17:33:28 -0000 1.1215
+++ ChangeLog 20 Feb 2011 18:39:39 -0000 1.1216
@@ -1,3 +1,11 @@
+2011-02-20 Karl Berry <address@hidden>
+
+ * doc/refcard/txirefcard.tex,
+ * doc/texinfo.txi (Command Summary): add @copying, @insertcopying,
+ @indent, @headitemfont, @dotless, @unmacro.
+ * doc/refcard/txicmdcheck: also check against implementation.
+ * util/txicmdlist: script to output all implemented commands.
+
2011-02-18 Karl Berry <address@hidden>
* doc/refcard/txirefcard.tex,
Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.370
retrieving revision 1.371
diff -u -b -r1.370 -r1.371
--- doc/texinfo.txi 18 Feb 2011 17:33:28 -0000 1.370
+++ doc/texinfo.txi 20 Feb 2011 18:39:39 -0000 1.371
@@ -1,5 +1,5 @@
\input texinfo.tex @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.370 2011/02/18 17:33:28 karl Exp $
address@hidden $Id: texinfo.txi,v 1.371 2011/02/20 18:39:39 karl Exp $
@c Ordinarily, Texinfo files have the extension .texi. But texinfo.texi
@c clashes with texinfo.tex on 8.3 filesystems, so we use texinfo.txi.
@@ -21409,7 +21409,7 @@
@item @@cartouche
Highlight an example or quotation by drawing a box with rounded
corners around it. Pair with @code{@@end cartouche}. No effect in
-Info. @xref{cartouche, , Drawing Cartouches Around Examples}.)@refill
+Info. @xref{cartouche, , Drawing Cartouches Around Examples}.
@item @@center @var{line-of-text}
Center the line of text following the command.
@@ -21478,8 +21478,11 @@
@item @@contents
Print a complete table of contents. Has no effect in Info, which uses
-menus instead. @xref{Contents, , Generating a Table of
-Contents}.
+menus instead. @xref{Contents, , Generating a Table of Contents}.
+
address@hidden @@copying
+Specify copyright holders and copying conditions for the document Pair
+with @code{@@end cartouche}. @xref{copying,, @code{@@copying}}.
@item @@address@hidden@}
Generate the copyright symbol @copyright{}. @xref{copyright symbol,,
@@ -21683,6 +21686,10 @@
Generate a dot accent over the character @var{c}, as in @dotaccent{o}.
@xref{Inserting Accents}.
address@hidden @@address@hidden@address@hidden
+Generate dotless i (address@hidden') and dotless j (address@hidden').
address@hidden Accents}.
+
@item @@address@hidden@}
Generate an ellipsis, @address@hidden
@xref{dots, , @code{@@dots}}.
@@ -21849,6 +21856,10 @@
@item @@headitem
Begin a heading row in a multitable. @xref{Multitable Rows}.
address@hidden @@address@hidden@address@hidden
+Set @var{text} in the font used for multitable heading rows; mostly
+useful in multitable templates. @xref{Multitable Rows}.
+
@item @@html
Enter HTML completely. Pair with @code{@@end html}. @xref{Raw
Formatter Commands}.
@@ -21918,6 +21929,9 @@
@item @@include @var{filename}
Read the contents of Texinfo source file @var{filename}. @xref{Include Files}.
address@hidden @@indent
+Insert paragraph indentation. @xref{indent,, @code{indent}}.
+
@item @@address@hidden@address@hidden
Indicate text that is a uniform resource locator for the World Wide
Web. @xref{indicateurl, , @code{@@indicateurl}}.
@@ -21935,6 +21949,10 @@
@code{@@} until after it has read the definitions file. @xref{Texinfo
File Header}.
address@hidden @@insertcopying
+Insert the text previously defined with the @code{@@copying}
+environment. @xref{insertcopying,, @code{@@insertcopying}}.
+
@item @@item
Indicate the beginning of a marked paragraph for @code{@@itemize} and
@code{@@enumerate}; indicate the beginning of the text of a first column
@@ -22407,6 +22425,10 @@
under the character @var{c}, as in @u{o}, @ubaraccent{o},
@udotaccent{o}. @xref{Inserting Accents}.
address@hidden @@unmacro @var{macroname}
+Undefine the macro @code{@@@var{macroname}} if it has been defined.
address@hidden Macros}.
+
@item @@unnumbered @var{title}
Begin a chapter that appears without chapter numbers of any kind. The
title appears in the table of contents. In Info, the title is
@@ -23106,7 +23128,7 @@
(@url{http://www.gnu.org/software/rcs}) version control systems, which
expand it into a string such as:
@example
-$Id: texinfo.txi,v 1.370 2011/02/18 17:33:28 karl Exp $
+$Id: texinfo.txi,v 1.371 2011/02/20 18:39:39 karl Exp $
@end example
(This is useful in all sources that use version control, not just manuals.)
You may wish to include the @samp{$Id:} comment in the @code{@@copying}
@@ -23185,7 +23207,7 @@
@verbatim
\input texinfo @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.370 2011/02/18 17:33:28 karl Exp $
address@hidden $Id: texinfo.txi,v 1.371 2011/02/20 18:39:39 karl Exp $
@comment %**start of header
@setfilename sample.info
@include version.texi
Index: doc/refcard/txicmdcheck
===================================================================
RCS file: /sources/texinfo/texinfo/doc/refcard/txicmdcheck,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -b -r1.2 -r1.3
--- doc/refcard/txicmdcheck 10 Nov 2008 19:36:44 -0000 1.2
+++ doc/refcard/txicmdcheck 20 Feb 2011 18:39:40 -0000 1.3
@@ -1,6 +1,6 @@
#!/usr/bin/env perl
-# $Id: txicmdcheck,v 1.2 2008/11/10 19:36:44 karl Exp $
-# Copyright 2008 Free Software Foundation, Inc.
+# $Id: txicmdcheck,v 1.3 2011/02/20 18:39:40 karl Exp $
+# Copyright 2008, 2011 Free Software Foundation, Inc.
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
@@ -17,38 +17,48 @@
#
# Original author: Karl Berry.
#
-# Kludge of a script to check command lists in refcard vs. refman
-# for consistency. Would be nice to check makeinfo, too.
+# Kludge of a script to check command lists in refcard vs. refman vs.
+# tp for consistency.
exit (&main ());
sub main
{
- my @cardcmds = &read_refcard ("txirefcard.tex");
- my @mancmds = &read_refman ("../texinfo.txi");
- my (%mancmds, %cardcmds);
- @address@hidden = ();
- @address@hidden = ();
+ my @card_cmds = &read_refcard ("txirefcard.tex");
+ my @man_cmds = &read_refman ("../texinfo.txi");
+ my @tp_cmds = &read_tp ("../../util/txicmdlist");
+
+ my (%card_cmds, %man_cmds, %tp_cmds);
+ @address@hidden = ();
+ @address@hidden = ();
+ @address@hidden = ();
my @found = ();
- for my $cc (@cardcmds) {
- if (exists $mancmds{$cc}) {
+ for my $cc (@card_cmds) {
+ if (exists $man_cmds{$cc} && exists $tp_cmds{$cc}) {
push (@found, $cc);
- delete $mancmds{$cc};
- delete $cardcmds{$cc};
+ delete $man_cmds{$cc};
+ delete $card_cmds{$cc};
+ delete $tp_cmds{$cc};
}
}
+
printf " common %d: @{[sort @found]}\n", @found + 0;
- my @card_only = keys %cardcmds;
+
+ my @card_only = keys %card_cmds;
printf "refcard only %s: @{[sort @card_only]}\n", @card_only + 0;
- my @man_only = keys %mancmds;
+
+ my @man_only = keys %man_cmds;
printf "refman only %s: @{[sort @man_only]}\n", @man_only + 0;
- return @card_only + @man_only;
+ my @tp_only = keys %tp_cmds;
+ printf "tp only %s: @{[sort @tp_only]}\n", @tp_only + 0;
+
+ return @card_only + @man_only + @tp_only;
}
-# Return command names given in the reference card.
+# Return command names from the reference card.
#
sub read_refcard
{
@@ -101,8 +111,8 @@
}
-# Return command names from the @-Command List summary node in the
-# reference manual.
+# Return command names from the @-Command List
+# node in the reference manual.
#
sub read_refman
{
@@ -130,3 +140,40 @@
close (FILE) || warn "close($FILE) failed: $!";
return @ret;
}
+
+
+# Return command names implemented in the general parser.
+# The argument is the command to run to return the list.
+#
+sub read_tp
+{
+ my ($prog) = @_;
+ my @ret = ();
+
+ local *FILE;
+ $FILE = "$prog |";
+ open (FILE) || die "open($FILE) failed: $!";
+ while (<FILE>) {
+ chomp;
+ # excise @<whitespace> commands from normal list.
+ next if $_ eq '@ ' || $_ eq "address@hidden" || $_ eq "" || $_ eq '@';
+
+ # obsolete and/or subsidiary commands we don't want to document as usual.
+ next if $_ =~ /allow-recursion
+ |columnfractions
+ |cropmarks
+ |ctrl
+ |(even|every|odd)(foot|head)ingmarks
+ |quote-arg
+ |rmacro
+ |shorttitle$
+ |\|
+ /x;
+ push (@ret, $_);
+ }
+ close (FILE) || warn "close($FILE) failed: $!";
+
+ push (@ret, '@var{whitespace}');
+
+ return @ret;
+}
Index: doc/refcard/txirefcard-a4.pdf
===================================================================
RCS file: /sources/texinfo/texinfo/doc/refcard/txirefcard-a4.pdf,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -b -r1.8 -r1.9
Binary files /tmp/cvsGBwf5H and /tmp/cvspi5yVp differ
Index: doc/refcard/txirefcard.pdf
===================================================================
RCS file: /sources/texinfo/texinfo/doc/refcard/txirefcard.pdf,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -b -r1.8 -r1.9
Binary files /tmp/cvsOHiLCI and /tmp/cvsNFVsuq differ
Index: doc/refcard/txirefcard.tex
===================================================================
RCS file: /sources/texinfo/texinfo/doc/refcard/txirefcard.tex,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -b -r1.14 -r1.15
--- doc/refcard/txirefcard.tex 18 Feb 2011 17:33:29 -0000 1.14
+++ doc/refcard/txirefcard.tex 20 Feb 2011 18:39:40 -0000 1.15
@@ -1,5 +1,5 @@
% Texinfo reference card.
-% $Id: txirefcard.tex,v 1.14 2011/02/18 17:33:29 karl Exp $
+% $Id: txirefcard.tex,v 1.15 2011/02/20 18:39:40 karl Exp $
%
%**start of header
% This file can be printed with 1, 2, or 3 columns per page (see below).
@@ -415,6 +415,8 @@
address@hidden a name to be used for the output files. This command is
essential for \TeX\ formatting as well, even though it produces no output.
Should be the first command in the input.}
address@hidden document \var{title}.}
address@hidden copyright and licensing text. Pair with address@hidden copying}.}
address@hidden text defined by address@hidden
\subsection{Internationalization}
@@ -565,6 +567,7 @@
corresponding address@hidden \var{envname}} is seen.
address@hidden the normal indentation when starting a new paragraph; often
used after environments.}
address@hidden normal paragraph indentation.}
address@hidden \var{line-of-text} without any indentation.}
address@hidden an example or quotation by drawing a box with rounded corners
around it. Pair with address@hidden cartouche}. No effect in Info.}
@@ -602,6 +605,7 @@
address@hidden an item for the list and table commands.}
address@hidden only with address@hidden Like address@hidden but do not
generate extra preceding vertical space. When several items have the same
description, use address@hidden for the first and address@hidden for the rest.}
address@hidden only for multitables. Like address@hidden, but indicates a
heading row.}
address@hidden \var{text} in the heading row font.}
address@hidden \var{text} as-is; used as \var{formatting-command} for tables
when no highlighting is desired.}
@@ -682,6 +686,7 @@
address@hidden, @o}{\ttbraced{}}{Generate uppercase \O\ and lowercase \o.}
address@hidden, @oe}{\ttbraced{}}{Generate uppercase \OE\ and lowercase \oe.}
address@hidden, @th}{\ttbraced{}}{Generate uppercase \TH\ and lowercase \th.}
address@hidden|j}}{Generate dotless \i\ and \j.}
address@hidden an upside-down exclamation point, \raise.4ex\hbox{<}.}
address@hidden, @ordm}{\ttbraced{}}{Generate \ordf\ and lowercase \ordm.}
address@hidden an upside-down question mark, \raise.4ex\hbox{?`}.}
@@ -726,6 +731,7 @@
address@hidden a greater-than-or-equal sign, $\geq$.}
address@hidden a less-than-or-equal sign, $\leq$.}
+
\section{Making and preventing breaks}
address@hidden a line break.}
@@ -831,6 +837,7 @@
address@hidden the command address@hidden a synonym for the existing command
address@hidden
address@hidden \ttbraced{\var{params}}}{Define a new Texinfo command
address@hidden Pair with address@hidden macro}.}
address@hidden address@hidden if it is defined.}
address@hidden,} before\code{,} after}{Can only be used within address@hidden;
create a new command that encloses its argument in the \var{before} and
\var{after} strings.}
Index: util/txicmdlist
===================================================================
RCS file: util/txicmdlist
diff -N util/txicmdlist
--- /dev/null 1 Jan 1970 00:00:00 -0000
+++ util/txicmdlist 20 Feb 2011 18:39:40 -0000 1.1
@@ -0,0 +1,39 @@
+#!/usr/bin/env perl
+# Copyright 2011 Free Software Foundation, Inc.
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 3 of the License,
+# or (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <http://www.gnu.org/licenses/>.
+#
+# Original author: Patrice Dumas.
+#
+# Output Texinfo command names recognized in the implementation.
+
+BEGIN {
+ (my $mydir = $0) =~ s,/[^/]+$,,;
+ chomp (my $tpdir = `cd $mydir/../tp && pwd`);
+ unshift (@INC, $tpdir);
+}
+
+use Texinfo::Common;
+
+my @all_commands = (
+ keys(%Texinfo::Common::block_commands),
+ keys(%Texinfo::Common::brace_commands),
+ keys(%Texinfo::Common::misc_commands),
+ keys(%Texinfo::Common::no_brace_commands),
+ qw(cindex findex kindex pindex tindex value vindex),
+ qw(thischapter thischaptername thischapternum thisfile thispage thistitle),
+ qw(end),
+);
+
+print map { "address@hidden" } sort (@all_commands);