[idldoc] difference between log and warnings
Françoise Pinsard
Francoise.Pinsard at locean-ipsl.upmc.fr
Mon Dec 10 01:20:58 PST 2007
log file and idldoc-warnings.html are different.
For example (idldoc3.0b3 outputs) I can read in my log file
Parsing pb_continuation.pro...
IDLDOC: param param1 not found in commaafter
IDLDOC: param param2 not found in commaafter
and I only see in idldoc-warnings.html
./pb_continuation.pro: commaafter
partial documentation
On other example with tp1.pro
I can read in my log file
Parsing tp1.pro...
IDLDOC: unknown tag "returns" in file tp1.pro
while I see in idldoc-warnings.html
./tp1.pro: my_routine
no documentation
This last information is quite severe because in fact I have some file
comments in tp1.pro
We can say that log file is for code maintainer and idldoc-warnings.html
is more for end-users but in fact we would like end-users to become code
maintainer so it will be great to have the same king of informations in
both : the detail one (log) and the synthetic one (idldoc-warnings.html)
--
Françoise Pinsard
LOCEAN - IPSL
UMR 7159 CNRS/IRD/UPMC/MNHN
Université Pierre et Marie Curie aile 45-55 5 étage pièce 516
Case 100 - 4 Place Jussieu 75252 Paris cedex 05
Tél. +33 1 44 27 47 65 Fax +33 1 44 27 71 59
mailto:Francoise.Pinsard at locean-ipsl.upmc.fr
http://www.locean-ipsl.upmc.fr/
More information about the idldoc
mailing list