Chunked guide

Jon Hermansen jon.hermansen at
Sun Jul 20 08:27:45 PDT 2008

I found that having the guide all on one page was VERY handy, I was skipping
all around it when I wrote my first port. Since package management isn't too
scary to me, and building from source isn't either, I essentially knew how
to build the package I was trying to write, but I didn't know how to
implement it in a Portfile. Getting help in IRC and cross-referencing
people's suggestions with information from the guide made things really

Anyways, just my two cents.

On Sun, Jul 20, 2008 at 10:34 AM, <markd at> wrote:

> >Hi,
> >
> >I just committed a new target "guide-chunked" to the doc-new Makefile
> >which
> >generates a chunked version of the guide [1].
> >
> >I used a Tcl script to add the table of contents to each page. Please
> >have a
> >look at [2] and tell me what you think.
> >
> >If you like it we can activate the guide-chunked target on the
> >documentation
> >server and make it available to everybody.
> >
> >Thanks,
> >Simon
> Thanks for your work on this!  That is some nice scripting work.  I think
> we should make the chunked guide available now that you've got the TOC
> handled.  I think the real question now is whether to keep a "single html"
> version around.  The only "problem" with the chunked version is you can't
> do a browser search of the whole document, but I'm not sure how many
> people want that.  I can live without it.  I'd like to hear comments from
> others.
> If a consensus is that keepind a "single html" version around is
> desirable, I wouldn't want to make people select between two versions
> before viewing, but provide a link to a "single html" version as an option
> so the chunked version is the default viewing methood.
> Mark
> _______________________________________________
> macports-dev mailing list
> macports-dev at
-------------- next part --------------
An HTML attachment was scrubbed...

More information about the macports-dev mailing list