Contents

• Chapter 1  Introduction
• Chapter 2  Preliminaries: Key concepts and relations
  • 2.1  Modules
  • 2.2  Class and object hierarchies
    • 2.2.1  Class hierarchy
    • 2.2.2  Object hierarchies: WRegion parents and managers
    • 2.2.3  Summary
• Chapter 3  Basic configuration
  • 3.1  The configuration files
  • 3.2  A walk through ion.lua
  • 3.3  Keys and rodents
    • 3.3.1  The binding setup functions
      • Ioncore binding setup functions
      • IonWS module binding setup functions
      • FloatWS module binding setup functions
      • Query module binding setup functions
      • Menu module binding setup functions
    • 3.3.2  Defining the bindings
    • 3.3.3  An example
    • 3.3.4  Another example
    • 3.3.5  Key and button specifications
    • 3.3.6  A further note on the default binding configuration
    • 3.3.7  Client window bindings
  • 3.4  Winprops
    • 3.4.1  Classes, roles and instances
    • 3.4.2  Finding window identification with xprop
    • 3.4.3  Supported winprops
    • 3.4.4  Some common examples
      • Acrobat Reader
      • Fixing a Mozilla Firebird transient
      • Forcing newly created windows in named frames
  • 3.5  The query library
  • 3.6  Menus
    • 3.6.1  Defining menus
    • 3.6.2  Special menus
    • 3.6.3  Displaying menus
  • 3.7  Some common configuration tasks
    • 3.7.1  Binding a key to execute a program
• Chapter 4  Graphical styles
  • 4.1  Drawing engines, style specifications and sub-styles
    • 4.1.1  Known styles and substyles
      • Frames
      • Tabs and menu entries
      • The rest
  • 4.2  Defining styles for the default drawing engine
    • 4.2.1  The structure of the configuration files
    • 4.2.2  Defining the styles
      • Colours
      • Borders and widths
      • Text
      • Miscellaneous
      • Substyles
    • 4.2.3  An example
  • 4.3  Miscellaneous settings
    • 4.3.1  Extra fields for style frame-ionframe
    • 4.3.2  Extra fields for style frame-floatframe
    • 4.3.3  Extra fields for style dock
• Chapter 5  Scripting
  • 5.1  Hooks and other callbacks
    • 5.1.1  Hooks
    • 5.1.2  Placement methods
  • 5.2  Referring to regions
    • 5.2.1  Direct object references
    • 5.2.2  Name-based lookups
  • 5.3  Alternative winprop selection criteria
• Chapter 6  Function reference
  • 6.1  Functions exported by Ioncore
    • 6.1.1  WClientWin functions
    • 6.1.2  WGenFrame functions
    • 6.1.3  WMPlex functions
    • 6.1.4  WRegion functions
    • 6.1.5  WRootWin functions
    • 6.1.6  WScreen functions
  • 6.2  Functions exported by the ionws module
    • 6.2.1  WIonFrame functions
    • 6.2.2  WIonWS functions
    • 6.2.3  WWsSplit functions
  • 6.3  Functions exported by the floatws module
    • 6.3.1  WFloatFrame functions
    • 6.3.2  WFloatWS functions
  • 6.4  Functions exported by the query module
    • 6.4.1  WEdln functions
    • 6.4.2  WInput functions
  • 6.5  Functions exported by the menu module
    • 6.5.1  WMenu functions
  • 6.6  Functions exported by the de module
  • 6.7  Functions exported by the dock module
    • 6.7.1  WDock functions
  • 6.8  Functions defined in ioncorelib
  • 6.9  Functions defined in querylib
  • 6.10  Functions defined in delib
  • 6.11  Functions defined in menulib
• Appendix A  The GNU General Public License