[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[6986] move example from NEWS to manual
From: |
Gavin D. Smith |
Subject: |
[6986] move example from NEWS to manual |
Date: |
Sat, 06 Feb 2016 08:36:21 +0000 |
Revision: 6986
http://svn.sv.gnu.org/viewvc/?view=rev&root=texinfo&revision=6986
Author: gavin
Date: 2016-02-06 08:36:20 +0000 (Sat, 06 Feb 2016)
Log Message:
-----------
move example from NEWS to manual
Modified Paths:
--------------
trunk/ChangeLog
trunk/NEWS
trunk/doc/texinfo.texi
Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog 2016-02-06 07:55:15 UTC (rev 6985)
+++ trunk/ChangeLog 2016-02-06 08:36:20 UTC (rev 6986)
@@ -7,6 +7,9 @@
an unwanted comma after the cross-reference when processing with
TeX.
+ * NEWS, doc/texinfo.texi (Cross Reference Parts): Move example
+ of comma insertion. Suggestion from Karl Berry.
+
2016-02-05 Gavin Smith <address@hidden>
* doc/texinfo.tex (\xrefX): Check for some commands following
Modified: trunk/NEWS
===================================================================
--- trunk/NEWS 2016-02-06 07:55:15 UTC (rev 6985)
+++ trunk/NEWS 2016-02-06 08:36:20 UTC (rev 6986)
@@ -22,12 +22,8 @@
. For processing with TeX, a comma is automatically provided following
a cross-reference command (such as @xref) when needed to separate
the page number from following text, so you don't need to add one
- yourself. This gives you the choice of whether to have a comma
- there in Info or HTML output. For example,
- "@xref{Another Section} for more information" produces
- "See Another Section, page NN, for more information" in the printed
- output, and "*Note Another Section:: for more information" in the
- Info output. Behavior when followed by punctuation, as always
+ yourself. See the `Parts of a Cross Reference' node in the manual
+ for details. Behavior when followed by punctuation, as always
recommended previously, is unchanged.
* texi2any:
Modified: trunk/doc/texinfo.texi
===================================================================
--- trunk/doc/texinfo.texi 2016-02-06 07:55:15 UTC (rev 6985)
+++ trunk/doc/texinfo.texi 2016-02-06 08:36:20 UTC (rev 6986)
@@ -4835,11 +4835,24 @@
ignored. To include a comma in one of the arguments, use
@code{@@address@hidden@}} (@pxref{Inserting a Comma}).
address@hidden Unwanted comma after cross-reference
address@hidden Comma after cross-reference
When processing with TeX, a comma is automatically inserted after the
page number for cross-references to within the same manual, unless the
closing brace of the argument is followed by non-whitespace (such as a
-comma or period). If an unwanted comma is added, follow the argument
+comma or period). This gives you the choice of whether to have a comma
+there in Info or HTML output. For example,
+
address@hidden
+@@address@hidden address@hidden for more information
address@hidden example
+
address@hidden produces
address@hidden Another Section, page @var{ppp}, for more information'} in the
+printed output, and
address@hidden@samp{*Note Another Section:: for more information}} in the Info
+output.
+
+If an unwanted comma is added, follow the argument
with a command such as @samp{@@:}. For example,
@address@hidden@@address@hidden@}@@: --- for the details}} produces
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [6986] move example from NEWS to manual,
Gavin D. Smith <=