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