[Telepathy-commits] [telepathy-doc/master] 2009-12-15 Murray Cumming <murrayc at murrayc.com>
Murray Cumming
murrayc at murrayc.com
Tue Jan 20 00:52:47 PST 2009
* configure.ac:
* docs/examples/basics_dbus_glib/Makefile.am:
* docs/examples/basics_dbus_glib/main.c
* docs/book/C/telepathy.xml: Basics: Add a little example of calling a
D-Bus method with dbus-glib.
* docs/book/C/icons/:
* docs/book/C/figures/: Added these directories to git. I forgot to do
that until now.
---
ChangeLog | 12 ++++
configure.ac | 1 +
docs/book/C/caution.png | Bin 0 -> 2369 bytes
docs/book/C/home.png | Bin 0 -> 2479 bytes
docs/book/C/important.png | Bin 0 -> 2592 bytes
docs/book/C/next.png | Bin 0 -> 1814 bytes
docs/book/C/note.png | Bin 0 -> 2520 bytes
docs/book/C/prev.png | Bin 0 -> 1841 bytes
docs/book/C/telepathy.xml | 9 +++-
docs/book/C/tip.png | Bin 0 -> 2288 bytes
docs/book/C/up.png | Bin 0 -> 1811 bytes
docs/book/C/warning.png | Bin 0 -> 3249 bytes
docs/examples/Makefile.am | 2 +-
docs/examples/basics_dbus_glib/Makefile.am | 7 ++
docs/examples/basics_dbus_glib/main.c | 85 ++++++++++++++++++++++++++++
15 files changed, 114 insertions(+), 2 deletions(-)
create mode 100644 docs/book/C/caution.png
create mode 100644 docs/book/C/home.png
create mode 100644 docs/book/C/important.png
create mode 100644 docs/book/C/next.png
create mode 100644 docs/book/C/note.png
create mode 100644 docs/book/C/prev.png
create mode 100644 docs/book/C/tip.png
create mode 100644 docs/book/C/up.png
create mode 100644 docs/book/C/warning.png
create mode 100644 docs/examples/basics_dbus_glib/Makefile.am
create mode 100644 docs/examples/basics_dbus_glib/main.c
diff --git a/ChangeLog b/ChangeLog
index 42de49c..12e6be7 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,17 @@
2009-12-15 Murray Cumming <murrayc at murrayc.com>
+ * configure.ac:
+ * docs/examples/basics_dbus_glib/Makefile.am:
+ * docs/examples/basics_dbus_glib/main.c
+ * docs/book/C/telepathy.xml: Basics: Add a little example of calling a
+ D-Bus method with dbus-glib.
+
+ * docs/book/C/icons/:
+ * docs/book/C/figures/: Added these directories to git. I forgot to do
+ that until now.
+
+2009-12-15 Murray Cumming <murrayc at murrayc.com>
+
* docs/book/C/telepathy.xml: Add a small part of the introduction.
Add some sect structure.
diff --git a/configure.ac b/configure.ac
index 300e6ca..90eb3f9 100644
--- a/configure.ac
+++ b/configure.ac
@@ -25,6 +25,7 @@ AC_OUTPUT([
docs/Makefile
docs/examples/Makefile
+ docs/examples/basics_dbus_glib/Makefile
docs/examples/connect/Makefile
docs/examples/list_all_protocols/Makefile
docs/examples/list_contacts/Makefile
diff --git a/docs/book/C/caution.png b/docs/book/C/caution.png
new file mode 100644
index 0000000000000000000000000000000000000000..e3897db8771158c562faec8dfa675633ba677007
GIT binary patch
literal 2369
zcmV-H3BLA;P)<h;3K|Lk000e1NJLTq001xm001xu1^@s6R|5Hm00006VoOIv0RI60
z0RN!9r;`8x010qNS#tmY3labT3lag+-G2N4000McNliru(+Cm{92SZr)$#xU06ug@
zSad^gZEa<4bO1wgWnpw>WFU8GbZ8({Xk{QrNlj1+3MgYKATls8GayP~Yjt8ECu(VJ
zZDC_4AX9W at X>Mh5Co}I at 000PtNkl<Zc-rlmdvH|M9mhX+HwjC~hDV?Q!YlHWTA;w#
zB8UQlg)(RnQy5xj>Oe)EaXOtUV~0X#`fx}c-j6a`ML+~QO&?<0_?T*;0SZPDgb;=|
zl3+r at X0yA=?!D*qk9+R!*~=!`NVGV^ojG&&p1tSX at Avon{(k3o?}1y#t>f15l|GCw
zXx=_RzIJ^DsQRi97!DKxbF{t_z at LD>-s~QI5NHNu3+?AOGx)hcv=#79d-i4o|1cnQ
zpu-CD<))QS$vM;RNJV1l%>;fv5YquZFnzR)Tq>33`CZbiDU(ZoJS7#0r#s@|-Wwdh
z5ZDf6I33 at cF^1h+i}6M(zzjn80 at Loji%4S~Wgni`$4&=AK-vF`z$3s`eU5oE$MV|C
zEAfOXKne_LfwUmjz_ck72nVmS|D%ig95a9*u>Z>@@G!7LA73<kJg>g^9G*}Gh7=&J
zH~~Xi5DReM)Vl};YT19}Q+=-cfdFve%ObD{cm?n{9Si2%$+j)O!P{5?Sa^C2!tmul
zMkhR7dLkoNL7HG*WBQbd1nWQJz{gc?64!u(Uo?TofGs-sc{9hd{e|D!;H8C;nT_l|
zh at UQdnSJFKsJu|mj*>DakI5&~E0M8!W=x$(pst#ON3ZA$>is|+ at Za_T%4o;EPXHVA
z)qCE|aqRrVb9h20kywBQhM>H>f^{4Jm^Ap?BXarvcZS>Y3ZLcqWeX6(V#BUuI*GL^
z9dAq*lqb#mo^peKv}lqIzOe#?iQxpTWfF}xUpK*R{c-^lDJ`V5Abgfp%jWY$(e3Wi
zX1y|2hY@&EStbsC at q)YAvUUYV=p-O)P{KqC0Wylum#j>~fRVR#Q~z7>ASZl=HNPlg
z$wR~3BsKs`I)cE@)MW8v$-;Zsv}!p<@C1f1L72AJrLZMrM(C2Al{86VL07VUo_I!*
z(zNfFCWKD2ZuvtzHg~X_#3mJUpPRtl!0+^q$A54y>z`kSp#oMa>mw{ckujt6>Y0-?
z(a6C);_HHxrt*MkdqG+dI?ej!b6NbrAUBE4z_`ytpbxOv4St;iUf5d3u_UHVLILXG
z&mb!^ksn4Dc26v7QjwO*YfgXTDK at NlkVSL)yGhJec-lqa>%b44i%H{$*p_cNZa*A>
zfdHXfQb|af5Nn`cL0){ap#yUh!P`QU!h&EW8<)@Fo5TD%mS4JFj at qAv)~+sw;E9CA
zlm`ry9E1X{ydWb1Mhq`VWT3t|F2JTnT>VC!8!PzkggiPljqcvDS!v$1b&L&Kii8{z
z78Z!cD|~DGkofq1`JEG%mKIXUM+!Ao2n^wPP!J5oZkWI)z+vZNTggF6_kNP7afGF5
z+P0j5Wy?yM5D75*o&oX6dUegR!C{XxWWs~CBrT-+ at 4fOGcD!{($FjY(SKpROiAEp~
zxDTK)+)UXAXPGp9AiaBLD=@ajq*U=BEr@%>BHtIG^87VoF^iupygez%WjuIAoDkBY
z?BlCEv-uonE;qRe{JA9(MjKxijsU%!j=o>>v!i$(lgIV9ONV$0wWVP=>C~Hv(KQb;
zvj|mPptBiB4%q9~1B=5a>Uet78On|YbquvCq10%7GTmaX5!j<%)N=uXp(t;@U&*N9
zy%=2J*HWmH<CRRZ{alLrS at XhPUMx9|Pc|{Ee|7>qiInPqFWz~PcMb>i=LdmVz-gDE
zjrM$2F at Qqg5YWTv?CS5t)?d$J_T)kp+_v at OYlFu_$x*@lAH4*CKRbi!zt1AWD^={6
zaT$GBS;wZ5Dz=q=raw2P!0%I9b(-!0*;W>E$ejbmsBb#}1cJ>hT>1vDmmas{K{#?y
zR<)X$QWzyS$1W-6O)Vh9E8`Y-z#lnvja~25xWSw1o#T+Imc0t6*M-YyO+tq290E#!
zX+Up)m?_xv{uu`K&0*BgZt<XYB<1tQm_EK2ciz#B$L9{DODB at zpsF^^)_+v7YWHPa
z`hFJpn_KHH%g6DhL%?C*4EzO{2owNVLb7M?Ir6$@QP8s!{%ns5YTLqn^D-GdB$qB(
zB(1_#wGm!@tD0ZEa?$<VHNfi{SVIFWQ;<sO0Uf-d?(qUy%DsDlvA{sEtBHS>U1HdP
zT>9j7!r$2w&-o<PJa(X0*M at oHKQ%n_`*X--I6GC!bbo#kF6$=|@up#YkEX>;^<OFQ
z4Io}VzPaxb1wDNX=<UPrGm;B6O*a4jsGcWRpT at G1o>>aKlmd%zkr3&m(Uv^m5Xn&e
zZz}>roq=y3tR}yE7KOci<aG9^jAL8Bsy0md$p#)>d5Y#}5{CWiokOU3oor)i%?YsU
zNTfr+<MM=leoqDU2xsuShidFMutA;en2;vbwGmET3{$k?1mPy3KkKOW9_)bkXlXO1
zWUG@&BGFn98?JT2lY)>(<?37|DF6-}t0&xKF?w(|XD>HWc`?MI;#1TIP5l{XfYm at m
z1EgC!ral(ORMWj7+ggc at HV7H6b_nq6B+5@V at a_k7)CFP`zjlc$bx9Rw6|hpJXQ6?N
zscaWf=VnDBsyv~`LYphG4%VyAnMyvHDl0k7r`jXxi$ZJjUImI3i6#wnNF&jtKu1(_
z?$KogAiZgn64x!?E&P_M_-g<rv_K-Dz+X^+L#pNps at lsT;((88QW7arYFb-Nx^z66
zCp?-boOQzS&?xowxxePUPl11_3bPpqYf@>_q+}(QbWAOfg=-I at -FswuRx(@}DMKUS
zTo))pUUhv{E7W3|zIA}6E1*qR;9j>Hw|A4TrA5x8Svo`Wj{d*YGK|o`xvlFyTP~U2
z at GfO4Ng1x+UKc5^3zV5+aiW!yL3HFcYdR^`vA8!yVdj*~GDV?gw2>@2Y at gUjvka%b
nfZB0Shir6r#74Qik-`51XnnY|(@{Ta00000NkvXXu0mjf07q)(
literal 0
HcmV?d00001
diff --git a/docs/book/C/home.png b/docs/book/C/home.png
new file mode 100644
index 0000000000000000000000000000000000000000..0f57369ff07d5bd62c1e54439cf15be2bcd92c43
GIT binary patch
literal 2479
zcmV;g2~hTlP)<h;3K|Lk000e1NJLTq001Na001Tk1^@s6tjIZ&00004b3#c}2nYxW
zd<bNS0000PbVXQnQ*UN;cVTj60C#tHE@^ISb7Ns}WiD at WXPfRk8UO$ZK}keGR9J<*
zmwSv|MIFaKznSy6uf5y5&+cMb%3_xSwYCK+v=s>&EGCeuHEM$|d?aEMRE!#szd&Mr
z#Y72&MEJvtK*bn>i5f&~&>#h=v^If;0=snEZg;o4w|nn7=iYN>{Np~n+wQjVkhz(h
zxs!8#^O at i8JHMF`Yb|d_DT+ATtc~BQ9rbp=JnT4kxJtcP6j}OKZOL2lP*FsCTK}rQ
zyL<D}OeX)Yv9Z^yNpj^jYhQlHfr=toPwPLPvuxR#k)feXG&#v^rNW-k(Zf-aT(iyE
zJ#WVDn+jP`q~Fu}xm7DyUNSN~oIwO at Em_ZF?a<Ib%5nbmYo)GyM}UeV=libv+$HPQ
ztr$G(EDx<gYpe(s at LiX+Lqom3>+XC=>#hG+prXj8Oe*!)4I4I`)!o-8XbmEu>Sk=C
zI$E=KXsA2ox_3Y9IA41sWBkt=dPwU}r}O!rUw--J1>f_)7%&E#B-p7bOsPa<Ej4Rf
zVAfjpA3Air97T6+jpJM2HlUr3^S#cVo^M>bapMxLR2?QsAdWGI4`VBp*1MrGL~S;W
zwH!EdWOlYvd8C>oU)*+v0Z$856j7emzZ^X0oGq)?ug@#MCP^JAiZG+2*eK$)6D7vW
zCD!#0;A!20YWLJDlaq7PrP5!jN%GOtCD27RR1`^jTL1aoYu0RCy=hZkxh^P$XboXV
za_}G~4EguWG}9}V)BF7&uzPBPpjIQL6sd;DZ3Aqmrzf|xP`Jv|`pKe5<_&qMDAMC<
z{p6Y}u2?ZJJnXhYWG!}blH}D_iQ||($EV1Cd<#7{eG6j at m3{ko{i|Q$y}3?0e4nbd
z%q0ni{|bJxREiEwP9CTx$ranIojxN_QDiusPCs$+)mJa;9vG08c#Xk~jbX;d2x>K+
zFU_#@mRso9{1K8Q!5D*5it6Ynuifx at E_6J)(rIeeQc4n%hJ6dn%+1BG9X&c)Gv at u<
ztUa_SP*G$!lh6Ns!?oA;WxKjsD~Vc-<fWG|6BEn^0ehp6bMC$ef8|Q7wJjK>6vh~8
z$Byyp=RV7MwV3`)hQwNCl7zS|gyk?aFOQFp$HuH~_tZQMr5xucmtJ#CU$(EWo?DcH
zI40h^7c()zk#d=RTC?Jj-;%lLqWX-j#rJ*s`ugbY?IoQ~<Ms71{P0c=77C12DrgZ3
zTH~~ZE}crLfu5dzSL<)KGqiw;B4?-j`!^QOJ{!>*(Ha{B#Lqs9ot@?7xj9A$23Yy%
zqd5Kj7-J9-^7%Z4LZJoM(a}LZpU2JTIj>mc$nxbJD3?(pbZL#>6g#jamvgPPUnq)r
zrvUkmbH_!SHWknsl)_9+5kLJjNu|OIrCG|CU&i?lK8VWH7l_uH&dyF!sZ>1-jnElm
za9x*tK985pa_+tNQdz&AeJ4%;(B(K}l)?fiMWM4Zr$jz852z^8pX%=3+%r5ZXpI>i
zCEmT8S`@K+W`^tyH*oHce%#t3T-T+eqobvnW^IQO5wh7Vek#S#jvc5iTX?=y!dOc|
zYw`_SU3H-E&I9tazU{(|8w)rN$=<!hd-hNXL!K#>Shiya{a^YrP4WA_Pdc3jm<O{E
zlraX+^YDG2cint5`5SL!_v|cjlF+F&1*LGcCY{YLDT;g$z$uC>$rTD)`-X>A{M1vJ
z at o}ar74{p$$_E}GJu=dQ at jMR^!5GsL;bNJ-y<bFdU6=mrugC4}<(b=VV_ioF9gc$*
zAu1HQqH_6m;Bm)Q>f7h9Ufmh*+J&8+<@LEaJC at 7IdmefSueX;ZNm@&~sg=_We!70G
zHQk#x<8*bgd;50QW-??vkD+v$*FA4}QRD*sF_GU~n8{>S81mxubaZHNP%eJ#F{N at j
zthI;;(l~%M2RXSm`$Yt$RO_4OMB1x};0+E^xaumNx&MCC<2aIaT^z_vRVv~rxb at jr
zUb)@#JV#co+I!%->&|;$D%G3RY8*Logle@)5Cl}K)z+Y{>ypW2$Y!$?3WXMMk|g~8
z506ue>v_3Wtzt}q>-h~BxOClW`uqCGjg0W(_17QM_uLbm-`&0JrOC;O*q9$WpGcBl
z>~tKDD5`DUwd?2qxbx15rZ9sb;MspZLl}nhbfc8QaU5LN<?0W8m`o-M!1VMq`$tQ}
z9m~;5(8u?qf}>Qs*HTqE;>vOIxr6jIq!2Gz5(HtmZr|a<PsGN2eVetfIsjYa_@~Xm
zYPFha-wrC3GGQ3D#Ch_w7RN1EYc1mVq%%1 at M-!jWB!HjJB9cSmfOOi&7(*P#h)8Lh
zwbMnBHO+I9bFvVPF-dza@%<EW94`n2AoXwNiP#v6u at -Ba{b0qSNXTYVBuPT8RzpN)
z0NM|2rvO=Nqb8723eWWj)Z$0)g+yMB4Hi&IeIm2vDpTPc>1dXeKZv!KAPBGv96wG0
z(ps0=1+2BMy8#g7<ky>CZ9OYN$XMw(QEV8NkWLLRjvl9M(yYh at xUP#ahHAA6aO`AT
z3r&3{ilUZ>9LGT#zZSHNlaa at PS_`BJ6-G5CW&&pCBCuwjVc)SWpfC(clH}+afvmOD
zVHmb~$N{01TSNq(1AOx8zoBIg5RxQWFlj1j<fz7fPbD~xgSD0 at ifj}`rvNRap<_`L
zkxr-QCA0Pt at B!}n-8xd~T+2fMaU65m%5FBLQV4=4D-nSUtcMk$7WA}$f*`0GW6rFh
zIF2Wp9)fz#IYm1HnQXq*w$>8IF(*!(V8yv-qZU~N#w=lCVuHcJL4qKNtJUh<X at Nw<
z*}i at I@h}W6AWEruqCUAaL7N&naNt1eB(PWsf`Ea60V<VBeC*h<SVTI2inTVG2P7g2
z at WU`H2SE^9Yu&ns^eG{0FU=$huzL0CGj6m^Tjg at u%*@P$KngHGc^(jr<L=bd)V_lU
z4^~D-Mmkfe6az~K7(YCAs&^Wjr|<h1rw)`#rREL3SgBU496fr}zVN~eV~ufJ7sq+G
z4yog(Zo28F at 8oj1Pg!dnYpqyorSYz6YYUBFHrh=aO at p@4wjyFh#I&_5<KyE$yYIgH
z9tP%Y+f8=Ci(&)JYq&ED_>KQQ;5MoQ=tgZ<u>q1sjj1QA8V~_h>Y=Gn*UkJywHVMM
tfKD4ov#r~}PKK$qJ!?R1A%K(1e*h`B8vdua>pB1c002ovPDHLkV1i4Q!Q%h`
literal 0
HcmV?d00001
diff --git a/docs/book/C/important.png b/docs/book/C/important.png
new file mode 100644
index 0000000000000000000000000000000000000000..2e1a2a3646189a9d424282765234187f63dbbc26
GIT binary patch
literal 2592
zcmV+*3g7jKP)<h;3K|Lk000e1NJLTq001xm001xu1^@s6R|5Hm00006VoOIv0RI60
z0RN!9r;`8x3DrqNK~#9!?V4+Bo7EY|fA9PH9w#Qgq)8l_CZiqBlJpXibPcVRs;eMX
znOX=HBn*T=8;dF~s*n&L`hlv_K8y+pO?1$yX!`)FR#6zL3KcC3stO9FqFq8*+pTHS
z=GLUS*iPd3-G}$Q&WYnVj>*_Q>_|s`b8H{~|Ih6_&vOF*AOGE<Eb?CFerk%nbs#QY
z_5URT3ZOg=OI^^cz)v;UCZWDI1!p4g&H?xfFab<078zxcfInw}o%4O+7WCePKOceL
z0>eN|kkNl=0t%qD!E;svOh!WoB0w1WdZ6t?I0lRZli6xR%L2UmIFzo3qZW8feq$1d
z3b87}5t3P30Sn~Vpt&6SJD^<xum7htptiy?AAF)fP<|t7NEVmhPq3kZKt%;Ehl5+E
zPjm6;Q5020kH-_A9|y(^lE)9iBfyAQUXV#C-xs_tfJ}M4RBqqSU5`A1*XzaYcB3f9
z_9NZhoPX;rI*%M-w6~YZNMr_S6+Su$zZ8C9Dp6ld0x7{yh+iz-vW3mhKTly{Ar6OQ
z&P~F-y?nA~57$2boROX$^msf$LV*)+!lS^@LP%)e2YkfqWy9{>Y<%Jgii(P`*=#6^
zGUv3p-7IfvVz{e|=-?m|V`FIXIEsO`><+NB!<Pbld@%?pfMo-`p+TJte!}OY>6KTg
z- at F-*$AhY>X~E00Y~x1q%gVTR`ZVJsBUsF^2KA-T`z?Gch1jeKn4xl?)v!+xyH5K3
zY<~G=LTlELo12?4aCzpJl`%CwPVa>a#G+9wLNIn%qr=BNFqnxZv^3z=$6>t-elI)h
z2(YrPjoN$e!Rz&A1>T$`_4Pyt2Ix6|o_H*V#Rx;r5~w>1M?_>cNi2wf3RpM5#|q?`
zizC2Ko_vz^k3PzhB}?W6wtxSAUVr^{4j(?u)vH&judh$}IaO8hheGt6J<ITo8z}KO
zn&H9za?m;qf0#@cTD7 at M=hv{yD&;g0ATJc6 at r4&CE-uDmv7`jGZ{I!!2L}m<!(6<0
zkz>b>F*GzpV`JkC;O4X4?IuuB!R3!WB04;bCXm{pb{szFgMoDZpr#`50F*gkuemTK
zLS5tT-2?&w91h2v((mZ#pufMLlP6Eo(a}L95 at G-T{R!ZyoV~ERnpLf>xV&BfT*78*
zVIPnWIE at 2*egX=h1>hNZaRjJ%-~o!4FURlqr+3c$d at fzO#L&>t%paO3N;N$DEP)j(
zP%Q>dy8&*+-LL`36-!$3*_BK{-411T_>FwzI|Bh4ckQB}pdc-XzP>&bMIjoE&XUyi
z>(|qM7huz#J$On=Kv8fAQ!0gBz->YcX$dHRwgjF|&T*=D?7-!6r8ONzQ79 at ZA`*!Z
z4u at wE2nK`mMx~;aD=Dn3B**7N5vF8;AFYM;k``tZOKOtzm&wwP0d~KiRV^*}e7<=B
z0N8A{)Nwh((7NvFr?KVa7<&nkmm4PSk$hnm0R>R~@Syyo<3L4oGkJM=^Ge^e at lYs)
z+wGnKzP7eDV*<gN8iF-7Xm&eHBQ9SH4S-wlN at zhQV0FM#vh=k;fHf^GX&pB?viN*H
z%FD|W8d)d-MNwF{b0==UA4L720VPH at -~k+R_&1rTt*}moVma=YH8zr)o0~F8n=2$%
zRaN0~xhO0wOc2<%ZQFtf6t7;*(zR<7T5th5aF-yEBY3HRVroEh!~JsHp9EI!*fGoY
z=K?Mh7#kbIE`B^13{qEDx8O9Rs=1lmf`Wt=RA4>)LJ%;`D4_w1&3H3W8kSU5QBYPk
zBU#HN;{@2UWeZNH6PwLOTU%RJdD5LtO;{X`ghN|^g6T8CG$Ta?)FvoZp-6V#(v2Gv
zjys>!lV?jy3)R)tY~8w*ojZ4Co$M`Jw~id)3pNA!YC*s$6r)%GH2~{m^N9l$_uh-o
z=R;N1tlAa_4jjn7Un4Ym$EHpE^VBI6RmCdm>APX;r|<{CDXIdRT`E>$Ku#clr?@y#
z*Zxp5S<}_`-%l(W#hIU<(1O(nG^QVDDxhjosTczSRaIFRDxIC3y!hga+;`u7w6?a=
z-rl}o;PPC)X;UIUvKaQWLIfropjiM-Ps)h`6%}|qo*A(`)A8DCuhHGzO?!Jg!^6Y$
z_V#l8`0=!+l5V&IfrJ^WhIy;Pi4z1=T{@a$Kz=ZY)9K8Lz^PNG=<o06`t|DoeD>LA
zDfh{A?_f<0U%&l!qIhvbiO7j;fNB90Jt at PxcJ5r(&RbGaLU(s};_rrrh8bWNDij4!
zH7)V%G%7?hC(>rM!7ad*bLWV~Vp;jX-o1MXg+dANufF<fR-xFOSHJucU7xNdhoM_2
zLo>su9)_=7u-QzWZnU>^^3WlE{_w*KmRMzFB_~dt$Xepb<MOAU5*;3%?nS|<u=Hua
z=!dW51uyW&#~$OImtI=5khsu!<%=))(?bt2aOo1^fq_JAG7A5a?-vwtvMu=)yz7LJ
zNyO}9<OhSSY;I=5GtZEJ`|TMYLfMY54;|u*g9jP7e3 at I<t}#9`k_axtz%kg<V{|Jz
zfo`+#@veZ{P4I at zP(aF2T3^q~2Op%Yp at Gu6x<vs#*wsbXnKN8?|9v_?{1B_d!DKYb
zSYO|aCh!<=9^N|(M}dC;mw;YnI?bSX8Qj$bzq1*gfYcJ!G;(}C?76uFSFIwixR|2K
zO7e<|&~=^LYihVH7 at YOJZ{B at 3@qFRE_fS-o?~We_MM00pnFxo`r=|$syonx<qYFD3
z6}9m<@Yk>4Z@?7+z6%%>ElC{0^n<|C?eNr6_*q6bBsLpXrxUBwNqlN5v(Tuj#3v`2
z2#1M{kAoCtVj`KG5dJs<z31SA at 8AM(LlEc!`hYR>X3=7r5=K^9Tm(O^goZny!7g>@
z7IT<Vj!89$d9yPJ7th1#PPk}XuhEYYLc0a{5nw{T7PX2fnh*GafOz$UAhZHj=fl$5
zq^d2`5tpXi^q-jSN)v;z5x8*${(c6|OQt^z+!UaD#q+38R9s1Fu~>vTxkWF=oF1{3
z132%5au0ZyK#2n0Nzgn{;4t1#Nx(eU`wja=1-%P8ED-zLFprqvG%gx}qXPUbLm><a
zsfWeq5 at B>!XHGb_W4atASIiu-=9Kag$MoG@;)F~-;p0-9d`hyMn6R9Q>2r#Rko>3s
zJSsp(1i6 at eA*iIean}Sen*i$&z#U at RB@#A4z?|wFd&ed4lS$ymh1o;}So3*8>QK+>
zQY#t!>wqfA$N;SpXln}a=?KInzm<thO7{Vi(r4n*xvFP#$*0JPVG=1-nzHFAX#$U)
zWKQuUpz)-8V|}r2>Xjr7DJj<Hi=N4^dW!Xo#=ilH_Wwlj$m-t!0000<MNUMnLSTZV
CZrl3+
literal 0
HcmV?d00001
diff --git a/docs/book/C/next.png b/docs/book/C/next.png
new file mode 100644
index 0000000000000000000000000000000000000000..00da327c4d67afca788e555475d07cf5668fded0
GIT binary patch
literal 1814
zcmV+x2kH2UP)<h;3K|Lk000e1NJLTq001Na001Be1^@s6dXd_W00004b3#c}2nYxW
zd<bNS0000PbVXQnQ*UN;cVTj60C#tHE@^ISb7Ns}WiD at WXPfRk8UO$Ws7XXYR9J=0
zm~C)WXBEeP=efHJA%yp|jTELR1kgcR!8aDh7K_?iDx)&KR2}^yPMPu30(M6I;EW#>
z7<JTk>Wo^zm%fZ>g$@d|Izj?fXbPn*1`?nN5MGmzO|pCMeV*fodw2Kln$&_b;?10S
z?tONj=lu4Z|2fZYL{+)bE1OHdOAL>z<1;Org0nZgQQ|WH<@y=7PM)zilOEHS&86S-
z{{Y0iI~LmYpZ{Uwr18`KlFg-8-E<&T)yWNw<UY4~!px>Q+p_D at -?+IzDAx*?xsX4_
z*B<=#_&eu(@S985r?+Ku>C{aDa_X=yq`z>Hjw@|^`kpoQ%NMU&Er$KsTzcaF90*mc
z3khAokl)YiJ*{LHe00p}53gAy#vIA!(zC8-JE<-EY%aYVnE4jhFIcj0#hPVzeyslV
z)mKmyRfno_$CL#O<oorB=YG&z^oLirYzkU$2x!^*vH80f-=8tYQz808l4HD31VEb_
zXJ)1}G|H)~M*+pDD?>F+m`$BGfnV<2JkXcF{BX<0;8)iTbk8FV`E_61Sbx6110x<H
zCc+YfkqTS|4F-#S^c60mC}^ZB#o^R3dE9MGZ)oPpy^rO)E}Z<y{_h8mycy7lmEea3
z&Rji)F&=`!h>5@?x~B#RqG|(0HA<T!iqyq{)8vc2e0If}@qaq_%-5H$PtT7#dvPS+
zBZ}Io#cGIkVKizaTI&Kr>k~SkP<^cWSR!*IpX2ws0P8}o4PWBrv(K~qy$_E2(4zbA
z6T?5Ux%9NR45V=>TUXiG#g!ClfFnQ&aT4N6qa>aauT?7W8i%@eF?ZI2%qQ;t(mOrR
zJDSa<=Usn<VzAH!I1S1UEj~^HoCGKVDj_OiG)IVHaRh`~U^pDWw*>-Qpsjm1bqyKs
zq5IZ0)s3k?n9Zf{P5K^DLs7E}aIt<6!7~P89U+1U2p|F)>&b~@DCj3&>?L35r4S6G
zPH_&@DuPGKWVn>?rumll at r94Cow)slEx*sMOK)h|7(6;Ekg6ke0Y(f?1!D|?2Wnz5
z3lc*)4H*pj84CLuEcT&T)PV|^l%N(6aDcNG-wxy3VGeig;@pIGRxN*M{O$vP*tm2<
zdh-771>YSJD6mC}!4SrH7~_!^57Z-cHcFWd3Du`y2k_lssV8Alpem>VbqXRxO(kjv
zsNig+&D3WmF;pC&f1uZ at qkYr}<^5iI209}r9vDwBDTzi;Fh&qhFalmG>P=<8C5r+{
zvdgI|qM#1$x_t$8I#svt+16k53lFqx3R<8>)FP6qeg-KyHwp730!=`AF|=0&9<Pth
z7$Kd?u<Y%t2?xD!$6ud3+k0+!N$ckD#gfld0>%TpDxi2nQ`*$4z?2{(jaNqqi6c~+
zB$^*LrhyOK{z+bIf3?{5>cQ8#|L#`3vCmxrJP}b<wW%1!#4y!BrD~E0E-th(r15Hi
zh|(bfPAWXAFm>E*+;!^%?0fO~;S-(5|9oVtT|3-MA@&(5OvIHU6lc7WLNQ6JM5&Up
z1dxepPZiXFvl<;P8m*sR-%Rs_Wjwd{cZ1z;oPX at l<Mu~Hg=Z2bM0HUGBoL{8#oVt%
z0A&#q!z2Nt=v*pxa&n+G0&-;qgTgzezMm<~=INbV2hX?nZ#edp+g0PQ%4(}j{h-jZ
z_1T{`)y$WU(%Lgs=FFR|3l}%n8BahJS1K(dynE_LDE6lG>D^oUx(*k=+PT*qrMmDa
zrK at zGs+rW*&EX>GO9AOPzsWHb-=_d?#u79CZB0Wz7B4D)=Ri<0GM0snD>-$dJAC19
zd(L<43BP>dsGb9C?8nuNB`a&ljbL$)#a0KYve<a|fEp9^Du6nf#Da+{Ie6ee at uim!
zA9>}s;o5u;c_57UvWfkx{HbabAyrioDFIaJsWyV~Mjl{HilCf3fk~O^%pH3#J9q6E
zI@#X2<IvB- at 3?><c9;Z8-Y2cnhg8*xNH_{a@{^P+!=&*=Q0L&5%zUQHB7XDCuZPZd
zT-w<73%hNEh$k&fjDf~qU8_VLLj^SuUcyQ+9w1%@UqPp3W+8(OY}x+vYd!6Q4<CEV
z?xUiQWNK=m0#&t1hJQQDV$vW^;ixcxNsYk==s11C?cDY3<qNL|pZez?-HDpWjsz6|
zPDl7p$Ed$9Rn-BdG at AIm<pu^ws!ob$x=xMnJkx&s+)Hj{=U#WEw0s1pfLOSr`FvBL
z1X$@4TB)270vPLaJP3ksbscbzcD1@<4M^Gk6GZa*7ge;q{Gt5=*8l(j07*qoM6N<$
Eg1(t%5C8xG
literal 0
HcmV?d00001
diff --git a/docs/book/C/note.png b/docs/book/C/note.png
new file mode 100644
index 0000000000000000000000000000000000000000..df1e0a9265dc6ce7602d3da91195b2a84d278e01
GIT binary patch
literal 2520
zcmV;}2`Bc6P)<h;3K|Lk000e1NJLTq001xm001xu1^@s6R|5Hm00006VoOIv0RI60
z0RN!9r;`8x010qNS#tmY3labT3lag+-G2N4000McNliru(+Cm{3_9{Tt3Ut%06ug@
zSad^gZEa<4bO1wgWnpw>WFU8GbZ8({Xk{QrNlj1+3MgYKATls8GayP~Yjt8ECu(VJ
zZDC_4AX9W at X>Mh5Co}I at 000RaNkl<Zc-rlmS&ST46^6fa?!8sj-7}uC%`6_<!HE+m
z*a_HXadzX7m?&642#a{&0gyoOz#<|*h-Y|Uc|bx4ApsH~2p|v-2?+ at VB_u2fOA>4#
ziMJu+u|4+K<IK|2U3Cu+RXsDAfFO1UA>kt(b>Hsls`KCTpY1lBm-BL7{(q&>XuPx0
zX#BF#Xv|gm%SNN|&i|$jat_9S{+3nA$3C^^MrsqsC{9l at IXBIhMyI%Ivh{_TnVH-F
z8vxwd?))vQk}rJbhSwnDM`#_~4`-&R=WT9Wo$&WIS0Bptsdl^l#ET6;&+>Qg|MV at p
zu=#n4!w2xr2=#!k2b@<ve(3-r^1jN$^1ldRM_-na|7|a!9tgES$O1_g2wB3K_3Hq3
zEV=)S2E at O>>rF&3Gm2xQgnB@|qE2x^QSWeG(Y0$avkb_e7jz<s2+lp1y-AXgrYYW+
zCgpiftJPw9dRn>$Ktwow>@nVS+j}`Vah$=dq>P3VgnEbTU&#~+Jv}vk^|P<Ba^(to
zdun7^imD<~*&|B<#L`)!h?Gt<gLRke?f|f^0Px<^I<uEI-*f?=``Rz~{N_G<Jwd(V
zyx>PRPz+qeSMPtEGgD`nKK=lHK0|wJ#4O;PQ~;JSR~%@9Xog5A0brzQ+M#*Tl^7`9
ztK4$q74%%Yh1>T{F_8y!a1HJiJ2}-@%O}5oAJb3oC0eA_E{G9|7%?k1F`8gFOtVFm
z0Fr_vpb5AP(R3+*?ocR%K*XUw<%93Ofp<N6fcO4pl&9}M2>g~Shx^%6&)K*- at NhQ7
z^h}Ety&2JzA}S7F#<DoDxaa^)5DleD0-~724gd$VyW)Xbt%j<@`-C*h_{jTj;<2e&
zzPq`X- at kelUtX_l%!ECEIL^+iH!?F<&}<rcTZkx#uQVXqSWpNcq4Gcg at d%+4(B1Pu
znx?3DoKJAxxct)feCAWP@`)cj%)UR2VFq~-*>&~B^wcxvTajklcy^{uNE4ib^NJIP
zEupn&Qf{>PD!3KII+;qkN+I<g(SW*0NHboxX&oQ?z;33Wo#w7z?BmJ($La0O2;QUW
zF%(nBT+>honJA))^UEH+V0=Y0Y%ybX3xIPD5szp>@IsQdsnu$%=$%K!*uC>IUcPxP
zd2Xy+)k~5D1c%pv4*@fwT|gA5`G3LaPL{GrjIp~OaL$1^oGU35e4tU!D2f_Rg?cSx
zXmAyI9uZM$^|Ck_N}dZ&l_U+zY5?H+Kx>%vf;B-Dgbsl2c_79JR(1u!CnRa0C{oPo
zq`}e7bE1KwsB<L2<5Wqr3=u`0Cq^ZxFH^hgTlR!jX*`0V-3Kr`JBzBKA~+``KEcuy
ztRM}Zq9_1Cv@{|FPm%=EGy$q=?Hn$om?j|gB~40EF+W2nmQtw89uPsDqliLC92Nsk
zQeq4gF`}wCb;M|(TE>k!g7=)7n&rsRQ*7V1t?Ug9o;onb<mqW%xpfPPOA%2F1MEKn
z at Pg`qsv=ru3l}_26Mp^Z(?nDL{MT{zk2dM)TSI-tFu&h>g0Fn at K_1`t49+Kv9X-QC
zkBoB9{eR)W;bVv<eB(R!^32#I{VP`Rjc?zDXlZ&`=-fi}?izp<y>&!A>QlTAsCrJG
zn&l at y{UbB;j;S-VJoxLqj2}D2#EB_x|IphxFgnZlgfQJqNzyu3?%2vj7p}*EiIb;!
z?e*Ka?9vMv8D5QvB9wK&)OFtj&+Dzt7#!&1FHargrq^!gbvw86)c!Gk_vqia?y4&g
z5#I8~tGMUBhq&Tp>)3qRg$r%8;py+|<FjA<9(Vlc0j|Gh$5{=Co^zC;!G8MtdluF!
z`+M1c=m=Nu*t`I;D5{;bHm&(N0Pec`0k*w-Bipxb;;&EsopwGC^t^Zz*&TP>vF>?4
z_H~AbMrgMe=a!*?eqOot5`KK=!`%PCpZNN>?&b|QUsrXrj=APM0MAa((rDCh&awHj
z4YU^SAuos+|FH)S9Xhn;f(wQb2{@Nf6b0&9tX^5?qaWCVy0VYodF?hpxbCX096vF|
z_1A18%MwJCp~2OxIx>lf^42%+=ANJbhCe=jfLIh<e)%Rw)~o>)5QFHt3*eDQ9vOVe
z%D$?K2Ap$5DW|F4-X1K at VOC}l5l50XST{0IPFYo5$g&#OUbz)eLV!ItU(@O4DisVV
zdku=Ju3%lE(DCEPFCAGkPy!HNVRwK-v~2K at fLU2>i at Zruw6NI1iZ;Ze8m!{t6xLA$
z!6TJ9QqHg4ZRTcXW;P8B^p!K~La`}JzQuAKEm9bCvY)Dy9zcOkiu6^pX3y<JRm;tg
zsuQ)c`|TQl`T4mEFIYcPx)=dt at x3S(jTnU at Mq;rDPQ+Eie3jp;{YL%s4+%ThnPFxm
zNz$DxblYvWy}Q|L?cTNP#?mk|tTX2tl}AcCm}#Z5u*qgis4R+!Vip&)q at hEqMp2Ne
zY3x!EA3S()<=bxEMZK2No;`_)RdFT@#iu;)iKtp-R7oL`^1Du-FQ%Z1YHeAg1*jm^
z?qdtR&^e8i0@&o_<d)aJ{^p7nV9_8NMqJog5kXZ;hHLputv*`}Mk`aKL0mScs|c7Q
zN(sQMV0L!4D+7%*o6YyUYTFiCb0;v196dTgk+*na?~_cNIK>nD_G2;9+tZ-0uffI*
zYq)&##fZS#k%7_+3#UC1AtLd)hjvjtYHiGnXU31RZ|{Dlrlz_BAWc)u3V!&L`>>+m
z?t35NnIjYTI<cu^Cr%%ZMQ&M^9&5Mr%m=rsIX7RdUfp-Yy5W~>uh%nrRy0^YGR&rn
z*K@^|OBfy=z-)1-KQcba(TS5hy?>O$qvMQ at 9_8r7Bx#y{crovu-Twmu=+Mwmp67Yz
zO!L7sP48?rn}=s-XHU<~&E-W=<UmqAtX&00TCMBAH6esKGrPn&_YPHM!-khGJY;O_
z$RQCq0_+<c92^TF{HfJyjm^x=%#4qZ9|Y#k<qwWd)v5tmWvDKxkh*N$35>j|T%A{|
zzLV-c`7%4I0)bT5w<?|cXNSaR(~ZU at JIoT}Y?;Qzh+SAOKikZgQNt?Z-LiYN{vCzR
i%Xv93=jFVdll%j8Fn<i1$3OZ20000<MNUMnLSTYQH^wCZ
literal 0
HcmV?d00001
diff --git a/docs/book/C/prev.png b/docs/book/C/prev.png
new file mode 100644
index 0000000000000000000000000000000000000000..23dafb7e9d2ce86b8513a533ac88fe9bb34fc189
GIT binary patch
literal 1841
zcmV-12hRA3P)<h;3K|Lk000e1NJLTq001Na001Be1^@s6dXd_W00004b3#c}2nYxW
zd<bNS0000PbVXQnQ*UN;cVTj60C#tHE@^ISb7Ns}WiD at WXPfRk8UO$W!%0LzR9J<*
zn1761RTam-=ic{bcBeaKw at YEMwbW9n6_p|tvY8cX+mOXJmAVa;mc+z>82k}2Q(_Zi
zqQ;086Msa+Ka?U;FhGh`(mxa;gax%|Yi+yzu`OM at -QPPq-I>{$dGFnO{NvvD=IxKV
zxJ!JSlly+&^SR%1?zwlCm>KWJk;%HNN#H5g*xLE1e_^iuh<6EQz3U|2Y^ZPiAb{ri
z^fhmw%r5u7bgJ>iFWvp^E0(patj at PTXU-s5mq=jGdlp~&h5I(|UQm}vfk5-+nHx|h
z>n2Iyxf at p8yy2b=UrF`mPoasgo;S>#fHGOPnFL;0ck|{Cw6EQfI5+xF6su!sO0|IK
z|Ey3Z>#ih$SMT2VK+8w3TPMyA{{t0Onm5FpfHGOP&2iiVpa0bE#wAx?N2iAmL1`b%
z3<d*W*b>s5$+|7?u-jtiqki#!2FmPm?@gx~ANyj*x6*DRfwLorp;<-7tifPh*}OQp
zq_F(?u(ri(Tyzf%m_hJxzOMw}y>VYOTVZT_*!@mR^RkB?*z(N<B`=5J(gkSNVAhkM
zTGA`fP`3!o3Ys|rHP3bIT0?Vyg~?_-^6Re^JNNkMccf4z>$)WH^r~xb+_ZD!S5pIp
zbGTF)wxiWx=*W at Q3K#NSk#nU3C=Q^tvTXp(D!Q+9fVLIeX7oEFP$ug(lE5EZKeF+|
z?YHbmo*O-aiVbxrxrPQ{l^_j<vXIK0Pg6xhLq~(T+%XL(lXaJqz^j`-zH`Y<E8Aq(
zKqmt2O at 4{Oe9#s~gDnV1fk}adxu<muG!A!}RG9>n$-1{l=^WhA{$SHJ&CBRm|7&2@
zK&-xqaIql^6oyZ56h0;egvtpG4%D<s0L%iE$-3K8^$oxL?52knlEXML*a?8lp9LZj
z at 5W4Z2)61l0BvA|0fo>2>nNl(sLO}V0f4rL-3J#pUGx2W at BDJZX!#-r^KYAVi6}&Z
zkY=R{wIVP;FnK`=#cB>E{}QS}3Duwsr2-Hnhy|bp9I8WtQUJ)R^xqZIf%b8!Jc4|A
z5EZ`!S0=481Stt@^%53|IY7Z1!MHbsf;VcyXC8pr>Zci6Gqhr81!%<(>>?@a5h(BS
zK(GJ6e>}6x9o%>D=X>wGtz)4h6F4(`2&u#saGeBP$A#-Apy9zo8NM!~tnz?h5CJ49
zTIrds5rgAvo2AssL&@_{4$Q12BFW4ud at b4!b?))^7xNPv4!r!#2vw83X6Z(ZP4r`+
zcouzyQ at AjG4E?1u7^_^wgvx;=Lr4=!;nYkzMo|$rVM8vgO<sc?B66ky5t01c&(yz0
z&-$%@dgBl0`Y!hQpSXS}Qi(K3n1mJr5E7G|NvGDzIG`kueK!OVAy92wNH$86h-4Hp
zGRYzV$P+K<p{qW`>sWU_lP~7h-hR`Ly0`idpb!k1(AbWJAdn;o0g$K-nHk{N1k%h9
z(%dHjkjB()iiAx$BGRE$!qN%=V(1uGa^1mpegBE?6^r8??d$GZ(3Sf$2Fu+Mh#5Vi
zQG-mkCVwWU4rxRxlVH=vN?Y822t-pYsDS_aQ}qq+bG_ZqPyFWVceQU%rBjP=zVMa}
zUoAgK0Pjn$MN at LA*^X$2)@GKmGUsNd)y`d~4m0^CW`<3wxViD`)mz2wSFfu7$(Hs{
zr;(b#@v)a797Op;61Z{ECUl=XUp?R5>w&{H4~TCl*leD{;>rWVz1|x?3|0XMtoflr
zJjHbUx@*6Fed4zAXI==Nee#a=pImh7(hhMX_j|DLjaoLDFZK+2M_%c9q&UEDLqL&$
z5`q*7D3VYl5eNw-94O%+sE%W3s^6$E&R{AgC3;@dr%OY;h54nuw|=a3dFz^c5{Jir
z2agK1Bqwm?5_<an&S&iRW>GWep$hTyAnuQu*$Jg2qBuZ&l?WBY$Vnb54Fw%qz4_y@
ze6ID5_1o%?7Y?GxgS8BG-~p)EZ&Yk>AxONPYPCAVW(kgy`?1ys-~sT;ITZf#qu~DI
zM^8QZ+>5`RxS^pPS0%59)(n7HCg1_6TBz{cv*u6fH}b_c(<c3LwNU;H=1u9mdg!s>
zyXU+5cJJNyt5OTrpvf^?W9dfkRpal^0ObSlnAzjlN;~bRG at Bz1F%8C!zIylx^=#kC
z@$FCTdt$7&zlRyjG8u)e8f$0#o|%KG{%76f+bS+#N<h4TM!B|nt60|je)*Cs6D_0v
zuB<=$v^t9EGd2Ja at GK5z{bz$!OfhpfvNC`P+m->8yY}nTBd63_&#(Rhz#02Iv@$c7
fnc1HW1_1s8ax^m`hMkj&00000NkvXXu0mjfHV}&-
literal 0
HcmV?d00001
diff --git a/docs/book/C/telepathy.xml b/docs/book/C/telepathy.xml
index 8e1519f..cf841f6 100644
--- a/docs/book/C/telepathy.xml
+++ b/docs/book/C/telepathy.xml
@@ -71,7 +71,7 @@
<chapter id="chapter-introduction">
<title>Introduction</title>
<para>The Telepathy framework allows applications to use real-time communications via several common protocols, such as XMPP (Jabber). For instance, an instant messenger application might use Telepathy to allow chats with online contacts via accounts with various IM services. Or a game might use Telepathy to simplify the implementation of its networking code, allowing users to play against each other.</para>
- <para>Telepathy is a D-Bus API so it may be used from most programming languages.</para>
+ <para>Telepathy is a <ulink url="http://www.freedesktop.org/wiki/Software/dbus">D-Bus</ulink> API so it may be used from most programming languages.</para>
<para>All this functionality is available under an open source license, allowing people to make improvements and add new features.</para>
<para>TODO: What are the benefits? How is it better than the alternatives? (If there are any). Is it easier, robuster, more secure, more flexible, cheaper, free-er, what?</para>
@@ -104,6 +104,13 @@ of the Telapathy specification.
<sect2 id="sec-basics-dbus-glib">
<title>Using D-Bus from C, with glib</title>
<para>TODO</para>
+
+ <sect3>
+ <title>Example</title>
+ <para>This example used dbus-glib to call the <literal>Notify()</literal> method on the <literal>org.freedesktop.Notification</literal> interface of the desktop notification service at the <literal>/org/freedesktop/Notification</literal> path.</para>
+ <para><ulink url="&url_examples_base;basics_dbus_glib">Source Code</ulink></para>
+ </sect3>
+
</sect2>
<sect2 id="sec-basics-dbus-python">
diff --git a/docs/book/C/tip.png b/docs/book/C/tip.png
new file mode 100644
index 0000000000000000000000000000000000000000..33aa88b5efa86b5023277cd229062893d3cc5403
GIT binary patch
literal 2288
zcmV<M2oLv(P)<h;3K|Lk000e1NJLTq001xm001xu1^@s6R|5Hm00006VoOIv00000
z008+zyMF)x2&G9xK~#9!?U`$gRn-;8f9HMflYyB*z-f at -p+yaY6t&crLZrdi^Z}Tt
zu`P-9gJ}~@T0WS5X&TcSo76;-+BBvTAJwKot2Cvp at ij6n6hR##2*WTBocG*2b02eG
z=bm%=fqlnw&)nDGgP5?Bm3d_Dn)To7zy5pewc+x*ye_XV^pZXUUy|?p(sDgtUEl96
zDF6wOJ*EhgJmz}L7Up=&y%Yev0jt1vU^B2DXa|}B1IPn0pdaW44gs$MmdCt+K63!2
z9an)B!2Q78t2=IKS-JKGu2^~{;b;U?H&7HA*LBGk3Z&C%#z%+fIdP2B$2()di@=k>
zIRUZ&6z7`}=^}Pr0W{#3z at 9BT?q$u|4kF<o$(bz4REBgWN3LLD6>V@`WLd`0H3Fti
zG!#VBWCqWk<lle!1Hco&Bft!h^=0H!1yI`c8-cwWx9#fK_|<O`444d$#~F(y$Q3Lk
zNvdp6_H)40Sr`p+w)+TO2VXb|`~o;EfaE>d_*4Ltg5Lq``~H0o8SU*WnVd>8I5J7W
z7dX{GQ~+Wc8g^!i15Z6#0Dca<1f)bZ>Vi<_6TG77&)@UF!)jYw8|TiCGB`4c<G4t&
ze8EIevd_u@`2N;$Tu at EcuHU5eo;Y%w<Jf~hpNB?nt(s68$dC%$1ibiz2Od^iT3a~P
z`w_83dhYJZGDwh$$B9pjl8nd6XEW%!fu`%_fP6qublSh%LC<?#TY+Q1SR+MUk3x!&
z!mb_nJ=D>@aup|g21%qdRp}BN8^JE*`N{5`?7V$53!@P}=;`NA`(Nkm`SCfR at lh)^
zKEUgL{rzcR7cdDVMNQcA&44V_=2siH?b^A1!%g&_A0?hhSEY;VI>g7vdHmrAx%0cX
z5)KAX6osXWo4Iw<I*xXqWjd8912Fq}Sw at y+R3k(%7-|_EI1>bp3RNmrqmo=l>sJ7K
zHg4Li^;SfVPIB}qb&6{6t~-}=Ula~$fL#$Dh3diCNKrW+=$%dY|04Xg%2fG*;Z
z<^w<h?%%re$Ap3b&W}u1{-+)wvMghS!{qXXicVK8Uor=DB at 0KJ*>LL}0QUf4L1SgU
z05st4tFK+h$aoyfDppn%ACSm`MLhGjH!3<k{C>|YU1|Z*43nnTHbi?81_B};sgW8e
z?f&g+*59&w-G-a#JwJx+xDCtXhke5w?e4+QH5N5R$QLZ0JJ87s|L7|BA$VVDQ|zLJ
zYg=Y~?4ur_7s!cvD60dt27t{guiZduCOh|p^&LjVqD5|I2FtRri$!e5W~jf9*Wc_y
za$RIqrR}N}sH$3<KEf}Ogb at hR(zc4T-T&PP{7Ym&5o+Yt10VzImn^-qOfoC|Lx9PV
zVV1ToV%xTxS+$~#Wmhz_xOpMbNRVK_L{n9gGZ`NE^*+*>T-_Rw09`i;1S0 at f17@{C
zR%_^gdn6hqK0G;_;%Y5|qNx1w(LF40TT)e%qoE+Wrq&N$n5yd+4n|lef>$e1Uapb>
z31~JAgM6V_m-}WYL?&0RJcGj%?A`YgCq6s}z?(-uU^<m4<Gox1fGjKEx&RAA at alXr
zAOnV?s93ghK{0&1_gZu7Vm{~{qP4k+cTe^6+Tjzt(Rr9PS1seGKl&cF?XdsV|J7~o
zycq_!6sqRAJk3!dwZ=)DcU{-OA9xiYPrv*Y&%Dx!BuV6RIr8~D58k^INs<^GnP4KG
zY^Z=gR-vK*f>nVjrE6-{a{wS#C=^iqdR<4uB}pQcNYJr%6&tQ!1Hj0{RDIt2{MuFl
zRZ$VWkiVsN>m6hc(4S7HF?6*u_p1PL9f!=!40nEK%dE43;mL-0 at AX^AXG&3y)Vlmv
z0#It2y2nO`2pGoP0`r3L0m){wgo7qqH+9T9oJ!4<1y}PR6qe6r$Ys)qL#$Y>wXT){
z8#vU{{SJ|Eu;z~WyUBbm$EL4bhpuU}&T{!;O}h926|Fpl><pv*rvTpfT=?xqGvENP
zo_yzxn5M}M at qU)Ow#^OKtuAvIF!hFbU$RUhj;d;$d9N!W?#ZR8MMD`V4WBIF#etra
z1WmmnT`C#CmzK4bIb7PZpf>kCer>BjYI>67^aQ|Lq6hL$E8IpiU;$4ad~PpIk-!|f
zR0Cp~CaPMl&TUIt>NkM`NMdRnMb$WT;Aw!DedCsfYrqvBI0rm&=Dq)5=-OQFSLi0A
zO-=L;jFdUMa`D27+4BQRCt_rh(@YHY0qh3`fV2ld!#A=Ljq<=FoqzxH$>L0`CIw1B
zOvB*NyJxV9#aU-dS{8iV2UW>lE|X$<YzWu2Ir`fEK470X1Ja&5v3oIN6$v=|;qkY3
zT)W{GMN*BrT+Uk#gCj9kw6&sZDsLV=#rvnvSLJ;!lVW11A6Zd2`0QgA at Eei+7?2Pd
zs0g6ZsYDdGL(`4NZ~NgMj7W21U1gQF!`t(u6EUX7K0=li{`ve~Y%Bj;(f^Nq(y4@>
zQhknX51u~WxwWnR8bvq5^)Dz@=pqZXnI0b|86U at S91cGFnB_Y5@5JPK5{QclU7=d=
z^9A6DiP^E<6GyHOhC(f>5k%8;R8?zOCX0nUsi|>dBZD}0k;&l!I$wFJPtc~z6MRxg
zsQpO>TmJE40Ehrhz|Vl)H*LR*g^SxT%n)WEgl3qinuaVZxVSiWk)l<gkjs+KrYU4I
zD5^qgYLd=Z_LbCTpWylwFg>5y=*3K at 4Kb^Uin+}_!1mSazSeZb at -+m45hPj0bsVG%
zMS!BH7v2f7X@>hwar*e%32{ihETl3i03<)F>2#&{fq(!K7PcAKDDJS!#7#;Q`kfSA
zWv}RM4vQVm2$@WO9`6H{UTAcYk$^B${A~EHfTbELilWSUT7>N9`9f3ejZE{H?z_W!
z?-)f7h)ecHR%rkrdBDh?F`yrS>j~CB|93AofG_kr@#S@?*Z%?BoK~b<njo|Q0000<
KMNUMnLSTY}%T2!k
literal 0
HcmV?d00001
diff --git a/docs/book/C/up.png b/docs/book/C/up.png
new file mode 100644
index 0000000000000000000000000000000000000000..51378584d5280419db8a261f700c84cf12f73cfc
GIT binary patch
literal 1811
zcmV+u2kiKXP)<h;3K|Lk000e1NJLTq001Tc001Tk1^@s6s6FYf00004b3#c}2nYxW
zd<bNS0000PbVXQnQ*UN;cVTj60C#tHE@^ISb7Ns}WiD at WXPfRk8UO$WrAb6VR9J<@
zmtBliR~3N2wa?uQ+&jbYS6bz#&;Ui+fwoXYP8p#Sq?FRuI<454MopUrP3%L at BtH0{
z4{B7>*aw^V;$MsjQqxSLu~Ma`flO1a#t4BBpp<EV;b#~aF89vdbNBM$>~sIPFhhZ|
zPj>d+=j^lhch*{at#w3Ix!w{+c7qsxs*X*2ww3y?dqKe50H`HFklC^H?&bH0;U8gS
z+ip2n7}?tp{{Gn7FSmBB=r+q1ubeH0KZTJEZW&k@*%mSE{QQcI({G<XOLiaL!Rn6n
z6XwlYxI%<q+%hmR{O;Zb%NO6bXtjO+*qdA^p5@;k?c|Zqb!VqdnYktGu`hq(U}2B_
z-mIDPH?DuMd*XjSdW(^A0TE&F(h2qt^zp>HujVFAZ2f*1+0CCASQy!-+jG-;x*vW%
zxBqk>!^N{mdWq0Kw4dX{2YF)MmRt~Ieji5m{+kXKMs|g at Ex&qp<2SP>hYxXj_(K3h
z1Vr!y4h-}$LY_y~JlTryRv6h?Hw`R|>}*8-x at E(Qxmb%F9o*}IJWs>*e*c?Hp4`rw
z<y})mcsq=2>kS7BBbyUp*XGWzOqt$3lLG_qR-UCGjYZYb_dzdr%~>2QS#;l>V(1Mc
zJ8nUYIWdf^5yKm+mUZ2E at BEc!?}>L%QAC;nNli}}Ef?5*<aJiw(>Y<z9rIQp{QQQ2
zA-uA1ZpTAi4?Hzt at 9}qt-RL-$tpZ*gIY-~oULIcccy?<0jOW50`|axn3nTmd%&DJ#
z;hA+WPC9t%pIj<kxC+YU>P*X-d_Vs?{x+LBpUzHd$^9^l?4utWER5{h?8MerzqTpL
z9=~vip~3(FR|@*d)suk_&+ViC{5~FC+no!7%=R#{ORpI$jO;=&LGRZ$znm?^!<@Kq
zxPd~i0HY0U{hWO#cT;dftPeNm5dIcM_EX~q3nM!fVb`-8wzjqA+WBDczm*NrO+)}u
z#0V0A2_OgrlM#YU(qfb{BPiv%_5XG3&$LZ$mDLZdn<~PtFtXV(!NSO9#PF9dtoqXJ
z3ubl5!GZTGNT3N!0C*VjKoWpt6cY#pN=$)K@<^Z<4=M%_aO&7|<d57n=kCms1<U4(
z;f-c)r2dBR%lj9tUfS8Q*&aCAM_FT>I=~?&fib2EWdf at A1EItvF2!ew8L3Dv$Ou7D
zZN<Q7xybG#J9x08vt{-j^BzL@*%iUU9@{f_=7R1ou6be7!Bg*1Eay=ih=V{8qhJ&X
z6fq!yV7#=PDRCh_MZpar8ET*m#;e%)`RTL#=sDg!+Dq4GAJ0ymJmVW-WVhDINL2|V
z`&fJHwCyiF^P_C8rH$B?y!sp}4n=Vqv**|!a2n$z_R@?wKXQtTr89M3t6uY}$thL`
zPkyGSde5nUmdv|Y7~=JvzsVPh`KR`5EA0fx0EppR!}+1?kAM4;ChMw#X!^Qs3F7ZO
z_i7fSh!^u{d4$u&qm*?tv7r=-DijLpz?tO0yte%Zm*P>HXSd2kF?<)Og6;lEX=4~!
zGZGh#-?y&DWjQaB*b^wDuE6Qy5!941;-S*)B6TGmN=;%7h!Br30l2Lx7@&?~+Rvn&
zJ=;o&l{YD2WI;eg8F6_A3Wp$Y36xNmWuTI%PZKD0B(c?0_8GboSZ&FSJ*DzJIEfi3
z90ubshQyCu21dnx)F~>0OXple88?`UW3bqdN}QZV1I8q6Q!ockK&$!V%>gTw3*_TL
zB!vp33T9F}tFbLf#ty}(+&r+0 at nGWFjbe<43Zzb@;K3x3mOm at FkMXxZZZM~1L<}k}
zQJa8~1j=|o0O!&Wt~f_!?p3m)>jP61 at qwc9@8R1t5&#H^L-m8|;kZV!F*8{4$4NDj
zl=r~3nN4C-Wld_M!_hQ{OEVL(A`-|L$MiCZ`4 at tQ3MfWR;^_RzbABMHrw4H0T%tyG
zH6P)*fHt5EI1wrPepyxHreGc@<7*0(_HmjhGjRi&*cjlFY$);W)c7wCn8wALlJhWe
zZR;UpAXZh)cqmf?)mQ at nb&mCOw<do_KDQF7aRYV1vKqiE at zPc3CVGItg9Ry&UqwVD
zP9 at efM*126XI}gDD>Jy>qMY*U)hf8zo+7F`9*H%MgNDAL>J-uqotH?h+A8XzUX``A
zq^c#U{p%5t3}BmVUJH?e)O}$SuoSMgmbn}@ZAVG$%Yjc68;h4<Dn(0GrOklSwy~sO
zR|2d^Nma{@FE<5i0-8#r8BlGT0yRR_!Ra_Q{Xe>A at h179$cq2~002ovPDHLkV1fmu
BZZ!Y^
literal 0
HcmV?d00001
diff --git a/docs/book/C/warning.png b/docs/book/C/warning.png
new file mode 100644
index 0000000000000000000000000000000000000000..3c8a37df51861ef31171987ef06c59fffa044f61
GIT binary patch
literal 3249
zcmV;i3{LZjP)<h;3K|Lk000e1NJLTq001xm001xu1^@s6R|5Hm00006VoOIv0RI60
z0RN!9r;`8x3}#70K~#9!)tY;7RaKV8f9Kp6klZ97ukeylG<4fAjJ9oqjfj9KS{fk)
z7%2oTplLJKw6^68U;yn_svYDdjKQ%-nVLaBV5GzmC`|~E=^6-$jM!~R=#WH0NJ4IM
zbMHC#JocVHa+A(|B{xX_F{f%(QgwFr`M$N*{?^)i2mYTw%J=v?1yFCoTr&JqgnyTR
zX#z at VY3Z^}n>M{~+cvgscc75+hR{144(_?<p4VS_<(17qJ7D#dM4!NymzO{L{PWMt
z3l}cP&PNE*quI8d(CX^y<kL?-EmyBzy%iV^xW7j<dk4Q_#R_ at l%9Wb}-nMONS(dD=
zt(8lbERk#0tl0)+{v}8#g at uJH^YZe#z;_3!>$=o5Ey9AqV3(PuDNWOi3%<MM=H~X9
zgp#D^m+joS^ZkN?f{1)K41+)*Kx1PgrfGKlfyd*)>2yX+qN*wb1`O!R`}Fj5gb=9e
zpLL+VzMhv~ewndj$G)?1<Hk3DX29%eO(;ote#M?Wd)_T5D2Q07nx at gv(7>hR$I(}=
z>~l!R=I1j$KR;HIq-5E$Wn^V#ZGQFDSKsQ5grhg`2M!!~cjwNX5#WQtAWcn8l<(e+
zc<H4Zk~QCn6IhDE;Azt$zyoAwXR~F?mdT43FIEc+3(J5|SZ0$ZpcEDsuGqVG at 4Gv8
z?1=GvV`C%de)l^Z8#Z(acXt7oNm|Q^6PT*X;Hgt%0OaQ8QczGZIVUH_SyWVXE)j`%
z1eBvkkN*7N!Gr(2W5<q&7n-I~U0ux|_U=Vlzdm7A>Wle`iZBg>ArCziGuPa?bJ at Ce
z>ra<1UCI|<d{G{cL^J_q_wL=lEG{nIwr$(Ch!??NkSkZNP<ikm*4niR0aXJVfCAv7
zZ~~_RDS$Hp;g-{<F{NbagAc~6huqv;wr<@zW#PhwJw^gRIdbI4^Dn&cLX4IN0s&c3
zQ6UelTPHt;7~2l=p|E9ve0%Lm*;sQ?`kEW$hudD4!$D2~IRoT!kpB+yKpZ=_W{osW
zQyPX5WAo?Fmv6rL=08PCY-a?N0|yS|6%`e2- at JKq+_d@QM;~Es*bu||Pr&QI2SuMT
z;nA7A^YJJA;uov9bK-s2rirDsFz${~{Br9S=DqYQ&RZH^o-Jd1oQSlXJc-fX&ahdt
zV!ktF$`p3(+BGFQog4s%4jqaMJ{SyATU$%jp+jh4$%{^z-N2{irx<tFy$l&TjKLm*
zvA5kx=E%|Lt at T{HT8)95Nk5rNsyB_F-1|2amH!vM>J~=DSvM`e|2?K at GHm+v2rOQ&
zm-+MOvw8F8DT@{@a)i^#Pyya}<BjcGwrq*<d}U=Nm-g?cea#wVIPtn$r|Nk6ry?wa
zkiUt+1Jh7!4IxZyOGlLoZl at Dfbz&PD?JbSmJ$W)80_%V}z>b>t;>L}9wRUa9TIf{5
zO`A4x?AWot2W|yYRDdyK#zcTO41=1Q8ooPx7+-#V4De2~!z2_%5(@gzeOEC8K9Ckj
z2|}PM3X13$X#{<IQ+}Es+&zP;hVR&U<N)sgSE71p2~_^}w|uo`O-z?Nbm&l0Qc?g$
z0bVsa*DTATva*t at y?bfN&reDU9jXGtMhY7#LP%kEOAZ at hnMff(+BiKa{P at 19xZM5u
z;e@|t`QJT<KRhzpK^1Sk#aFMrmZ%n{0PeU1oK7dr>(?jre0Pfovyj-9fo)kJ1xSHy
zTL{^?XMld5{y3D5aeB~CKndYbFt-FMe)Ah#E>}DPDxj#*y4zi!lOfO%1*KyuhXd8^
z>DXRLiERmNA+T+`D~~T;C`AYxVQ2)~nrZVjB<-Yl8z*O?7orcHpRgsm7C at jfe8lZI
z6esnUtFVlA+WZ<0)rqhzgjBFBtAn((k-|g>8#O_vCVK%-)SkB2mLOpSq(E3E4o at m0
zZv7#tgNEbx`>~{x)PbXLIGxm0UBEVVT&@8qC at 4y&LmWv(Akmi9nTSAi1Wcd>2!vTX
z!X>dIGzw`$MlsOgV&v^AimHO5bgT*6M%UVDX}CgDb2GN;L?FSo5K<t7ffDC?$#%6#
z6Zmgn=C9WwZyCt7=4Q%|9p!ZK|4;`QT06qZ087K+ at _@sIs=82B6^Fxv)8)eB8Gzr{
z#PE at Sh30R?<8dLRh=_Ji>60{p&czlz!C_#-Q*#+Sax_v(+7~Y3<bQt5x?kn<ZP{sl
zbkF_t>)#*ufHV}R8;8S2b-Ga<3Jz5Tx102VgPHu`Y_zsUg1%PFkWSFoNNS?)tgi&R
z=UMcGqkt<lm&q7D0+-W?_m)g%ELuX=9k=n`&c(oM+;-<g1`ZpICnW=^N^HwUqTo>6
zsHy|S?WTX)KwK^ddf+;(tu25SQPq1rM2cDqYELTE-6jL|*BY?&0KyC*gn_eP3L}4f
zKYyF|uT=iwD~=xeH+)SEgtTC|n28SY2NXp?K?NyM5U7fZ5E7wwmb*wxRBMt}p=hNU
z4{Us9IrVilm>~^mn<&!4-7l4_yQlL=&I-I4gZN<Qdd?PqPMhyKLfA+ty37_9wiyif
zNd|f-h!Ol#uZq``3dImm6eUJR1>gei1&;08hp7dzO#^9LAPiid{tOy9p8IEJle;*N
zTW`OEc3(5Wc0W=|gb*FY%QBI+iDiT^bPZh#g57)3?CFUi;C8!FRW<HJcK{!5dWW;8
zPNHi8Y%7Em76=o!+r`ka6B#^W90O9)NKH${se-UNdL!F15g|X8siOt_w6?a;+R}v3
z=_+K2tWN}_lw at RNFmm?nxSq%X@|XUci+{X;ZHADRiIg at 73sn)M-ZBzz+8|sm7mCuc
z25iefgaVkRfuRM_g8|xnJ~Y3dp-M+rmdN{)^74`=(3xi$85#Waz4yqRIWxu^slYT~
z>EjEjyHr6a*cSG(3ATYMblm+txIO)FI8+cO(rCxf+cC5NdeBevwFZ3G8<0i-qarbZ
z3C}&p{adyW3Wa)Bq3#=o&Qr9^%uMbpC?IpjjF^c>0E>W}ho0h_^Jg*IeORFY!Ztd3
z94R|gM at nofL`V;y>j47(>onAV$JP28Y%|Egf_E{mcMynn)VRkUWBRULU2C#C`0l59
zPJp(ywz%OLGiD6z+QpgW%enmJml5wWfLtJN-U<c}f?c0|N?Q6LoNjlxMNqJ98^bWr
zwIF)HPh(>pE!XN%Y at K~Owqaa`ar{|EJD*8QmN4ss50Fw~7)FG16-7Y^(Iu1)fJ>Jy
zy<b*V_Ts{Y3uD%U*Xt#9+B90vpQp9DI$~k<1AYWJH2BAV`45H+ at i1!CNQ7+@^taL0
zavgtb3&GYV+M2K8yLK7Pf1Q1=6yUtxp=!~ce%51;F=yYtxZta*s+c!#9;Z&7S_{+w
zb)E4^1;%D)XaDd1{rlr;ZcR-MCC@%fZE<njn$Zy68hXdVzG~2-#`FV5hoyKxxU##W
z#*Babak38|MoJlx_W<qf?PO<XQ&Lj$DsU0F08}g8)<P<9>l05raen*u?PO+V#sICW
ztK-Bo&+y&JlQ;d2Yy6x!JoV|P2q7>GBL at 5<k37P;bLTq2e*;_w0*-FYp9yH+e*5j7
zs;a703l=Ph`Iy)1C1d(@+RDmksj2DnF=C=k%lJnhW$uw905P7gs;VL<Cnqj=z;;B<
zWdd47Ma7=7va(eVJn#TsuQx&g($mxNPMb#SxpVkxYx`7m;%$`1&z{Y^&prb{*Y$|8
zm6esOT)C1nXU at b0AMb25f<$Fy<*KZ#EQSpm7O6lP84R2;1Al2LEw!~be7O6AS+kh`
z`R572FI~EnGiT1M2CCwLPjosRLE`GwtE;9?o!S+N&L=G`jnUcJ_)1D>iW7<6EbC`K
zV?kJ&qrsPyl#rK~*O at j6!IMOrkp at h7^2sOV@#Dv3C=}{4UDvy;w~M@<F8I3Nr3HgQ
zSzKH!Crz3pfwjN_U_uy&qfcAPusXH_mp}RBlZjHw^8i!hTt;-iA4}%GIMJB1XV3ED
zi!V}MUcMT*l#J&cNvydpb<%Zxm2KPHb=O^e0+!7C!-o%(pPx@@X=$I*#+gJabwy(T
z{{0hOF4uXd)5)AUb8ZTFMNud$EadIC-=?&*G-=P@$iEtN6}yKYe)#;gYuC^;?Ryt8
zkH>=$g0H{+`X9m<JbhZQeZ39uBryiK4M^`iqx_ycY at jvl{hGe0&5e9m4YxDt;TA`^
j2?PY7he-tca?0|5+R4bmy*%S at 00000NkvXXu0mjfi#s=4
literal 0
HcmV?d00001
diff --git a/docs/examples/Makefile.am b/docs/examples/Makefile.am
index fae4402..b4711e3 100644
--- a/docs/examples/Makefile.am
+++ b/docs/examples/Makefile.am
@@ -1,6 +1,6 @@
include $(top_srcdir)/docs/Makefile_web.am_fragment
-example_dirs = connect list_all_protocols list_contacts set_presence send_message
+example_dirs = basics_dbus_glib connect list_all_protocols list_contacts set_presence send_message
SUBDIRS = $(example_dirs)
diff --git a/docs/examples/basics_dbus_glib/Makefile.am b/docs/examples/basics_dbus_glib/Makefile.am
new file mode 100644
index 0000000..d0a304f
--- /dev/null
+++ b/docs/examples/basics_dbus_glib/Makefile.am
@@ -0,0 +1,7 @@
+include $(top_srcdir)/docs/examples/Makefile.am_fragment
+
+#Build the executable, but don't install it.
+noinst_PROGRAMS = example
+
+example_SOURCES = main.c
+
diff --git a/docs/examples/basics_dbus_glib/main.c b/docs/examples/basics_dbus_glib/main.c
new file mode 100644
index 0000000..2aca97b
--- /dev/null
+++ b/docs/examples/basics_dbus_glib/main.c
@@ -0,0 +1,85 @@
+/* Copyright 2009 Collabora Ltd
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License version 2
+ * as published by the Free Software Foundation.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+ */
+
+#include <dbus/dbus-glib.h>
+#include <glib.h>
+
+GMainLoop *mainloop = NULL;
+
+int
+main (int argc, char **argv)
+{
+ g_type_init ();
+
+ /* Create the main loop: */
+ mainloop = g_main_loop_new (NULL, FALSE);
+
+ /* Connect to the bus: */
+ GError *error = 0;
+ DBusGConnection *connection = dbus_g_bus_get (DBUS_BUS_SESSION, &error);
+ if (error)
+ {
+ g_printf ("dbus_g_bus_get() failed: %s\n", error->message);
+ g_clear_error (&error);
+ g_main_loop_quit (mainloop);
+ return 1;
+ }
+
+ /* Get a proxy for the remote object: */
+ DBusGProxy *proxy = dbus_g_proxy_new_for_name (connection,
+ "org.freedesktop.Notifications", /* name */
+ "/org/freedesktop/Notifications", /* path */
+ "org.freedesktop.Notifications"); /* interface */
+
+ /* Call a method on the interface of the remote object: */
+ error = NULL;
+ guint id = 0;
+ GHashTable* actions = g_hash_table_new (NULL, NULL);
+ dbus_g_proxy_call (proxy, "Notify", &error,
+ G_TYPE_STRING, "dbus-glib example",
+ G_TYPE_UINT, 0,
+ G_TYPE_STRING, "", /* icon_name */
+ G_TYPE_STRING, "Example Notification",
+ G_TYPE_STRING, "This is an example notification via dbus-glib.",
+ G_TYPE_STRV, 0,
+ dbus_g_type_get_map("GHashTable", G_TYPE_STRING, G_TYPE_VALUE), actions,
+ G_TYPE_INT, 0,
+ G_TYPE_INVALID,
+ G_TYPE_UINT, &id, /* Return value. */
+ G_TYPE_INVALID);
+ g_hash_table_unref (actions);
+ actions = NULL;
+
+ if (error)
+ {
+ g_printf ("dbus_g_proxy_call() failed: %s\n", error->message);
+ g_clear_error (&error);
+ g_main_loop_quit (mainloop);
+ return 1;
+ }
+
+
+ /* Run the main loop,
+ * to keep our application alive while we wait for responses from D-Bus.
+ * This function returns when we call g_main_loop_quit() from elsewhere.
+ */
+ g_main_loop_run (mainloop);
+
+ /* Clean up: */
+ g_main_loop_unref (mainloop);
+
+ return 0;
+}
--
1.5.6.5
More information about the Telepathy-commits
mailing list