Hi List! Unfortunately, the online help feature is only *almost* ready, but I would like to add it to 0.99.5 as it's stable in my eyes - but I was busy the last days to do the final step. So here's my current problem in short, I'm looking for opinions.
Background: - using user-guide.chm on Win32 instead of .html files for the new "online help" has some advantages and is therefore desired - when the user looks into the help, having user-guide.chm locally installed frees user from having an internet connection - to enable WS to show user-guide.chm requires htmlhelp.h / .lib at compile time, which is not available as default for MSVC6 (but as a free download) - generating user-guide.chm requires some advanced tool/library setup (JAVA, FOP, ...) - therefore only developers of the guide itself should be required to generate user-guide.chm This means for the buildbot: - create docbook before the Wireshark setup - Gerald already changed this - it has htmlhelp.c/.lib already installed - no change - enabling WS setup.exe generation with user-guide.chm requires HHC_DIR set in config.nmake - can be easily changed This means for other developers (three options possible): A.) - disable HHC_DIR in config.nmake again (and as a consequence don't provide the online help with "personal generated" WS installations) - quite easy / but no help and a required change from the default values in config.nmake or B.): - install HTML HELP WORKSHOP, small download from Microsoft (2-3MB?) - easy, but some additional work - download user-guide.chm and copy it into the /docbook dir of the sources - maybe we could add this to the setup target somehow (where currently only the win32 libraries are downloaded) or C.) Declare docbook generation (user-guide, developer-guide) mandatory, which requires a lot of additional tools and libs - this seems overkill to me for this purpose. I would like to keep things for newbie developers as simple as possible. For this reason I prefer B.) as it seems to be the cleanest way without adding too much additional trouble for a newbie developer ... So which is the way to go? Regards, ULFL _______________________________________________ Wireshark-dev mailing list [email protected] http://www.wireshark.org/mailman/listinfo/wireshark-dev
