# Raco doc for user scope installed packages

**URL:** <https://racket.discourse.group/t/raco-doc-for-user-scope-installed-packages/2612>\
**Category:** General\
**Created:** [December 23, 2023, 2:03am UTC](https://racket.discourse.group/t/raco-doc-for-user-scope-installed-packages/2612 "2023-12-23T02:03:12Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![bremner](https://avatars.discourse-cdn.com/v4/letter/b/aca169/32.png) [@bremner](https://racket.discourse.group/u/bremner)\
**Post date:** [December 23, 2023, 2:03am UTC](https://racket.discourse.group/t/raco-doc-for-user-scope-installed-packages/2612/1 "2023-12-23T02:03:12Z")

</div>

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

---

<div class="post-metadata">

**Author:** ![shhyou](https://avatars.discourse-cdn.com/v4/letter/s/ccd318/32.png) [@shhyou](https://racket.discourse.group/u/shhyou)\
**Post date:** [December 23, 2023, 6:47pm UTC](https://racket.discourse.group/t/raco-doc-for-user-scope-installed-packages/2612/2 "2023-12-23T18:47:11Z")

</div>

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](https://github.com/racket/racket/issues/4400). 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.

---

<div class="post-metadata">

**Author:** ![bremner](https://avatars.discourse-cdn.com/v4/letter/b/aca169/32.png) [@bremner](https://racket.discourse.group/u/bremner)\
**Post date:** [December 24, 2023, 12:34am UTC](https://racket.discourse.group/t/raco-doc-for-user-scope-installed-packages/2612/3 "2023-12-24T00:34:20Z")

</div>

shhyou via Racket Discourse [notifications@racket.discoursemail.com](mailto: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](https://github.com/racket/racket/issues/4400). 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.