Uwe Fischer wrote:
Hi T.J.,
On 01/28/09 20:10, T. J. Frazier wrote:
Uwe Fischer wrote:
Hi T. J.,
BTW: I thought the "Alphabetic List of Functions, Statements, and
Operators" would be generated automatically. Do you really have
to fix
that by hand?
(This was in reply to Uwe's question about the OLH.)
The list is in Help > Basic > Contents > Macros, etc. > Command
Reference > Alphabetic etc. It's one of my most-used resources;
seeing it incomplete gives me a chill.
AFAIK, that list of functions was generated automatically once,
many years ago. I never touched it. It is incomplete, for sure, but
then the whole "Contents" tab page was meant initially to be
incomplete, giving only the most often needed headings.
Uwe
Oh, dear, /oh, dear,/ *oh, dear!*
I was tempted to delete that list of reference info from the Basic
Help TOC. But if you are using it all the time, I will not delete
that list, of course. Additionally, I try to get a current list from
the developers and post it to the OOo Wiki.
Uwe
If you like, I would be glad to try generating the list automatically.
Scanning the page titles for "[RUNTIME]" should catch every current
entry except "Generating Random Numbers", which page title you could
fix. Expanding the search for "Function", "Operator", and "Statement"
should prove useful. Additionally, my list would not be case-sensitive
in its sort order, which the current list is (and shouldn't be, IMHO).
it is no problem to generate a list from the existing help pages. What
is needed now would be a list of existing BASIC functions. As I do not
plan to look into the sources, I've asked a BASIC developer to provide
such a list. Will ask him again today.
Excuse me if I'm getting a little confused, here. I'm envisioning a work flow
like this:
Developer list of functions includes (for example) "Zork Function".
Q: Does a page for that exist?
: No, -> list: "Pages we must write"
: Yes, update content as necessary.
: Q: Does the automated process index this page?
:: Yes again, fine; we are done with this item.
:: No, fix page title / attributes such that it will be indexed automatically.
Iterate for all developer list items.
Run automated index process as needed.
The automated index seems crucial. Indexing as I suggested above will make the list
noticeably longer. And sort it more usefully, too.
Uwe
btw, the *.xhp help source files are in your installation-folder/help/en
folder. Zipped as jar files.
Thanks for the tip. I /may/ just take a peek at those . . . :-)
--
T. J. Frazier
Melbourne, FL
(TJFrazier on OO.o)
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org
For additional commands, e-mail: dev-h...@documentation.openoffice.org
