[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
texinfo ChangeLog doc/texinfo.txi
From: |
karl |
Subject: |
texinfo ChangeLog doc/texinfo.txi |
Date: |
Fri, 07 Sep 2012 17:37:51 +0000 |
CVSROOT: /sources/texinfo
Module name: texinfo
Changes by: karl <karl> 12/09/07 17:37:51
Modified files:
. : ChangeLog
doc : texinfo.txi
Log message:
@* in @title applies to all formats
CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1407&r2=1.1408
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.471&r2=1.472
Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1407
retrieving revision 1.1408
diff -u -b -r1.1407 -r1.1408
--- ChangeLog 7 Sep 2012 16:24:55 -0000 1.1407
+++ ChangeLog 7 Sep 2012 17:37:51 -0000 1.1408
@@ -1,6 +1,9 @@
2012-09-07 Karl Berry <address@hidden>
- * doc/texinfo.txi: "an @code{@@", not "a", ditto @samp.
+ * doc/texinfo.txi (title subtitle author): @* breaks in the title
+ will be respected in HTML unless conditionalized.
+
+ * doc/texinfo.txi: "an @code{@@", not "a" throughout; ditto @samp.
2012-09-06 Patrice Dumas <address@hidden>
and Karl Berry <address@hidden>
Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.471
retrieving revision 1.472
diff -u -b -r1.471 -r1.472
--- doc/texinfo.txi 7 Sep 2012 16:24:55 -0000 1.471
+++ doc/texinfo.txi 7 Sep 2012 17:37:51 -0000 1.472
@@ -1,5 +1,5 @@
\input texinfo.tex @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.471 2012/09/07 16:24:55 karl Exp $
address@hidden $Id: texinfo.txi,v 1.472 2012/09/07 17:37:51 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.
@@ -1458,9 +1458,10 @@
@item
The @code{@@settitle} line specifies a title for the page headers (or
-footers) of the printed manual, and the default document description for
-the @samp{<head>} in HTML format. Strictly speaking, @code{@@settitle}
-is optional---if you don't mind your document being titled `Untitled'.
+footers) of the printed manual, and the default title and document
+description for the @samp{<head>} in HTML. Strictly speaking,
address@hidden@@settitle} is optional---if you don't mind your document being
+titled `Untitled'.
@item
The @code{@@bye} line at the end of the file on a line of its own tells
@@ -3100,7 +3101,8 @@
@cindex @code{<title>} HTML tag
In the HTML file produced by @command{makeinfo}, @var{title} serves as
the document @samp{<title>}. It also becomes the default document
-description in the @samp{<head>} part (@pxref{documentdescription}).
+description in the @samp{<head>} part
+(@pxref{documentdescription,,@code{@@documentdescription}}).
When the title page is used in the output, the title in the
@code{@@settitle} command does not affect the title as it appears on
@@ -3443,9 +3445,17 @@
flush to the left-hand side of the page in a larger than normal font.
The title is underlined with a black rule. The title must be given on
a single line in the source file; it will be broken into multiple
-lines of output is needed. The @code{@@*} command may be used to
-specify the line breaks in long titles if the automatic breaks do not
-suit.
+lines of output is needed.
+
+For long titles, the @code{@@*} command may be used to specify the
+line breaks in long titles if the automatic breaks do not suit. Such
+explicit line breaks are generally reflected in all output formats; if
+you only want to specify them for the printed output, use a
+conditional (@pxref{Conditionals}). For example:
+
address@hidden
+@@title This Long Title@@address@hidden,@@address@hidden Is Broken in
@@address@hidden@}
address@hidden example
The @code{@@subtitle} command sets subtitles in a normal-sized font
flush to the right-hand side of the page.
@@ -20856,7 +20866,7 @@
@item @@settitle @var{title}
Specify the title for page headers in a printed manual, and the
-default document description for HTML @samp{<head>}. @xref{settitle,,
+default document title for HTML @samp{<head>}. @xref{settitle,,
@code{@@settitle}}.
@item @@shortcaption
@@ -21816,7 +21826,7 @@
Revision Control System}) or other version control systems, which
expand it into a string such as:
@example
-$Id: texinfo.txi,v 1.471 2012/09/07 16:24:55 karl Exp $
+$Id: texinfo.txi,v 1.472 2012/09/07 17:37:51 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}
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/03
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/03
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/04
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/06
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/06
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/07
- texinfo ChangeLog doc/texinfo.txi,
karl <=
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/08
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/09
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/09
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/10
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/12
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/13
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/15
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/23