comp.lang.idl-pvwave archive
Messages from Usenet group comp.lang.idl-pvwave, compiled by Paulo Penteado

Home » Public Forums » archive » IDLDoc Error
Show: Today's Messages :: Show Polls :: Message Navigator
E-mail to friend 
Switch to threaded view of this topic Create a new topic Submit Reply
IDLDoc Error [message #78403] Mon, 14 November 2011 12:22 Go to next message
David Fanning is currently offline  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 #78412 is a reply to message #78403] Mon, 28 November 2011 12:02 Go to previous messageGo to next message
Michael Galloy is currently offline  Michael Galloy
Messages: 1114
Registered: April 2006
Senior Member
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.

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 #78455 is a reply to message #78403] Thu, 24 November 2011 00:59 Go to previous messageGo to next message
sh is currently offline  sh
Messages: 26
Registered: April 2010
Junior Member
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?

Cheers,
Sebastian
Re: IDLDoc Error [message #78487 is a reply to message #78403] Tue, 22 November 2011 13:46 Go to previous messageGo to next message
David Fanning is currently offline  David Fanning
Messages: 11724
Registered: August 2001
Senior Member
Michael Galloy writes:

> And, how could I forget, a new color scheme!

Yes, and very attractive, too! :-)

Cheers,

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 #78489 is a reply to message #78403] Tue, 22 November 2011 10:29 Go to previous messageGo to next message
Michael Galloy is currently offline  Michael Galloy
Messages: 1114
Registered: April 2006
Senior Member
On 11/21/11 2:59 PM, Michael Galloy wrote:
> IDLdoc 3.4 was released today. Download at:
>
> idldoc.idldev.com/wiki/Downloads
>
> Release notes:
>
> * Allow LaTeX equation formatting.
>
> * Fix for bug where links to routines, files, etc. in directory
> overview comments on the overview page were not correct.
>
> * Adding links to parent items in index entries.
>
> * Changes to HTML output styling including larger type size.
>
> * Fixed bug where DLM contents could not be references using backtick
> notation in rst markup syntax.
>
> * Added private and hidden attributes to directory names in overview
> file.
>
> * Not showing warnings page when USER keyword is set.
>
> * Fixed bug where parsing rst Requires tag would cause IDLdoc to crash.
>
> * Fixed bug where Warnings page showed items from private or hidden
> items.

And, how could I forget, a new color scheme!

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 #78537 is a reply to message #78403] Tue, 29 November 2011 10:10 Go to previous message
Michael Galloy is currently offline  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 Go to previous message
Michael Galloy is currently offline  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
  Switch to threaded view of this topic Create a new topic Submit Reply
Previous Topic: Re: IDL QUESTIONS(time convection)
Next Topic: Looping code for proccessing multiple files

-=] Back to Top [=-
[ Syndicate this forum (XML) ] [ RSS ] [ PDF ]

Current Time: Wed Oct 08 19:23:51 PDT 2025

Total time taken to generate the page: 0.00693 seconds