X-Git-Url: http://git.kpe.io/?p=lml2.git;a=blobdiff_plain;f=doc%2Freadme.lml;fp=doc%2Freadme.lml;h=3989b9b393c79916e616c058337c22e8a7c35a2f;hp=3a19c5329a5592bb6f643521e3366670bbf9fa47;hb=5b4d4c25eef861d0602e327c556f3cfd788cb9be;hpb=38e4f57a38547532d06019a60969937d251a554b diff --git a/doc/readme.lml b/doc/readme.lml index 3a19c53..3989b9b 100644 --- a/doc/readme.lml +++ b/doc/readme.lml @@ -5,7 +5,7 @@ (page ("readme") (html (:head - (:title "LML README") + (:title "LML2 README") ((:meta :http-equiv "Content-Type" :content "text/html; charset=iso-8859-1")) ((:meta :name "Copyright" :content "Kevin Rosenberg 2002 ")) ((:meta :name "description" :content "Lisp Markup Language Documentation")) @@ -13,33 +13,53 @@ ((:meta :name "keywords" :content "Common Lisp, HTML, Markup Langauge"))) (:body - (:h1 "LML Documentation") + (:h1 "LML2 Documentation") (:h2 "Overview") (:p - ((:a :href "http://lml.b9.com") "LML") - " is a Common Lisp package for generating HTML and XHTML documents." - "LML is authored by " - ((:a :href "mailto:kevin@rosenberg.net") "Kevin Rosenberg") - ". The home page for LML is " - ((:a :href "http://lml.b9.com/") "http://lml.b9.com/") - ".") + ((:a :href "http://lml2.b9.com") "LML2") + " is a Common Lisp package for generating HTML and XHTML documents." + " LML2 is based on:") - (:h2 "Installation") - (:p - "The easiest way to install LML is to use the " - ((:a :href "http://www.debian.org/") "Debian") - " GNU/Linux operating system. You can then use the command " - (:tt "apt-get install cl-lml") - " to automatically download and install the LML package.") - (:p - "On a non-Debian system, you need to have " - ((:a :href "http://cclan.sourceforge.net/") "ASDF") - " installed to load the system definition file. You will need to change the source + (:ul + (:li ((:a :href "http://lml.b9.com") "LML") " by " + ((:a :href "mailto:kevin@rosenberg.net") "Kevin Rosenberg")) + (:li "htmlgen by " + ((:a :href "http://www.franz.com") "Franz, Inc."))) + + (:p + "The home page for LML2 is " + ((:a :href "http://lml2.b9.com/") "http://lml2.b9.com/") + ".") + + (:h2 "Differences between LML and LML2") + (:p "The syntax and HTML generation for LML2 are based on Franz's htmlgen macro. Personally, I like the syntax of LML better than LML2, but there are advantages of Franz's approach:") + (:ul + (:li "Faster compilation and runtime HTML generation") + (:li "Behavior of tags is extensible")) + + (:h2 "Differences between htmlgen and LML2") + (:ul + (:li "LML2 is XHTML compatible with close tags so that (html :hr) now produces '<hr />'") + (:li "Lowercase tag names so that (html ((:p class 'a))) now produces '<p class=\"a\"></p>") + (:li "Addition of new tags such as :insert-file, :nbsp, :jscript") + (:li "Removal of the if* macro from the htmlgen.lisp source code")) + + (:h2 "Installation") + (:p + "The easiest way to install LML is to use the " + ((:a :href "http://www.debian.org/") "Debian") + " GNU/Linux operating system. You can then use the command " + (:tt "apt-get install cl-lml2") + " to automatically download and install the LML2 package.") + (:p + "On a non-Debian system, you need to have " + ((:a :href "http://cclan.sourceforge.net/") "ASDF") + " installed to load the system definition file. You will need to change the source pathname in the system file to match the location where you have installed LML.") (:h2 "Usage") (:p - "Currently, there is no documentation on the functions provided by LML. However, the source code is instructive and there are example files included in the LML package.") + "Currently, there is no documentation on the functions provided by LML2. However, the source code is instructive and there are example files included in the LML2 package.") (:h2 "Examples") ((:table :border 1 :cellpadding 3) @@ -66,7 +86,7 @@ :hr (:p "View this page's " - ((:a :href "http://lml.b9.com/") "LML") + ((:a :href "http://lml2.b9.com/") "LML2") " " ((:a :href "readme.lml") "source") ".")