Skip to content

Help file doesn't display correctly

6 messages · ronggui, Brian Ripley, Duncan Murdoch

Original
ronggui
# 
Dear R Developer,

It seems to be a problem with help file. Not sure if it is related to
the new format of Rd parser. Multiple lines are joined together
without proper line break.
There were 14 warnings (use warnings() to see them)
## All lines are joined together and not easy to read.
Warning messages:
1: In grepl("^[[:blank:]]*$", buffer[length(buffer)]) :
  input string 1 is invalid in this locale
2: In grep("^[[:space:]]*$", buffer) : input string 5 is invalid in this locale
3: In grep("^[[:space:]]*$", buffer) : input string 2 is invalid in this locale
4: In grep("^[[:space:]]*$", buffer) : input string 1 is invalid in this locale
5: In grep("^[[:space:]]*$", buffer) : input string 4 is invalid in this locale
6: In grep("^[[:space:]]*$", buffer) : input string 5 is invalid in this locale
7: In grep("^[[:space:]]*$", buffer) : input string 6 is invalid in this locale
8: In grep("^[[:space:]]*$", buffer) : input string 7 is invalid in this locale
9: In grep("^[[:space:]]*$", buffer) : input string 9 is invalid in this locale
10: In grep("^[[:space:]]*$", buffer) : input string 10 is invalid in
this locale
11: In grepl("^[[:space:]]*$", txt[1L]) :
  input string 1 is invalid in this locale
12: In grepl("^[[:blank:]]*$", buffer[length(buffer)]) :
  input string 1 is invalid in this locale
13: In grep("^[[:space:]]*$", buffer) : input string 1 is invalid in this locale
14: In grep("^[[:space:]]*$", buffer) : input string 2 is invalid in this locale
R version 2.10.0 alpha (2009-10-04 r49936)
i386-pc-mingw32

locale:
[1] LC_COLLATE=Chinese_People's Republic of China.936
LC_CTYPE=Chinese_People's Republic of China.936
[3] LC_MONETARY=Chinese_People's Republic of China.936 LC_NUMERIC=C
[5] LC_TIME=Chinese_People's Republic of China.936

attached base packages:
[1] stats     graphics  grDevices utils     datasets  methods   base

loaded via a namespace (and not attached):
[1] tools_2.10.0
Duncan Murdoch
#
On 10/6/2009 5:12 AM, Ronggui Huang wrote:
Thanks, we're looking into it.  Please try again in a day or two and let 
us know if this is not fixed.

Duncan Murdoch
Brian Ripley
#
On Tue, 6 Oct 2009, Ronggui Huang wrote:

            

      
      
      
    

        
It was a problem with the handling of fancy quotes in a DBCS encoding 
(as used for CJK languages).  We don't attempt to use them for 
sQuote(), and will no longer attempt to use them for help.  This will 
take effect in r49952 and later, and seems to work for me in CP936.

It is not easy for us to test in Chinese Windows (most non-Chinese 
editions do not support it, or need add-ons installed), so please keep 
on reporting issues, particularly those with help (text, HTML, PDF?) 
rendering.

            

      
      
      
    

        

      
      
    

        

  
    

      
      
    

  


  


      

    

    

      
      

        


  

        

      ronggui
    

    

      
      #
    

  


  

      
2009/10/6 Prof Brian Ripley <ripley at stats.ox.ac.uk>:

            

      
      
      
    

        
As for the HTML help, it works if I launch it by help.start(), but the
link becomes broken if I launch it by click  menu "help- html help".

  
    

      
      
    

  


  


      

    

    

      
      

        


  

        

      Brian Ripley
    

    

      
      #
    

  


  

      
On Tue, 6 Oct 2009, Ronggui Huang wrote:

        

            

      
      
      
    

        
That is the expected behaviour, since it uses static HTML help and no 
prebuilt package HTML pages are being shipped.  I don't know if Duncan 
wants to change it to call an R function, but that would have the 
disadvantage of being unavailable when R is running (you will note 
that that menu item is not greyed out when Rgui is running 
computations, unlike most others).

  
    

      
      
    

  


  


      

    

    

      
      

        


  

        

      Duncan Murdoch
    

    

      
      #
    

  


  

      
On 10/6/2009 12:01 PM, Prof Brian Ripley wrote:

            

      
      
      
    

        
I think it is better to make the change, so that the help pages are 
available.  You can jump between pages once the browser is open 
(hopefully the server is handling this safely; it hasn't crashed for me 
yet).

I'll commit this...

Duncan Murdoch