First - many thanks to the ESS developers for their work; it really is invaluable!

If I have a simple function:

myfun <- function(a, b) {a + b}

and then C-c C-o gives (as expected)

##' .. content for \description{} (no empty lines) ..
##'
##' .. content for \details{} ..
##' @title
##' @param a
##' @param b
##' @return
##' @author
myfun <- function(a, b) {a + b}

If I then add some text to a @param that involves a line break e.g. for 'a':

##' .. content for \description{} (no empty lines) ..
##'
##' .. content for \details{} ..
##' @title
##' @param a Some text
##'
##' New paragraph
##' @param b
##' @return
##' @author
myfun <- function(a, b) {a + b}

and then update with C-c C-o it puts the new paragraph at the end of the params:

##' .. content for \description{} (no empty lines) ..
##'
##' .. content for \details{} ..
##' @title
##' @param a Some text
##' @param b
##'
##' New paragraph
##' @return
##' @author
myfun <- function(a, b) {a + b}

I can avoid this if I put all the text in one paragraph without any line breaks and use \cr to start a new line - which is maybe good practise anyway?  Is this expected behaviour or should C-c C-o keep the text together in this situation?

[ESS 5.14, Windows 7, R2.13.0]

Many thanks

David


David Carslaw
Environmental Research Group
MRC-HPA Centre for Environment and Health
King's College London
Room 4.129
Franklin Wilkins Building
Stamford Street
London SE1 9NH

david.carslaw@kcl.ac.uk
tel. 020 7848 3844

	[[alternative HTML version deleted]]

