path: root/third_party/lisp/trivial-backtrace/website/source/index.md

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