From: Ben Hutchings Date: Sat, 4 Aug 2007 23:10:56 +0000 (+0000) Subject: [svn-upgrade] Integrating new upstream version, ion3 (20070720) X-Git-Tag: ion3-20070720 X-Git-Url: https://git.decadent.org.uk/gitweb/?p=ion3-doc.git;a=commitdiff_plain;h=3e627fc0998d082559ba00e28cbb264eb38b288d [svn-upgrade] Integrating new upstream version, ion3 (20070720) --- diff --git a/ChangeLog b/ChangeLog index 8f8ab99..d674b1c 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,9 @@ +2007-07-14 21:59 UTC Tuomo Valkonen + * Removed obsolete TODO note + +2007-07-14 20:34 UTC Tuomo Valkonen + * Documented orientation winprop + 2007-07-08 09:38 UTC Tuomo Valkonen tagged ion-doc-3rc-20070708 diff --git a/conf-winprops.tex b/conf-winprops.tex index e5e0133..db70e5f 100644 --- a/conf-winprops.tex +++ b/conf-winprops.tex @@ -91,6 +91,14 @@ usual method of identifying windows, and how to obtain this information. \end{winprop} +\begin{winprop}{orientation}{string} + \index{orientation@\var{orientation}} + The orientation of the window: one of \codestr{vertical} or + \codestr{horizontal}. This is only useful when using the + window as a status display. +\end{winprop} + + \begin{winprop}{statusbar}{string} \index{statusbar@\var{statusbar}} Put the window in the statusbar, in the named tray component, diff --git a/exact-version b/exact-version index 82d7222..d4a6d43 100644 --- a/exact-version +++ b/exact-version @@ -1,5 +1,11 @@ Context: +[Removed obsolete TODO note +Tuomo Valkonen **20070714215925] + +[Documented orientation winprop +Tuomo Valkonen **20070714203400] + [TAG ion-doc-3rc-20070708 Tuomo Valkonen **20070708093830] diff --git a/ionconf.dvi.gz b/ionconf.dvi.gz index 0df24ca..7518f10 100644 Binary files a/ionconf.dvi.gz and b/ionconf.dvi.gz differ diff --git a/ionconf.out b/ionconf.out index 385ef4f..a8fb3c0 100644 --- a/ionconf.out +++ b/ionconf.out @@ -47,7 +47,7 @@ \BOOKMARK [2][-]{subsection.5.2.1}{ Direct object references}{section.5.2} \BOOKMARK [2][-]{subsection.5.2.2}{ Name-based lookups}{section.5.2} \BOOKMARK [1][-]{section.5.3}{ Alternative winprop selection criteria}{chapter.5} -\BOOKMARK [1][-]{lstlisting.5.-266}{ Writing !ion-statusd! monitors}{chapter.5} +\BOOKMARK [1][-]{lstlisting.5.-267}{ Writing !ion-statusd! monitors}{chapter.5} \BOOKMARK [0][-]{chapter.6}{ Function reference}{} \BOOKMARK [1][-]{section.6.1}{ Functions defined in ioncore}{chapter.6} \BOOKMARK [2][-]{subsection.6.1.1}{ WClientWin functions}{section.6.1} diff --git a/ionconf.ps.gz b/ionconf.ps.gz index 514517f..51d19e7 100644 Binary files a/ionconf.ps.gz and b/ionconf.ps.gz differ diff --git a/ionconf.tex b/ionconf.tex index a71ba17..177fe45 100644 --- a/ionconf.tex +++ b/ionconf.tex @@ -10,7 +10,7 @@ \title{Configuring and extending Ion3 with Lua} \author{Tuomo Valkonen \\ tuomov at iki.fi} -\date{2007-07-08} +\date{2007-07-20} \makeindex diff --git a/ionconf/images.log b/ionconf/images.log index 9d415fb..079e0c0 100644 --- a/ionconf/images.log +++ b/ionconf/images.log @@ -1,4 +1,4 @@ -This is pdfeTeX, Version 3.141592-1.21a-2.2 (Web2C 7.5.4) (format=latex 2007.4.8) 8 JUL 2007 12:40 +This is pdfeTeX, Version 3.141592-1.21a-2.2 (Web2C 7.5.4) (format=latex 2007.4.8) 20 JUL 2007 16:59 entering extended mode **./images.tex (./images.tex @@ -364,22 +364,22 @@ l2hSize :tex2html_wrap_inline1059:7.48248pt::0.0pt::48.86426pt. ] -l2hSize :tex2html_wrap_inline2241:8.7125pt::8.7125pt::23.6642pt. +l2hSize :tex2html_wrap_inline2259:8.7125pt::8.7125pt::23.6642pt. [3 ] -l2hSize :tex2html_wrap_inline5516:7.5626pt::7.5626pt::14.53923pt. +l2hSize :tex2html_wrap_inline5534:7.5626pt::7.5626pt::14.53923pt. [4 ] -l2hSize :tex2html_wrap_inline5518:7.5626pt::7.5626pt::14.53923pt. +l2hSize :tex2html_wrap_inline5536:7.5626pt::7.5626pt::14.53923pt. [5 ] -l2hSize :tex2html_wrap_inline7768:8.7125pt::8.7125pt::86.9574pt. +l2hSize :tex2html_wrap_inline7786:8.7125pt::8.7125pt::86.9574pt. [6 diff --git a/ionconf/images.tex b/ionconf/images.tex index 75709b4..6e1ef45 100644 --- a/ionconf/images.tex +++ b/ionconf/images.tex @@ -82,7 +82,7 @@ \title{Configuring and extending Ion3 with Lua} \author{Tuomo Valkonen \\tuomov at iki.fi} -\date{2007-07-08} +\date{2007-07-20} \makeindex @@ -301,7 +301,7 @@ $N=1{\ldots} 5$% \stepcounter{subsection} \stepcounter{subsection} {\newpage\clearpage -\lthtmlinlinemathA{tex2html_wrap_inline2241}% +\lthtmlinlinemathA{tex2html_wrap_inline2259}% $(0, 1]$% \lthtmlinlinemathZ \lthtmlcheckvsize\clearpage} @@ -325,13 +325,13 @@ $(0, 1]$% \stepcounter{subsection} \stepcounter{subsection} {\newpage\clearpage -\lthtmlinlinemathA{tex2html_wrap_inline5516}% +\lthtmlinlinemathA{tex2html_wrap_inline5534}% $-1$% \lthtmlinlinemathZ \lthtmlcheckvsize\clearpage} {\newpage\clearpage -\lthtmlinlinemathA{tex2html_wrap_inline5518}% +\lthtmlinlinemathA{tex2html_wrap_inline5536}% $-2$% \lthtmlinlinemathZ \lthtmlcheckvsize\clearpage} @@ -361,7 +361,7 @@ $-2$% \stepcounter{section} \stepcounter{subsection} {\newpage\clearpage -\lthtmlinlinemathA{tex2html_wrap_inline7768}% +\lthtmlinlinemathA{tex2html_wrap_inline7786}% $\{t,m,b\}\times\{t,c,b\}$% \lthtmlinlinemathZ \lthtmlcheckvsize\clearpage} diff --git a/ionconf/index.html b/ionconf/index.html index 7f97e0f..beebfd3 100644 --- a/ionconf/index.html +++ b/ionconf/index.html @@ -57,7 +57,7 @@ original version by: Nikos Drakos, CBLU, University of Leeds

