John C Nash
2011-Nov-02 18:58 UTC
[Rd] overly long lines in pdf output of manual from package
In re-factoring my optimx package, I'm finding that the pdf output has some lines that are outside the margins (and there are warnings in R CMD check optimx). Clearly I can fix this by editing the tex file that is generated, but the build infrastructure would still get things wrong in automatic processing. So that gives rise to 3 questions: 1) How do I adjust the DESCRIPTION file to avoid too long a line (optimx uses a lot of other packages). I can add \cr elements to the Rd files to control those lines, but DESCRIPTION doesn't allow this. 2) Is there an option control that does the job? I've not found one in searching, but could easily have chosen poor search terms. 3) To avoid running the whole of R CMD check to rebuild the manual, do I need to dig into R CMD check to find the bits that just build the manual, or is there an option to Rd2pdf to do this? I've found how to process a list of files with Rd2pdf, but need to add the DESCRIPTION stuff. Best John Nash
Prof Brian Ripley
2011-Nov-02 19:54 UTC
[Rd] overly long lines in pdf output of manual from package
On Wed, 2 Nov 2011, John C Nash wrote:> In re-factoring my optimx package, I'm finding that the pdf output has some lines that are > outside the margins (and there are warnings in R CMD check optimx). Clearly I can fix this > by editing the tex file that is generated, but the build infrastructure would still get > things wrong in automatic processing. So that gives rise to 3 questions: > > 1) How do I adjust the DESCRIPTION file to avoid too long a line (optimx uses a lot of > other packages). I can add \cr elements to the Rd files to control those lines, but > DESCRIPTION doesn't allow this.Wrap lines? And is this R 2.14.0, as the issues are easier with the fonts used there?> 2) Is there an option control that does the job? I've not found one > in searching, but could easily have chosen poor search terms.R has ways to reformat description files. See ?write.dcf.> > 3) To avoid running the whole of R CMD check to rebuild the manual, > do I need to dig into R CMD check to find the bits that just build > the manual, or is there an option to Rd2pdf to do this? I've found > how to process a list of files with Rd2pdf, but need to add the > DESCRIPTION stuff.R CMD R2pdf on a package source directory is what R CMD check uses.> > Best > > John Nash > > ______________________________________________ > R-devel at r-project.org mailing list > https://stat.ethz.ch/mailman/listinfo/r-devel >-- Brian D. Ripley, ripley at stats.ox.ac.uk Professor of Applied Statistics, http://www.stats.ox.ac.uk/~ripley/ University of Oxford, Tel: +44 1865 272861 (self) 1 South Parks Road, +44 1865 272866 (PA) Oxford OX1 3TG, UK Fax: +44 1865 272595