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> </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.