From maechler@stat.math.ethz.ch  Thu Nov  4 08:20:51 1999
From: maechler@stat.math.ethz.ch (maechler@stat.math.ethz.ch)
Date: Thu, 4 Nov 1999 09:20:51 +0100 (MET)
Subject: bug in Rdconvlib.pl converting to latex (PR#311)
Message-ID: <199911040820.JAA27177@pubhealth.ku.dk>

>>>>> "Ray" == Ray Brownrigg <Ray.Brownrigg@mcs.vuw.ac.nz> writes:

    Ray> If .../<pkg>/man/ contains a filename beginning with [, such as
    Ray> [.datetimes, Rdconvlib.pl cannot convert that help file into latex at
    Ray> INSTALL time.  [Using --no-latex is a workaround.]

    Ray> The error given is:

    Ray> # R INSTALL ssCatalogues
    Ray> :
    Ray> help
    >>>> Building/Updating help pages for package `ssCatalogues'
    Ray> Formats: text html latex example
    Ray> /^[.datetimes$/: unmatched [] in regexp at /vol/R/etc/Rdconvlib.pl line
    Ray> 1322, <rdfile> chunk 36.
    Ray> :

    Ray> Unfortunately the script stops at that point, so none of the following
    Ray> help files are installed.

Well, the bug is more that of documentation of what is allowed for *.Rd
file names.

For portability, we even had to give up having e.g., 
both
	Alias.Rd 
and	alias.Rd

I'd say the rule must contain

>>>> |  For portability reasons, R source files must start with  |
>>>> |     [a-zA-Z]						 |
>>>> |  and should be unique within a package if lowercased.	 |

Maybe we even have to consider more restrictions..

Should this be put into the 
       FAQ,  ?library (...base/man/library.Rd), and/or
       doc/manual/writing-Rd.tex
?

Martin Maechler <maechler@stat.math.ethz.ch>	http://stat.ethz.ch/~maechler/
Seminar fuer Statistik, ETH-Zentrum  LEO D10	Leonhardstr. 27
ETH (Federal Inst. Technology)	8092 Zurich	SWITZERLAND
phone: x-41-1-632-3408		fax: ...-1228			<><

-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-
r-devel mailing list -- Read http://www.ci.tuwien.ac.at/~hornik/R/R-FAQ.html
Send "info", "help", or "[un]subscribe"
(in the "body", not the subject !)  To: r-devel-request@stat.math.ethz.ch
_._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._


bug in Rdconvlib.pl converting to latex (PR#311)
maechler@stat.math.ethz.ch