Commit e1644a68 authored by Dave Cooper's avatar Dave Cooper
Browse files

updating the tutorial.pdf

parent c08f29ad
......@@ -91,7 +91,19 @@
\newlabel{sec:workingwithprojects}{{3.3}{16}{Working with Projects\relax }{section.3.3}{}}
\@writefile{toc}{\contentsline {subsection}{\numberline {3.3.1}Directory Structure}{16}{subsection.3.3.1}}
\newlabel{subsec:directorystructure}{{3.3.1}{16}{Directory Structure\relax }{subsection.3.3.1}{}}
\@writefile{lof}{\contentsline {figure}{\numberline {3.2}{\ignorespaces Example project directory with four source files}}{17}{figure.3.2}}
\newlabel{fig:yoyodyne-base}{{3.2}{17}{Example project directory with four source files\relax }{figure.3.2}{}}
\@writefile{lof}{\contentsline {figure}{\numberline {3.3}{\ignorespaces Example project directory with file ordering configuration file}}{17}{figure.3.3}}
\newlabel{fig:yoyodyne-with-file-ordering-isc}{{3.3}{17}{Example project directory with file ordering configuration file\relax }{figure.3.3}{}}
\@writefile{toc}{\contentsline {subsection}{\numberline {3.3.2}Source Files within a source/ subdirectory}{17}{subsection.3.3.2}}
\newlabel{subsec:sourcefileswithinasource/subdirectory}{{3.3.2}{17}{Source Files within a source/ subdirectory\relax }{subsection.3.3.2}{}}
\@writefile{toc}{\contentsline {subsubsection}{Enforcing Ordering}{17}{section*.4}}
\newlabel{subsubsec:enforcingordering}{{3.3.2}{17}{Enforcing Ordering\relax }{section*.4}{}}
\@writefile{toc}{\contentsline {section}{\numberline {3.4}Customizing your Environment}{17}{section.3.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}{}}
This is pdfTeX, Version 3.1415926-1.40.10 (TeX Live 2009/Debian) (format=pdflatex 2011.11.28) 23 OCT 2012 13:44
This is pdfTeX, Version 3.1415926-1.40.10 (TeX Live 2009/Debian) (format=pdflatex 2011.11.28) 26 OCT 2012 11:25
entering extended mode
%&-line parsing enabled.
**tutorial.tex
......@@ -327,23 +327,22 @@ 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.
)
\tf@toc=\write5
\openout5 = `tutorial.toc'.
[3
] [4
])
\tf@toc=\write5
\openout5 = `tutorial.toc'.
]
[4]
Chapter 1.
[1
] [2] [3] [4
]
Chapter 2.
<../images/gendl-installation.png, id=218, 127.40933pt x 70.12866pt>
<../images/gendl-installation.png, id=229, 127.40933pt x 70.12866pt>
File: ../images/gendl-installation.png Graphic file (type png)
<use ../images/gendl-installation.png> [5]
......@@ -353,11 +352,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=246, 687.56876pt x 613.29124pt>
<../images/mini-buffer.png, id=257, 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=248, 318.52333pt x 212.52733pt>
<../images/genworks-gendl-console.png, id=259, 318.52333pt x 212.52733pt>
File: ../images/genworks-gendl-console.png Graphic file (type png)
<use ../images/genworks-gendl-console.png>
......@@ -373,11 +372,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=268, 542.29266pt x 441.11467pt>
<../images/tasty-robot.png, id=279, 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=269, 543.36333pt x 440.044pt>
<../images/tasty-robot-x3dom.png, id=280, 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
......@@ -415,13 +414,35 @@ File: omlcmr.fd 1999/05/25 v2.5h Standard LaTeX font definitions
LaTeX Font Info: Font shape `OML/cmr/m/n' in size <10.95> not available
(Font) Font shape `OML/cmm/m/it' tried instead on input line 757.
[15]
Overfull \hbox (6.79999pt too wide) in paragraph at lines 843--844
[][]
[]
LaTeX Warning: Reference `fig:yoyodyne-base' on page 16 undefined on input line
827.
[16]
Overfull \hbox (6.90225pt too wide) in paragraph at lines 873--877
[]\OT1/cmr/m/n/10.95 This will force pack-age.lisp to be com-piled/loaded first
, and pa-ram-e-ters.lisp to be com-piled/loaded
[]
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.
[]
[16] [17] [18
[20
] (./tutorial.ind [19
] (./tutorial.ind [21
]) (./tutorial.aux)
......@@ -433,13 +454,13 @@ LaTeX Warning: There were undefined references.
)
Here is how much of TeX's memory you used:
5156 strings out of 494985
76118 string characters out of 1181033
144014 words of memory out of 3000000
8130 multiletter control sequences out of 15000+50000
5170 strings out of 494985
76442 string characters out of 1181033
145443 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,362b,395s stack positions out of 5000i,500n,10000p,200000b,50000s
38i,8n,36p,384b,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
......@@ -454,9 +475,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 (23 pages, 502745 bytes).
Output written on tutorial.pdf (25 pages, 511748 bytes).
PDF statistics:
479 PDF objects out of 1000 (max. 8388607)
134 named destinations out of 1000 (max. 500000)
274 words of extra memory for PDF output out of 10000 (max. 10000000)
507 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)
......@@ -27,5 +27,7 @@
\BOOKMARK [2][-]{subsection.3.2.3}{Shutdown}{section.3.2}
\BOOKMARK [1][-]{section.3.3}{Working with Projects}{chapter.3}
\BOOKMARK [2][-]{subsection.3.3.1}{Directory Structure}{section.3.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.}{}
......@@ -827,6 +827,81 @@ In Figure
\ref{fig:yoyodyne-base} is an example application directory, with four source files.
\begin{figure}
\begin{lrbox}{\boxedverb}
\begin{minipage}{\linewidth}
\begin{verbatim}
apps/yoyodyne/booster-rocket/source/assembly.gdl
apps/yoyodyne/booster-rocket/source/package.gdl
apps/yoyodyne/booster-rocket/source/parameters.gdl
apps/yoyodyne/booster-rocket/source/rules.gdl
\end{verbatim}
\end{minipage}
\end{lrbox}
\fbox{\usebox{\boxedverb}}
\caption{Example project directory with four source files}
\label{fig:yoyodyne-base}
\end{figure}
\subsection{Source Files within a source/ subdirectory}
\label{subsec:sourcefileswithinasource/subdirectory}
\subsubsection{Enforcing Ordering}
\label{subsubsec:enforcingordering}
Within a source subdirectory, you may have a file called \texttt{file-ordering.isc}\footnote{\texttt{isc} stands for ``Intelligent Source Configuration''} to enforce a certain ordering on the files. Here is the contents of an example for the
above application:
\texttt{("package" "parameters")}
This will force package.lisp to be compiled/loaded first, and
parameters.lisp to be compiled/loaded next. The ordering on the rest
of the files should not matter (although it will default to
lexigraphical ordering).
Now our sample application directory looks like Figure
\ref{fig:yoyodyne-with-file-ordering-isc} is an example application directory, with four source files.
\begin{figure}
\begin{lrbox}{\boxedverb}
\begin{minipage}{\linewidth}
\begin{verbatim}
apps/yoyodyne/booster-rocket/source/assembly.gdl
apps/yoyodyne/booster-rocket/source/file-ordering.isc
apps/yoyodyne/booster-rocket/source/package.gdl
apps/yoyodyne/booster-rocket/source/parameters.gdl
apps/yoyodyne/booster-rocket/source/rules.gdl
\end{verbatim}
\end{minipage}
\end{lrbox}
\fbox{\usebox{\boxedverb}}
\caption{Example project directory with file ordering configuration file}
\label{fig:yoyodyne-with-file-ordering-isc}
\end{figure}
\section{Customizing your Environment}
......@@ -848,6 +923,33 @@ 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.}
\label{chap:thischapterliststhetypicalmodificationsyouwillwantto
considerforupgradingfromgdl1580togendl1581.}
\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
\end{itemize}
\backmatter
......
......@@ -29,5 +29,8 @@
\contentsline {subsection}{\numberline {3.2.3}Shutdown}{16}{subsection.3.2.3}
\contentsline {section}{\numberline {3.3}Working with Projects}{16}{section.3.3}
\contentsline {subsection}{\numberline {3.3.1}Directory Structure}{16}{subsection.3.3.1}
\contentsline {subsection}{\numberline {3.3.2}Source Files within a source/ subdirectory}{17}{subsection.3.3.2}
\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}
......@@ -49,6 +49,7 @@ written consent from Genworks International.")
,*introduction*
,*installation*
,*basic-operation*
,*upgrade-notes*
:backmatter
:printindex
))
......
......@@ -253,6 +253,9 @@ overview of the expected directory structure and available control
files, followed by a reference for each of the functions included in
the bootstrap module."
((:subsection :title "Directory Structure")
(:p "You should structure your applications in a modular fashion, with the
directories containing actual Lisp sources called \"source.\"")
......@@ -264,7 +267,54 @@ however.")
(:p "In Figure "
(:ref "fig:yoyodyne-base")
" is an example application directory, with four source files.")))
" is an example application directory, with four source files.")
((:boxed-figure :caption "Example project directory with four source files"
:label "fig:yoyodyne-base")
(:verbatim "
apps/yoyodyne/booster-rocket/source/assembly.gdl
apps/yoyodyne/booster-rocket/source/package.gdl
apps/yoyodyne/booster-rocket/source/parameters.gdl
apps/yoyodyne/booster-rocket/source/rules.gdl
"))
)
((:subsection :title "Source Files within a source/ subdirectory")
((:subsubsection :title "Enforcing Ordering")
(:p "Within a source subdirectory, you may have a file called "
(:texttt "file-ordering.isc")
(:footnote (:texttt "isc") " stands for ``Intelligent Source Configuration''")
" to enforce a certain ordering on the files. Here is the contents of an example for the
above application:")
(:p (:texttt "(\"package\" \"parameters\")"))
(:p "This will force package.lisp to be compiled/loaded first, and
parameters.lisp to be compiled/loaded next. The ordering on the rest
of the files should not matter (although it will default to
lexigraphical ordering).")
(:p "Now our sample application directory looks like Figure "
(:ref "fig:yoyodyne-with-file-ordering-isc")
" is an example application directory, with four source files.")
)
((:boxed-figure :caption "Example project directory with file ordering configuration file"
:label "fig:yoyodyne-with-file-ordering-isc")
(:verbatim "
apps/yoyodyne/booster-rocket/source/assembly.gdl
apps/yoyodyne/booster-rocket/source/file-ordering.isc
apps/yoyodyne/booster-rocket/source/package.gdl
apps/yoyodyne/booster-rocket/source/parameters.gdl
apps/yoyodyne/booster-rocket/source/rules.gdl"))
))
((:section :title "Customizing your Environment")
......
Supports Markdown
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