Skip to content

Commit

Permalink
docs(mkdocs): generate latest cli docs
Browse files Browse the repository at this point in the history
  • Loading branch information
LGUG2Z committed Sep 27, 2024
1 parent 109227b commit d6ae81a
Show file tree
Hide file tree
Showing 17 changed files with 152 additions and 10 deletions.
16 changes: 16 additions & 0 deletions docs/cli/animation-duration.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
# animation-duration

```
Set the duration for movement animations in ms
Usage: komorebic.exe animation-duration <DURATION>
Arguments:
<DURATION>
Desired animation durations in ms
Options:
-h, --help
Print help
```
16 changes: 16 additions & 0 deletions docs/cli/animation-fps.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
# animation-fps

```
Set the frames per second for movement animations
Usage: komorebic.exe animation-fps <FPS>
Arguments:
<FPS>
Desired animation frames per second
Options:
-h, --help
Print help
```
20 changes: 20 additions & 0 deletions docs/cli/animation-style.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
# animation-style

```
Set the ease function for movement animations
Usage: komorebic.exe animation-style [OPTIONS]
Options:
-s, --style <STYLE>
Desired ease function for animation
[default: linear]
[possible values: linear, ease-in-sine, ease-out-sine, ease-in-out-sine, ease-in-quad, ease-out-quad, ease-in-out-quad, ease-in-cubic, ease-in-out-cubic, ease-in-quart,
ease-out-quart, ease-in-out-quart, ease-in-quint, ease-out-quint, ease-in-out-quint, ease-in-expo, ease-out-expo, ease-in-out-expo, ease-in-circ, ease-out-circ, ease-in-out-circ,
ease-in-back, ease-out-back, ease-in-out-back, ease-in-elastic, ease-out-elastic, ease-in-out-elastic, ease-in-bounce, ease-out-bounce, ease-in-out-bounce]
-h, --help
Print help
```
16 changes: 16 additions & 0 deletions docs/cli/animation.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
# animation

```
Enable or disable movement animations
Usage: komorebic.exe animation <BOOLEAN_STATE>
Arguments:
<BOOLEAN_STATE>
[possible values: enable, disable]
Options:
-h, --help
Print help
```
12 changes: 12 additions & 0 deletions docs/cli/bar-configuration.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
# bar-configuration

```
Show the path to komorebi.bar.json
Usage: komorebic.exe bar-configuration
Options:
-h, --help
Print help
```
2 changes: 1 addition & 1 deletion docs/cli/complete-configuration.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# complete-configuration

```
Signal that the final configuration option has been sent
For legacy komorebi.ahk or komorebi.ps1 configurations, signal that the final configuration option has been sent
Usage: komorebic.exe complete-configuration
Expand Down
3 changes: 3 additions & 0 deletions docs/cli/enable-autostart.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,9 @@ Options:
--ahk
Enable autostart of ahk
--bar
Enable autostart of komorebi-bar
-h, --help
Print help
Expand Down
16 changes: 16 additions & 0 deletions docs/cli/focus-stack-window.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
# focus-stack-window

```
Focus the specified window index in the focused stack
Usage: komorebic.exe focus-stack-window <TARGET>
Arguments:
<TARGET>
Target index (zero-indexed)
Options:
-h, --help
Print help
```
2 changes: 1 addition & 1 deletion docs/cli/reload-configuration.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# reload-configuration

```
Reload ~/komorebi.ahk (if it exists)
Reload legacy komorebi.ahk or komorebi.ps1 configurations (if they exist)
Usage: komorebic.exe reload-configuration
Expand Down
16 changes: 16 additions & 0 deletions docs/cli/replace-configuration.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
# replace-configuration

```
Replace the configuration of a running instance of komorebi from a static configuration file
Usage: komorebic.exe replace-configuration <PATH>
Arguments:
<PATH>
Static configuration JSON file from which the configuration should be loaded
Options:
-h, --help
Print help
```
3 changes: 3 additions & 0 deletions docs/cli/start.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,9 @@ Options:
--ahk
Start autohotkey configuration file
--bar
Start komorebi-bar in a background process
-h, --help
Print help
Expand Down
3 changes: 3 additions & 0 deletions docs/cli/stop.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,9 @@ Options:
--whkd
Stop whkd if it is running as a background process
--bar
Stop komorebi-bar if it is running as a background process
-h, --help
Print help
Expand Down
12 changes: 12 additions & 0 deletions docs/cli/toggle-transparency.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
# toggle-transparency

