# [tex4ht-commits] [SCM] tex4ht updated: r117 - trunk/doc

karl at gnu.org.ua karl at gnu.org.ua
Wed Oct 9 19:45:44 CEST 2013

Author: karl
Date: 2013-10-09 20:45:44 +0300 (Wed, 09 Oct 2013)
New Revision: 117

Modified:
trunk/doc/tex4ht-annotated-source.tex
trunk/doc/tex4ht-configure1.tex
trunk/doc/tex4ht-configure2.tex
trunk/doc/tex4ht-mathml.tex
trunk/doc/tex4ht-mcol.tex
Log:
break source lines at <80 chars

Modified: trunk/doc/tex4ht-annotated-source.tex
===================================================================
--- trunk/doc/tex4ht-annotated-source.tex	2013-10-08 18:30:08 UTC (rev 116)
+++ trunk/doc/tex4ht-annotated-source.tex	2013-10-09 17:45:44 UTC (rev 117)
@@ -200,7 +200,7 @@
the free web font, namely, EB Garamond created by
lines are \verb'.css' declarations to make use of Garamond and

Modified: trunk/doc/tex4ht-configure1.tex
===================================================================
--- trunk/doc/tex4ht-configure1.tex	2013-10-08 18:30:08 UTC (rev 116)
+++ trunk/doc/tex4ht-configure1.tex	2013-10-09 17:45:44 UTC (rev 117)
@@ -83,8 +83,9 @@
\Configure{ext}............1
\end{verbatim}
\begin{tabular}{ll}
-\fline\#1: default extension name for target files  (recorded in \Verb+\:html+).
-Can also be requested through a command line option \Verb+ext=...+\par
+\fline\#1: default extension name for target files (recorded in
+\Verb+\:html+).  Can also be requested through a command line option
+\Verb+ext=...+\par

\end{tabular}
\begin{verbatim}
@@ -410,7 +411,8 @@
\end{tabular}
\begin{itemize}
\item Empty arguments request the omission of the corresponding field.
-\item \Verb=\TocCount=  Specifies the entry count withing the \Verb= jobname.4tc= file.
+\item \Verb=\TocCount=  Specifies the entry count within the
+  \Verb= jobname.4tc= file.
\item  \Verb=\TitleCount= Count of entries submitted to the toc file.
\item An alternative to \Verb=\ConfigureToc{unit-name}=:
\end{itemize}
@@ -677,7 +679,8 @@

\fline   \#2 content at the start indented paragraphs

-\fline   \#3 insertion into \Verb=\EndP=, at the start of non-indented paragraphs
+\fline   \#3 insertion into \Verb=\EndP=, at the start of non-indented
+paragraphs

\fline   \#4 insertion into \Verb=\EndP=, at the start of indented paragraphs

Modified: trunk/doc/tex4ht-configure2.tex
===================================================================
--- trunk/doc/tex4ht-configure2.tex	2013-10-08 18:30:08 UTC (rev 116)
+++ trunk/doc/tex4ht-configure2.tex	2013-10-09 17:45:44 UTC (rev 117)
@@ -118,9 +118,9 @@

\begin{tabular}{ll}

-\fline   \#1 names cross-references of files (appends \#1 to \Verb=)F= and \Verb=)Q=
-      entries of the \Verb=.xref= files). Applicable mainly implicitly
+\fline \#1 names cross-references of files (appends \#1 to \Verb=)F= and
+      \Verb=)Q= entries of the \Verb=.xref= files). Applicable mainly

\end{tabular}

Modified: trunk/doc/tex4ht-mathml.tex
===================================================================
--- trunk/doc/tex4ht-mathml.tex	2013-10-08 18:30:08 UTC (rev 116)
+++ trunk/doc/tex4ht-mathml.tex	2013-10-09 17:45:44 UTC (rev 117)
@@ -13,26 +13,74 @@
\chapter{MathML 3 and implications for \TeX4ht}
\fi

