Commit 03774b93 authored by Dave Cooper's avatar Dave Cooper
Browse files

Fixed tree status bug in tasty. Started next section of new tutorial manual in...

Fixed tree status bug in tasty. Started next section of new tutorial manual in documentation/tutorial.
parent 43defc31
......@@ -221,16 +221,6 @@ to the src/ directory distributed with GDL.
arm-angle-right arm-angle-left
pincer-distance-left pincer-distance-right))
(center-sphere :type 'sphere :radius 0.1)
(rob-text :type 'general-note
:display-controls (list :billboard t)
:orientation (alignment :top (the (face-normal-vector :rear)))
:strings "Bob"
:center (the center))
))
......
......@@ -18,16 +18,18 @@
\@writefile{lof}{\addvspace {10\p@ }}
\@writefile{lot}{\addvspace {10\p@ }}
\newlabel{chap:introduction}{{1}{1}{Introduction\relax }{chapter.1}{}}
\@writefile{toc}{\contentsline {section}{\numberline {1.1}Knowledge Base Concepts According to Genworks}{1}{section.1.1}}
\newlabel{sec:knowledgebaseconceptsaccordingtogenworks}{{1.1}{1}{Knowledge Base Concepts According to Genworks\relax }{section.1.1}{}}
\@writefile{toc}{\contentsline {section}{\numberline {1.2}Goals for this Tutorial}{1}{section.1.2}}
\newlabel{sec:goalsforthistutorial}{{1.2}{1}{Goals for this Tutorial\relax }{section.1.2}{}}
\@writefile{toc}{\contentsline {section}{\numberline {1.3}What is GenDL?}{2}{section.1.3}}
\newlabel{sec:whatisgendl?}{{1.3}{2}{What is GenDL?\relax }{section.1.3}{}}
\@writefile{toc}{\contentsline {section}{\numberline {1.4}Why GDL (what is GDL good for?)}{2}{section.1.4}}
\newlabel{sec:whygdl(whatisgdlgoodfor?)}{{1.4}{2}{Why GDL (what is GDL good for?)\relax }{section.1.4}{}}
\@writefile{toc}{\contentsline {section}{\numberline {1.5}What GDL is not}{3}{section.1.5}}
\newlabel{sec:whatgdlisnot}{{1.5}{3}{What GDL is not\relax }{section.1.5}{}}
\@writefile{toc}{\contentsline {section}{\numberline {1.1}Welcome}{1}{section.1.1}}
\newlabel{sec:welcome}{{1.1}{1}{Welcome\relax }{section.1.1}{}}
\@writefile{toc}{\contentsline {section}{\numberline {1.2}Knowledge Base Concepts According to Genworks}{1}{section.1.2}}
\newlabel{sec:knowledgebaseconceptsaccordingtogenworks}{{1.2}{1}{Knowledge Base Concepts According to Genworks\relax }{section.1.2}{}}
\@writefile{toc}{\contentsline {section}{\numberline {1.3}Goals for this Tutorial}{1}{section.1.3}}
\newlabel{sec:goalsforthistutorial}{{1.3}{1}{Goals for this Tutorial\relax }{section.1.3}{}}
\@writefile{toc}{\contentsline {section}{\numberline {1.4}What is GenDL?}{2}{section.1.4}}
\newlabel{sec:whatisgendl?}{{1.4}{2}{What is GenDL?\relax }{section.1.4}{}}
\@writefile{toc}{\contentsline {section}{\numberline {1.5}Why GDL (what is GDL good for?)}{3}{section.1.5}}
\newlabel{sec:whygdl(whatisgdlgoodfor?)}{{1.5}{3}{Why GDL (what is GDL good for?)\relax }{section.1.5}{}}
\@writefile{toc}{\contentsline {section}{\numberline {1.6}What GDL is not}{3}{section.1.6}}
\newlabel{sec:whatgdlisnot}{{1.6}{3}{What GDL is not\relax }{section.1.6}{}}
\@writefile{toc}{\contentsline {chapter}{\numberline {2}Installation}{5}{chapter.2}}
\@writefile{lof}{\addvspace {10\p@ }}
\@writefile{lot}{\addvspace {10\p@ }}
......@@ -40,13 +42,41 @@
\newlabel{subsec:unpackthedistribution}{{2.1.2}{5}{Unpack the Distribution\relax }{subsection.2.1.2}{}}
\@writefile{lof}{\contentsline {figure}{\numberline {2.1}{\ignorespaces Several Gendl versions and one GPL }}{6}{figure.2.1}}
\newlabel{fig:gendl-installation}{{2.1}{6}{Several Gendl versions and one GPL\relax }{figure.2.1}{}}
\@writefile{toc}{\contentsline {subsection}{\numberline {2.1.3}Test your Installation}{6}{subsection.2.1.3}}
\newlabel{subsec:testyourinstallation}{{2.1.3}{6}{Test your Installation\relax }{subsection.2.1.3}{}}
\@writefile{toc}{\contentsline {subsection}{\numberline {2.1.4}Make a Desktop Shortcut}{7}{subsection.2.1.4}}
\newlabel{subsec:makeadesktopshortcut}{{2.1.4}{7}{Make a Desktop Shortcut\relax }{subsection.2.1.4}{}}
\@writefile{toc}{\contentsline {subsection}{\numberline {2.1.5}Populate your Initialization File}{7}{subsection.2.1.5}}
\newlabel{subsec:populateyourinitializationfile}{{2.1.5}{7}{Populate your Initialization File\relax }{subsection.2.1.5}{}}
\@writefile{toc}{\contentsline {section}{\numberline {2.2}Installation of open-source Gendl}{7}{section.2.2}}
\newlabel{sec:installationofopen-sourcegendl}{{2.2}{7}{Installation of open-source Gendl\relax }{section.2.2}{}}
\@writefile{toc}{\contentsline {subsection}{\numberline {2.2.1}Install and Configure your Common Lisp environment}{7}{subsection.2.2.1}}
\newlabel{subsec:installandconfigureyourcommonlispenvironment}{{2.2.1}{7}{Install and Configure your Common Lisp environment\relax }{subsection.2.2.1}{}}
\@writefile{toc}{\contentsline {subsection}{\numberline {2.1.3}Make a Desktop Shortcut}{6}{subsection.2.1.3}}
\newlabel{subsec:makeadesktopshortcut}{{2.1.3}{6}{Make a Desktop Shortcut\relax }{subsection.2.1.3}{}}
\@writefile{toc}{\contentsline {subsection}{\numberline {2.1.4}Populate your Initialization File}{6}{subsection.2.1.4}}
\newlabel{subsec:populateyourinitializationfile}{{2.1.4}{6}{Populate your Initialization File\relax }{subsection.2.1.4}{}}
\@writefile{toc}{\contentsline {section}{\numberline {2.2}Installation of open-source Gendl}{6}{section.2.2}}
\newlabel{sec:installationofopen-sourcegendl}{{2.2}{6}{Installation of open-source Gendl\relax }{section.2.2}{}}
\@writefile{toc}{\contentsline {subsection}{\numberline {2.2.1}Install and Configure your Common Lisp environment}{6}{subsection.2.2.1}}
\newlabel{subsec:installandconfigureyourcommonlispenvironment}{{2.2.1}{6}{Install and Configure your Common Lisp environment\relax }{subsection.2.2.1}{}}
\@writefile{toc}{\contentsline {subsection}{\numberline {2.2.2}Load and Configure Quicklisp}{7}{subsection.2.2.2}}
\newlabel{subsec:loadandconfigurequicklisp}{{2.2.2}{7}{Load and Configure Quicklisp\relax }{subsection.2.2.2}{}}
\@writefile{toc}{\contentsline {section}{\numberline {2.3}System Startup and Testing}{7}{section.2.3}}
\newlabel{sec:systemstartupandtesting}{{2.3}{7}{System Startup and Testing\relax }{section.2.3}{}}
\@writefile{toc}{\contentsline {subsection}{\numberline {2.3.1}System Startup}{7}{subsection.2.3.1}}
\newlabel{subsec:systemstartup}{{2.3.1}{7}{System Startup\relax }{subsection.2.3.1}{}}
\@writefile{toc}{\contentsline {subsubsection}{Startup of prepackaged Gendl distribution}{7}{section*.2}}
\newlabel{subsubsec:startupofprepackagedgendldistribution}{{2.3.1}{7}{Startup of prepackaged Gendl distribution\relax }{section*.2}{}}
\@writefile{lof}{\contentsline {figure}{\numberline {2.2}{\ignorespaces The mini-buffer in Emacs}}{8}{figure.2.2}}
\newlabel{fig:mini-buffer}{{2.2}{8}{The mini-buffer in Emacs\relax }{figure.2.2}{}}
\@writefile{lof}{\contentsline {figure}{\numberline {2.3}{\ignorespaces Genworks Gendl Console}}{8}{figure.2.3}}
\newlabel{fig:genworks-gendl-console}{{2.3}{8}{Genworks Gendl Console\relax }{figure.2.3}{}}
\@writefile{toc}{\contentsline {subsubsection}{Startup of open-source Gendl distribution}{9}{section*.3}}
\newlabel{subsubsec:startupofopen-sourcegendldistribution}{{2.3.1}{9}{Startup of open-source Gendl distribution\relax }{section*.3}{}}
\@writefile{toc}{\contentsline {subsection}{\numberline {2.3.2}Basic System Test}{9}{subsection.2.3.2}}
\newlabel{subsec:basicsystemtest}{{2.3.2}{9}{Basic System Test\relax }{subsection.2.3.2}{}}
\@writefile{lof}{\contentsline {figure}{\numberline {2.4}{\ignorespaces Robot displayed in Tasty}}{10}{figure.2.4}}
\newlabel{fig:tasty-robot}{{2.4}{10}{Robot displayed in Tasty\relax }{figure.2.4}{}}
\@writefile{lof}{\contentsline {figure}{\numberline {2.5}{\ignorespaces Robot x3dom}}{10}{figure.2.5}}
\newlabel{fig:tasty-robot-x3dom}{{2.5}{10}{Robot x3dom\relax }{figure.2.5}{}}
\@writefile{toc}{\contentsline {subsection}{\numberline {2.3.3}Full Regression Test}{11}{subsection.2.3.3}}
\newlabel{subsec:fullregressiontest}{{2.3.3}{11}{Full Regression Test\relax }{subsection.2.3.3}{}}
\@writefile{toc}{\contentsline {section}{\numberline {2.4}Getting Help and Support}{11}{section.2.4}}
\newlabel{sec:gettinghelpandsupport}{{2.4}{11}{Getting Help and Support\relax }{section.2.4}{}}
\@writefile{toc}{\contentsline {chapter}{\numberline {3}Basic Operation of the Gendl Environment}{13}{chapter.3}}
\@writefile{lof}{\addvspace {10\p@ }}
\@writefile{lot}{\addvspace {10\p@ }}
\newlabel{chap:basicoperationofthegendlenvironment}{{3}{13}{Basic Operation of the Gendl Environment\relax }{chapter.3}{}}
\@writefile{toc}{\contentsline {section}{\numberline {3.1}Startup and Shutdown}{13}{section.3.1}}
\newlabel{sec:startupandshutdown}{{3.1}{13}{Startup and Shutdown\relax }{section.3.1}{}}
......@@ -2,7 +2,7 @@
\indexentry{Knowledge Base System|hyperpage}{1}
\indexentry{Caching|hyperpage}{1}
\indexentry{Dependency tracking|hyperpage}{1}
\indexentry{Common Lisp|hyperpage}{1}
\indexentry{Common Lisp|hyperpage}{2}
\indexentry{Basic Lisp Techniques|hyperpage}{2}
\indexentry{compiled language!benefits of|hyperpage}{2}
\indexentry{macros!code-expanding|hyperpage}{2}
......
......@@ -5,7 +5,7 @@
\indexspace
\item Caching, \hyperpage{1}
\item Common Lisp, \hyperpage{1}
\item Common Lisp, \hyperpage{2}
\item compiled language
\subitem benefits of, \hyperpage{2}
......
This is pdfTeX, Version 3.1415926-2.3-1.40.12 (TeX Live 2011/MacPorts 2011_5) (format=pdflatex 2012.4.16) 11 OCT 2012 19:39
This is pdfTeX, Version 3.1415926-2.3-1.40.12 (TeX Live 2011/MacPorts 2011_5) (format=pdflatex 2012.4.16) 15 OCT 2012 16:17
entering extended mode
restricted \write18 enabled.
%&-line parsing enabled.
......@@ -300,113 +300,95 @@ LaTeX Font Info: External font `cmex10' loaded for size
]
Chapter 1.
LaTeX Font Info: Font shape `OMS/cmr/m/n' in size <10.95> not available
(Font) Font shape `OMS/cmsy/m/n' tried instead on input line 90.
(Font) Font shape `OMS/cmsy/m/n' tried instead on input line 100.
[1
] [2] [3] [4
]
Chapter 2.
Overfull \hbox (8.16745pt too wide) in paragraph at lines 251--256
\OT1/cmr/m/n/10.95 video is also avail-able in the Doc-u-men-ta-tion sec-tion o
f the hrefhttp://genworks.com/newsiteGenworks
[]
<../images/gendl-installation.png, id=134, 127.40933pt x 70.12866pt>
<../images/gendl-installation.png, id=179, 127.40933pt x 70.12866pt>
File: ../images/gendl-installation.png Graphic file (type png)
<use ../images/gendl-installation.png>
Package pdftex.def Info: ../images/gendl-installation.png used on input line 27
1.
Package pdftex.def Info: ../images/gendl-installation.png used on input line 28
2.
(pdftex.def) Requested size: 127.40901pt x 70.12848pt.
[5]
LaTeX Warning: Reference `fig:mini-buffer' on page 6 undefined on input line 29
7.
Overfull \hbox (0.60901pt too wide) in paragraph at lines 309--311
[]\OT1/cmr/m/n/10.95 On Linux or Ma-cOS, there will be a sep-a-rate Emacs buffe
r (avail-able through Emacs' ``Buffers''
Overfull \hbox (21.10905pt too wide) in paragraph at lines 301--302
[]\OT1/cmr/m/n/10.95 Using the ``My Com-puter'' or ``Com-puter'' Win-dows file
man-ager, right-mouse on the \OT1/cmtt/m/n/10.95 run-gdl.bat
[]
[6 <../images/gendl-installation.png>]
LaTeX Font Info: Try loading font information for OMS+cmtt on input line 381
.
LaTeX Font Info: No file OMScmtt.fd. on input line 381.
<../images/mini-buffer.png, id=207, 687.56876pt x 613.29124pt>
File: ../images/mini-buffer.png Graphic file (type png)
<use ../images/mini-buffer.png>
Package pdftex.def Info: ../images/mini-buffer.png used on input line 399.
(pdftex.def) Requested size: 216.80562pt x 216.8075pt.
LaTeX Font Warning: Font shape `OMS/cmtt/m/n' undefined
(Font) using `OMS/cmsy/m/n' instead
(Font) for symbol `textbullet' on input line 381.
<../images/genworks-gendl-console.png, id=209, 318.52333pt x 212.52733pt>
File: ../images/genworks-gendl-console.png Graphic file (type png)
<use ../images/genworks-gendl-console.png>
Package pdftex.def Info: ../images/genworks-gendl-console.png used on input lin
e 412.
(pdftex.def) Requested size: 318.52254pt x 212.5268pt.
Overfull \hbox (29.01247pt too wide) in paragraph at lines 383--384
[]\OT1/cmtt/m/n/10.95 LispWorks (commercial product from LispWorks Ltd, free Pe
rsonal Edition available)
[]
Overfull \hbox (17.51509pt too wide) in paragraph at lines 385--386
[]\OT1/cmtt/m/n/10.95 Steel Bank Common Lisp (SBCL) (free open-source project w
ith permissive license)
[]
Overfull \hbox (7.14003pt too wide) in paragraph at lines 389--393
[]\OT1/cmtt/m/n/10.95 Please refer to the documentation for each of these syste
ms for full information
Overfull \hbox (0.60901pt too wide) in paragraph at lines 431--433
[]\OT1/cmr/m/n/10.95 On Linux or Ma-cOS, there will be a sep-a-rate Emacs buffe
r (avail-able through Emacs' ``Buffers''
[]
Overfull \hbox (1.6374pt too wide) in paragraph at lines 389--393
\OT1/cmtt/m/n/10.95 on installing and configuring the environment. Typically th
is will include a text
[7] [8 <../images/mini-buffer.png> <../images/genworks-gendl-console.png>]
Overfull \hbox (16.66708pt too wide) in paragraph at lines 456--457
[]\OT1/cmr/m/n/10.95 After Quick-lisp is in-stalled and ini-tial-ized in your s
ys-tem, type: \OT1/cmtt/m/n/10.95 (ql:quickload :genworks-gdl)
[]
<../images/tasty-robot.png, id=229, 542.29266pt x 441.11467pt>
File: ../images/tasty-robot.png Graphic file (type png)
Overfull \hbox (1.6374pt too wide) in paragraph at lines 389--393
\OT1/cmtt/m/n/10.95 editor, either Gnu Emacs with Superior Lisp Interaction Mod
e for Emacs (Slime), or
[]
<use ../images/tasty-robot.png>
Package pdftex.def Info: ../images/tasty-robot.png used on input line 493.
(pdftex.def) Requested size: 216.81392pt x 216.8077pt.
<../images/tasty-robot-x3dom.png, id=230, 543.36333pt x 440.044pt>
File: ../images/tasty-robot-x3dom.png Graphic file (type png)
Overfull \hbox (13.13478pt too wide) in paragraph at lines 389--393
\OT1/cmtt/m/n/10.95 a built-in text editing and development environment which c
omes with the Common Lisp
[]
<use ../images/tasty-robot-x3dom.png>
Package pdftex.def Info: ../images/tasty-robot-x3dom.png used on input line 504
.
(pdftex.def) Requested size: 216.81084pt x 216.8119pt.
[9] [10 <../images/tasty-robot.png> <../images/tasty-robot-x3dom.png>] [11] [1
2
[7] [8
]
Chapter 3.
[13] [14
] (./tutorial.ind [9
] (./tutorial.ind [15
])
Package atveryend Info: Empty hook `BeforeClearDocument' on input line 402.
Package atveryend Info: Empty hook `AfterLastShipout' on input line 402.
Package atveryend Info: Empty hook `BeforeClearDocument' on input line 617.
Package atveryend Info: Empty hook `AfterLastShipout' on input line 617.
(./tutorial.aux)
Package atveryend Info: Executing hook `AtVeryEndDocument' on input line 402.
Package atveryend Info: Executing hook `AtEndAfterFileList' on input line 402.
Package atveryend Info: Executing hook `AtVeryEndDocument' on input line 617.
Package atveryend Info: Executing hook `AtEndAfterFileList' on input line 617.
Package rerunfilecheck Info: File `tutorial.out' has not changed.
(rerunfilecheck) Checksum: B8C4F81559021D46D8B69E43E951A29A;1136.
LaTeX Font Warning: Some font shapes were not available, defaults substituted.
LaTeX Warning: There were undefined references.
Package atveryend Info: Empty hook `AtVeryVeryEnd' on input line 402.
(rerunfilecheck) Checksum: 1E7FAC87274F08F475D3F5CE073B61A0;1696.
Package atveryend Info: Empty hook `AtVeryVeryEnd' on input line 617.
)
Here is how much of TeX's memory you used:
5385 strings out of 494770
80628 string characters out of 3171573
161767 words of memory out of 3000000
8501 multiletter control sequences out of 15000+200000
5456 strings out of 494770
82005 string characters out of 3171573
164517 words of memory out of 3000000
8535 multiletter control sequences out of 15000+200000
11969 words of font info for 42 fonts, out of 3000000 for 9000
134 hyphenation exceptions out of 8191
29i,8n,28p,362b,492s stack positions out of 5000i,500n,10000p,200000b,50000s
29i,8n,28p,362b,419s stack positions out of 5000i,500n,10000p,200000b,50000s
</opt/local/share/texmf-texlive-dist/fonts/type1/public/amsfonts/cm/cmbx10.pf
b></opt/local/share/texmf-texlive-dist/fonts/type1/public/amsfonts/cm/cmbx12.pf
b></opt/local/share/texmf-texlive-dist/fonts/type1/public/amsfonts/cm/cmr10.pfb
......@@ -421,10 +403,10 @@ ocal/share/texmf-texlive-dist/fonts/type1/public/amsfonts/cm/cmsy9.pfb></opt/lo
cal/share/texmf-texlive-dist/fonts/type1/public/amsfonts/cm/cmti10.pfb></opt/lo
cal/share/texmf-texlive-dist/fonts/type1/public/amsfonts/cm/cmtt10.pfb></opt/lo
cal/share/texmf-texlive-dist/fonts/type1/public/amsfonts/cm/cmtt9.pfb>
Output written on tutorial.pdf (13 pages, 194368 bytes).
Output written on tutorial.pdf (19 pages, 380546 bytes).
PDF statistics:
259 PDF objects out of 1000 (max. 8388607)
226 compressed objects within 3 object streams
60 named destinations out of 1000 (max. 500000)
126 words of extra memory for PDF output out of 10000 (max. 10000000)
375 PDF objects out of 1000 (max. 8388607)
330 compressed objects within 4 object streams
95 named destinations out of 1000 (max. 500000)
210 words of extra memory for PDF output out of 10000 (max. 10000000)
\BOOKMARK [0][-]{chapter.1}{Introduction}{}% 1
\BOOKMARK [1][-]{section.1.1}{Knowledge Base Concepts According to Genworks}{chapter.1}% 2
\BOOKMARK [1][-]{section.1.2}{Goals for this Tutorial}{chapter.1}% 3
\BOOKMARK [1][-]{section.1.3}{What is GenDL?}{chapter.1}% 4
\BOOKMARK [1][-]{section.1.4}{Why GDL \(what is GDL good for?\)}{chapter.1}% 5
\BOOKMARK [1][-]{section.1.5}{What GDL is not}{chapter.1}% 6
\BOOKMARK [0][-]{chapter.2}{Installation}{}% 7
\BOOKMARK [1][-]{section.2.1}{Installation of pre-packaged Gendl}{chapter.2}% 8
\BOOKMARK [2][-]{subsection.2.1.1}{Download the Software and retrieve a license key}{section.2.1}% 9
\BOOKMARK [2][-]{subsection.2.1.2}{Unpack the Distribution}{section.2.1}% 10
\BOOKMARK [2][-]{subsection.2.1.3}{Test your Installation}{section.2.1}% 11
\BOOKMARK [2][-]{subsection.2.1.4}{Make a Desktop Shortcut}{section.2.1}% 12
\BOOKMARK [2][-]{subsection.2.1.5}{Populate your Initialization File}{section.2.1}% 13
\BOOKMARK [1][-]{section.1.1}{Welcome}{chapter.1}% 2
\BOOKMARK [1][-]{section.1.2}{Knowledge Base Concepts According to Genworks}{chapter.1}% 3
\BOOKMARK [1][-]{section.1.3}{Goals for this Tutorial}{chapter.1}% 4
\BOOKMARK [1][-]{section.1.4}{What is GenDL?}{chapter.1}% 5
\BOOKMARK [1][-]{section.1.5}{Why GDL \(what is GDL good for?\)}{chapter.1}% 6
\BOOKMARK [1][-]{section.1.6}{What GDL is not}{chapter.1}% 7
\BOOKMARK [0][-]{chapter.2}{Installation}{}% 8
\BOOKMARK [1][-]{section.2.1}{Installation of pre-packaged Gendl}{chapter.2}% 9
\BOOKMARK [2][-]{subsection.2.1.1}{Download the Software and retrieve a license key}{section.2.1}% 10
\BOOKMARK [2][-]{subsection.2.1.2}{Unpack the Distribution}{section.2.1}% 11
\BOOKMARK [2][-]{subsection.2.1.3}{Make a Desktop Shortcut}{section.2.1}% 12
\BOOKMARK [2][-]{subsection.2.1.4}{Populate your Initialization File}{section.2.1}% 13
\BOOKMARK [1][-]{section.2.2}{Installation of open-source Gendl}{chapter.2}% 14
\BOOKMARK [2][-]{subsection.2.2.1}{Install and Configure your Common Lisp environment}{section.2.2}% 15
\BOOKMARK [2][-]{subsection.2.2.2}{Load and Configure Quicklisp}{section.2.2}% 16
\BOOKMARK [1][-]{section.2.3}{System Startup and Testing}{chapter.2}% 17
\BOOKMARK [2][-]{subsection.2.3.1}{System Startup}{section.2.3}% 18
\BOOKMARK [2][-]{subsection.2.3.2}{Basic System Test}{section.2.3}% 19
\BOOKMARK [2][-]{subsection.2.3.3}{Full Regression Test}{section.2.3}% 20
\BOOKMARK [1][-]{section.2.4}{Getting Help and Support}{chapter.2}% 21
\BOOKMARK [0][-]{chapter.3}{Basic Operation of the Gendl Environment}{}% 22
\BOOKMARK [1][-]{section.3.1}{Startup and Shutdown}{chapter.3}% 23
</
......@@ -59,6 +59,16 @@ written consent from Genworks International.}
\section{Welcome}
\label{sec:welcome}
Congratulations on your purchase or download of Genworks Gendl. By investing some of your
valuable time into learning this system, you are investing in your future productivity and you are becoming
part of a quiet revolution. Although you may have come to Genworks Gendl because of an interest in 3D modeling
or mechanical engineering, you will find that a whole new world, and a whole new approach to computing, will
now be at your fingertips.
\section{Knowledge Base Concepts According to Genworks}
\label{sec:knowledgebaseconceptsaccordingtogenworks}
......@@ -210,19 +220,20 @@ Without further ado, then, let's turn the page and get started with some hands-o
\label{chap:installation}
This section will take you through the installation of Gendl
from a prepackaged distribution with the Allegro CL Common Lisp engine
and the Slime IDE (based on Gnu Emacs). Gendl is also available as
open-source software; if you want to use that version, then you are
expected to have your own Common Lisp engine installed and set up, and
your own editing environment. See the README file with the open-source
distribution\footnote{http://github.com/genworks/Genworks-GDL/} for more details on using it.
Follow Section
\ref{sec:installationofpre-packagedgendl} if your email address is registered with Genworks and you will
install a pre-packaged Gendl distribution including its own Common
Lisp engine. Gendl is also available as open-source software\footnote{http://github.com/genworks/Genworks-GDL}; if you
want to use that version, then please refer to Section
\ref{sec:installationofopen-sourcegendl}.
\section{Installation of pre-packaged Gendl}
\label{sec:installationofpre-packagedgendl}
This section will take you through the installation of Gendl
from a prepackaged distribution with the Allegro CL Common Lisp engine
and the Slime IDE (based on Gnu Emacs).
\subsection{Download the Software and retrieve a license key}
......@@ -236,7 +247,7 @@ distribution\footnote{http://github.com/genworks/Genworks-GDL/} for more details
\item Enter your email address\footnote{if your address is not on file, send mail to licensing@genworks.com}.
\item Download the latest Payload and gpl.zip for Windows.
\item Download the latest Payload and gpl.zip for Windows\footnote{If you already have a gpl.zip from a previous Gendl installation, it is not necessary to download a new one.}
\item Click to receive license key file by email.
......@@ -252,7 +263,7 @@ GenDL is currently distributed for all the platforms as a
self-contained ``zip'' file which does not require official
administrator installation. What follows are general instructions; more up-to-date details
may be found in the email which accompanies the license key file. A five-minute installation video
is also available in the Documentation section of the href{http://genworks.com/newsite}{Genworks Newsite}.
is also available in the Documentation section of the \href{http://genworks.com/newsite}{Genworks Newsite}.
\begin{enumerate}
......@@ -279,11 +290,98 @@ is also available in the Documentation section of the href{http://genworks.com/n
So you now should have two directories at the same level: one named \texttt{gdl1581.../}(the rest of the name will contain the specific dated build stamp), and a \texttt{gdl/}directory at the same level. Note that as seen in Figure
\ref{fig:gendl-installation}, it is possible to have several Gendl versions installed, but just a single common \texttt{gpl/} folder.
\subsection{Test your Installation}
\subsection{Make a Desktop Shortcut}
\label{subsec:makeadesktopshortcut}
\label{subsec:testyourinstallation}
Test your installation according to the following checklist:
\begin{enumerate}
\item Using the ``My Computer'' or ``Computer'' Windows file manager, right-mouse on the \texttt{run-gdl.bat} file.
\item Select ``Create Shortcut.''
\item Now drag the new ``Run-gdl-shortcut'' icon to your desktop.
\end{enumerate}
\subsection{Populate your Initialization File}
\label{subsec:populateyourinitializationfile}
The default initialization file for Gendl is called \texttt{gdlinit.cl},
\section{Installation of open-source Gendl}
\label{sec:installationofopen-sourcegendl}
This section is only relevant if you have not received a
pre-packaged Gendl distribution with its own Common Lisp engine. If
you have received a pre-packaged Gendl distribution, then please skip
this section. In case you want to use the open-source Gendl, you will
use your own Common Lisp installation and fetch Gendl (Genworks-GDL)
using a very powerful and convenient CL package/library manager
called \emph{Quicklisp}.
\subsection{Install and Configure your Common Lisp environment}
\label{subsec:installandconfigureyourcommonlispenvironment}
Gendl is currently tested to build on the following Common Lisp engines:
\begin{itemize}
\item Allegro CL (commercial product from Franz Inc, free Express Edition available)
\item LispWorks (commercial product from LispWorks Ltd, free Personal Edition available)
\item Steel Bank Common Lisp (SBCL) (free open-source project with permissive license)
\end{itemize}
Please refer to the documentation for each of these systems for full information on installing
and configuring the environment. Typically this will include a text editor, either Gnu Emacs with Superior
Lisp Interaction Mode for Emacs (Slime), or a built-in text editing and development environment which
comes with the Common Lisp system.
As of this writing, a convenient way to set up Emacs with Slime is to use the \href{http://github.com/quicklisp/quicklisp-slime-helper}{Quicklisp-slime-helper}.
\subsection{Load and Configure Quicklisp}
\label{subsec:loadandconfigurequicklisp}
As of this writing, Quicklisp is rapidly becoming the defacto standard library manager for Common Lisp.
\begin{itemize}
\item Visit the \href{http://quicklisp.org}{Quicklisp website}
\item Follow the instructions there to download the \texttt{quicklisp.lisp} bootstrap file and load it to set up your Quicklisp environment.
\end{itemize}
\section{System Startup and Testing}
\label{sec:systemstartupandtesting}
\subsection{System Startup}
\label{subsec:systemstartup}
\subsubsection{Startup of prepackaged Gendl distribution}
\label{subsubsec:startupofprepackagedgendldistribution}
To start a prepackaged system, follow these steps:
\begin{enumerate}
......@@ -292,14 +390,38 @@ README file displayed by default. Take the time to look through this README file
Especially the later part of the file contains information about Emacs keyboard
shortcuts available.
\item In emacs, enter: \texttt{M-x glime}. That is, hold down the ``Meta'' (or ``Alt'') key, and press the ``M'' key.
\item In emacs, enter: \texttt{M-x glime}. That is, hold down the ``Meta'' (or ``Alt'') key, and press the ``X'' key, then type ``glime.''
You will see this command shown in the \emph{mini-buffer} at the bottom of the Emacs window, as shown in Figure
\ref{fig:mini-buffer}
\begin{figure}
\begin{center}
\includegraphics[width=3in,height=3in]{../images/mini-buffer.png}
\end{center}
\caption{The mini-buffer in Emacs}
\label{fig:mini-buffer}
\end{figure}
\item press the ``Enter'' key
\item On Windows, you will get a new window, named the Allegro CL Console or the Gendl Console.
Watch this console for any errors or warnings.
\begin{figure}
\begin{center}
\includegraphics{../images/genworks-gendl-console.png}
\end{center}
\caption{Genworks Gendl Console}
\label{fig:genworks-gendl-console}
\end{figure}
\item On Windows, you will get a new window, named the Allegro CL Console or the Gendl Console,
as shown in Figure
\ref{fig:genworks-gendl-console}. This window might start out in minimized form (as an icon at the bottom of your screen). Click on it
to open it. Watch this console for any errors or warnings.
The first time you start up, you may see messages in this console for
several minutes while the system is being built (or if you received a
......@@ -310,10 +432,48 @@ On Linux or MacOS, there will be a separate Emacs buffer (available
through Emacs' ``Buffers'' menu) where you will see these messages.
The messages will consist of compiling and loading information, followed by copyright and welcome information
for Gendl. After these messages have finished, you should see the following command prompt:\texttt{gdl-user(1): }
for Gendl. After these messages have finished, you should see the following command prompt:
\texttt{gdl-user(1): }
\item In your Web Browser (e.g. Google Chrome, Firefox, Safari, Opera, Internet Explorer),
perform the following steps:
The Genworks GDL console contains a command prompt, but mostly you will use the Slime REPL buffer in Emacs
to type commands. The Genworks GDL console is mainly used for displaying output text from the Gendl system and from your application.
\end{enumerate}
\subsubsection{Startup of open-source Gendl distribution}
\label{subsubsec:startupofopen-sourcegendldistribution}
To start an Open-source distribution, follow these steps:
\begin{enumerate}
\item Start your Common Lisp engine and development environment (e.g. SBCL with Emacs and Superior Lisp Interaction Mode for Emacs).
\item After Quicklisp is installed and initialized in your system, type: \texttt{(ql:quickload :genworks-gdl)} to get Genworks Gendl installed and loaded in your environment.
\item Type the following to initialize the Gendl environment:
\texttt{(gdl:start-gdl :edition :open-source)}
\end{enumerate}
\subsection{Basic System Test}
\label{subsec:basicsystemtest}
You may test your installation using the following
checklist. These tests are optional. You may perform some or all of
them in order to ensure that your Gendl is installed correctly and
running smoothly. In your Web Browser (e.g. Google Chrome, Firefox,
Safari, Opera, Internet Explorer), perform the following steps:
\begin{enumerate}
......@@ -325,7 +485,30 @@ perform the following steps:
\item Click on the top node in the tree.
\item Observe the wireframe graphics for the robot.
\item Observe the wireframe graphics for the robot as shown in
\ref{fig:tasty-robot}.
\begin{figure}
\begin{center}
\includegraphics[width=3in,height=3in]{../images/tasty-robot.png}
\end{center}
\caption{Robot displayed in Tasty}
\label{fig:tasty-robot}