> > On second thought. It would be much simpler and just as effective to
> > move some functions around a bit and divide the file with a few more
> > page breaks.
>
> I agree on this one. 3000 lines ins't a lot, especially when you compare
> it to 25000 lines of org.el. But org.el is organized nicely with
> outlines, instead of page breaks. Maybe you should consider outlines for
> package.el as well. Outlines are easy to navigate, fold and narrow into.

Yes, I'll add a comment outline to every page break (as is the usual style), as well as a short description.