89 lines
2.1 KiB
Markdown
89 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}
|
||
|
|