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}
 | 
						|
 |