Hi Ox-users,
I recently upgraded Oxdoc to version 0.991alpha. I had some difficulties to get it running, and also found some minor bugs.
1.
Following the documentation I executed oxdoc.bat, which provides a short description, including:
Usage is:
java oxdoc [options] inputfile [inputfile ...]
But when I added a path it didn't work. I found that the call in the batchfile is different:
set oxdocjar=%~dp0oxdoc.jar
java -jar "%oxdocjar%" %*
and this could be changed to include the path. (I suppose the -jar switch is essential although not mentioned in the documentation.)
2.
I consider it inconvenient that every #include in files is expanded. I avoided that by excluding my main.ox (with containts all the #include's) from the Oxdoc command.
3.
An error occurs if a file start like:
/** This file contains...
#include it in main.ox
**/
Ox has no problem with the mentioning of #include inside a comment. I think it must be possible to comment out a preprocessor command. (Problem can be avoided by inserting a word before, at the same line.)
4.
Oxdoc reported an error at the start of a method like this:
aclass::thisweek()
{ return
GetVar("DATE") .>= dayofcalendar(2011, 04, 30) .&&
GetVar("DATE") .<= dayofcalendar(2011, 05, 08);
}
It seems that numbers with leading zeros are interpreted as octal, and so 08 is considered as wrong. But Ox has no octal numbers and those dates run correctly. (Error can be avoided by replacing leading zero by space.)
5.
Finally a question. When I open oxdoc.bat or oxdoc.log in Notepad, line breaks are missing. Probably Notepad (Windows XP) wants CRLF, while only LF (or only CR) is present. Is it possible to change the setting in Notepad?
Oxdoc is very useful, and several bugs already have been fixed since the earlier version I used. Thanks to Yori.
Regards,
Jaap
-----------------------------------------------------------------
Jacob J. de Vries
Department of Spatial Economics
Vrije Universiteit
De Boelelaan 1105
NL 1081 HV Amsterdam
Phone +31 20 59 86142
Fax +31 20 59 86004
[log in to unmask]
http://personal.vu.nl/j.j.de.vries/
-----------------------------------------------------------------
|