[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
branch master updated: Minor manual modernizations
From: |
Gavin D. Smith |
Subject: |
branch master updated: Minor manual modernizations |
Date: |
Fri, 03 Jun 2022 07:23:35 -0400 |
This is an automated email from the git hooks/post-receive script.
gavin pushed a commit to branch master
in repository texinfo.
The following commit(s) were added to refs/heads/master by this push:
new d21bc544d5 Minor manual modernizations
d21bc544d5 is described below
commit d21bc544d58221cc3a65b4b0079e56b7e6de12c8
Author: Gavin Smith <gavinsmith0123@gmail.com>
AuthorDate: Fri Jun 3 12:23:26 2022 +0100
Minor manual modernizations
* doc/texinfo.texi
(Output Formats): Remove list of browser names.
(HTML Translation): Remove reference to Lynx, Emacs W3, and
HTML 1.0. (Tzvetelin Katchov suggested updating this list.)
(Output Formats, PDF Output): Remove words "some years ago".
(Invoking texi2any): Capitalize Cascading Style Sheets.
---
ChangeLog | 11 +++++++++++
doc/texinfo.texi | 32 ++++++++++++++++----------------
2 files changed, 27 insertions(+), 16 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index 943e8fdf9c..b5cfbfd5cf 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,14 @@
+2022-06-03 Gavin Smith <gavinsmith0123@gmail.com>
+
+ Minor manual modernizations
+
+ * doc/texinfo.texi
+ (Output Formats): Remove list of browser names.
+ (HTML Translation): Remove reference to Lynx, Emacs W3, and
+ HTML 1.0. (Tzvetelin Katchov suggested updating this list.)
+ (Output Formats, PDF Output): Remove words "some years ago".
+ (Invoking texi2any): Capitalize Cascading Style Sheets.
+
2022-06-03 Tzvetelin Katchov <katchov@gnu.org> (tiny change)
* doc/texinfo.texi (Formay with texi2dvi): remove extra space
diff --git a/doc/texinfo.texi b/doc/texinfo.texi
index 606192fb7c..77d34ee4bf 100644
--- a/doc/texinfo.texi
+++ b/doc/texinfo.texi
@@ -860,15 +860,16 @@ omitted.
@item HTML
@cindex HTML output, overview
-@cindex Mozilla
-@cindex Lynx
-@cindex Emacs-W3
+@c @cindex Mozilla
+@c @cindex Lynx
+@c @cindex Emacs-W3
(Generated via @command{makeinfo --html}.) HTML, standing for Hyper
-Text Markup Language, has become the most commonly used language for
-writing documents on the World Wide Web. Web browsers, such as
-Mozilla, Lynx, and Emacs-W3, can render this language online. There
+Text Markup Language, is the language for writing documents on the World
+Wide Web. Web browsers
+@c such as Mozilla, Lynx, and Emacs-W3
+can render this language online. There
are many versions of HTML, both different standards and
-browser-specific variations. @command{makeinfo} tries to use a subset
+browser-specific variations. @command{makeinfo} uses a subset
of the language that can be interpreted by any common browser,
intentionally not using many newer or less widely-supported tags.
Although the native output is thus rather plain, it can be customized
@@ -933,7 +934,7 @@ customizability of the output than would be possible with
the plain
@cindex DocBook output, overview
@cindex XML DocBook output, overview
(Generated via @command{makeinfo --docbook}.) This is an XML-based
-format developed some years ago, primarily for technical
+format, primarily for technical
documentation. It therefore bears some resemblance, in broad
outline, to Texinfo. See @uref{http://www.docbook.org}. Various
converters from DocBook @emph{to} Texinfo have also been developed;
@@ -15311,8 +15312,8 @@ program instead of plain @command{tex}. That is, run
@samp{pdftex
foo.texi} instead of @samp{tex foo.texi}.
@dfn{PDF} stands for `Portable Document Format'. It was invented by
-Adobe Systems some years ago for document interchange, based on their
-PostScript language. Related links:
+Adobe Systems for document interchange, based on their PostScript language.
+Related links:
@itemize
@item
@@ -15463,7 +15464,7 @@ several directories separated by the usual path
separator character
@item --css-include=@var{file}
@opindex --css-include
When producing HTML, literally include the contents of @var{file},
-which should contain W3C cascading style sheets specifications, in the
+which should contain Cascading Style Sheets specifications, in the
@samp{<style>} block of the HTML output. If @var{file} is @samp{-},
read standard input. @xref{HTML CSS}.
@@ -18098,16 +18099,15 @@ To repeat what was said at the top: please report
output from an
error-free run of @code{makeinfo} which has @emph{practical} browser
portability problems as a bug (@pxref{Reporting Bugs}).
-A few other general points about the HTML output follow.
+A few other points about the HTML output:
@cindex Navigation bar, in HTML output
@strong{Navigation bar:} By default, a navigation bar is inserted at the
start of each node, analogous to Info output. If the
@samp{--no-headers} option is used, the navigation bar is only
-inserted at the beginning of split files. Header @code{<link>}
-elements in split output can support Info-like navigation with
-browsers like Lynx and @w{Emacs W3} which implement this HTML@tie{}1.0
-feature.
+inserted at the beginning of split files. Header @code{<link>} elements
+in split output support Info-like navigation with browsers which implement
+this feature.
@cindex Footnote styles, in HTML
@strong{Footnotes:} for HTML, when the footnote style is @samp{end},
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- branch master updated: Minor manual modernizations,
Gavin D. Smith <=