NAME

       Notion - an X11 window manager

SYNOPSIS

       notion [options]

DESCRIPTION

       Notion is a tiling tabbed window manager designed with keyboard users in mind.

OPTIONS

       -display host:display.screen
              X display to manage

       -conffile configfile
              Configuration file to use instead of default

       -searchdir dir
              Directory to search for configuration files and other scripts

       -oneroot
              On  X  servers  with multiple (traditional non-Xinerama) screens, manage only default screen (root
              window), not all, as given by the -display option or in the DISPLAY environment variable.

       -session session_name
              Set  session  name.  This  option  affects  where  workspace  and  other  save   files   are   put
              (~/.notion/session_name if option set).

       -help  Show help on command line options

       -version
              Show version

       -about Show about text (version, author, license)

BASIC CONCEPTS

       This  section is an overview of the types objects that appear on an X display managed by Notion and their
       relationships in a standard setup. This  information  is  necessary  to  understand  the  operations  and
       availability  of  the different key bindings explained below. For a more detailed explanation, needed for
       writing custom bindings configuration files, see the additional documentation available from  the  Notion
       Web page.

       The  top-level objects that matter in the case at hand are screens.  They correspond to physical screens.
       Screens contain workspaces (which are a kind of group), and client windows put  into  full  screen  mode.
       These objects are multiplexed in the sense that only one can be displayed at a time.

       Workspaces themselves may contain tilings and detached/floating frames. A workspace containing no tilings
       and only detached/floating windows is also called a floating workspace. Tilings themselves contain frames
       tiled  to  fill  the  screen,  and  possibly a statusbar or dock. Akin to screens, frames multiplex other
       objects, but in this case mostly client window groups. Most of the time, frames are  the  only  trace  of
       Notion  you  see  on  the  screen.  Frames  may  have  border  decorations,  and they have a tab for each
       multiplexed object.

       Queries are boxes that appear at the bottoms of frames or screens to ask you for textual input to execute
       an action that depends on it.  Most queries support tab-completion.

