Re: doc patch and Re: [Fwd: french words]

Derek Robert Price <[email protected]> Fri, 14 Sep 2001 12:38:39 -0400
Newsgroups gmane.comp.tex.texi2html.devel
Message-ID <[email protected]>
Peter Moulder wrote:

> On Fri, Sep 14, 2001 at 10:40:17AM -0400, Derek Robert Price wrote:
> > Any objections?  Anyone know French who can confirm that these are
> > proper translations?
>
> FWIW: I'm not a native speaker, but I can at least confirm that they would all
> be understood.
>
> Btw, I've been meaning to send you a patch or two.  Attached is a patch
> just against documentation.

You actually have commit privileges to the source yourself, but I'd be happy to
review it.

I can actually see a procedure like Automake and Autoconf use being useful:

1) Submit the patch to the dev list for comments.  (Another list can split for
patches if it ever seems desirable).
2) Others comment / recommend revisions.
3) If necessary, author revises patch and resubmits - return to step 2.
4) Author commits patch if (s)he has privileges - else someone else commits.

I'm forwarding your patch to dev though I think only you and I have subscribed,
we have two others with commit privileges I an cc'ing to request that they
subscribe to the dev list if at all possible.

I'll also review the patch soon and send another email.

Derek
docpatch (text/plain, 16.6 KB)
Index: ChangeLog
===================================================================
RCS file: /usr/local/tigris/data/helm/cvs/repository/texi2html/ChangeLog,v
retrieving revision 1.4
diff -d -u -r1.4 ChangeLog
--- ChangeLog	2001/08/10 20:04:47	1.4
+++ ChangeLog	2001/08/12 16:09:51
@@ -264,7 +264,7 @@
 
 	* implemented @documentlanguage:
 	  - sets language of document, unless overwritten by -lang, or 
-	    explicitely set $T2H_LANG
+	    explicitly set $T2H_LANG
 
 	* introduced T2H_OBSOLETE_OPTIONS to prevent obsolete options to 
 	  ambiguate current options
@@ -429,12 +429,12 @@
 	* fixed atuomatic pointer creation for appendix chapters
 	* fixed handling of menu entries with description going into the
 	  next line, use numbered section names, if $T2H_NUMBER_SECTIONS
-	* texi2html.init: $T2H_TOP_HEADING for explicitely specifying
+	* texi2html.init: $T2H_TOP_HEADING for explicitly specifying
 	  heading of top node
 	* fixed handling of headings (no new page on -split section)
 	* fixed bug in index (generation of section names)
 	* stoc in _ovr.html within BLOCKQUOTES
-	* get rid of bulletts in ToC, if $T2H_NUMBER_SECTIONS
+	* get rid of bullets in ToC, if $T2H_NUMBER_SECTIONS
 
 2000-04-06  Olaf Bachmann  <[email protected]>
 
Index: NEWS
===================================================================
RCS file: /usr/local/tigris/data/helm/cvs/repository/texi2html/NEWS,v
retrieving revision 1.2
diff -d -u -r1.2 NEWS
--- NEWS	2001/08/10 20:04:47	1.2
+++ NEWS	2001/08/12 16:09:51
@@ -4,7 +4,8 @@
 * Many bug fixes.
 * The operation of the previously broken << (FastBack) and >> (FastForward)
   buttons has changed slightly.  FastBack now returns to the beginning of the
-  current chapter and FastBack now jumps to the beginning of the next chapter.
+  current chapter and FastForward now jumps to the beginning of the next
+  chapter.
 
 1.64 (July 3 2000)
 * Incorporated first  version of Texi2html Texinfo manual, authored by
Index: texi2html.1
===================================================================
RCS file: /usr/local/tigris/data/helm/cvs/repository/texi2html/texi2html.1,v
retrieving revision 1.1.1.1
diff -d -u -r1.1.1.1 texi2html.1
--- texi2html.1	2001/04/29 07:23:15	1.1.1.1
+++ texi2html.1	2001/08/12 16:09:51
@@ -108,7 +108,7 @@
 .B foo.html
 The document's contents.
 .TP
