This is the mail archive of the
kawa@sourceware.cygnus.com
mailing list for the Kawa project.
Re: manual organization
Per Bothner <per@bothner.com> writes:
> brlewis@alum.mit.edu writes:
>
> > Particularly confusing items in the reference section might cross-ref
> > the tutorial section, e.g. primitive-[whichever]-method.
>
> And of course the tutorial can cross-reference the reference manual
> for the "gory details". But how many references are best?
I think just a few explicit cross-references in the most confusing
places, but lots of index entries.
--
Bruce R. Lewis