aboutsummaryrefslogtreecommitdiff
path: root/man
AgeCommit message (Collapse)Author
2023-04-10man page: Update outdated information (#5478)Orestis Floros
Instead of correcting some of them, I completely deleted them since the userguide is always more up-to-date. Fixes #5477
2023-01-22i3bar: Add protocol for workspace buttonsOrestis Floros
Closes #3818 (parent issue) Fixes #1808 Fixes #2333 Fixes #2617 Fixes #3548
2022-10-11Escape ~ to prevent interpretation as subscript. (#5168)bodea
2022-09-06man/i3-input: fix a typo: chose → choose (#5087)paperluigis
2021-10-31Correct short form of raw option in i3-msg manpagelycurgus
2021-09-22GET_CONFIG: add raw/variable-processed contents of all config files (#4528)Michael Stapelberg
We do this by adding to included_files as i3 processes the configs. This should allow for easy debugging, without having to change how i3 processes config files. related to #4192
2021-08-28Implement support for the WM_Sn selection (#4374)Uli Schlachter
Closes #536 When the WM_Sn selection is already owned at startup, this now either errors out or waits for the old selection owner to exit.
2021-01-03i3bar: Add default bar_idOrestis Floros
Instead of erroring, request the list of bar configs from i3 and use the first one.
2021-01-03i3bar: Update manpage/help with optionsOrestis Floros
2020-11-29i3-nagbar: add possibility to open bar on focused monitorekarpp
Closes #3692 i3-nagbar will open by default on the monitor with input focus and using the flag -p on the primary monitor.
2020-11-16i3-sensible-terminal: prioritize terminals with good accessibility (#4259)Michael Stapelberg
We never did (and still do not) guarantee any order in which terminal emulators are tried. Quoting from the i3-sensible-terminal man page: > Please don’t complain about the order: If the user has any preference, they > will have $TERMINAL set or modified their i3 configuration file. This commit moves mate-terminal to the beginning of the list, which is considered the most accessible terminal emulator among blind users. fixes https://github.com/i3/i3/issues/4256
2019-02-21Add proper return code for i3-msgNils ANDRÉ-CHANG
2018-11-05Change config order in manpageMorten Linderud
This brings the headline for the configuration files inline with the recent move to XDG directories. Signed-off-by: Morten Linderud <morten@linderud.pw>
2018-10-07i3-nagbar: add option for button that runs commands without a terminal (#3258)Orestis
Fixes #2199.
2018-10-04i3-msg: add support for SUBSCRIBE message typeVivien Didelot
If i3-msg is invoked with -t subscribe, it will wait for the first event matching the given payload, before exiting. For instance, get the number of the next focused workspace with: i3-msg -t subscribe '[ "workspace" ]' | jshon -e current -e num Like inotifywait, the -m flag allows to wait indefinitely for events, instead of exiting right after receiving the first one. For example, continuously monitor the names of focused windows with: i3-msg -t subscribe -m '[ "window" ]' | jq .container.name
2018-08-01enhancement: adds hyper as a sensible terminal optiondownzer0
- hyper.is
2018-07-10Correct XDG paths precedence for config filesOrestis Floros
Fixes #3323
2018-06-15Update i3-msg.man: added get_config and send_tickMartin
Added get_config and send_tick which are mentioned [here](https://i3wm.org/docs/ipc.html).
2018-04-15man: Fix title markersTakashi Iwai
The title marker lines have to be aligned with the previous lines. The error was caught by asciidoctor, which tends to be picker than asciidoc. Signed-off-by: Takashi Iwai <tiwai@suse.de>
2018-03-30Add --modifier flag to i3-config-wizard (#3210)Joona
Add --modifier flag to i3-config-wizard The --modifier flag accepts either alt or win, and will generate the configuration file without opening a window. Also adds i3-config-wizard's flags to the manpage. Fixes #3136.
2018-03-16Add alacritty to i3-sensible-terminalChristian Duerr
2018-02-19Added gVim to i3-sensible-editorDebianWall
2018-02-19Added guake and tilda.DebianWall
2017-11-12add the kitty terminal in i3-sensible-terminalCast
2017-09-24Replace http:// with https:// where applicableMichael Stapelberg
The testcases will be updated automatically in a separate commit.
2017-08-31Revert "i3-nagbar: add button flag to execute action with /bin/sh directly" ↵Michael Stapelberg
(#2893)
2017-07-10Add KDE konsole terminal fallback to i3-sensible-terminalDavid Jimenez Sequero
2017-05-31Fix manpage on configuration lookup orderAdaephon-GH
The lookup order stated in the i3 manpage was is contratiction to the actual lookup order, which was introduced with commit https://github.com/i3/i3/commit/bfa12a581915d6a3de182fa6025fce108cac8eab. Since that commit (6.5 years ago) the "traditional" paths took precedence over XDG_CONFIG paths.
2017-05-12i3-nagbar: add button flag to execute action with /bin/sh directly.Max Fisher
Fixes #2765.
2017-03-26Adding new terminals to i3-sensible-terminalFranz König
2016-12-09Fix name of mcedit (#2524)Jakub Wilk
It's "mcedit", not "mc-edit".
2016-10-23generate asciidoc.conf via autoconfMichael Stapelberg
…instead of updating it in release.sh.
2016-10-23Switch to autotools (GNU build system)Michael Stapelberg
This commit probably comes as a surprise to some, given that one of i3’s explicitly stated goals used to be “Do not use programs such as autoconf/automake for configuration and creating unreadable/broken makefiles”. I phrased this goal over 7 years ago, based largely on a grudge that I inherited, which — as I’ve realized in the meantime — was largely held against FOSS in general, and not actually nuanced criticism of autotools. In the meantime, I have come to realize that the knee-jerk reaction of “I could do this better!” (i.e. writing our own build system in this particular case) is usually misguided, and nowadays I strongly suggest trying hard to fix the existing system for the benefit of all existing and future users. Further, I recently got to experience the other side of the coin, as I packaged a new version of FreeRADIUS for Debian, which at the time of writing used autoconf in combination with boilermake, a custom make-based build system that only FreeRADIUS uses. Understanding the build system enough to fix issues and enable parallel compilation took me an entire day. That time is time which potentially every downstream maintainer needs to invest, and the resulting knowledge cannot be applied to any other project. Hence, I believe it’s a good idea switch i3 to autotools. Yes, it might be that particular features were easier to implement/understand in our custom Makefiles, and there might be individuals who have an easier time reading through our custom Makefiles than learning autotools. All of these considerations are outweighed by the benefits we get from using the same build system as literally thousands of other FOSS software packages. Aside from these somewhat philosophical considerations, there’s also practical improvements which this change brings us. See the “changes” section below. ┌──────────────────────────────────────────────────────────────────────────────┐ │ new workflow │ └──────────────────────────────────────────────────────────────────────────────┘ You can now build i3 like you build any other software package which uses autotools. Here’s a memory refresher: autoreconf -fi mkdir -p build && cd build ../configure make -j8 (The autoreconf -fi step is unnecessary if you are building from a release tarball, but shouldn’t hurt either.) ┌──────────────────────────────────────────────────────────────────────────────┐ │ recommended reading │ └──────────────────────────────────────────────────────────────────────────────┘ I very much recommend reading “A Practitioner's Guide to GNU Autoconf, Automake, and Libtool” by John Calcote (https://www.nostarch.com/autotools.htm). That book is from 2010 and, AFAICT, is the most up to date comprehensive description of autotools. Do not read older documentation. In particular, if a document you’re reading mentions configure.in (deprecated filename) or recursive make (now considered harmful), it’s likely outdated. ┌──────────────────────────────────────────────────────────────────────────────┐ │ changes │ └──────────────────────────────────────────────────────────────────────────────┘ This commit implements the following new functionality/changes in behavior: • We use the AX_ENABLE_BUILDDIR macro to enforce builds happening in a separate directory. This is a prerequisite for the AX_EXTEND_SRCDIR macro and building in a separate directory is common practice anyway. In case this causes any trouble when packaging i3 for your distribution, please let me know. • “make check” runs the i3 testsuite. You can still use ./testcases/complete-run.pl to get the interactive progress output. • “make distcheck” (runs testsuite on “make dist” result, tiny bit quicker feedback cycle than waiting for the travis build to catch the issue). • “make uninstall” (occasionally requested by users who compile from source) • “make” will build manpages/docs by default if the tools are installed. Conversely, manpages/docs are not tried to be built for users who don’t want to install all these dependencies to get started hacking on i3. • non-release builds will enable address sanitizer by default. Use the --disable-sanitizers configure option to turn off all sanitizers, and see --help for available sanitizers. • Support for pre-compiled headers (PCH) has been dropped for now in the interest of simplicitly. Maybe we can re-add it later. • coverage reports are now generated using “make check-code-coverage”, which requires specifying --enable-code-coverage when calling configure. ┌──────────────────────────────────────────────────────────────────────────────┐ │ build system feature parity/testing │ └──────────────────────────────────────────────────────────────────────────────┘ In addition to what’s described above, I tested the following features: • “make install” installs the same files (plus documentation and manpages) cd i3-old && make install PREFIX=/tmp/inst/old cd i3-new && ./configure --prefix=/tmp/inst/new cd /tmp/inst (cd old && for f in $(find); do [ -e "../new/$f" ] || echo "$f missing"; done) • make dist generates a tarball which includes the same files cd i3-old && make dist cd i3-new/x86_64-pc-linux-gnu && make dist colordiff -u <(tar tf i3-old/i3-4.12.tar.bz2 | sort) \ <(tar tf i3-new/x86_64-pc-linux-gnu/i3-4.12.tar.gz | sort) There are some expected differences: • Some files have been renamed (e.g. the new etc/ and share/ subdirectories) • Some files will now be generated at build-time, so only their corresponding .in file is shipped (e.g. testcases/complete-run.pl) • The generated parser files are shipped in the dist tarball (they only depend on the parser-specs/* files, not on the target system) • autotools infrastructure is shipped (e.g. “configure”, “missing”, etc.) • DLOG and ELOG statements still produce the same file name in logfiles • Listing source code in gdb still works. • gdb backtraces contain the i3-<version> path component • release.sh still works • version embedding 1. git checkout shows “4.12-136-gf720023 (2016-10-10, branch "autotools")” 2. tarball of a git version shows “4.12-non-git” 3. release tarball shows 4.13 • debug mode is enabled by default for non-release builds • enabling verbose builds via V=1 ┌──────────────────────────────────────────────────────────────────────────────┐ │ speed │ └──────────────────────────────────────────────────────────────────────────────┘ There is no noticeable difference in compilation speed itself (of binaries, documentation and manpages): i3-old $ time make all docs mans -j8 make all docs mans -j8 28.92s user 2.15s system 640% cpu 4.852 total i3-new $ time make -j8 make -j8 27.08s user 1.92s system 620% cpu 4.669 total In terms of one-time costs: configuring the build system (../configure) takes about 2.7s on my machine, generating the build system (autoreconf -fi) takes about 3.1s on my machine. ┌──────────────────────────────────────────────────────────────────────────────┐ │ m4 macros │ └──────────────────────────────────────────────────────────────────────────────┘ All files in m4/ have been copied from the autoconf-archive package in version b6aeb1988f4b6c78bf39d97b6c4f6e1d594d59b9 and should be updated whenever they change. This commit has been tested with autoconf 2.69 and automake 1.15.
2016-07-30Update manpages (#2404)Denton Liu
2016-06-15Introduced a new GET_BINDING_MODES message type and reply. (#2376)Ingo Bürk
This type dumps all currently configured binding modes. fixes #2375
2016-05-31Added qterminal to i3-sensible-terminal (#2367)Zamarin Arthur
2016-04-04Point out the default ipc message type in i3-msg.manHong Xu
2016-03-06release i3 4.124.12Michael Stapelberg
2016-02-14Reflect changes to i3-sensible-terminal in its manpagebendem
2016-02-06travis: check spelling of binaries and manpages, use dockerMichael Stapelberg
We now build a docker base container based on debian sid (where the very latest packages are available). That base container is updated once a month, or whenever travis-build.Dockerfile or debian/control change, but re-used for subsequent travis runs. While the initial build might take up to 15 minutes, subsequent builds typically run in a minute or two. All the different steps that we run on travis are now factored into separate scripts in the travis/ directory. Switching to docker should also help with issue #2174.
2016-01-26Fix i3-nagbar example.David Coppa
2015-10-16man: add “floating window” to terminology (Thanks frederik)Michael Stapelberg
2015-09-30release i3 4.114.11Michael Stapelberg
2015-09-08release i3 4.10.44.10.4Michael Stapelberg
2015-07-30release i3 4.10.34.10.3Michael Stapelberg
2015-04-16release i3 4.10.24.10.2Michael Stapelberg
2015-03-29release i3 4.10.14.10.1Michael Stapelberg
2015-03-29Merge branch 'master' into nextMichael Stapelberg
2015-03-29release i3 4.104.10Michael Stapelberg
2015-03-11degendered termsDiana Thayer