1. The contents of sections 1.3 and 1.4 are the same.
2. To facilitate double-sided printing, equal left and right margins are required.
3. The manual is too bulky for 'comb' (spiral) binding and, as a single document, is also unwieldy. May I suggest that it be split into several volumes, each with their own TOC and Index sections? I would suggest something along the following lines:
Volume I: 'Basics' Parts 1 and 2 (142 pages + TOC + Index)
Volume II: 'Libraries & Abstract Data Types' Parts 3, 4, 5, 6 and 9 (184 pages+ TOC + Index)
Volume III: 'Extensions & Foreign Language Interfaces' Parts 7 and 8 (148 pages+ TOC + Index)
Volume IV: 'Standalone Utilities, Contributed Libraries, Appendices & References' Parts 10, 11 and 12, References and Definition Indexes (126 pages + TOC + Index)
This leaves room for moderate expansion of each volume. In due course, additional volumes may be required, eg. Volume V: 'Graphical User Interface (GUI)'.
Cheers, Daniel
Daniel Dudley writes:
- The contents of sections 1.3 and 1.4 are the same.
- To facilitate double-sided printing, equal left and right margins
are required.
Yes, it's true. Thanks for pointing it out.
- The manual is too bulky for 'comb' (spiral) binding and, as a
single document, is also unwieldy. May I suggest that it be split into several volumes, each with their own TOC and Index sections? I would suggest something along the following lines:
Yes. This is in our list of things to do. Although one can oneself make separate bindings, we agree in that it is much more elegant to provide separate volumes. The point is that the documentation in all the formats is generated from the sources by lpdoc (a tool written in Ciao Prolog). This keeps everything in sync automatically, but sometimes we discover practical problems we have to work around --- when we have time!
MCL
________________________________________________________ Virtuosity is no big deal, if you don't mind practicing.
-
Daniel Dudley -
Manuel Carro