updated the documentation
This commit is contained in:
parent
53b4a83757
commit
ae8f325d9f
4 changed files with 126 additions and 46 deletions
|
@ -12,12 +12,7 @@
|
|||
|
||||
=8.3.0=
|
||||
|
||||
(+) Multi-dimensional tiling of the master area. The user may now specify
|
||||
X and Y dimensions independently up to 9 x 9.
|
||||
(+) Initially assign windows to the monitor on which they appear if
|
||||
nothing is specified in the configuration.
|
||||
(~) Improved view arranging runtime.
|
||||
(+) Created bug.n log to record major and debugging events.
|
||||
(~) Fixed bug #18641: Freezing problem. In most cases, bug.n will no
|
||||
longer hang when one of its managed windows hangs.
|
||||
(~) Fixed bug: Sometimes cycling through the windows in a view would
|
||||
|
@ -26,10 +21,38 @@
|
|||
a non-active monitor could cause both monitors to change views.
|
||||
(~) Gap widths are now treated identically on both "tile" and "monocle"
|
||||
layouts.
|
||||
(~) Fixed bug #18650: Unexpected monitor focus changes
|
||||
(~) Fixed bug in 'Manager_setWindowMonitor(d)' and
|
||||
'Manager_setViewMonitor(d)'
|
||||
(~) Fixed bug, which prevented bug.n from Main_reload, if the number of
|
||||
monitors changed.
|
||||
(~) Fixed bug: Closing Bar_cmdGui and activating the next to last window.
|
||||
(~) Fixed bug: Vertical position of Bar_cmdGui, if
|
||||
Config_verticalBarPos=tray and the task bar is at the top of the
|
||||
monitor.
|
||||
(~) Fixed bug: On Main_reload() and Config_verticalBarPos=tray.
|
||||
(~) Changed the command line argument from specifying 'the path to the
|
||||
config.ini' to 'the path to the general data directory containing
|
||||
the config.ini and log.txt'.
|
||||
(+) Multi-dimensional tiling of the master area. The user may now specify
|
||||
X and Y dimensions independently up to 9 x 9.
|
||||
(+) Initially assign windows to the monitor on which they appear if
|
||||
nothing is specified in the configuration.
|
||||
(+) Created bug.n log to record major and debugging events and window
|
||||
information.
|
||||
(+) 'View margins' allowing a layout to occupy a limited space of the
|
||||
monitor.
|
||||
(+) 'Single window action', which allows to close or maximize windows
|
||||
based on rules.
|
||||
(+) 'Reload' hotkey, which reloads the whole script.
|
||||
(+) Re-Setting the 'Reload' and 'ExitApp' hotkey in 'config.ini'-
|
||||
(+) Added the configuration variable "Config_viewNames", with which views
|
||||
can be named and the number of views can be set. The configuration
|
||||
variable "Config_viewCount" therewith becomes obsolete.
|
||||
(-) Removed the configuration variable "Config_viewCount".
|
||||
(-) Removed the explicit listing of commands in the Bar_cmdGui.
|
||||
(-) Removed the default rules for Gimp, since from version 2.8 onwards
|
||||
Gimp can use a single application window instead of three and more.
|
||||
|
||||
|
||||
=8.2.1=
|
||||
|
|
|
@ -97,6 +97,12 @@
|
|||
The default values are retrieved from the "Window Color and Appearance"
|
||||
settings.
|
||||
|
||||
: **Config_barCommands**=Run, explore docs;Monitor_toggleBar();Main_reload();Reload;ExitApp
|
||||
The commands seperated by semicolon, which are listed in the command GUI
|
||||
of the bar (#!) and therewith can be selected rather then typed; bug.n
|
||||
functions (as used in the hotkey configuration), the "Run" and "Send"
|
||||
command of AutoHotkey can be used here.
|
||||
|
||||
: **Config_readinBat**=0
|
||||
If true (=1), the system battery status is read in and displayed in the
|
||||
status bar. This only makes sense, if you have a system battery
|
||||
|
@ -110,6 +116,18 @@
|
|||
If true (=1), the current date is read in (format: "WW, DD. MMM. YYYY")
|
||||
and displayed in the status bar.
|
||||
|
||||
: **Config_readinDiskLoad**=0
|
||||
If true (=1), the current disk load (read and write) is read in and
|
||||
displayed in the status bar.
|
||||
|
||||
: **Config_readinMemoryUsage**=0
|
||||
If true (=1), the system memory usage is read in and displayed in the
|
||||
status bar.
|
||||
|
||||
: **Config_readinNetworkLoad**=0
|
||||
If true (=1), the current network load (up and down) is read in and
|
||||
displayed in the status bar.
|
||||
|
||||
: **Config_readinTime**=1
|
||||
If true (=1), the current time is read in (format: "HH:MM") and
|
||||
displayed in the status bar.
|
||||
|
@ -157,10 +175,10 @@ settings.
|
|||
=== View / Layout ===
|
||||
|
||||
: **Config_viewNames**=1;2;3;4;5;6;7;8;9
|
||||
The names of the views in use separated by a semicolon. With the number
|
||||
of fields in this list the total number of views is given. This has
|
||||
effects on the displayed groups in the bar, and should not be exceeded in
|
||||
the hotkeys section of the configuration.
|
||||
The names of the views separated by a semicolon. This variable sets the
|
||||
names of the views shown in the status bar and determines the nummber of
|
||||
views (Config_viewCount); the total number of names given, i. e. views,
|
||||
should not be exceeded by the configured hotkeys.
|
||||
|
||||
: **Config_layout_#1**=[]=;tile
|
||||
The layout symbol and arrange function (the first entry is set as the
|
||||
|
@ -184,17 +202,39 @@ settings.
|
|||
The stack axis: 1 = x (from left to right), 2 = y (from top to
|
||||
bottom), 3 = z (monocle).
|
||||
|
||||
: **Config_layoutGapWidth=0
|
||||
The default gap width in px (only even numbers) of the "tile" layout,
|
||||
i. e. the space between windows and around the layout.
|
||||
|
||||
: **Config_layoutMFactor**=0.6
|
||||
The factor for the size of the master area, which is multiplied by the
|
||||
monitor size.
|
||||
|
||||
: **Config_viewMargins**=0;0;0;0
|
||||
The margin of a view (around the layout, "monocle" and "tile") as a
|
||||
semicolon separated list of values in px (top;right;bottom;left), which
|
||||
by default can be activated per view with the hotkey Win+Shift+N
|
||||
(View_toggleMargins).
|
||||
With view margins you may create an empty area on the monitor, which is
|
||||
not occupied by the layout, therewith making a desktop widget visible.
|
||||
|
||||
|
||||
=== Runtime ===
|
||||
|
||||
: **Config_ghostWndSubString**= (Not Responding)
|
||||
The text string, which identifies a hung window in its title bar; the
|
||||
german Windows version uses " (Keine Rückmeldung)".
|
||||
|
||||
: **Config_mouseFollowsFocus**=1
|
||||
If true (=1), the mouse pointer is set over the focused window, if a
|
||||
window is activated by bug.n.
|
||||
|
||||
: **Config_newWndPosition=top
|
||||
The position of a new window in a view; "top": at the beginning of the
|
||||
window list and the master area (default), "masterBottom": at the end
|
||||
of the master area, "stackTop": on top of the stack area, "bottom": at
|
||||
the end of the window list and the stack area.
|
||||
|
||||
: **Config_onActiveHiddenWnds**=view
|
||||
The action, which will be taken, if a window e. g. should be
|
||||
activated, but is not visible; "view": show the view accordng to the
|
||||
|
@ -210,7 +250,7 @@ settings.
|
|||
: **Config_syncMonitorViews**=0
|
||||
The number of monitors (2 or more), for which views should be
|
||||
activated, when using the accordant hotkey. If set to 1, the views are
|
||||
actiated for all monitors. If set to 0, views are activated
|
||||
activated for all monitors. If set to 0, views are activated
|
||||
independently (only on the active monitor).
|
||||
|
||||
: **Config_viewFollowsTagged**=0
|
||||
|
@ -220,7 +260,7 @@ settings.
|
|||
|
||||
=== Rules ===
|
||||
|
||||
: **Config_rule_#1**=.*;.*;;1;0;0;0;0;0
|
||||
: **Config_rule_#1**=.*;.*;;1;0;0;0;0;0;
|
||||
If you want to replace a default rule, you will have to use the
|
||||
correct variable name, e. g. you may set a rule (.*;.*;) for a default
|
||||
monitor, view and / or showing window title bars by setting the first
|
||||
|
@ -228,39 +268,39 @@ settings.
|
|||
If you want to add a rule you do not have to use a numbered variable,
|
||||
but "Config_rule=..." (the numbering will be done automatically in the
|
||||
order given in the configuration file). General format:
|
||||
Config_rule[_#<i>]=<class (regular expression string)>;<title (regular
|
||||
Config_rule_#<i>=<class (regular expression string)>;<title (regular
|
||||
expression string)>;<window style (hexadecimal number or blank)>;
|
||||
<is managed (1 = True or 0 = False)>;<monitor (0 <= integer <= total
|
||||
number of monitors, 0 means the currently active monitor)>;<tags
|
||||
(binary mask as integer >= 0, e. g. 17 for 1 and 5, 0 means the
|
||||
currently active tag)>;<is floating (1 = True or 0 = False)>;
|
||||
<is decorated (1 = True or 0 = False)>;<hide title (1 = True or
|
||||
0 = False)>
|
||||
0 = False)>;<action on single windows (Close or Maximize)>
|
||||
(all in one line, ";" is not allowed as a character)
|
||||
|
||||
: **Config_rule_#2**=.*;.*;0x80000000;0;0;0;1;1;1
|
||||
: **Config_rule_#2**=.*;.*;0x80000000;0;0;0;1;1;1;
|
||||
Pop-up windows (style WS_POPUP=0x80000000) will not be managed, are
|
||||
floating and the titles are hidden.
|
||||
|
||||
: **Config_rule_#3**=SWT_Window0;.*;;1;0;0;0;0;0
|
||||
: **Config_rule_#3**=SWT_Window0;.*;;1;0;0;0;0;0;
|
||||
Windows created by Java (SWT) e. g. Eclipse have the style WS_POPUP,
|
||||
but should excluded from the above rule.
|
||||
but should be excluded from the second rule.
|
||||
|
||||
: **Config_rule_#4**=Xming;.*;;1;0;0;0;0;0
|
||||
Xming windows have the style WS_POPUP, but should be excluded from
|
||||
the above rule.
|
||||
: **Config_rule_#4**=QWidget;.*;;1;0;0;0;0;0;
|
||||
Also windows created by QT (QWidget) should be excluded from the second
|
||||
rule for the same reason as above.
|
||||
|
||||
: **Config_rule_#5**=MsiDialog(No)?CloseClass;.*;;1;0;0;1;1;0"
|
||||
: **Config_rule_#6**=AdobeFlashPlayerInstaller;.*;;1;0;0;1;0;1"
|
||||
: **Config_rule_#7**=CalcFrame;.*;;1;0;0;1;1;0"
|
||||
: **Config_rule_#8**=_sp;_sp;;1;0;0;1;0;1"
|
||||
: **Config_rule_#9**=MozillaDialogClass;.*;;1;0;0;1;1;0"
|
||||
: **Config_rule_#10**=gdkWindowToplevel;GIMP-Start;;1;0;0;1;1;0"
|
||||
: **Config_rule_#11**=gdkWindowToplevel;GNU Image Manipulation Program;;1;0;0;1;1;0"
|
||||
: **Config_rule_#12**=gdkWindowToplevel;Werkzeugkasten;;1;0;0;1;1;0"
|
||||
: **Config_rule_#13**=gdkWindowToplevel;Ebenen, .* - Pinsel, Muster, .*;;1;0;0;1;1;0"
|
||||
: **Config_rule_#14**=gdkWindowToplevel;Toolbox;;1;0;0;1;1;0"
|
||||
: **Config_rule_#15**=gdkWindowToplevel;Layers, Channels, Paths, .*;;1;0;0;1;1;0"
|
||||
: **Config_rule_#5**=Xming;.*;;1;0;0;0;0;0;
|
||||
Also Xming windows should be excluded from the second rule for the same
|
||||
reason as above.
|
||||
|
||||
: **Config_rule_#6**=MsiDialog(No)?CloseClass;.*;;1;0;0;1;1;0;
|
||||
: **Config_rule_#7**=AdobeFlashPlayerInstaller;.*;;1;0;0;1;0;1;
|
||||
: **Config_rule_#8**=CalcFrame;.*;;1;0;0;1;1;0;
|
||||
: **Config_rule_#9**=MozillaDialogClass;.*;;1;0;0;1;1;0;
|
||||
: **Config_rule_#10**=_sp;_sp;;1;0;0;1;0;1;
|
||||
: **Config_rule_#11**=MozillaWindowClass;.* - Mozilla Firefox;;1;0;0;0;1;0;Maximize
|
||||
: **Config_rule_#12**=Chrome_WidgetWin_1;.*;;1;0;0;0;1;0;Maximize
|
||||
|
||||
|
||||
=== Session management ===
|
||||
|
|
|
@ -71,7 +71,7 @@ There are three layouts.
|
|||
A master area for the main window(s) and a stacking area for the rest,
|
||||
all windows are shown at any time. This layout can be further changed
|
||||
in the following respects:
|
||||
- the dimensions of the master area (1x1 ... 9x9)
|
||||
- the dimensions of the master area (1x1 ... 2x3 ... 9x9)
|
||||
- the stacking direction of the master and stacking area (from left to
|
||||
right, from top to bottom or monocle)
|
||||
- the position of the master area (left, top, right or bottom)
|
||||
|
@ -120,7 +120,7 @@ path to the configuration file (<file path to the bug.n executable>
|
|||
If you are using bug.n on Microsoft Windows Vista or 7 you may use
|
||||
applications, which run with administrator privileges e. g.
|
||||
administrative tools and therefor are not managed by bug.n, if it is
|
||||
run with an account, which //is// not the administrator. If you want
|
||||
run with an account, which is //not// the administrator. If you want
|
||||
those applications to be managed, you need to run bug.n with
|
||||
administrator privileges, too.
|
||||
You can set the option "Run this program as an administrator" on the
|
||||
|
|
|
@ -136,19 +136,27 @@ pressing the left Windows key and the shift key and the q key
|
|||
|
||||
: #^Left::**View_setMX(-1)**
|
||||
Decrease the master X dimension by 1, i. e. decrease the number of
|
||||
windows in the master area by Y. Minimum of 1.
|
||||
windows in the master area by Y. Minimum of 1 (only for the "tile"
|
||||
layout).
|
||||
|
||||
: #^Right::**View_setMX(+1)
|
||||
Increase the master X dimension by 1, i. e. increase the number of
|
||||
windows in the master area by Y. Maximum of 9.
|
||||
windows in the master area by Y. Maximum of 9 (only for the "tile"
|
||||
layout).
|
||||
|
||||
: #^Down::**View_setMY(-1)**
|
||||
Decrease the master Y dimension by 1, i.e. decrease the number of
|
||||
windows in the master area by X. Minimum of 1.
|
||||
windows in the master area by X. Minimum of 1 (only for the "tile"
|
||||
layout).
|
||||
|
||||
: #^Up::**View_setMY(+1)**
|
||||
Increase the master Y dimension by 1, i.e. increase the number of
|
||||
windows in the master area by X. Maximum of 9.
|
||||
windows in the master area by X. Maximum of 9 (only for the "tile"
|
||||
layout).
|
||||
|
||||
: #+n::**View_toggleMargins()**
|
||||
Toggle the view margins, which are set by the configuration variable
|
||||
"Config_viewMargins".
|
||||
|
||||
|
||||
=== Tag / View related hotkeys ===
|
||||
|
@ -207,20 +215,22 @@ pressing the left Windows key and the shift key and the q key
|
|||
|
||||
=== Logging/Debugging related hotkeys ===
|
||||
|
||||
: #^i::**Manager_logViewWindowList()**
|
||||
Dump the contents of the current view to the bug.n log.
|
||||
: #^i::**Debug_logViewWindowList()**
|
||||
Dump window information on the windows of the active view to the log.
|
||||
|
||||
: #+^i::**Manager_logManagedWindowList()**
|
||||
Dump the contents of the managed window list to the bug.n log.
|
||||
: #+^i::**Debug_logManagedWindowList()**
|
||||
Dump window information on the contents of the managed window list
|
||||
(floating and tiled windows of all views) to the log.
|
||||
|
||||
: #^h::**Manager_logHelp()**
|
||||
Print to the log a description of the formatting used in the
|
||||
previous two log messages.
|
||||
: #^h::**Debug_logHelp()**
|
||||
Print a description of the formatting (column headings) used in the
|
||||
previous two log messages (Manager_logViewWindowList and
|
||||
Manager_logManagedWindowList) to the log.
|
||||
|
||||
: #^[::**Log_decDebugLevel()**
|
||||
: #^d::**Debug_setLogLevel(-1)**
|
||||
Decrement the debug log level. Show fewer debug messages.
|
||||
|
||||
: #^]::**Log_incDebugLevel()**
|
||||
: #^+d::**Debug_setLogLevel(+1)**
|
||||
Increment the debug log level. Show more debug messages.
|
||||
|
||||
|
||||
|
@ -240,12 +250,19 @@ pressing the left Windows key and the shift key and the q key
|
|||
Reload bug.n (i. e. the configuration and its dependent settings)
|
||||
without deleting the window lists of bug.n and restoring windows.
|
||||
! It does not reset internal configuration variables, the tray icon or
|
||||
menu, hotkeys (unless set explicitly in Config.ini), individual window
|
||||
menu, hotkeys (unless defined in Config.ini), individual window
|
||||
settings like Config_showBorder (since windows might be hidden) or
|
||||
hiding the title bar, the monitor count or views.
|
||||
! It does not reload the monitor configuration and therefor does not
|
||||
recognize any changes in the number of monitors.
|
||||
! It does not reload functions.
|
||||
! Changed rules are only applied to new windows.
|
||||
|
||||
: #^+r::**Reload**
|
||||
Reload bug.n (i. e. the whole script), which resets the configuration,
|
||||
the bar, the monitor configuration and window lists of bug.n. It is
|
||||
like Quitting and restarting bug.n.
|
||||
|
||||
: #^q::**ExitApp
|
||||
Quit bug.n, restore the default Windows UI and show all windows.
|
||||
|
||||
|
|
Loading…
Reference in a new issue