Folding is a simple solution, but there are intrinsic problems, like the need to embed the documentation in comments. If the user already has to expand a fold to edit the docs, the IDE could instead just provide a link or shortcut that jumps to a separate documentation file, written in whatever language, Rd, markdown, docbook. For example, I could imagine RStudio showing the rendered documentation in a side pane when the cursor is on the function name/signature, and the user could somehow switch modes to edit it. But there would be no need to mix two different languages in the same file, and thus no ugly escaping, and no documentation obscuring the code, or vice versa.
On Thu, Feb 1, 2018 at 7:20 AM, Lionel Henry <lio...@rstudio.com> wrote: > > > On 1 févr. 2018, at 06:51, Therneau, Terry M., Ph.D. <thern...@mayo.edu> > wrote: > > > > A second is that I care a lot about documentation so my help files are > > fairly long, so much so that the advantage of having the documentation > of an argument > > "close" to the declaration of said argument is lost. > > Good point. It suggests editors need folding support for roxygen sections. > > Lionel > ______________________________________________ > R-devel@r-project.org mailing list > https://stat.ethz.ch/mailman/listinfo/r-devel > [[alternative HTML version deleted]] ______________________________________________ R-devel@r-project.org mailing list https://stat.ethz.ch/mailman/listinfo/r-devel