[tex4ht-commits] [SCM] tex4ht updated: r71 - trunk/lit

[karl at gnu.org.ua]

Author: karl
Date: 2010-12-24 21:42:19 +0200 (Fri, 24 Dec 2010)
New Revision: 71

Modified:
   trunk/lit/ChangeLog
   trunk/lit/tex4ht-c.tex
   trunk/lit/tex4ht-t4ht.tex
Log:
attempted doc improvements

Modified: trunk/lit/ChangeLog
===================================================================
--- trunk/lit/ChangeLog	2010-12-24 01:44:17 UTC (rev 70)
+++ trunk/lit/ChangeLog	2010-12-24 19:42:19 UTC (rev 71)
@@ -1,3 +1,9 @@
+2010-12-24  Karl Berry  <karl at gnu.org>
+
+	* tex4ht-c.tex,
+	* tex4ht-t4ht.tex: attempt to document which files I think these
+	programs read and write.  Fix a couple typos.
+
 2010-12-23  Karl Berry  <karl at gnu.org>
 
 	* tex4ht-c.tex,

Modified: trunk/lit/tex4ht-c.tex
===================================================================
--- trunk/lit/tex4ht-c.tex	2010-12-24 01:44:17 UTC (rev 70)
+++ trunk/lit/tex4ht-c.tex	2010-12-24 19:42:19 UTC (rev 71)
@@ -224,11 +224,12 @@
 
 \Section{Preamble}
 
- A command-line program running in the
-console environment of the operating system (MS-DOS, MS-DOS window
-of Windows 3.1, Unix shell, etc).  
+A command-line program running in the console environment of the
+operating system (MS-DOS, MS-DOS window of Windows 3.1, Unix shell,
+etc).  The input is a heavily specialized DVI file.  The main output is
+the HTML/XML and \`'.css', also \`'.lg', \`'.idv', and
+\`'.tmp'.
 
-
 \<tex4ht.c\><<< 
 /* tex4ht.c (`version), generated from `jobname.tex
    Copyright (C) 2009-2010 TeX Users Group
@@ -1554,7 +1555,7 @@
 
 
 
-Line breaks within  comamnd lines should be phisically given.
+Line breaks within command lines should be physically given.
 
 \Section{I/O Files}
 
@@ -1585,9 +1586,8 @@
 Below:  If input is from stdin which is not a console
         device, switch it to binary mode. 
 
-Warning `statement with no effect' under \`'gcc -Wall' in Linux?
-Does the problem stems from the fact that UNIX doesn't
-  differentiate between BINARY and ASCII modes?
+Warning `statement with no effect' under \`'gcc -Wall' on non-Windows.
+This is not a problem; SET_BINARY is a no-op.
 
 \<open input file\><<<
 if( *in_name != '\0' ){ `<file = non-piped input file`> }
@@ -12503,21 +12503,21 @@
 
 \List{*}
 \item \`'\special{t4ht^i}' - on    class i-'0' (i='0', '1', ..., \`'~'
-\item  \`'\special{t4ht^-}'--pause from processing delimeters
-\item  \`'\special{t4ht^+}'--continue processing delimeters
+\item  \`'\special{t4ht^-}'--pause from processing delimiters
+\item  \`'\special{t4ht^+}'--continue processing delimiters
 \item
  \`'\special{t4ht^}'--off, if in scan-mode of class values.
 on/off show-class, otherwise
 \item
 \`'\special{t4ht^i*...*...}'---Configure delimiters for class i
 \item  \`'\special{t4ht^ix}'--put delimiters of class i on next group.
-If x=\`'>' ignore delimeters within the group.
+If x=\`'>' ignore delimiters within the group.
 \item  \`'\special{t4ht^i)*...*...}'--put the specified delimiters of
  class  on next group, instead of the default ones.
-Ignore delimeters within the group.
+Ignore delimiters within the group.
 \item  \`'\special{t4ht^i(*...*...}'--put the specified delimiters of
  class  on next group, instead of the default ones.
-Don't ignore delimeters within the group.
+Don't ignore delimiters within the group.
 \EndList
 
 
@@ -12796,7 +12796,7 @@
 \SubSection{Requests}
 
   \`'\special{t4ht^ix}'--put delimiters of class i on next group/token.  If
-{\tt x=`)'} ignore delimeters within the group.
+{\tt x=`)'} ignore delimiters within the group.
 
 
 \<class delimiters on group\><<<
@@ -12813,7 +12813,7 @@
 
   \`'\special{t4ht^)x*...*...}'--put the specified delimiters of
  class  on next group, instead of the default ones.
-If {\tt x=`)'}, ignore delimeters within the group.
+If {\tt x=`)'}, ignore delimiters within the group.
 
 
 

Modified: trunk/lit/tex4ht-t4ht.tex
===================================================================
--- trunk/lit/tex4ht-t4ht.tex	2010-12-24 01:44:17 UTC (rev 70)
+++ trunk/lit/tex4ht-t4ht.tex	2010-12-24 19:42:19 UTC (rev 71)
@@ -81,14 +81,14 @@
 
 The post-processor \`'tex4ht.c' prepares a \`'.lg' file in which it
 lists the pictures that need to be generated, and the entries
-encountered in \''\Needs{...}'.  The \`'.log' file contains the
-entries encountered in the \''\Needs-{...}'.  The t4ht.perl script
-treats as commands the entries that are enclosed between double-quote
-(\''"') characters, and the other entries as comments. It first works
-on the \`'.lg' file and then on the \`'.log' file.
+encountered in \''\Needs{...}'.  The \`'.log' file contains the entries
+encountered in the \''\Needs-{...}'.  The t4ht program (used to be a
+Perl script?) treats as commands the entries that are enclosed between
+double-quote (\''"') characters, and the other entries as comments. It
+first works on the \`'.lg' file and then on the \`'.log' file.
+The main output is a new \`'.css'.
 
 
-
 \<main's body\><<<
 `<load env file`>
 lg_file = open_file(lg_name,LG_EXT);