Skip to content

Document passing arguments to external commands - #2211

Merged
fdncred merged 1 commit into
nushell:mainfrom
ColumbusLabs:codex/document-external-arguments
Jul 25, 2026
Merged

Document passing arguments to external commands#2211
fdncred merged 1 commit into
nushell:mainfrom
ColumbusLabs:codex/document-external-arguments

Conversation

@ColumbusLabs

Copy link
Copy Markdown
Contributor

What

Document how Nushell passes arguments to external commands.

Why

The existing page explains how to select an external command, but not how quoted strings, lists, or dynamic executable names map to the invocation.

Fixes #527

Details

  • explains that quoted spaces stay inside a single argument
  • makes the direct-list error explicit and shows ...$paths for separate arguments
  • documents executable names stored in variables with ^$program
  • links the canonical spread, string-command, and extern documentation

Testing

  • npm ci
  • npm run build (1,628 pages rendered)
  • npx prettier --check book/running_externals.md
  • rendered-link and anchor inspection
  • git diff --check

@ColumbusLabs
ColumbusLabs force-pushed the codex/document-external-arguments branch from 0e04ad8 to 1315592 Compare July 24, 2026 23:28
@ColumbusLabs
ColumbusLabs force-pushed the codex/document-external-arguments branch from 1315592 to 5bee6ff Compare July 25, 2026 01:52
@fdncred
fdncred merged commit bef55b5 into nushell:main Jul 25, 2026
2 checks passed
@fdncred

fdncred commented Jul 25, 2026

Copy link
Copy Markdown
Contributor

Thanks

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document passing arguments to externals better

2 participants