hmmm ... IMHO, if you want to keep "things simple as much as possible
for newbie developer", it's better to let people download the html user
guide and they won't need an internet connection either.
Why this wish of distinction between unix/win32 platforms with
.chm/.html?(sorry if there was already a discussion about that)
Regards,
Sebastien Tandel
Ulf Lamping wrote:
> 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
> Wireshark-dev@xxxxxxxxxxxxx
> http://www.wireshark.org/mailman/listinfo/wireshark-dev
>