Commit Graph

253 Commits

Author SHA1 Message Date
Michael Stapelberg
a2daf229fb userguide: document how to "un-scratchpad" a window (Thanks knopwob) 2012-09-28 18:03:36 +02:00
Yaroslav Molochko
04c58c7325 Implement variable border widths for pixel/normal
fixes #325
2012-09-24 22:20:29 +02:00
Pauli Ervi
b41ab04ecd Userguide: Added link from 7.2 to 6.6
The multiple monitors section (7) is probably the most
likely place for someone to go look for how to move
workspaces between monitors (6.6).
2012-09-22 19:05:12 +02:00
Sebastian Ullrich
236f9f45e3 Make "[move] workspace number" accept a default ws name after the ws number 2012-09-22 14:34:05 +02:00
Simon Elsbrock
28104a480c implement delayed urgency hint reset
If there is a client with an urgency hint on another workspace and
switching to this workspace would cause the urgency to be reset (by
moving the focusing to the client), delay the reset by some time. This
gives the user the chance to see it.

This commit adds the possibility to configure the urgency delay timer
duration using the 'force_display_urgency_hint' directive. Also,
documentation and a testcase was added to allow for automated checks of
the intended behavior.

fixes #482
2012-09-22 14:12:09 +02:00
chrysn
e15e37f922 fixes #776
this implements both the "move container to workspace back_and_forth" command
and movements to the same workspace when auto_back_and_forth is set.

it includes documentation and test suite additions by michael.

it also simplifies the workspace_show_by_name function (making use of
workspace_get accepting NULL pointers).
2012-09-22 13:35:31 +02:00
Michael Stapelberg
9febbe119a userguide: mention the FAQ 2012-09-19 17:30:44 +02:00
Michael Stapelberg
c5db01e6f8 userguide: make moving cons/workspaces to other outputs its own section
Frequent requests for this functionality on IRC made me aware that it’s
not easily findable.
2012-09-19 17:13:00 +02:00
Michael Stapelberg
4186827386 docs/userguide: document the --release flag for key bindings 2012-09-06 17:31:30 +02:00
Michael Stapelberg
b15dd83b26 docs/userguide: use --no-startup-id for executing shell scripts 2012-09-06 17:31:16 +02:00
Michael Stapelberg
a598544b5a userguide: point out explicitly how to use startup-notifications 2012-09-05 21:10:26 +02:00
Cian
8202f04bf2 Make the initial mention of 'split h/v' a little easier to understand. 2012-08-31 00:16:58 +02:00
Quentin Glidic
6c9bf84d4e userguide: Update Fonts section for Pango support 2012-08-13 11:39:31 +02:00
Axel Wagner
57effd65b2 Make horizontal edge-borders hidable too 2012-08-06 03:03:00 +02:00
Iakov Davydov
f27735f620 create hide_edge_borders option 2012-08-05 20:26:15 +02:00
Michael Stapelberg
de94f6da1a Introduce splith/splitv layouts, remove orientation
With this commit, the "default" layout is replaced by the splith and
splitv layouts. splith is equivalent to default with orientation
horizontal and splitv is equivalent to default with orientation
vertical.

The "split h" and "split v" commands continue to work as before, they
split the current container and you will end up in a split container
with layout splith (after "split h") or splitv (after "split v").

To change a splith container into a splitv container, use either "layout
splitv" or "layout toggle split". The latter command is used in the
default config as mod+l (previously "layout default"). In case you have
"layout default" in your config file, it is recommended to just replace
it by "layout toggle split", which will work as "layout default" did
before when pressing it once, but toggle between horizontal/vertical
when pressing it repeatedly.