-.B foo_foot.html
+.B foo_fot.html
 The footnotes (if any).
 .TP
 .B foo_l2h_img*
@@ -132,7 +132,10 @@
 contributed to this program.  Its current maintainer is Olaf Bachmann,
 [email protected].
 .SH AVAILABILITY
-http://www.mathematik.uni-kl.de/~obachman/Texi2Html/Distrib
+http://www.mathematik.uni-kl.de/~obachman/Texi2html/Distrib
+.br
+Will in future be available from
+http://texi2html.cvshome.org/
 .SH COPYRIGHT
 Copyright \(co 1999, 2000  Free Software Foundation, Inc.
 There is NO warranty.  You may redistribute this software
Index: texi2html.1.in
===================================================================
RCS file: /usr/local/tigris/data/helm/cvs/repository/texi2html/texi2html.1.in,v
retrieving revision 1.1.1.1
diff -d -u -r1.1.1.1 texi2html.1.in
--- texi2html.1.in	2001/04/29 07:23:12	1.1.1.1
+++ texi2html.1.in	2001/08/12 16:09:51
@@ -108,7 +108,7 @@
 .B foo.html
 The document's contents.
 .TP
-.B foo_foot.html
+.B foo_fot.html
 The footnotes (if any).
 .TP
 .B foo_l2h_img*
@@ -132,7 +132,10 @@
 contributed to this program.  Its current maintainer is Olaf Bachmann,
 [email protected].
 .SH AVAILABILITY
-http://www.mathematik.uni-kl.de/~obachman/Texi2Html/Distrib
+http://www.mathematik.uni-kl.de/~obachman/Texi2html/Distrib
+.br
+Will in future be available from
+http://texi2html.cvshome.org/
 .SH COPYRIGHT
 Copyright \(co 1999, 2000  Free Software Foundation, Inc.
 There is NO warranty.  You may redistribute this software
Index: texi2html.init
===================================================================
RCS file: /usr/local/tigris/data/helm/cvs/repository/texi2html/texi2html.init,v
retrieving revision 1.3
diff -d -u -r1.3 texi2html.init
--- texi2html.init	2001/05/01 21:33:44	1.3
+++ texi2html.init	2001/08/12 16:09:51
@@ -74,7 +74,7 @@
 };
 
 # - glossary
-#if set, uses section named `Footnotes' for glossary
+# If set, uses section named `Footnotes' for glossary.
 my $T2H_USE_GLOSSARY = 0;
 $T2H_OPTIONS -> {glossary} =
 {
@@ -127,7 +127,7 @@
 # -top_file
 # uses file of this name for top-level file
 # extension is manipulated appropriately, if necessary.
-# If empty, <basename of document>.html is used
+# If empty, <basename of document>.html is used.
 # Typically, you would set this to "index.html".
 my $T2H_TOP_FILE = '';
 $T2H_OPTIONS -> {top_file} =
@@ -139,9 +139,9 @@
 
 
 # -toc_file
-# uses file of this name for table of contents file
+# uses file of this name for table of contents.  File
 # extension is manipulated appropriately, if necessary.
-# If empty, <basename of document>_toc.html is used
+# If empty, <basename of document>_toc.html is used.
 my $T2H_TOC_FILE = '';
 $T2H_OPTIONS -> {toc_file} =
 {
@@ -195,7 +195,7 @@
 # if set to 'section' (resp. 'chapter') create one html file per (sub)section
 # (resp. chapter) and separate pages for Top, ToC, Overview, Index,
 # Glossary, About.
-# otherwise, create monolithic html file which contains whole document
+# Otherwise, create a monolithic html file that contains the whole document.
 #$T2H_SPLIT = 'section';
 my $T2H_SPLIT = '';
 $T2H_OPTIONS -> {split} =
@@ -220,8 +220,8 @@
 };
 
 # -subdir
-# if set put result files in this directory
-# if not set result files are put into current directory
+# If set, then put result files into the specified directory.
+# If not set, then result files are put into the current directory.
 #$T2H_SUBDIR = 'html';
 my $T2H_SUBDIR = '';
 $T2H_OPTIONS -> {subdir} =
@@ -232,8 +232,8 @@
 };
 
 # -short_extn
-# If this is set all HTML file will have extension ".htm" instead of
-# ".html". This is helpful when shipping the document to PC systems.
+# If this is set, then all HTML files will have extension ".htm" instead of
+# ".html". This is helpful when shipping the document to DOS-based systems.
 my $T2H_SHORTEXTN = 0;
 $T2H_OPTIONS -> {short_ext} =
 {
@@ -337,7 +337,7 @@
 # The following options are only relevant if $T2H_L2H is set
 #
 # -l2h_l2h
-# name/location of latex2html progam
+# name/location of latex2html program
 my $T2H_L2H_L2H = "latex2html";
 $T2H_OPTIONS -> {l2h_l2h} =
 {
@@ -348,8 +348,8 @@
 };
 
 # -l2h_skip
-# if set, skips actual call to latex2html tries to reuse previously generated
-# content, instead
+# If set, skips actual call to latex2html: tries to reuse previously generated
+# content, instead.
 my $T2H_L2H_SKIP = '';
 $T2H_OPTIONS -> {l2h_skip} =
 {
@@ -360,9 +360,9 @@
 };
 
 # -l2h_tmp
-# if set, l2h uses this directory for temporarary files. The path
-# leading to this directory may not contain a dot (i.e., a "."),
-# otherwise, l2h will fail
+# If set, l2h uses the specified directory for temporary files.  The path
+# leading to this directory may not contain a dot (i.e., a ".");
+# otherwise, l2h will fail.
 my $T2H_L2H_TMP = '';
 $T2H_OPTIONS -> {l2h_tmp} =
 {
Index: doc/custpage.texi
===================================================================
RCS file: /usr/local/tigris/data/helm/cvs/repository/texi2html/doc/custpage.texi,v
retrieving revision 1.2
diff -d -u -r1.2 custpage.texi
--- doc/custpage.texi	2001/05/01 14:43:48	1.2
+++ doc/custpage.texi	2001/08/12 16:09:52
@@ -40,7 +40,7 @@
 do so.
 
 
-a) General: Philosphy, and how it works@*
+a) General: Philosophy, and how it works@*
 aa) Navigation panels@*
 b) Top page@*
 c) Section pages@*
