[racket] How to document a package and access its documentation
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