Commit 0910186a authored by Dave Cooper's avatar Dave Cooper
Browse files

starting up on tutorial manual again...

parent b6eaec38
(asdf:defsystem #:gdl-robot
:description
"Auto-generated asdf defsys from Genworks GDL cl-lite."
:author
"Genworks and Dave Cooper unless otherwise indicated"
:license
"AGPL unless otherwise indicated"
:serial
t
:version
"2012111900"
:depends-on
nil
:components
((:file "source/package") (:file "source/assembly")))
\ No newline at end of file
(asdf:defsystem #:gdl-tutorial :description
"Auto-generated asdf defsys from Genworks GDL cl-lite."
:author
"Genworks and Dave Cooper unless otherwise indicated"
:license "AGPL unless otherwise indicated" :serial t
:version "2012101900" :depends-on (:gdl-dom)
:components
((:file "source/package") (:file "source/parameters")
(:file "source/introduction")
(:file "source/installation")
(:file "source/basic-operation")
(:file "source/assembly")))
\ No newline at end of file
(asdf:defsystem #:gdl-tutorial
:description
"Auto-generated asdf defsys from Genworks GDL cl-lite."
:author
"Genworks and Dave Cooper unless otherwise indicated"
:license
"AGPL unless otherwise indicated"
:serial
t
:version
"2012111900"
:depends-on
(:gdl-dom)
:components
((:file "source/package") (:file "source/parameters")
(:file "source/introduction") (:file "source/installation")
(:file "source/basic-operation") (:file "source/upgrade-notes")
(:file "source/assembly")))
\ No newline at end of file
......@@ -103,7 +103,4 @@
\newlabel{sec:customizingyourenvironment}{{3.4}{17}{Customizing your Environment\relax }{section.3.4}{}}
\@writefile{toc}{\contentsline {section}{\numberline {3.5}Saving the World}{17}{section.3.5}}
\newlabel{sec:savingtheworld}{{3.5}{17}{Saving the World\relax }{section.3.5}{}}
\@writefile{toc}{\contentsline {chapter}{\numberline {4}This chapter lists the typical modifications you will want to consider for upgrading from GDL 1580 to Gendl 1581.}{19}{chapter.4}}
\@writefile{lof}{\addvspace {10\p@ }}
\@writefile{lot}{\addvspace {10\p@ }}
\newlabel{chap:thischapterliststhetypicalmodificationsyouwillwantto considerforupgradingfromgdl1580togendl1581.}{{4}{19}{This chapter lists the typical modifications you will want to consider for upgrading from GDL 1580 to Gendl 1581}{chapter.4}{}}
\newlabel{chap:upgradenotes}{{3.5}{19}{Upgrade Notes\relax }{chapter*.5}{}}
This is pdfTeX, Version 3.1415926-1.40.10 (TeX Live 2009/Debian) (format=pdflatex 2011.11.28) 26 OCT 2012 11:25
This is pdfTeX, Version 3.1415926-1.40.10 (TeX Live 2009/Debian) (format=pdflatex 2011.11.28) 19 NOV 2012 15:03
entering extended mode
%&-line parsing enabled.
**tutorial.tex
......@@ -327,22 +327,23 @@ LaTeX Font Info: External font `cmex10' loaded for size
] (./tutorial.toc
LaTeX Font Info: External font `cmex10' loaded for size
(Font) <10.95> on input line 2.
[3
])
)
\tf@toc=\write5
\openout5 = `tutorial.toc'.
[4]
[3
] [4
]
Chapter 1.
[1
] [2] [3] [4
]
Chapter 2.
<../images/gendl-installation.png, id=229, 127.40933pt x 70.12866pt>
<../images/gendl-installation.png, id=223, 127.40933pt x 70.12866pt>
File: ../images/gendl-installation.png Graphic file (type png)
<use ../images/gendl-installation.png> [5]
......@@ -352,11 +353,11 @@ man-ager, right-mouse on the \OT1/cmtt/m/n/10.95 run-gdl.bat
[]
[6 <../images/gendl-installation.png (PNG copy)>]
<../images/mini-buffer.png, id=257, 687.56876pt x 613.29124pt>
<../images/mini-buffer.png, id=251, 687.56876pt x 613.29124pt>
File: ../images/mini-buffer.png Graphic file (type png)
<use ../images/mini-buffer.png>
<../images/genworks-gendl-console.png, id=259, 318.52333pt x 212.52733pt>
<../images/genworks-gendl-console.png, id=253, 318.52333pt x 212.52733pt>
File: ../images/genworks-gendl-console.png Graphic file (type png)
<use ../images/genworks-gendl-console.png>
......@@ -372,11 +373,11 @@ Overfull \hbox (16.66708pt too wide) in paragraph at lines 457--458
ys-tem, type: \OT1/cmtt/m/n/10.95 (ql:quickload :genworks-gdl)
[]
<../images/tasty-robot.png, id=279, 542.29266pt x 441.11467pt>
<../images/tasty-robot.png, id=273, 542.29266pt x 441.11467pt>
File: ../images/tasty-robot.png Graphic file (type png)
<use ../images/tasty-robot.png>
<../images/tasty-robot-x3dom.png, id=280, 543.36333pt x 440.044pt>
<../images/tasty-robot-x3dom.png, id=274, 543.36333pt x 440.044pt>
File: ../images/tasty-robot-x3dom.png Graphic file (type png)
<use ../images/tasty-robot-x3dom.png> [9] [10 <../images/tasty-robot.png (PNG c
......@@ -432,17 +433,25 @@ Overfull \hbox (6.79999pt too wide) in paragraph at lines 897--898
[17] [18
]
Chapter 4.
[19]
Overfull \hbox (352.43867pt too wide) has occurred while \output is active
\OT1/cmr/m/n/10.95 20 \OT1/cmr/m/sl/10.95 CHAPTER 4. THIS CHAPTER LISTS THE TY
PICAL MODIFICATIONS YOU WILL WANT TO CONSIDER FOR UPGRADING FROM GDL 1580 TO GE
NDL 1581.
[]
[20
LaTeX Warning: Reference `subsec:usingquicklisp' on page 19 undefined on input
line 946.
! Undefined control sequence.
l.957 \textt
{"3rdpty/"} directory are no longer needed or available. Instead...
The control sequence at the end of the top line
of your error message was never \def'ed. If you have
misspelled it (e.g., `\hobx'), type `I' and the correct
spelling (e.g., `I\hbox'). Otherwise just continue,
and I'll forget about whatever was undefined.
LaTeX Warning: Reference `subsec:usingquicklisp' on page 19 undefined on input
line 959.
[19] [20] (./tutorial.ind [21
] (./tutorial.ind [21
]) (./tutorial.aux)
......@@ -455,12 +464,12 @@ LaTeX Warning: There were undefined references.
)
Here is how much of TeX's memory you used:
5170 strings out of 494985
76442 string characters out of 1181033
145443 words of memory out of 3000000
76371 string characters out of 1181033
145348 words of memory out of 3000000
8136 multiletter control sequences out of 15000+50000
12647 words of font info for 44 fonts, out of 3000000 for 9000
73 hyphenation exceptions out of 8191
38i,8n,36p,384b,395s stack positions out of 5000i,500n,10000p,200000b,50000s
38i,8n,36p,362b,395s stack positions out of 5000i,500n,10000p,200000b,50000s
</home/dcooper8/.texmf-var/fonts/pk/ljfour/jknappen/ec/tcrm1095.600pk> </hom
e/dcooper8/.texmf-var/fonts/pk/ljfour/jknappen/ec/tcrm0900.600pk></usr/share/te
xmf-texlive/fonts/type1/public/amsfonts/cm/cmbx10.pfb></usr/share/texmf-texlive
......@@ -475,9 +484,9 @@ c/amsfonts/cm/cmsl10.pfb></usr/share/texmf-texlive/fonts/type1/public/amsfonts/
cm/cmsy10.pfb></usr/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmti10.p
fb></usr/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmtt10.pfb></usr/sh
are/texmf-texlive/fonts/type1/public/amsfonts/cm/cmtt9.pfb>
Output written on tutorial.pdf (25 pages, 511748 bytes).
Output written on tutorial.pdf (25 pages, 511461 bytes).
PDF statistics:
507 PDF objects out of 1000 (max. 8388607)
504 PDF objects out of 1000 (max. 8388607)
142 named destinations out of 1000 (max. 500000)
290 words of extra memory for PDF output out of 10000 (max. 10000000)
282 words of extra memory for PDF output out of 10000 (max. 10000000)
......@@ -30,4 +30,3 @@
\BOOKMARK [2][-]{subsection.3.3.2}{Source Files within a source/ subdirectory}{section.3.3}
\BOOKMARK [1][-]{section.3.4}{Customizing your Environment}{chapter.3}
\BOOKMARK [1][-]{section.3.5}{Saving the World}{chapter.3}
\BOOKMARK [0][-]{chapter.4}{This chapter lists the typical modifications you will want to consider for upgrading from GDL 1580 to Gendl 1581.}{}
......@@ -923,28 +923,66 @@ for example by loading definitions and settings into your Gendl
fonts, colors, and default buffers (to name a few) for your emacs
editing environment.
\chapter{This chapter lists the typical modifications you will want to
consider for upgrading from GDL 1580 to Gendl 1581.}
\chapter*{Upgrade Notes}
\label{chap:thischapterliststhetypicalmodificationsyouwillwantto
considerforupgradingfromgdl1580togendl1581.}
\label{chap:upgradenotes}
GDL 1580 marked the end of a major branch of GDL development,
and 1581 was actually a major new version. With 1581, an open-source
version was released, and eventually the name was changed to
Gendl.
This chapter lists the typical modifications you will want to consider
for upgrading from GDL 1580 to Gendl 1582.
\begin{itemize}
\item (update-gdl ..) not yet available for 1581.
\item (register-asdf-systems no longer needed or available) - If you want your own asdf systems,
use (ql:quickload ...) for 3rdpty files.
\item system-wide gdlinit.cl in application directory, personal one in home directory.
\item Slime debugging is different - refer to Slime intro
\item color-themes -- M-x color-theme-select
\item Gendl files can end with .lisp or .gdl
\item (update-gdl ..) is not yet available for 1582. Instead
of updating incrementally with patches, Gendl 1582 is released on a
monthly basis in conjunction with Quicklisp releases. Updating
quicklisp involves downloading a full Genworks source code tree and
running a build script. Information on this procedure is provided in
Section
\ref{subsec:usingquicklisp}.
\item (make-gdl-app ..) not yet available for 1582. We are
preparing the Enterprise Edition of 1582 which will include the
make-gdl-app function, which creates Runtime applications without the
compiler or Gendl development facilities. If you are an Enterprise
licensee, are ready to release Runtime applications on 1582, and you
have not received information on the Enterprise Edition, please
contact support@genworks.com
\item (register-asdf-systems) and the
\textt{"3rdpty/"} directory are no longer needed or available. Instead, we depend on the Quicklisp
system. Details of Quicklisp are available at \href{http://www.quicklisp.org}. See Section
\ref{subsec:usingquicklisp} for information about how to use Quicklisp with Gendl.
\item There is a system-wide gdlinit.cl in the application
directory, and this may have some default information which
ships with Gendl. There is a personal one in home directory,
which you should modify if you want to customize anything.
\item Slime debugging is different from the ELI emacs debugger. The main thing to know is
to press ``a'' or ``q'' to pop out of the current error. Full documentation for the Slime debug mode
is available with the \href{http://common-lisp.net/project/slime/doc/html/Debugger.html}{Slime documentation}.
\item color-themes -- Gendl now ships with the Emacs
color-theme package. You can select a different color theme with \texttt{M-x color-theme-select}. Press [Enter] or middle-mouse on a color theme to apply it.
\item Gendl files can now end with \texttt{.lisp} or \texttt{.gdl}. The new \texttt{.gdl} extension will work for emacs Lisp mode and will work with
cl-lite, ASDF, and Quicklisp for including source files in application systems. We recommend migrating
to the new \texttt{.gdl} extension for files containing \texttt{define-object}, \texttt{define-format}, and \texttt{define-lens} forms, and any other future toplevel defining forms introduced by Gendl, in order to distinguish
from files containing raw Common Lisp code.
\item in gdlAjax, HTML for a sheet-section is given in the slot called \texttt{inner-html} instead of \texttt{main-view}. This name change was made to clarify what exactly is
expected in this slot -- it is the innerHTML of the page
division represented by the current sheet-section. If you
want to make your code back-compatible with GDL 1580, you can
use the following form in place of old occurences of \texttt{main-view}:
\begin{verbatim}... #+allegro-v8.1 main-view #-allegro-v8.1 inner-html ...
\end{verbatim}
\end{itemize}
......
......@@ -33,4 +33,3 @@
\contentsline {subsubsection}{Enforcing Ordering}{17}{section*.4}
\contentsline {section}{\numberline {3.4}Customizing your Environment}{17}{section.3.4}
\contentsline {section}{\numberline {3.5}Saving the World}{17}{section.3.5}
\contentsline {chapter}{\numberline {4}This chapter lists the typical modifications you will want to consider for upgrading from GDL 1580 to Gendl 1581.}{19}{chapter.4}
......@@ -328,11 +328,20 @@ editing environment."
((:section :title "Saving the World")
" You may customize your environment in several different ways,
for example by loading definitions and settings into your Gendl
``world'' automatically when the system starts, and by specifying
fonts, colors, and default buffers (to name a few) for your emacs
editing environment."
" Saving the world refers to a technique of saving a complete
binary image of your Gendl ``world'' which contains all the currently
compiled and loaded definitions and settings. This allows you to
start up a saved world almost instantly, without having to reload all
the definitions. You can then incrementally compile and load just the
particular definitions which you are working on for your development
session.
To save a world, follow these steps:
"
)
......
......@@ -19,4 +19,4 @@
;; <http://www.gnu.org/licenses/>.
;;
("package" "parameters" "introduction" "installation" "basic-operation")
\ No newline at end of file
("package" "parameters" "introduction" "installation" "basic-operation" "upgrade-notes")
\ No newline at end of file
......@@ -22,16 +22,90 @@
(in-package :gendl-doc)
(defparameter *upgrade-notes*
`((:chapter :title "This chapter lists the typical modifications you will want to
consider for upgrading from GDL 1580 to Gendl 1581.")
`((:chapter* :title "Upgrade Notes")
"GDL 1580 marked the end of a major branch of GDL development,
and 1581 was actually a major new version. With 1581, an open-source
version was released, and eventually the name was changed to
Gendl.
This chapter lists the typical modifications you will want to consider
for upgrading from GDL 1580 to Gendl 1582."
((:list :style :itemize)
(:item "(update-gdl ..) not yet available for 1581.")
(:item "(register-asdf-systems no longer needed or available) - If you want your own asdf systems,
use (ql:quickload ...) for 3rdpty files.")
(:item "system-wide gdlinit.cl in application directory, personal one in home directory.")
(:item "Slime debugging is different - refer to Slime intro")
(:item "color-themes -- M-x color-theme-select")
(:item "Gendl files can end with .lisp or .gdl"))))
(:item "(update-gdl ..) is not yet available for 1582. Instead
of updating incrementally with patches, Gendl 1582 is released on a
monthly basis in conjunction with Quicklisp releases. Updating
quicklisp involves downloading a full Genworks source code tree and
running a build script. Information on this procedure is provided in
Section "
(:ref "subsec:usingquicklisp")
".")
(:item "(make-gdl-app ..) not yet available for 1582. We are
preparing the Enterprise Edition of 1582 which will include the
make-gdl-app function, which creates Runtime applications without the
compiler or Gendl development facilities. If you are an Enterprise
licensee, are ready to release Runtime applications on 1582, and you
have not received information on the Enterprise Edition, please
contact support@genworks.com")
(:item "(register-asdf-systems) and the "
(:textt "\"3rdpty/\"")
" directory are no longer needed or available. Instead, we depend on the Quicklisp
system. Details of Quicklisp are available at "
(:href "http://www.quicklisp.org")
". See Section "
(:ref "subsec:usingquicklisp")
" for information about how to use Quicklisp with Gendl.")
(:item "There is a system-wide gdlinit.cl in the application
directory, and this may have some default information which
ships with Gendl. There is a personal one in home directory,
which you should modify if you want to customize anything.")
(:item "Slime debugging is different from the ELI emacs debugger. The main thing to know is
to press ``a'' or ``q'' to pop out of the current error. Full documentation for the Slime debug mode
is available with the "
(:href "http://common-lisp.net/project/slime/doc/html/Debugger.html" "Slime documentation")
".")
(:item "color-themes -- Gendl now ships with the Emacs
color-theme package. You can select a different color theme with "
(:texttt "M-x color-theme-select")
". Press [Enter] or middle-mouse on a color theme to apply it.")
(:item "Gendl files can now end with "
(:texttt ".lisp")
" or "
(:texttt ".gdl")
". The new "
(:texttt ".gdl")
" extension will work for emacs Lisp mode and will work with
cl-lite, ASDF, and Quicklisp for including source files in application systems. We recommend migrating
to the new "
(:texttt ".gdl")
" extension for files containing "
(:texttt "define-object")
", "
(:texttt "define-format")
", and "
(:texttt "define-lens")
" forms, and any other future toplevel defining forms introduced by Gendl, in order to distinguish
from files containing raw Common Lisp code.")
(:item "in gdlAjax, HTML for a sheet-section is given in the slot called "
(:texttt "inner-html")
" instead of "
(:texttt "main-view")
". This name change was made to clarify what exactly is
expected in this slot -- it is the innerHTML of the page
division represented by the current sheet-section. If you
want to make your code back-compatible with GDL 1580, you can
use the following form in place of old occurences of "
(:texttt "main-view")
": "
(:verbatim "... #+allegro-v8.1 main-view #-allegro-v8.1 inner-html ...")))))
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment