| 1 |
--- a/standalone-doc/guide.tex |
| 2 |
+++ b/standalone-doc/guide.tex |
| 3 |
@@ -99,7 +99,7 @@ |
| 4 |
a $p$-group. The algorithm implemented here is described in O'Brien (1995). |
| 5 |
\end{enumerate} |
| 6 |
|
| 7 |
-The pq program is written in traditional C and contains about |
| 8 |
+The anu-pq program is written in traditional C and contains about |
| 9 |
22000 lines of code. |
| 10 |
It was developed in a SUN OS environment and has been ported successfully |
| 11 |
to each of Solaris, AIX and Ultrix environments. The interface and |
| 12 |
@@ -114,7 +114,7 @@ |
| 13 |
distributions. |
| 14 |
The program is also distributed as part of Quotpic. |
| 15 |
|
| 16 |
-Version 1.9 of the pq program (i.e.~the version you are currently reading |
| 17 |
+Version 1.9 of the anu-pq program (i.e.~the version you are currently reading |
| 18 |
the documentation for) is configured to call {\sf GAP}, at least version |
| 19 |
4.5, to compute stabilisers when needed. |
| 20 |
|
| 21 |
@@ -143,11 +143,11 @@ |
| 22 |
directory containing those packages of {\sf ANUPQ} and {\sf AutPGrp} |
| 23 |
that are missing from the {\sf GAP} 4 distribution \texttt{pkg} directory. |
| 24 |
|
| 25 |
-The pq program only needs {\sf GAP} for computing stabilisers when you |
| 26 |
+The anu-pq program only needs {\sf GAP} for computing stabilisers when you |
| 27 |
answer ``No'' (\texttt{0}) to the question |
| 28 |
``\texttt{PAG-generating sequence for automorphism group?}''. |
| 29 |
If you neglect to add: ``\verb|GAP=|\textit{GAPPATH}'' to the \verb|make| |
| 30 |
-command, never mind; the pq program first checks to see if the environment |
| 31 |
+command, never mind; the anu-pq program first checks to see if the environment |
| 32 |
variable \verb|ANUPQ_GAP_EXEC| is set. For \texttt{csh} doing: |
| 33 |
|
| 34 |
\begin{quote} |
| 35 |
@@ -173,7 +173,7 @@ |
| 36 |
\emph{standard presentation algorithm} and \emph{automorphism group algorithm} |
| 37 |
implementations may be accessed via the ``Standard Presentation Menu". |
| 38 |
|
| 39 |
-By default, the pq program opens with the Basic Menu [for {\it p}-Quotient |
| 40 |
+By default, the anu-pq program opens with the Basic Menu [for {\it p}-Quotient |
| 41 |
Program] (see~\ref{sec:basic-menu}), which provides ``basic'' options for |
| 42 |
the {\it p}-Quotient algorithm and via options \texttt{8} and \texttt{9} |
| 43 |
gives (immediate) access to two further menus, |
| 44 |
@@ -184,7 +184,7 @@ |
| 45 |
access to a further menu: the Advanced Menu for {\it p}-Group Generation |
| 46 |
(see~\ref{sec:pgrp-gen-advanced-menu}). |
| 47 |
|
| 48 |
-If the pq program is invoked with the \texttt{-i} switch (see |
| 49 |
+If the anu-pq program is invoked with the \texttt{-i} switch (see |
| 50 |
Section~\ref{sec:runtime}), the program opens with the |
| 51 |
Standard Presentation Menu (see Section~\ref{sec:stnd-pres-menu}) |
| 52 |
which gives one immediate access to the |
| 53 |
@@ -192,10 +192,10 @@ |
| 54 |
and via option \texttt{7} access to the Basic Menu |
| 55 |
and hence the other menus. |
| 56 |
|
| 57 |
-To cleanly exit the pq program one must retrace one's path through the menus |
| 58 |
+To cleanly exit the anu-pq program one must retrace one's path through the menus |
| 59 |
(by typing the number of the option that exits each menu or \texttt{0}). |
| 60 |
-Exiting the menu that the pq program opened with (either the Basic Menu |
| 61 |
-or the Standard Presentation Menu), exits the pq program. |
| 62 |
+Exiting the menu that the anu-pq program opened with (either the Basic Menu |
| 63 |
+or the Standard Presentation Menu), exits the anu-pq program. |
| 64 |
|
| 65 |
The Basic Menu, the main Menu for {\it p}-Group Generation and |
| 66 |
the Standard Presentation Menu |
| 67 |
@@ -302,10 +302,10 @@ |
| 68 |
\item |
| 69 |
For each menu, the option \texttt{-1} lists the menu, |
| 70 |
and \texttt{0} exits the menu. |
| 71 |
-To cleanly exit the pq program one must retrace one's path through the menus |
| 72 |
+To cleanly exit the anu-pq program one must retrace one's path through the menus |
| 73 |
(by typing the number of the option that exits each menu or \texttt{0}). |
| 74 |
-Exiting the menu that the pq program opened with (either the Basic Menu |
| 75 |
-or the Standard Presentation Menu), exits the pq program. |
| 76 |
+Exiting the menu that the anu-pq program opened with (either the Basic Menu |
| 77 |
+or the Standard Presentation Menu), exits the anu-pq program. |
| 78 |
|
| 79 |
\item If the program cannot open a file for any reason, it simply |
| 80 |
reports this and if not running interactively exits. |
| 81 |
@@ -452,7 +452,7 @@ |
| 82 |
\begin{description} |
| 83 |
\item[\texttt{1.\ Compute pc presentation}]\ \\ |
| 84 |
When you select this option, you will be given the following sequence |
| 85 |
- of prompts for input. [If you start the pq program with the \texttt{-k} |
| 86 |
+ of prompts for input. [If you start the anu-pq program with the \texttt{-k} |
| 87 |
switch (see Section~\ref{sec:runtime}), you will not be prompted; |
| 88 |
instead you must supply input in the form: |
| 89 |
\begin{quote} |
| 90 |
@@ -552,7 +552,7 @@ |
| 91 |
provides access to the main menu for {\it p}-group generation. |
| 92 |
|
| 93 |
\item[\texttt{10.\ Exit from p-quotient program}]\ \\ |
| 94 |
- causes the pq program to exit, or if pq was called with the \texttt{-i} |
| 95 |
+ causes the anu-pq program to exit, or if pq was called with the \texttt{-i} |
| 96 |
switch (see Section~\ref{sec:runtime}) exits to the Standard Presentation |
| 97 |
Menu. Selecting option \texttt{0} performs the same function. |
| 98 |
|
| 99 |
@@ -641,7 +641,7 @@ |
| 100 |
\textit{starting-group-identifier} is the group identifier defined at option |
| 101 |
\texttt{1} of the Basic Menu (see Section~\ref{sec:basic-menu}) |
| 102 |
e.g.~if you use the \texttt{-k} switch (see Section~\ref{sec:runtime}) |
| 103 |
-when you started the pq program and settled for the default group identifier |
| 104 |
+when you started the anu-pq program and settled for the default group identifier |
| 105 |
\texttt{G} then for class 2, the groups will be saved to a file with name: |
| 106 |
\texttt{G\_class2}. As before, the |
| 107 |
program does not query the user before overwriting an existing file. |
| 108 |
@@ -940,7 +940,7 @@ |
| 109 |
to input a finite presentation for a group, to construct |
| 110 |
a ``standard" presentation for a specified $p$-quotient of the group, |
| 111 |
and also to construct a description of the automorphism group of the $p$-group. |
| 112 |
-To access this menu, you need to run the pq program |
| 113 |
+To access this menu, you need to run the anu-pq program |
| 114 |
with the \texttt{-i} run-time parameter switch (see~\ref{sec:runtime}). |
| 115 |
|
| 116 |
The appropriate way to view the standard presentation algorithm is the |
| 117 |
@@ -1031,7 +1031,7 @@ |
| 118 |
The assumption is that such a file containing the presentation and |
| 119 |
automorphism information for the $p$-group was generated from a previous |
| 120 |
run of the Standard Presentation algorithm. If you don't supply a |
| 121 |
- valid filename the pq program bails out of option \texttt{2}. |
| 122 |
+ valid filename the anu-pq program bails out of option \texttt{2}. |
| 123 |
\end{description} |
| 124 |
% |
| 125 |
Whether or not you have previously selected option \texttt{1}, |
| 126 |
@@ -1083,7 +1083,7 @@ |
| 127 |
to the generators for the standard presentation. |
| 128 |
|
| 129 |
\item[\texttt{9.\ Exit from program}]\ \\ |
| 130 |
- causes the pq program to exit. |
| 131 |
+ causes the anu-pq program to exit. |
| 132 |
Selecting option \texttt{0} performs the same function. |
| 133 |
|
| 134 |
\end{description} |
| 135 |
@@ -1099,7 +1099,7 @@ |
| 136 |
\section{Examples} |
| 137 |
\subsection{A Basic Menu example} |
| 138 |
The following example exercises options within the Basic Menu |
| 139 |
-(see~\ref{sec:basic-menu}). When the pq program is used without any switches |
| 140 |
+(see~\ref{sec:basic-menu}). When the anu-pq program is used without any switches |
| 141 |
(see Section~\ref{sec:runtime}), it opens with the Basic Menu. |
| 142 |
\begin{verbatim} |
| 143 |
Basic Menu for p-Quotient Program |
| 144 |
@@ -1150,15 +1150,15 @@ |
| 145 |
|
| 146 |
This is essentially example \texttt{2gp} in the \texttt{examples} directory |
| 147 |
(except some of our \texttt{\#}\textit{comment}s are different). |
| 148 |
-If the binary for the pq program is \texttt{pq}, then |
| 149 |
+If the binary for the anu-pq program is \texttt{pq}, then |
| 150 |
\begin{quote} |
| 151 |
\verb|pq < 2gp| |
| 152 |
\end{quote} |
| 153 |
executes the example non-interactively, with something similar to the above |
| 154 |
output to the screen, minus the menu. Note that |
| 155 |
-the menus from the pq program are only displayed when it is used interactively. |
| 156 |
-A script file for the pq program (like \texttt{2gp}) should contain the |
| 157 |
-responses that the pq program will expect, in the correct sequence. |
| 158 |
+the menus from the anu-pq program are only displayed when it is used interactively. |
| 159 |
+A script file for the anu-pq program (like \texttt{2gp}) should contain the |
| 160 |
+responses that the anu-pq program will expect, in the correct sequence. |
| 161 |
|
| 162 |
\subsection{A {\it p}-Group Generation example}\label{sec:pgrp-gen-eg} |
| 163 |
|
| 164 |
@@ -1171,7 +1171,7 @@ |
| 165 |
if you run into problemsm, at this point.) |
| 166 |
|
| 167 |
For this example (which generates all groups with lower exponent-3 series of |
| 168 |
-shape 2-2-3-1), the pq program is invoked without any of the switches |
| 169 |
+shape 2-2-3-1), the anu-pq program is invoked without any of the switches |
| 170 |
of Section~\ref{sec:runtime}. |
| 171 |
|
| 172 |
\begin{verbatim} |
| 173 |
@@ -1334,7 +1334,7 @@ |
| 174 |
have not used the \texttt{-k} (keywords) runtime switch and to reduce the |
| 175 |
output we have only computed the standard presentation to class 3 (instead |
| 176 |
of class 10, as in the \verb|2gp| example). |
| 177 |
-For this example, the pq program is invoked with the \texttt{-i} runtime |
| 178 |
+For this example, the anu-pq program is invoked with the \texttt{-i} runtime |
| 179 |
switch (see Section~\ref{sec:runtime}), which gives us access to the |
| 180 |
Standard Presentation Menu (see Section~\ref{sec:stnd-pres-menu}). |
| 181 |
|
| 182 |
@@ -1419,7 +1419,7 @@ |
| 183 |
(see Section~\ref{sec:runtime}). For this example we are again |
| 184 |
using the Standard Presentation Menu; so we also use the \texttt{-i} runtime |
| 185 |
switch. The example is \verb|2gp.com| from the \texttt{isom} directory. |
| 186 |
-If the binary for the pq program is \texttt{pq}, then |
| 187 |
+If the binary for the anu-pq program is \texttt{pq}, then |
| 188 |
\begin{quote} |
| 189 |
\verb|pq -i -k < 2gp.com| |
| 190 |
\end{quote} |
| 191 |
--- a/doc/basics.xml |
| 192 |
+++ b/doc/basics.xml |
| 193 |
@@ -2,7 +2,7 @@ |
| 194 |
<Heading>Mathematical Background and Terminology</Heading> |
| 195 |
|
| 196 |
In this chapter we will give a brief description of the mathematical |
| 197 |
-notions used in the algorithms implemented in the ANU <C>pq</C> program |
| 198 |
+notions used in the algorithms implemented in the ANU <C>anu-pq</C> program |
| 199 |
that are made accessible from &GAP; through this package. For proofs |
| 200 |
and details we will point to relevant places in the published |
| 201 |
literature. Also we will try to give some explanation of terminology |
| 202 |
@@ -93,7 +93,7 @@ |
| 203 |
<Index>class</Index><Index>p-class</Index><!-- @<M>p</M>-class --> |
| 204 |
has <E><M>p</M>-class</E> <M>c</M> if <M>c</M> is the smallest integer such that <M>P_c(G)</M> |
| 205 |
is the trivial group. In this manual, as well as in much of the |
| 206 |
-literature about the <C>pq</C>- and related algorithms, the <M>p</M>-class is |
| 207 |
+literature about the <C>anu-pq</C>- and related algorithms, the <M>p</M>-class is |
| 208 |
often referred to simply by <E>class</E>. |
| 209 |
<P/> |
| 210 |
|
| 211 |
@@ -202,7 +202,7 @@ |
| 212 |
descriptions of the algorithm are given in <Cite Key="Sims94"/>. |
| 213 |
<P/> |
| 214 |
|
| 215 |
-The <C>pq</C> algorithm successively determines the factor groups of the |
| 216 |
+The <C>anu-pq</C> algorithm successively determines the factor groups of the |
| 217 |
groups of the <M>p</M>-central series of a finitely presented (fp) group |
| 218 |
<M>G</M>. If a bound <M>b</M> for the <M>p</M>-class is given, the algorithm will |
| 219 |
determine those factor groups up to at most <M>p</M>-class <M>b</M>. If the |
| 220 |
@@ -295,14 +295,14 @@ |
| 221 |
|
| 222 |
<Index>exponent check</Index> |
| 223 |
In this form, starting with a free group and imposing an exponent law |
| 224 |
-(also referred to as an <E>exponent check</E>) the <C>pq</C> program has, in |
| 225 |
+(also referred to as an <E>exponent check</E>) the <C>anu-pq</C> program has, in |
| 226 |
fact, found its most noted application in the determination of |
| 227 |
(restricted) Burnside groups (as reported in e.g. <Cite Key="HN80"/>, |
| 228 |
<Cite Key="NO96"/> and <Cite Key="VL90b"/>). |
| 229 |
<P/> |
| 230 |
|
| 231 |
Via a &GAP; program using the <Q>local</Q> interactive functions of the |
| 232 |
-<C>pq</C> program made available through this interface also arbitrary laws |
| 233 |
+<C>anu-pq</C> program made available through this interface also arbitrary laws |
| 234 |
can be imposed via the option <C>Identities</C> |
| 235 |
(see <Ref Label="option Identities" Style="Text"/>). |
| 236 |
</Subsection> |
| 237 |
@@ -328,12 +328,12 @@ |
| 238 |
<P/> |
| 239 |
|
| 240 |
The main practical problem here is the determination of these |
| 241 |
-representatives. <Cite Key="OBr90"/> describes methods for this and the <C>pq</C> |
| 242 |
+representatives. <Cite Key="OBr90"/> describes methods for this and the <C>anu-pq</C> |
| 243 |
program allows choices according to whether space or time limitations |
| 244 |
must be met. |
| 245 |
<P/> |
| 246 |
|
| 247 |
-As well as the descendants of <M>G</M>, the <C>pq</C> program determines their |
| 248 |
+As well as the descendants of <M>G</M>, the <C>anu-pq</C> program determines their |
| 249 |
automorphism groups from that of <M>G</M> (see <Cite Key="OBr95"/>), which is |
| 250 |
important for an iteration of the process; this has been used by |
| 251 |
Eamonn O'Brien, e.g. in the classification of the <M>2</M>-groups that are |
| 252 |
--- a/doc/examples.xml |
| 253 |
+++ b/doc/examples.xml |
| 254 |
@@ -5,7 +5,7 @@ |
| 255 |
These may be executed or displayed via the function <C>PqExample</C> |
| 256 |
(see <Ref Func="PqExample" Style="Text"/>). Each example resides in a file of the same name in the |
| 257 |
directory <C>examples</C>. Most of the examples are translations to &GAP; of |
| 258 |
-examples provided for the <C>pq</C> standalone by Eamonn O'Brien; the |
| 259 |
+examples provided for the <C>anu-pq</C> standalone by Eamonn O'Brien; the |
| 260 |
standalone examples are found in directories <C>standalone/examples</C> |
| 261 |
(<M>p</M>-quotient and <M>p</M>-group generation examples) and <C>standalone/isom</C> |
| 262 |
(standard presentation examples). The first line of each example |
| 263 |
@@ -146,11 +146,11 @@ |
| 264 |
|
| 265 |
The <C>Relators</C> option was included because computations involving words |
| 266 |
containing commutators that are pre-expanded by &GAP; before being |
| 267 |
-passed to the <C>pq</C> program may run considerably more slowly, than the |
| 268 |
+passed to the <C>anu-pq</C> program may run considerably more slowly, than the |
| 269 |
same computations being run with &GAP; pre-expansions avoided. The |
| 270 |
following examples demonstrate a case where the performance hit due to |
| 271 |
pre-expansion of commutators by &GAP; is a factor of order 100 (in order |
| 272 |
-to see timing information from the <C>pq</C> program, we set the <C>InfoANUPQ</C> |
| 273 |
+to see timing information from the <C>anu-pq</C> program, we set the <C>InfoANUPQ</C> |
| 274 |
level to 2). |
| 275 |
|
| 276 |
<P/> |
| 277 |
@@ -190,7 +190,7 @@ |
| 278 |
]]></Log> |
| 279 |
|
| 280 |
Now we do the same calculation using the <C>Relators</C> option. In this way, |
| 281 |
-the commutators are passed directly as strings to the <C>pq</C> program, so |
| 282 |
+the commutators are passed directly as strings to the <C>anu-pq</C> program, so |
| 283 |
that &GAP; does not <Q>see</Q> them and pre-expand them. |
| 284 |
|
| 285 |
<Log><![CDATA[ |
| 286 |
@@ -260,7 +260,7 @@ |
| 287 |
Note that the <C>time</C> statement gives the time in milliseconds spent by |
| 288 |
&GAP; in executing the <C>PqExample("B2-4-Id");</C> command (i.e. everything |
| 289 |
up to the <C>Info</C>-ing of the variables used), but over 90% of that time |
| 290 |
-is spent in the final <C>Pq</C> statement. The time spent by the <C>pq</C> program, |
| 291 |
+is spent in the final <C>Pq</C> statement. The time spent by the <C>anu-pq</C> program, |
| 292 |
which is negligible anyway (you can check this by running the example |
| 293 |
while the <C>InfoANUPQ</C> level is set to 2), is not counted by <C>time</C>. |
| 294 |
|
| 295 |
@@ -386,7 +386,7 @@ |
| 296 |
&ANUPQ; package is the computation of the Burnside group <M>B(5, 4)</M>, the |
| 297 |
largest group of exponent 4 generated by 5 elements. It has order |
| 298 |
<M>2^{2728}</M> and lower exponent-<M>p</M> central class 13. The example |
| 299 |
-<C>"B5-4.g"</C> computes <M>B(5, 4)</M>; it is based on a <C>pq</C> standalone input |
| 300 |
+<C>"B5-4.g"</C> computes <M>B(5, 4)</M>; it is based on a <C>anu-pq</C> standalone input |
| 301 |
file written by M. F. Newman. |
| 302 |
<P/> |
| 303 |
|
| 304 |
@@ -658,7 +658,7 @@ |
| 305 |
</Item> |
| 306 |
|
| 307 |
<Item> |
| 308 |
- As each descendant is processed its unique label defined by the <C>pq</C> |
| 309 |
+ As each descendant is processed its unique label defined by the <C>anu-pq</C> |
| 310 |
program and number of descendants is <C>Info</C>-ed at <C>InfoANUPQ</C> level 1. |
| 311 |
</Item> |
| 312 |
|
| 313 |
--- a/doc/infra.xml |
| 314 |
+++ b/doc/infra.xml |
| 315 |
@@ -76,7 +76,7 @@ |
| 316 |
to load. |
| 317 |
<P/> |
| 318 |
|
| 319 |
-Also, if &GAP; cannot find a working <C>pq</C> binary, the call to |
| 320 |
+Also, if &GAP; cannot find a working <C>anu-pq</C> binary, the call to |
| 321 |
<C>LoadPackage</C> will return <K>fail</K>. |
| 322 |
<P/> |
| 323 |
|
| 324 |
@@ -112,26 +112,26 @@ |
| 325 |
<List> |
| 326 |
<Mark><C>binary</C></Mark> |
| 327 |
<Item> |
| 328 |
-the path of the <C>pq</C> binary; |
| 329 |
+the path of the <C>anu-pq</C> binary; |
| 330 |
</Item> |
| 331 |
<Mark><C>tmpdir</C></Mark> |
| 332 |
<Item> |
| 333 |
-the path of the temporary directory used by the <C>pq</C> |
| 334 |
-binary and &GAP; (i.e. the directory in which all the <C>pq</C>'s temporary |
| 335 |
+the path of the temporary directory used by the <C>anu-pq</C> |
| 336 |
+binary and &GAP; (i.e. the directory in which all the <C>anu-pq</C>'s temporary |
| 337 |
files are created) (also see <Ref Func="ANUPQDirectoryTemporary" Style="Text"/> below); |
| 338 |
</Item> |
| 339 |
<Mark><C>outfile</C></Mark> |
| 340 |
<Item> |
| 341 |
-the full path of the default <C>pq</C> output file; |
| 342 |
+the full path of the default <C>anu-pq</C> output file; |
| 343 |
</Item> |
| 344 |
<Mark><C>SPimages</C></Mark> |
| 345 |
<Item> |
| 346 |
the full path of the file <C>GAP_library</C> to which the |
| 347 |
-<C>pq</C> program writes its Standard Presentation images; |
| 348 |
+<C>anu-pq</C> program writes its Standard Presentation images; |
| 349 |
</Item> |
| 350 |
<Mark><C>version</C></Mark> |
| 351 |
<Item> |
| 352 |
-the version of the current <C>pq</C> binary; |
| 353 |
+the version of the current <C>anu-pq</C> binary; |
| 354 |
</Item> |
| 355 |
<Mark><C>ni</C></Mark> |
| 356 |
<Item> |
| 357 |
@@ -177,7 +177,7 @@ |
| 358 |
<Mark><C>haspcp</C></Mark> |
| 359 |
<Item> |
| 360 |
is bound and set to <K>true</K> when a pc presentation is first |
| 361 |
-set inside the <C>pq</C> program (e.g. by <C>PqPcPresentation</C> or |
| 362 |
+set inside the <C>anu-pq</C> program (e.g. by <C>PqPcPresentation</C> or |
| 363 |
<C>PqRestorePcPresentation</C> or a higher order function like <C>Pq</C>, |
| 364 |
<C>PqEpimorphism</C>, <C>PqPCover</C>, <C>PqDescendants</C> or <C>PqStandardPresentation</C> |
| 365 |
that does a <C>PqPcPresentation</C> operation, but <E>not</E> <C>PqStart</C> which only |
| 366 |
@@ -186,17 +186,17 @@ |
| 367 |
<Mark><C>gens</C></Mark> |
| 368 |
<Item> |
| 369 |
a list of the generators of the group <C>group</C> as strings |
| 370 |
-(the same as those passed to the <C>pq</C> program); |
| 371 |
+(the same as those passed to the <C>anu-pq</C> program); |
| 372 |
</Item> |
| 373 |
<Mark><C>rels</C></Mark> |
| 374 |
<Item> |
| 375 |
a list of the relators of the group <C>group</C> as strings (the |
| 376 |
-same as those passed to the <C>pq</C> program); |
| 377 |
+same as those passed to the <C>anu-pq</C> program); |
| 378 |
</Item> |
| 379 |
<Mark><C>name</C></Mark> |
| 380 |
<Item> |
| 381 |
the name of the group whose pc presentation is defined by a |
| 382 |
-call to the <C>pq</C> program (according to the <C>pq</C> program -- unless you |
| 383 |
+call to the <C>anu-pq</C> program (according to the <C>anu-pq</C> program -- unless you |
| 384 |
have used the <C>GroupName</C> option (see e.g. <Ref Func="Pq" Style="Text"/>) or applied the function |
| 385 |
<C>SetName</C> (see <Ref BookName="ref" Func="SetName" Style="Text"/>) to the group, the <Q>generic</Q> name |
| 386 |
<C>"[grp]"</C> is set as a default); |
| 387 |
@@ -204,18 +204,18 @@ |
| 388 |
<Mark><C>gpnum</C></Mark> |
| 389 |
<Item> |
| 390 |
if not a null string, the <Q>number</Q> (i.e. the unique label |
| 391 |
-assigned by the <C>pq</C> program) of the last descendant processed; |
| 392 |
+assigned by the <C>anu-pq</C> program) of the last descendant processed; |
| 393 |
</Item> |
| 394 |
<Mark><C>class</C></Mark> |
| 395 |
<Item> |
| 396 |
the largest lower exponent-<M>p</M> central class of a quotient |
| 397 |
-group of the group (usually <C>group</C>) found by a call to the <C>pq</C> program; |
| 398 |
+group of the group (usually <C>group</C>) found by a call to the <C>anu-pq</C> program; |
| 399 |
</Item> |
| 400 |
<Mark><C>forder</C></Mark> |
| 401 |
<Item> |
| 402 |
the factored order of the quotient group of largest lower |
| 403 |
exponent-<M>p</M> central class found for the group (usually <C>group</C>) by a |
| 404 |
-call to the <C>pq</C> program (this factored order is given as a list |
| 405 |
+call to the <C>anu-pq</C> program (this factored order is given as a list |
| 406 |
<!-- FIXME: [p,n] reformatted --> |
| 407 |
<C>[p,n]</C>, indicating an order of <M>p^n</M>); |
| 408 |
</Item> |
| 409 |
@@ -223,23 +223,23 @@ |
| 410 |
<Item> |
| 411 |
the lower exponent-<M>p</M> central class of the |
| 412 |
<M>p</M>-covering group of a <M>p</M>-quotient of the group (usually <C>group</C>) found |
| 413 |
-by a call to the <C>pq</C> program; |
| 414 |
+by a call to the <C>anu-pq</C> program; |
| 415 |
</Item> |
| 416 |
<Mark><C>workspace</C></Mark> |
| 417 |
<Item> |
| 418 |
-the workspace set for the <C>pq</C> process (either given as |
| 419 |
+the workspace set for the <C>anu-pq</C> process (either given as |
| 420 |
a second argument to <C>PqStart</C>, or set by default to 10000000); |
| 421 |
</Item> |
| 422 |
<Mark><C>menu</C></Mark> |
| 423 |
<Item> |
| 424 |
-the current menu of the <C>pq</C> process (the <C>pq</C> program is |
| 425 |
+the current menu of the <C>anu-pq</C> process (the <C>anu-pq</C> program is |
| 426 |
managed by various menus, the details of which the user shouldn't |
| 427 |
normally need to know about -- the <C>menu</C> field remembers which menu the |
| 428 |
-<C>pq</C> process is currently <Q>in</Q>); |
| 429 |
+<C>anu-pq</C> process is currently <Q>in</Q>); |
| 430 |
</Item> |
| 431 |
<Mark><C>outfname</C></Mark> |
| 432 |
<Item> |
| 433 |
-is the file to which <C>pq</C> output is directed, which is |
| 434 |
+is the file to which <C>anu-pq</C> output is directed, which is |
| 435 |
always <C>ANUPQData.outfile</C>, except when option <C>SetupFile</C> is used with a |
| 436 |
non-interactive function, in which case <C>outfname</C> is set to |
| 437 |
<C>"PQ_OUTPUT"</C>; |
| 438 |
@@ -331,16 +331,16 @@ |
| 439 |
<ManSection> |
| 440 |
<InfoClass Name="InfoANUPQ"/> |
| 441 |
<Description> |
| 442 |
-The input to and the output from the <C>pq</C> program is, by default, not |
| 443 |
+The input to and the output from the <C>anu-pq</C> program is, by default, not |
| 444 |
displayed. However the user may choose to see some, or all, of this |
| 445 |
input/output. This is done via the <C>Info</C> mechanism (see |
| 446 |
Section <Ref BookName="ref" Label="Info Functions" Style="Text"/> in the &GAP; Reference Manual). For this |
| 447 |
purpose, there is the <A>InfoClass</A> <C>InfoANUPQ</C>. If the <C>InfoLevel</C> of |
| 448 |
-<C>InfoANUPQ</C> is high enough each line of <C>pq</C> input/output is directed to |
| 449 |
+<C>InfoANUPQ</C> is high enough each line of <C>anu-pq</C> input/output is directed to |
| 450 |
a call to <C>Info</C> and will be displayed for the user to see. By default, |
| 451 |
the <C>InfoLevel</C> of <C>InfoANUPQ</C> is 1, and it is recommended that you leave |
| 452 |
it at this level, or higher. Messages that the user should presumably |
| 453 |
-want to see and output from the <C>pq</C> program influenced by the value of |
| 454 |
+want to see and output from the <C>anu-pq</C> program influenced by the value of |
| 455 |
the option <C>OutputLevel</C> (see the options listed in Section <Ref Func="Pq" Style="Text"/>), other |
| 456 |
than timing and memory usage are directed to <C>Info</C> at <C>InfoANUPQ</C> level |
| 457 |
1. |
| 458 |
@@ -355,14 +355,14 @@ |
| 459 |
gap> SetInfoLevel(InfoANUPQ, 2); |
| 460 |
]]></Log> |
| 461 |
|
| 462 |
-enables the display of most timing and memory usage data from the <C>pq</C> |
| 463 |
+enables the display of most timing and memory usage data from the <C>anu-pq</C> |
| 464 |
program, and also the number of identity instances when the <C>Identities</C> |
| 465 |
option is used. (Some timing and memory usage data, particularly when |
| 466 |
profuse in quantity, is <C>Info</C>-ed at <C>InfoANUPQ</C> level 3 instead.) Note |
| 467 |
that the the &GAP; functions <C>time</C> and <C>Runtime</C> |
| 468 |
(see <Ref BookName="ref" Func="Runtime" Style="Text"/> in |
| 469 |
the &GAP; Reference Manual) count the time spent by &GAP; and <E>not</E> the |
| 470 |
-time spent by the (external) <C>pq</C> program. |
| 471 |
+time spent by the (external) <C>anu-pq</C> program. |
| 472 |
|
| 473 |
<Log><![CDATA[ |
| 474 |
gap> SetInfoLevel(InfoANUPQ, 3); |
| 475 |
@@ -370,9 +370,9 @@ |
| 476 |
|
| 477 |
enables the display of output of the nature of the first two <C>InfoANUPQ</C> |
| 478 |
that was not directly invoked by the user (e.g. some commands require |
| 479 |
-&GAP; to discover something about the current state known to the <C>pq</C> |
| 480 |
+&GAP; to discover something about the current state known to the <C>anu-pq</C> |
| 481 |
program). The identity instances processed under the <C>Identities</C> option |
| 482 |
-are also displayed at this level. In some cases, the <C>pq</C> program |
| 483 |
+are also displayed at this level. In some cases, the <C>anu-pq</C> program |
| 484 |
produces a lot of output despite the fact that the <C>OutputLevel</C> |
| 485 |
(see <Ref Label="option OutputLevel" Style="Text"/>) is unset or is set to 0; such output is also |
| 486 |
<C>Info</C>-ed at <C>InfoANUPQ</C> level 3. |
| 487 |
@@ -381,23 +381,23 @@ |
| 488 |
gap> SetInfoLevel(InfoANUPQ, 4); |
| 489 |
]]></Log> |
| 490 |
|
| 491 |
-enables the display of all the commands directed to the <C>pq</C> program, |
| 492 |
+enables the display of all the commands directed to the <C>anu-pq</C> program, |
| 493 |
behind a <Q><C>ToPQ> </C></Q> prompt (so that you can distinguish it from the |
| 494 |
-output from the <C>pq</C> program). See Section <Ref Sect="Hints and Warnings regarding the use of Options" Style="Text"/> for an example of how this can be a useful |
| 495 |
+output from the <C>anu-pq</C> program). See Section <Ref Sect="Hints and Warnings regarding the use of Options" Style="Text"/> for an example of how this can be a useful |
| 496 |
troubleshooting tool. |
| 497 |
|
| 498 |
<Log><![CDATA[ |
| 499 |
gap> SetInfoLevel(InfoANUPQ, 5); |
| 500 |
]]></Log> |
| 501 |
|
| 502 |
-enables the display of the <C>pq</C> program's prompts for input. Finally, |
| 503 |
+enables the display of the <C>anu-pq</C> program's prompts for input. Finally, |
| 504 |
|
| 505 |
<Log><![CDATA[ |
| 506 |
gap> SetInfoLevel(InfoANUPQ, 6); |
| 507 |
]]></Log> |
| 508 |
|
| 509 |
-enables the display of all other output from the <C>pq</C> program, namely the |
| 510 |
-banner and menus. However, the timing data printed when the <C>pq</C> program |
| 511 |
+enables the display of all other output from the <C>anu-pq</C> program, namely the |
| 512 |
+banner and menus. However, the timing data printed when the <C>anu-pq</C> program |
| 513 |
exits can never be observed. |
| 514 |
|
| 515 |
</Description> |
| 516 |
@@ -428,13 +428,13 @@ |
| 517 |
<Description> |
| 518 |
returns a list of words that &GAP; understands, given a list <A>rels</A> of |
| 519 |
strings in the string representations of the generators of the fp group |
| 520 |
-<A>group</A> prepared as a list of relators for the <C>pq</C> program. |
| 521 |
+<A>group</A> prepared as a list of relators for the <C>anu-pq</C> program. |
| 522 |
<P/> |
| 523 |
|
| 524 |
<E>Note:</E> |
| 525 |
-The <C>pq</C> program does not use <C>/</C> to indicate multiplication by an |
| 526 |
+The <C>anu-pq</C> program does not use <C>/</C> to indicate multiplication by an |
| 527 |
inverse and uses square brackets to represent (left normed) commutators. |
| 528 |
-Also, even though the <C>pq</C> program accepts relations, all elements of |
| 529 |
+Also, even though the <C>anu-pq</C> program accepts relations, all elements of |
| 530 |
<A>rels</A> <E>must</E> be in relator form, i.e. a relation of form <C><A>w1</A> = <A>w2</A></C> |
| 531 |
must be written as <C><A>w1</A>*(<A>w2</A>)^-1</C>. |
| 532 |
<P/> |
| 533 |
@@ -464,9 +464,9 @@ |
| 534 |
|
| 535 |
<E>Note:</E> |
| 536 |
The reason the generators <E>must</E> be <C>x1,...,x<A>n</A></C> is that these are the |
| 537 |
-pc generator names used by the <C>pq</C> program (as distinct from the |
| 538 |
+pc generator names used by the <C>anu-pq</C> program (as distinct from the |
| 539 |
generator names for the group provided by the user to a function like |
| 540 |
-<C>Pq</C> that invokes the <C>pq</C> program). |
| 541 |
+<C>Pq</C> that invokes the <C>anu-pq</C> program). |
| 542 |
</Description> |
| 543 |
</ManSection> |
| 544 |
|
| 545 |
@@ -537,7 +537,7 @@ |
| 546 |
<Func Name="ToPQLog" Arg="[ filename ]"/> |
| 547 |
<Description> |
| 548 |
With string argument <A>filename</A>, <C>ToPQLog</C> opens the file with name |
| 549 |
-<A>filename</A> for logging; all commands written to the <C>pq</C> binary (that are |
| 550 |
+<A>filename</A> for logging; all commands written to the <C>anu-pq</C> binary (that are |
| 551 |
<C>Info</C>-ed behind a <Q><C>ToPQ> </C></Q> prompt at <C>InfoANUPQ</C> level 4) are then |
| 552 |
also written to that file (but without prompts). With no argument, |
| 553 |
<C>ToPQLog</C> stops logging to whatever file was being logged to. If a file |
| 554 |
@@ -615,9 +615,9 @@ |
| 555 |
<Index Subkey="of pq program">menu item</Index> |
| 556 |
<Index Subkey="of pq program is a menu item">option</Index> <!-- FIXME: is this right? --> |
| 557 |
<E>Note:</E> |
| 558 |
-By <Q>options</Q> we refer to &GAP; options. The <C>pq</C> program also uses the |
| 559 |
+By <Q>options</Q> we refer to &GAP; options. The <C>anu-pq</C> program also uses the |
| 560 |
term <Q>option</Q>; to distinguish the two usages of <Q>option</Q>, in this |
| 561 |
-manual we use the term <E>menu item</E> to refer to what the <C>pq</C> program |
| 562 |
+manual we use the term <E>menu item</E> to refer to what the <C>anu-pq</C> program |
| 563 |
refers to as an <Q>option</Q>. |
| 564 |
<P/> |
| 565 |
|
| 566 |
@@ -754,7 +754,7 @@ |
| 567 |
|
| 568 |
There are some other strategies which may have helped us to see our error |
| 569 |
above. The function <C>Pq</C> recognises the option <C>OutputLevel</C> |
| 570 |
-(see <Ref Label="option OutputLevel" Style="Text"/>); if this option is set to at least 1, the <C>pq</C> program |
| 571 |
+(see <Ref Label="option OutputLevel" Style="Text"/>); if this option is set to at least 1, the <C>anu-pq</C> program |
| 572 |
provides information on each class quotient as it is generated: |
| 573 |
<Log><![CDATA[ |
| 574 |
gap> ANUPQWarnOfOtherOptions := false;; # Set back to normal |
| 575 |
@@ -785,7 +785,7 @@ |
| 576 |
value of <C>ClassBound</C>). |
| 577 |
<P/> |
| 578 |
|
| 579 |
-If you have some familiarity with <Q>keyword</Q> command input to the <C>pq</C> |
| 580 |
+If you have some familiarity with <Q>keyword</Q> command input to the <C>anu-pq</C> |
| 581 |
binary, then setting the level of <C>InfoANUPQ</C> to 4 would also have |
| 582 |
indicated a problem: |
| 583 |
<Log><![CDATA[ |
| 584 |
@@ -805,7 +805,7 @@ |
| 585 |
]]></Log> |
| 586 |
|
| 587 |
Here the line <Q><C>#I ToPQ> class 63</C></Q> indicates that a directive to set |
| 588 |
-the classbound to 63 was sent to the <C>pq</C> program. |
| 589 |
+the classbound to 63 was sent to the <C>anu-pq</C> program. |
| 590 |
|
| 591 |
</Section> |
| 592 |
</Chapter> |
| 593 |
--- a/doc/install.xml |
| 594 |
+++ b/doc/install.xml |
| 595 |
@@ -1,7 +1,7 @@ |
| 596 |
<Chapter Label="Installing-ANUPQ"> |
| 597 |
<Heading>Installing the ANUPQ Package</Heading> |
| 598 |
|
| 599 |
-The ANU <C>pq</C> program is written in C and the package can be installed |
| 600 |
+The ANU <C>anu-pq</C> program is written in C and the package can be installed |
| 601 |
under UNIX and in environments similar to UNIX. In particular |
| 602 |
it is known to work on Linux and Mac OS X, and also on Windows |
| 603 |
equipped with cygwin. |
| 604 |
@@ -66,8 +66,8 @@ |
| 605 |
|
| 606 |
What this does is look for a file <C>sysinfo.gap</C> in the root directory of |
| 607 |
&GAP; in order to determine an architecture name for the subdirectory of |
| 608 |
-<C>bin</C> in which to put the compiled <C>pq</C> binary. This only makes sense if |
| 609 |
-&GAP; was compiled for the same architecture that <C>pq</C> will be. If you |
| 610 |
+<C>bin</C> in which to put the compiled <C>anu-pq</C> binary. This only makes sense if |
| 611 |
+&GAP; was compiled for the same architecture that <C>anu-pq</C> will be. If you |
| 612 |
have a shared file system mounted across different architectures, then |
| 613 |
you should run <C>configure</C> and <C>make</C> for &ANUPQ; for each architecture |
| 614 |
immediately after compiling &GAP; on the same architecture. |
| 615 |
@@ -98,12 +98,12 @@ |
| 616 |
<P/> |
| 617 |
|
| 618 |
<Index Key="ANUPQ_GAP_EXEC" Subkey="environment variable"><C>ANUPQ_GAP_EXEC</C></Index> |
| 619 |
-The path of &GAP; (see <E>Note</E> below) used by the <C>pq</C> binary (the value |
| 620 |
+The path of &GAP; (see <E>Note</E> below) used by the <C>anu-pq</C> binary (the value |
| 621 |
<C>GAP</C> is set to in the <C>make</C> command) may be over-ridden by setting the |
| 622 |
environment variable <C>ANUPQ_GAP_EXEC</C>. These values are only of interest |
| 623 |
-when the <C>pq</C> program is run as a standalone; however, the <C>testPq</C> |
| 624 |
-script assumes you have set one of these correctly (see Section <Ref Sect="Testing your ANUPQ installation" Style="Text"/>). When the <C>pq</C> program is started from &GAP; |
| 625 |
-communication occurs via an iostream, so that the <C>pq</C> binary does not |
| 626 |
+when the <C>anu-pq</C> program is run as a standalone; however, the <C>testPq</C> |
| 627 |
+script assumes you have set one of these correctly (see Section <Ref Sect="Testing your ANUPQ installation" Style="Text"/>). When the <C>anu-pq</C> program is started from &GAP; |
| 628 |
+communication occurs via an iostream, so that the <C>anu-pq</C> binary does not |
| 629 |
actually need to know a valid path for &GAP; is this case. |
| 630 |
<P/> |
| 631 |
|
| 632 |
@@ -124,7 +124,7 @@ |
| 633 |
Now it is time to test the installation. After doing <C>configure</C> and |
| 634 |
<C>make</C> you will have a <C>testPq</C> script. The script assumes that, if the |
| 635 |
environment variable <C>ANUPQ_GAP_EXEC</C> is set, it is a correct path for |
| 636 |
-&GAP;, or otherwise that the <C>make</C> call that compiled the <C>pq</C> program |
| 637 |
+&GAP;, or otherwise that the <C>make</C> call that compiled the <C>anu-pq</C> program |
| 638 |
set <C>GAP</C> to a correct path for &GAP; (see Section <Ref Sect="Running the pq program as a standalone" Style="Text"/> for more details). To run the tests, just type: |
| 639 |
|
| 640 |
<Listing><![CDATA[ |
| 641 |
@@ -134,7 +134,7 @@ |
| 642 |
Some of the tests the script runs take a while. Please be patient. The |
| 643 |
script checks that you not only have a correct &GAP; (at least version |
| 644 |
4.4) installation that includes the &AutPGrp; package, but that the |
| 645 |
-&ANUPQ; package and its <C>pq</C> binary interact correctly. You should see |
| 646 |
+&ANUPQ; package and its <C>anu-pq</C> binary interact correctly. You should see |
| 647 |
something like the following output: |
| 648 |
|
| 649 |
<Log><![CDATA[ |
| 650 |
@@ -174,12 +174,12 @@ |
| 651 |
<Heading>Running the pq program as a standalone</Heading> |
| 652 |
|
| 653 |
<Index Key="ANUPQ_GAP_EXEC" Subkey="environment variable"><C>ANUPQ_GAP_EXEC</C></Index> |
| 654 |
-When the <C>pq</C> program is run as a standalone it sometimes needs to call |
| 655 |
+When the <C>anu-pq</C> program is run as a standalone it sometimes needs to call |
| 656 |
&GAP; to compute stabilisers of subgroups; in doing so, it first checks |
| 657 |
the value of the environment variable <C>ANUPQ_GAP_EXEC</C>, and uses that, if |
| 658 |
set, or otherwise the value of <C>GAP</C> it was compiled with, as the path |
| 659 |
for &GAP;. If you ran <C>testPq</C> (see Section <Ref Sect="Testing your ANUPQ installation" Style="Text"/>) and you got both &GAP; is <C>OK</C> and the link between the |
| 660 |
-<C>pq</C> binary and &GAP; is <C>OK</C>, you should be fine. Otherwise heed the |
| 661 |
+<C>anu-pq</C> binary and &GAP; is <C>OK</C>, you should be fine. Otherwise heed the |
| 662 |
recommendations of the error messages you get and run the <C>testPq</C> until |
| 663 |
all tests are passed. |
| 664 |
<P/> |
| 665 |
@@ -190,7 +190,7 @@ |
| 666 |
to install the needed packages in your own directory (because, say, you |
| 667 |
are not a system administrator) then you should create your own shell |
| 668 |
script that runs &GAP; with a correct setting of the <C>-l</C> option and set |
| 669 |
-the path used by the <C>pq</C> binary to the path of that script. To create |
| 670 |
+the path used by the <C>anu-pq</C> binary to the path of that script. To create |
| 671 |
the script that runs &GAP; it is easiest to copy the system one and edit |
| 672 |
it, e.g. start by executing the following UNIX commands (skip the second |
| 673 |
step if you already have a <C>bin</C> directory; <C>you@unix></C> is your UNIX |
| 674 |
@@ -223,7 +223,7 @@ |
| 675 |
]]></Listing> |
| 676 |
|
| 677 |
assuming that your personal &GAP; <C>pkg</C> directory is a subdirectory of |
| 678 |
-<C>gapstuff</C> in your home directory. Finally, to let the <C>pq</C> program know |
| 679 |
+<C>gapstuff</C> in your home directory. Finally, to let the <C>anu-pq</C> program know |
| 680 |
where &GAP; is and also know where your <C>pkg</C> directory is that contains |
| 681 |
&ANUPQ;, set the environment variable <C>ANUPQ_GAP_EXEC</C> to the complete |
| 682 |
(i.e. absolute) path of your <C>mygap</C> script (do not use the tilde |
| 683 |
--- a/doc/interact.xml |
| 684 |
+++ b/doc/interact.xml |
| 685 |
@@ -4,11 +4,11 @@ |
| 686 |
Here we describe the interactive functions defined by the &ANUPQ; |
| 687 |
package, i.e. the functions that manipulate and initiate interactive |
| 688 |
&ANUPQ; processes. These are functions that extract information via a |
| 689 |
-dialogue with a running <C>pq</C> process (process used in the UNIX sense). |
| 690 |
+dialogue with a running <C>anu-pq</C> process (process used in the UNIX sense). |
| 691 |
Occasionally, a user needs the <Q>next step</Q>; the functions provided in |
| 692 |
-this chapter make use of data from previous steps retained by the <C>pq</C> |
| 693 |
-program, thus allowing the user to interact with the <C>pq</C> program like |
| 694 |
-one can when one uses the <C>pq</C> program as a stand-alone (see <C>guide.dvi</C> |
| 695 |
+this chapter make use of data from previous steps retained by the <C>anu-pq</C> |
| 696 |
+program, thus allowing the user to interact with the <C>anu-pq</C> program like |
| 697 |
+one can when one uses the <C>anu-pq</C> program as a stand-alone (see <C>guide.dvi</C> |
| 698 |
in the <C>standalone-doc</C> directory). |
| 699 |
<P/> |
| 700 |
|
| 701 |
@@ -42,7 +42,7 @@ |
| 702 |
died), may result. Since zombie processes do consume resources, in such |
| 703 |
an event, the responsible computer user should seek out and terminate |
| 704 |
those zombie processes (e.g. on Linux: <C>ps xw | grep pq</C> gives you |
| 705 |
-information on the <C>pq</C> processes corresponding to any interactive |
| 706 |
+information on the <C>anu-pq</C> processes corresponding to any interactive |
| 707 |
&ANUPQ; processes started in a &GAP; session; you can then do <C>kill |
| 708 |
<A>N</A></C> for each number <A>N</A> appearing in the first column of this output). |
| 709 |
|
| 710 |
@@ -56,16 +56,16 @@ |
| 711 |
<Func Name="PqStart" Arg=": options"/> |
| 712 |
<Description> |
| 713 |
activate an iostream for an interactive &ANUPQ; process (i.e. <C>PqStart</C> |
| 714 |
-starts up a <C>pq</C> process and opens a &GAP; iostream to <Q>talk</Q> to that |
| 715 |
+starts up a <C>anu-pq</C> process and opens a &GAP; iostream to <Q>talk</Q> to that |
| 716 |
process) and returns an integer <A>i</A> that can be used to identify that |
| 717 |
process. The argument <A>G</A> should be an <E>fp group</E> or <E>pc group</E> that the |
| 718 |
user intends to manipulate using interactive &ANUPQ; functions. If the |
| 719 |
function is called without specifying <A>G</A>, a group can be read in by |
| 720 |
using the function <C>PqRestorePcPresentation</C> (see <Ref Func="PqRestorePcPresentation" Style="Text"/>). |
| 721 |
-If <C>PqStart</C> is given an integer argument <A>workspace</A>, then the <C>pq</C> |
| 722 |
+If <C>PqStart</C> is given an integer argument <A>workspace</A>, then the <C>anu-pq</C> |
| 723 |
program is started up with a workspace (an integer array) of size |
| 724 |
<A>workspace</A> (i.e. <M>4 \times <A>workspace</A></M> bytes in a 32-bit environment); |
| 725 |
-otherwise, the <C>pq</C> program sets a default workspace of <M>10000000</M>. |
| 726 |
+otherwise, the <C>anu-pq</C> program sets a default workspace of <M>10000000</M>. |
| 727 |
<P/> |
| 728 |
|
| 729 |
The only <A>options</A> currently recognised by <C>PqStart</C> are <C>Prime</C>, |
| 730 |
@@ -86,11 +86,11 @@ |
| 731 |
<P/> |
| 732 |
|
| 733 |
<E>Note:</E> |
| 734 |
-It can happen that the <C>pq</C> process, and hence the &GAP; iostream |
| 735 |
+It can happen that the <C>anu-pq</C> process, and hence the &GAP; iostream |
| 736 |
assigned to communicate with it, can die, e.g. by the user typing a |
| 737 |
-<C>Ctrl-C</C> while the <C>pq</C> process is engaged in a long calculation. |
| 738 |
+<C>Ctrl-C</C> while the <C>anu-pq</C> process is engaged in a long calculation. |
| 739 |
<C>IsPqProcessAlive</C> (see <Ref Func="IsPqProcessAlive" Style="Text"/>) is provided to check the |
| 740 |
-status of the &GAP; iostream (and hence the status of the <C>pq</C> process |
| 741 |
+status of the &GAP; iostream (and hence the status of the <C>anu-pq</C> process |
| 742 |
it was communicating with). |
| 743 |
</Description> |
| 744 |
</ManSection> |
| 745 |
@@ -148,7 +148,7 @@ |
| 746 |
<P/> |
| 747 |
|
| 748 |
<Index>interruption</Index><!-- @interruption of an interactive ANUPQ process --> |
| 749 |
-If the user does not yet have a <C>gap></C> prompt then usually the <C>pq</C> |
| 750 |
+If the user does not yet have a <C>gap></C> prompt then usually the <C>anu-pq</C> |
| 751 |
program is still away doing something and an &ANUPQ; interface function |
| 752 |
is still waiting for a reply. Typing a <C>Ctrl-C</C> (i.e. holding down the |
| 753 |
<C>Ctrl</C> key and typing <C>c</C>) will stop the waiting and send &GAP; into a |
| 754 |
@@ -159,7 +159,7 @@ |
| 755 |
<P/> |
| 756 |
|
| 757 |
The &GAP; iostream of an interactive &ANUPQ; process will also die if |
| 758 |
-the <C>pq</C> program has a segmentation fault. We do hope that this never |
| 759 |
+the <C>anu-pq</C> program has a segmentation fault. We do hope that this never |
| 760 |
happens to you, but if it does and the failure is reproducible, then it's |
| 761 |
a bug and we'd like to know about it. Please read the <C>README</C> that comes |
| 762 |
with the &ANUPQ; package to find out what to include in a bug report and |
| 763 |
@@ -231,7 +231,7 @@ |
| 764 |
<P/> |
| 765 |
|
| 766 |
The behaviour of the interactive <C>Pq</C> function depends on the current |
| 767 |
-state of the pc presentation stored by the <C>pq</C> program: |
| 768 |
+state of the pc presentation stored by the <C>anu-pq</C> program: |
| 769 |
|
| 770 |
<Enum> |
| 771 |
<Item> |
| 772 |
@@ -301,7 +301,7 @@ |
| 773 |
default interactive &ANUPQ; process, an epimorphism from <A>F</A> onto the |
| 774 |
<M>p</M>-quotient of <A>F</A> specified by <A>options</A>; <A>F</A> must previously have been |
| 775 |
given (as first argument) to <C>PqStart</C> to start the interactive &ANUPQ; |
| 776 |
-process (see <Ref Func="PqStart" Style="Text"/>). Since the underlying interactions with the <C>pq</C> |
| 777 |
+process (see <Ref Func="PqStart" Style="Text"/>). Since the underlying interactions with the <C>anu-pq</C> |
| 778 |
program effected by the interactive <C>PqEpimorphism</C> are identical to |
| 779 |
those effected by the interactive <C>Pq</C>, everything said regarding the |
| 780 |
requirements and behaviour of the interactive <C>Pq</C> function |
| 781 |
@@ -415,8 +415,8 @@ |
| 782 |
|
| 783 |
Taking one of the examples for the non-interactive version of |
| 784 |
<C>StandardPresentation</C> (see <Ref Func="StandardPresentation" Style="Text"/>) that required two |
| 785 |
-separate calls to the <C>pq</C> program, we now show how it can be done by |
| 786 |
-setting up a dialogue with just the one <C>pq</C> process, using the |
| 787 |
+separate calls to the <C>anu-pq</C> program, we now show how it can be done by |
| 788 |
+setting up a dialogue with just the one <C>anu-pq</C> process, using the |
| 789 |
interactive version of <C>StandardPresentation</C>: |
| 790 |
|
| 791 |
<Example><![CDATA[ |
| 792 |
@@ -498,8 +498,8 @@ |
| 793 |
(see <Ref Func="EpimorphismPqStandardPresentation" Style="Text"/>) and modifying it a little, we |
| 794 |
illustrate, as for the interactive <C>StandardPresentation</C> |
| 795 |
(see <Ref Func="StandardPresentation" Label="interactive" Style="Text"/>), how something that required two |
| 796 |
-separate calls to the <C>pq</C> program can now be achieved with a dialogue |
| 797 |
-with just one <C>pq</C> process. Also, observe that calls to one of the |
| 798 |
+separate calls to the <C>anu-pq</C> program can now be achieved with a dialogue |
| 799 |
+with just one <C>anu-pq</C> process. Also, observe that calls to one of the |
| 800 |
standard presentation functions (as mentioned in the notes |
| 801 |
of <Ref Func="StandardPresentation" Label="interactive" Style="Text"/>) computes and stores both an fp |
| 802 |
group with a standard presentation and an epimorphism; subsequent calls |
| 803 |
@@ -639,7 +639,7 @@ |
| 804 |
<E>Notes:</E> The function <C>PqDescendants</C> uses the automorphism group of <A>G</A> |
| 805 |
which it computes via the package &AutPGrp; if the automorphism group of |
| 806 |
<A>G</A> is not already present. If &AutPGrp; is not installed an error may |
| 807 |
-be raised. If the automorphism group of <A>G</A> is insoluble the <C>pq</C> |
| 808 |
+be raised. If the automorphism group of <A>G</A> is insoluble the <C>anu-pq</C> |
| 809 |
program will call &GAP; together with the &AutPGrp; package for certain |
| 810 |
orbit-stabilizer calculations. |
| 811 |
<P/> |
| 812 |
@@ -728,9 +728,9 @@ |
| 813 |
<M>p</M>-quotient previously computed by the interactive <C>Pq</C> function |
| 814 |
(see <Ref Func="Pq" Label="interactive" Style="Text"/>) to be the group of the process. This function is |
| 815 |
supplied to enable the computation of descendants of a <M>p</M>-quotient that |
| 816 |
-is already known to the <C>pq</C> program, via the interactive <C>PqDescendants</C> |
| 817 |
+is already known to the <C>anu-pq</C> program, via the interactive <C>PqDescendants</C> |
| 818 |
function (see <Ref Func="PqDescendants" Label="interactive" Style="Text"/>), thus avoiding the need to |
| 819 |
-re-submit it and have the <C>pq</C> program recompute it. |
| 820 |
+re-submit it and have the <C>anu-pq</C> program recompute it. |
| 821 |
<P/> |
| 822 |
|
| 823 |
<E>Note:</E> See the function <C>PqPGSetDescendantToPcp</C> |
| 824 |
@@ -776,21 +776,21 @@ |
| 825 |
<Heading>Low-level Interactive ANUPQ functions based on menu items of the |
| 826 |
pq program</Heading> |
| 827 |
|
| 828 |
-The <C>pq</C> program has 5 menus, the details of which the reader will not |
| 829 |
+The <C>anu-pq</C> program has 5 menus, the details of which the reader will not |
| 830 |
normally need to know, but if she wishes to know the details they may be |
| 831 |
found in the standalone manual: <C>guide.dvi</C>. Both <C>guide.dvi</C> and the |
| 832 |
-<C>pq</C> program refer to the items of these 5 menus as <Q>options</Q>, which do |
| 833 |
+<C>anu-pq</C> program refer to the items of these 5 menus as <Q>options</Q>, which do |
| 834 |
<E>not</E> correspond in any way to the options used by any of the &GAP; |
| 835 |
-functions that interface with the <C>pq</C> program. |
| 836 |
+functions that interface with the <C>anu-pq</C> program. |
| 837 |
<P/> |
| 838 |
|
| 839 |
<E>Warning:</E> |
| 840 |
The commands provided in this section are intended to provide something |
| 841 |
like the interactive functionality one has when running the standalone, |
| 842 |
-from within &GAP;. The <C>pq</C> standalone (in particular, its <Q>advanced</Q> |
| 843 |
+from within &GAP;. The <C>anu-pq</C> standalone (in particular, its <Q>advanced</Q> |
| 844 |
menus) assumes some expertise of the user; doing the <Q>wrong</Q> thing can |
| 845 |
cause the program to crash. While a number of safeguards have been |
| 846 |
-provided in the &GAP; interface to the <C>pq</C> program, these are <E>not</E> |
| 847 |
+provided in the &GAP; interface to the <C>anu-pq</C> program, these are <E>not</E> |
| 848 |
foolproof, and the user should exercise care and ensure pre-requisites of |
| 849 |
the various commands are met. |
| 850 |
</Section> |
| 851 |
@@ -798,8 +798,8 @@ |
| 852 |
<Section><Heading>General commands</Heading> |
| 853 |
|
| 854 |
The following commands either use a menu item from whatever menu is |
| 855 |
-<Q>current</Q> for the <C>pq</C> program, or have general application and are not |
| 856 |
-associated with just one menu item of the <C>pq</C> program. |
| 857 |
+<Q>current</Q> for the <C>anu-pq</C> program, or have general application and are not |
| 858 |
+associated with just one menu item of the <C>anu-pq</C> program. |
| 859 |
|
| 860 |
<ManSection> |
| 861 |
<Func Name="PqNrPcGenerators" Arg="i"/> |
| 862 |
@@ -881,12 +881,12 @@ |
| 863 |
<Func Name="PqDisplayPcPresentation" Arg="i : [OutputLevel := lev ]"/> |
| 864 |
<Func Name="PqDisplayPcPresentation" Arg=": [OutputLevel := lev ]" Label="for default process"/> |
| 865 |
<Description> |
| 866 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 867 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 868 |
program to display the pc presentation of the lower exponent <M>p</M>-class |
| 869 |
quotient of the group currently determined by the process. |
| 870 |
<P/> |
| 871 |
|
| 872 |
-Except if the last command communicating with the <C>pq</C> program was a |
| 873 |
+Except if the last command communicating with the <C>anu-pq</C> program was a |
| 874 |
<M>p</M>-group generation command (for which there is only a verbose output |
| 875 |
level), to set the amount of information this command displays you may |
| 876 |
wish to call <C>PqSetOutputLevel</C> first (see <Ref Func="PqSetOutputLevel" Style="Text"/>), or |
| 877 |
@@ -894,8 +894,8 @@ |
| 878 |
<P/> |
| 879 |
|
| 880 |
<E>Note:</E> |
| 881 |
-For those familiar with the <C>pq</C> program, <C>PqDisplayPcPresentation</C> |
| 882 |
-performs menu item 4 of the current menu of the <C>pq</C> program. |
| 883 |
+For those familiar with the <C>anu-pq</C> program, <C>PqDisplayPcPresentation</C> |
| 884 |
+performs menu item 4 of the current menu of the <C>anu-pq</C> program. |
| 885 |
</Description> |
| 886 |
</ManSection> |
| 887 |
|
| 888 |
@@ -903,11 +903,11 @@ |
| 889 |
<Func Name="PqSetOutputLevel" Arg="i, lev"/> |
| 890 |
<Func Name="PqSetOutputLevel" Arg="lev" Label="for default process"/> |
| 891 |
<Description> |
| 892 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 893 |
-program to set the output level of the <C>pq</C> program to <A>lev</A>. |
| 894 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 895 |
+program to set the output level of the <C>anu-pq</C> program to <A>lev</A>. |
| 896 |
<P/> |
| 897 |
|
| 898 |
-<E>Note:</E> For those familiar with the <C>pq</C> program, <C>PqSetOutputLevel</C> |
| 899 |
+<E>Note:</E> For those familiar with the <C>anu-pq</C> program, <C>PqSetOutputLevel</C> |
| 900 |
performs menu item 5 of the main (or advanced) <M>p</M>-Quotient menu, or the |
| 901 |
Standard Presentation menu. |
| 902 |
</Description> |
| 903 |
@@ -925,7 +925,7 @@ |
| 904 |
<P/> |
| 905 |
|
| 906 |
<E>Note:</E> This function is mainly implemented at the &GAP; level. It does |
| 907 |
-not correspond to a menu item of the <C>pq</C> program. |
| 908 |
+not correspond to a menu item of the <C>anu-pq</C> program. |
| 909 |
</Description> |
| 910 |
</ManSection> |
| 911 |
|
| 912 |
@@ -937,7 +937,7 @@ |
| 913 |
<Func Name="PqPcPresentation" Arg="i : options"/> |
| 914 |
<Func Name="PqPcPresentation" Arg=": options" Label="for default process"/> |
| 915 |
<Description> |
| 916 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 917 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 918 |
program to compute the pc presentation of the quotient (determined by |
| 919 |
<A>options</A>) of the group of the process, which for process <A>i</A> is stored |
| 920 |
as <C>ANUPQData.io[<A>i</A>].group</C>. |
| 921 |
@@ -955,7 +955,7 @@ |
| 922 |
<E>Notes</E> |
| 923 |
<P/> |
| 924 |
|
| 925 |
-The pc presentation is held by the <C>pq</C> program. In contrast to <C>Pq</C> |
| 926 |
+The pc presentation is held by the <C>anu-pq</C> program. In contrast to <C>Pq</C> |
| 927 |
(see <Ref Func="Pq" Label="interactive" Style="Text"/>), no &GAP; pc group is returned; |
| 928 |
see <C>PqCurrentGroup</C> (<Ref Func="PqCurrentGroup" Style="Text"/>) if you need the corresponding |
| 929 |
&GAP; pc group. |
| 930 |
@@ -980,7 +980,7 @@ |
| 931 |
<C>PqEvaluateIdentities(<A>i</A>);</C> as their final step. |
| 932 |
<P/> |
| 933 |
|
| 934 |
-For those familiar with the <C>pq</C> program, <C>PqPcPresentation</C> performs |
| 935 |
+For those familiar with the <C>anu-pq</C> program, <C>PqPcPresentation</C> performs |
| 936 |
menu item 1 of the main <M>p</M>-Quotient menu. |
| 937 |
</Description> |
| 938 |
</ManSection> |
| 939 |
@@ -989,7 +989,7 @@ |
| 940 |
<Func Name="PqSavePcPresentation" Arg="i, filename"/> |
| 941 |
<Func Name="PqSavePcPresentation" Arg="filename" Label="for default process"/> |
| 942 |
<Description> |
| 943 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 944 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 945 |
program to save the pc presentation previously computed for the quotient |
| 946 |
of the group of that process to the file with name <A>filename</A>. If the |
| 947 |
first character of the string <A>filename</A> is not <C>/</C>, <A>filename</A> is |
| 948 |
@@ -998,7 +998,7 @@ |
| 949 |
<C>PqRestorePcPresentation</C> (see <Ref Func="PqRestorePcPresentation" Style="Text"/>). |
| 950 |
<P/> |
| 951 |
|
| 952 |
-<E>Note:</E> For those familiar with the <C>pq</C> program, <C>PqSavePcPresentation</C> |
| 953 |
+<E>Note:</E> For those familiar with the <C>anu-pq</C> program, <C>PqSavePcPresentation</C> |
| 954 |
performs menu item 2 of the main <M>p</M>-Quotient menu. |
| 955 |
</Description> |
| 956 |
</ManSection> |
| 957 |
@@ -1007,7 +1007,7 @@ |
| 958 |
<Func Name="PqRestorePcPresentation" Arg="i, filename"/> |
| 959 |
<Func Name="PqRestorePcPresentation" Arg="filename" Label="for default process"/> |
| 960 |
<Description> |
| 961 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 962 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 963 |
program to restore the pc presentation previously saved to <A>filename</A>, by |
| 964 |
<C>PqSavePcPresentation</C> (see <Ref Func="PqSavePcPresentation" Style="Text"/>). If the first |
| 965 |
character of the string <A>filename</A> is not <C>/</C>, <A>filename</A> is assumed to |
| 966 |
@@ -1016,7 +1016,7 @@ |
| 967 |
<P/> |
| 968 |
|
| 969 |
<E>Note:</E> |
| 970 |
-For those familiar with the <C>pq</C> program, <C>PqRestorePcPresentation</C> |
| 971 |
+For those familiar with the <C>anu-pq</C> program, <C>PqRestorePcPresentation</C> |
| 972 |
performs menu item 3 of the main <M>p</M>-Quotient menu. |
| 973 |
</Description> |
| 974 |
</ManSection> |
| 975 |
@@ -1025,13 +1025,13 @@ |
| 976 |
<Func Name="PqNextClass" Arg="i : [ QueueFactor ]"/> |
| 977 |
<Func Name="PqNextClass" Arg=": [ QueueFactor ]" Label="for default process"/> |
| 978 |
<Description> |
| 979 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 980 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 981 |
program to calculate the next class of <C>ANUPQData.io[<A>i</A>].group</C>. |
| 982 |
<P/> |
| 983 |
|
| 984 |
<Index>option QueueFactor</Index> |
| 985 |
<C>PqNextClass</C> accepts the option <C>QueueFactor</C> (see also <Ref Label="option QueueFactor" Style="Text"/>) which should be a positive integer if automorphisms have |
| 986 |
-been previously supplied. If the <C>pq</C> program requires a queue factor and |
| 987 |
+been previously supplied. If the <C>anu-pq</C> program requires a queue factor and |
| 988 |
none is supplied via the option <C>QueueFactor</C> a default of 15 is taken. |
| 989 |
<P/> |
| 990 |
|
| 991 |
@@ -1052,7 +1052,7 @@ |
| 992 |
its own elimination of redundant generators). |
| 993 |
<P/> |
| 994 |
|
| 995 |
-For those familiar with the <C>pq</C> program, <C>PqNextClass</C> performs menu item |
| 996 |
+For those familiar with the <C>anu-pq</C> program, <C>PqNextClass</C> performs menu item |
| 997 |
6 of the main <M>p</M>-Quotient menu. |
| 998 |
</Description> |
| 999 |
</ManSection> |
| 1000 |
@@ -1061,7 +1061,7 @@ |
| 1001 |
<Func Name="PqComputePCover" Arg="i"/> |
| 1002 |
<Func Name="PqComputePCover" Arg="" Label="for default process"/> |
| 1003 |
<Description> |
| 1004 |
-for the <A>i</A>th or default interactive &ANUPQ; processi, directi, the <C>pq</C> |
| 1005 |
+for the <A>i</A>th or default interactive &ANUPQ; processi, directi, the <C>anu-pq</C> |
| 1006 |
program to compute the <M>p</M>-covering group of <C>ANUPQData.io[<A>i</A>].group</C>. |
| 1007 |
In contrast to the function <C>PqPCover</C> (see <Ref Func="PqPCover" Style="Text"/>), this function does |
| 1008 |
not return a &GAP; pc group. |
| 1009 |
@@ -1079,7 +1079,7 @@ |
| 1010 |
PqEliminateRedundantGenerators(i); |
| 1011 |
]]></Listing> |
| 1012 |
|
| 1013 |
-For those familiar with the <C>pq</C> program, <C>PqComputePCover</C> performs menu |
| 1014 |
+For those familiar with the <C>anu-pq</C> program, <C>PqComputePCover</C> performs menu |
| 1015 |
item 7 of the main <M>p</M>-Quotient menu. |
| 1016 |
</Description> |
| 1017 |
</ManSection> |
| 1018 |
@@ -1092,7 +1092,7 @@ |
| 1019 |
<Func Name="PqCollect" Arg="i, word"/> |
| 1020 |
<Func Name="PqCollect" Arg="word" Label="for default process"/> |
| 1021 |
<Description> |
| 1022 |
-for the <A>i</A>th or default interactive &ANUPQ; process, instruct the <C>pq</C> |
| 1023 |
+for the <A>i</A>th or default interactive &ANUPQ; process, instruct the <C>anu-pq</C> |
| 1024 |
program to do a collection on <A>word</A>, a word in the current pc generators |
| 1025 |
(the form of <A>word</A> required is described below). <C>PqCollect</C> returns the |
| 1026 |
resulting word of the collection as a list of generator number, exponent |
| 1027 |
@@ -1119,7 +1119,7 @@ |
| 1028 |
</Item> |
| 1029 |
</Enum> |
| 1030 |
|
| 1031 |
-<E>Note:</E> For those familiar with the <C>pq</C> program, <C>PqCollect</C> performs |
| 1032 |
+<E>Note:</E> For those familiar with the <C>anu-pq</C> program, <C>PqCollect</C> performs |
| 1033 |
menu item 1 of the Advanced <M>p</M>-Quotient menu. |
| 1034 |
</Description> |
| 1035 |
</ManSection> |
| 1036 |
@@ -1128,14 +1128,14 @@ |
| 1037 |
<Func Name="PqSolveEquation" Arg="i, a, b"/> |
| 1038 |
<Func Name="PqSolveEquation" Arg="a, b" Label="for default process"/> |
| 1039 |
<Description> |
| 1040 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 1041 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 1042 |
program to solve <M><A>a</A> * <A>x</A> = <A>b</A></M> for <A>x</A>, where <A>a</A> and <A>b</A> are words |
| 1043 |
in the pc generators. For the representation of these words see the |
| 1044 |
description of the function <C>PqCollect</C> (<Ref Func="PqCollect" Style="Text"/>). |
| 1045 |
<P/> |
| 1046 |
|
| 1047 |
<E>Note:</E> |
| 1048 |
-For those familiar with the <C>pq</C> program, <C>PqSolveEquation</C> performs |
| 1049 |
+For those familiar with the <C>anu-pq</C> program, <C>PqSolveEquation</C> performs |
| 1050 |
menu item 2 of the Advanced <M>p</M>-Quotient menu. |
| 1051 |
</Description> |
| 1052 |
</ManSection> |
| 1053 |
@@ -1144,7 +1144,7 @@ |
| 1054 |
<Func Name="PqCommutator" Arg="i, words, pow"/> |
| 1055 |
<Func Name="PqCommutator" Arg="words, pow" Label="for default process"/> |
| 1056 |
<Description> |
| 1057 |
-for the <A>i</A>th or default interactive &ANUPQ; process, instruct the <C>pq</C> |
| 1058 |
+for the <A>i</A>th or default interactive &ANUPQ; process, instruct the <C>anu-pq</C> |
| 1059 |
program to compute the left normed commutator of the list <A>words</A> of |
| 1060 |
words in the current pc generators raised to the integer power <A>pow</A>, and |
| 1061 |
return the resulting word as a list of generator number, exponent pairs. |
| 1062 |
@@ -1154,7 +1154,7 @@ |
| 1063 |
<P/> |
| 1064 |
|
| 1065 |
<E>Note:</E> |
| 1066 |
-For those familiar with the <C>pq</C> program, <C>PqCommutator</C> performs menu |
| 1067 |
+For those familiar with the <C>anu-pq</C> program, <C>PqCommutator</C> performs menu |
| 1068 |
item 3 of the Advanced <M>p</M>-Quotient menu. |
| 1069 |
</Description> |
| 1070 |
</ManSection> |
| 1071 |
@@ -1163,14 +1163,14 @@ |
| 1072 |
<Func Name="PqSetupTablesForNextClass" Arg="i"/> |
| 1073 |
<Func Name="PqSetupTablesForNextClass" Arg="" Label="for default process"/> |
| 1074 |
<Description> |
| 1075 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 1076 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 1077 |
program to set up tables for the next class. As as side-effect, |
| 1078 |
after <C>PqSetupTablesForNextClass(<A>i</A>)</C> the value returned by |
| 1079 |
<C>PqPClass(<A>i</A>)</C> will be one more than it was previously. |
| 1080 |
<P/> |
| 1081 |
|
| 1082 |
<E>Note:</E> |
| 1083 |
-For those familiar with the <C>pq</C> program, <C>PqSetupTablesForNextClass</C> |
| 1084 |
+For those familiar with the <C>anu-pq</C> program, <C>PqSetupTablesForNextClass</C> |
| 1085 |
performs menu item 6 of the Advanced <M>p</M>-Quotient menu. |
| 1086 |
</Description> |
| 1087 |
</ManSection> |
| 1088 |
@@ -1179,7 +1179,7 @@ |
| 1089 |
<Func Name="PqTails" Arg="i, weight"/> |
| 1090 |
<Func Name="PqTails" Arg="weight" Label="for default process"/> |
| 1091 |
<Description> |
| 1092 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 1093 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 1094 |
program to compute and add tails of weight <A>weight</A> if <A>weight</A> is in the |
| 1095 |
integer range <C>[2 .. PqPClass(<A>i</A>)]</C> (assuming <A>i</A> is the number of the |
| 1096 |
process, even in the default case) or for all weights if <C><A>weight</A> = 0</C>. |
| 1097 |
@@ -1209,7 +1209,7 @@ |
| 1098 |
PqAddTails(i, weight); |
| 1099 |
]]></Listing> |
| 1100 |
|
| 1101 |
-For those familiar with the <C>pq</C> program, <C>PqTails</C> uses menu item 7 of |
| 1102 |
+For those familiar with the <C>anu-pq</C> program, <C>PqTails</C> uses menu item 7 of |
| 1103 |
the Advanced <M>p</M>-Quotient menu. |
| 1104 |
</Description> |
| 1105 |
</ManSection> |
| 1106 |
@@ -1218,7 +1218,7 @@ |
| 1107 |
<Func Name="PqComputeTails" Arg="i, weight"/> |
| 1108 |
<Func Name="PqComputeTails" Arg="weight" Label="for default process"/> |
| 1109 |
<Description> |
| 1110 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 1111 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 1112 |
program to compute tails of weight <A>weight</A> if <A>weight</A> is in the integer |
| 1113 |
range <C>[2 .. PqPClass(<A>i</A>)]</C> (assuming <A>i</A> is the number of the process, |
| 1114 |
even in the default case) or for all weights if <C><A>weight</A> = 0</C>. See |
| 1115 |
@@ -1226,7 +1226,7 @@ |
| 1116 |
<P/> |
| 1117 |
|
| 1118 |
<E>Note:</E> |
| 1119 |
-For those familiar with the <C>pq</C> program, <C>PqComputeTails</C> uses menu item |
| 1120 |
+For those familiar with the <C>anu-pq</C> program, <C>PqComputeTails</C> uses menu item |
| 1121 |
7 of the Advanced <M>p</M>-Quotient menu. |
| 1122 |
</Description> |
| 1123 |
</ManSection> |
| 1124 |
@@ -1235,7 +1235,7 @@ |
| 1125 |
<Func Name="PqAddTails" Arg="i, weight"/> |
| 1126 |
<Func Name="PqAddTails" Arg="weight" Label="for default process"/> |
| 1127 |
<Description> |
| 1128 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 1129 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 1130 |
program to add the tails of weight <A>weight</A>, previously computed by |
| 1131 |
<C>PqComputeTails</C> (see <Ref Func="PqComputeTails" Style="Text"/>), if <A>weight</A> is in the integer |
| 1132 |
range <C>[2 .. PqPClass(<A>i</A>)]</C> (assuming <A>i</A> is the number of the process, |
| 1133 |
@@ -1244,7 +1244,7 @@ |
| 1134 |
<P/> |
| 1135 |
|
| 1136 |
<E>Note:</E> |
| 1137 |
-For those familiar with the <C>pq</C> program, <C>PqAddTails</C> uses menu item 7 of |
| 1138 |
+For those familiar with the <C>anu-pq</C> program, <C>PqAddTails</C> uses menu item 7 of |
| 1139 |
the Advanced <M>p</M>-Quotient menu. |
| 1140 |
</Description> |
| 1141 |
</ManSection> |
| 1142 |
@@ -1298,7 +1298,7 @@ |
| 1143 |
been added (see <Ref Func="PqTails" Style="Text"/>). |
| 1144 |
<P/> |
| 1145 |
|
| 1146 |
-For those familiar with the <C>pq</C> program, <C>PqDoConsistencyChecks</C> performs |
| 1147 |
+For those familiar with the <C>anu-pq</C> program, <C>PqDoConsistencyChecks</C> performs |
| 1148 |
menu item 8 of the Advanced <M>p</M>-Quotient menu. |
| 1149 |
</Description> |
| 1150 |
</ManSection> |
| 1151 |
@@ -1307,7 +1307,7 @@ |
| 1152 |
<Func Name="PqCollectDefiningRelations" Arg="i"/> |
| 1153 |
<Func Name="PqCollectDefiningRelations" Arg="" Label="for default process"/> |
| 1154 |
<Description> |
| 1155 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 1156 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 1157 |
program to collect the images of the defining relations of the original fp |
| 1158 |
group of the process, with respect to the current pc presentation, in the |
| 1159 |
context of finding the next class (see <Ref Func="PqNextClass" Style="Text"/>). If the tails |
| 1160 |
@@ -1316,7 +1316,7 @@ |
| 1161 |
<P/> |
| 1162 |
|
| 1163 |
<E>Note:</E> |
| 1164 |
-For those familiar with the <C>pq</C> program, <C>PqCollectDefiningRelations</C> |
| 1165 |
+For those familiar with the <C>anu-pq</C> program, <C>PqCollectDefiningRelations</C> |
| 1166 |
performs menu item 9 of the Advanced <M>p</M>-Quotient menu. |
| 1167 |
</Description> |
| 1168 |
</ManSection> |
| 1169 |
@@ -1338,7 +1338,7 @@ |
| 1170 |
<P/> |
| 1171 |
|
| 1172 |
<E>Note:</E> |
| 1173 |
-For those familiar with the <C>pq</C> program, <C>PqCollectDefiningGenerators</C> |
| 1174 |
+For those familiar with the <C>anu-pq</C> program, <C>PqCollectDefiningGenerators</C> |
| 1175 |
performs menu item 23 of the Advanced <M>p</M>-Quotient menu. |
| 1176 |
</Description> |
| 1177 |
</ManSection> |
| 1178 |
@@ -1358,7 +1358,7 @@ |
| 1179 |
<P/> |
| 1180 |
|
| 1181 |
<E>Note</E> |
| 1182 |
-For those familiar with the <C>pq</C> program, <C>PqCommutatorDefiningGenerators</C> |
| 1183 |
+For those familiar with the <C>anu-pq</C> program, <C>PqCommutatorDefiningGenerators</C> |
| 1184 |
performs menu item 24 of the Advanced <M>p</M>-Quotient menu. |
| 1185 |
</Description> |
| 1186 |
</ManSection> |
| 1187 |
@@ -1367,7 +1367,7 @@ |
| 1188 |
<Func Name="PqDoExponentChecks" Arg="i : [ Bounds := list ]"/> |
| 1189 |
<Func Name="PqDoExponentChecks" Arg=": [ Bounds := list ]" Label="for default process"/> |
| 1190 |
<Description> |
| 1191 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 1192 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 1193 |
program to do exponent checks for weights (inclusively) between the bounds |
| 1194 |
of <C>Bounds</C> or for all weights if <C>Bounds</C> is not given. The value <A>list</A> |
| 1195 |
of <C>Bounds</C> (assuming the interactive process is numbered <A>i</A>) should be a |
| 1196 |
@@ -1379,7 +1379,7 @@ |
| 1197 |
<P/> |
| 1198 |
|
| 1199 |
<E>Note:</E> |
| 1200 |
-For those familiar with the <C>pq</C> program, <C>PqDoExponentChecks</C> performs |
| 1201 |
+For those familiar with the <C>anu-pq</C> program, <C>PqDoExponentChecks</C> performs |
| 1202 |
menu item 10 of the Advanced <M>p</M>-Quotient menu. |
| 1203 |
</Description> |
| 1204 |
</ManSection> |
| 1205 |
@@ -1388,12 +1388,12 @@ |
| 1206 |
<Func Name="PqEliminateRedundantGenerators" Arg="i"/> |
| 1207 |
<Func Name="PqEliminateRedundantGenerators" Arg="" Label="for default process"/> |
| 1208 |
<Description> |
| 1209 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 1210 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 1211 |
program to eliminate redundant generators of the current <M>p</M>-quotient. |
| 1212 |
<P/> |
| 1213 |
|
| 1214 |
<E>Note:</E> |
| 1215 |
-For those familiar with the <C>pq</C> program, <C>PqEliminateRedundantGenerators</C> |
| 1216 |
+For those familiar with the <C>anu-pq</C> program, <C>PqEliminateRedundantGenerators</C> |
| 1217 |
performs menu item 11 of the Advanced <M>p</M>-Quotient menu. |
| 1218 |
</Description> |
| 1219 |
</ManSection> |
| 1220 |
@@ -1402,12 +1402,12 @@ |
| 1221 |
<Func Name="PqRevertToPreviousClass" Arg="i"/> |
| 1222 |
<Func Name="PqRevertToPreviousClass" Arg="" Label="for default process"/> |
| 1223 |
<Description> |
| 1224 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 1225 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 1226 |
program to abandon the current class and revert to the previous class. |
| 1227 |
<P/> |
| 1228 |
|
| 1229 |
<E>Note:</E> |
| 1230 |
-For those familiar with the <C>pq</C> program, <C>PqRevertToPreviousClass</C> |
| 1231 |
+For those familiar with the <C>anu-pq</C> program, <C>PqRevertToPreviousClass</C> |
| 1232 |
performs menu item 12 of the Advanced <M>p</M>-Quotient menu. |
| 1233 |
</Description> |
| 1234 |
</ManSection> |
| 1235 |
@@ -1416,7 +1416,7 @@ |
| 1236 |
<Func Name="PqSetMaximalOccurrences" Arg="i, noccur"/> |
| 1237 |
<Func Name="PqSetMaximalOccurrences" Arg="noccur" Label="for default process"/> |
| 1238 |
<Description> |
| 1239 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 1240 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 1241 |
program to set maximal occurrences of the weight 1 generators in the |
| 1242 |
definitions of pcp generators of the group of the process. This can be |
| 1243 |
used to avoid the definition of generators of which one knows for |
| 1244 |
@@ -1431,7 +1431,7 @@ |
| 1245 |
<P/> |
| 1246 |
|
| 1247 |
<E>Note:</E> |
| 1248 |
-For those familiar with the <C>pq</C> program, <C>PqSetMaximalOccurrences</C> |
| 1249 |
+For those familiar with the <C>anu-pq</C> program, <C>PqSetMaximalOccurrences</C> |
| 1250 |
performs menu item 13 of the Advanced <M>p</M>-Quotient menu. |
| 1251 |
</Description> |
| 1252 |
</ManSection> |
| 1253 |
@@ -1440,12 +1440,12 @@ |
| 1254 |
<Func Name="PqSetMetabelian" Arg="i"/> |
| 1255 |
<Func Name="PqSetMetabelian" Arg="" Label="for default process"/> |
| 1256 |
<Description> |
| 1257 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 1258 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 1259 |
program to enforce metabelian-ness. |
| 1260 |
<P/> |
| 1261 |
|
| 1262 |
<E>Note:</E> |
| 1263 |
-For those familiar with the <C>pq</C> program, <C>PqSetMetabelian</C> performs |
| 1264 |
+For those familiar with the <C>anu-pq</C> program, <C>PqSetMetabelian</C> performs |
| 1265 |
menu item 14 of the Advanced <M>p</M>-Quotient menu. |
| 1266 |
</Description> |
| 1267 |
</ManSection> |
| 1268 |
@@ -1456,7 +1456,7 @@ |
| 1269 |
<Func Name="PqJacobi" Arg="i, c, b, a"/> |
| 1270 |
<Func Name="PqJacobi" Arg="c, b, a" Label="for default process"/> |
| 1271 |
<Description> |
| 1272 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 1273 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 1274 |
program to do the consistency check for the pc generators with indices |
| 1275 |
<A>c</A>, <A>b</A>, <A>a</A> which should be non-increasing positive integers, i.e. <M><A>c</A> |
| 1276 |
\ge <A>b</A> \ge <A>a</A></M>. |
| 1277 |
@@ -1499,7 +1499,7 @@ |
| 1278 |
<P/> |
| 1279 |
|
| 1280 |
<E>Note:</E> |
| 1281 |
-For those familiar with the <C>pq</C> program, <C>PqDoConsistencyCheck</C> and |
| 1282 |
+For those familiar with the <C>anu-pq</C> program, <C>PqDoConsistencyCheck</C> and |
| 1283 |
<C>PqJacobi</C> perform menu item 15 of the Advanced <M>p</M>-Quotient menu. |
| 1284 |
</Description> |
| 1285 |
</ManSection> |
| 1286 |
@@ -1508,13 +1508,13 @@ |
| 1287 |
<Func Name="PqCompact" Arg="i"/> |
| 1288 |
<Func Name="PqCompact" Arg="" Label="for default process"/> |
| 1289 |
<Description> |
| 1290 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 1291 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 1292 |
program to do a compaction of its work space. This function is safe to |
| 1293 |
perform only at certain points in time. |
| 1294 |
<P/> |
| 1295 |
|
| 1296 |
<E>Note:</E> |
| 1297 |
-For those familiar with the <C>pq</C> program, <C>PqCompact</C> performs menu item |
| 1298 |
+For those familiar with the <C>anu-pq</C> program, <C>PqCompact</C> performs menu item |
| 1299 |
16 of the Advanced <M>p</M>-Quotient menu. |
| 1300 |
</Description> |
| 1301 |
</ManSection> |
| 1302 |
@@ -1523,7 +1523,7 @@ |
| 1303 |
<Func Name="PqEchelonise" Arg="i"/> |
| 1304 |
<Func Name="PqEchelonise" Arg="" Label="for default process"/> |
| 1305 |
<Description> |
| 1306 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 1307 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 1308 |
program to echelonise the word most recently collected by <C>PqCollect</C> or |
| 1309 |
<C>PqCommutator</C> against the relations of the current pc presentation, and |
| 1310 |
return the number of the generator made redundant or <K>fail</K> if no |
| 1311 |
@@ -1533,7 +1533,7 @@ |
| 1312 |
<P/> |
| 1313 |
|
| 1314 |
<E>Note:</E> |
| 1315 |
-For those familiar with the <C>pq</C> program, <C>PqEchelonise</C> performs menu |
| 1316 |
+For those familiar with the <C>anu-pq</C> program, <C>PqEchelonise</C> performs menu |
| 1317 |
item 17 of the Advanced <M>p</M>-Quotient menu. |
| 1318 |
</Description> |
| 1319 |
</ManSection> |
| 1320 |
@@ -1559,7 +1559,7 @@ |
| 1321 |
</List> |
| 1322 |
|
| 1323 |
<E>Note:</E> |
| 1324 |
-For those familiar with the <C>pq</C> program, <C>PqSupplyAutomorphisms</C> uses |
| 1325 |
+For those familiar with the <C>anu-pq</C> program, <C>PqSupplyAutomorphisms</C> uses |
| 1326 |
menu item 18 of the Advanced <M>p</M>-Quotient menu. |
| 1327 |
</Description> |
| 1328 |
</ManSection> |
| 1329 |
@@ -1568,13 +1568,13 @@ |
| 1330 |
<Func Name="PqExtendAutomorphisms" Arg="i"/> |
| 1331 |
<Func Name="PqExtendAutomorphisms" Arg="" Label="for default process"/> |
| 1332 |
<Description> |
| 1333 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 1334 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 1335 |
program to extend automorphisms of the <M>p</M>-quotient of the previous class |
| 1336 |
to the <M>p</M>-quotient of the present class. |
| 1337 |
<P/> |
| 1338 |
|
| 1339 |
<E>Note:</E> |
| 1340 |
-For those familiar with the <C>pq</C> program, <C>PqExtendAutomorphisms</C> uses |
| 1341 |
+For those familiar with the <C>anu-pq</C> program, <C>PqExtendAutomorphisms</C> uses |
| 1342 |
menu item 18 of the Advanced <M>p</M>-Quotient menu. |
| 1343 |
</Description> |
| 1344 |
</ManSection> |
| 1345 |
@@ -1583,12 +1583,12 @@ |
| 1346 |
<Func Name="PqApplyAutomorphisms" Arg="i, qfac"/> |
| 1347 |
<Func Name="PqApplyAutomorphisms" Arg="qfac" Label="for default process"/> |
| 1348 |
<Description> |
| 1349 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 1350 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 1351 |
program to apply automorphisms; <A>qfac</A> is the queue factor e.g. <C>15</C>. |
| 1352 |
<P/> |
| 1353 |
|
| 1354 |
<E>Note:</E> |
| 1355 |
-For those familiar with the <C>pq</C> program, <C>PqCloseRelations</C> performs |
| 1356 |
+For those familiar with the <C>anu-pq</C> program, <C>PqCloseRelations</C> performs |
| 1357 |
menu item 19 of the Advanced <M>p</M>-Quotient menu. |
| 1358 |
</Description> |
| 1359 |
</ManSection> |
| 1360 |
@@ -1597,7 +1597,7 @@ |
| 1361 |
<Func Name="PqDisplayStructure" Arg="i : [ Bounds := list ]"/> |
| 1362 |
<Func Name="PqDisplayStructure" Arg=": [ Bounds := list ]" Label="for default process"/> |
| 1363 |
<Description> |
| 1364 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 1365 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 1366 |
program to display the structure for the pcp generators numbered |
| 1367 |
(inclusively) between the bounds of <C>Bounds</C> or for all generators if |
| 1368 |
<C>Bounds</C> is not given. The value <A>list</A> of <C>Bounds</C> (assuming the |
| 1369 |
@@ -1676,7 +1676,7 @@ |
| 1370 |
</List> |
| 1371 |
|
| 1372 |
<E>Note:</E> |
| 1373 |
-For those familiar with the <C>pq</C> program, <C>PqDisplayStructure</C> performs |
| 1374 |
+For those familiar with the <C>anu-pq</C> program, <C>PqDisplayStructure</C> performs |
| 1375 |
menu item 20 of the Advanced <M>p</M>-Quotient menu. |
| 1376 |
</Description> |
| 1377 |
</ManSection> |
| 1378 |
@@ -1685,7 +1685,7 @@ |
| 1379 |
<Func Name="PqDisplayAutomorphisms" Arg="i : [ Bounds := list ]"/> |
| 1380 |
<Func Name="PqDisplayAutomorphisms" Arg=": [ Bounds := list ]" Label="for default process"/> |
| 1381 |
<Description> |
| 1382 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 1383 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 1384 |
program to display the automorphism actions on the pcp generators numbered |
| 1385 |
(inclusively) between the bounds of <C>Bounds</C> or for all generators if |
| 1386 |
<C>Bounds</C> is not given. The value <A>list</A> of <C>Bounds</C> (assuming the |
| 1387 |
@@ -1697,7 +1697,7 @@ |
| 1388 |
<P/> |
| 1389 |
|
| 1390 |
<E>Note:</E> |
| 1391 |
-For those familiar with the <C>pq</C> program, <C>PqDisplayAutomorphisms</C> |
| 1392 |
+For those familiar with the <C>anu-pq</C> program, <C>PqDisplayAutomorphisms</C> |
| 1393 |
performs menu item 21 of the Advanced <M>p</M>-Quotient menu. |
| 1394 |
</Description> |
| 1395 |
</ManSection> |
| 1396 |
@@ -1706,7 +1706,7 @@ |
| 1397 |
<Func Name="PqWritePcPresentation" Arg="i, filename"/> |
| 1398 |
<Func Name="PqWritePcPresentation" Arg="filename" Label="for default process"/> |
| 1399 |
<Description> |
| 1400 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 1401 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 1402 |
program to write a pc presentation of a previously-computed quotient of |
| 1403 |
the group of that process, to the file with name <A>filename</A>. Here the |
| 1404 |
group of a process is the one given as first argument when <C>PqStart</C> was |
| 1405 |
@@ -1714,12 +1714,12 @@ |
| 1406 |
<C>ANUPQData.io[<A>i</A>].group</C>). If the first character of the string |
| 1407 |
<A>filename</A> is not <C>/</C>, <A>filename</A> is assumed to be the path of a writable |
| 1408 |
file relative to the directory in which &GAP; was started. If a pc |
| 1409 |
-presentation has not been previously computed by the <C>pq</C> program, then |
| 1410 |
-<C>pq</C> is called to compute it first, effectively invoking |
| 1411 |
+presentation has not been previously computed by the <C>anu-pq</C> program, then |
| 1412 |
+<C>anu-pq</C> is called to compute it first, effectively invoking |
| 1413 |
<C>PqPcPresentation</C> (see <Ref Func="PqPcPresentation" Style="Text"/>). |
| 1414 |
<P/> |
| 1415 |
|
| 1416 |
-<E>Note:</E> For those familiar with the <C>pq</C> program, <C>PqPcWritePresentation</C> |
| 1417 |
+<E>Note:</E> For those familiar with the <C>anu-pq</C> program, <C>PqPcWritePresentation</C> |
| 1418 |
performs menu item 25 of the Advanced <M>p</M>-Quotient menu. |
| 1419 |
<P/> |
| 1420 |
|
| 1421 |
@@ -1727,7 +1727,7 @@ |
| 1422 |
<!-- %\>PqWriteCompactDescription( <A>i</A> ) F --> |
| 1423 |
<!-- %\>PqWriteCompactDescription() F --> |
| 1424 |
<!-- % --> |
| 1425 |
-<!-- %for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> --> |
| 1426 |
+<!-- %for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> --> |
| 1427 |
<!-- %program to write a compact description --> |
| 1428 |
<!-- % --> |
| 1429 |
<!-- %<E>OF ....</E> --> |
| 1430 |
@@ -1735,7 +1735,7 @@ |
| 1431 |
<!-- %to a file. --> |
| 1432 |
<!-- % --> |
| 1433 |
<!-- %<E>Note:</E> --> |
| 1434 |
-<!-- %For those familiar with the <C>pq</C> program, <C>PqWriteCompactDescription</C> --> |
| 1435 |
+<!-- %For those familiar with the <C>anu-pq</C> program, <C>PqWriteCompactDescription</C> --> |
| 1436 |
<!-- %performs menu item 26 of the Advanced <M>p</M>-Quotient menu. --> |
| 1437 |
</Description> |
| 1438 |
</ManSection> |
| 1439 |
@@ -1748,7 +1748,7 @@ |
| 1440 |
<Func Name="PqSPComputePcpAndPCover" Arg="i : options"/> |
| 1441 |
<Func Name="PqSPComputePcpAndPCover" Arg=": options" Label="for default process"/> |
| 1442 |
<Description> |
| 1443 |
-for the <A>i</A>th or default interactive &ANUPQ; process, directs the <C>pq</C> |
| 1444 |
+for the <A>i</A>th or default interactive &ANUPQ; process, directs the <C>anu-pq</C> |
| 1445 |
program to compute for the group of that process a pc presentation up to |
| 1446 |
the <M>p</M>-quotient of maximum class or the value of the option <C>ClassBound</C> |
| 1447 |
and the <M>p</M>-cover of that quotient, and sets up tabular information |
| 1448 |
@@ -1766,7 +1766,7 @@ |
| 1449 |
<P/> |
| 1450 |
|
| 1451 |
<E>Note:</E> |
| 1452 |
-For those familiar with the <C>pq</C> program, <C>PqSPComputePcpAndPCover</C> |
| 1453 |
+For those familiar with the <C>anu-pq</C> program, <C>PqSPComputePcpAndPCover</C> |
| 1454 |
performs option 1 of the Standard Presentation menu. |
| 1455 |
</Description> |
| 1456 |
</ManSection> |
| 1457 |
@@ -1811,7 +1811,7 @@ |
| 1458 |
Detailed descriptions of the above options may be found in Chapter <Ref Chap="ANUPQ Options" Style="Text"/>. |
| 1459 |
<P/> |
| 1460 |
|
| 1461 |
-<E>Note:</E> For those familiar with the <C>pq</C> program, <C>PqSPPcPresentation</C> |
| 1462 |
+<E>Note:</E> For those familiar with the <C>anu-pq</C> program, <C>PqSPPcPresentation</C> |
| 1463 |
performs menu item 2 of the Standard Presentation menu. |
| 1464 |
</Description> |
| 1465 |
</ManSection> |
| 1466 |
@@ -1820,7 +1820,7 @@ |
| 1467 |
<Func Name="PqSPSavePresentation" Arg="i, filename"/> |
| 1468 |
<Func Name="PqSPSavePresentation" Arg="filename" Label="for default process"/> |
| 1469 |
<Description> |
| 1470 |
-for the <A>i</A>th or default interactive &ANUPQ; process, directs the <C>pq</C> |
| 1471 |
+for the <A>i</A>th or default interactive &ANUPQ; process, directs the <C>anu-pq</C> |
| 1472 |
program to save the standard presentation previously computed for the |
| 1473 |
group of that process to the file with name <A>filename</A>, where the group |
| 1474 |
of a process is the one given as first argument when <C>PqStart</C> was called |
| 1475 |
@@ -1829,7 +1829,7 @@ |
| 1476 |
relative to the directory in which &GAP; was started. |
| 1477 |
<P/> |
| 1478 |
|
| 1479 |
-<E>Note:</E> For those familiar with the <C>pq</C> program, <C>PqSPSavePresentation</C> |
| 1480 |
+<E>Note:</E> For those familiar with the <C>anu-pq</C> program, <C>PqSPSavePresentation</C> |
| 1481 |
performs menu item 3 of the Standard Presentation menu. |
| 1482 |
</Description> |
| 1483 |
</ManSection> |
| 1484 |
@@ -1838,7 +1838,7 @@ |
| 1485 |
<Func Name="PqSPCompareTwoFilePresentations" Arg="i, f1, f2"/> |
| 1486 |
<Func Name="PqSPCompareTwoFilePresentations" Arg="f1, f2" Label="for default process"/> |
| 1487 |
<Description> |
| 1488 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 1489 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 1490 |
program to compare the presentations in the files with names <A>f1</A> and <A>f2</A> |
| 1491 |
and returns <K>true</K> if they are identical and <K>false</K> otherwise. For each |
| 1492 |
of the strings <A>f1</A> and <A>f2</A>, if the first character is not a <C>/</C> then it |
| 1493 |
@@ -1850,14 +1850,14 @@ |
| 1494 |
<P/> |
| 1495 |
|
| 1496 |
The presentations in files <A>f1</A> and <A>f2</A> must have been generated by the |
| 1497 |
-<C>pq</C> program but they do <E>not</E> need to be <E>standard</E> presentations. If If |
| 1498 |
+<C>anu-pq</C> program but they do <E>not</E> need to be <E>standard</E> presentations. If If |
| 1499 |
the presentations in files <A>f1</A> and <A>f2</A> <E>have</E> been generated by |
| 1500 |
<C>PqSPStandardPresentation</C> (see <Ref Func="PqSPStandardPresentation" Style="Text"/>) then a |
| 1501 |
<K>false</K> response from <C>PqSPCompareTwoFilePresentations</C> says the groups |
| 1502 |
defined by those presentations are <E>not</E> isomorphic. |
| 1503 |
<P/> |
| 1504 |
|
| 1505 |
-For those familiar with the <C>pq</C> program, |
| 1506 |
+For those familiar with the <C>anu-pq</C> program, |
| 1507 |
<C>PqSPCompareTwoFilePresentations</C> performs menu item 6 of the Standard |
| 1508 |
Presentation menu. |
| 1509 |
</Description> |
| 1510 |
@@ -1867,7 +1867,7 @@ |
| 1511 |
<Func Name="PqSPIsomorphism" Arg="i"/> |
| 1512 |
<Func Name="PqSPIsomorphism" Arg="" Label="for default process"/> |
| 1513 |
<Description> |
| 1514 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 1515 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 1516 |
program to compute the isomorphism mapping from the <M>p</M>-group of the |
| 1517 |
process to its standard presentation. This function provides a |
| 1518 |
description only; for a &GAP; object, use |
| 1519 |
@@ -1875,7 +1875,7 @@ |
| 1520 |
(see <Ref Func="EpimorphismStandardPresentation" Label="interactive" Style="Text"/>). |
| 1521 |
<P/> |
| 1522 |
|
| 1523 |
-<E>Note:</E> For those familiar with the <C>pq</C> program, <C>PqSPIsomorphism</C> |
| 1524 |
+<E>Note:</E> For those familiar with the <C>anu-pq</C> program, <C>PqSPIsomorphism</C> |
| 1525 |
performs menu item 8 of the Standard Presentation menu. |
| 1526 |
</Description> |
| 1527 |
</ManSection> |
| 1528 |
@@ -1885,14 +1885,14 @@ |
| 1529 |
<Section><Heading>Commands from the Main <M>p</M>-Group Generation menu</Heading> |
| 1530 |
|
| 1531 |
Note that the <M>p</M>-group generation commands can only be applied once the |
| 1532 |
-<C>pq</C> program has produced a pc presentation of some quotient group of the |
| 1533 |
+<C>anu-pq</C> program has produced a pc presentation of some quotient group of the |
| 1534 |
<Q>group of the process</Q>. |
| 1535 |
|
| 1536 |
<ManSection> |
| 1537 |
<Func Name="PqPGSupplyAutomorphisms" Arg="i[, mlist] : options"/> |
| 1538 |
<Func Name="PqPGSupplyAutomorphisms" Arg="[mlist] : options" Label="for default process"/> |
| 1539 |
<Description> |
| 1540 |
-for the <A>i</A>th or default interactive &ANUPQ; process, supply the <C>pq</C> |
| 1541 |
+for the <A>i</A>th or default interactive &ANUPQ; process, supply the <C>anu-pq</C> |
| 1542 |
program with the automorphism group data needed for the current quotient |
| 1543 |
of the group of that process (for process <A>i</A> the group is stored as |
| 1544 |
<C>ANUPQData.io[<A>i</A>].group</C>). For a description of the format of <A>mlist</A> |
| 1545 |
@@ -1906,7 +1906,7 @@ |
| 1546 |
<P/> |
| 1547 |
|
| 1548 |
<E>Note:</E> |
| 1549 |
-For those familiar with the <C>pq</C> program, <C>PqPGSupplyAutomorphisms</C> |
| 1550 |
+For those familiar with the <C>anu-pq</C> program, <C>PqPGSupplyAutomorphisms</C> |
| 1551 |
performs menu item 1 of the main <M>p</M>-Group Generation menu. |
| 1552 |
</Description> |
| 1553 |
</ManSection> |
| 1554 |
@@ -1915,15 +1915,15 @@ |
| 1555 |
<Func Name="PqPGExtendAutomorphisms" Arg="i"/> |
| 1556 |
<Func Name="PqPGExtendAutomorphisms" Arg="" Label="for default process"/> |
| 1557 |
<Description> |
| 1558 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 1559 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 1560 |
program to compute the extensions of the automorphisms of the |
| 1561 |
<M>p</M>-quotient of the previous class to the <M>p</M>-quotient of the current |
| 1562 |
class. You may wish to set the <C>InfoLevel</C> of <C>InfoANUPQ</C> to 2 (or more) |
| 1563 |
-in order to see the output from the <C>pq</C> program (see <Ref Func="InfoANUPQ" Style="Text"/>). |
| 1564 |
+in order to see the output from the <C>anu-pq</C> program (see <Ref Func="InfoANUPQ" Style="Text"/>). |
| 1565 |
<P/> |
| 1566 |
|
| 1567 |
<E>Note:</E> |
| 1568 |
-For those familiar with the <C>pq</C> program, <C>PqPGExtendAutomorphisms</C> |
| 1569 |
+For those familiar with the <C>anu-pq</C> program, <C>PqPGExtendAutomorphisms</C> |
| 1570 |
performs menu item 2 of the main or advanced <M>p</M>-Group Generation menu. |
| 1571 |
</Description> |
| 1572 |
</ManSection> |
| 1573 |
@@ -1932,7 +1932,7 @@ |
| 1574 |
<Func Name="PqPGConstructDescendants" Arg="i : options"/> |
| 1575 |
<Func Name="PqPGConstructDescendants" Arg=": options" Label="for default process"/> |
| 1576 |
<Description> |
| 1577 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 1578 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 1579 |
program to construct descendants prescribed by <A>options</A>, and return the |
| 1580 |
number of descendants constructed (compare function <Ref Func="PqDescendants" Style="Text"/> which |
| 1581 |
returns the list of descendants). The options possible are <C>ClassBound</C>, |
| 1582 |
@@ -1943,13 +1943,13 @@ |
| 1583 |
in Chapter <Ref Chap="ANUPQ Options" Style="Text"/>.) |
| 1584 |
<P/> |
| 1585 |
|
| 1586 |
-<C>PqPGConstructDescendants</C> requires that the <C>pq</C> program has previously |
| 1587 |
+<C>PqPGConstructDescendants</C> requires that the <C>anu-pq</C> program has previously |
| 1588 |
computed a pc presentation and a <M>p</M>-cover for a <M>p</M>-quotient of some |
| 1589 |
class of the group of the process. |
| 1590 |
<P/> |
| 1591 |
|
| 1592 |
<E>Note:</E> |
| 1593 |
-For those familiar with the <C>pq</C> program, <C>PqPGConstructDescendants</C> |
| 1594 |
+For those familiar with the <C>anu-pq</C> program, <C>PqPGConstructDescendants</C> |
| 1595 |
performs menu item 5 of the main <M>p</M>-Group Generation menu. |
| 1596 |
</Description> |
| 1597 |
</ManSection> |
| 1598 |
@@ -1964,7 +1964,7 @@ |
| 1599 |
<Func Name="PqPGRestoreDescendantFromFile" Arg="i : [ Filename := name ]"/> |
| 1600 |
<Func Name="PqPGRestoreDescendantFromFile" Arg=": [ Filename := name ]" Label="for default process"/> |
| 1601 |
<Description> |
| 1602 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 1603 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 1604 |
program to restore group <A>n</A> of class <A>cls</A> from a temporary file, where |
| 1605 |
<A>cls</A> and <A>n</A> are positive integers, or the group stored in <A>name</A>. |
| 1606 |
<C>PqPGSetDescendantToPcp</C> and <C>PqPGRestoreDescendantFromFile</C> are |
| 1607 |
@@ -1973,20 +1973,20 @@ |
| 1608 |
(see <Ref Func="PqPGConstructDescendants" Style="Text"/>) or the interactive <C>PqDescendants</C> |
| 1609 |
(see <Ref Func="PqDescendants" Label="interactive" Style="Text"/>). In the <C>Filename</C> option forms, the |
| 1610 |
option defaults to the last filename in which a presentation was stored |
| 1611 |
-by the <C>pq</C> program. |
| 1612 |
+by the <C>anu-pq</C> program. |
| 1613 |
<P/> |
| 1614 |
|
| 1615 |
<E>Notes</E> |
| 1616 |
<P/> |
| 1617 |
|
| 1618 |
Since the <C>PqPGSetDescendantToPcp</C> and <C>PqPGRestoreDescendantFromFile</C> |
| 1619 |
-are intended to be used in calculation of further descendants the <C>pq</C> |
| 1620 |
+are intended to be used in calculation of further descendants the <C>anu-pq</C> |
| 1621 |
program computes the <M>p</M>-cover of the restored descendant. Hence, |
| 1622 |
<C>PqCurrentGroup</C> used immediately after one of these commands returns the |
| 1623 |
<M>p</M>-cover of the restored descendant rather than the descendant itself. |
| 1624 |
<P/> |
| 1625 |
|
| 1626 |
-For those familiar with the <C>pq</C> program, <C>PqPGSetDescendantToPcp</C> and |
| 1627 |
+For those familiar with the <C>anu-pq</C> program, <C>PqPGSetDescendantToPcp</C> and |
| 1628 |
<C>PqPGRestoreDescendantFromFile</C> perform menu item 3 of the main or |
| 1629 |
advanced <M>p</M>-Group Generation menu. |
| 1630 |
</Description> |
| 1631 |
@@ -2012,17 +2012,17 @@ |
| 1632 |
<Func Name="PqAPGDegree" Arg="i, step, rank : [ Exponent := n ]"/> |
| 1633 |
<Func Name="PqAPGDegree" Arg="step, rank : [ Exponent := n ]" Label="for default process"/> |
| 1634 |
<Description> |
| 1635 |
-<!-- %for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> --> |
| 1636 |
+<!-- %for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> --> |
| 1637 |
<!-- %program to compute definition sets and return the degree of the --> |
| 1638 |
<!-- %permutation group. Here the step-size <A>step</A> and the rank <A>rank</A> of the --> |
| 1639 |
<!-- %initial segment subgroup are positive integers. See <Ref Label="option Exponent" Style="Text"/> for --> |
| 1640 |
<!-- %the one recognised option <C>Exponent</C>. --> |
| 1641 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 1642 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 1643 |
program to invoke menu item 6 of the Advanced <M>p</M>-Group Generation menu. |
| 1644 |
Here the step-size <A>step</A> and the rank <A>rank</A> are positive integers and |
| 1645 |
-are the arguments required by the <C>pq</C> program. See <Ref Label="option Exponent" Style="Text"/> |
| 1646 |
+are the arguments required by the <C>anu-pq</C> program. See <Ref Label="option Exponent" Style="Text"/> |
| 1647 |
for the one recognised option <C>Exponent</C>. |
| 1648 |
-<!-- %<E>Note:</E> For those familiar with the <C>pq</C> program, <C>PqAPGDegree</C> performs --> |
| 1649 |
+<!-- %<E>Note:</E> For those familiar with the <C>anu-pq</C> program, <C>PqAPGDegree</C> performs --> |
| 1650 |
<!-- %menu item 6 of the Advanced <M>p</M>-Group Generation menu. --> |
| 1651 |
</Description> |
| 1652 |
</ManSection> |
| 1653 |
@@ -2031,14 +2031,14 @@ |
| 1654 |
<Func Name="PqAPGPermutations" Arg="i : options"/> |
| 1655 |
<Func Name="PqAPGPermutations" Arg=": options" Label="for default process"/> |
| 1656 |
<Description> |
| 1657 |
-<!-- %for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> --> |
| 1658 |
+<!-- %for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> --> |
| 1659 |
<!-- %program to compute permutations of subgroups. --> |
| 1660 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 1661 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 1662 |
program to perform menu item 7 of the Advanced <M>p</M>-Group Generation menu. |
| 1663 |
Here the options <A>options</A> recognised are <C>PcgsAutomorphisms</C>, |
| 1664 |
<C>SpaceEfficient</C>, <C>PrintAutomorphisms</C> and <C>PrintPermutations</C> (see |
| 1665 |
Chapter <Ref Chap="ANUPQ Options" Style="Text"/> for details). |
| 1666 |
-<!-- %<E>Note:</E> For those familiar with the <C>pq</C> program, <C>PqAPGPermutations</C> --> |
| 1667 |
+<!-- %<E>Note:</E> For those familiar with the <C>anu-pq</C> program, <C>PqAPGPermutations</C> --> |
| 1668 |
<!-- %performs menu item 7 of the Advanced <M>p</M>-Group Generation menu. --> |
| 1669 |
</Description> |
| 1670 |
</ManSection> |
| 1671 |
@@ -2047,11 +2047,11 @@ |
| 1672 |
<Func Name="PqAPGOrbits" Arg="i : options"/> |
| 1673 |
<Func Name="PqAPGOrbits" Arg=": options" Label="for default process"/> |
| 1674 |
<Description> |
| 1675 |
-<!-- %for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> --> |
| 1676 |
+<!-- %for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> --> |
| 1677 |
<!-- %program to compute the orbits of the automorphism group, and return the --> |
| 1678 |
<!-- %number of orbits, if either a summary or a complete listing (or both) of --> |
| 1679 |
<!-- %orbit information was requested. --> |
| 1680 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 1681 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 1682 |
to perform menu item 8 of the Advanced <M>p</M>-Group Generation menu. |
| 1683 |
<P/> |
| 1684 |
|
| 1685 |
@@ -2059,7 +2059,7 @@ |
| 1686 |
<C>SpaceEfficient</C> and <C>CustomiseOutput</C> (see Chapter <Ref Chap="ANUPQ Options" Style="Text"/> for |
| 1687 |
details). For the <C>CustomiseOutput</C> option only the setting of the |
| 1688 |
<C>orbit</C> is recognised (all other fields if set are ignored). |
| 1689 |
-<!-- %<E>Note:</E> For those familiar with the <C>pq</C> program, <C>PqAPGOrbits</C> performs --> |
| 1690 |
+<!-- %<E>Note:</E> For those familiar with the <C>anu-pq</C> program, <C>PqAPGOrbits</C> performs --> |
| 1691 |
<!-- %menu item 8 of the Advanced <M>p</M>-Group Generation menu. --> |
| 1692 |
</Description> |
| 1693 |
</ManSection> |
| 1694 |
@@ -2068,10 +2068,10 @@ |
| 1695 |
<Func Name="PqAPGOrbitRepresentatives" Arg="i : options"/> |
| 1696 |
<Func Name="PqAPGOrbitRepresentatives" Arg=": options" Label="for default process"/> |
| 1697 |
<Description> |
| 1698 |
-<!-- %for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> --> |
| 1699 |
+<!-- %for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> --> |
| 1700 |
<!-- %program to process the orbit representatives and output the reduced --> |
| 1701 |
<!-- %<M>p</M>-cover to a file. --> |
| 1702 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 1703 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 1704 |
to perform item 9 of the Advanced <M>p</M>-Group Generation menu. |
| 1705 |
<P/> |
| 1706 |
|
| 1707 |
@@ -2083,7 +2083,7 @@ |
| 1708 |
reduced <M>p</M>-cover is written to the file <C>"redPCover"</C> in the temporary |
| 1709 |
directory whose name is stored in <C>ANUPQData.tmpdir</C>. |
| 1710 |
<!-- %<E>Note:</E> --> |
| 1711 |
-<!-- %For those familiar with the <C>pq</C> program, <C>PqAPGOrbitRepresentatives</C> --> |
| 1712 |
+<!-- %For those familiar with the <C>anu-pq</C> program, <C>PqAPGOrbitRepresentatives</C> --> |
| 1713 |
<!-- %performs option 9 of the Advanced <M>p</M>-Group Generation menu. --> |
| 1714 |
</Description> |
| 1715 |
</ManSection> |
| 1716 |
@@ -2092,10 +2092,10 @@ |
| 1717 |
<Func Name="PqAPGSingleStage" Arg="i : options"/> |
| 1718 |
<Func Name="PqAPGSingleStage" Arg=": options" Label="for default process"/> |
| 1719 |
<Description> |
| 1720 |
-<!-- %for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> --> |
| 1721 |
+<!-- %for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> --> |
| 1722 |
<!-- %program to do a single stage of the descendants construction algorithm as --> |
| 1723 |
<!-- %prescribed by <A>options</A>. --> |
| 1724 |
-for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>pq</C> |
| 1725 |
+for the <A>i</A>th or default interactive &ANUPQ; process, direct the <C>anu-pq</C> |
| 1726 |
to perform option 5 of the Advanced <M>p</M>-Group Generation menu. |
| 1727 |
<P/> |
| 1728 |
|
| 1729 |
@@ -2105,7 +2105,7 @@ |
| 1730 |
<C>CustomiseOutput</C>. (Detailed descriptions of these options may be found |
| 1731 |
in Chapter <Ref Chap="ANUPQ Options" Style="Text"/>.) |
| 1732 |
<!-- %<E>Note:</E> --> |
| 1733 |
-<!-- %For those familiar with the <C>pq</C> program, <C>PqAPGSingleStage</C> performs --> |
| 1734 |
+<!-- %For those familiar with the <C>anu-pq</C> program, <C>PqAPGSingleStage</C> performs --> |
| 1735 |
<!-- %option 5 of the Advanced <M>p</M>-Group Generation menu. --> |
| 1736 |
</Description> |
| 1737 |
</ManSection> |
| 1738 |
@@ -2116,10 +2116,10 @@ |
| 1739 |
<Section Label="Primitive Interactive ANUPQ Process Read/Write Functions"> |
| 1740 |
<Heading>Primitive Interactive ANUPQ Process Read/Write Functions</Heading> |
| 1741 |
|
| 1742 |
-For those familiar with using the <C>pq</C> program as a standalone we provide |
| 1743 |
+For those familiar with using the <C>anu-pq</C> program as a standalone we provide |
| 1744 |
primitive read/write tools to communicate directly with an interactive |
| 1745 |
&ANUPQ; process, started via <C>PqStart</C>. For the most part, it is up to |
| 1746 |
-the user to translate the output strings from <C>pq</C> program into a form |
| 1747 |
+the user to translate the output strings from <C>anu-pq</C> program into a form |
| 1748 |
useful in &GAP;. |
| 1749 |
|
| 1750 |
<ManSection> |
| 1751 |
@@ -2134,7 +2134,7 @@ |
| 1752 |
<K>fail</K> purely because the output from &ANUPQ; is not there yet), but if |
| 1753 |
<C>PqRead</C> finds any output at all, it waits for a complete line. <C>PqRead</C> |
| 1754 |
also writes the line read via <C>Info</C> at <C>InfoANUPQ</C> level 2. It doesn't |
| 1755 |
-try to distinguish banner and menu output from other output of the <C>pq</C> |
| 1756 |
+try to distinguish banner and menu output from other output of the <C>anu-pq</C> |
| 1757 |
program. |
| 1758 |
</Description> |
| 1759 |
</ManSection> |
| 1760 |
@@ -2148,7 +2148,7 @@ |
| 1761 |
<E>at the time of the call</E>, as a list of strings with any trailing |
| 1762 |
newlines removed and returns the empty list otherwise. <C>PqReadAll</C> also |
| 1763 |
writes each line read via <C>Info</C> at <C>InfoANUPQ</C> level 2. It doesn't try |
| 1764 |
-to distinguish banner and menu output from other output of the <C>pq</C> |
| 1765 |
+to distinguish banner and menu output from other output of the <C>anu-pq</C> |
| 1766 |
program. Whenever <C>PqReadAll</C> finds only a partial line, it waits for the |
| 1767 |
complete line, thus increasing the probability that it has captured all |
| 1768 |
the output to be had from &ANUPQ;. |
| 1769 |
@@ -2165,7 +2165,7 @@ |
| 1770 |
interactive &ANUPQ; process, <Q>chomps</Q> them (i.e. removes any trailing |
| 1771 |
newline character), emits them to <C>Info</C> at <C>InfoANUPQ</C> level 2 (without |
| 1772 |
trying to distinguish banner and menu output from other output of the |
| 1773 |
-<C>pq</C> program), and applies the function <A>Modify</A> (where <A>Modify</A> is just |
| 1774 |
+<C>anu-pq</C> program), and applies the function <A>Modify</A> (where <A>Modify</A> is just |
| 1775 |
the identity map/function for the first two forms) until a <Q>chomped</Q> |
| 1776 |
line <A>line</A> for which <C><A>IsMyLine</A>( <A>Modify</A>(<A>line</A>) )</C> is true. |
| 1777 |
<C>PqReadUntil</C> returns the list of <A>Modify</A>-ed <Q>chomped</Q> lines read. |
| 1778 |
@@ -2194,7 +2194,7 @@ |
| 1779 |
<A>string</A> must be in exactly the form the &ANUPQ; standalone expects. The |
| 1780 |
command is echoed via <C>Info</C> at <C>InfoANUPQ</C> level 3 (with a <Q><C>ToPQ> </C></Q> |
| 1781 |
prompt); i.e. do <C>SetInfoLevel(InfoANUPQ, 3);</C> to see what is transmitted |
| 1782 |
-to the <C>pq</C> program. <C>PqWrite</C> returns <K>true</K> if successful in writing to |
| 1783 |
+to the <C>anu-pq</C> program. <C>PqWrite</C> returns <K>true</K> if successful in writing to |
| 1784 |
the stream of the interactive &ANUPQ; process, and <K>fail</K> otherwise. |
| 1785 |
<P/> |
| 1786 |
|
| 1787 |
--- a/doc/intro.xml |
| 1788 |
+++ b/doc/intro.xml |
| 1789 |
@@ -6,14 +6,14 @@ |
| 1790 |
|
| 1791 |
|
| 1792 |
<Index>ANUPQ</Index> |
| 1793 |
-The &GAP; 4 package &ANUPQ; provides an interface to the ANU <C>pq</C> C |
| 1794 |
+The &GAP; 4 package &ANUPQ; provides an interface to the ANU <C>anu-pq</C> C |
| 1795 |
program written by Eamonn O'Brien, making the functionality of the C |
| 1796 |
program available to &GAP;. Henceforth, we shall refer to the &ANUPQ; |
| 1797 |
-package when referring to the &GAP; interface, and to the ANU <C>pq</C> |
| 1798 |
-program or just <C>pq</C> when referring to that C program. |
| 1799 |
+package when referring to the &GAP; interface, and to the ANU <C>anu-pq</C> |
| 1800 |
+program or just <C>anu-pq</C> when referring to that C program. |
| 1801 |
<P/> |
| 1802 |
|
| 1803 |
-The <C>pq</C> program consists of implementations of the following algorithms: |
| 1804 |
+The <C>anu-pq</C> program consists of implementations of the following algorithms: |
| 1805 |
<P/> |
| 1806 |
|
| 1807 |
<Enum> |
| 1808 |
@@ -50,7 +50,7 @@ |
| 1809 |
<M>p</M>-group. |
| 1810 |
<P/> |
| 1811 |
|
| 1812 |
-This part of the <C>pq</C> program is not accessible through the &ANUPQ; |
| 1813 |
+This part of the <C>anu-pq</C> program is not accessible through the &ANUPQ; |
| 1814 |
package. Instead, users are advised to consider the &GAP; 4 package |
| 1815 |
&AutPGrp; by Bettina Eick and Eamonn O'Brien, which implements a better |
| 1816 |
algorithm in &GAP; for the computation of automorphism groups of |
| 1817 |
@@ -97,18 +97,18 @@ |
| 1818 |
for the options of the functions that are described. The user will become |
| 1819 |
best acquainted with the &ANUPQ; package by trying the examples. This |
| 1820 |
chapter describes the non-interactive functions of the &ANUPQ; package, |
| 1821 |
-i.e. <Q>one-shot</Q> functions that invoke the <C>pq</C> program in such a way |
| 1822 |
-that once &GAP; has got what it needs, the <C>pq</C> is allowed to exit. It |
| 1823 |
+i.e. <Q>one-shot</Q> functions that invoke the <C>anu-pq</C> program in such a way |
| 1824 |
+that once &GAP; has got what it needs, the <C>anu-pq</C> is allowed to exit. It |
| 1825 |
is expected that most of the time, users will only need these functions. |
| 1826 |
<P/> |
| 1827 |
|
| 1828 |
Advanced users will want to explore Chapter <Ref Chap="Interactive ANUPQ functions" Style="Text"/> |
| 1829 |
which describes all the interactive functions of the &ANUPQ; package; |
| 1830 |
these are functions that extract information via a dialogue with a |
| 1831 |
-running <C>pq</C> process. Occasionally, a user needs the <Q>next step</Q>; the |
| 1832 |
+running <C>anu-pq</C> process. Occasionally, a user needs the <Q>next step</Q>; the |
| 1833 |
functions provided in this chapter make use of data from previous steps |
| 1834 |
-retained by the <C>pq</C> program, thus allowing the user to interact with the |
| 1835 |
-<C>pq</C> program like one can when one uses the <C>pq</C> program as a stand-alone |
| 1836 |
+retained by the <C>anu-pq</C> program, thus allowing the user to interact with the |
| 1837 |
+<C>anu-pq</C> program like one can when one uses the <C>anu-pq</C> program as a stand-alone |
| 1838 |
(see <C>guide.dvi</C> in the <C>standalone-doc</C> directory). |
| 1839 |
<P/> |
| 1840 |
|
| 1841 |
@@ -134,7 +134,7 @@ |
| 1842 |
<Section Label="Authors and Acknowledgements"> |
| 1843 |
<Heading>Authors and Acknowledgements</Heading> |
| 1844 |
|
| 1845 |
-The C implementation of the ANU <C>pq</C> standalone was developed by Eamonn O'Brien. |
| 1846 |
+The C implementation of the ANU <C>anu-pq</C> standalone was developed by Eamonn O'Brien. |
| 1847 |
<P/> |
| 1848 |
|
| 1849 |
An interactive interface using iostreams was developed with the |
| 1850 |
--- a/doc/non-interact.xml |
| 1851 |
+++ b/doc/non-interact.xml |
| 1852 |
@@ -2,12 +2,12 @@ |
| 1853 |
<Heading>Non-interactive ANUPQ functions</Heading> |
| 1854 |
|
| 1855 |
Here we describe all the non-interactive functions of the &ANUPQ; |
| 1856 |
-package; i.e. <Q>one-shot</Q> functions that invoke the <C>pq</C> program in such |
| 1857 |
-a way that once &GAP; has got what it needs, the <C>pq</C> program is allowed |
| 1858 |
+package; i.e. <Q>one-shot</Q> functions that invoke the <C>anu-pq</C> program in such |
| 1859 |
+a way that once &GAP; has got what it needs, the <C>anu-pq</C> program is allowed |
| 1860 |
to exit. It is expected that most of the time users will only need these |
| 1861 |
functions. The functions interface with three of the four algorithms (see |
| 1862 |
-Chapter <Ref Chap="Introduction" Style="Text"/>) provided by the ANU <C>pq</C> C program, and are |
| 1863 |
-mainly grouped according to the algorithm of the <C>pq</C> program they relate |
| 1864 |
+Chapter <Ref Chap="Introduction" Style="Text"/>) provided by the ANU <C>anu-pq</C> C program, and are |
| 1865 |
+mainly grouped according to the algorithm of the <C>anu-pq</C> program they relate |
| 1866 |
to. |
| 1867 |
<P/> |
| 1868 |
|
| 1869 |
@@ -137,7 +137,7 @@ |
| 1870 |
|
| 1871 |
Now we redo the last example to show how one may use the <C>Relators</C> |
| 1872 |
option. Observe that <C>Comm(Comm(b, a), a)</C> is a left normed commutator |
| 1873 |
-which must be written in square bracket notation for the <C>pq</C> program and |
| 1874 |
+which must be written in square bracket notation for the <C>anu-pq</C> program and |
| 1875 |
embedded in a pair of double quotes. The function <C>PqGAPRelators</C> |
| 1876 |
(see <Ref Func="PqGAPRelators" Style="Text"/>) can be used to translate a list of strings prepared |
| 1877 |
for the <C>Relators</C> option into &GAP; format. Below we use it. Observe |
| 1878 |
@@ -648,7 +648,7 @@ |
| 1879 |
The function <C>PqDescendants</C> uses the automorphism group of <A>G</A> which it |
| 1880 |
computes via the package &AutPGrp;. If this package is not installed an |
| 1881 |
error may be raised. If the automorphism group of <A>G</A> is insoluble, the |
| 1882 |
-<C>pq</C> program will call &GAP; together with the &AutPGrp; package for |
| 1883 |
+<C>anu-pq</C> program will call &GAP; together with the &AutPGrp; package for |
| 1884 |
certain orbit-stabilizer calculations. (So, in any case, one should |
| 1885 |
ensure the &AutPGrp; package is installed.) |
| 1886 |
<P/> |
| 1887 |
@@ -744,7 +744,7 @@ |
| 1888 |
<Description> |
| 1889 |
returns a generating set for a supplement to the inner automorphisms of |
| 1890 |
<A>D</A>, in the form of a record with fields <C>agAutos</C>, <C>agOrder</C> and |
| 1891 |
-<C>glAutos</C>, as provided by the <C>pq</C> program. One should be very careful in |
| 1892 |
+<C>glAutos</C>, as provided by the <C>anu-pq</C> program. One should be very careful in |
| 1893 |
using these automorphisms for a descendant calculation. |
| 1894 |
<!-- %The automorphisms generate a subgroup of the automorphism group of the pc --> |
| 1895 |
<!-- %group <A>D</A> that supplements the inner automorphism group of <A>D</A> in the --> |
| 1896 |
@@ -757,7 +757,7 @@ |
| 1897 |
<E>Note:</E> |
| 1898 |
In principle there must be a way to use those automorphisms in order to |
| 1899 |
compute descendants but there does not seem to be a way to hand back |
| 1900 |
-these automorphisms properly to the <C>pq</C> program. |
| 1901 |
+these automorphisms properly to the <C>anu-pq</C> program. |
| 1902 |
|
| 1903 |
<Example><![CDATA[ |
| 1904 |
gap> Q := Pq( FreeGroup(2) : Prime := 3, ClassBound := 1 ); |
| 1905 |
@@ -790,8 +790,8 @@ |
| 1906 |
Note that by also including <C>PqStart</C> as a second argument to <C>PqExample</C> |
| 1907 |
one can see how it is possible, with the aid of <C>PqSetPQuotientToGroup</C> |
| 1908 |
(see <Ref Func="PqSetPQuotientToGroup" Style="Text"/>), to do the equivalent computations with the |
| 1909 |
-interactive versions of <C>Pq</C> and <C>PqDescendants</C> and a single <C>pq</C> |
| 1910 |
-process (recall <C>pq</C> is the name of the external C program). |
| 1911 |
+interactive versions of <C>Pq</C> and <C>PqDescendants</C> and a single <C>anu-pq</C> |
| 1912 |
+process (recall <C>anu-pq</C> is the name of the external C program). |
| 1913 |
</Description> |
| 1914 |
</ManSection> |
| 1915 |
|
| 1916 |
--- a/doc/options.xml |
| 1917 |
+++ b/doc/options.xml |
| 1918 |
@@ -96,7 +96,7 @@ |
| 1919 |
<Item> |
| 1920 |
Specifies that the <M>p</M>-quotient to be computed has lower exponent-<M>p</M> |
| 1921 |
class at most <A>n</A>. If this option is omitted a default of 63 (which is |
| 1922 |
-the maximum possible for the <C>pq</C> program) is taken, except for |
| 1923 |
+the maximum possible for the <C>anu-pq</C> program) is taken, except for |
| 1924 |
<C>PqDescendants</C> (see <Ref Func="PqDescendants" Style="Text"/>) and in a special case of <C>PqPCover</C> |
| 1925 |
(see <Ref Func="PqPCover" Style="Text"/>). Let <A>F</A> be the argument (or start group of the process |
| 1926 |
in the interactive case) for the function; then for <C>PqDescendants</C> the |
| 1927 |
@@ -127,12 +127,12 @@ |
| 1928 |
<Mark><C>Relators := <A>rels</A></C> |
| 1929 |
<Label Name="option Relators"/><Index>option Relators</Index></Mark> |
| 1930 |
<Item> |
| 1931 |
-Specifies that the relators sent to the <C>pq</C> program should be <A>rels</A> |
| 1932 |
+Specifies that the relators sent to the <C>anu-pq</C> program should be <A>rels</A> |
| 1933 |
instead of the relators of the argument group <A>F</A> (or start group in the |
| 1934 |
interactive case) of the calling function; <A>rels</A> should be a list of |
| 1935 |
<E>strings</E> in the string representations of the generators of <A>F</A>, and <A>F</A> |
| 1936 |
must be an <E>fp group</E> (even if the calling function accepts a pc group). |
| 1937 |
-This option provides a way of giving relators to the <C>pq</C> program, |
| 1938 |
+This option provides a way of giving relators to the <C>anu-pq</C> program, |
| 1939 |
without having them pre-expanded by &GAP;, which can sometimes effect a |
| 1940 |
performance loss of the order of 100 (see Section <Ref Sect="The Relators Option" Style="Text"/>). |
| 1941 |
<P/> |
| 1942 |
@@ -140,9 +140,9 @@ |
| 1943 |
<E>Notes</E> |
| 1944 |
<Enum> |
| 1945 |
<Item> |
| 1946 |
- The <C>pq</C> program does not use <C>/</C> to indicate multiplication by an |
| 1947 |
+ The <C>anu-pq</C> program does not use <C>/</C> to indicate multiplication by an |
| 1948 |
inverse and uses square brackets to represent (left normed) commutators. |
| 1949 |
- Also, even though the <C>pq</C> program accepts relations, all elements of |
| 1950 |
+ Also, even though the <C>anu-pq</C> program accepts relations, all elements of |
| 1951 |
<A>rels</A> <E>must</E> be in relator form, i.e. a relation of form <C><A>w1</A> = <A>w2</A></C> |
| 1952 |
must be written as <C><A>w1</A>*(<A>w2</A>)^-1</C> and then put in a pair of |
| 1953 |
double-quotes to make it a string. See the example below. |
| 1954 |
@@ -166,10 +166,10 @@ |
| 1955 |
<Mark><C>GroupName := <A>name</A></C> |
| 1956 |
<Label Name="option GroupName"/><Index>option GroupName</Index></Mark> |
| 1957 |
<Item> |
| 1958 |
-Specifies that the <C>pq</C> program should refer to the group by the name |
| 1959 |
+Specifies that the <C>anu-pq</C> program should refer to the group by the name |
| 1960 |
<A>name</A> (a string). If <C>GroupName</C> is not set and the group has been |
| 1961 |
assigned a name via <C>SetName</C> (see <Ref BookName="ref" Label="SetName" Style="Text"/>) it is set as the name |
| 1962 |
-the <C>pq</C> program should use. Otherwise, the <Q>generic</Q> name <C>"[grp]"</C> |
| 1963 |
+the <C>anu-pq</C> program should use. Otherwise, the <Q>generic</Q> name <C>"[grp]"</C> |
| 1964 |
is set as a default. |
| 1965 |
</Item> |
| 1966 |
|
| 1967 |
@@ -188,7 +188,7 @@ |
| 1968 |
level 1, the number of instances is <C>Info</C>-ed at <C>InfoANUPQ</C> level 2, and |
| 1969 |
the instances that are evaluated are <C>Info</C>-ed at <C>InfoANUPQ</C> level 3. As |
| 1970 |
usual timing information is <C>Info</C>-ed at <C>InfoANUPQ</C> level 2; and details |
| 1971 |
-of the processing of each instance from the <C>pq</C> program (which is often |
| 1972 |
+of the processing of each instance from the <C>anu-pq</C> program (which is often |
| 1973 |
quite <E>voluminous</E>) is <C>Info</C>-ed at <C>InfoANUPQ</C> level 3. Try the examples |
| 1974 |
<C>"B2-4-Id"</C> and <C>"11gp-3-Engel-Id"</C> which demonstrate the usage of the |
| 1975 |
<C>Identities</C> option; these are run using <C>PqExample</C> (see <Ref Func="PqExample" Style="Text"/>). |
| 1976 |
@@ -224,11 +224,11 @@ |
| 1977 |
<Label Name="option OutputLevel"/><Index>option OutputLevel</Index></Mark> |
| 1978 |
<Item> |
| 1979 |
Specifies the level of <Q>verbosity</Q> of the information output by the ANU |
| 1980 |
-<C>pq</C> program when computing a pc presentation; <A>n</A> must be an integer in |
| 1981 |
+<C>anu-pq</C> program when computing a pc presentation; <A>n</A> must be an integer in |
| 1982 |
the range 0 to 3. <C>OutputLevel := 0</C> displays at most one line of output |
| 1983 |
and is the default; <C>OutputLevel := 1</C> displays (usually) slightly more |
| 1984 |
output and <C>OutputLevel</C>s of 2 and 3 are two levels of verbose output. To |
| 1985 |
-see these messages from the <C>pq</C> program, the <C>InfoANUPQ</C> level must be |
| 1986 |
+see these messages from the <C>anu-pq</C> program, the <C>InfoANUPQ</C> level must be |
| 1987 |
set to at least 1 (see <Ref Func="InfoANUPQ" Style="Text"/>). See |
| 1988 |
Section <Ref Sect="Hints and Warnings regarding the use of Options" Style="Text"/> |
| 1989 |
for an example of how <C>OutputLevel</C> can be used as a troubleshooting tool. |
| 1990 |
@@ -238,7 +238,7 @@ |
| 1991 |
<Label Name="option RedoPcp"/><Index>option RedoPcp</Index></Mark> |
| 1992 |
<Item> |
| 1993 |
Specifies that the current pc presentation (for an interactive process) |
| 1994 |
-stored by the <C>pq</C> program be scrapped and clears the current values |
| 1995 |
+stored by the <C>anu-pq</C> program be scrapped and clears the current values |
| 1996 |
stored for the options <C>Prime</C>, <C>ClassBound</C>, <C>Exponent</C> and <C>Metabelian</C> |
| 1997 |
and also clears the <C>pQuotient</C>, <C>pQepi</C> and <C>pCover</C> fields of the data |
| 1998 |
record of the process. |
| 1999 |
@@ -247,21 +247,21 @@ |
| 2000 |
<Mark><C>SetupFile := <A>filename</A></C> |
| 2001 |
<Label Name="option SetupFile"/><Index>option SetupFile</Index></Mark> |
| 2002 |
<Item> |
| 2003 |
-Non-interactively, this option directs that <C>pq</C> should not be called and |
| 2004 |
+Non-interactively, this option directs that <C>anu-pq</C> should not be called and |
| 2005 |
that an input file with name <A>filename</A> (a string), containing the |
| 2006 |
-commands necessary for the ANU <C>pq</C> standalone, be constructed. The |
| 2007 |
+commands necessary for the ANU <C>anu-pq</C> standalone, be constructed. The |
| 2008 |
commands written to <A>filename</A> are also <C>Info</C>-ed behind a <Q><C>ToPQ> </C></Q> |
| 2009 |
prompt at <C>InfoANUPQ</C> level 4 (see <Ref Func="InfoANUPQ" Style="Text"/>). Except in the case |
| 2010 |
following, the calling function returns <K>true</K>. If the calling function |
| 2011 |
is the non-interactive version of one of <C>Pq</C>, <C>PqPCover</C> or |
| 2012 |
<C>PqEpimorphism</C> and the group provided as argument is trivial given with |
| 2013 |
an empty set of generators, then no setup file is written and <K>fail</K> is |
| 2014 |
-returned (the <C>pq</C> program cannot do anything useful with such a group). |
| 2015 |
+returned (the <C>anu-pq</C> program cannot do anything useful with such a group). |
| 2016 |
Interactively, <C>SetupFile</C> is ignored. |
| 2017 |
<P/> |
| 2018 |
|
| 2019 |
<E>Note:</E> |
| 2020 |
-Since commands emitted to the <C>pq</C> program may depend on knowing what the |
| 2021 |
+Since commands emitted to the <C>anu-pq</C> program may depend on knowing what the |
| 2022 |
<Q>current state</Q> is, to form a setup file some <Q>close enough guesses</Q> |
| 2023 |
may sometimes be necessary; when this occurs a warning is <C>Info</C>-ed at |
| 2024 |
<C>InfoANUPQ</C> or <C>InfoWarning</C> level 1. To determine whether the <Q>close |
| 2025 |
@@ -269,15 +269,15 @@ |
| 2026 |
command without the <C>SetupFile</C> option, after either setting the |
| 2027 |
<C>InfoANUPQ</C> level to at least 4 (the setup file script can then be |
| 2028 |
compared with the <Q><C>ToPQ> </C></Q> commands that are <C>Info</C>-ed) or setting a |
| 2029 |
-<C>pq</C> command log file by using <C>ToPQLog</C> (see <Ref Func="ToPQLog" Style="Text"/>). |
| 2030 |
+<C>anu-pq</C> command log file by using <C>ToPQLog</C> (see <Ref Func="ToPQLog" Style="Text"/>). |
| 2031 |
</Item> |
| 2032 |
|
| 2033 |
<Mark><C>PqWorkspace := <A>workspace</A></C> |
| 2034 |
<Label Name="option PqWorkspace"/><Index>option PqWorkspace</Index></Mark> |
| 2035 |
<Item> |
| 2036 |
-Non-interactively, this option sets the memory used by the <C>pq</C> program. |
| 2037 |
+Non-interactively, this option sets the memory used by the <C>anu-pq</C> program. |
| 2038 |
It sets the maximum number of integer-sized elements to allocate in its |
| 2039 |
-main storage array. By default, the <C>pq</C> program sets this figure to |
| 2040 |
+main storage array. By default, the <C>anu-pq</C> program sets this figure to |
| 2041 |
10000000. Interactively, <C>PqWorkspace</C> is ignored; the memory used in |
| 2042 |
this case may be set by giving <C>PqStart</C> a second argument |
| 2043 |
(see <Ref Func="PqStart" Style="Text"/>). |
| 2044 |
@@ -295,8 +295,8 @@ |
| 2045 |
interactive process). Passing the option <C>PcgsAutomorphisms</C> without a |
| 2046 |
value (or equivalently setting it to <K>true</K>), specifies that a polycyclic |
| 2047 |
generating sequence for the automorphism group (which must be <E>soluble</E>) |
| 2048 |
-of <A>G</A>, be computed and passed to the <C>pq</C> program. This increases the |
| 2049 |
-efficiency of the computation; it also prevents the <C>pq</C> from calling |
| 2050 |
+of <A>G</A>, be computed and passed to the <C>anu-pq</C> program. This increases the |
| 2051 |
+efficiency of the computation; it also prevents the <C>anu-pq</C> from calling |
| 2052 |
&GAP; for orbit-stabilizer calculations. By default, <C>PcgsAutomorphisms</C> |
| 2053 |
is set to the value returned by <C>IsSolvable( AutomorphismGroup( <A>G</A> ) )</C>, |
| 2054 |
and uses the package &AutPGrp; to compute <C>AutomorphismGroup( <A>G</A> )</C> if |
| 2055 |
@@ -347,7 +347,7 @@ |
| 2056 |
<Mark><C>SpaceEfficient</C> |
| 2057 |
<Label Name="option SpaceEfficient"/><Index>option SpaceEfficient</Index></Mark> |
| 2058 |
<Item> |
| 2059 |
-Specifies that the <C>pq</C> program performs certain calculations of <M>p</M>-group |
| 2060 |
+Specifies that the <C>anu-pq</C> program performs certain calculations of <M>p</M>-group |
| 2061 |
generation more slowly but with greater space efficiency. This flag is |
| 2062 |
frequently necessary for groups of large Frattini quotient rank. The |
| 2063 |
space saving occurs because only one permutation is stored at any one |
| 2064 |
@@ -420,7 +420,7 @@ |
| 2065 |
<Mark><C>BasicAlgorithm</C> |
| 2066 |
<Label Name="option BasicAlgorithm"/><Index>option BasicAlgorithm</Index></Mark> |
| 2067 |
<Item> |
| 2068 |
-Specifies that an algorithm that the <C>pq</C> program calls its <Q>default</Q> |
| 2069 |
+Specifies that an algorithm that the <C>anu-pq</C> program calls its <Q>default</Q> |
| 2070 |
algorithm be used for <M>p</M>-group generation. By default this algorithm is |
| 2071 |
<E>not</E> used. If this option is supplied the settings of options |
| 2072 |
<C>RankInitialSegmentSubgroups</C>, <C>AllDescendants</C>, <C>Exponent</C> and |
| 2073 |
@@ -495,7 +495,7 @@ |
| 2074 |
the directory in which &GAP; was started. If this option is omitted it |
| 2075 |
is written to the file with the name generated by the command <C>Filename( |
| 2076 |
ANUPQData.tmpdir, "SPres" );</C>, i.e. the file with name <C>"SPres"</C> in the |
| 2077 |
-temporary directory in which the <C>pq</C> program executes. |
| 2078 |
+temporary directory in which the <C>anu-pq</C> program executes. |
| 2079 |
</Item> |
| 2080 |
|
| 2081 |
<Mark><C>QueueFactor := <A>n</A></C> |
| 2082 |
@@ -505,7 +505,7 @@ |
| 2083 |
This option may be used with <C>PqNextClass</C> (see <Ref Func="PqNextClass" Style="Text"/>). |
| 2084 |
<P/> |
| 2085 |
|
| 2086 |
-The queue factor is used when the <C>pq</C> program uses automorphisms to close |
| 2087 |
+The queue factor is used when the <C>anu-pq</C> program uses automorphisms to close |
| 2088 |
a set of elements of the <M>p</M>-multiplicator under their action. |
| 2089 |
<P/> |
| 2090 |
|
| 2091 |
@@ -554,7 +554,7 @@ |
| 2092 |
<Label Name="option Filename"/><Index>option Filename</Index></Mark> |
| 2093 |
<Item> |
| 2094 |
Specifies that an output or input file to be written to or read from by |
| 2095 |
-the <C>pq</C> program should have the name <A>string</A>. |
| 2096 |
+the <C>anu-pq</C> program should have the name <A>string</A>. |
| 2097 |
</Item> |
| 2098 |
</List> |
| 2099 |
|