The rationale behind this commit is that it’s cleaner to have all
parameters that influence how windows are rendered in the layout itself
rather than having a special parameter in combination with only one
layout. This enables us to change existing split containers in all cases
without breaking existing features (see ticket #464). Also, users should
feel more confident about whether they are actually splitting or just
changing an existing split container now.

As a nice side-effect, this commit brings back the "layout toggle"
feature we once had in i3 version 3 (see the userguide).

AFAIK, it is safe to use in-place restart to upgrade into versions
after this commit (switching to an older version will break your layout,
though).

Fixes #464
2012-08-04 03:13:24 +02:00
Michael Stapelberg
23c28e5208 Merge branch 'master' into next 2012-06-24 17:30:45 +02:00
Michael Stapelberg
453cc68e40 add section about implicit containers to the userguide (Thanks mloskot) 2012-06-24 17:30:18 +02:00
Michael Stapelberg
d4f8450ea9 Merge branch 'master' into next 2012-06-10 21:30:36 +02:00
Michael Stapelberg
1ad6eea4a8 userguide: make the default clear for focus_follows_mouse and new_window 2012-06-10 21:30:14 +02:00
Pavel Löbl
2afecaf355 Add a new command 'move to workspace current'
Added a new command 'move to workspace current' which can be used
with criteria to move a window to the current workspace.
2012-06-03 19:42:56 +02:00
Michael Stapelberg
373b4ad74a Implement 'rename workspace <old_name> to <new_name>' 2012-04-08 20:40:00 +02:00
Michael Stapelberg
72078c704e Implement 'workspace number <number>' to switch to named workspaces 2012-04-08 19:17:46 +02:00
Michael Stapelberg
2d110c90e6 Implement resize <grow|shrink> <width|height>, use it in the default config
Fixes: #576
2012-04-08 16:00:15 +02:00
Jose Pereira
9a58c1fcaa Added option to select primary display on tray_output 2012-04-05 14:42:07 +02:00
Pavel Löbl
f78f137ed0 Extends move command for floating windows 2012-03-25 11:06:49 +02:00
Michael Stapelberg
2763a23cc7 userguide: add a hint to xev (Thanks toxios) 2012-03-22 13:10:36 +01:00
D Thompson
82146fcebf Implement support for user configuration of constraints on floating window dimensions. 2012-02-16 18:31:28 +00:00
Jeremy O'Brien
53541817ef Implement urgency flag matcher
Currently it supports the following options:
"oldest": match the first window that triggered an urgent event
"latest": match the last window that triggered an urgent event
2012-02-14 22:47:10 +00:00
Michael Stapelberg
18aeb262d3 userguide: document 'fullscreen global' 2012-01-27 22:32:25 +00:00
Michael Stapelberg
f9bc434e2a Implement highlighting right/bottom borders of splitted windows
Fixes #299
2012-01-22 11:22:15 +00:00
Michael Stapelberg
31b7ec29fd Re-implement bar borders (by Angelo Haller)
This re-introduces borders around the workspace buttons in i3bar.
No additional pixels will be consumed (you will not lose any space for your
windows).
2012-01-20 21:36:50 +00:00
Michael Stapelberg
814695d8bb Implement 'move workspace to output <output>'
Fixes: #541
2012-01-10 22:16:50 +00:00
Michael Stapelberg
df9b338175 Introduce synonyms: 'move to workspace' and 'move container to workspace' and 'move window to workspace'
This makes the new 'move workspace to output' command much more clear
2012-01-10 22:16:09 +00:00
Michael Stapelberg
58f331c50a userguide: document workspace next_on_output/prev_on_output 2012-01-08 16:30:48 +00:00
Michael Stapelberg
c72367660f update userguide to reflect the modifier option in i3bar config 2012-01-08 12:52:45 +00:00
Michael Stapelberg
c92aa648cb document the 'focus output' command 2012-01-08 12:02:59 +00:00
Michael Stapelberg
9a46335e25 docs/userguide: refer to the new i3bar options in "8.1. Displaying a status line" 2011-12-30 00:59:32 +01:00
Michael Stapelberg
cea6f7ad96 Merge branch 'master' into next 2011-12-24 15:37:13 +01:00
Miguel de Val-Borro
1d2c63de5c Fix a few spelling typos 2011-12-24 15:36:43 +01:00
Michael Stapelberg
538247a843 s/xwininfo/xprop (Thanks Miguel) 2011-12-24 15:36:11 +01:00
Miguel de Val-Borro
e7e2ed94fd Fix typo in keyboard binding example in the user guide 2011-12-24 15:35:15 +01:00
Michael Stapelberg
08986a1798 Implement scratchpad functionality (see userguide) 2011-12-21 23:15:32 +00:00
Michael Stapelberg
1f2c9306a2 Merge branch 'master' into next
Conflicts:
	testcases/t/159-socketpaths.t
2011-12-18 18:02:08 +00:00
Michael Stapelberg
c21172a6f6 Create a secure temp path instead of a predictable one (Thanks Han)
With this commit, i3 will now use either $XDG_RUNTIME_DIR/i3 (XDG_RUNTIME_DIR
is only writable by the user, so this is not a problem) or a secure temporary
location in /tmp, following the pattern /tmp/i3-<user>.XXXXXX
2011-12-18 17:59:31 +00:00
Jan-Erik Rediger
f23d675de9 Implement new "i3bar_command" option for bar.
This allows you to specify an alternate path to the i3bar binary.
The userguide docu is included.
2011-11-27 21:40:57 +00:00
Michael Stapelberg
09a28f603f userguide: use bar blocks in the bar related examples 2011-11-15 23:42:41 +00:00
Michael Stapelberg
5b4f8eb7e2 userguide: s/enter/Return (use correct keysym) (Thanks mxf) 2011-11-15 20:20:54 +00:00
Michael Stapelberg
433720d27a docs/userguide: make it clear how to use multiple output directives (Thanks moemoe) 2011-11-13 12:54:10 +00:00
Michael Stapelberg
cc1a7d35d9 docs/userguide: fix typo (Thanks sycamorex) 2011-11-13 10:51:58 +00:00
Michael Stapelberg
41cf2468c0 docs/userguide: make the bar config reflect reality
Forgot to update this when changing the color.
2011-11-10 23:37:53 +00:00
Michael Stapelberg
715fe580af docs/userguide: s/shrinked/shrunk (Thanks f8l) 2011-11-08 18:06:44 +00:00
Michael Stapelberg
51e0d1b741 docs/userguide: clarify proportional resizing with floating modifier (Thanks Donald) 2011-10-29 22:58:32 +01:00
Michael Stapelberg
09a07b9169 docs/userguide: update the workspace assignment section 2011-10-27 22:45:34 +01:00
Michael Stapelberg
18c2ef33d3 docs/userguide: Document the move syntax 2011-10-27 21:52:39 +01:00
Michael Stapelberg
73d4737e42 docs/userguide: document the --no-startup-id flag for exec directives in the config 2011-10-25 22:21:09 +01:00
Michael Stapelberg
15f36cdc91 docs/userguide: document the --no-startup-id flag 2011-10-25 22:18:40 +01:00
Michael Stapelberg
5ec5a07dd2 docs/userguide: use the correct color keywords (Thanks Atsutane) 2011-10-23 13:17:32 +01:00
Michael Stapelberg
202b216c14 docs/userguide: document the output bar option 2011-10-21 22:22:02 +01:00
Michael Stapelberg
0f2642a9c9 docs/userguide: document the tray_output bar option 2011-10-21 19:50:40 +01:00
Michael Stapelberg
0f3d31124d docs/userguide: document the bar configuration 2011-10-20 23:38:34 +01:00
Michael Stapelberg
178be03fa6 Implement 'workspace back_and_forth' (Patch by Michael Walle) 2011-10-17 23:17:56 +01:00
Michael Stapelberg
b829fce813 Mention 'move workspace next/prev' in the userguide 2011-10-02 22:21:38 +01:00
Michael Stapelberg
3537f2d4ca Merge branch 'master' into next 2011-10-02 12:57:27 +01:00
Michael Walle
ba7b325469 userguide: fix typo
Signed-off-by: Michael Walle <michael@walle.cc>
2011-10-02 12:57:16 +01:00
Michael Stapelberg
ab04526aa1 mention the force_xinerama configfile directive in the userguide 2011-09-19 23:18:40 +01:00
Michael Stapelberg
9a76887a28 docs/userguide: document the window_role criterion 2011-09-18 16:06:52 +01:00
Michael Stapelberg
24dbddc395 docs/userguide: fix the for_window syntax 2011-09-11 22:15:14 +01:00
Michael Stapelberg
332476cf0e docs/userguide: document the new assign syntax 2011-09-11 22:15:05 +01:00
Michael Stapelberg
9b671bda83 docs/userguide: provide an example of case-insensitive matching with PCRE (Thanks stfn) 2011-09-11 21:17:13 +01:00
Michael Stapelberg
1a91c695e7 mention PCRE in docs/userguide 2011-09-11 11:10:09 +01:00
Michael Stapelberg
c3d0957efd Merge branch 'master' into next 2011-08-29 16:05:11 +02:00
Michael Stapelberg
1aa7eeb700 docs/userguide: state that mod+shift+space toggles, add link to criteria in for_window (Thanks Don) 2011-08-29 16:04:42 +02:00
Michael Stapelberg
1a34d250bb Merge branch 'master' into next 2011-08-29 15:17:53 +02:00
Michael Stapelberg
640071163f docs/userguide: new_window: s/borderless/none/ (Thanks bjonnh) 2011-08-29 15:17:31 +02:00
Michael Stapelberg
e7d6cd0f1c Merge branch 'master' into next 2011-08-28 18:03:06 +02:00
Michael Stapelberg
5796f72885 docs/userguide: properly document command chaining and criteria 2011-08-28 18:02:49 +02:00
Michael Stapelberg
e5f10022e7 docs/userguide: properly document the resize command 2011-08-28 17:51:37 +02:00
Michael Stapelberg
f269d85232 Merge branch 'master' into next 2011-08-28 14:55:17 +02:00
Michael Stapelberg
c846ff272f docs/userguide: document force_focus_wrapping config directive 2011-08-28 14:54:58 +02:00
Michael Stapelberg
61cbf7a658 Merge branch 'colors-userguide' into next 2011-08-27 16:47:53 +02:00
Michael Stapelberg
30c892adf4 docs/userguide: use the default colors in the colors example 2011-08-27 16:47:36 +02:00
Michael Stapelberg
057e0e9794 Merge branch 'master' into next 2011-08-27 15:28:34 +02:00
Michael Stapelberg
2d627ad9de docs/userguide: s/mod+h/mod+s for stacking (Thanks Tim) 2011-08-27 15:28:11 +02:00
Michael Stapelberg
e411223f8b Merge branch 'master' into next 2011-08-25 14:11:51 +02:00
Michael Stapelberg
ca77646de6 docs/userguide: add paragraph about named workspaces, discourage use of 'ipc-socket' 2011-08-25 14:11:31 +02:00
Peter Bui
7ddba4995f BUG-396: Implement move output <RANDR-OUTPUT> command
Also add support for move output <up|down|left|right> and update
userguide about the new command.
2011-08-17 16:10:11 +02:00
Michael Stapelberg
98cc37e223 swap up/down, also modify the testcase 2011-08-09 09:46:02 +02:00
Peter Bui
3316d8b8ba Resize uses up and down, not bottom and top
- Fix userguide resize example
- Update migration script
2011-08-09 09:42:36 +02:00
Michael Stapelberg
0ec208bd75 docs/userguide: use bindsym for the 'split' example (Thanks Jan) 2011-08-07 18:03:29 +02:00
Michael Stapelberg
92481b133c docs/userguide: the correct command is 'floating enable', not 'mode floating' (Thanks Sander)
Fixes: #453
2011-08-03 20:48:28 +02:00
Michael Stapelberg
9e4bd9a157 docs/userguide: remove the bar.* color keys (Thanks aksr) 2011-08-01 14:42:21 +02:00
Michael Stapelberg
9fbf6e3992 docs/userguide: use i3bar instead of dzen2 in the 'exec' example (Thanks ubitux) 2011-08-01 14:40:01 +02:00
Michael Stapelberg
d60c6f0db2 docs/userguide: update keyboard-layer images, remove incomplete warning 2011-07-31 23:53:26 +02:00
Michael Stapelberg
b77ab98ebc docs/userguide: document for_window (Thanks aksr) 2011-07-31 23:38:26 +02:00
Michael Stapelberg
033466585d docs/userguide: update the status line section, recommend i3bar
dzen2 does not get mentioned anymore. They did not release a new version for
more than three years (-dock was added 2008-04-03). I am sick of telling people
they need to check out the latest SVN trunk of dzen2.
2011-07-31 15:39:18 +02:00
Michael Stapelberg
c601ac1d8e docs/userguide: little fixes by fernando 2011-07-29 13:31:37 +02:00
Michael Stapelberg
20c68b1869 docs/userguide: explain the split command 2011-07-29 01:12:19 +02:00
Michael Stapelberg
7e6aa72664 docs/userguide: explain default_orientation config directive 2011-07-29 01:12:06 +02:00
Michael Stapelberg
85b01df11b userguide: add popup_during_fullscreen configuration directive 2011-07-29 00:26:30 +02:00
Michael Stapelberg
8ef51a7cfa update docs/userguide (various little fixes/updates) 2011-07-28 22:51:48 +02:00
Michael Stapelberg
7801cd7a03 Don’t pretend like the global fullscreen mode would be configured in the default config (Thanks Mirko)
Conflicts:

	docs/userguide
2011-07-23 22:08:41 +02:00
Michael Stapelberg
f5e24bd349 userguide: add missing $ (Thanks artoj) 2011-07-23 22:07:49 +02:00
Claudio Marforio
cc24a96e96 patch to allow exec_always in configure file
fixed indentation, updated docs
2011-07-12 18:23:14 +02:00
Michael Stapelberg
c408fef021 Implement 'focus floating', 'focus tiling' and 'focus mode_toggle' (+test +docs) 2011-07-04 17:09:52 +02:00
Michael Stapelberg
fb9d77305e Implement 'fullscreen global' 2011-06-10 18:27:20 +02:00
Michael Stapelberg
bef25d72aa Implement 'border toggle' (+test) 2011-06-10 16:15:52 +02:00
Michael Stapelberg
60ae26c19d Implement 'workspace next/prev' (+test) 2011-06-10 16:03:59 +02:00
Michael Stapelberg
c5a44f12d4 userguide: document resizing with a mode 2011-06-10 15:16:05 +02:00
Michael Stapelberg
238057667a userguide: document workspace_layout 2011-06-10 15:14:42 +02:00
Michael Stapelberg
bd49c80d5f CONFIG BREAK: rename 'mode floating/tiling' to 'floating enable/disable'
The three different variants now:
   floating enable
   floating disable
   floating toggle
2011-06-10 02:06:47 +02:00
Michael Stapelberg
9bbb37bb55 BREAKS CONFIG: rename 'level up' to 'focus parent'
…and 'level down' to 'focus child'. More intuitive than the old command names.
2011-06-10 01:36:33 +02:00
Michael Stapelberg
d68e4710fe CONFIG BREAK: kick the 'next'/'prev' commands, introduce 'focus left' etc.
Instead of the cryptic next/prev commands, we now provide an argument to the
focus command. Userguide and default config is updated.
2011-06-08 20:49:49 +02:00
Michael Stapelberg
a26a11c609 update the userguide for tree (not complete yet) 2011-05-28 21:58:58 +02:00
Sardem FF7
cd6f93be3f Rename bind to bindcode
Also fallback when using just 'bind' to be backward-compatible
2011-04-18 23:52:45 +02:00
Axel Wagner
4caf85aa0b Use I3SOCK-environment-variable 2011-01-12 10:15:48 +01:00
Fernando Tarlá Cardoso Lemos
e6d1f181fd Info about client.background for the user guide. 2010-11-13 20:08:19 +01:00
Michael Stapelberg
3bbcfadd22 docs: add/cleanup references 2010-03-25 03:26:59 +01:00
Michael Stapelberg
239dbbb4f5 Add documentation for the workspace_bar option 2010-03-25 02:47:01 +01:00
Michael Stapelberg
234ed6c99b docs: merge spelling and grammar fixes by sasha (Thanks!) 2010-03-21 01:50:10 +01:00
Michael Stapelberg
b6a003afdf docs/userguide: merge little corrections (Thanks fallen) 2010-03-16 20:28:43 +01:00
Michael Stapelberg
c58c7b9c63 Fix spelling errors/strange sentences in the user’s guide
Proof-reading is very appreciated.
2010-03-15 18:23:12 +01:00
Michael Stapelberg
6580f89560 Mention proportional resizing in userguide 2010-03-13 13:24:26 +01:00
Axel Wagner
50d0661203 Add documentation for floating resize 2010-03-13 13:22:37 +01:00
Axel Wagner
9c77b0f9a1 Implement screen-spanning fullscreen-mode (command: 'fg')
This closes ticket #188
2010-03-08 11:15:31 +01:00
Michael Stapelberg
496106cd44 Include graphic of the default keyboard layout in user’s guide
This closes ticket #166
2010-03-07 21:12:59 +01:00
Michael Stapelberg
f66d018e02 Update userguide, explain comments and normalize the paragraph about fonts (Thanks kraM) 2010-03-07 00:00:04 +01:00
Michael Stapelberg
aae824b1f3 Change workspace assignments to use the RandR output name instead of <screen> 2010-03-02 13:35:43 +01:00
Michael Stapelberg
69279d4567 Add documentation for the new focus follows mouse-option 2010-01-29 21:58:50 +01:00
Michael Stapelberg
7c7756d75f docs: improve documentation on modes (Thanks xeen) 2010-01-26 22:48:12 +01:00
Michael Stapelberg
57e4972fd1 Add clarification about border color in userguide (Thanks xeen) 2009-12-15 19:11:01 +01:00
Michael Stapelberg
13231e13ab Add new chapters to userguide: multi-monitor and software environment 2009-12-07 10:25:12 +01:00
Michael Stapelberg
d266474f97 Remove the terminal option from config.
The welcome message is displayed using xmessage(1), not using your
terminal. Thus, it makes no sense to have this option anymore. Also,
the new lex/yacc parser cannot correctly handle the situation:
normal variables are expanded before parsing the file. As a replacement,
you can use:
  set $terminal /usr/bin/urxvt
2009-11-13 20:36:59 +01:00
Michael Stapelberg
5e521cc299 document the new border option 2009-11-08 12:45:05 +01:00
Michael Stapelberg
25aae13331 Update userguide 2009-10-23 19:53:36 +02:00
Michael Stapelberg
1d80fd6aa4 userguide: tell the user where the configuration file needs to be (Thanks Scytale) 2009-10-11 14:43:56 +02:00
Michael Stapelberg
2ff2a6a315 Implement the urgency hint for windows/workspaces
Thanks to Mikael for bringing it to my mind. This change introduces
two new color classes, client.urgent and bar.urgent. By default,
urgent clients are drawn in red (colors by Atsutane).
2009-09-06 22:40:11 +02:00
Michael Stapelberg
4da54f1279 Merge branch 'next' into testcases
Conflicts:
	docs/userguide
2009-08-21 11:45:59 +02:00
Michael Stapelberg
a84b2269c3 userguide: use space for toggling tiling/floating 2009-08-19 13:31:14 +02:00
Michael Stapelberg
e35299d4df userguide: s/j/l in examples 2009-08-19 13:23:26 +02:00
Michael Stapelberg
962bab7c1c Update examples to use bindsym instead of bind 2009-08-19 13:15:14 +02:00
Michael Stapelberg
c38767603b Document commands and new configuration options in userguide 2009-08-19 13:00:09 +02:00
Michael Stapelberg
5b6bcb48f0 Document commands and new configuration options in userguide 2009-08-19 12:59:13 +02:00
Michael Stapelberg
ffcc8bbc3a Implement putting clients into floating mode at a specific workspace
This changes syntax of the assign command a bit. Old configurations
will continue to work. See the userguide.
2009-07-21 16:43:20 +02:00
Michael Stapelberg
62c8d58d82 Implement the configuration option floating_modifier and document it 2009-06-24 20:31:00 +02:00
Michael Stapelberg
44fe2e9cf2 userguide: Explain containers (Thanks dirkson) 2009-06-24 19:49:07 +02:00
Michael Stapelberg
cba36914a8 Implement selecting the next tiling/floating window (using "focus")
Also update documentation (manpage, userguide).
To make the code easier to read/write when checking if a client is
floating, introduce client_is_floating().
2009-06-21 16:14:15 +02:00
Michael Stapelberg
325d1b301f Implement the special workspace ~ for assignments, which will set clients floating automatically 2009-06-19 20:20:00 +02:00
Michael Stapelberg
086f6a47e3 userguide: be more specific 2009-06-14 01:10:17 +02:00
Michael Stapelberg
33b331d444 userguide: Document variables 2009-06-13 20:10:49 +02:00