IAre there any good examples of how to use these? So far, I haven't gotten any of them to work as expected. Thanks -- lynn
Example #1 -- Attempt to pass in an array of strings as Basenames. None of these work:
BASENAMES="docset_prewrittenFileBasenames='README'"
BASENAMES="docset_prewrittenFileBasenames=list('README',)"
BASENAMES="docset_prewrittenFileBasenames=list('README','')"
BASENAMES="docset_prewrittenFileBasenames=README,FOO"
Example #2 -- Attempt to turn on TRACE with -v option
Example #3 -- Attempt to use my own formatter class.
FORMATTER="-F MulticolorHTMLTable"
Example #4 -- Attempt to over-ride formatter colors.
COLOR="formatter_bgcolor1='#FFEFDD'"
I'm trying to put these into a shell script and then call the 'happydoc'. None will work. help !!
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
#1 - This is probably a limitation of the fact that the list is not evaled. The options are all treated as strings. This problem is eliminated in 3.0, since all files are treated based on mimetype and text files will be converted automatically just because they are there. In the mean time, you could edit your happydoc source to add to the default list. Take a look at happydoclib/happydocset.py.
#2 - Tracing is enabled with an environment variable. For example:
% export HAPPYDOC_TRACE=1
% happydoc ...
#3 - If you have created your own formatter plugin, and dropped it into the right directory, using the -F option on the command line should work correctly.
#4 - Maybe if you posted the shell script, I could look at it and help you better?
Doug
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
Thanks for your quick assist :)
IThe main problem was with the -v and getopt treating everything that followed it, as a non-option.
2 more things:
1. when will v3 be out?
2. i've found a few bugs in this version. would it help to know what they are? or will V3 obsolete all these bugs?
Thansk again.
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
I don't have a schedule for 3.0 yet. The code that is checked in is almost usable for creating HTML documentation, but it does not include all of the features of 2.x yet, and (since it is prototype code) may change drastically before the final release.
Version 3 will probably make any existing bugs obsolete, but you should report them anyway so I make sure that is the case. :-)
Doug
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
IAre there any good examples of how to use these? So far, I haven't gotten any of them to work as expected. Thanks -- lynn
Example #1 -- Attempt to pass in an array of strings as Basenames. None of these work:
BASENAMES="docset_prewrittenFileBasenames='README'"
BASENAMES="docset_prewrittenFileBasenames=list('README',)"
BASENAMES="docset_prewrittenFileBasenames=list('README','')"
BASENAMES="docset_prewrittenFileBasenames=README,FOO"
Example #2 -- Attempt to turn on TRACE with -v option
Example #3 -- Attempt to use my own formatter class.
FORMATTER="-F MulticolorHTMLTable"
Example #4 -- Attempt to over-ride formatter colors.
COLOR="formatter_bgcolor1='#FFEFDD'"
I'm trying to put these into a shell script and then call the 'happydoc'. None will work. help !!
#1 - This is probably a limitation of the fact that the list is not evaled. The options are all treated as strings. This problem is eliminated in 3.0, since all files are treated based on mimetype and text files will be converted automatically just because they are there. In the mean time, you could edit your happydoc source to add to the default list. Take a look at happydoclib/happydocset.py.
#2 - Tracing is enabled with an environment variable. For example:
% export HAPPYDOC_TRACE=1
% happydoc ...
#3 - If you have created your own formatter plugin, and dropped it into the right directory, using the -F option on the command line should work correctly.
#4 - Maybe if you posted the shell script, I could look at it and help you better?
Doug
Thanks for your quick assist :)
IThe main problem was with the -v and getopt treating everything that followed it, as a non-option.
2 more things:
1. when will v3 be out?
2. i've found a few bugs in this version. would it help to know what they are? or will V3 obsolete all these bugs?
Thansk again.
I don't have a schedule for 3.0 yet. The code that is checked in is almost usable for creating HTML documentation, but it does not include all of the features of 2.x yet, and (since it is prototype code) may change drastically before the final release.
Version 3 will probably make any existing bugs obsolete, but you should report them anyway so I make sure that is the case. :-)
Doug