texinfo-commits
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

branch master updated: * doc/texinfo.texi (HTML Customization for Math):


From: Patrice Dumas
Subject: branch master updated: * doc/texinfo.texi (HTML Customization for Math): Refer to the user of the program as "you".
Date: Tue, 02 Apr 2024 12:28:01 -0400

This is an automated email from the git hooks/post-receive script.

pertusus pushed a commit to branch master
in repository texinfo.

The following commit(s) were added to refs/heads/master by this push:
     new 601531c42c * doc/texinfo.texi (HTML Customization for Math):  Refer to 
the user of the program as "you".
601531c42c is described below

commit 601531c42ce9d1b1465128cea99e001cecaa59ab
Author: Patrice Dumas <pertusus@free.fr>
AuthorDate: Tue Apr 2 18:27:48 2024 +0200

    * doc/texinfo.texi (HTML Customization for Math):  Refer to the user
    of the program as "you".
    
    * doc/texinfo.texi: replace 'In the default case' by 'By default'.
    Gavin suggestion.
---
 ChangeLog        |  8 ++++++++
 doc/texinfo.texi | 61 ++++++++++++++++++++++++++++----------------------------
 2 files changed, 38 insertions(+), 31 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 1b8d1fc85b..1d82d4d975 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2024-04-02  Patrice Dumas  <pertusus@free.fr>
+
+       * doc/texinfo.texi (HTML Customization for Math):  Refer to the user
+       of the program as "you".
+
+       * doc/texinfo.texi: replace 'In the default case' by 'By default'.
+       Gavin suggestion.
+
 2024-04-02  Gavin Smith <gavinsmith0123@gmail.com>
 
        * doc/texinfo.texi (HTML Customization Variables List):
diff --git a/doc/texinfo.texi b/doc/texinfo.texi
index b7da6c51c4..4e22c02ff1 100644
--- a/doc/texinfo.texi
+++ b/doc/texinfo.texi
@@ -11861,7 +11861,7 @@ the official web site for ISO@tie{}3166 can be found via
 @cindex Character set, declaring
 @cindex Document input encoding
 
-In the default case, the input and output document encoding are assumed
+By default, the input and output document encoding are assumed
 to be UTF-8, the vast global character encoding, expressed in 8-bit bytes.
 UTF-8 is compatible with 7-bit ASCII.  It is recommended to use UTF-8
 encoding for Texinfo manuals.
@@ -17220,7 +17220,7 @@ any way; the special @samp{@@} and @samp{;} characters 
are looked for
 the text is blindly copied into the output.  Comments in the CSS
 file may or may not be included in the output.
 
-In the default case, classes are added to the HTML elements and CSS rules
+By default, classes are added to the HTML elements and CSS rules
 for these classes are output at the beginning of each HTML file.  Set
 the @code{NO_CSS} customization variable to prevent classes being added and CSS
 being used. Set @code{INLINE_CSS_STYLE} to have CSS code put in HTML
@@ -17288,7 +17288,7 @@ well as the manual rendered in HTML.
 @vindex EPUB_CREATE_CONTAINER_FILE @subentry @r{avoiding} @code{Archive::Zip} 
@r{dependency}
 The generation of the EPUB file depends on the @code{Archive::Zip}
 Perl module being installed.  This dependency is checked at runtime.
-In the default case, trying to output EPUB without this dependency raises an
+By default, trying to output EPUB without this dependency raises an
 error.  However, if the EPUB output file is not generated, with the
 customization variable @code{EPUB_CREATE_CONTAINER_FILE} set to 0, it is
 not an error if @code{Archive::Zip} is not installed.
@@ -17952,12 +17952,12 @@ Unset in the default case.
 @vindex NO_TOP_NODE_OUTPUT
 @vindex SHOW_TITLE
 @vindex USE_TITLEPAGE_FOR_TITLE
-In the default case, the HTML output is tailored for online viewing with
+By default the HTML output is tailored for online viewing with
 a direct access to the information at the Top node.  For an output more
 similar to a book, set @code{NO_TOP_NODE_OUTPUT} to remove the Top node.
 If @code{SHOW_TITLE} is @samp{undef}, the default,
 setting @code{NO_TOP_NODE_OUTPUT} also sets @code{SHOW_TITLE} to
-output a title at the beginning of the document.  In the default case
+output a title at the beginning of the document.  By default
 the full @code{@@titlepage} is used for the title, unset
 @code{USE_TITLEPAGE_FOR_TITLE} to get a simple title string.
 If @code{SHOW_TITLE} is set, you can have the table of contents
@@ -17966,7 +17966,7 @@ output after the title by setting 
@code{CONTENTS_OUTPUT_LOCATION} to
 
 @vindex CONTENTS_OUTPUT_LOCATION
 @vindex FORMAT_MENU
