*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 <[email protected]>
wrote:
> On 9/28/21, David Storrs <[email protected]> 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 [email protected].
> > 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 [email protected].
> 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 [email protected].
To view this discussion on the web visit
https://groups.google.com/d/msgid/racket-users/CAE8gKodPi7vr8Bvwnp9R4hiPzAf-68v-ZTPF2zH-i8KZqhSQKQ%40mail.gmail.com.