-\leavevmode
-\hlink{http://www.w3.org/TR/MathML3/}{\mathml 3} is about to be formalized and going to be released as the new standard for encoding mathematics in web. It differs from the previous standard version 2. The main changes that have a bearing on the functionality of \hlink{http://www.tug.org/tex4ht/}{\texht} are discussed here.
+be formalized and going to be released as the new standard for encoding
+mathematics in web. It differs from the previous standard version 2. The
+main changes that have a bearing on the functionality of

-\mathml 1 and 2 didn't have any built in provisions to specify links for various elements. The recommendation was to use \hlink{http://www.w3.org/TR/xlink/}{\xlink} since it was part of the original grand plan for \hlink{http://www.w3.org/standards/xml/}{\xml} in its formative years. However, \xlink didn't gain much popularity nor was it supported widely. Therefore, \mathml 3 now specifies that any \mathml element can accept an \verb+href+ attribute that takes an \uri specifying a hyperlink same as in the \hlink{http://dev.w3.org/html5/spec/Overview.html}{\html} element, namely, \verb+<a>+. So this has an implication in the current scheme of \texht. If readers provide a few examples of how they want to include links in a math fragment in \latex, it will help largely to make a stable and suitable conversion scheme for \texht.
+\mathml 1 and 2 didn't have any built in provisions to specify links for
+various elements. The recommendation was to use
+in its formative years. However, \xlink didn't gain much popularity nor
+was it supported widely. Therefore, \mathml 3 now specifies that any
+\mathml element can accept an \verb+href+ attribute that takes an \uri
+specifying a hyperlink same as in the
+namely, \verb+<a>+. So this has an implication in the current scheme of
+\texht. If readers provide a few examples of how they want to include
+links in a math fragment in \latex, it will help largely to make a
+stable and suitable conversion scheme for \texht.

\section{Line breaking}

-Previous standards of \mathml had the same limitations as \tex in the matter of breaking long equations. In \tex, it is easy for an author to break equations while authoring content taking into consideration of the margin constrains and paper sizes. However, for web content, margin and line-length are irrelevant when the window sizes are unknown or potentially liable to dynamic changes. Therefore, new \mathml 3 specifies a line breaking model and introduces several new attributes to control properties of line breaks and alignments.
+Previous standards of \mathml had the same limitations as \tex in the
+matter of breaking long equations. In \tex, it is easy for an author to
+break equations while authoring content taking into consideration of the
+margin constrains and paper sizes. However, for web content, margin and
+line-length are irrelevant when the window sizes are unknown or
+potentially liable to dynamic changes. Therefore, new \mathml 3
+specifies a line breaking model and introduces several new attributes to
+control properties of line breaks and alignments.

-This has deeper implications on the rendering software than on the engine that creates \mathml.  However, since the specification allows newer properties for line breaks and alignments, we need to take care of those part in \texht which at the moments obeys what the author has input in her \latex document.  Since \tex is incapable of determining the semantic meaning of equations, we have to provide hooks to make \texht aware of the real line breaks and obligatory line breaks to adjust with page sizes.  A better option will be to make use of \verb+breqn+ package while authoring and \texht to provide necessary extra functionality to take care of \hlink{http://tug.ctan.org/tex-archive/macros/latex/contrib/mh/}{\texttt{breqn}} features in combination with \mathml's newer goodies.
+This has deeper implications on the rendering software than on the
+engine that creates \mathml.  However, since the specification allows
+newer properties for line breaks and alignments, we need to take care of
+those part in \texht which at the moments obeys what the author has
+input in her \latex document.  Since \tex is incapable of determining
+the semantic meaning of equations, we have to provide hooks to make
+\texht aware of the real line breaks and obligatory line breaks to
+adjust with page sizes.  A better option will be to make use of
+\verb+breqn+ package while authoring and \texht to provide necessary
+extra functionality to take care of
+features in combination with \mathml's newer goodies.

\section{Image inclusion}

-The usage of \verb+<glyph>+ element in the previous \mathml specification has been deprecated now. \verb+<glyph>+ element was used to specify characters from non-standard fonts that do not correspond to Unicode code points. Since the usage becomes difficult in a web context, as one needs to make sure that the font is available, \verb+<mglyph>+ has been extended with \verb+src+ attribute. \verb+<mglyph>+ now acts as a general image reference element in \mathml much like \html's \verb+<img>+ element.
+The usage of \verb+<glyph>+ element in the previous \mathml
+specification has been deprecated now. \verb+<glyph>+ element was used
+to specify characters from non-standard fonts that do not correspond to
+Unicode code points. Since the usage becomes difficult in a web context,
+as one needs to make sure that the font is available, \verb+<mglyph>+
+has been extended with \verb+src+ attribute. \verb+<mglyph>+ now acts as
+a general image reference element in \mathml much like \html's
+\verb+<img>+ element.

\section{Elementary math layout}

-Elementary school math layout is difficult to typeset even with \tex.  Usually people adopt a tabular layout with a lot of complex macros to control space and rules around various number segments. Previous \mathml standards provide elementary school math layout, much like in \tex, with a lot of tabular structure which obstructs rendering of math other than visual, particularly audio, because of the interference of tabular elements.  \mathml 3 provides better layout elements and scheme which help to specify even borrows and carries and many different kind of layout.
+Elementary school math layout is difficult to typeset even with \tex.
+Usually people adopt a tabular layout with a lot of complex macros to
+control space and rules around various number segments. Previous \mathml
+standards provide elementary school math layout, much like in \tex, with
+a lot of tabular structure which obstructs rendering of math other than
+visual, particularly audio, because of the interference of tabular
+elements.  \mathml 3 provides better layout elements and scheme which
+help to specify even borrows and carries and many different kind of
+layout.

\begin{verbatim}
435.3
@@ -89,6 +137,14 @@
\section{Directionality}

\ifvmode\leavevmode\fi
-\mathml 3 provides support for right to left writing/reading direction whereas previous versions didn't have this functionality. The new specifications provide the user to control both writing directions of the identifiers within a formula and layout direction of the formula itself separately. I am not sure, if this has any influence on the behavior of current version of \texht which is based on \verb+dvi+ files generated by \tex/\latex while support for \verb+xdv+, extended dvi generated by Xe\tex, is still very basic which supports multi-directional scripts.
+\mathml 3 provides support for right to left writing/reading direction
+whereas previous versions didn't have this functionality. The new
+specifications provide the user to control both writing directions of
+the identifiers within a formula and layout direction of the formula
+itself separately. I am not sure, if this has any influence on the
+behavior of current version of \texht which is based on \verb+dvi+ files
+generated by \tex/\latex while support for \verb+xdv+, extended dvi
+generated by Xe\tex, is still very basic which supports
+multi-directional scripts.

\ifx\texhtstandalonedoc1 \end{document}\fi

Modified: trunk/doc/tex4ht-mcol.tex
===================================================================
--- trunk/doc/tex4ht-mcol.tex	2013-10-08 18:30:08 UTC (rev 116)
+++ trunk/doc/tex4ht-mcol.tex	2013-10-09 17:45:44 UTC (rev 117)
@@ -21,14 +21,17 @@
\section*{Prolog}
\label{sec-1}

-\href{http://www.12000.org/}{Nasser M. Abbassi} had filed a feature request at \href{http://puszcza.gnu.org.ua/bugs/?188}{TeX4ht} project for
-multicolumn support in TeX4ht which is lacking at the moment. \href{http://www.w3.org/TR/css3-multicol/}{This
-page} provides the latest specifications of \href{http://www.w3.org}{W3C} relating to multicolumn
-layout in HTML which some of the mainstream browsers support in
-varying degrees.  Our initial efforts are pointed towards \texttt{multicol}
-package so that TeX4ht provides enough hooks to generate output with
-multicolumn layout as envisaged in \LaTeX{} by \texttt{multicol} package.
-Support for \texttt{\textbackslash{}twocolumn} still remains to be done, though.
+\href{http://www.12000.org/}{Nasser M. Abbassi} had filed a feature
+request at \href{http://puszcza.gnu.org.ua/bugs/?188}{TeX4ht} project
+for multicolumn support in TeX4ht which is lacking at the
+the latest specifications of \href{http://www.w3.org}{W3C} relating to
+multicolumn layout in HTML which some of the mainstream browsers support
+in varying degrees.  Our initial efforts are pointed towards
+\texttt{multicol} package so that TeX4ht provides enough hooks to
+generate output with multicolumn layout as envisaged in \LaTeX{} by
+\texttt{multicol} package.  Support for
+\texttt{\textbackslash{}twocolumn} still remains to be done, though.

\section*{Approach to the Problem}
\label{sec-2}
@@ -58,7 +61,8 @@
\item \texttt{\textbackslash{}columnseprulecolor}: rule color
\item \texttt{\textbackslash{}flushcolumns}: balanced columns
\item \texttt{\textbackslash{}raggedcolumns}: unbalanced columns
-\item \texttt{\textbackslash{}begin\{multicols\}\{<num>\}}: beginning of multicolumn enviromnemt
+\item \texttt{\textbackslash{}begin\{multicols\}\{<num>\}}: beginning of
+        multicolumn enviromnemt
\item \texttt{\textbackslash{}end\{multicols\}}: end of multicolumn environment
\item \texttt{\textbackslash{}multicoltolerance}: no effect on HTML output
\end{enumerate}
@@ -111,10 +115,11 @@
\begin{verbatim}
\Configure{columnrulestyle}{outset}
\end{verbatim}
-\texttt{columnrulestyle} has no equivalent in \texttt{multicol}. Specify rule style
-with the above hook. Legal values are provided below:
- \texttt{none}, \texttt{hidden}, \texttt{dotted}, \texttt{dashed}, \texttt{solid}, \texttt{double},  \texttt{groove},
-     \texttt{ridge}, \texttt{inset},  \texttt{outset},
+\texttt{columnrulestyle} has no equivalent in \texttt{multicol}. Specify
+rule style with the above hook. Valid values are:
+ \texttt{none}, \texttt{hidden}, \texttt{dotted}, \texttt{dashed},
+ \texttt{solid}, \texttt{double},  \texttt{groove},
+ \texttt{ridge}, \texttt{inset},  \texttt{outset}.

\begin{verbatim}
\Configure{columnspan}{none}