[cl-faq] Now, with less over-engineering!!

Peter Seibel peter at gigamonkeys.com
Sat Jan 14 20:19:51 CST 2006


As I started to think about actually editing the FAQ I came to my  
senses and realized that I was completely missing the point of my own  
Markup library with that \faq{\question{...}\answer{...}} nonsense.  
So I wrote some code to dump the file out in a more normal Markup  
form, taking advantage of the support for Emacs outline mode, etc.  
The new source file is at the usual place:

   <http://www.lispniks.com/faq/faq.txt>

and the HTML at:

   <http://www.lispniks.com/faq/faq.html>

Anyone, who's got questions and answers in the old form should send  
them along; I'll deal with converting them. But for future the format  
is much simpler:

   *** Question text here, all one one line.

   Answer here using Markup conventions such as:

     blockquotes indented two spaces

   And

       (code examples indented four spaces)

   And \i{internal markup} like \b{this}

This makes the file much easier to edit and will hopefully enable me  
to get to work actually, you know, editing.

-Peter

-- 
Peter Seibel           * peter at gigamonkeys.com
Gigamonkeys Consulting * http://www.gigamonkeys.com/
Practical Common Lisp  * http://www.gigamonkeys.com/book/




More information about the cl-faq mailing list