Subject: per-package documentation in on-line help system
From: Raymond Toy
Date: Fri, 04 Jan 2013 08:57:59 -0800
>>>>> "Robert" == Robert Dodier <robert.dodier at gmail.com> writes:
Robert> I've committed some code to bring per-package (share packages, that is)
Robert> documentation into the on-line help system. As with the general
Robert> documentation, per-package stuff is written in Texinfo and compiled to
Robert> .info, the .info is searched to build an index, and the index is
Robert> searched at run time for the ? and ?? commands.
Robert> So far the scheme is not fully automated -- makeinfo, build_index.pl,
Robert> and load(my_index) all have to be executed by hand. Let's talk about
Robert> suitable ways to automate this stuff.
Finally got around to trying this out. Cool!
What are your thoughts on integrating this? It seems to me that all
of these things should be built at the same time as when we build the
main info files so that the user doesn't have to.
I'm not sure about how to integrate the new per-package docs though.
Maybe we can arrange it so that when the package is loaded, the lisp
file for the documentation is also loaded? But that means no docs
unless you know to load the package.
Ray