posit-dev / posit-dev/positron

Change `R: Document R Package` command to run as task in separate R process

Open
#9,679 5 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement lang: r support
Dominant language
TypeScript
Stars
4.3k
Forks
184
Avg merge
1d 11h
Merged PRs (30d)
206

Description

System details:

Positron and OS details:

Positron Version: 2025.09.0 (user setup) build 139
Code - OSS Version: 1.103.0
Commit: 30e3d0a74e09a0f6640929822cb57a326671360e
Date: 2025-08-29T18:50:28.998Z
Electron: 37.2.3
Chromium: 138.0.7204.100
Node.js: 22.17.0
V8: 13.8.500258-electron.0
OS: Windows_NT x64 10.0.26100

and

Positron Version: 2025.01.1 build 0
Code - OSS Version: 1.96.0
Commit: e51707059b519f02aee408a3578cd81af6224476
Date: 2025-02-01T23:19:40.362Z
Browser: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36

Session details:

R 4.4.3 and R 4.5.1

Describe the issue:

Positron is inserting Escape and Bell characters into R markdown with {roxygen2} while running devtools::document(). The same characters are not added when running in RStudio

Positron creates this line:

#> i Run ]8;;x-r-run:admiral::get_duplicates_dataset()admiral::get_duplicates_dataset()]8;; to access the duplicate records}\if{html}{\out{</div>}}

RStudio creates this line:

#> i Run `admiral::get_duplicates_dataset()` to access the duplicate records}\if{html}{\out{</div>}}

Steps to reproduce the issue:

  1. Run devtools::document() on the following file from {admiral}:
    https://github.com/pharmaverse/admiral/blob/main/R/derive_extreme_records.R

Expected or desired behavior:

See RStudio output above

Were there any error messages in the UI, Output panel, or Developer Tools console?

No

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the R: Document R Package command and reproduce the issue by running devtools::document() on R/derive_extreme_records.R from the linked admiral package. Trace how the command launches R and compare its output with the RStudio example; done means the generated roxygen2 text contains backticks without Escape or Bell characters.

Written by the indexing model from the issue text.

Assessment

Tech stack
r, typescript
Domain
developer-experience, tooling
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.