search

mgalloy / idldoc

Documenting IDL code
Other
20 stars 13 forks source link

COMMENT_STYLE keyword only changes the extension of the output #86

Closed sappjw closed 8 years ago

sappjw commented 8 years ago

When using different COMMENT_STYLE keyword settings (e.g., 'plain' or 'rst'), the only thing that changes about the output is the extension of the resulting files. The content remains HTML.

mgalloy commented 8 years ago

I will take a look at this. Are you using the latest release or the GitHub repo?

Also, the options for COMMENT_STYLE are "rst", "html", or "latex".

sappjw commented 8 years ago

I'm using the repo HEAD. And I'd like the RST output, but I wanted to try other options based on these lines.

mgalloy commented 8 years ago

Ah, TEMPLATE_PREFIX needs to change with COMMENT_STYLE. I have added a commit (19a93c8) that automatically sets TEMPLATE_PREFIX for "latex" and "docbook" comment styles. There are currently no templates for "rst" and "plain" output; if you play around with this and create some, please make a pull request!

Please let me know if this helps.

sappjw commented 8 years ago

I see, thanks for the clarification.

mgalloy commented 8 years ago

The two-step process wasn't very user-friendly. Hopefully it will be easier to deal with now.