BINDINGS

       These  are  the default key and pointer bindings. Below, Mod4 refers to the modifier used by Notion. Mod4
       is the default, but this can be configured by setting META in the configuration. The particular key  that
       is  interpreted  as Mod4 depends on your system. On Xorg-based systems it is usually bound to the windows
       key. The xmodmap(1x) tool can be used to get/set which key codes correspond to which modifiers,  and  the
       xev(1x) tool can be used to see what codes are generated by particular keys.

       The  string  in  square  brackets  after  a  binding  group  heading  below  indicates  the  module whose
       configuration file defines these bindings.

   Globally available bindings
       Mod4+1, Mod4+2, Mod4+3, Mod4+4, Mod4+5, Mod4+6, Mod4+7, Mod4+8, Mod4+9, Mod4+0
              Switch to n:th object (workspace, full screen client window) within current screen.

       Mod4+comma, Mod4+period
              Switch to next/previous object within current screen.

       Mod4+K K
              Go to first region demanding attention or previously active one.

       Mod4+K T
              Clear all tags.

       Mod4+Shift+1, Mod4+Q, Mod4+Shift+2, Mod4+W, Mod4+Shift+3, Mod4+E
              Go to n:th screen on multihead setup.

       Mod4+Shift+comma, Mod4+I, Mod4+O, Mod4+grave
              Go to next/previous screen on multihead setup.

       Mod4+F9
              Create a new workspace of chosen default type.

       F12, Button3 press
              Display the main menu.

       Button2 press
              Display the window list menu.

       Mod4+Tab
              Forward-circulate focus.

       Mod4+K Tab
              Backward-circulate focus.

       Mod4+K R
              Raise focused object, if possible.

   Bindings operating on all frames and screens
       Mod4+C Close current object.

   Bindings operating on all frames
       Mod4+K H, Mod4+K V
              Maximize the frame horizontally/vertically.

       Button3 press
              Display context menu.

       Mod4+R Begin move/resize mode.

       Button1 click at tab, Button2 click at tab
              Switch the frame to display the object indicated by the tab.

       Button1 drag at border, Mod4+Button3 drag
              Resize the frame.

       Mod4+Button1 drag
              Move the frame.

       Button1 drag at tab, Button2 drag at tab
              Move objects between frames by dragging and dropping the tab.

       Mod4+Button4 click, Mod4+Button5 click
              Switch to next/previous object within the frame.

   Bindings operating on top-level (non-transient) frames and screens
       Mod4+T Toggle tag of current object.

       Mod4+L Lock screen

       F1     Query for manual page to be displayed.

       Mod4+F1
              Show the Notion manual page.

       F2     Run a terminal emulator.

       F3     Query for command line to execute.

       Mod4+F3
              Query for Lua code to execute.

       F4     Query for host to connect to with SSH.

       F5     Query for file to edit.

       F6     Query for file to view.

       F9     Query for workspace to go to or create a new one.

       Mod4+G Query for a client window to go to.

       Mod4+M Display context menu.

       Mod4+K D
              Detach (float) or reattach an object to its previous location.

       Mod4+K G
              Menu for recently used workspaces.

   Bindings operating on top-level (non-transient) frames
       Mod4+A Query for a client window to attach.

       Mod4+K 1, Mod4+K 2, Mod4+K 3, Mod4+K 4, Mod4+K 5, Mod4+K 6, Mod4+K 7, Mod4+K 8, Mod4+K 9, Mod4+K 0
              Switch to n:th object within the frame.

       Mod4+K N, Mod4+K P
              Switch to next/previous object within the frame.

       Mod4+K comma, Mod4+K period
              Move current object within the frame left/right.

       Mod4+K H, Mod4+K V
              Maximize the frame horizontally/vertically.

       Mod4+K A
              Attach tagged objects to this frame.

   Bindings for floating/detached frames
       Button1 double click at tab
              Toggle shade mode

       Button1 press at tab, Button1 press at border, Mod4+Button1 click
              Raise the frame.

       Mod4+Button3 click
              Lower the frame.

       Button1 drag at tab
              Move the frame.

       Mod4+K B
              Tile frame, if no tiling exists on the workspace

   Bindings for tilings and tiled frames [mod_tiling]
       Mod4+S Split current frame vertically.

       Mod4+P, Mod4+N, Mod4+Shift+Button4 click, Mod4+Shift+Button5 click
              Go to frame above/below current frame.

       Mod4+Tab, Mod4+K Tab
              Go to frame right/left of current frame.

       Mod4+K S
              Split current frame horizontally.

       Mod4+K X
              Destroy current frame.

   Bindings for client windows
       Mod4+K Mod4+L
              Nudge the client window. This might help with some programs' resizing problems.

       Mod4+K C
              Kill client owning the client window.

       Mod4+K Q
              Send next key press to the client window. Some programs may not allow this by default.

       Mod4+Return
              Toggle client window group full-screen mode

   Move/resize mode bindings
       Escape Cancel the resize mode.

       Return End the resize mode.

       Left, Right, Up, Down, F, B, P, N
              Grow in specified direction.

       Shift+Left, Shift+Right, Shift+Up, Shift+Down, Shift+F, Shift+B, Shift+P, Shift+N
              Shrink in specified direction.

       Mod4+Left, Mod4+Right, Mod4+Up, Mod4+Down, Mod4+F, Mod4+B, Mod4+P, Mod4+N
              Move in specified direction.

   Bindings for message boxes and queries [mod_query]
       Escape, Control+G, Control+C
              Close the query/message box, not executing bound actions.

       Control+U, Control+V, Page_Up, Page_Down
              Scroll the message or completions up/down.

   Bindings for editing in queries [mod_query]
       These bindings are similar to those of the joe(1) text editor.  Cut, copy  and  paste  works  in  a  more
       conventional manner, though, but the keys are equivalent.

       Control+F, Control+B, Right, Left
              Move one character forward/backward.

       Control+E, Control+A, End, Home
              Go to end/beginning.

       Control+X, Control+Z
              Skip one word forward/backward.

       Control+D, Delete
              Delete next character.

       BackSpace, Control+H
              Delete previous character.

       Control+W, Control+O
              Delete one word forward/backward.

       Control+J
              Delete to end of line.

       Control+Y
              Delete the whole line.

       Control+T
              Transpose characters.

       Control+P, Control+N, Up, Down, Control+Up, Control+Down
              Select next/previous (matching) history entry.

       Button2 click, Control+K C
              Paste from the clipboard.

       Control+K B
              Set mark/begin selection.

       Control+K Y
              Cut selection.

       Control+K K
              Copy selection.

       Control+K G
              Clear mark/cancel selection.

       Tab, Shift+Tab, Control+Tab
              Try to complete the entered text or cycle through completions.

       Control+R, Control+S
              Complete from history

       Control+M, Return, KP_Enter
              Close the query and execute bound action.

   Bindings for menus [mod_menu]
       Escape, Control+G, Control+C, Left
              Close the menu.

       Return, KP_Enter, Control+M, Right
              Activate current menu entry.

       Control+N, Control+P, Up, Down
              Select next/previous menu entry.

       BackSpace
              Clear the menu's typeahead find buffer.

FILES AND DIRECTORIES

       /etc/X11/notion/cfg_notion.lua
              System default main configuration files

       /etc/X11/notion/cfg_*.lua
              Other configuration files.

       /etc/X11/notion/look_*.lua
              Colour scheme configuration files

       ~/.notion/
              User configuration files

       ~/.notion/cfg_notion.lua
              User default main configuration file (overrides system default)

SEE ALSO

       The Notion home page, http://notion.sf.net/

       The document "Configuring and extending Notion with Lua" found on the Notion home page.

       /usr/share/doc/notion/

       X(7x), notionflux(1), joe(1)

AUTHOR

       Notion  was  written  by  the  Notion  team,  based on Ion which was written by Tuomo Valkonen <tuomov at
       iki.fi>.

                                                                                                       NOTION(1)