texinfo-commits
[Top][All Lists]
Advanced
[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}
reply via email to
[Prev in Thread] Current Thread [Next in Thread]