[racket] How to document a package and access its documentation

From: Lawrence Woodman (lwoodman at vlifesystems.com)
Date: Tue Aug 13 06:15:10 EDT 2013

Hello all,

Thanks for the suggestions and for directing me to raco docs, which I 
hadn't come
across previously.

I have been able to render the scribble files and push them to github 
pages.  I then
pointed to this from the README file and set the project's homepage link 
to also
point here.  This solution is fine for me, but I am pleased to hear that 
in the future
the new package system will render the docs automatically.

I had been having problems generating the docs with raco setup, which
turned out to be partly because of a conflict between a previously 
installed PLaneT
collection and the package install.  This part of the problem has now 
partially resolved
itself as I deleted the installed PLaneT file.

However, despite being able to render the docs with scribble, I still 
can't render with
raco setup/ raco pkg install.  When I try, I get the following error:

     raco setup: --- building documentation ---
     raco setup: docs failure: application: not a procedure;
      expected a procedure that can be applied to arguments
       given: #f
       arguments...:
        'scribblings

Does anyone have any idea why this is being caused?  Or how I can go 
about investigating it?



bfn


Lorry

-- 
vLife Systems Ltd
Registered Office: The Meridian, 4 Copthall House, Station Square, Coventry, CV1 2FL
Registered in England and Wales No. 06477649
http://vlifesystems.com


Posted on the users mailing list.