[ESS] roxygen updates with C-c C-o

Henning Redestig henning.red at googlemail.com
Thu Sep 1 00:00:01 CEST 2011


Hi David,

try now with ess from svn, C-c C-o should keep multiple paragraps in
@param fields intact.

Best, Henning

2011/8/30 Carslaw, David <david.carslaw at kcl.ac.uk>:
> 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 at kcl.ac.uk
> tel. 020 7848 3844
>
>        [[alternative HTML version deleted]]
>
> ______________________________________________
> ESS-help at r-project.org mailing list
> https://stat.ethz.ch/mailman/listinfo/ess-help
>



-- 
/Henning



More information about the ESS-help mailing list