Raco doc for user scope installed packages

General
1

I have several packages installed in user scope, and for some of them
"raco doc pkgname" works, but not others. I'm not sure if this a bug in
the individual packages, or some problem with my setup (racket-cs 8.10
on Debian)

For example, given the (edited) list below, I would expect

raco doc {markdown,frog,plait} to work, but only the first two do

% find ~/.local/share/racket/8.10/pkgs -name index.html
/home/bremner/.local/share/racket/8.10/pkgs/markdown/markdown/doc/markdown/index.html
/home/bremner/.local/share/racket/8.10/pkgs/frog/frog/doc/frog/index.html
/home/bremner/.local/share/racket/8.10/pkgs/plait/doc/plait/index.html

2

I recall seeing similar scenarios in `raco docs foo` finds no matches for packages installed in user's home directory · Issue #4400 · racket/racket · GitHub. But for what was reported in #4400, it looks like the docs were missing because there were errors during raco setup. I am not sure if something similar happens here.

3

shhyou via Racket Discourse notifications@racket.discoursemail.com
writes:

I recall seeing similar scenarios in
`raco docs foo` finds no matches for packages installed in user's home directory · Issue #4400 · racket/racket · GitHub. But for what was
reported in #4400, it looks like the docs were missing because there
were errors during raco setup. I am not sure if something similar
happens here.

Thanks for the suggestion. If there are errors, then they are not
reported (exit status from raco pkg install plait is 0). It is
(potentially) interesting that the reports are about the ubuntu PPA,
which organizes things in the same way as the debian packages, afaik.