Skip to content

Commit c7f4f19

Browse files
committed
docs: address review feedback
Drop CHANGELOG entry for docs-only change. Simplify placeholder note to be shell-agnostic per reviewer request.
1 parent d45c99b commit c7f4f19

2 files changed

Lines changed: 3 additions & 18 deletions

File tree

CHANGELOG.md

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,6 @@
66
## Bugfixes
77
- Handle invalid working directories gracefully when using `--full-path`, see #1900 (@Xavrir).
88

9-
## Documentation
10-
- Document PowerShell placeholder quoting requirement in the troubleshooting section, see #735 (@YoshKoz)
11-
129
# 10.4.2
1310

1411
## Bugfixes

README.md

Lines changed: 3 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -444,22 +444,10 @@ you can use `export -f my_function` to make available to child processes. You wo
444444
need to call `fd -x bash -c 'my_function "$1"' bash`. For other use cases or shells, use
445445
a (temporary) shell script.
446446

447-
### Placeholders (`{}`, `{/}`, `{//}`, `{.}`, `{/.}`) in PowerShell
447+
### Placeholders in `-x`/`-X`
448448

449-
In PowerShell (both Windows PowerShell and PowerShell 7+), curly braces `{}` are reserved
450-
for script blocks. Passing them unquoted to `fd -x`/`fd -X` will cause PowerShell to
451-
interpret them before `fd` sees them, breaking the placeholder. Wrap any placeholder in
452-
single quotes (or escape the braces with backticks):
453-
454-
``` powershell
455-
# Won't work — PowerShell parses `{/}` as a script block:
456-
fd -e txt -x echo {/}
457-
458-
# Works — single quotes pass `{/}` through to fd untouched:
459-
fd -e txt -x echo '{/}'
460-
```
461-
462-
The same rule applies to `{}`, `{//}`, `{.}`, and `{/.}`.
449+
Depending on your shell, you may need to quote the placeholders (`{}`, `{/}`, `{//}`,
450+
`{.}`, `{/.}`) to prevent the shell from interpreting them before `fd` sees them.
463451

464452
## Integration with other programs
465453

0 commit comments

Comments
 (0)