*fists of rage*
I'm glad it worked for you, and that it works for me if I repeat your
steps. I have no idea why it wasn't working given that I was using the
local copy of the git repository that is the source of what's on github.
Argh.
Regardless, thank you very much for your help. I've fixed the (for-label
try-catch), removed the test-more dependency, pushed it to github, and told
the package server to rescan. It says it will do that 1 minute from now,
so hopefully it'll be good to go at that point. I think documentation only
gets generated once per day though, right?
Also, any ideas on why the remove fails?
$ raco pkg remove try-catch
raco pkg remove: invalid `deps' specification
specification: '("base" racket/format racket/string)
That is not the deps specification from the info.rkt file so I don't know
where it's getting that.
On Tue, Sep 28, 2021 at 1:36 PM Ben Greenman <benjaminlgreen...@gmail.com>
wrote:
> On 9/28/21, David Storrs <david.sto...@gmail.com> wrote:
> > Summary: Documentation for a new module is not being generated when I
> > would expect it to be and when I do it manually it ends up not linking
> > basic Racket items. I've done a lot of searching to figure it out and
> > would appreciate some help.
>
> I cloned the try-catch repo (744f217), ran raco pkg install, and got a
> nicely-rendered document. Log attached.
>
> The only problem I saw is that `try` isn't linked. You can fix that by
> adding a `(require (for-label try-catch))`.
>
>
> > Long version:
> >
> > I published a module a few days ago called try-catch. I have an announce
> > email written up for it but I was waiting for the documentation to
> generate
> > before sending. It still hasn't generated so today I investigated.
> >
> > First thing I did was make sure that raco was using the local copy for
> > everything:
> >
> > $ raco pkg remove try-catch
> > raco pkg remove: invalid `deps' specification
> > specification: '("base" racket/format racket/string)
> >
> > Weird.
> >
> > $ raco setup --check-pkg-deps try-catch
> > [...lots of stuff, no problems reported]
> >
> > Okay, whatever.
> >
> > $ raco pkg remove --force try-catch
> >
> > Turn off the WiFi to be certain I don't get the package server version.
> >
> > $ raco pkg install ./try-catch
> >
> > Succeeds, claims that it is building the documentation, does not actually
> > do so. Ditto when I try
> >
> > $ raco setup try-catch
> >
> > When I manually run
> >
> > $ cd try-catch/scribblings/ && scribble try-catch.scbl
> >
> > I get the try-catch.html file as expected but racket/base functions such
> as
> > with-handlers are not properly linked -- i.e. they appear in blue with a
> > red line under them and are not links.
>
> That's normal. Scribble needs a few command-line flags to know where
> to look for cross references (xrefs). I don't know the right flags
> offhand.
>
>
> > I do not get any missing dependencies when I run
> >
> > My info.rkt file and try-catch.scrbl are both based on those from other
> > modules I have that do work correctly. I've checked the issues that were
> > pointed out to me the last time I had to ask this question, I've been
> > through the Racket documentation and through Beautiful Racket, and still
> > not found the answer. Any suggestions?
> >
> >
> > ;; The info.rkt file
> > #lang info
> >
> > (define collection "try-catch")
> > (define version "0.1")
> > (define deps '("base"
> > "syntax-classes-lib"))
> >
> > (define scribblings '(("scribblings/try-catch.scrbl" ())))
> >
> > (define test-omit-paths '())
> > (define build-deps '("racket-doc"
> > "scribble-lib"
> > "rackunit-lib"
> > "sandbox-lib"))
> >
> > ;;----------
> > ;; The top lines from main.rkt to show the require:
> >
> > #lang racket/base
> >
> > (require (for-syntax racket/base
> > syntax/parse)
> > racket/function)
> >
> > ;;----------
> > ;; A stripped-down version of scribblings/try-catch.scrbl that
> demonstrates
> > the failures
> >
> > #lang scribble/manual
> >
> > @(require (for-label racket)
> > racket/sandbox
> > scribble/example)
> >
> > @defmodule[try-catch]
> >
> > @(define eval
> > (call-with-trusted-sandbox-configuration
> > (lambda ()
> > (parameterize ([sandbox-output 'string]
> > [sandbox-error-output 'string]
> > [sandbox-memory-limit 50])
> > (make-evaluator 'racket)))))
> >
> > @itemlist[
> > @item{@racket[with-handlers], @racket[~a], @racketmodname[syntax-parse]}
> > ]
> >
> > @examples[
> > #:eval eval
> > #:label #f
> >
> > (require try-catch)
> > (define err (defatalize (raise-arguments-error 'foo "failed")))
> > err
> > (try [(displayln "ok")])
> > ]
> >
> > --
> > You received this message because you are subscribed to the Google Groups
> > "Racket Users" group.
> > To unsubscribe from this group and stop receiving emails from it, send an
> > email to racket-users+unsubscr...@googlegroups.com.
> > To view this discussion on the web visit
> >
> https://groups.google.com/d/msgid/racket-users/CAE8gKoforSuxKVGwj2E_T-_HhLafaFipRGqERh6QUvyn6%2B9MUg%40mail.gmail.com
> .
> >
>
> --
> You received this message because you are subscribed to the Google Groups
> "Racket Users" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to racket-users+unsubscr...@googlegroups.com.
> To view this discussion on the web visit
> https://groups.google.com/d/msgid/racket-users/CAFUu9R5%2B%3DbdPTXwrNgu1ZKfjzRSOYy03FmMAiRN%2Br2o3DEyoUA%40mail.gmail.com
> .
>
--
You received this message because you are subscribed to the Google Groups
"Racket Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to racket-users+unsubscr...@googlegroups.com.
To view this discussion on the web visit
https://groups.google.com/d/msgid/racket-users/CAE8gKodPi7vr8Bvwnp9R4hiPzAf-68v-ZTPF2zH-i8KZqhSQKQ%40mail.gmail.com.
