R devel - Sep 2006 - enhancement request for labeling help windows in Windows

I would like to make a formal request for an enhancement.

The default help for RGui in 2.4.0dev seems to be the .chm format
outside of the RGui frame.  Previously the default help was individual
windows inside the RGui frame.  Every package in R has its own help
file and all of them are labeled identically as "Help" by Windows.
The labels appear in the title of the window, in the task bar, and in
the alt-tab menu.

The request is to give each a unique name, for example
    R Help --- base
    R Help --- grid
    R Help --- lattice

On 9/5/2006 7:41 PM, Richard M. Heiberger wrote:
> I would like to make a formal request for an enhancement.
> 
> The default help for RGui in 2.4.0dev seems to be the .chm format
> outside of the RGui frame.  Previously the default help was individual
> windows inside the RGui frame.  Every package in R has its own help
> file and all of them are labeled identically as "Help" by
Windows.
> The labels appear in the title of the window, in the task bar, and in
> the alt-tab menu.
> 
> The request is to give each a unique name, for example
>     R Help --- base
>     R Help --- grid
>     R Help --- lattice
> 
No problem:  let me know what to do.

Duncan Murdoch

I am looking at the HTML Help Workshop which I got from wherever
your website told me to get it.

There is no documentation in the material I have.  My guess is that one
of the variables in the file  "c:/Program Files/HTML Help
Workshop/include/htmlhelp.h"
needs to be changed.  My first guess is the line
    LPCTSTR pszCaption;      // IN/OUT: Window title
although how to change the value of pszCaption is not at all obvious.

I opened up the .chm files in emacs for other applications and they all
have a string buried inside that contains the name that appears on the window.

Rich

On Tue, 5 Sep 2006, Richard M. Heiberger wrote:
> I am looking at the HTML Help Workshop which I got from wherever
> your website told me to get it.
>
> There is no documentation in the material I have.  My guess is that one
> of the variables in the file  "c:/Program Files/HTML Help
Workshop/include/htmlhelp.h"
> needs to be changed.  My first guess is the line
>     LPCTSTR pszCaption;      // IN/OUT: Window title
> although how to change the value of pszCaption is not at all obvious.
>
> I opened up the .chm files in emacs for other applications and they all
> have a string buried inside that contains the name that appears on the
window.
I think the help window title comes from the
  Title=...
line in the *.hhp file.  share/perl/build-help-windows.pl:open_hhp()
adds a bunch of similar lines to the *.hhp file,
but not Title=.

See, e.g.,
  http://www.helpware.net/FAR/help/dlg_hhpedit_sec.htm

----------------------------------------------------------------------------
Bill Dunlap
Insightful Corporation
bill at insightful dot com
360-428-8146

 "All statements in this message represent the opinions of the author and
do
 not necessarily reflect Insightful Corporation policy or position."