[Gardeners] mcclim.cliki.net improvements

[Clemens Fruhwirth]

Paolo Amoroso <amoroso at mclink.it> wrote:

> Clemens Fruhwirth <clemens at endorphin.org> writes:
> 
> > When I have seen the front pages of 
> >  
> >  http://cliki.net and http://mcclim.cliki.net 
> >
> > for the first time, I felt totally lost. I had no idea where I have to
> > go to get the information I wanted. I resorted to the "click every link
> 
> As someone who spent some time editing mcclim.cliki.net, I'd be
> interested in what kind of information you were looking for, and why
> you felt lost.

First of all, I haven't had a brief idea of what asdf was, how it
relates to asdf-install and what defsystem is about. This could be cured
by fixing http://www.cliki.net/asdf with a nice hierarchy graphics of,
how these stuff relates to each other. But back to McCLIM. When you hit

http://mcclim.cliki.net/index

you see "Building and Installation" and "Documentation". The first one is
usually a subtopic of the second. "Building and Installation" talks
about mk:operate-on-system, which I'm not using. When you click on
"Documentation" you see a random bunch of links. It should be ordered from
"First contact with least experience to developer information". However,
I found the "Out Of Box Experience" and filtered the asdf commands, that
are spread across the whole page. In a nutshell I was looking for 

(asdf:operate 'asdf:load-op 'cmucl-graystream)
(asdf:operate 'asdf:load-op 'cmucl-clx)
(asdf:operate 'asdf:load-op 'clim)
(asdf:operate 'asdf:load-op 'clim-clx)

Now knowing more about asdf, I chosen something different in my .sbclrc
(defmethod asdf:perform :after ((o asdf:load-op) (s (eql (asdf:find-system :clim))))
  (asdf:oos 'asdf:load-op :clim-clx))

and only do "(asdf:oos 'asdf:load-op :clim)" in my eval-when
environments.. so, these things are missing from my perspective of
mcclim's wiki. I'm going to restructure these pages, if you don't object
as following: 

Move Building and Installation into Documention
Move Compilance into Documentation
Move Compatibility into Documentation

Reorder the content of Documentation as following:

* Prequisites for McCLIM (former Compatiblity)
* Downloading McCLIM
  * via Debian using clc
  * via Gentoo using clc
  * manually
* Loading McCLIM
  * Using mk:defsystem
  * Using asdf
  * Implementation specific (CMUCL, SBCL, OpenMCL..)
* Installation McCLIM
  * Generating a core image with McCLIM loaded in c-l-c.
  * manually
* Application development
  * Examples
  * Links to walkthrough etc.
  * Tutorials
* For developers
  * CLIM Spec

Also
http://lists.metacircles.com/pipermail/portable-clx/2005-November/000111.html
has to be fixed for McCLIM to load properly with portable clx. That was
also a point I was struggling with on my installation attempts.

Regards,
-- 
Fruhwirth Clemens - http://clemens.endorphin.org 
for robots: sp4mtrap at endorphin.org