launch help in pdf or on web

[Petr Mikulik]

Gnuplot on OS/2 and Windows had always an interactive (GUI) help reader for
their INF and HLP help formats, respectively. Nowadays, MS removed the 32
bit HLP reader from the default Windows Vista installation and it has to be
installed separately. Is it easy to switch the format to 16 bit HLP (for
which WinHelp.exe is still installed by default)? Or shell we ship the CHM
help file (is there an appropriate convertor for gnuplot formats? I've
googled one shareware hlp2chm.exe.)?

Nowadays, there are GUIs for gnuplot running under other systems, i.e. wxt
and qt. That would be nice if their menus can launch the interactive help
files, i.e. help in PDF (using default pdf reader) or help on web (using
default html browser). Possible new menu items could be:
- Help in PDF
- Help on web
- Demos on web
- Faq on web

Or will this be a job for the GUIs or for new gnuplot commands? E.g.

helppdf splot
helpweb splot

---
PM

------------------------------------------------------------------------------
Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
trial. Simplify your report design, integration and deployment - and focus on
what you do best, core application coding. Discover what's new with
Crystal Reports now.  http://p.sf.net/sfu/bobj-july
_______________________________________________
gnuplot-beta mailing list
gnuplot-beta@...
https://lists.sourceforge.net/lists/listinfo/gnuplot-beta

[Ethan Merritt]

On Friday 04 September 2009 00:27:22 Petr Mikulik wrote:

> Nowadays, there are GUIs for gnuplot running under other systems, i.e. wxt
> and qt. That would be nice if their menus can launch the interactive help
> files,  i.e. help in PDF (using default pdf reader) or help on web (using  
> default html browser).

I think you have pointed to the heart of the problem.
How is an application program like gnuplot supposed to know what the "default"
application launcher is?  The match-up of mimetype to preferred application
is a desktop- or system-level function.  I have no clue about Windows,
but on many linux desktop configurations you can select with the mouse
any text string that is a well-formed URL and it will give you the option
to launch a browser. From this perspective it would be sufficient to do:
gnuplot> help foo
         Please see http://gnuplot.sourceforge.net/docs/gnuplot.pdf


------------------------------------------------------------------------------
Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
trial. Simplify your report design, integration and deployment - and focus on
what you do best, core application coding. Discover what's new with
Crystal Reports now.  http://p.sf.net/sfu/bobj-july
_______________________________________________
gnuplot-beta mailing list
gnuplot-beta@...
https://lists.sourceforge.net/lists/listinfo/gnuplot-beta

[Tatsuro MATSUOKA-5]

Hello

--- Petr Mikulik wrote:

> Or shell we ship the CHM
> help file (is there an appropriate convertor for gnuplot formats? I've
> googled one shareware hlp2chm.exe.)?

I have tried to convert the html-style gnuplot documents to a chm file by HTML Help Workshop.
However customization of html files to chm help for index or so will be recommended.

Now html documents in 'make' are produced by latex2html.

I think that it is better to convert doc2rtf for Help Workshop to program like doc2html for HTML Help
Workshop.

