Skip to content

Conversation

@KavishaHaswani
Copy link

Summary of the Pull Request

Updated the behavior of the --pos command-line argument in documentation.

References and Relevant Issues

Related to #4247

Detailed Description of the Pull Request / Additional comments

  • A single value like --pos 500 now sets both x and y to 500.
  • A trailing comma (e.g., --pos 500,) sets only x, using the default for y.

## Summary of the Pull Request
Updated the behavior of the `--pos` command-line argument in documentation.

## References and Relevant Issues
Related to #4247

## Detailed Description of the Pull Request / Additional comments
- A single value like `--pos 500` now sets both `x` and `y` to `500`.
- A trailing comma (e.g., `--pos 500,`) sets only `x`, using the default for `y`.
@learn-build-service-prod
Copy link

Learn Build status updates of commit 663248d:

✅ Validation status: passed

File Status Preview URL Details
TerminalDocs/command-line-arguments.md ✅Succeeded View

For more details, please refer to the build report.

@learn-build-service-prod
Copy link

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 issues. Other issues are also a high priority. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@KavishaHaswani
Copy link
Author

KavishaHaswani commented Nov 1, 2025

Note: This docs PR is related to the main code PR (microsoft/terminal#19409). The main code changes are pending review, so this PR depends on that one.

@mattwojo mattwojo added the futureRelease This is releated to a future version that has not yet been release via Microsoft Store label Dec 18, 2025
@mattwojo mattwojo assigned DHowett and unassigned cinnamon-msft Dec 18, 2025
carlos-zamora added a commit to microsoft/terminal that referenced this pull request Jan 15, 2026
## Summary of the Pull Request
Fixes #4247. Improves consistency in -pos tag parsing by supporting
single-value input for both axes.

## References and Relevant Issues
#4247

## Detailed Description of the Pull Request / Additional comments
The change aligns -pos behavior with padding-style logic. Existing
comma-separated behavior remains unchanged.
- A single value like "number" now sets both x and y positions to that
value — similar to how padding behaves.
- A value like "number," (with a trailing comma) continues to set only
x, leaving y unchanged.

## Validation Steps Performed
- Ran all unit and integration tests
- Added unit test to verify single-value and comma-separated inputs

## PR Checklist
- [x] Closes #4247
- [x] Tests added/passed
- [x] Documentation updated
MicrosoftDocs/terminal#890

---------

Co-authored-by: Carlos Zamora <cazamor@microsoft.com>
Copy link

@Maibrahim30 Maibrahim30 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done

@learn-build-service-prod
Copy link

Learn Build status updates of commit 663248d:

✅ Validation status: passed

File Status Preview URL Details
TerminalDocs/command-line-arguments.md ✅Succeeded View

For more details, please refer to the build report.

@learn-build-service-prod
Copy link

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@learn-build-service-prod
Copy link

Learn Build status updates of commit 663248d:

✅ Validation status: passed

File Status Preview URL Details
TerminalDocs/command-line-arguments.md ✅Succeeded View

For more details, please refer to the build report.

@learn-build-service-prod
Copy link

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

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

Labels

futureRelease This is releated to a future version that has not yet been release via Microsoft Store

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants