comp.lang.idl-pvwave archive: archive

Home » Public Forums » archive » IDLDoc Bandwagon

Show: Today's Messages :: Show Polls :: Message Navigator
E-mail to friend

Re: IDLDoc Bandwagon [message #72646 is a reply to message #72510]

Tue, 21 September 2010 07:02

Michael Galloy
Messages: 1114
Registered: April 2006

Senior Member

On 9/20/10 10:23 pm, Paulo Penteado wrote:
> On Sep 21, 1:16 am, Paulo Penteado<pp.pente...@gmail.com> wrote:
>> On Sep 21, 12:54 am, Michael Galloy<mgal...@gmail.com> wrote:
>>
>>> It's painful to convert existing files, so individual files can specify
>>> their own FORMAT_STYLE/MARKUP_STYLE by putting a "docformat" comment on
>>> the *first line* of the file, like:
>>
>>> ; docformat = 'rst rst'
>>
>>> or
>>
>>> ; docformat = 'IDL preformatted'
>>
>> I had not noticed that the markup style could fix the newlines for old
>> comments.
>>
>> What I have been using, to make the old files work unaltered, is to
>> specify fortmat_style='IDL' in the call to IDLDoc, and always put the
>> docformat on the new files, to override the IDL format.
>
> By the way, I noticed that using fortmat_style='IDL' in the IDLDoc
> call seems to supress the contents of the overview file. Is this
> intended?

Not everything is supported in the "legacy styles." I would like to, but
I just haven't finished everything for them. Expect new features in the
rst format/markup styles, but not really anything new in the IDL/IDLdoc
format styles.

Mike
--
www.michaelgalloy.com
Research Mathematician
Tech-X Corporation

Report message to a moderator

[Message index]

		IDLDoc Bandwagon By: David Fanning on Mon, 20 September 2010 16:48
		Re: IDLDoc Bandwagon By: David Fanning on Tue, 21 September 2010 14:32
		Re: IDLDoc Bandwagon By: Michael Galloy on Tue, 21 September 2010 14:12
		Re: IDLDoc Bandwagon By: David Fanning on Tue, 21 September 2010 10:17
		Re: IDLDoc Bandwagon By: Michael Galloy on Tue, 21 September 2010 07:16
		Re: IDLDoc Bandwagon By: Michael Galloy on Tue, 21 September 2010 07:02
		Re: IDLDoc Bandwagon By: David Fanning on Mon, 20 September 2010 21:53
		Re: IDLDoc Bandwagon By: penteado on Mon, 20 September 2010 21:30
		Re: IDLDoc Bandwagon By: penteado on Mon, 20 September 2010 21:23
		Re: IDLDoc Bandwagon By: David Fanning on Mon, 20 September 2010 21:20
		Re: IDLDoc Bandwagon By: penteado on Mon, 20 September 2010 21:16
		Re: IDLDoc Bandwagon By: Michael Galloy on Mon, 20 September 2010 20:54
		Re: IDLDoc Bandwagon By: penteado on Mon, 20 September 2010 18:29
		Re: IDLDoc Bandwagon By: penteado on Mon, 20 September 2010 18:27

Previous Topic:	The variable shellCmd is not defined
Next Topic:	Coyote and Catalyst Libraries Available on SVN Repository

-=] Back to Top [=-

[ Syndicate this forum (XML) ] [

] [

]

Current Time: Sat Oct 11 14:38:41 PDT 2025

Total time taken to generate the page: 0.47682 seconds