Missing docs.

4 views
Skip to first unread message

Robin Lee Powell

unread,
Jul 30, 2008, 2:23:00 AM7/30/08
to webl...@googlegroups.com

I just, more-or-less accidentally, found the make-quickform in the
weblocks source, which was exactly what I was looking for at the
time. It's not in the Tinaa docs online at all, which makes me
worry what else is missing. Can someone regenerate the docs?

-Robin

--
Lojban Reason #17: http://en.wikipedia.org/wiki/Buffalo_buffalo
Proud Supporter of the Singularity Institute - http://singinst.org/
http://www.digitalkingdom.org/~rlpowell/ *** http://www.lojban.org/

Vyacheslav Akhmechet

unread,
Jul 30, 2008, 2:32:55 AM7/30/08
to webl...@googlegroups.com
On Wed, Jul 30, 2008 at 2:23 AM, Robin Lee Powell
<rlpo...@digitalkingdom.org> wrote:
> It's not in the Tinaa docs online at all, which makes me
> worry what else is missing. Can someone regenerate the docs?
Robin,

Tinaa docs online are severely out of date. Unfortunately
common-lisp.net doesn't have a lisp implementation installation, so
it's not possible to regenerate the documentation on the server on
every commit (I should really try and install SBCL in the home
directory, come to think of it). So, for the moment, please don't rely
on online Tinaa documentation. Generate it yourself locally by calling
asdf doc-op on the weblocks project. I'll try to resolve this issue
when I get back to working on weblocks in about a week.

- Slava

Robin Lee Powell

unread,
Aug 1, 2008, 2:20:28 AM8/1/08
to webl...@googlegroups.com
On Wed, Jul 30, 2008 at 02:32:55AM -0400, Vyacheslav Akhmechet
wrote:

>
> On Wed, Jul 30, 2008 at 2:23 AM, Robin Lee Powell
> <rlpo...@digitalkingdom.org> wrote:
> > It's not in the Tinaa docs online at all, which makes me worry
> > what else is missing. Can someone regenerate the docs?
>
> Tinaa docs online are severely out of date. Unfortunately
> common-lisp.net doesn't have a lisp implementation installation,
> so it's not possible to regenerate the documentation on the server
> on every commit (I should really try and install SBCL in the home
> directory, come to think of it). So, for the moment, please don't
> rely on online Tinaa documentation. Generate it yourself locally
> by calling asdf doc-op on the weblocks project. I'll try to
> resolve this issue when I get back to working on weblocks in about
> a week.

Thanks, I appreciate it.

Unfortunately, I can't figure out how to do what you suggest; the
farthest I've gotten is:

(load "/usr/lib/sbcl/site/cl-weblocks/weblocks-scripts.asd")

(load "/usr/lib/sbcl/site/cl-weblocks/weblocks.asd")

