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.
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.
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.
