Skip to content

swaynag: add page#22025

Open
acuteenvy wants to merge 1 commit intotldr-pages:mainfrom
acuteenvy:swaynag
Open

swaynag: add page#22025
acuteenvy wants to merge 1 commit intotldr-pages:mainfrom
acuteenvy:swaynag

Conversation

@acuteenvy
Copy link
Copy Markdown
Member

Checklist

  • The page(s) are in the correct platform directories: common, linux, osx, windows, sunos, android, etc.
  • The page description(s) have links to documentation or a homepage.
  • The page(s) follow the content guidelines.
  • The page(s) follow the style guide.
  • The PR contains at most 5 new pages.
  • The PR is authored by me, or has been human-reviewed if it was created with AI or machine translation software.
  • The PR title conforms to the recommended templates.

@github-actions github-actions bot added new command Issues requesting creation of a new page or PRs adding a new page for a command. review needed Prioritized PRs marked for reviews from maintainers. labels Apr 12, 2026
- Display an error:

`swaynag {{[-m|--message]}} "{{error message}}"`
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
`swaynag {{[-m|--message]}} "{{error message}}"`
`swaynag {{[-m|--message]}} "{{error_message}}"`

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

The message usually contains spaces, hence the quotes. I don't think snake case is appropriate here.


- Display a warning:

`swaynag {{[-t|--type]}} warning {{[-m|--message]}} "{{warning message}}"`
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
`swaynag {{[-t|--type]}} warning {{[-m|--message]}} "{{warning message}}"`
`swaynag {{[-t|--type]}} warning {{[-m|--message]}} "{{warning_message}}"`


- Use the specified font:

`swaynag {{[-f|--font]}} "{{monospace bold 9}}" {{[-m|--message]}} "{{error message}}"`
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
`swaynag {{[-f|--font]}} "{{monospace bold 9}}" {{[-m|--message]}} "{{error message}}"`
`swaynag {{[-f|--font]}} "{{monospace bold 9}}" {{[-m|--message]}} "{{error_message}}"`


- Create a button and run a command in the specified terminal on click:

`TERMINAL={{terminal_executable}} swaynag {{[-b|--button]}} "{{button text}}" {{command}} {{[-m|--message]}} "{{error message}}"`
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
`TERMINAL={{terminal_executable}} swaynag {{[-b|--button]}} "{{button text}}" {{command}} {{[-m|--message]}} "{{error message}}"`
`TERMINAL={{terminal_executable}} swaynag {{[-b|--button]}} "{{button_text}}" {{command}} {{[-m|--message]}} "{{error_message}}"`


- Create a button and run a command on click:

`swaynag {{[-B|--button-no-terminal]}} "{{button text}}" {{command}} {{[-m|--message]}} "{{error message}}"`
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
`swaynag {{[-B|--button-no-terminal]}} "{{button text}}" {{command}} {{[-m|--message]}} "{{error message}}"`
`swaynag {{[-B|--button-no-terminal]}} "{{button_text}}" {{command}} {{[-m|--message]}} "{{error_message}}"`


- Display the bar on the bottom of the screen:

`swaynag {{[-e|--edge]}} bottom {{[-m|--message]}} "{{error message}}"`
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
`swaynag {{[-e|--edge]}} bottom {{[-m|--message]}} "{{error message}}"`
`swaynag {{[-e|--edge]}} bottom {{[-m|--message]}} "{{error_message}}"`


- Open `swaynag` on the specified monitor:

`swaynag {{[-o|--output]}} {{DP-1}} {{[-m|--message]}} "{{error message}}"`
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
`swaynag {{[-o|--output]}} {{DP-1}} {{[-m|--message]}} "{{error message}}"`
`swaynag {{[-o|--output]}} {{DP-1}} {{[-m|--message]}} "{{error_message}}"`

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

Labels

new command Issues requesting creation of a new page or PRs adding a new page for a command. review needed Prioritized PRs marked for reviews from maintainers.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants