Use more recent version of manual (from topcom 0.15.3)

debian/README.Debian

@@ -19,9 +19,9 @@ We make several changes to the upstream package.
   hardcoding it.
 
 * We include the html manual.  This has not been shipped with the source
-  since version 0.14.0, but is available on the upstream webpage:
+  since version 0.15.3, but is available on the upstream webpage:
   http://www.rambau.wm.uni-bayreuth.de/TOPCOM/TOPCOM-manual.html.
-  We regenerate it using the TeX source from the 0.14.0 tarball:
-  http://www.rambau.wm.uni-bayreuth.de/Software/TOPCOM-0.14.0.tar.gz
+  We regenerate it using the TeX source from the 0.15.3 tarball:
+  http://www.rambau.wm.uni-bayreuth.de/Software/TOPCOM-0.15.3.tar.gz
 
  -- Doug Torrance <dtorrance@piedmont.edu>, Sun,  5 Jul 2020 08:30:09 -0400

debian/changelog

@@ -7,7 +7,7 @@ topcom (0.17.8+ds-2) unstable; urgency=medium
       need htlatex to generate manual.
     - Remove unnecessary shlibs:Depends from topcom-examples.
   * debian/manual.tex
-    - New file; obtained from topcom 0.14.0 source.
+    - New file; obtained from topcom 0.15.3 source.
   * debian/README.Debian
     - Add note about how we now generate the manual.
   * debian/rules

debian/manual.tex

@@ -55,36 +55,60 @@ \section{Commands}
 The following commands are provided:
 \begin{description}
 \item[\texttt{points2chiro}] Computes the chirotope of a point configuration.
+
 \item[\texttt{chiro2dual}] Computes the dual of a chirotope.
 \item[\texttt{chiro2circuits}] Computes the circuits of a chirotope.
+\item[\texttt{chiro2cocircuits}] Computes the circuits of a chirotope.
 \item[\texttt{cocircuits2facets}] Computes the facets of a set of cocircuits.
+
+\item[\texttt{points2facets}] Computes the facets of a point configuration.
+
+\item[\texttt{points2nflips}] Computes the number of flips of a point
+  configurations and the seed triangulation.
+\item[\texttt{points2flips}] Computes all flips of a point configurations and the
+  seed triangulation.
+
 \item[\texttt{chiro2placingtriang}] Computes the placing triangulation of a
   chirotope given by the numbering of the elements.
 \item[\texttt{points2placingtriang}] dto.\ for point configurations.
+
 \item[\texttt{chiro2finetriang}] Computes a fine (i.e., using all vertices)
   triangulation by placing and pushing.
 \item[\texttt{points2finetriang}] dto.\ for point configurations.
-\item[\texttt{chiro2nfinetriangs}] Computes the number of all fine
-  triangulations of a chirotope that are connected by bistellar flips to a fine
-  seed triangulation.
-\item[\texttt{points2nfinetriangs}] dto.\ for point configurations.
-\item[\texttt{points2flips}] Computes the number of flips of a point
-  configurations and the seed triangulation.
+
+\item[\texttt{chiro2triangs}] Computes all triangulations of a chirotope that
+  are connected by bistellar flips to the regular triangulations.
+\item[\texttt{points2triangs}] dto.\ for point configurations.
+
 \item[\texttt{chiro2ntriangs}] Computes the number of all triangulations of a
   chirotope that are connected by bistellar flips to the regular triangulations.
 \item[\texttt{points2ntriangs}] dto.\ for point configurations.
-\item[\texttt{chiro2nalltriangs}] Computes the number of all triangulations of a
-  chirotope.
+
 \item[\texttt{chiro2finetriangs}] Computes all fine triangulations of a
   chirotope that are connected by bistellar flips to a fine seed
   triangulation.
 \item[\texttt{points2finetriangs}] dto.\ for point configurations.
-\item[\texttt{points2flips}] Computes all flips of a point configurations and the
+
+\item[\texttt{chiro2nfinetriangs}] Computes the number of all fine
+  triangulations of a chirotope that are connected by bistellar flips to a fine
   seed triangulation.
-\item[\texttt{chiro2triangs}] Computes all triangulations of a chirotope that
-  are connected by bistellar flips to the regular triangulations.
-\item[\texttt{points2triangs}] dto.\ for point configurations.
+\item[\texttt{points2nfinetriangs}] dto.\ for point configurations.
+
 \item[\texttt{chiro2alltriangs}] Computes all triangulations of a chirotope.
+\item[\texttt{points2alltriangs}] dto.\ for point configurations.
+
+\item[\texttt{chiro2nalltriangs}] Computes the number of all triangulations of a
+  chirotope.
+\item[\texttt{points2nalltriangs}] dto.\ for point configurations.
+
+\item[\texttt{chiro2allfinetriangs}] Computes all fine triangulations of a
+  chirotope.
+\item[\texttt{points2allfinetriangs}] dto.\ for point configurations.
+
+\item[\texttt{chiro2nallfinetriangs}] Computes the number of all fine
+  triangulations of a chirotope.
+\item[\texttt{points2nallfinetriangs}] dto.\ for point configurations.
+
 \item[\texttt{cube d}] Computes the vertices and symmetry generators of a
   $d$-cube.
 \item[\texttt{cyclic n d}] Computes the vertices and symmetry generators of
@@ -125,17 +149,34 @@ \subsection*{Options controlling what is computed}
   accept triangulations with more vertices.
 \item[\texttt{-}\texttt{-regular}] Search for regular triangulations only (checked liftings are
   w.r.t.\ the last homogeneous coordinate, e.g., last coordinates all ones is
-  fine).
+  fine); note that this may reduce the effort of exploration, since regular
+  triangulations are connected by themselves.
+\item[\texttt{-}\texttt{-nonregular}] Output non-regular triangulations only;
+  note that this does not reduce the effort of exploration, since non-regular
+  triangulations are in general not connected by themselves.
 \end{description}
 
 \subsection*{Options controlling the internals of the clients}
 \begin{description}
-\item[\texttt{-}\texttt{-chirocache $[n]$}] set the chirotope cache to $n$ elements.
-\item[\texttt{-}\texttt{-localcache $[n]$}] set the cache for local operations
-\item[\texttt{-}\texttt{-memopt}] save memory by using caching techniques;
+\item[\texttt{-}\texttt{-chirocache $[n]$}] Set the chirotope cache to $n$ elements.
+\item[\texttt{-}\texttt{-localcache $[n]$}] Set the cache for local operations.
+\item[\texttt{-}\texttt{-memopt}] Save memory by using caching techniques.
 \item[\texttt{-}\texttt{-soplex}] Use soplex instead of cdd for regularity checks (unstable).
 \end{description}
 
+\subsection{Options for warm starts from previous calculations}
+\label{sec:options-warm-starts}
+\begin{description}
+\item[\texttt{-}\texttt{-dumpfile $[$dumpfilename$]$}] Write intermediate results into a file.
+\item[\texttt{-}\texttt{-dumpfrequency $[k]$}] Dump the results of a
+  BFS round if at least $k$ triangulations have been computed
+  inbetween
+\item[\texttt{-}\texttt{-dumprotations $[k]$}] Dump into $k$ different rotating files.
+\item[\texttt{-}\texttt{-readfile $[$readfilename$]$}] Read intermediate results from a file.
+\end{description}
+
+
+
 
 \section{Examples}
 \label{sec:examples}