== name ==

CL-WHO

== category ==

Webprogramming

== author ==

Dr. Edmund Weitz (mailto(edi@agharta.de), mailto(edi@weitz.de))

== author-image ==

== short-description ==

CL-WHO is a Lisp markup language which can be used to generate HTML or
XML.

== long-description ==

CL-WHO is a Lisp markup language which provides convenient means to
convert S-expressions intermingled with code into (X)HTML, XML. It
tries to create efficient code in that it makes constant strings as
long as possible. In other words, the code generated by the CL-WHO
macros will usually be a sequence of WRITE-STRING forms for constant
parts of the output interspersed with arbitrary code inserted by the
user of the macro. CL-WHO will make sure that there aren't two
adjacent WRITE-STRING forms with constant strings.

== examples ==

This code

  (with-html-output (*http-stream*)
    (loop for (link . title) in '(("http://zappa.com/" . "Frank Zappa")
                                  ("http://marcusmiller.com/" . "Marcus Miller")
                                  ("http://www.milesdavis.com/" . "Miles Davis"))
          do (htm (:a :href link
                    (:b (str title)))
                  :br)))

will be translated by CL-WHO into this code

  (let ((*http-stream* *http-stream*))
    (progn
      nil
      (loop for (link . title) in '(("http://zappa.com/" . "Frank Zappa")
                                    ("http://marcusmiller.com/" . "Marcus Miller")
                                    ("http://www.milesdavis.com/" . "Miles Davis"))
            do (progn
                 (write-string "<a href='" *http-stream*)
                 (princ link *http-stream*)
                 (write-string "'><b>" *http-stream*)
                 (princ title *http-stream*)
                 (write-string "</b></a><br />" *http-stream*)))))

at macro-expansion time.  See the documentation for more examples.

== instructions ==

Just load the file 'load.lisp' or use ASDF:

  (asdf:oos 'asdf:load-op :cl-who)

== tutorial ==

Various examples can be found in the documentation.

== home-url ==

http://weitz.de/cl-who/

== doc-url ==

http://weitz.de/cl-who/

== license ==

CL-WHO comes with a href(BSD license,http://www.opensource.org/licenses/bsd-license.php).

== book ==

== references ==

== source-fooball ==

Download the source code from
href(http://weitz.de/files/cl-who.tgz,http://weitz.de/files/cl-who.tgz)
or
href(ftp://ftp.franz.com/pub/lispwire/edi/cl-who-0.4.3.tgz,ftp://ftp.franz.com/pub/lispwire/edi/cl-who-0.4.3.tgz).
bold(NOTE: Edi's site might have a newer version.)


== release-date ==

2004-09-13

== release-version ==

0.4.3

== status ==

stable

== history ==

== acl-dependencies ==

== other-dependencies ==

== platform ==

== ad ==