From p.dalgaard at biostat.ku.dk  Sun May 25 14:29:04 2003
From: p.dalgaard at biostat.ku.dk (Peter Dalgaard BSA)
Date: Sun May 25 15:29:07 2003
Subject: [Rd] Re: [R] help output paged in separate window
In-Reply-To: <ntc1dvkmh7a4sei8jhpdc37ptamh7fk8cr@4ax.com>
References: <XFMail.030524203021.Ted.Harding@nessie.mcc.ac.uk>
	<XFMail.030525104227.Ted.Harding@nessie.mcc.ac.uk>
	<ntc1dvkmh7a4sei8jhpdc37ptamh7fk8cr@4ax.com>
Message-ID: <x2k7cf9mj0.fsf@biostat.ku.dk>

Duncan Murdoch <dmurdoch@pair.com> writes:

> On Sun, 25 May 2003 10:42:27 +0100 (BST), Ted.Harding@nessie.mcc.ac.uk
> wrote in r-help:
> 
> >Thanks to Jonathan Baron and Peter Dalgaard for private comments and help
> >on this question. Peter in particular pointed out that
> >  library(tcltk); options(pager=tkpager)
> 
> I notice a bug in the behaviour when used with help().  In Windows
> (and elsewhere?) the pager gets called through file.show, with the
> help topic given as the "header", rather than the "title".  According
> to the docs, "title" is supposed to be an overall title common to all
> displayed files, while "header" is file-specific.  In Windows, a
> combination of both args is used as the window title.
> 
> However, tkpager only uses the "title" argument for the window title,
> putting "header" into the text being displayed, with the result that
> the windows end up with no title.
> 
> Is this an inconsistency in the usage for "header" between Windows and
> other platforms, or a bug in tkpager?

A bit of both, I think. The Unix version of help() has

                  file.show(zfile, title = paste("R Help on `",
                    topic, "'", sep = ""), delete.file = (zfile !=
                    file), pager = pager)

so everything is in the title. We could still paste the title and the
header arguments rather than put the header in the displayed text, of
course. 

I don't read the docs as "overall title common to all displayed files"
though, just as common to the set of files displayed by file.show. Or
was that what you meant too?

-- 
   O__  ---- Peter Dalgaard             Blegdamsvej 3  
  c/ /'_ --- Dept. of Biostatistics     2200 Cph. N   
 (*) \(*) -- University of Copenhagen   Denmark      Ph: (+45) 35327918
~~~~~~~~~~ - (p.dalgaard@biostat.ku.dk)             FAX: (+45) 35327907


[Rd] Re: [R] help output paged in separate window
Peter Dalgaard BSA