Thanks for this opportunity to comment on the dev doc. I'd like to point
out a potential ambiguity. I confess, I don't have the doc in front of
me; I hope what I sketch is sufficiently robust that someone can spot
the issue properly.
It deals with the early stages of building from source using cygwin. The
instructions call for running ./configure, then shuffling some files
around (they were already where they belong). From memory of the issues
I ran into, the instructions then ask you to run dmake.
dmake is built by ./bootstrap (at least on my build). Nothing told me
about that. Here is the ambiguity: it is possible that during "proper"
(whatever that means) execution of ./configure, ./bootstrap would have
been run already. It didn't run; I had to execute it myself. It did,
indeed, build dmake. I found that it builds dmake by reading the code.
But, dmake failed because it needed something down in (memory again)
/usr/local/... in a directory that *does not exist*. Again, the
ambiguity: is it possible that ./configure would create what dmake
wanted? is it possible that dmake build would create that itself (text
search found no hint that the necessary directory was to be created). Is
it possible that I have a bad cygwin installation? Is it possible that
/usr/local/... doesn't exist and there is a bug in dmake?
The documentation, for me, blew right over any potential issues in this
area and google has, to date, been no help (though google got me through
./configure :)
Thoughts?
Thanks
Jack
Michael Hoennig wrote:
<snip>
*** =================================================================
*** Reviewing the documentation and report issues if you find any
*** -----------------------------------------------------------------
Besides others, the OOo SDK contains a Developers Guide and a
Reference Guide. It's not only important for developers who
want to develop applications with OOo to know these well.
There is also always room for improvement in such documents.
Thus, read the documentation:
-> http://api.openoffice.org/DevelopersGuide/DevelopersGuide.html
-> http://api.openoffice.org/docs/common/ref/com/sun/star/module-ix.html
And when you find anything to improve which you think should actually
be improved, report an issue to IssueZilla.
After once being registered with IssueZilla, reporting an issue is
just a matter of minutes.
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
