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 #72654 is a reply to message #72510]

Mon, 20 September 2010 21:23

penteado
Messages: 866
Registered: February 2018

Senior Member
Administrator

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?

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:27 PDT 2025

Total time taken to generate the page: 0.71978 seconds