[Paraview] Help file for Custom plugin NOT being included with Deployed ParaView.

[Michael Jackson]

It would seem that people writing plugins would want to provide some sort of help for their plugins but after looking through the Plugins directory that comes with ParaView I see that there are NO help files for any of those plugins which makes me think I am in the minority in this case. 

 It would seem that the first thing would be to push the generation of the documentation off until AFTER all the plugin CMake code has been run through. If this is possible (and easy) then moving forward with a mechanism to include help files becomes much easier. It almost is as easy as appending to PV_DOCUMENTATION_FILES. I would expect this could be included in a patch release for 3.12 if that occurs. If there is much more that needs to be done then 4.0 is probably a better target.

Thoughts.
--
Mike Jackson <www.bluequartz.net>

On Nov 21, 2011, at 2:53 PM, Utkarsh Ayachit wrote:

> Mike,
> 
> You're correct. This has been a long pending feature request. If
> there's enough interest in adding support for this, we can fix it for
> 4.0.
> 
> Utkarsh
> 
> On Mon, Nov 21, 2011 at 2:41 PM, Michael Jackson
> <mike.jackson at bluequartz.net> wrote:
>> It looks like currently there were not any provisions made to include a plugins help files into paraview directly. Looking through the CMake files the documentation is created _before_ the plugin CMake code is called so with out rearranging that cmake code there probably isn't any chance of having my documentation put in.
>> 
>>  Or I am just plain missing something.
>> --
>> Mike Jackson <www.bluequartz.net>
>> 
>> On Nov 21, 2011, at 1:44 PM, Michael Jackson wrote:
>> 
>>> I have written a couple of plugins for ParaView and updated them for 3.12.0. I have an HTML file for each filter/reader/writer that I created that contains the documentation. How can I get those files included into ParaView so that if the user clicks the "?" button my HTML page will show up?
>>> 
>>> Thanks
>>> ___________________________________________________________
>>> Mike Jackson                    Principal Software Engineer
>>> BlueQuartz Software                            Dayton, Ohio
>>> mike.jackson at bluequartz.net              www.bluequartz.net
>>> 
>> 
>> _______________________________________________
>> Powered by www.kitware.com
>> 
>> Visit other Kitware open-source projects at http://www.kitware.com/opensource/opensource.html
>> 
>> Please keep messages on-topic and check the ParaView Wiki at: http://paraview.org/Wiki/ParaView
>> 
>> Follow this link to subscribe/unsubscribe:
>> http://www.paraview.org/mailman/listinfo/paraview
>>