From ripley@stats.ox.ac.uk  Mon Jun 11 12:26:30 2001
From: ripley@stats.ox.ac.uk (Prof Brian Ripley)
Date: Mon, 11 Jun 2001 12:26:30 +0100 (BST)
Subject: [Rd] documentation and \sloppy (PR#976)
In-Reply-To: <200106102050.WAA26838@pubhealth.ku.dk>
Message-ID: <Pine.LNX.4.31.0106111220350.15491-100000@gannet.stats>

On Sun, 10 Jun 2001 p.ribeiro@lancaster.ac.uk wrote:

> Hi
> When preparing documentation using Rd2dvi sometimes we get "overflow" on
> some lines. The consequence is that in the documentation there are some
> lines where words are not hyphenated or moved. The final document has some
> lines with more columns than the rest of the text.
> This happens when we use \code{} (which probably calls the \tt in latex).
>
> I've been checking the documentation (.pdf files) of a few packages  and
> this seens to occours all over.
>
> One possible way to correct this is  by introducing the command
> \sloppy
> on the header of the automatically generated .tex files. It seens to work
> fine in some tests I've run.
>
> I'm wondering whether the "\sloppy" can be incorporated to the Rd2dvi
> command.

Yes it can, using the Rd.cfg mechanism.  If there is a file Rd.cfg in your
TEXINPUTS path, it gets read at the bottom of Rd.sty.  This should allow
you to change the TeX penalties (which is what \sloppy does AFAIR).

I think Rd2dvi is intended only to be a simple mechanism to produce
a reasonable printed manual, but the Rd.cfg mechanism allows some
customization.  My view is that a few overlaps into the right margin is
less distracting that the `loose' typesetting that \sloppy encourages.

Brian

-- 
Brian D. Ripley,                  ripley@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 272860 (secr)
Oxford OX1 3TG, UK                Fax:  +44 1865 272595

-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-
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
_._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._


[Rd] documentation and \sloppy (PR#976)
Prof Brian Ripley