Stale docstring: load_workspace says 'tmuxp does not allow appending'
Nobody has claimed this yet.
Assessment
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Newbie friendliness
- 55/100
- Issue type
- Documentation
- Clarity
- Clearly specified
- Activity status
- Stale
- Tech stack
- python
- Domain
- cli, documentation
Research direction
Open src/tmuxp/cli/load.py around lines 574-577 and review the surrounding load_workspace documentation and session-exists options. Replace the stale statement with an accurate description of the default, --append, and --here modes, then verify the docstring clearly matches the behavior described in the issue.
Written by the indexing model from the issue text.
Description
Documentation Bug
The load_workspace docstring in src/tmuxp/cli/load.py (lines 574-577) says:
Currently, tmuxp does not allow appending a workspace / incremental building on top of a current session (pull requests are welcome!).
This is no longer accurate:
--appendhas been supported for some time (adds windows to the current attached session)--herewas added on the parity branch (reuses the current window for the first workspace window)
Fix
Remove or replace the stale text with an accurate description of the three session-exists modes:
- Default — prompts to reattach to the existing session
--append— adds windows from the workspace to the current attached session--here— reuses the current window for the first workspace window and renames the session
Files
src/tmuxp/cli/load.pylines 574-577
- Dominant language
- Python
- Stars
- 4.6k
- Forks
- 248
- Avg merge
- 2h 13m
- Merged PRs (30d)
- 1
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from tmux-python/tmuxp
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
tmux-python/tmuxp#1026 · 1 comment ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
tmux-python/tmuxp#939 · 1 comment ·
-
enhancement WorkspaceBuilder
Difficulty 4/5 3-5 days Newbie friendliness 48/100
tmux-python/tmuxp#1062 ·
-
enhancement need-comments WorkspaceBuilder
Difficulty 5/5 Over a week Newbie friendliness 35/100
tmux-python/tmuxp#1058 · 2 comments ·
-
bug
Difficulty 4/5 3-5 days Newbie friendliness 45/100
tmux-python/tmuxp#1053 · 10 comments ·
All issues in tmux-python/tmuxp
Similar issues
-
documentation help wanted
Difficulty 2/5 1-3 hours Newbie friendliness 90/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 90/100
simonw/sqlite-utils#872 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100