[Axiom-developer] 20080727.01.tpd.patch (update What's New pages)

[daly]

Update the What's New pages in Hyperdoc, including new images.

=======================================================================
diff --git a/books/bookvol7.1.pamphlet b/books/bookvol7.1.pamphlet
index 9b7426b..e1a9dca 100644
--- a/books/bookvol7.1.pamphlet
+++ b/books/bookvol7.1.pamphlet
@@ -233,6 +233,7 @@ November 10, 2003 ((iHy))
 \pagepic{ps/v71releasenotes.eps}{releasenotes}
 \pagefrom{Root Page}{RootPage}
 \pageto{Online information}{onlineInformation}
+\pageto{July 2008}{july2008}
 \pageto{May 2008}{may2008}
 \pageto{March 2008}{march2008}
 \pageto{January 2008}{january2008}
@@ -243,6 +244,7 @@ November 10, 2003 ((iHy))
 \beginscroll
 \beginmenu
     \menudownlink{Online information}{onlineInformation}
+    \menudownlink{July 2008}{july2008}
     \menudownlink{May 2008}{may2008}
     \menudownlink{March 2008}{march2008}
     \menudownlink{January 2008}{january2008}
@@ -255,6 +257,8 @@ November 10, 2003 ((iHy))
 
 @
 \pagehead{onlineInformation}{releasenotes.ht}{Online Information}
+\pagepic{ps/v71onlineinformation.eps}{onlineinformation}
+\pagefrom{What's New in Axiom}{releaseNotes}
 <<releasenotes.ht>>=
 \begin{page}{onlineInformation}{Online information}
 \beginscroll
@@ -267,7 +271,150 @@ Axiom information can be found online at
 \end{page}
 
 @
+\pagehead{july2008}{releasenotes.ht}{July 23, 2008 Release Notes}
+\pagepic{ps/v71july2008.eps}{july2008}
+\pagefrom{What's New in Axiom}{releaseNotes}
+<<releasenotes.ht>>=
+\begin{page}{july2008}{July 23, 2008 Release Notes}
+\beginscroll
+\begin{verbatim}
+The July 2008 release marks the second large-scale change toward a
+literate Axiom distribution. The original change was to make every
+file into a pamphlet document. This second change draws Axiom into
+tighter collections, called books (for obvious reasons). 
+
+There is a new "books" directory which contains 14 books, most of
+which are new:
+
+ bookvol0:  The reconstructed Jenks and Sutor book
+ bookvol1:  The published tutorial volume
+ bookvol2:  Users Guide
+ bookvol3:  Programmers Guide
+ bookvol4:  Developers Guide
+ bookvol5:  Interpreter
+ bookvol6:  Command
+ bookvol7:  Hyperdoc
+ bookvol7.1 Hyperdoc Pages
+ bookvol8:  Graphics
+ bookvol9:  Compiler
+ bookvol10: Algebra
+ bookvol11: Browser
+ bookvol12: Crystal
+
+All of these books now exist. Portions of the current system have
+been moved completely into book form (Graphics and Hyperdoc) so
+the old files have been removed from the src tree. Both Graphics
+and Hyperdoc are now built directly from their book. Work will 
+follow on other parts of the system.
+
+These books are online at:
+<http://axiom.axiom-developer.org/axiom-website/documentation.html>
+
+
+
+
+There is an interesting side-effect of using literate technology.
+Once you combine C and .h files into a single document so that each
+file is a separate chunk it becomes obvious that there is no need for
+local include files. The lines that read:
+   #include "foo.h"
+become
+   @<<foo.h>>
+and get expanded inline. Once you do this it also becomes obvious
+that many include files get included multiple times (a clear waste
+of disk I/O and preparser time). Further it becomes clear that there
+is no need for creating tiny .o files since all of the source can
+be combined into one C file using chunks. 
+
+These approaches were used to reduce the compile-time overhead
+for both the graphics and the hyperdoc functions.
+
+
+
+
+In addition to consolidating the source files for Graphics into
+bookvol8 there were several other changes.
+
+  * the functions for graphics, that is, viewman, view2d, view3d
+    and viewalone are now built as single C files. 
+  * the graphics code was reorganized into chapters of related code
+  * there is the beginnings of documentation
+  * there is the beginnings of a test suite based on the 
+    CRC Handbook of Curves and Surfaces
+  * the book is hyperlinked (Bill Page, Frederic Lehobey, Anatoly Raportirenko)
+  * redundant code was eliminated
+  * the code is fully indexed
+  * the src/graph subdirectory is gone
+
+
+
+In addition to consolidating the source files for Hyperdoc into
+bookvol7 there were several other changes.
+
+  * the functions for hyperdoc, that is, spadbuf, ex2ht, htadd, hthits
+    and hypertex are now built as single C files
+  * the hyperdoc code was reorganized into chapters of related code
+  * there is the beginnngs of documentation
+  * redundant code was eliminated
+  * scroll wheel handling was added (Gregory Vanuxem)
+  * the book is hyperlinked (Bill Page, Frederic Lehobey, Anatoly Raportirenko)
+  * the code is fully indexed
+  * )hd now works to start or restart Hyperdoc (Jose Alfredo Portes)
+  * the src/hyper subdirectory is gone
+
+
+
+In addition to consolidating the hyperdoc pages into bookvol7.1
+there were several other changes:
+
+  * the pages are hyperlinked
+  * new latex macros were written to simplify page handling
+  * images of hyperdoc pages were added
+  * forward and backward hyperlinks between pages images works
+    making it possible to "browse" the hyperdoc pages using only
+    the single PDF file (Bill Page, Frederic Lehobey, Anatoly Raportirenko)
+  * the pages are fully indexed
+  * the src/hyper/pages subdirectory is gone
+
+
+
+A combined table of contents PDF is now automatically generated
+which covers all of the volumes. This makes it easier to find the
+topic of interest.
+
+
+In addition there were several other changes.
+
+  * Some fixes were made for different platforms
+       In particular, Fedora9 breaks the build and needs work
+
+  * The configure script was replaced by instructions
+       The standard (export AXIOM) works everywhere so the configure
+       script is useless for guessing.
+
+  * the FAQ was updated about git
+       Since the May 2008 release the primary Gold source code platform
+       is github. The FAQ was updated to reflect this.
+
+  * the FAQ was updated about X11
+       X11 has moved yet again so more notes are needed
+
+  * move axbook to books
+       The hyperlinked version of Jenks is now built from the books dir
+
+  * add Ralf Hemmecke's documentation to ax.boot
+  * add Monoid multiply to DirectProduct (Ralf Hemmecke)
+  * add Monoid multiply regression test
+
+\end{verbatim}
+\endscroll
+\autobuttons
+\end{page}
+
+@
 \pagehead{may2008}{releasenotes.ht}{May 27, 2008 Release Notes}
+\pagepic{ps/v71may2008.eps}{may2008}
+\pagefrom{What's New in Axiom}{releaseNotes}
 <<releasenotes.ht>>=
 \begin{page}{may2008}{May 27, 2008 Release Notes}
 \beginscroll
@@ -309,6 +456,8 @@ PORTING
 
 @
 \pagehead{march2008}{releasenotes.ht}{March 25, 2008 Release Notes}
+\pagepic{ps/v71march2008.eps}{march2008}
+\pagefrom{What's New in Axiom}{releaseNotes}
 <<releasenotes.ht>>=
 \begin{page}{march2008}{March 25, 2008 Release Notes}
 \beginscroll
@@ -404,6 +553,8 @@ o  Complex Gamma, logGamma, and log(Gamma) have additional 
tests and
 
 @
 \pagehead{january2008}{releasenotes.ht}{January 25, 2008 Release Notes}
+\pagepic{ps/v71january2008.eps}{january2008}
+\pagefrom{What's New in Axiom}{releaseNotes}
 <<releasenotes.ht>>=
 \begin{page}{january2008}{January 25, 2008 Release Notes}
 \beginscroll
@@ -660,6 +811,8 @@ Patches released
 
 @
 \pagehead{november2007}{releasenotes.ht}{November 23, 2007 Release Notes}
+\pagepic{ps/v71november2007.eps}{november2007}
+\pagefrom{What's New in Axiom}{releaseNotes}
 <<releasenotes.ht>>=
 \begin{page}{november2007}{November 23, 2007 Release Notes}
 \beginscroll
@@ -848,6 +1001,8 @@ ADD )HELP FACILITY
 
 @
 \pagehead{feb2005}{releasenotes.ht}{Feature Complete Release Feb 2005}
+\pagepic{ps/v71feb2005.eps}{feb2005}
+\pagefrom{What's New in Axiom}{releaseNotes}
 <<releasenotes.ht>>=
 \begin{page}{feb2005}{Feature Complete Release Feb 2005}
 \beginscroll
diff --git a/changelog b/changelog
index 6ab41bf..c5aab40 100644
--- a/changelog
+++ b/changelog
@@ -1,3 +1,11 @@
+20080727 tpd books/bookvol7.1.pamphlet update What's New branch
+20080727 tpd books/ps/v71feb2005.eps added
+20080727 tpd books/ps/v71january2008.eps added
+20080727 tpd books/ps/v71july2008.eps added
+20080727 tpd books/ps/v71march2008.eps added
+20080727 tpd books/ps/v71may2008.eps added
+20080727 tpd books/ps/v71november2007.eps added
+20080727 tpd books/ps/v71onlineinformation.eps added
 20080725 tpd books/bookvol0 fix copyright latex line overflows
 20080725 tpd books/bookvol1 fix copyright latex line overflows
 20080725 tpd books/bookvol2 fix copyright latex line overflows