Index: doc/ifo.texi
===================================================================
RCS file: /usr/local/tigris/data/helm/cvs/repository/texi2html/doc/ifo.texi,v
retrieving revision 1.1.1.1
diff -d -u -r1.1.1.1 ifo.texi
--- doc/ifo.texi	2001/04/29 07:23:18	1.1.1.1
+++ doc/ifo.texi	2001/08/12 16:09:52
@@ -35,12 +35,12 @@
 @c
 @c --------------------------------------------------------
 @section Initialization file options
-This section describes in detail all option which can only
-be used in initialization file (@file{texi2html.init}), but
-not on command line.
-This mean the only way to change those
+This section describes in detail all options that can be used
+only in the initialization file (@file{texi2html.init}),
+and cannot be specified on the command line.
+This means the only way to change those
 options is first to copy the original @file{texi2html.init}
-to e.g. @file{texi2html.init.myown} and do changes to fit
+to e.g.@: @file{texi2html.init.myown} and make changes to fit
 your needs.
 
 @menu
@@ -70,10 +70,10 @@
 @node IFOmenu, IFOCenterImage, IFOnumber, IFOs
 @subsection Avoid menu redundancy
 @c not sure if correct?
-@cindex menu, redundance
+@cindex menu, redundancy
 @vindex T2H_AVOID_MENU_REDUNDANCY
-if set and menu entry equals menu descr, then do not print
-menu descr. Likewise, if node name equals entry name, do
+If set, and menu entry equals menu description, then do not print
+menu description.  Likewise, if node name equals entry name, do
 not print entry name.
 @var{$T2H_AVOID_MENU_REDUNDANCY} = 1;
 
@@ -89,9 +89,9 @@
 @c +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
 @node IFOExampleIndentCell, IFOSampleIndentCell, IFOCenterImage, IFOs
 @subsection Example Indent Cell
-@cindex example, indention
+@cindex example, indentation
 @vindex T2H_EXAMPLE_INDENT_CELL