Tuomo Valkonen

tuomov at iki.fi

-

2007-07-08

+

2007-07-20

diff --git a/ionconf/ionconf.html b/ionconf/ionconf.html index 7f97e0f..beebfd3 100644 --- a/ionconf/ionconf.html +++ b/ionconf/ionconf.html @@ -57,7 +57,7 @@ original version by: Nikos Drakos, CBLU, University of Leeds

Tuomo Valkonen

tuomov at iki.fi

-

2007-07-08

+

2007-07-20

diff --git a/ionconf/node11.html b/ionconf/node11.html index d529fb6..4fd7b9a 100644 --- a/ionconf/node11.html +++ b/ionconf/node11.html @@ -58,73 +58,73 @@ original version by: Nikos Drakos, CBLU, University of Leeds Index

acrobatic - : 3.5 + : 3.5
Alt : 3.3.5
AnyModifier : 3.3.5
resizeinc - : 3.5.1 - | 3.5.1 + : 3.5.1 + | 3.5.1
Button-n : 3.3.6
class
-
winprop : 3.5.2 +
winprop : 3.5.2
clientwin_do_manage_alt - : 6.9 + : 6.9
clientwin_mapped_hook - : 6.9 + : 6.9
clientwin_property_change_hook - : 6.9 + : 6.9
clientwin_unmapped_hook - : 6.9 + : 6.9
Control : 3.3.5
defmenu : 3.4.1
drawing engine - : 4.1 + : 4.1
ETCDIR : 3.1
float - : 3.5 + : 3.5
frame_managed_changed_hook - : 6.9 + : 6.9
fullscreen - : 3.5 + : 3.5
ignore_resizeinc - : 3.5.1 - | 3.5.1 + : 3.5.1 + | 3.5.1
ignore_cfgrq - : 3.5 + : 3.5
ignore_max_size - : 3.5.1 + : 3.5.1
ignore_min_size - : 3.5.1 + : 3.5.1
ignore_net_active_window - : 3.5 + : 3.5
instance
-
winprop : 3.5.2 +
winprop : 3.5.2
ioncore_deinit_hook - : 6.9 + : 6.9
ioncore_post_layout_setup_hook - : 6.9 + : 6.9
ioncore_sigchld_hook - : 6.9 + : 6.9
ioncore_snapshot_hook - : 6.9 + : 6.9
ioncore_submap_ungrab_hook - : 6.9 + : 6.9
is_dockapp
-
winprop : 3.5.2 +
winprop : 3.5.2
is_transient
-
winprop : 3.5.2 +
winprop : 3.5.2
jumpto - : 3.5 + : 3.5
keysymdef.h : 3.3.5
Lock @@ -132,36 +132,38 @@ Index
manager : 2.2.2.1
max_size - : 3.5.1 + : 3.5.1
menuentry : 3.4.1
menus : 3.4.1
min_size - : 3.5.1 + : 3.5.1
ModN : 3.3.5
name
-
winprop : 3.5.2 +
winprop : 3.5.2
new_group - : 3.5 + : 3.5
NumLock : 3.3.5
Obj : 2.2.1
oneshot - : 3.5 + : 3.5 +
orientation + : 3.5
parent : 2.2.2.1
PREFIX : 3.1
region_do_warp_alt - : 6.9 + : 6.9
region_notify_hook - : 6.9 + : 6.9
role
-
winprop : 3.5.2 +
winprop : 3.5.2
root window : 2.2.1 @@ -170,35 +172,35 @@ Index
X : 2.2.1
screen_managed_changed_hook - : 6.9 + : 6.9
ScrollLock : 3.3.5
Shift : 3.3.5
statusbar - : 3.5 + : 3.5
style - : 4.1 + : 4.1
submenu : 3.4.1
substyle - : 4.1 + : 4.1
switchto - : 3.5 + : 3.5
system.mk : 3.1
target - : 3.5 + : 3.5
tiling_placement_alt - : 6.9 + : 6.9
transient - : 3.5.3 + : 3.5.3
transient_mode - : 3.5 + : 3.5
transparent - : 3.5 + : 3.5
userpos - : 3.5.1 + : 3.5.1
WClientWin : 2.2.1
WEdln @@ -234,7 +236,7 @@ Index
xmodmap : 3.3.5
xprop - : 3.5.3 + : 3.5.3 diff --git a/ionconf/node13.html b/ionconf/node13.html index dd529eb..e4ff2c1 100644 --- a/ionconf/node13.html +++ b/ionconf/node13.html @@ -70,7 +70,7 @@ Mathematics Department, Macquarie University, Sydney. The command line arguments were:
latex2html -show_section_numbers -short_index -local_icons -noaddress -up_url http://iki.fi/tuomov/ion/ -up_title 'Ion homepage' -nofootnode -split 3 ionconf

