Commit aa72094e authored by Dave Cooper's avatar Dave Cooper

ready for 1588 release

parent 960b9afa
......@@ -3,7 +3,7 @@
(asdf:defsystem #:dom :description
"The Gendl\" dom Subsystem" :author "John McCarthy" :license
"Affero Gnu Public License (http://www.gnu.org/licenses/)" :serial t
:version "20150113" :depends-on (:cl-who :yadd)
:version "20150115" :depends-on (:cl-who :yadd)
#-asdf-unicode :defsystem-depends-on #-asdf-unicode (:asdf-encodings)
#+asdf-encodings :encoding #+asdf-encodings :utf-8
:components
......
......@@ -4,7 +4,7 @@
"The Gendl\" (legacy) Testing and Tracking Utility, version 2 (using Ajax but pre-gdlAjax, and no JQuery or CSS)"
:author "John McCarthy" :license
"Affero Gnu Public License (http://www.gnu.org/licenses/)" :serial t
:version "20150113" :depends-on (:gwl-graphics)
:version "20150115" :depends-on (:gwl-graphics)
#-asdf-unicode :defsystem-depends-on #-asdf-unicode (:asdf-encodings)
#+asdf-encodings :encoding #+asdf-encodings :utf-8
:components
......
......@@ -4,7 +4,7 @@
"The Gendl\" Web-based Development Environment (tasty)" :author
"John McCarthy" :license
"Affero Gnu Public License (http://www.gnu.org/licenses/)" :serial t
:version "20150113" :depends-on (:tree :gwl-graphics)
:version "20150115" :depends-on (:tree :gwl-graphics)
#-asdf-unicode :defsystem-depends-on #-asdf-unicode (:asdf-encodings)
#+asdf-encodings :encoding #+asdf-encodings :utf-8
:components
......
......@@ -4,7 +4,7 @@
"The Gendl\" Translators to/from XML and potentially other high-level KBE and Knowledge formats"
:author "John McCarthy" :license
"Affero Gnu Public License (http://www.gnu.org/licenses/)" :serial t
:version "20150113" :depends-on (:gwl)
:version "20150115" :depends-on (:gwl)
#-asdf-unicode :defsystem-depends-on #-asdf-unicode (:asdf-encodings)
#+asdf-encodings :encoding #+asdf-encodings :utf-8
:components
......
......@@ -4,7 +4,7 @@
"The Gendl\" Tree component used by Tasty and potentially as a UI component on its own"
:author "John McCarthy" :license
"Affero Gnu Public License (http://www.gnu.org/licenses/)" :serial t
:version "20150113" :depends-on (:gwl-graphics)
:version "20150115" :depends-on (:gwl-graphics)
#-asdf-unicode :defsystem-depends-on #-asdf-unicode (:asdf-encodings)
#+asdf-encodings :encoding #+asdf-encodings :utf-8
:components
......
......@@ -4,7 +4,7 @@
"The Gendl\" Yet Another Definition Documenter (yadd)" :author
"John McCarthy" :license
"Affero Gnu Public License (http://www.gnu.org/licenses/)" :serial t
:version "20150113" :depends-on
:version "20150115" :depends-on
(:gwl-graphics #-allegro :cl-html-parse)
#-asdf-unicode :defsystem-depends-on #-asdf-unicode (:asdf-encodings)
#+asdf-encodings :encoding #+asdf-encodings :utf-8
......
......@@ -3,7 +3,7 @@
(asdf:defsystem #:base :description
"The Gendl\" Base Core Kernel Engine" :author "John McCarthy"
:license "Affero Gnu Public License (http://www.gnu.org/licenses/)"
:serial t :version "20150113" :depends-on nil
:serial t :version "20150115" :depends-on nil
#-asdf-unicode :defsystem-depends-on #-asdf-unicode (:asdf-encodings)
#+asdf-encodings :encoding #+asdf-encodings :utf-8
:components
......
......@@ -285,6 +285,7 @@ If you are interested in this effort we would love to hear from you at open-sour
#:*already-loaded-systems*
#:*loaded-hotpatches*
#:*packages-to-lock*
#:*patch-url-base*
#:*warn-on-invalid-toplevel-inputs?))
......
......@@ -3,7 +3,7 @@
(asdf:defsystem #:cl-lite :description
"The Gendl\" Compile-and-Load Lite Utility" :author "John McCarthy"
:license "Affero Gnu Public License (http://www.gnu.org/licenses/)"
:serial t :version "20150113" :depends-on (:glisp)
:serial t :version "20150115" :depends-on (:glisp)
#-asdf-unicode :defsystem-depends-on #-asdf-unicode (:asdf-encodings)
#+asdf-encodings :encoding #+asdf-encodings :utf-8
:components
......
......@@ -3,7 +3,7 @@
(asdf:defsystem #:bus :description
"The Gendl\" Wireframe School Bus Demo" :author "John McCarthy"
:license "Affero Gnu Public License (http://www.gnu.org/licenses/)"
:serial t :version "20150113" :depends-on (:gwl-graphics)
:serial t :version "20150115" :depends-on (:gwl-graphics)
#-asdf-unicode :defsystem-depends-on #-asdf-unicode (:asdf-encodings)
#+asdf-encodings :encoding #+asdf-encodings :utf-8
:components
......
......@@ -3,7 +3,7 @@
(asdf:defsystem #:ledger :description
"The Gendl\" Ledger Bookkeeping Demo" :author "John McCarthy"
:license "Affero Gnu Public License (http://www.gnu.org/licenses/)"
:serial t :version "20150113" :depends-on
:serial t :version "20150115" :depends-on
(#-gwl :gwl)
#-asdf-unicode :defsystem-depends-on #-asdf-unicode (:asdf-encodings)
#+asdf-encodings :encoding #+asdf-encodings :utf-8
......
......@@ -4,7 +4,7 @@
"The Gendl\" Simplified Android Robot example " :author
"John McCarthy" :license
"Affero Gnu Public License (http://www.gnu.org/licenses/)" :serial t
:version "20150113" :depends-on (:gwl-graphics)
:version "20150115" :depends-on (:gwl-graphics)
#-asdf-unicode :defsystem-depends-on #-asdf-unicode (:asdf-encodings)
#+asdf-encodings :encoding #+asdf-encodings :utf-8
:components
......
......@@ -4,7 +4,7 @@
"The Gendl\" Wire-World demo and test-case for wireframe tessellation and X3D output"
:author "John McCarthy" :license
"Affero Gnu Public License (http://www.gnu.org/licenses/)" :serial t
:version "20150113" :depends-on
:version "20150115" :depends-on
(#-gwl-graphics :gwl-graphics)
#-asdf-unicode :defsystem-depends-on #-asdf-unicode (:asdf-encodings)
#+asdf-encodings :encoding #+asdf-encodings :utf-8
......
......@@ -3,7 +3,7 @@
(asdf:defsystem #:examples :description
"The Gendl\" examples Subsystem" :author "John McCarthy" :license
"Affero Gnu Public License (http://www.gnu.org/licenses/)" :serial t
:version "20150113" :depends-on (:gwl-graphics :surf)
:version "20150115" :depends-on (:gwl-graphics :surf)
#-asdf-unicode :defsystem-depends-on #-asdf-unicode (:asdf-encodings)
#+asdf-encodings :encoding #+asdf-encodings :utf-8
:components
......
Welcome to the Genworks® GDL and Gendl® Environment
Note: If you are new to GDL or Gendl, please see below for Welcome
Message and other information.
This area will be used for the time being to list Release Notes, most
recent first.
===========================
GDL1588
===========================
Release Notes
===============
Release Schedule
================
========================================
GDL1587p008, Gendl1587p008 (2014-09-16)
========================================
FASL Incompatibility
====================
2015-01-15: GDL1588 release
Please note that 1587p008 does require compiling of fresh .fasl
files. If you try to load fasl files compiled with 1587p004, you will
probably get an error something like:
2016-01-15: The next major GDL release will be made available (number
TBD).
"attempt to take the cdr of eql hash table..."
Normally we only allow fasl incompatibility with full releases, rather
than point releases, but 1587p008 is an exception to this rule.
Furthermore, GDL should be preparing the fasls so they give a proper
"incompatible fasl" error in cases like this. This will be addressed
in a future release. For now, please simply be sure to delete all
existing fasl files which were compiled with previous GDL versions,
before attempting to compile or run your application with 1587p008.
Bug fixes:
==========
o Pressing <Enter> after changing a settable-slot in the settables
area of the tasty inspector was sending a duplicate request to the
server, which could cause unstable results, especially on SMP
Lisps. This is fixed.
o The append-elements operator contained a bug which could cause
corrupted data structures. This has been fixed. Also several subtle
fixes and cleanups.
Quicklisp
=========
Quicklisp is a curated library manager which can automatically fetch
CL libraries and their dependencies from the Internet. See
http://quicklisp.org for more information on Quicklisp.
We have now added the function
(load-quicklisp)
which will load and initialize the supported version of quicklisp
(which ships with the installation) and pre-register all Gendl-related
packages so that Quicklisp will not try to fetch and reload these if
you try to (ql:quickload ...) a system which depends on them. The
version of quicklisp which ships with this release is the only
supported version of Quicklisp (to ensure library compatibility, each
GDL release is tied to a specific Quicklisp version).
Note that depending on your installation, you may not have file
permissions to write into the quicklisp directory in its default
location, i.e.
(merge-pathnames "quicklisp/" glisp:*gendl-home*)
In this case, you can copy (copy, not move) the quicklisp directory to
a writeable location of your choice, and specify a :path keyword
argument to load-quicklisp, e.g:
(load-quicklisp :path "~/quicklisp/")
Note that it is a good idea to include the trailing slash in the
pathname.
After doing (load-quicklisp), you can test whether Quicklisp is
functional by trying something like:
(ql:quickload :cl-json)
Emacs Initialization and Glime
==============================
We have divided the emacs user initialiazation file into two files:
~/.emacs-gendl[.el] which is loaded when starting this emacs
environment, and
~/.emacs-glime[.el] which is loaded only when starting the
GDL-flavored Slime environment.
We are currently studying Emacs initialization, so this may be
modified more in future releases; please watch this space for
notifications.
In case you are wondering what "glime" actually is - this is Genworks'
extension to Slime (Superior Lisp Interaction Mode for Emacs, which we
use by default to interact with Gendl and GDL from Emacs). The idea of
Glime is that when you type
"(the ..." or
":objects ((my-object :type 'my-object ..."
then the emacs mini-buffer will give useful and context-sensitive
completion information similar to what it does now for standard Lisp
functions. Glime already works now to some extent, but we feel it
needs to be polished a bit more before loading it by default.
You can load Glime at any time with:
(load (merge-pathnames "emacs/glime.lisp" (glisp:*gdl-home*)))
[glime needs to be loaded only on the Lisp (Swank) side, not on the
Emacs (Slime) side].
In due course we intend to have Glime polished a bit more so it does a
better job filtering and formatting the auto-completions for messages
and object inputs, at which point it will be loaded by default in our
standard emacs initialization and we will rightfully be able to call
the whole environment "Glime."
2017-01-14: Support for GDL1588 will be sunsetted.
----------------------------------------------------------------------
......@@ -136,7 +24,7 @@ the whole environment "Glime."
Welcome to the Genworks® GDL and Gendl® Environment
=========
Startup
=========
......@@ -155,6 +43,25 @@ wireframe rendering of a simplified android robot.
See "Troubleshooting" below if you experience trouble starting up.
Updating
=========
The function (update-gdl) will pull down a bootstrap file which knows
how to fetch and install the currently available patches for this
version of GDL.
Documentation
=============
The following manual is currently available in PDF format:
http://genworks.com/downloads/tutorial.pdf
==================
Authoring GDL Code
==================
......@@ -166,7 +73,7 @@ All things considered, Gnu Emacs is the most powerful, portable, and
risk-free IDE (Integrated Development Environment) available for
working with Lisp-based systems like GDL. Spending some time getting
familiar with Gnu Emacs is perhaps the best small investment you can
make.
make.
If you are new to Emacs, you can get a general Emacs Tutorial under
the Help menu above. After completing the Tutorial, try to practice
......@@ -195,9 +102,9 @@ Finally, please see the Genworks Documentation (URL below) for some
screen-cast videos on using Emacs in the GDL environment.
===============
Learning GDL
===============
==============================
Learning GDL and Documentation
==============================
Absolutely the best way to learn GDL is to dive in and start using
it for small exercises and projects.
......@@ -210,7 +117,14 @@ Other Documentation:
http://www.genworks.com
Then click the link for Documentation.
Then click the link for Documentation, which contains lecture slides
and videos.
Additionally, reference documentation is available "live" from your
running system, at
http://localhost:9000/yadd
=========
......@@ -399,6 +313,85 @@ C-x C-e : Evaluate Form (with cursor after closing parenthesis)
Quicklisp
=========
Quicklisp is a curated library manager which can automatically fetch
CL libraries and their dependencies from the Internet. See
http://quicklisp.org for more information on Quicklisp.
the function
(load-quicklisp)
will load and initialize the supported version of quicklisp (which
ships with the installation) and pre-register all Gendl-related
packages so that Quicklisp will not try to fetch and reload these if
you try to (ql:quickload ...) a system which depends on them. The
version of quicklisp which ships with this release is the only
supported version of Quicklisp (to ensure library compatibility, each
GDL release is tied to a specific Quicklisp version).
Note that depending on your installation, you may not have file
permissions to write into the quicklisp directory in its default
location, i.e.
(merge-pathnames "quicklisp/" glisp:*gendl-home*)
In this case, you can copy (copy, not move) the quicklisp directory to
a writeable location of your choice, and specify a :path keyword
argument to load-quicklisp, e.g:
(load-quicklisp :path "~/quicklisp/")
Note that it is a good idea to include the trailing slash in the
pathname.
After doing (load-quicklisp), you can test whether Quicklisp is
functional by trying something like:
(ql:quickload :cl-json)
Emacs Initialization and Glime
==============================
We have divided the emacs user initialiazation file into two files:
~/.emacs-gendl[.el] which is loaded when starting this emacs
environment, and
~/.emacs-glime[.el] which is loaded only when starting the
GDL-flavored Slime environment.
In case you are wondering what "glime" actually is - this is Genworks'
extension to Slime (Superior Lisp Interaction Mode for Emacs, which we
use by default to interact with Gendl and GDL from Emacs). The idea of
Glime is that when you type
"(the ..." or
":objects ((my-object :type 'my-object ..."
then the emacs mini-buffer will give useful and context-sensitive
completion information similar to what it does now for standard Lisp
functions. Glime already works now to some extent, but we feel it
needs to be polished a bit more before loading it by default.
You can load Glime at any time with:
(load (merge-pathnames "emacs/glime.lisp" (glisp:*gdl-home*)))
[glime needs to be loaded only on the Lisp (Swank) side, not on the
Emacs (Slime) side].
In due course we intend to have Glime polished a bit more so it does a
better job filtering and formatting the auto-completions for messages
and object inputs, at which point it will be loaded by default in our
standard emacs initialization and we will rightfully be able to call
the whole environment "Glime."
Troubleshooting
......
......@@ -3,7 +3,7 @@
(asdf:defsystem #:geom-base :description
"The Gendl\" Wireframe Geometry" :author "John McCarthy" :license
"Affero Gnu Public License (http://www.gnu.org/licenses/)" :serial t
:version "20150113" :depends-on (:glisp)
:version "20150115" :depends-on (:glisp)
#-asdf-unicode :defsystem-depends-on #-asdf-unicode (:asdf-encodings)
#+asdf-encodings :encoding #+asdf-encodings :utf-8
:components
......
......@@ -3,7 +3,7 @@
(asdf:defsystem #:glisp :description
"The Gendl\" Common Lisp Portability" :author "John McCarthy"
:license "Affero Gnu Public License (http://www.gnu.org/licenses/)"
:serial t :version "20150113" :depends-on
:serial t :version "20150115" :depends-on
(:base :uiop :cl-typesetting :cl-ppcre :cl-who #-allegro :cl-base64 #-allegro :babel #-allegro :acl-compat)
#-asdf-unicode :defsystem-depends-on #-asdf-unicode (:asdf-encodings)
#+asdf-encodings :encoding #+asdf-encodings :utf-8
......
......@@ -3,7 +3,7 @@
(asdf:defsystem #:gwl-graphics :description
"The Gendl\" GWL embedded graphics support" :author "John McCarthy"
:license "Affero Gnu Public License (http://www.gnu.org/licenses/)"
:serial t :version "20150113" :depends-on (:geom-base :gwl)
:serial t :version "20150115" :depends-on (:geom-base :gwl)
#-asdf-unicode :defsystem-depends-on #-asdf-unicode (:asdf-encodings)
#+asdf-encodings :encoding #+asdf-encodings :utf-8
:components
......
......@@ -3,7 +3,7 @@
(asdf:defsystem #:gwl :description
"The Gendl\" Generative Web Language (GWL)" :author "John McCarthy"
:license "Affero Gnu Public License (http://www.gnu.org/licenses/)"
:serial t :version "20150113" :depends-on
:serial t :version "20150115" :depends-on
(:bordeaux-threads :glisp :aserve)
#-asdf-unicode :defsystem-depends-on #-asdf-unicode (:asdf-encodings)
#+asdf-encodings :encoding #+asdf-encodings :utf-8
......
......@@ -3,7 +3,7 @@
(asdf:defsystem #:regression :description
"The Gendl\" regression Subsystem" :author "John McCarthy" :license
"Affero Gnu Public License (http://www.gnu.org/licenses/)" :serial t
:version "20150113" :depends-on (:lift :surf :tasty)
:version "20150115" :depends-on (:lift :surf :tasty)
#-asdf-unicode :defsystem-depends-on #-asdf-unicode (:asdf-encodings)
#+asdf-encodings :encoding #+asdf-encodings :utf-8
:components
......
......@@ -4,7 +4,7 @@
"The Gendl\" NURBS Surface and Solids Geometry Primitives" :author
"John McCarthy" :license
"Affero Gnu Public License (http://www.gnu.org/licenses/)" :serial t
:version "20150113" :depends-on (:geom-base)
:version "20150115" :depends-on (:geom-base)
#-asdf-unicode :defsystem-depends-on #-asdf-unicode (:asdf-encodings)
#+asdf-encodings :encoding #+asdf-encodings :utf-8
:components
......
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