```
Toggle transparency for unfocused windows
Usage: komorebic.exe toggle-transparency
Options:
-h, --help
Print help
```
2 changes: 1 addition & 1 deletion docs/cli/watch-configuration.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# watch-configuration

```
Enable or disable watching of ~/komorebi.ahk (if it exists)
Enable or disable watching of legacy komorebi.ahk or komorebi.ps1 configurations (if they exist)
Usage: komorebic.exe watch-configuration <BOOLEAN_STATE>
Expand Down
2 changes: 1 addition & 1 deletion justfile
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ deadlock $RUST_LOG="trace":
cargo +stable run --bin komorebi --locked --features deadlock_detection

docgen:
komorebic docgen
cargo run --package komorebic -- docgen
Get-ChildItem -Path "docs/cli" -Recurse -File | ForEach-Object { (Get-Content $_.FullName) -replace 'Usage: ', 'Usage: komorebic.exe ' | Set-Content $_.FullName }

schemagen:
Expand Down
9 changes: 5 additions & 4 deletions komorebic/src/main.rs
Original file line number Diff line number Diff line change
Expand Up @@ -897,6 +897,7 @@ enum SubCommand {
/// Show the path to komorebi.json
#[clap(alias = "config")]
Configuration,
/// Show the path to komorebi.bar.json
#[clap(alias = "bar-config")]
#[clap(alias = "bconfig")]
BarConfiguration,
Expand Down Expand Up @@ -1281,16 +1282,16 @@ enum SubCommand {
TransparencyAlpha(TransparencyAlpha),
/// Toggle transparency for unfocused windows
ToggleTransparency,
/// Enable or disable the window move animation
/// Enable or disable movement animations
#[clap(arg_required_else_help = true)]
Animation(Animation),
/// Set the duration for the window move animation in ms
/// Set the duration for movement animations in ms
#[clap(arg_required_else_help = true)]
AnimationDuration(AnimationDuration),
/// Set the frames per second for the window move animation
/// Set the frames per second for movement animations
#[clap(arg_required_else_help = true)]
AnimationFps(AnimationFps),
/// Set the ease function for the window move animation
/// Set the ease function for movement animations
#[clap(arg_required_else_help = true)]
AnimationStyle(AnimationStyle),
/// Enable or disable focus follows mouse for the operating system
Expand Down
12 changes: 10 additions & 2 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -79,6 +79,7 @@ nav:
- cli/stop.md
- cli/check.md
- cli/configuration.md
- cli/bar-configuration.md
- cli/whkdrc.md
- cli/state.md
- cli/global-state.md
Expand All @@ -103,12 +104,13 @@ nav:
- cli/cycle-focus.md
- cli/cycle-move.md
- cli/stack.md
- cli/unstack.md
- cli/cycle-stack.md
- cli/focus-stack-window.md
- cli/stack-all.md
- cli/unstack-all.md
- cli/resize-edge.md
- cli/resize-axis.md
- cli/unstack.md
- cli/cycle-stack.md
- cli/move-to-monitor.md
- cli/cycle-move-to-monitor.md
- cli/move-to-workspace.md
Expand Down Expand Up @@ -179,6 +181,7 @@ nav:
- cli/restore-windows.md
- cli/manage.md
- cli/unmanage.md
- cli/replace-configuration.md
- cli/reload-configuration.md
- cli/watch-configuration.md
- cli/complete-configuration.md
Expand Down Expand Up @@ -208,6 +211,11 @@ nav:
- cli/border-implementation.md
- cli/transparency.md
- cli/transparency-alpha.md
- cli/toggle-transparency.md
- cli/animation.md
- cli/animation-duration.md
- cli/animation-fps.md
- cli/animation-style.md
- cli/focus-follows-mouse.md
- cli/toggle-focus-follows-mouse.md
- cli/mouse-follows-focus.md
Expand Down

0 comments on commit d6ae81a

Please sign in to comment.