-used as identation for block enclosing command
+used as indentation for block enclosing command
 @code{@@example}, etc If not empty, must be enclosed in
 @code{<td></td>}
 @var{$T2H_EXAMPLE_INDENT_CELL} = '<td>&nbsp;</td>';
Index: doc/initfile.texi
===================================================================
RCS file: /usr/local/tigris/data/helm/cvs/repository/texi2html/doc/initfile.texi,v
retrieving revision 1.2
diff -d -u -r1.2 initfile.texi
--- doc/initfile.texi	2001/05/01 14:43:48	1.2
+++ doc/initfile.texi	2001/08/12 16:09:52
@@ -68,14 +68,14 @@
 
 The default initialization options are defined in the
 @file{texi2html.init} file contained in the @b{Texi2html}
-distribution (which gets includes near the biginning of the
+distribution (which gets included near the beginning of the
 @command{texi2html} script that gets installed).
 
 To customize @file{texi2html} it is best if you copy the
 appropriate sections from the @file{texi2html.init}
 contents into an appropriate local initialization file,
 make the necessary changes there, and then have
-@command{texi2html} read this inialization file by one of
+@command{texi2html} read this initialization file by one of
 the means described above.
 
 For an example on what you can produces with
Index: doc/options.texi
===================================================================
RCS file: /usr/local/tigris/data/helm/cvs/repository/texi2html/doc/options.texi,v
retrieving revision 1.1.1.1
diff -d -u -r1.1.1.1 options.texi
--- doc/options.texi	2001/04/29 07:23:18	1.1.1.1
+++ doc/options.texi	2001/08/12 16:09:52
@@ -48,7 +48,7 @@
 * OptionTopFile::             Top File.
 * OptionTocFile::             Table of content File.
 * OptionFrames::              Frames.
-* OptionMenu::                Menu's.
+* OptionMenu::                Menus.
 * OptionNumber::              Number sections.
 * OptionSplit::               Splitting.
 * OptionSectionNavigation::   Navigation.
@@ -175,7 +175,7 @@
 
 @c --------------------------------------------------------
 @node OptionInclude, OptionTopFile, OptionIso, Options
-@section Include Direcotry
+@section Include Directory
 @vindex Include directories
 @opindex I
 @vindex T2H_INCLUDE_DIRS
@@ -197,7 +197,7 @@
 @option{-top_file}
 uses file of this name for top-level file
 extension is manipulated appropriately, if necessary.
-If empty, @file{<basename of document>.html} is used
+If empty, @file{<basename of document>.html} is used.
 Typically, you would set this to @file{index.html}.
 
 $T2H_TOP_FILE = "";
@@ -209,9 +209,9 @@
 @opindex toc_file
 @vindex T2H_TOC_FILE
 @option{-toc_file}
-uses file of this name for table of contents file extension
+uses file of this name for table of contents.  File extension
 is manipulated appropriately, if necessary. If empty,
-@file{<basename of document>_toc.html} is used
+@file{<basename of document>_toc.html} is used.
 
 $T2H_TOC_FILE = "";
 
@@ -230,7 +230,7 @@
 
 @c --------------------------------------------------------
 @node OptionMenu, OptionNumber, OptionFrames, Options
-@section Menu's
+@section Menus
 @cindex HTML, menu
 @cindex Texinfo, menu
 @opindex menu
@@ -268,8 +268,8 @@
 if set to @strong{section} (resp. @strong{chapter}) create one
 @acronym{HTML} file per (sub)section (resp. chapter) and
 separate pages for Top, ToC, Overview, Index, Glossary,
-About. otherwise, create monolithic @acronym{HTML} file which
-contains whole document
+About.  Otherwise, create a monolithic @acronym{HTML} file that
+contains the whole document.
 
 #$T2H_SPLIT = 'section';
 $T2H_SPLIT = undef;
@@ -302,8 +302,8 @@
 @cindex Subdirectory
 @vindex T2H_SUBDIR
 @option{-subdir}
-if set put result files in this directory if not set result
-files are put into current directory
+If set, then put result files in the specified directory.
+If not set, then result files are put into the current directory.
 
 @c #$T2H_SUBDIR = 'html';
 @var{$T2H_SUBDIR} = undef;
@@ -318,9 +318,9 @@
 @vindex T2H_SHORTEXTN
 @opindex short_extn
 @option{-short_extn}
-If this is set all @acronym{HTML} file will have extension
+If this is set, then all @acronym{HTML} files will have extension
 @file{.htm} instead of @file{.html}. This is helpful when
-shipping the document to PC systems.
+shipping the document to DOS-based systems.
 @var{$T2H_SHORTEXTN} = 0;
 
 @c --------------------------------------------------------
@@ -393,15 +393,14 @@
 @vindex $T2H_WORDS
 @opindex lang
 @option{-lang}
-For page titles use
+For page titles, use
 @code{$T2H_WORDS->@{$T2H_LANG@}->@{...@}} as title. To add
-a new languages, supply list of titles (see
-@var{$T2H_WORDS}). and use ISO 639 language codes (see e.g.
-perl module @file{Locale-Codes-1.02.tar.gz} for
-definitions)
+a new languages, supply list of titles (see @var{$T2H_WORDS}),
+and use ISO 639 language codes (see e.g.@: perl module
+@file{Locale-Codes-1.02.tar.gz} for definitions).
 
 If you don't give a @option{-lang} then we got it from the
-Texinfo source fille (@@documentlanguage
+Texinfo source file (@@documentlanguage
 @c Put a table with the language codes here!
 @c Or better put a reference into the Texinfo
 @c Manual, which has a table of ISO 639-Codes.
@@ -418,7 +417,7 @@
 @c
 @c put some information about Month names etc. here
 @c $MONTH_NAMES !!
-@c Suplemental should be naming scheme for variables in
+@c Supplemental should be naming scheme for variables in
 @c different languages (MONTH_NAMES_DE etc.)
 @c --------------------------------------------------------
 @node OptionL2H, , OptionLanguage, Options
@@ -447,7 +446,7 @@
 @vindex T2H_L2H_L2H
 @opindex l2h_l2h
 @option{-l2h_l2h}
-name/location of @command{latex2html} progam.
+name/location of @command{latex2html} program.
 
 @c --------------------------------------------------------
 @node OptionL2HSkip, OptionL2Htmp, OptionL2HL2H, OptionL2H
@@ -456,7 +455,7 @@
 @vindex T2H_L2H_SKIP
 @opindex l2h_skip
 @option{-l2h_skip}
-if set, skips actual call to @command{atex2html} tries to
+If set, skips actual call to @command{latex2html}: tries to
 reuse previously generated content, instead.
 
 @c --------------------------------------------------------
@@ -467,6 +466,6 @@
 @vindex T2H_L2H_TMP
 @opindex l2h_tmp
 @option{-l2h_tmp}
-if set, l2h uses this directory for temporarary files. The
+If set, l2h uses this directory for temporary files.  The
 path leading to this directory may not contain a dot (i.e.,
-a "."), otherwise, l2h will fail
+a @samp{.}); otherwise, l2h will fail.
Index: doc/texi2html.texi
===================================================================
RCS file: /usr/local/tigris/data/helm/cvs/repository/texi2html/doc/texi2html.texi,v
retrieving revision 1.2
diff -d -u -r1.2 texi2html.texi
--- doc/texi2html.texi	2001/05/01 14:43:48	1.2
+++ doc/texi2html.texi	2001/08/12 16:09:52
@@ -48,7 +48,7 @@
 @c
 @c Get the version of the script itself through
 @c configure/autoconf etc.
-@c version.texi is automaticly generated through
+@c version.texi is automatically generated through
 @c configure/autoconf.
 @include version.texi
 @c --------------------------------------------------------
@@ -255,7 +255,7 @@
 * OptionTopFile::             Top File.
 * OptionTocFile::             Table of content File.
 * OptionFrames::              Frames.
-* OptionMenu::                Menu's.
+* OptionMenu::                Menus.
 * OptionNumber::              Number sections.
 * OptionSplit::               Splitting.
 * OptionSectionNavigation::   Navigation.