IDLDoc Error [message #78403] |
Mon, 14 November 2011 12:22  |
David Fanning
Messages: 11724 Registered: August 2001
|
Senior Member |
|
|
Folks,
I have been doing a LOT of documentation work the past
couple of days, and after a rough start I have gotten
whole directories of files to compile without warning
messages from IDLDoc, version 3.3. I believe I am
starting to know what I am doing.
So, this afternoon I turned my attention to updating
my ActiveContour software. I marked up all the files
with rst mark-up, and when I was finished I executed
the very same idldoc command I have been using all
week:
IDL> idldoc, $
root='c:\idl\activecontour\source', $
output='c:\idl\activecontour\source\activecontourdocs', $
title='Coyote Graphics Active Contour Routines', $
subtitle= 'Date: ' + Systime(), /NoSource
Only this time, I get the following error:
Copying resources...
Parsing .\...
Parsing testapplication.pro...
% IDLDOC: Array dimensions must be greater than 0.
If I remove testapplication.pro, it fails on the next
file. In fact, it won't work with *any* file in the
directory. Which leads me to conclude something
else is wrong. Does anyone have any clues?
Thanks,
David
--
David Fanning, Ph.D.
Fanning Software Consulting, Inc.
Coyote's Guide to IDL Programming: http://www.idlcoyote.com/
Sepore ma de ni thui. ("Perhaps thou speakest truth.")
|
|
|
|
|
|
|
Re: IDLDoc Error [message #78537 is a reply to message #78403] |
Tue, 29 November 2011 10:10  |
Michael Galloy
Messages: 1114 Registered: April 2006
|
Senior Member |
|
|
On 11/28/11 4:03 PM, Michael Galloy wrote:
> On 11/28/11 1:02 PM, Michael Galloy wrote:
>> On 11/24/11 1:59 AM, sebastian wrote:
>>> Unfortunately I always get the error message:
>>>
>>> % IDLDOC: Attempt to subscript V2PARTS with I is out of range.
>>> -162
>>>
>>> with idldoc-3.4! What's the problem?
>>>
>>> And it still eats up a lot of memory, but I coudn't test it with our
>>> whole library (> 2000 files) due to the error above. idldoc-3.3 never
>>> could finish all files due to a memory crash of IDL (around 2 GB)! Is
>>> it somehow possible to split it up? E.g. use idldoc on certain folders
>>> and then merge the htmls?
>>
>> That error is coming from the routine that compares version numbers, so
>> I would suspect IDLdoc is having a problem with something in a
>> :Requires: field. I am tracking this down and will provide a patch when
>> I figure it out (if it is easy for you to find the contents of the
>> :Requires: fields, that would be handy information for me).
>>
>> The memory issue is a bit trickier. The IDL library is about 1400 files
>> and IDLdoc runs through it on my computer (though it can take almost an
>> hour). A merge of partial runs might be a solution, though that would
>> take some significant work.
>
> OK, I believe I have a fix for this. I will send you a beta offline to
> see if this fixes the issue for you.
>
> Mike
OK, I have a fix that works for Sebastion (both for the crash and the
memory limits, though I didn't do anything for the memory issue in this
release, it was fixed along the way somehow), so I'm releasing 3.4.1.
Get it here:
http://idldoc.idldev.com/wiki/Downloads
Mike
--
Michael Galloy
www.michaelgalloy.com
Modern IDL, A Guide to Learning IDL: http://modernidl.idldev.com
Research Mathematician
Tech-X Corporation
|
|
|
Re: IDLDoc Error [message #78557 is a reply to message #78412] |
Mon, 28 November 2011 15:03  |
Michael Galloy
Messages: 1114 Registered: April 2006
|
Senior Member |
|
|
On 11/28/11 1:02 PM, Michael Galloy wrote:
> On 11/24/11 1:59 AM, sebastian wrote:
>> Unfortunately I always get the error message:
>>
>> % IDLDOC: Attempt to subscript V2PARTS with I is out of range.
>> -162
>>
>> with idldoc-3.4! What's the problem?
>>
>> And it still eats up a lot of memory, but I coudn't test it with our
>> whole library (> 2000 files) due to the error above. idldoc-3.3 never
>> could finish all files due to a memory crash of IDL (around 2 GB)! Is
>> it somehow possible to split it up? E.g. use idldoc on certain folders
>> and then merge the htmls?
>
> That error is coming from the routine that compares version numbers, so
> I would suspect IDLdoc is having a problem with something in a
> :Requires: field. I am tracking this down and will provide a patch when
> I figure it out (if it is easy for you to find the contents of the
> :Requires: fields, that would be handy information for me).
>
> The memory issue is a bit trickier. The IDL library is about 1400 files
> and IDLdoc runs through it on my computer (though it can take almost an
> hour). A merge of partial runs might be a solution, though that would
> take some significant work.
OK, I believe I have a fix for this. I will send you a beta offline to
see if this fixes the issue for you.
Mike
--
Michael Galloy
www.michaelgalloy.com
Modern IDL, A Guide to Learning IDL: http://modernidl.idldev.com
Research Mathematician
Tech-X Corporation
|
|
|