Frank Peters wrote:
T. J. Frazier wrote:
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?
This is true but we don't have an approved list of all functions as yet.
The help for BASIC functions grew over more than a decade and help
was added in an, erm, more ad-hoc manner. I wish there would have been
such a formal process.
: 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.
this is what we will probably be doing once we have that ultimate
developer list of all-time-favourite BASIC functions.
-f
As a wannabe toolsmith, my interest lies in the automated process part.
The manual steps, with the magic developer list, will bring the Help up
to date. The automation will help /keep/ it up to date, in perpetuity.
I unzipped the Help jar, and wrote a little Basic code to extract the
titles from the files' meta-data, and sort them, non-case-sensitive.
Then I printed the list in two passes: one for the "Alpha List of ..."
in the Basic Help TOC, and the other for everything else. You probably
have better ways of doing this, further upline, but you're welcome to
the list and/or the code, if you like. I sent Uwe a copy of the list.
IMHO, the "_non_-case-sensitive" sorting is very important. I find it
jarring, when "AND Operator" is listed before "Abs Function", or
"CVError" is listed before "CVar", although those glitches are tiny, in
this particular list (only one position out of place).
I can't really help directly, until I break through one or both of these
entry barriers:
* Ubuntu:
** Installing as dual-boot with Windows Vista
** Setup and mastery (I've run Linux before, thanks be).
* WV: obtaining a SVN client (they only list WXP availability, so far)
Then I will ask for access rights ("You can mess with this! :-) "), if
I've earned them.
Meanwhile, I'll do what I can. /tj/
--
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