-In the default case, a list of subordinate sections is output in each node
+By default, a list of subordinate sections is output in each node
 for navigation, corresponding to @code{FORMAT_MENU} set to @samp{sectiontoc}.
 The table of contents are output at the end of the @code{@@top}
 section, to have the main location for navigation in the whole document
@@ -18012,7 +18012,7 @@ navigation and index lookup.  This only works with 
non-split HTML output.
 @cindex JavaScript license web labels page
 @vindex JS_WEBLABELS
 @vindex JS_WEBLABELS_FILE
-In the default case, a @dfn{JavaScript license web labels page} is setup
+By default, a @dfn{JavaScript license web labels page} is setup
 to give licensing information and source code for any JavaScript used in
 the HTML files for the manual
 (See @uref{https://www.gnu.org/licenses/javascript-labels.html}).  To avoid
@@ -18110,7 +18110,7 @@ Default is undefined.
 
 @item menu links
 @vindex NODE_NAME_IN_MENU
-In the default case, node names are used in menu entries links.  Set
+Node names are used in menu entries links by default.  Set
 @code{NODE_NAME_IN_MENU} to false to use section names instead.
 
 @item Table of contents links
@@ -18126,7 +18126,7 @@ default false.
 
 @item Top node up direction link
 @vindex IGNORE_REF_TO_TOP_NODE_UP
-In the default case, no Top node Up reference is generated.  It is possible
+By default no Top node Up reference is generated.  It is possible
 to ignore references to the Top node Up appearing in other cross-references
 by setting @code{IGNORE_REF_TO_TOP_NODE_UP}.  @code{IGNORE_REF_TO_TOP_NODE_UP}
 is not set in the default case.
@@ -18175,7 +18175,7 @@ be relevant, for example, if you know that no manual is 
installed locally.
 @cindex HTML cross-references @subentry configuration customization
 You can use customization variables to specify the HTML Xref
 Configuration more precisely.
-In the default case, the file name used for HTML Xref configuration
+By default, the file name used for HTML Xref configuration
 is searched for in directories, and all the files found are used.
 You can set the @code{HTMLXREF_MODE} customization variable to modify how
 cross-references to other manuals information is determined.
@@ -18184,7 +18184,7 @@ as the source of information.  If @code{HTMLXREF_MODE} 
is set to @samp{none}
 no information is used.  The default case is obtained with @code{HTMLXREF_MODE}
 not defined or set to any other value.  The @code{HTMLXREF_FILE} customization
 variable sets the file used for HTML Xref configuration to another value than
-the default, @file{htmlxref.cnf}.  In the default case, the distant manual
+the default, @file{htmlxref.cnf}.  By default, the distant manual
 is considered to be split or monolithic based on the splitting of the manual
 being output.  It is possible to set it explicitely, instead, with
 @code{EXTERNAL_CROSSREF_SPLIT}.
@@ -18207,7 +18207,7 @@ the @code{TOP_NODE_FILE_TARGET} customization variable 
value; default is
 with @code{EXTERNAL_DIR}, in the default case there is none.  Similarly,
 the file extension for cross-references to other manuals is set with
 @code{EXTERNAL_CROSSREF_EXTENSION}, which, if unset, is based
-on @code{EXTENSION}.  In the default case, the base file names are truncated
+on @code{EXTENSION}.  By default, the base file names are truncated
 to 245 characters (@pxref{HTML Xref Link Basics}).  The maximum length of a
 base file name is changed by setting @code{BASEFILENAME_LENGTH}.
 
@@ -18222,7 +18222,7 @@ is unset, the navigation bar is only inserted at the 
beginning of
 split files.
 
 @vindex USE_LINKS
-In the default case, @code{<link>} elements are generated in the
+By default, @code{<link>} elements are generated in the
 HTML @code{<head>} to specify relationships between the HTML page
 and other resources, for example the Top node, the next node or
 the table of contents.  Unset @code{USE_LINKS} to avoid those elements.
@@ -18292,7 +18292,7 @@ to be inserted in specific places in the output.
 @vindex USE_XML_SYNTAX
 @cindex DOCTYPE customization
 @vindex DOCTYPE
-In the default case, HTML is generated, but you can set
+By default HTML is generated, but you can set
 @code{USE_XML_SYNTAX} in order to generate XML compatible code.  The main
 difference is that @samp{/>} instead of @samp{>} closes elements with an
 opening element, but no closing element, such as @code{<img>} or @code{<link>}
@@ -18303,17 +18303,17 @@ The default is the HTML5 DTD-less simple DOCTYPE.
 @vindex USE_ISO
 @vindex USE_NUMERIC_ENTITY
 @vindex OUTPUT_CHARACTERS
-In the default case, entities are used for doubled single-quote characters
+By default, entities are used for doubled single-quote characters
 (@pxref{Inserting Quotation Marks}), and @samp{---} and @samp{--}
 (@pxref{Conventions}).  Set @code{USE_ISO} to @samp{0} in the unlikely case
 that you want a simpler formatting.
-In the default case, textual entities are used when possible.  Set
+By default textual entities are used when possible.  Set
 @code{USE_NUMERIC_ENTITY} to use numeric entities only.
 Set @code{OUTPUT_CHARACTERS} to output accented characters based on
 the output encoding instead of entities.
 
 @vindex NO_CUSTOM_HTML_ATTRIBUTE
-In the default case, a custom attribute, as allowed by the standard, is
+By default a custom attribute, as allowed by the standard, is
 used to provide the target manual name in cross-references.
 If it is not desirable, for example to generate strict XHTML, you can
 set @code{NO_CUSTOM_HTML_ATTRIBUTE} to prevent custom attributes being
@@ -18321,7 +18321,7 @@ output.
 
 @vindex CLOSE_QUOTE_SYMBOL
 @vindex OPEN_QUOTE_SYMBOL
-In the default case, opening quote and closing quotes needed, e.g.  for
+By default opening quote and closing quotes needed, e.g.  for
 @code{@@samp} output are set to @code{&lsquo;} and @code{&rsquo;} if
 @code{USE_NUMERIC_ENTITY} is not set, to @code{&#8216;} and @code{&#8217;} if
 set, and to a quote character if @code{OUTPUT_CHARACTERS} is set and the output
@@ -18465,10 +18465,9 @@ for menu entries formatting; default is undefined and 
set to
 
 @item NUMBER_FOOTNOTES
 @itemx NO_NUMBER_FOOTNOTE_SYMBOL
-In the default case footnotes are numbered.  With
-@option{--no-number-footnotes} or if @code{NUMBER_FOOTNOTES} is set to 0, a
-@samp{*} is used instead, or the @code{NO_NUMBER_FOOTNOTE_SYMBOL} customization
-variable value, if set.
+By default footnotes are numbered.  With @option{--no-number-footnotes} or if
+@code{NUMBER_FOOTNOTES} is set to 0, a @samp{*} is used instead, or the
+@code{NO_NUMBER_FOOTNOTE_SYMBOL} customization variable value, if set.
 
 @item PROGRAM_NAME_IN_ABOUT
 Used when an About element is output.  If set, output the program
@@ -18485,13 +18484,13 @@ default false.
 
 @vindex HTML_MATH
 @cindex HTML output @subentry math @subentry customization
-Diverse methods can be used to render math in HTML (@pxref{Inserting Math}).
-The is controlled by the @code{HTML_MATH} customization variable
-value.  In the default case, the customization variable is unset
-and the HTML output is only emphasized.  Better options for
-displaying properly formatted mathematics may be selected.  Some of
-these options also translate @code{@@tex} if @option{--iftex} is set,
-and @code{@@latex} sections if @option{--iflatex} is set.
+You can select diverse methods to render math in HTML (@pxref{Inserting Math}).
+This is controlled by the @code{HTML_MATH} customization variable
+value.  By default, the customization variable is unset
+and the HTML output is only emphasized.  You may select better options for
+displaying properly formatted mathematics.  For some of those options, if you
+set @option{--iftex}, @code{@@tex} sections are converted to HTML, and if you
+set @option{--iflatex} @code{@@latex} sections are converted to HTML.
 
 @table @code
 @item l2h
@@ -18545,7 +18544,7 @@ output directory, with @samp{_tex4ht} in their name.
 @end table
 
 @vindex CONVERT_TO_LATEX_IN_MATH
-In the default case, with @code{CONVERT_TO_LATEX_IN_MATH} undefined,
+By default, with @code{CONVERT_TO_LATEX_IN_MATH} undefined,
 setting @code{HTML_MATH} also sets @code{CONVERT_TO_LATEX_IN_MATH}.
 In that case Texinfo @@-commands inside @code{@@math} and @code{@@displaymath}
 are converted to @LaTeX{}, before converting the @code{@@math} or
@@ -18830,7 +18829,7 @@ This can be unset, set to
 set to @samp{l2h}, which uses @command{latex2html}
 (@pxref{@command{latex2html} Customization Variables}), or set to
 @samp{t4h}, which uses @command{tex4ht}
-(@pxref{@command{tex4ht} Customization Variables}).  In the default case,
+(@pxref{@command{tex4ht} Customization Variables}).  By default,
 setting @code{HTML_MATH} also sets @code{CONVERT_TO_LATEX_IN_MATH}.
 
 @item HTML_ROOT_ELEMENT_ATTRIBUTES



reply via email to

[Prev in Thread] Current Thread [Next in Thread]