I am having problems installing raco docs, meaning I want
raco docs foo-pkg
to work no matter how I installed the package. To give you an example of a
failure, I created a racket package and put it up on the raco pkg server:
https://pkgd.racket-lang.org/pkgn/package/bleir-sandbox
which refers to a github repo
https://github.com/rebcabin/bleir-sandbox
I then created two, fresh, Ubuntu 18.04 virtual machines via Virtual Box.
On both machines, I installed racket 8.2 as follows:
sudo apt install racket
sudo add-apt-repository ppa:plt/racket
sudo apt update
sudo apt upgrade
On machine 1, I did
raco pkg install bleir-sandbox
raco test .local/share/racket/8.2/pkgs/bleir-sanbox # all copacetic
raco docs bleir-sandbox
WORKS! Scribble docs show up in Firefox
On machine 2, I did
git clone https://github.com/rebcabin/bleir-sandbox.git
cd bleir-sandbox
git checkout master
cd ..
raco pkg install bleir-sandbox
raco test .local/share/racket/8.2/pkgs/bleir-sandbox # everything
copacetic
raco docs bleir-sandbox
NO MATCHES FOUND! Raco docs show no entries found for bleir-sandbox
Worse yet, if I try on machine 2 to do it the working way, it doesn't work,
and it fails forever more.
raco pkg remove bleir-sandbox
raco pkg install bleir-sandbox
raco test .local/share/racket/8.2/pkgs/bleir-sanbox # all copacetic
raco docs bleir-sandbox
NO MATCHES FOUND!, NEVER EVER AGAIN
I flushed Firefox cache, I did sudo racket setup for everything, and more
trial-and-error.
Incidentally, some packages installed from the cloud also don't install
docs. For example,
raco pkg install beautiful-racket # the package works great
raco docs beautiful-racket # NOT FOUND!
I have similar problems on Ubuntu 21, but racket doesn't install things in
.local/share/racket/8.2. In fact, I've been unable to find out where racket
is installing packages on Ubuntu 21 (i.e., in what directories), even thoug
raco pkg show
shows all the packages I expect to see, and they all apparently work
properly except for doc install.
Would someone be so kind as to help me
1) understand what the heck is going on?
2) find a reliable, robust way to always install the docs on the packages I
develop.
--
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/2d7ade99-9a57-41fb-9903-1b2e17fab361n%40googlegroups.com.
