doc: do not comment out alltt environments. zap them instead
authorRamprasad Venkataraman <ramv@illinois.edu>
Thu, 2 Aug 2012 22:44:55 +0000 (17:44 -0500)
committerRamprasad Venkataraman <ramv@illinois.edu>
Thu, 2 Aug 2012 22:44:55 +0000 (17:44 -0500)
latex2html seems to generate empty divs even for commented out
alltt environments. Simply \zap them to avoid this.

doc/charm++/loadb.tex
doc/charm++/python.tex

index c975d3dd9c55b45a9282e7cc4771c4bd48e5f661..16abd9bffd8136ef2270f49b82b2d2bbdfe73f2f 100644 (file)
@@ -493,46 +493,51 @@ Other strategies can also be explored by following the simple API of the
 seed load balancer.
 \linebreak
 
-%{\bf Seed load balancers for Chares:}
-%
-%Seed load balancers can be directly used for load balancing Chares.
-%The default seed load balancer which is always linked is the random seed load balancer.
-%Users can choose another strategy listed above and link as a plugin
-%module into binary as described below.
-%
-%{\bf Seed load balancers for Array Elements:}
-%
-%Seed load balancers can also be used for array elements in the same way 
-%as they are used for individual chares.
-%Chare array is a collection of individual Chares in Charm++.
-%Since Chare Array has its internal strategy of static mapping of individual
-%array elements to processors using {\em CkArrayMap}~\ref{array map}~\footnote{by default it always distributed array elements to processors in Round-Robin fashion unless a different CkArrayMap is used}, 
-%a special CkArrayMap called {\em CldMap} must be created and passed into
-%array creation calls to interface with seed load balancer.
-%
-%For creating an empty array and then inserting chares into it, the API is as follows:
-%
-%\begin{alltt}
-%  CkArrayOptions opt;
-%  CkGroupID cldmapID = CProxy_CldMap::ckNew();
-%  opt.setMap(cldmapID);
-%  CProxy_WorkUnit arr = CProxy_WorkUnit::ckNew(param, opt); 
-%  for (int i=0; i<numChares; i++) 
-%    arr[i].insert(param);
-%\end{alltt}
-%
-%For initially populating the array with chares at time of creation the API is as follows:
-%\begin{alltt}
-%  CkArrayOptions opt(numChares);
-%  CkGroupID cldmapID = CProxy_CldMap::ckNew();
-%  opt.setMap(cldmapID);
-%  CProxy_WorkUnit arr = CProxy_WorkUnit::ckNew(param, opt); 
-%\end{alltt}
-%
-%The details about array creation are explained in section~\ref{advanced arrays} of the manual.
-%
+\zap{
+{\bf Seed load balancers for Chares:}
+
+Seed load balancers can be directly used for load balancing Chares.
+The default seed load balancer which is always linked is the random seed load balancer.
+Users can choose another strategy listed above and link as a plugin
+module into binary as described below.
+
+{\bf Seed load balancers for Array Elements:}
+
+Seed load balancers can also be used for array elements in the same way 
+as they are used for individual chares.
+Chare array is a collection of individual Chares in Charm++.
+Since Chare Array has its internal strategy of static mapping of individual
+array elements to processors using {\em CkArrayMap}~\ref{array map}~\footnote{by default it always distributed array elements to processors in Round-Robin fashion unless a different CkArrayMap is used}, 
+a special CkArrayMap called {\em CldMap} must be created and passed into
+array creation calls to interface with seed load balancer.
+
+For creating an empty array and then inserting chares into it, the API is as follows:
+
+\begin{alltt}
+  CkArrayOptions opt;
+  CkGroupID cldmapID = CProxy_CldMap::ckNew();
+  opt.setMap(cldmapID);
+  CProxy_WorkUnit arr = CProxy_WorkUnit::ckNew(param, opt); 
+  for (int i=0; i<numChares; i++) 
+    arr[i].insert(param);
+\end{alltt}
+
+For initially populating the array with chares at time of creation the API is as follows:
+\begin{alltt}
+  CkArrayOptions opt(numChares);
+  CkGroupID cldmapID = CProxy_CldMap::ckNew();
+  opt.setMap(cldmapID);
+  CProxy_WorkUnit arr = CProxy_WorkUnit::ckNew(param, opt); 
+\end{alltt}
+
+The details about array creation are explained in section~\ref{advanced arrays} of the manual.
+
+} % end zap
+
+
 {\bf Compile and run time options for seed load balancers}
 
+
 To choose a seed load balancer other than the default {\em rand} strategy,
 use link time command line option {\bf -balance foo}. 
 
index d7a5484064b4e7e9de436ad57adcfe7712f75677..0f9d6c856317dcc67ced148ea0b9bd234ee874e0 100644 (file)
@@ -535,14 +535,16 @@ Python script is suspended for long periods of time while waiting for the
 are automatically released and re-acquired by the \texttt{CkCallbackPython}
 class when it suspends.
 
-% This can be done using the two functions:
+\zap{
+This can be done using the two functions:
 
-%\begin{alltt}
-%void pythonAwake(int handle);   // to acquire the lock
-%void pythonSleep(int handle);   // to release the lock
-%\end{alltt}
+\begin{alltt}
+void pythonAwake(int handle);   // to acquire the lock
+void pythonSleep(int handle);   // to release the lock
+\end{alltt}
 
-%Important to remember is that before any Python value is accessed, the Python
-%interpreter must be awake. This include the functions \texttt{Py\_BuildValue} and
-%\texttt{PyArg\_ParseTuple}. \textbf{Note:} it is an error to call these functions
-%more than once before the other one is called.
+Important to remember is that before any Python value is accessed, the Python
+interpreter must be awake. This include the functions \texttt{Py\_BuildValue} and
+\texttt{PyArg\_ParseTuple}. \textbf{Note:} it is an error to call these functions
+more than once before the other one is called.
+} % end zap