Beginner question: Package documentation?

Discussion of Common Lisp
Post Reply
qiemem
Posts: 4
Joined: Sat Jan 17, 2009 8:00 pm

Beginner question: Package documentation?

Post by qiemem » Thu Mar 12, 2009 3:32 pm

I've downloaded a couple of packages using asdf-install, but I can't find the documentation for them online anywhere. Is there a way to view documentation for package from a repl? For instance, is there a function that will print a list of all the functions provided by a package? I've tried to use 'documentation', but I can't figure out how to use it on packages from clhs (I tried (documentation 'package-name 'package) without success).
Help would be much appreciated. Thanks!

findinglisp
Posts: 447
Joined: Sat Jun 28, 2008 7:49 am
Location: Austin, TX
Contact:

Re: Beginner question: Package documentation?

Post by findinglisp » Thu Mar 12, 2009 4:08 pm

No, not that I know of. There are the standard Lisp functions for viewing doc strings and such, but those only operate at the symbol level, not the ASDF package level.
Cheers, Dave
Slowly but surely the world is finding Lisp. http://www.findinglisp.com/blog/

gugamilare
Posts: 406
Joined: Sat Mar 07, 2009 6:17 pm
Location: Brazil
Contact:

Re: Beginner question: Package documentation?

Post by gugamilare » Thu Mar 12, 2009 4:14 pm

You can try tinaa to auto-generate a html files with the functions and their docs. It seems to work this way:

Code: Select all

(tinaa:document-system 'asdf-system 'the-name-of-the-system-here "/path/to/somewhere")
See the documentation of this function for other uses or more detail.

qiemem
Posts: 4
Joined: Sat Jan 17, 2009 8:00 pm

Re: Beginner question: Package documentation?

Post by qiemem » Fri Mar 13, 2009 2:29 pm

tinaa looks sweet, but unfortunately I get

Code: Select all

The function METABANG.UTILITIES:DIRECTORY-NAME-P is undefined.
   [Condition of type UNDEFINED-FUNCTION]
every time I try to use it. I installed it with asdf-install, but I think I might have messed something up.

However, in emacs, slime-apropros-package does exactly what I was looking for. It does seem sort of strange that (documentation ...) doesn't do this.
Thanks anyway!

Post Reply