(asdf:operate 'weblocks-asd:doc-op :weblocks)

Which gives me:

debugger invoked on a TYPE-ERROR in thread #<THREAD "initial thread" RUNNING {100266ACE1}>:
The value NIL
is not of type
(OR (VECTOR CHARACTER) (VECTOR NIL) BASE-STRING PATHNAME STREAM).

Type HELP for debugger help, or (SB-EXT:QUIT) to exit from SBCL.

restarts (invokable by number or by possibly-abbreviated name):
0: [RETRY ] Retry performing #<WEBLOCKS-ASD:DOC-OP NIL {1003E61C01}> on
#<ASDF:SYSTEM "weblocks" {100273B971}>.
1: [ACCEPT] Continue, treating #<WEBLOCKS-ASD:DOC-OP NIL {1003E61C01}> on
#<ASDF:SYSTEM "weblocks" {100273B971}> as having been successful.
2: [ABORT ] Reduce debugger level (to debug level 1).
3: Exit debugger, returning to top level.

Robin Lee Powell

unread,
Aug 5, 2008, 2:17:18 AM8/5/08
to webl...@googlegroups.com

Still hoping for help here.

-Robin

Vyacheslav Akhmechet

unread,
Aug 5, 2008, 3:19:19 AM8/5/08
to webl...@googlegroups.com
On Tue, Aug 5, 2008 at 2:17 AM, Robin Lee Powell
<rlpo...@digitalkingdom.org> wrote:
> Still hoping for help here.
Here's how I generate them:

(asdf:operate 'asdf:load-op :weblocks)


(asdf:operate 'weblocks-asd:doc-op :weblocks)

Does this work for you?

I'll try to put systems in place to have automatically generated
documentation in the coming days.

- Slava

Robin Lee Powell

unread,
Aug 5, 2008, 10:12:45 PM8/5/08
to webl...@googlegroups.com
On Tue, Aug 05, 2008 at 03:19:19AM -0400, Vyacheslav Akhmechet
wrote:

>
> On Tue, Aug 5, 2008 at 2:17 AM, Robin Lee Powell
> <rlpo...@digitalkingdom.org> wrote:
> > Still hoping for help here.
> Here's how I generate them:
>
> (asdf:operate 'asdf:load-op :weblocks)
> (asdf:operate 'weblocks-asd:doc-op :weblocks)
>
> Does this work for you?

Nope. What I actually ran was:

(push #p"/usr/lib/sbcl/site/cl-weblocks/" asdf:*central-registry*)


(asdf:operate 'asdf:load-op :weblocks)
(asdf:operate 'weblocks-asd:doc-op :weblocks)

And I got:

debugger invoked on a UNDEFINED-FUNCTION in thread #<THREAD "initial thread" RUNNING {100266AED1}>:
The function METABANG.UTILITIES:DIRECTORY-NAME-P is undefined.

Type HELP for debugger help, or (SB-EXT:QUIT) to exit from SBCL.

restarts (invokable by number or by possibly-abbreviated name):

0: [RETRY ] Retry performing #<WEBLOCKS-ASD:DOC-OP NIL {1002B64131}> on
#<ASDF:SYSTEM "weblocks" {10028E3201}>.
1: [ACCEPT] Continue, treating #<WEBLOCKS-ASD:DOC-OP NIL {1002B64131}> on
#<ASDF:SYSTEM "weblocks" {10028E3201}> as having been successful.
2: [ABORT ] Exit debugger, returning to top level.

("bogus stack frame")

-Robin

Vyacheslav Akhmechet

unread,
Aug 5, 2008, 11:49:13 PM8/5/08
to webl...@googlegroups.com
On Tue, Aug 5, 2008 at 10:12 PM, Robin Lee Powell
<rlpo...@digitalkingdom.org> wrote:
> debugger invoked on a UNDEFINED-FUNCTION in thread #<THREAD "initial thread" RUNNING {100266AED1}>:
> The function METABANG.UTILITIES:DIRECTORY-NAME-P is undefined.
Either my, or your version of metatilities is outdated. I'll play
around and fix this. Meanwhile, you find out which package this symbol
is in, and replace it in weblocks manually.

Robin Lee Powell

unread,
Aug 6, 2008, 6:38:36 PM8/6/08
to webl...@googlegroups.com

Yours, it seems; the new version is directory-pathname-p.

So I did this:

(require 'metatilities)
(defun METABANG.UTILITIES:DIRECTORY-NAME-P (&rest args) (apply #'METABANG.UTILITIES:DIRECTORY-PATHNAME-P args))


(push #p"/usr/lib/sbcl/site/cl-weblocks/" asdf:*central-registry*)
(asdf:operate 'asdf:load-op :weblocks)
(asdf:operate 'weblocks-asd:doc-op :weblocks)

and got:

debugger invoked on a UNBOUND-VARIABLE in thread #<THREAD "initial thread" RUNNING {100266ACE1}>:
The variable TINAA::IT is unbound.

Type HELP for debugger help, or (SB-EXT:QUIT) to exit from SBCL.

restarts (invokable by number or by possibly-abbreviated name):

0: [RETRY ] Retry performing #<WEBLOCKS-ASD:DOC-OP NIL {100286F8F1}> on
#<ASDF:SYSTEM "weblocks" {10035EE8A1}>.
1: [ACCEPT] Continue, treating #<WEBLOCKS-ASD:DOC-OP NIL {100286F8F1}> on
#<ASDF:SYSTEM "weblocks" {10035EE8A1}> as having been successful.


2: [ABORT ] Exit debugger, returning to top level.

((SB-PCL::FAST-METHOD TINAA:MAKE-PART :AROUND (T T T))
#<unavailable argument>
#S(SB-PCL::FAST-METHOD-CALL
:FUNCTION #<FUNCTION # {10028D7109}>
:PV NIL
:NEXT-METHOD-CALL #S(SB-PCL::FAST-METHOD-CALL
:FUNCTION #
:PV NIL
:NEXT-METHOD-CALL NIL
:ARG-INFO (3 . T))
:ARG-INFO (3 . T))
NIL
PACKAGE
:WEBLOCKS)[:EXTERNAL]
0]

Vyacheslav Akhmechet

unread,
Aug 7, 2008, 12:29:36 AM8/7/08
to webl...@googlegroups.com
On Wed, Aug 6, 2008 at 6:38 PM, Robin Lee Powell
<rlpo...@digitalkingdom.org> wrote:
> debugger invoked on a UNBOUND-VARIABLE in thread #<THREAD "initial thread" RUNNING {100266ACE1}>:
> The variable TINAA::IT is unbound.
May be a bug in TINAA. I'll check it out.
Reply all
Reply to author
Forward
0 new messages