I have tried the above. However, my limited ability and time prevents me to go ahead :-( .

Regards

Tatsuro
   

--------------------------------------
Thanks 10 years!  Yahoo! Shopping and Yahoo! Auctions
http://pr.mail.yahoo.co.jp/ec10years/

------------------------------------------------------------------------------
Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
trial. Simplify your report design, integration and deployment - and focus on
what you do best, core application coding. Discover what's new with
Crystal Reports now.  http://p.sf.net/sfu/bobj-july
_______________________________________________
gnuplot-beta mailing list
gnuplot-beta@...
https://lists.sourceforge.net/lists/listinfo/gnuplot-beta

[Tatsuro MATSUOKA-5]

Hello

http://www.geocities.jp/tmgpltwin/Files/Files.html
0022 gnuplot.chm.zip, 376,810 bytes, 2009-09-07, zipped gnuplot.chm file generated by HTML Help
Complier

The above file was made by mere translattion of htmldocs of the recent cvs sources.
That is a mere test of HTML Help Complier.

In the HTML help complier has ability to transtale *.hpj to *.hhp (HTML Help Project file).
However it could not be used.

Regards

Tatsuro
 

--- Tatsuro MATSUOKA  wrote:

> Hello
>
> --- Petr Mikulik wrote:
>
> > Or shell we ship the CHM
> > help file (is there an appropriate convertor for gnuplot formats? I've
> > googled one shareware hlp2chm.exe.)?
>
> I have tried to convert the html-style gnuplot documents to a chm file by HTML Help Workshop.
> However customization of html files to chm help for index or so will be recommended.
>
> Now html documents in 'make' are produced by latex2html.
>
> I think that it is better to convert doc2rtf for Help Workshop to program like doc2html for HTML
> Help
> Workshop.
>
> I have tried the above. However, my limited ability and time prevents me to go ahead :-( .
>
> Regards
>
> Tatsuro
>    

--------------------------------------
Thanks 10 years!  Yahoo! Shopping and Yahoo! Auctions
http://pr.mail.yahoo.co.jp/ec10years/

------------------------------------------------------------------------------
Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
trial. Simplify your report design, integration and deployment - and focus on
what you do best, core application coding. Discover what's new with
Crystal Reports now.  http://p.sf.net/sfu/bobj-july
_______________________________________________
gnuplot-beta mailing list
gnuplot-beta@...
https://lists.sourceforge.net/lists/listinfo/gnuplot-beta

[Petr Mikulik]

> > Or shell we ship the CHM help file (is there an appropriate convertor
> > for gnuplot formats? I've googled one shareware hlp2chm.exe.)?
>
> I have tried to convert the html-style gnuplot documents to a chm file by HTML Help Workshop.
> However customization of html files to chm help for index or so will be recommended.
>
> I think that it is better to convert doc2rtf for Help Workshop to program
> like doc2html for HTML Help Workshop.

HTML Help Workshop says it can convert rtf (such as gnuplot.rtf) into CHM.
However, it does not work for me -- on WXP or Wine it says that some DLLs
are incorrect.

Has somebody succeeded?


> Now html documents in 'make' are produced by latex2html.
> I have tried the above. However, my limited ability and time prevents me to go ahead :-( .
>
> http://www.geocities.jp/tmgpltwin/Files/Files.html
> 0022 gnuplot.chm.zip, 376,810 bytes, 2009-09-07, zipped gnuplot.chm file
> generated by HTML Help Complier
>
> The above file was made by mere translattion of htmldocs of the recent cvs
> sources. That is a mere test of HTML Help Complier.

How have you managed to include Contents and Index?


I wonder whether MS HTML Help Workshop is the only tool. Isn't there some
other tool, e.g. such that can be operated from a command line as the HCW
currently used?

---
PM

------------------------------------------------------------------------------
Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
trial. Simplify your report design, integration and deployment - and focus on
what you do best, core application coding. Discover what's new with
Crystal Reports now.  http://p.sf.net/sfu/bobj-july
_______________________________________________
gnuplot-beta mailing list
gnuplot-beta@...
https://lists.sourceforge.net/lists/listinfo/gnuplot-beta

[Tatsuro MATSUOKA-5]

Hello

--- Petr Mikulik wrote:

> HTML Help Workshop says it can convert rtf (such as gnuplot.rtf) into CHM.
> However, it does not work for me -- on WXP or Wine it says that some DLLs
> are incorrect.
>
> Has somebody succeeded?
I have met the same errors.  I googled again and found the page.

http://www.helpfulsolutions.com/

HTML Help DLL Registrar - ...........This little program asks you where you installed HTML Help
Workshop and then registers all of the DLLs it requires..................

HLP to HTML Help Convertor Fixer - ..... "The DLLs necessary to convert RTF to HTML have not been
installed correctly. Reinstall HTML Help Workshop and try again." is somewhat bogus............


I will try them

>
> > Now html documents in 'make' are produced by latex2html.
> > I have tried the above. However, my limited ability and time prevents me to go ahead :-( .
> >
> > http://www.geocities.jp/tmgpltwin/Files/Files.html
> > 0022 gnuplot.chm.zip, 376,810 bytes, 2009-09-07, zipped gnuplot.chm file
> > generated by HTML Help Complier
> >
> > The above file was made by mere translattion of htmldocs of the recent cvs
> > sources. That is a mere test of HTML Help Complier.
>
> How have you managed to include Contents and Index?
>
>
> I wonder whether MS HTML Help Workshop is the only tool. Isn't there some
> other tool, e.g. such that can be operated from a command line as the HCW
> currently used?

That was a mere test so that contents and index were not treated.  To get complete help, of course, we
have to treat the contents an index.  I have not try them yet.

>Isn't there some
> other tool, e.g. such that can be operated from a command line as the HCW
> currently used?

I have looking about the help. I cannot find the description of  command line.
Script writing by WSH (Windows script host) might be possible to treat it from command line.

Regards

Tatsuro
 


 

--------------------------------------
Thanks 10 years!  Yahoo! Shopping and Yahoo! Auctions
http://pr.mail.yahoo.co.jp/ec10years/

------------------------------------------------------------------------------
Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
trial. Simplify your report design, integration and deployment - and focus on
what you do best, core application coding. Discover what's new with
Crystal Reports now.  http://p.sf.net/sfu/bobj-july
_______________________________________________
gnuplot-beta mailing list
gnuplot-beta@...
https://lists.sourceforge.net/lists/listinfo/gnuplot-beta

[Tatsuro MATSUOKA-5]

Hello

--- Petr Mikulik wrote:

> HTML Help Workshop says it can convert rtf (such as gnuplot.rtf) into CHM.
> However, it does not work for me -- on WXP or Wine it says that some DLLs
> are incorrect.
>
> Has somebody succeeded?
I have met the same errors.  I googled again and found the page.

http://www.helpfulsolutions.com/

HTML Help DLL Registrar - ...........This little program asks you where you installed HTML Help
Workshop and then registers all of the DLLs it requires..................

HLP to HTML Help Convertor Fixer - ..... "The DLLs necessary to convert RTF to HTML have not been
installed correctly. Reinstall HTML Help Workshop and try again." is somewhat bogus............


I will try them

>
> > Now html documents in 'make' are produced by latex2html.
> > I have tried the above. However, my limited ability and time prevents me to go ahead :-( .
> >
> > http://www.geocities.jp/tmgpltwin/Files/Files.html
> > 0022 gnuplot.chm.zip, 376,810 bytes, 2009-09-07, zipped gnuplot.chm file
> > generated by HTML Help Complier
> >
> > The above file was made by mere translattion of htmldocs of the recent cvs
> > sources. That is a mere test of HTML Help Complier.
>
> How have you managed to include Contents and Index?
>
>
> I wonder whether MS HTML Help Workshop is the only tool. Isn't there some
> other tool, e.g. such that can be operated from a command line as the HCW
> currently used?

That was a mere test so that contents and index were not treated.  To get complete help, of course, we
have to treat the contents an index.  I have not try them yet.

>Isn't there some
> other tool, e.g. such that can be operated from a command line as the HCW
> currently used?

I have looking about the help. I cannot find the description of  command line.
Script writing by WSH (Windows script host) might be possible to treat it from command line.

Regards

Tatsuro
 


 

--------------------------------------
Thanks 10 years!  Yahoo! Shopping and Yahoo! Auctions
http://pr.mail.yahoo.co.jp/ec10years/

------------------------------------------------------------------------------
Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
trial. Simplify your report design, integration and deployment - and focus on
what you do best, core application coding. Discover what's new with
Crystal Reports now.  http://p.sf.net/sfu/bobj-july
_______________________________________________
gnuplot-beta mailing list
gnuplot-beta@...
https://lists.sourceforge.net/lists/listinfo/gnuplot-beta

[Tatsuro MATSUOKA-5]

Hello

Hmmmmm!

--- Tatsuro MATSUOKA wrote:

> Hello
>

> I have met the same errors.  I googled again and found the page.
>
> http://www.helpfulsolutions.com/
>
> HTML Help DLL Registrar - ...........This little program asks you where you installed HTML Help
> Workshop and then registers all of the DLLs it requires..................
>
> HLP to HTML Help Convertor Fixer - ..... "The DLLs necessary to convert RTF to HTML have not
> been
> installed correctly. Reinstall HTML Help Workshop and try again." is somewhat bogus............

and I tried
http://support.microsoft.com/kb/255123

The error

The DLLs necessary to convert RTF to HTML have not been installed correctly

could not be solved. :-(

Regards

Tatsuro


--------------------------------------
Thanks 10 years!  Yahoo! Shopping and Yahoo! Auctions
http://pr.mail.yahoo.co.jp/ec10years/

------------------------------------------------------------------------------
Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
trial. Simplify your report design, integration and deployment - and focus on
what you do best, core application coding. Discover what's new with
Crystal Reports now.  http://p.sf.net/sfu/bobj-july
_______________________________________________
gnuplot-beta mailing list
gnuplot-beta@...
https://lists.sourceforge.net/lists/listinfo/gnuplot-beta

[Hans-Bernhard Bröker-2]

Petr Mikulik wrote:

> HTML Help Workshop says it can convert rtf (such as gnuplot.rtf) into CHM.
> However, it does not work for me -- on WXP or Wine it says that some DLLs
> are incorrect.

Same problem here --- and no, none of the proposed fixes I've found
work.  The DLLs are as registered as can be; and the RTF file doesn't
contain the problems mentioned by helpfulsolutions.com.

> I wonder whether MS HTML Help Workshop is the only tool. Isn't there some
> other tool, e.g. such that can be operated from a command line as the HCW
> currently used?

Help workshop does include a command line tool (hhc).  But that will
only work  once we have a working HTML Help Workshop project file, and a
help sourcefile in HTML, not RTF.

I'm not convinced it's worth our while trying to use CHM.  If the fate
of 32bit Winhelp is any reference, CHM will vanish just as soon as we're
fully set up to create it.

------------------------------------------------------------------------------
Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
trial. Simplify your report design, integration and deployment - and focus on
what you do best, core application coding. Discover what's new with
Crystal Reports now.  http://p.sf.net/sfu/bobj-july
_______________________________________________
gnuplot-beta mailing list
gnuplot-beta@...
https://lists.sourceforge.net/lists/listinfo/gnuplot-beta

[Tatsuro MATSUOKA-5]

Hello

--- Hans-Bernhard Br将モker wrote:

> Same problem here --- and no, none of the proposed fixes I've found
> work.  The DLLs are as registered as can be; and the RTF file doesn't
> contain the problems mentioned by helpfulsolutions.com.

I also could not get successful results
>
> Help workshop does include a command line tool (hhc).  But that will
> only work  once we have a working HTML Help Workshop project file, and a
> help sourcefile in HTML, not RTF.
>
> I'm not convinced it's worth our while trying to use CHM.  If the fate
> of 32bit Winhelp is any reference, CHM will vanish just as soon as we're
> fully set up to create it.

Absolutely!!
On next January, 'windows 7' is coming up. HTML Help Workshop came up ten years ago.
What Hans is say is perhaps right.

It is better to wait a while whether Microsoft do the next action on help system for the next
generation.  

The possible way to use HTML Help Workshop to generate compact html style manual.
It reduces the size very well. For this purpose, HTML Help Workshop is not bad.
This chm file need not to be included in official release and I will upload it on my web.
Of course this is temporal treatment.

Regards

Tatsuro



--------------------------------------
Thanks 10 years!  Yahoo! Shopping and Yahoo! Auctions
http://pr.mail.yahoo.co.jp/ec10years/

------------------------------------------------------------------------------
Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
trial. Simplify your report design, integration and deployment - and focus on
what you do best, core application coding. Discover what's new with
Crystal Reports now.  http://p.sf.net/sfu/bobj-july
_______________________________________________
gnuplot-beta mailing list
gnuplot-beta@...
https://lists.sourceforge.net/lists/listinfo/gnuplot-beta