-The translation was initiated by tuomov on 2007-07-08 +The translation was initiated by tuomov on 2007-07-20

diff --git a/ionconf/node4.html b/ionconf/node4.html index 4eaa00e..f041fdf 100644 --- a/ionconf/node4.html +++ b/ionconf/node4.html @@ -905,7 +905,7 @@ usual method of identifying windows, and how to obtain this information.
Description:
-
+
Set this to true for Acrobat Reader. It has an annoying habit of trying to manage its dialogs instead of setting them as transients and letting the window manager do its job, causing @@ -923,7 +923,7 @@ usual method of identifying windows, and how to obtain this information.
Description:
-
+
Set this to open the window in a floating frame, when in a group. @@ -938,7 +938,7 @@ usual method of identifying windows, and how to obtain this information.
Description:
-
+
Should the window be initially in full screen mode?
@@ -952,7 +952,7 @@ usual method of identifying windows, and how to obtain this information.
Description:
-
+
Should configure requests on the window be ignored? Only has effect on floating windows. @@ -967,7 +967,7 @@ usual method of identifying windows, and how to obtain this information.
Description:
-
+
Ignore extended WM hints _NET_ACTIVE_WINDOW request.
@@ -981,7 +981,7 @@ usual method of identifying windows, and how to obtain this information.
Description:
-
+
Should a newly created client window always be made active, even if the allocated frame isn't. @@ -996,7 +996,7 @@ usual method of identifying windows, and how to obtain this information.
Description:
-
+
If the region specified by target winprop does not exist (or that winprop is not set), create a new workspace using the previously stored layout (see ioncore.deflayout) named by @@ -1015,12 +1015,28 @@ usual method of identifying windows, and how to obtain this information.
Description:
-
+
Discard this winprop after first use.
+

