changeset 73:8326c5ced916

- doc cleanup and html work
author cslag
date Sun, 13 Mar 2016 21:49:16 +0100
parents 2b89d8497aad
children f2a8dfd795e8
files doc/manual/manual.tex doc/manual/manual_build.tex doc/manual/manual_cc.tex doc/manual/manual_overview.tex doc/manual/manual_tex4ht.cfg doc/manual/manual_title.tex
diffstat 6 files changed, 44 insertions(+), 44 deletions(-) [+]
line wrap: on
line diff
--- a/doc/manual/manual.tex	Sun Mar 13 21:08:59 2016 +0100
+++ b/doc/manual/manual.tex	Sun Mar 13 21:49:16 2016 +0100
@@ -98,7 +98,7 @@
 \renewcommand{\paragraph}[1]{%
 	\par\vspace{12pt}%
 	\noindent%
-	{\bf#1}%
+	\textbf{#1}%
 	\par%
 	\vspace{6pt}%
 }%
@@ -156,7 +156,7 @@
 \lstset{basicstyle=\ttfamily}
 
 % text building blocks
-\newcommand{\group}[1]{{\it$<$#1$>$}}
+\newcommand{\group}[1]{\textit{$<$#1$>$}}
 \newcommand{\sigchar}[1]{'{\tt #1}'}
 \newcommand{\sigstr}[1]{"{\tt #1}"}
 \newcommand{\cenum}[1]{#1}
--- a/doc/manual/manual_build.tex	Sun Mar 13 21:08:59 2016 +0100
+++ b/doc/manual/manual_build.tex	Sun Mar 13 21:49:16 2016 +0100
@@ -53,15 +53,15 @@
 
 
 \begin{tabular}{l l l}
-{\bf{\large Platform}}             & Build Tool(s)    & Compiler, SDK                              \\
+\textbf{{\large Platform}}             & Build Tool(s)    & Compiler, SDK                              \\
 \hline
-{\bf{\large Windows}}              & nmake,Visual Studio & cl, cygwin (gcc), mingw (gcc)              \\
-{\bf{\large Unix-like}}            & GNU/BSD/Sun make & gcc, clang, sunc                           \\
-{\bf{\large Plan9}}                & mk               & 8c                                         \\
-{\bf{\large Haiku/BeOS}}           & GNU make         & gcc                                        \\
-{\bf{\large iOS/iPhone}}           & GNU make         & gcc and iPhone SDK on Mac OS X             \\
-{\bf{\large Nintendo DS}}          & nmake            & devkitPro\cite{devkitPro} tools on Windows \\
-{\bf{\large Playstation Portable}} & GNU make         & psptoolchain\cite{psptoolchain} tools      \\
+\textbf{{\large Windows}}              & nmake,Visual Studio & cl, cygwin (gcc), mingw (gcc)              \\
+\textbf{{\large Unix-like}}            & GNU/BSD/Sun make & gcc, clang, sunc                           \\
+\textbf{{\large Plan9}}                & mk               & 8c                                         \\
+\textbf{{\large Haiku/BeOS}}           & GNU make         & gcc                                        \\
+\textbf{{\large iOS/iPhone}}           & GNU make         & gcc and iPhone SDK on Mac OS X             \\
+\textbf{{\large Nintendo DS}}          & nmake            & devkitPro\cite{devkitPro} tools on Windows \\
+\textbf{{\large Playstation Portable}} & GNU make         & psptoolchain\cite{psptoolchain} tools      \\
 
 \end{tabular}\\
 
@@ -81,10 +81,10 @@
 Available options (omit for defaults):
 
 \begin{tabular}{ll}	
-{\tt --help}                  & display help                             \\
-{\tt --prefix={\it path}}     & specify installation prefix (Unix shell) \\
-{\tt --target={\it platform}} & MacOSX,iOS,iPhoneSimulator,PSP,...       \\
-{\tt --sdk={\it version}}     & SDK version                              \\
+{\tt --help}                     & display help                             \\
+{\tt --prefix=\textit{path}}     & specify installation prefix (Unix shell) \\
+{\tt --target=\textit{platform}} & MacOSX,iOS,iPhoneSimulator,PSP,...       \\
+{\tt --sdk=\textit{version}}     & SDK version                              \\
 \end{tabular}
 
 \paragraph{Windows flavour, and cross-build from Windows (PSP, NDS, etc.)}
@@ -96,21 +96,21 @@
 Available options:
 
 \begin{tabular}{ll}	
-{\tt /?}                    & display help \\
-{\tt /prefix {\it path}}    & set installation prefix (GNU make only) \\
-{\tt /prefix-bd {\it path}} & set build directory prefix (GNU make only) \\
-{\tt /target-x86}           & build for x86 architecture (default) \\
-{\tt /target-x64}           & build for x64 architecture \\
-{\tt /target-psp}           & build for PlayStation Portable (homebrew SDK) \\
-{\tt /target-nds-arm}       & build for Nintendo DS (devkitPro, ARM mode) \\
-{\tt /target-nds-thumb}     & build for Nintendo DS (devkitPro, THUMB mode) \\
-{\tt /tool-msvc}            & use Microsoft Visual C++ compiler (default) \\
-{\tt /tool-gcc}             & use GNU Compiler Collection \\
-{\tt /asm-ml}               & use Microsoft Macro Assembler (default) \\
-{\tt /asm-as}               & use the GNU Assembler \\
-{\tt /asm-nasm}             & use NASM Assembler \\
-{\tt /config-release}       & build release version (default) \\
-{\tt /config-debug}         & build debug version \\
+{\tt /?}                       & display help \\
+{\tt /prefix \textit{path}}    & set installation prefix (GNU make only) \\
+{\tt /prefix-bd \textit{path}} & set build directory prefix (GNU make only) \\
+{\tt /target-x86}              & build for x86 architecture (default) \\
+{\tt /target-x64}              & build for x64 architecture \\
+{\tt /target-psp}              & build for PlayStation Portable (homebrew SDK) \\
+{\tt /target-nds-arm}          & build for Nintendo DS (devkitPro, ARM mode) \\
+{\tt /target-nds-thumb}        & build for Nintendo DS (devkitPro, THUMB mode) \\
+{\tt /tool-msvc}               & use Microsoft Visual C++ compiler (default) \\
+{\tt /tool-gcc}                & use GNU Compiler Collection \\
+{\tt /asm-ml}                  & use Microsoft Macro Assembler (default) \\
+{\tt /asm-as}                  & use the GNU Assembler \\
+{\tt /asm-nasm}                & use NASM Assembler \\
+{\tt /config-release}          & build release version (default) \\
+{\tt /config-debug}            & build debug version \\
 \end{tabular}
 
 
--- a/doc/manual/manual_cc.tex	Sun Mar 13 21:08:59 2016 +0100
+++ b/doc/manual/manual_cc.tex	Sun Mar 13 21:49:16 2016 +0100
@@ -29,7 +29,7 @@
 
 It is important to understand that this section isn't a general
 purpose description of the present calling conventions.
-It merely explains the calling conventions {\bf for the parameter/return types
+It merely explains the calling conventions \textbf{for the parameter/return types
 supported by \dc}, not for aggregates (structures, unions and classes), SIMD
 data types (\_\_m64, \_\_m128, \_\_m128i, \_\_m128d), etc.\\
 We strongly advise the reader not to use this document as a general purpose
--- a/doc/manual/manual_overview.tex	Sun Mar 13 21:08:59 2016 +0100
+++ b/doc/manual/manual_overview.tex	Sun Mar 13 21:49:16 2016 +0100
@@ -24,7 +24,7 @@
 The \product{dyncall} library encapsulates architecture-, OS- and compiler-specific
 function call semantics in a virtual %
 %
-\casehtml{\Tg<span clas="marker">}{\begin{center}}%
+\casehtml{\Tg<span class="marker">}{\begin{center}}%
 \emph{bind argument parameters from left to right and then call}
 \casehtml{\Tg</span>}{\end{center}}%
  %
@@ -48,7 +48,7 @@
 Unfortunately, there are architectures we just don't have at home or work. If 
 you want to see \product{dyncall} running on such a platform, feel free to send
 in code and patches, or even to donate hardware you don't need anymore.
-Check the {\bf supported platforms} section for an overview of the supported 
+Check the \textbf{supported platforms} section for an overview of the supported 
 platforms and the different calling convention sections for details about the 
 support.
 \\
--- a/doc/manual/manual_tex4ht.cfg	Sun Mar 13 21:08:59 2016 +0100
+++ b/doc/manual/manual_tex4ht.cfg	Sun Mar 13 21:49:16 2016 +0100
@@ -99,23 +99,23 @@
 %\ConfigureEnv{lstlisting}{\listingLineReset\Tg<div class="ttDiv">}{\Tg</div>}{}{}
 %\Configure{listings}{}{}{}{\ifnum \lstlineno>0 \Tg<br> \fi \listingLine}
 
-% Make listing/table captions nicer.
+% Make listing/table captions nicer. NOTE: the -0.5em might need to be adapted if the main css changes.@@@
 \Configure{caption}
-	{\Tg<div class="caption" style="margin-top:-1em;text-align:right;color:\#A0A0A0">}
+	{\HCode{<div class="caption" style="margin:-0.5em 0;text-align:right;color:\#A0A0A0"><small>}}
 	{\HCode{<span class="id">}}
 	{\HCode{</span>: <span class="content">}}
-	{\HCode{</div>}}
+	{\HCode{</span></small></div>}}
 
 % All kinds of style setting for fonts, as we don't use the autogenerated
 % css file, but dyncall's website one.
-\Configure{texttt}{}{}
-\Configure{textit}{}{}
-\Configure{textrm}{}{}
-\Configure{textup}{}{}
-\Configure{textsl}{}{}
-\Configure{textsf}{}{}
-\Configure{textbf}{}{}
-\Configure{textsc}{}{}
+\Configure{texttt}{\Tg<span style="background-color:red">}{\Tg</span>}
+\Configure{textrm}{\Tg<span style="background-color:red">}{\Tg</span>}
+\Configure{textup}{\Tg<span style="background-color:red">}{\Tg</span>}
+\Configure{textsl}{\Tg<span style="background-color:red">}{\Tg</span>}
+\Configure{textsf}{\Tg<span style="background-color:red">}{\Tg</span>}
+\Configure{textsc}{\Tg<span style="background-color:red">}{\Tg</span>}
+\Configure{textit}{\Tg<i>}{\Tg</i>}
+\Configure{textbf}{\Tg<b>}{\Tg</b>}
 \Configure{emph}{\Tg<em>}{\Tg</em>}
 
 
--- a/doc/manual/manual_title.tex	Sun Mar 13 21:08:59 2016 +0100
+++ b/doc/manual/manual_title.tex	Sun Mar 13 21:49:16 2016 +0100
@@ -67,7 +67,7 @@
 
 \begin{titlepage}
 \begin{center}%
-	{\Huge {\bf \product{dyncall}}}\\%
+	{\Huge \textbf{\product{dyncall}}}\\%
         \ \\%
         Version \dyncallversion\\%
         \ \\%