[Openmcl-devel] Ways around the with-simple-restart bug?
dankna at accela.net
Wed Dec 8 00:23:47 UTC 2004
> I can offer some help as well - i'm just not shure what sort of help
> I've OpenMCL (CVS) running on my Debian/GNU/Linux system for quite some
> time now (just modified Kevin Rosenberg's build setup for the Debian
> package). So i can offer testing on both Debian and MOSX-10.2 (never
> could justify to spend money on the OSX upgrade again ...).
> Any place i could contribute? (I'v quite some experience with XML
> so i might have a closer look at the docs. Righ now i try to get manual
> into a recent printed version).
What is it you're trying to do, exactly? Frustration with the build
of the docs? Yeah, I never wrote up any step-by-step on that because so
far, only me and Gary have had to do it... It's as simple as running
in the top level of the docs tree, except that you have to have the
tools installed. They are listed in the makefile, so read it and see
I haven't tested the docs with any target except html. The stuff in
xsl/ directory makes some customizations which are html-specific;
some of them are appropriate for a printed-book target and some are not.
If that's what you're trying to do, I can take a look at it and see
If you're interested in helping with the docs, well, most of what I
editing for content and clarity, and only a small part is messing with
would urge you to give your time first to getting a new distribution
out the door,
since that's more important than the things I haven't gotten around to
my to-do list...
The offer of testing is also a good one, and will probably be useful.
All that said, though, if you have experience with docbook or are
learn, I definitely need to improve the speed of the build process.
mostly consists of turning on profiling in the (documentation) makefile
figuring out which standard stylesheets and DTDs it's pulling from the
network because it doesn't have them locally, and how I can make it find
the local copies. Of course, it's not quite as simple as that because
which are installed on your local machine are not the same as the ones
the server... Perhaps modify the profiling to save its output to a file
somewhere that can be viewed on the live page...
Once that's done - and only then, because doing it in the obvious way
approximately double the time the docs take to build - there needs to be
a mechanism for persistently linking to a specific chapter from
from on-site pages which aren't part of the Doc/ subdirectory. The
filenames all change (well, except for the dictionary entries) when
are added or moved, is the problem.
Be sure you're using the same versions of docbook and the stylesheets
are listed on the bottom of every page on the site.
I also do have a list of things that need to be written. I've
And then, I need to make editing passes through the whole thing to clean
up things like making sure symbols are listed as ccl: or ccl:: when
in the ccl package, ...
And there was a request at one point for an OpenGL section (but I
have any information to base it on...), and I've been wanting to take
stuff from the ccl/examples/ directory and integrate it with the docs
write real tutorials about it, and there's a bunch of private
variables that are used to configure OpenMCL, which all ought to be
listed in some central place, ...
-- Dan Knapp
The definitive list of symbols exported from CCL is in
Functions which should be documented:
with-autorelease-pool and related
process-name (function, setf-able)
process-initial-form (function, read-only)
process-priority (function, setf-able)
process-total-run-time (function, read-only)
process-creation-time (function, read-only)
process-reset-and-enable (function, identical to reset then enable)
let-globally (macro, complicated...)
Write <refpurpose>s for:
[and lots and lots of other dictionary entries, too]
Do content edits on:
From the Sockets Dictionary:
From the External-Program Dictionary:
Reformat the dictionary chapters of AMOP and include them in the docs
(this is explicitly permitted by their license).
Cleanup which somebody else should do:
The following symbols are exported from CCL but not defined anywhere:
More information about the Openmcl-devel