+ +

+
Winprop:
+
orientation (string) + +
+
Description:
+
+ The orientation of the window: one of `vertical' or + `horizontal'. This is only useful when using the + window as a status display. + +
+
+

@@ -1029,7 +1045,7 @@ usual method of identifying windows, and how to obtain this information.
Description:
-
+
Put the window in the statusbar, in the named tray component, (The default tray component is called simply `systray', and others you give names to in your custom template, always @@ -1046,7 +1062,7 @@ usual method of identifying windows, and how to obtain this information.
Description:
-
+
Should a newly mapped client window be switched to within its frame. @@ -1061,7 +1077,7 @@ usual method of identifying windows, and how to obtain this information.
Description:
-
+
The name of an object (workspace, frame) that should manage windows of this type. See also new_group. @@ -1076,7 +1092,7 @@ usual method of identifying windows, and how to obtain this information.
Description:
-
+
`normal': No change in behaviour. `current': The window should be thought of as a transient for the current active client window (if any) even if it is not marked as a @@ -1095,7 +1111,7 @@ usual method of identifying windows, and how to obtain this information.
Description:
-
+
Should frames be made transparent when this window is selected?
@@ -1110,15 +1126,15 @@ usual method of identifying windows, and how to obtain this information.

Additionally, the winprops -max_size, -min_size, -aspect, -resizeinc, +max_size, +min_size, +aspect, +resizeinc, and -ignore_max_size, -ignore_min_size, -ignore_aspect, -ignore_resizeinc, +ignore_max_size, +ignore_min_size, +ignore_aspect, +ignore_resizeinc, may be used to override application-supplied size hints. The four first ones are tables with the fields w and h, indicating the width and height size hints in pixels, and the latter ignore @@ -1126,7 +1142,7 @@ winprop is a boolean.

Finally, the boolean -userpos option may be used to +userpos option may be used to override the USPosition flag of the size hints. Normally, when this flag is set, Ion tries to respect the supplied window position more than when it is not set. Obviously, this makes sense @@ -1142,12 +1158,12 @@ only for floating windows.

The identification information supported are -class, -role, -instance, -name, -is_transient, and -is_dockapp. +class, +role, +instance, +name, +is_transient, and +is_dockapp. It is not necessary to specify all of these fields. The first three are strings, and must exactly match the corresponding information obtained from the window's properties. @@ -1235,7 +1251,7 @@ can be used to list the identification information required to set winprops for a window and all the transient windows managed within it.

- + Another way to get the identification information is to use xprop. Simply run To get class and instance, simply run xprop WM_CLASS and click on the particular window of interest. The class is the latter of @@ -1244,7 +1260,7 @@ windows have this property - use the command xprop WM_ROLE. This method, however, will not work on transients.

- + So-called ``transient windows'' are usually short-lived dialogs (although some programs abuse this property) that have a parent window that they are ``transient for''. On tiled workspaces Ion displays these windows @@ -1253,7 +1269,7 @@ Unfortunately xprop is stupid and can't cope with this situation, returning the parent window's properties when the transient is clicked on. For this reason you'll have to do a little extra work to get the properties for that window.3.3 + HREF="#foot1488">3.3

Finally, it should be mentioned that too many authors these days ``forget'' to set this vital identification to anything meaningful: @@ -1503,7 +1519,7 @@ for the additional mailboxes (`*' varying). gotten rid of in the author's opinion.

-
... window.... window.3.3
There's a patch to xprop to fix this, but nothing seems to be happening with respect to including it in diff --git a/ionconf/node5.html b/ionconf/node5.html index b5247f6..7fe37d1 100644 --- a/ionconf/node5.html +++ b/ionconf/node5.html @@ -128,7 +128,7 @@ user attributes are explained in Sections 4.3.

- +
4.1 Drawing engines, style specifications and sub-styles

@@ -180,7 +180,7 @@ specified, also in the form 
 attr1-attr2-...-attrn
-These extra attributes are called substyles +These extra attributes are called substyles and allow, for example, the state of the object to be indicated by different colour sets while keeping the interface at an abstract level and the drawing engine completely ignorant @@ -424,7 +424,7 @@ border elements and styles referred to there are explained in Figure

-

+
diff --git a/ionconf/node6.html b/ionconf/node6.html index 88aa9be..7baa979 100644 --- a/ionconf/node6.html +++ b/ionconf/node6.html @@ -126,8 +126,7 @@ the hook reference, section 6.9.

Note that many of the hooks are called in ``protected mode'' and can not -use any functions that modify Ion's internal state. TODO: More detailed -documentation when this is final. +use any functions that modify Ion's internal state.

diff --git a/ionconf/node7.html b/ionconf/node7.html index aa4ddce..7b2bbb9 100644 --- a/ionconf/node7.html +++ b/ionconf/node7.html @@ -5846,7 +5846,7 @@ Any parameters not explicitly set in conftab will be left unchanged.

-
+
Hook name:
@@ -5918,7 +5918,7 @@ reg:attach(cwin)

-
+
Hook name:
@@ -5938,7 +5938,7 @@ reg:attach(cwin)

-
+
Hook name:
@@ -5959,7 +5959,7 @@ reg:attach(cwin)

-
+
Hook name:
@@ -5980,7 +5980,7 @@ reg:attach(cwin)

-
+
Hook name:
@@ -6026,7 +6026,7 @@ reg:attach(cwin)

-
+
Hook name:
@@ -6047,7 +6047,7 @@ reg:attach(cwin)

-
+
Hook name:
@@ -6067,7 +6067,7 @@ reg:attach(cwin)

-
+
Hook name:
@@ -6088,7 +6088,7 @@ reg:attach(cwin)

-
+
Hook name:
@@ -6108,7 +6108,7 @@ reg:attach(cwin)

-
+
Hook name:
@@ -6128,7 +6128,7 @@ reg:attach(cwin)

-
+
Hook name:
@@ -6180,7 +6180,7 @@ reg:attach(cwin)

-
+
Hook name:
@@ -6201,7 +6201,7 @@ reg:attach(cwin)

-
+
Hook name:
@@ -6223,7 +6223,7 @@ reg:attach(cwin)

-
+
Hook name:
diff --git a/ionnotes.dvi.gz b/ionnotes.dvi.gz index 693cdf0..57010e8 100644 Binary files a/ionnotes.dvi.gz and b/ionnotes.dvi.gz differ diff --git a/ionnotes.ps.gz b/ionnotes.ps.gz index fcdc24c..825879a 100644 Binary files a/ionnotes.ps.gz and b/ionnotes.ps.gz differ diff --git a/ionnotes/node9.html b/ionnotes/node9.html index ff3be25..03f3abd 100644 --- a/ionnotes/node9.html +++ b/ionnotes/node9.html @@ -70,7 +70,7 @@ Mathematics Department, Macquarie University, Sydney. The command line arguments were:
latex2html -show_section_numbers -short_index -local_icons -noaddress -up_url http://iki.fi/tuomov/ion/ -up_title 'Ion homepage' -nofootnode -split 4 ionnotes

-The translation was initiated by tuomov on 2007-07-08 +The translation was initiated by tuomov on 2007-07-20

diff --git a/tricks.tex b/tricks.tex index 9cf86d1..b999688 100644 --- a/tricks.tex +++ b/tricks.tex @@ -30,10 +30,9 @@ In this example the hook handler has no parameters, but many hook handlers do. The types of parameters for each hook are listed in the hook reference, section \ref{sec:hookref}. - Note that many of the hooks are called in ``protected mode'' and can not -use any functions that modify Ion's internal state. TODO: More detailed -documentation when this is final. +use any functions that modify Ion's internal state. + \section{Referring to regions}
Figure 4.1: Sketch of different border styles and elements