88 lines
		
	
	
	
		
			2.1 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
			
		
		
	
	
			88 lines
		
	
	
	
		
			2.1 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
| {include resources/header.md}
 | |
| 
 | |
| <div class="contents">
 | |
| <div class="system-links">
 | |
| 
 | |
|   * [Mailing Lists][mailing-list]
 | |
|   * [Getting it][downloads]
 | |
|   * [Documentation][]
 | |
|   * [News][]
 | |
|   * [Test results][tr]
 | |
|   * [Changelog][]
 | |
| 
 | |
| </div>
 | |
| <div class="system-description">
 | |
| 
 | |
| ### What it is
 | |
| 
 | |
| On of the many things that didn't quite get into the Common
 | |
| Lisp standard was how to get a Lisp to output its call stack
 | |
| when something has gone wrong. As such, each Lisp has
 | |
| developed its own notion of what to display, how to display
 | |
| it, and what sort of arguments can be used to customize it.
 | |
| `trivial-backtrace` is a simple solution to generating a
 | |
| backtrace portably. As of {today}, it supports Allegro Common
 | |
| Lisp, LispWorks, ECL, MCL, SCL, SBCL and CMUCL. Its
 | |
| interface consists of three functions and one variable:
 | |
| 
 | |
|  * print-backtrace
 | |
|  * print-backtrace-to-stream
 | |
|  * print-condition
 | |
|  * \*date-time-format\*
 | |
| 
 | |
| You can probably already guess what they do, but they are
 | |
| described in more detail below.
 | |
| 
 | |
| {anchor mailing-lists}
 | |
| 
 | |
| ### Mailing Lists
 | |
| 
 | |
|   * [trivial-backtrace-devel][devel-list]: A list for
 | |
|     announcements, questions, patches, bug reports, and so
 | |
|     on; It's for anything and everything
 | |
| 
 | |
| ### API
 | |
| 
 | |
| {set-property docs-package trivial-backtrace}
 | |
| {docs print-backtrace}
 | |
| {docs print-backtrace-to-stream}
 | |
| {docs print-condition}
 | |
| {docs *date-time-format*}
 | |
| 
 | |
| {anchor downloads}
 | |
| 
 | |
| ### Where is it
 | |
| 
 | |
| A [git][] repository is available using
 | |
| 
 | |
|     git clone http://common-lisp.net/project/trivial-backtrace/trivial-backtrace.git
 | |
|     
 | |
| The [darcs][] repository is still around but is **not** being updated.
 | |
| The command to get it is below:
 | |
| 
 | |
|     ;;; WARNING: out of date
 | |
|     darcs get http://common-lisp.net/project/trivial-backtrace/
 | |
| 
 | |
| trivial-backtrace is also [ASDF installable][asdf-install].
 | |
| Its CLiki home is right [where][cliki-home] you'd expect.
 | |
| 
 | |
| There's also a handy [gzipped tar file][tarball].
 | |
| 
 | |
| {anchor news}
 | |
| 
 | |
| ### What is happening
 | |
| 
 | |
| <dl>
 | |
|   <dt>14 May 2009</dt>
 | |
|   <dd>Moved to [git][]; John Fremlin adds map-backtrace
 | |
|       </dd>
 | |
| 
 | |
| <dt>1 June 2008</dt>
 | |
| <dd>Release version 1.0
 | |
|     </dd>
 | |
|     </dl>
 | |
| </div>
 | |
| </div>
 | |
| 
 | |
| {include resources/footer.md}
 | |
| 
 |