Partial documentation for the options system

Robert Graham Merkel rgmerk@mira.net
Mon, 04 Sep 2000 22:27:30 +1100


And The Boss said "write documentation, lackeys!".

And the lackeys said, "yes, as soon as we finish hacking away on
(insert cool feature here)"

And The Boss said "write documentation, lackeys, or you'll be
sentenced to debug VB."

And Robert said "Cool, VB!  I'd really Boag's Premium Lager myself,
but I'll quality test Victoria Bitter if you really insist."

And the rest of the lackeys said "No, he means . . . Visual Basic, a
language that combines all of the misfeatures of C++, Commodore 64 Basic, and
Microsoft Windows 3.1 distributed on floppies".

And Robert screamed "NOOOOOOOO . . ." and knuckled down and wrote some
documentation for the options system (in between installing an orb
drive so that if his machine crashes all will not be lost)/

I'll do a bit more later, but there's other bugs and stuff I need to
work on and this may as well go into the main tree.

begin 644 gnucash.diff.gz
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
>!4RV&(KCLT-Q\.KL]%2<'`T&9PSS_[Q(P2:^30``
`
end

------------------------------------------------------------
Robert Merkel	                           rgmerk@mira.net

------------------------------------------------------------