atk 0.90.2-x86-mingw32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (849) hide show
  1. data/ChangeLog +241 -0
  2. data/README +30 -0
  3. data/Rakefile +74 -0
  4. data/ext/atk/Makefile +160 -0
  5. data/ext/atk/atk.def +2 -0
  6. data/ext/atk/depend +8 -0
  7. data/ext/atk/extconf.rb +60 -0
  8. data/ext/atk/makeinits.rb +39 -0
  9. data/ext/atk/rbatk.c +27 -0
  10. data/ext/atk/rbatk.h +36 -0
  11. data/ext/atk/rbatkaction.c +81 -0
  12. data/ext/atk/rbatkcomponent.c +184 -0
  13. data/ext/atk/rbatkdocument.c +95 -0
  14. data/ext/atk/rbatkeditabletext.c +102 -0
  15. data/ext/atk/rbatkgobjectaccessible.c +37 -0
  16. data/ext/atk/rbatkhyperlink.c +92 -0
  17. data/ext/atk/rbatkhypertext.c +44 -0
  18. data/ext/atk/rbatkimage.c +62 -0
  19. data/ext/atk/rbatkimplementor.c +27 -0
  20. data/ext/atk/rbatkinits.c +55 -0
  21. data/ext/atk/rbatknoopobject.c +30 -0
  22. data/ext/atk/rbatknoopobjectfactory.c +30 -0
  23. data/ext/atk/rbatkobject.c +178 -0
  24. data/ext/atk/rbatkobjectfactory.c +44 -0
  25. data/ext/atk/rbatkregistry.c +55 -0
  26. data/ext/atk/rbatkrelation.c +104 -0
  27. data/ext/atk/rbatkrelationset.c +94 -0
  28. data/ext/atk/rbatkselection.c +82 -0
  29. data/ext/atk/rbatkstate.c +41 -0
  30. data/ext/atk/rbatkstateset.c +143 -0
  31. data/ext/atk/rbatkstreamablecontent.c +50 -0
  32. data/ext/atk/rbatktable.c +292 -0
  33. data/ext/atk/rbatktext.c +364 -0
  34. data/ext/atk/rbatktextrange.c +91 -0
  35. data/ext/atk/rbatktextrectangle.c +156 -0
  36. data/ext/atk/rbatkutil.c +125 -0
  37. data/ext/atk/rbatkvalue.c +74 -0
  38. data/ext/atk/rbatkversion.h +24 -0
  39. data/extconf.rb +49 -0
  40. data/lib/1.8/atk.so +0 -0
  41. data/lib/1.9/atk.so +0 -0
  42. data/lib/atk.rb +12 -0
  43. data/vendor/local/bin/envsubst.exe +0 -0
  44. data/vendor/local/bin/gettext.exe +0 -0
  45. data/vendor/local/bin/gettext.sh +123 -0
  46. data/vendor/local/bin/glib-genmarshal.exe +0 -0
  47. data/vendor/local/bin/glib-gettextize +188 -0
  48. data/vendor/local/bin/glib-mkenums +511 -0
  49. data/vendor/local/bin/gobject-query.exe +0 -0
  50. data/vendor/local/bin/gspawn-win32-helper-console.exe +0 -0
  51. data/vendor/local/bin/gspawn-win32-helper.exe +0 -0
  52. data/vendor/local/bin/intl.dll +0 -0
  53. data/vendor/local/bin/libasprintf-0.dll +0 -0
  54. data/vendor/local/bin/libatk-1.0-0.dll +0 -0
  55. data/vendor/local/bin/libgcc_s_dw2-1.dll +0 -0
  56. data/vendor/local/bin/libgio-2.0-0.dll +0 -0
  57. data/vendor/local/bin/libglib-2.0-0.dll +0 -0
  58. data/vendor/local/bin/libgmodule-2.0-0.dll +0 -0
  59. data/vendor/local/bin/libgobject-2.0-0.dll +0 -0
  60. data/vendor/local/bin/libgthread-2.0-0.dll +0 -0
  61. data/vendor/local/bin/ngettext.exe +0 -0
  62. data/vendor/local/include/atk-1.0/atk/atk-enum-types.h +45 -0
  63. data/vendor/local/include/atk-1.0/atk/atk.h +56 -0
  64. data/vendor/local/include/atk-1.0/atk/atkaction.h +111 -0
  65. data/vendor/local/include/atk-1.0/atk/atkcomponent.h +171 -0
  66. data/vendor/local/include/atk-1.0/atk/atkdocument.h +83 -0
  67. data/vendor/local/include/atk-1.0/atk/atkeditabletext.h +104 -0
  68. data/vendor/local/include/atk-1.0/atk/atkgobjectaccessible.h +65 -0
  69. data/vendor/local/include/atk-1.0/atk/atkhyperlink.h +106 -0
  70. data/vendor/local/include/atk-1.0/atk/atkhyperlinkimpl.h +75 -0
  71. data/vendor/local/include/atk-1.0/atk/atkhypertext.h +78 -0
  72. data/vendor/local/include/atk-1.0/atk/atkimage.h +87 -0
  73. data/vendor/local/include/atk-1.0/atk/atkmisc.h +89 -0
  74. data/vendor/local/include/atk-1.0/atk/atknoopobject.h +55 -0
  75. data/vendor/local/include/atk-1.0/atk/atknoopobjectfactory.h +57 -0
  76. data/vendor/local/include/atk-1.0/atk/atkobject.h +649 -0
  77. data/vendor/local/include/atk-1.0/atk/atkobjectfactory.h +67 -0
  78. data/vendor/local/include/atk-1.0/atk/atkplug.h +61 -0
  79. data/vendor/local/include/atk-1.0/atk/atkregistry.h +69 -0
  80. data/vendor/local/include/atk-1.0/atk/atkrelation.h +89 -0
  81. data/vendor/local/include/atk-1.0/atk/atkrelationset.h +78 -0
  82. data/vendor/local/include/atk-1.0/atk/atkrelationtype.h +83 -0
  83. data/vendor/local/include/atk-1.0/atk/atkselection.h +95 -0
  84. data/vendor/local/include/atk-1.0/atk/atksocket.h +65 -0
  85. data/vendor/local/include/atk-1.0/atk/atkstate.h +178 -0
  86. data/vendor/local/include/atk-1.0/atk/atkstateset.h +80 -0
  87. data/vendor/local/include/atk-1.0/atk/atkstreamablecontent.h +105 -0
  88. data/vendor/local/include/atk-1.0/atk/atktable.h +217 -0
  89. data/vendor/local/include/atk-1.0/atk/atktext.h +365 -0
  90. data/vendor/local/include/atk-1.0/atk/atkutil.h +313 -0
  91. data/vendor/local/include/atk-1.0/atk/atkvalue.h +93 -0
  92. data/vendor/local/include/autosprintf.h +66 -0
  93. data/vendor/local/include/glib-2.0/gio/gappinfo.h +237 -0
  94. data/vendor/local/include/glib-2.0/gio/gasyncinitable.h +119 -0
  95. data/vendor/local/include/glib-2.0/gio/gasyncresult.h +73 -0
  96. data/vendor/local/include/glib-2.0/gio/gbufferedinputstream.h +123 -0
  97. data/vendor/local/include/glib-2.0/gio/gbufferedoutputstream.h +82 -0
  98. data/vendor/local/include/glib-2.0/gio/gcancellable.h +103 -0
  99. data/vendor/local/include/glib-2.0/gio/gcharsetconverter.h +60 -0
  100. data/vendor/local/include/glib-2.0/gio/gcontenttype.h +57 -0
  101. data/vendor/local/include/glib-2.0/gio/gconverter.h +95 -0
  102. data/vendor/local/include/glib-2.0/gio/gconverterinputstream.h +80 -0
  103. data/vendor/local/include/glib-2.0/gio/gconverteroutputstream.h +80 -0
  104. data/vendor/local/include/glib-2.0/gio/gdatainputstream.h +133 -0
  105. data/vendor/local/include/glib-2.0/gio/gdataoutputstream.h +116 -0
  106. data/vendor/local/include/glib-2.0/gio/gdrive.h +225 -0
  107. data/vendor/local/include/glib-2.0/gio/gemblem.h +58 -0
  108. data/vendor/local/include/glib-2.0/gio/gemblemedicon.h +62 -0
  109. data/vendor/local/include/glib-2.0/gio/gfile.h +1017 -0
  110. data/vendor/local/include/glib-2.0/gio/gfileattribute.h +77 -0
  111. data/vendor/local/include/glib-2.0/gio/gfileenumerator.h +133 -0
  112. data/vendor/local/include/glib-2.0/gio/gfileicon.h +56 -0
  113. data/vendor/local/include/glib-2.0/gio/gfileinfo.h +951 -0
  114. data/vendor/local/include/glib-2.0/gio/gfileinputstream.h +112 -0
  115. data/vendor/local/include/glib-2.0/gio/gfileiostream.h +118 -0
  116. data/vendor/local/include/glib-2.0/gio/gfilemonitor.h +95 -0
  117. data/vendor/local/include/glib-2.0/gio/gfilenamecompleter.h +76 -0
  118. data/vendor/local/include/glib-2.0/gio/gfileoutputstream.h +119 -0
  119. data/vendor/local/include/glib-2.0/gio/gfilterinputstream.h +76 -0
  120. data/vendor/local/include/glib-2.0/gio/gfilteroutputstream.h +76 -0
  121. data/vendor/local/include/glib-2.0/gio/gicon.h +91 -0
  122. data/vendor/local/include/glib-2.0/gio/ginetaddress.h +103 -0
  123. data/vendor/local/include/glib-2.0/gio/ginetsocketaddress.h +69 -0
  124. data/vendor/local/include/glib-2.0/gio/ginitable.h +96 -0
  125. data/vendor/local/include/glib-2.0/gio/ginputstream.h +172 -0
  126. data/vendor/local/include/glib-2.0/gio/gio.h +101 -0
  127. data/vendor/local/include/glib-2.0/gio/gioenums.h +703 -0
  128. data/vendor/local/include/glib-2.0/gio/gioenumtypes.h +79 -0
  129. data/vendor/local/include/glib-2.0/gio/gioerror.h +48 -0
  130. data/vendor/local/include/glib-2.0/gio/giomodule.h +132 -0
  131. data/vendor/local/include/glib-2.0/gio/gioscheduler.h +52 -0
  132. data/vendor/local/include/glib-2.0/gio/giostream.h +112 -0
  133. data/vendor/local/include/glib-2.0/gio/giotypes.h +339 -0
  134. data/vendor/local/include/glib-2.0/gio/gloadableicon.h +97 -0
  135. data/vendor/local/include/glib-2.0/gio/gmemoryinputstream.h +82 -0
  136. data/vendor/local/include/glib-2.0/gio/gmemoryoutputstream.h +97 -0
  137. data/vendor/local/include/glib-2.0/gio/gmount.h +242 -0
  138. data/vendor/local/include/glib-2.0/gio/gmountoperation.h +123 -0
  139. data/vendor/local/include/glib-2.0/gio/gnativevolumemonitor.h +62 -0
  140. data/vendor/local/include/glib-2.0/gio/gnetworkaddress.h +69 -0
  141. data/vendor/local/include/glib-2.0/gio/gnetworkservice.h +69 -0
  142. data/vendor/local/include/glib-2.0/gio/goutputstream.h +207 -0
  143. data/vendor/local/include/glib-2.0/gio/gresolver.h +167 -0
  144. data/vendor/local/include/glib-2.0/gio/gseekable.h +99 -0
  145. data/vendor/local/include/glib-2.0/gio/gsimpleasyncresult.h +125 -0
  146. data/vendor/local/include/glib-2.0/gio/gsocket.h +176 -0
  147. data/vendor/local/include/glib-2.0/gio/gsocketaddress.h +79 -0
  148. data/vendor/local/include/glib-2.0/gio/gsocketaddressenumerator.h +89 -0
  149. data/vendor/local/include/glib-2.0/gio/gsocketclient.h +130 -0
  150. data/vendor/local/include/glib-2.0/gio/gsocketconnectable.h +68 -0
  151. data/vendor/local/include/glib-2.0/gio/gsocketconnection.h +91 -0
  152. data/vendor/local/include/glib-2.0/gio/gsocketcontrolmessage.h +105 -0
  153. data/vendor/local/include/glib-2.0/gio/gsocketlistener.h +138 -0
  154. data/vendor/local/include/glib-2.0/gio/gsocketservice.h +88 -0
  155. data/vendor/local/include/glib-2.0/gio/gsrvtarget.h +52 -0
  156. data/vendor/local/include/glib-2.0/gio/gtcpconnection.h +68 -0
  157. data/vendor/local/include/glib-2.0/gio/gthemedicon.h +63 -0
  158. data/vendor/local/include/glib-2.0/gio/gthreadedsocketservice.h +81 -0
  159. data/vendor/local/include/glib-2.0/gio/gvfs.h +125 -0
  160. data/vendor/local/include/glib-2.0/gio/gvolume.h +211 -0
  161. data/vendor/local/include/glib-2.0/gio/gvolumemonitor.h +151 -0
  162. data/vendor/local/include/glib-2.0/gio/gzlibcompressor.h +55 -0
  163. data/vendor/local/include/glib-2.0/gio/gzlibdecompressor.h +54 -0
  164. data/vendor/local/include/glib-2.0/glib/galloca.h +63 -0
  165. data/vendor/local/include/glib-2.0/glib/garray.h +179 -0
  166. data/vendor/local/include/glib-2.0/glib/gasyncqueue.h +120 -0
  167. data/vendor/local/include/glib-2.0/glib/gatomic.h +85 -0
  168. data/vendor/local/include/glib-2.0/glib/gbacktrace.h +68 -0
  169. data/vendor/local/include/glib-2.0/glib/gbase64.h +57 -0
  170. data/vendor/local/include/glib-2.0/glib/gbitlock.h +43 -0
  171. data/vendor/local/include/glib-2.0/glib/gbookmarkfile.h +191 -0
  172. data/vendor/local/include/glib-2.0/glib/gcache.h +69 -0
  173. data/vendor/local/include/glib-2.0/glib/gchecksum.h +86 -0
  174. data/vendor/local/include/glib-2.0/glib/gcompletion.h +77 -0
  175. data/vendor/local/include/glib-2.0/glib/gconvert.h +138 -0
  176. data/vendor/local/include/glib-2.0/glib/gdataset.h +122 -0
  177. data/vendor/local/include/glib-2.0/glib/gdate.h +263 -0
  178. data/vendor/local/include/glib-2.0/glib/gdir.h +52 -0
  179. data/vendor/local/include/glib-2.0/glib/gerror.h +98 -0
  180. data/vendor/local/include/glib-2.0/glib/gfileutils.h +128 -0
  181. data/vendor/local/include/glib-2.0/glib/ghash.h +166 -0
  182. data/vendor/local/include/glib-2.0/glib/ghook.h +181 -0
  183. data/vendor/local/include/glib-2.0/glib/ghostutils.h +40 -0
  184. data/vendor/local/include/glib-2.0/glib/gi18n-lib.h +38 -0
  185. data/vendor/local/include/glib-2.0/glib/gi18n.h +34 -0
  186. data/vendor/local/include/glib-2.0/glib/giochannel.h +366 -0
  187. data/vendor/local/include/glib-2.0/glib/gkeyfile.h +250 -0
  188. data/vendor/local/include/glib-2.0/glib/glist.h +120 -0
  189. data/vendor/local/include/glib-2.0/glib/gmacros.h +277 -0
  190. data/vendor/local/include/glib-2.0/glib/gmain.h +304 -0
  191. data/vendor/local/include/glib-2.0/glib/gmappedfile.h +49 -0
  192. data/vendor/local/include/glib-2.0/glib/gmarkup.h +163 -0
  193. data/vendor/local/include/glib-2.0/glib/gmem.h +203 -0
  194. data/vendor/local/include/glib-2.0/glib/gmessages.h +343 -0
  195. data/vendor/local/include/glib-2.0/glib/gnode.h +288 -0
  196. data/vendor/local/include/glib-2.0/glib/goption.h +370 -0
  197. data/vendor/local/include/glib-2.0/glib/gpattern.h +49 -0
  198. data/vendor/local/include/glib-2.0/glib/gpoll.h +93 -0
  199. data/vendor/local/include/glib-2.0/glib/gprimes.h +51 -0
  200. data/vendor/local/include/glib-2.0/glib/gprintf.h +52 -0
  201. data/vendor/local/include/glib-2.0/glib/gqsort.h +46 -0
  202. data/vendor/local/include/glib-2.0/glib/gquark.h +52 -0
  203. data/vendor/local/include/glib-2.0/glib/gqueue.h +127 -0
  204. data/vendor/local/include/glib-2.0/glib/grand.h +85 -0
  205. data/vendor/local/include/glib-2.0/glib/gregex.h +243 -0
  206. data/vendor/local/include/glib-2.0/glib/grel.h +97 -0
  207. data/vendor/local/include/glib-2.0/glib/gscanner.h +278 -0
  208. data/vendor/local/include/glib-2.0/glib/gsequence.h +128 -0
  209. data/vendor/local/include/glib-2.0/glib/gshell.h +55 -0
  210. data/vendor/local/include/glib-2.0/glib/gslice.h +86 -0
  211. data/vendor/local/include/glib-2.0/glib/gslist.h +114 -0
  212. data/vendor/local/include/glib-2.0/glib/gspawn.h +139 -0
  213. data/vendor/local/include/glib-2.0/glib/gstdio.h +159 -0
  214. data/vendor/local/include/glib-2.0/glib/gstrfuncs.h +267 -0
  215. data/vendor/local/include/glib-2.0/glib/gstring.h +178 -0
  216. data/vendor/local/include/glib-2.0/glib/gtestutils.h +292 -0
  217. data/vendor/local/include/glib-2.0/glib/gthread.h +408 -0
  218. data/vendor/local/include/glib-2.0/glib/gthreadpool.h +114 -0
  219. data/vendor/local/include/glib-2.0/glib/gtimer.h +65 -0
  220. data/vendor/local/include/glib-2.0/glib/gtree.h +91 -0
  221. data/vendor/local/include/glib-2.0/glib/gtypes.h +451 -0
  222. data/vendor/local/include/glib-2.0/glib/gunicode.h +404 -0
  223. data/vendor/local/include/glib-2.0/glib/gurifuncs.h +81 -0
  224. data/vendor/local/include/glib-2.0/glib/gutils.h +490 -0
  225. data/vendor/local/include/glib-2.0/glib/gvariant.h +224 -0
  226. data/vendor/local/include/glib-2.0/glib/gvarianttype.h +305 -0
  227. data/vendor/local/include/glib-2.0/glib/gwin32.h +114 -0
  228. data/vendor/local/include/glib-2.0/glib-object.h +41 -0
  229. data/vendor/local/include/glib-2.0/glib.h +97 -0
  230. data/vendor/local/include/glib-2.0/gmodule.h +101 -0
  231. data/vendor/local/include/glib-2.0/gobject/gboxed.h +236 -0
  232. data/vendor/local/include/glib-2.0/gobject/gclosure.h +251 -0
  233. data/vendor/local/include/glib-2.0/gobject/genums.h +261 -0
  234. data/vendor/local/include/glib-2.0/gobject/gmarshal.h +169 -0
  235. data/vendor/local/include/glib-2.0/gobject/gobject.h +562 -0
  236. data/vendor/local/include/glib-2.0/gobject/gobjectnotifyqueue.c +166 -0
  237. data/vendor/local/include/glib-2.0/gobject/gparam.h +410 -0
  238. data/vendor/local/include/glib-2.0/gobject/gparamspecs.h +1083 -0
  239. data/vendor/local/include/glib-2.0/gobject/gsignal.h +509 -0
  240. data/vendor/local/include/glib-2.0/gobject/gsourceclosure.h +51 -0
  241. data/vendor/local/include/glib-2.0/gobject/gtype.h +1608 -0
  242. data/vendor/local/include/glib-2.0/gobject/gtypemodule.h +263 -0
  243. data/vendor/local/include/glib-2.0/gobject/gtypeplugin.h +134 -0
  244. data/vendor/local/include/glib-2.0/gobject/gvalue.h +159 -0
  245. data/vendor/local/include/glib-2.0/gobject/gvaluearray.h +77 -0
  246. data/vendor/local/include/glib-2.0/gobject/gvaluecollector.h +222 -0
  247. data/vendor/local/include/glib-2.0/gobject/gvaluetypes.h +243 -0
  248. data/vendor/local/include/libintl.h +464 -0
  249. data/vendor/local/lib/GNU.Gettext.dll +0 -0
  250. data/vendor/local/lib/atk-1.0.def +237 -0
  251. data/vendor/local/lib/atk-1.0.lib +0 -0
  252. data/vendor/local/lib/gio-2.0.def +800 -0
  253. data/vendor/local/lib/gio-2.0.lib +0 -0
  254. data/vendor/local/lib/glib-2.0/include/glibconfig.h +284 -0
  255. data/vendor/local/lib/glib-2.0.def +1381 -0
  256. data/vendor/local/lib/glib-2.0.lib +0 -0
  257. data/vendor/local/lib/gmodule-2.0.def +11 -0
  258. data/vendor/local/lib/gmodule-2.0.lib +0 -0
  259. data/vendor/local/lib/gobject-2.0.def +349 -0
  260. data/vendor/local/lib/gobject-2.0.lib +0 -0
  261. data/vendor/local/lib/gthread-2.0.def +3 -0
  262. data/vendor/local/lib/gthread-2.0.lib +0 -0
  263. data/vendor/local/lib/intl.lib +0 -0
  264. data/vendor/local/lib/libasprintf.dll.a +0 -0
  265. data/vendor/local/lib/libatk-1.0.dll.a +0 -0
  266. data/vendor/local/lib/libgio-2.0.dll.a +0 -0
  267. data/vendor/local/lib/libglib-2.0.dll.a +0 -0
  268. data/vendor/local/lib/libgmodule-2.0.dll.a +0 -0
  269. data/vendor/local/lib/libgobject-2.0.dll.a +0 -0
  270. data/vendor/local/lib/libgthread-2.0.dll.a +0 -0
  271. data/vendor/local/lib/libintl.def +31 -0
  272. data/vendor/local/lib/libintl.dll.a +0 -0
  273. data/vendor/local/lib/pkgconfig/atk.pc +11 -0
  274. data/vendor/local/lib/pkgconfig/gio-2.0.pc +14 -0
  275. data/vendor/local/lib/pkgconfig/glib-2.0.pc +15 -0
  276. data/vendor/local/lib/pkgconfig/gmodule-2.0.pc +14 -0
  277. data/vendor/local/lib/pkgconfig/gmodule-no-export-2.0.pc +14 -0
  278. data/vendor/local/lib/pkgconfig/gobject-2.0.pc +11 -0
  279. data/vendor/local/lib/pkgconfig/gthread-2.0.pc +11 -0
  280. data/vendor/local/manifest/atk-dev_1.30.0-2_win32.mft +37 -0
  281. data/vendor/local/manifest/atk_1.30.0-2_win32.mft +93 -0
  282. data/vendor/local/manifest/gettext-runtime-dev_0.18.1.1-2_win32.mft +81 -0
  283. data/vendor/local/manifest/gettext-runtime_0.18.1.1-2_win32.mft +3 -0
  284. data/vendor/local/manifest/glib-dev_2.24.2-2_win32.mft +491 -0
  285. data/vendor/local/manifest/glib_2.24.2-2_win32.mft +101 -0
  286. data/vendor/local/share/aclocal/glib-2.0.m4 +211 -0
  287. data/vendor/local/share/aclocal/glib-gettext.m4 +432 -0
  288. data/vendor/local/share/doc/gettext/bind_textdomain_codeset.3.html +165 -0
  289. data/vendor/local/share/doc/gettext/bindtextdomain.3.html +160 -0
  290. data/vendor/local/share/doc/gettext/csharpdoc/GNU_Gettext.html +8 -0
  291. data/vendor/local/share/doc/gettext/csharpdoc/GNU_Gettext_GettextResourceManager.html +305 -0
  292. data/vendor/local/share/doc/gettext/csharpdoc/GNU_Gettext_GettextResourceSet.html +356 -0
  293. data/vendor/local/share/doc/gettext/csharpdoc/begin.html +11 -0
  294. data/vendor/local/share/doc/gettext/csharpdoc/index.html +10 -0
  295. data/vendor/local/share/doc/gettext/csharpdoc/namespaces.html +6 -0
  296. data/vendor/local/share/doc/gettext/envsubst.1.html +213 -0
  297. data/vendor/local/share/doc/gettext/gettext.1.html +266 -0
  298. data/vendor/local/share/doc/gettext/gettext.3.html +186 -0
  299. data/vendor/local/share/doc/gettext/ngettext.1.html +280 -0
  300. data/vendor/local/share/doc/gettext/ngettext.3.html +143 -0
  301. data/vendor/local/share/doc/gettext/textdomain.3.html +150 -0
  302. data/vendor/local/share/doc/glib-2.24.2/COPYING +482 -0
  303. data/vendor/local/share/doc/glib-dev-2.24.2/COPYING +482 -0
  304. data/vendor/local/share/doc/libasprintf/autosprintf_all.html +174 -0
  305. data/vendor/local/share/glib-2.0/gdb/glib.py +252 -0
  306. data/vendor/local/share/glib-2.0/gdb/gobject.py +305 -0
  307. data/vendor/local/share/glib-2.0/gettext/mkinstalldirs +111 -0
  308. data/vendor/local/share/glib-2.0/gettext/po/Makefile.in.in +277 -0
  309. data/vendor/local/share/gtk-doc/html/gio/GAppInfo.html +1390 -0
  310. data/vendor/local/share/gtk-doc/html/gio/GAsyncInitable.html +531 -0
  311. data/vendor/local/share/gtk-doc/html/gio/GAsyncResult.html +343 -0
  312. data/vendor/local/share/gtk-doc/html/gio/GBufferedInputStream.html +568 -0
  313. data/vendor/local/share/gtk-doc/html/gio/GBufferedOutputStream.html +295 -0
  314. data/vendor/local/share/gtk-doc/html/gio/GCancellable.html +620 -0
  315. data/vendor/local/share/gtk-doc/html/gio/GCharsetConverter.html +245 -0
  316. data/vendor/local/share/gtk-doc/html/gio/GConverter.html +388 -0
  317. data/vendor/local/share/gtk-doc/html/gio/GDataInputStream.html +993 -0
  318. data/vendor/local/share/gtk-doc/html/gio/GDataOutputStream.html +544 -0
  319. data/vendor/local/share/gtk-doc/html/gio/GDrive.html +1416 -0
  320. data/vendor/local/share/gtk-doc/html/gio/GEmblem.html +272 -0
  321. data/vendor/local/share/gtk-doc/html/gio/GEmblemedIcon.html +206 -0
  322. data/vendor/local/share/gtk-doc/html/gio/GFile.html +7450 -0
  323. data/vendor/local/share/gtk-doc/html/gio/GFileDescriptorBased.html +115 -0
  324. data/vendor/local/share/gtk-doc/html/gio/GFileEnumerator.html +520 -0
  325. data/vendor/local/share/gtk-doc/html/gio/GFileIOStream.html +312 -0
  326. data/vendor/local/share/gtk-doc/html/gio/GFileIcon.html +155 -0
  327. data/vendor/local/share/gtk-doc/html/gio/GFileInfo.html +3116 -0
  328. data/vendor/local/share/gtk-doc/html/gio/GFileInputStream.html +262 -0
  329. data/vendor/local/share/gtk-doc/html/gio/GFileMonitor.html +353 -0
  330. data/vendor/local/share/gtk-doc/html/gio/GFileOutputStream.html +301 -0
  331. data/vendor/local/share/gtk-doc/html/gio/GFilenameCompleter.html +217 -0
  332. data/vendor/local/share/gtk-doc/html/gio/GFilterInputStream.html +182 -0
  333. data/vendor/local/share/gtk-doc/html/gio/GFilterOutputStream.html +183 -0
  334. data/vendor/local/share/gtk-doc/html/gio/GIOModule.html +261 -0
  335. data/vendor/local/share/gtk-doc/html/gio/GIOStream.html +479 -0
  336. data/vendor/local/share/gtk-doc/html/gio/GIcon.html +331 -0
  337. data/vendor/local/share/gtk-doc/html/gio/GInetAddress.html +717 -0
  338. data/vendor/local/share/gtk-doc/html/gio/GInetSocketAddress.html +195 -0
  339. data/vendor/local/share/gtk-doc/html/gio/GInitable.html +388 -0
  340. data/vendor/local/share/gtk-doc/html/gio/GInputStream.html +808 -0
  341. data/vendor/local/share/gtk-doc/html/gio/GLoadableIcon.html +301 -0
  342. data/vendor/local/share/gtk-doc/html/gio/GMemoryInputStream.html +185 -0
  343. data/vendor/local/share/gtk-doc/html/gio/GMemoryOutputStream.html +362 -0
  344. data/vendor/local/share/gtk-doc/html/gio/GMount.html +1465 -0
  345. data/vendor/local/share/gtk-doc/html/gio/GMountOperation.html +848 -0
  346. data/vendor/local/share/gtk-doc/html/gio/GNetworkAddress.html +263 -0
  347. data/vendor/local/share/gtk-doc/html/gio/GNetworkService.html +248 -0
  348. data/vendor/local/share/gtk-doc/html/gio/GOutputStream.html +1006 -0
  349. data/vendor/local/share/gtk-doc/html/gio/GResolver.html +787 -0
  350. data/vendor/local/share/gtk-doc/html/gio/GSeekable.html +350 -0
  351. data/vendor/local/share/gtk-doc/html/gio/GSimpleAsyncResult.html +979 -0
  352. data/vendor/local/share/gtk-doc/html/gio/GSocket.html +2152 -0
  353. data/vendor/local/share/gtk-doc/html/gio/GSocketAddress.html +297 -0
  354. data/vendor/local/share/gtk-doc/html/gio/GSocketClient.html +930 -0
  355. data/vendor/local/share/gtk-doc/html/gio/GSocketConnectable.html +428 -0
  356. data/vendor/local/share/gtk-doc/html/gio/GSocketConnection.html +548 -0
  357. data/vendor/local/share/gtk-doc/html/gio/GSocketControlMessage.html +274 -0
  358. data/vendor/local/share/gtk-doc/html/gio/GSocketListener.html +741 -0
  359. data/vendor/local/share/gtk-doc/html/gio/GSocketService.html +258 -0
  360. data/vendor/local/share/gtk-doc/html/gio/GThemedIcon.html +377 -0
  361. data/vendor/local/share/gtk-doc/html/gio/GThreadedSocketService.html +197 -0
  362. data/vendor/local/share/gtk-doc/html/gio/GUnixFDList.html +381 -0
  363. data/vendor/local/share/gtk-doc/html/gio/GUnixFDMessage.html +280 -0
  364. data/vendor/local/share/gtk-doc/html/gio/GUnixInputStream.html +237 -0
  365. data/vendor/local/share/gtk-doc/html/gio/GUnixOutputStream.html +237 -0
  366. data/vendor/local/share/gtk-doc/html/gio/GUnixSocketAddress.html +306 -0
  367. data/vendor/local/share/gtk-doc/html/gio/GVfs.html +274 -0
  368. data/vendor/local/share/gtk-doc/html/gio/GVolume.html +1028 -0
  369. data/vendor/local/share/gtk-doc/html/gio/GVolumeMonitor.html +709 -0
  370. data/vendor/local/share/gtk-doc/html/gio/GZlibCompressor.html +180 -0
  371. data/vendor/local/share/gtk-doc/html/gio/GZlibDecompressor.html +128 -0
  372. data/vendor/local/share/gtk-doc/html/gio/api-index-2-18.html +153 -0
  373. data/vendor/local/share/gtk-doc/html/gio/api-index-2-20.html +155 -0
  374. data/vendor/local/share/gtk-doc/html/gio/api-index-2-22.html +1088 -0
  375. data/vendor/local/share/gtk-doc/html/gio/api-index-2-24.html +206 -0
  376. data/vendor/local/share/gtk-doc/html/gio/api-index-deprecated.html +97 -0
  377. data/vendor/local/share/gtk-doc/html/gio/api-index-full.html +4499 -0
  378. data/vendor/local/share/gtk-doc/html/gio/async.html +44 -0
  379. data/vendor/local/share/gtk-doc/html/gio/ch01.html +171 -0
  380. data/vendor/local/share/gtk-doc/html/gio/ch02.html +45 -0
  381. data/vendor/local/share/gtk-doc/html/gio/ch03.html +80 -0
  382. data/vendor/local/share/gtk-doc/html/gio/ch19.html +75 -0
  383. data/vendor/local/share/gtk-doc/html/gio/ch20.html +217 -0
  384. data/vendor/local/share/gtk-doc/html/gio/ch20s02.html +41 -0
  385. data/vendor/local/share/gtk-doc/html/gio/ch20s03.html +39 -0
  386. data/vendor/local/share/gtk-doc/html/gio/conversion.html +44 -0
  387. data/vendor/local/share/gtk-doc/html/gio/extending-gio.html +96 -0
  388. data/vendor/local/share/gtk-doc/html/gio/extending.html +41 -0
  389. data/vendor/local/share/gtk-doc/html/gio/failable_initialization.html +38 -0
  390. data/vendor/local/share/gtk-doc/html/gio/file_mon.html +33 -0
  391. data/vendor/local/share/gtk-doc/html/gio/file_ops.html +50 -0
  392. data/vendor/local/share/gtk-doc/html/gio/gio-Desktop-file-based-GAppInfo.html +339 -0
  393. data/vendor/local/share/gtk-doc/html/gio/gio-Extension-Points.html +465 -0
  394. data/vendor/local/share/gtk-doc/html/gio/gio-GContentType.html +381 -0
  395. data/vendor/local/share/gtk-doc/html/gio/gio-GConverterInputstream.html +163 -0
  396. data/vendor/local/share/gtk-doc/html/gio/gio-GConverterOutputstream.html +163 -0
  397. data/vendor/local/share/gtk-doc/html/gio/gio-GFileAttribute.html +927 -0
  398. data/vendor/local/share/gtk-doc/html/gio/gio-GIOError.html +328 -0
  399. data/vendor/local/share/gtk-doc/html/gio/gio-GIOScheduler.html +297 -0
  400. data/vendor/local/share/gtk-doc/html/gio/gio-GSrvTarget.html +313 -0
  401. data/vendor/local/share/gtk-doc/html/gio/gio-Unix-Mounts.html +918 -0
  402. data/vendor/local/share/gtk-doc/html/gio/gio-hierarchy.html +107 -0
  403. data/vendor/local/share/gtk-doc/html/gio/gio.devhelp +1235 -0
  404. data/vendor/local/share/gtk-doc/html/gio/gio.devhelp2 +1384 -0
  405. data/vendor/local/share/gtk-doc/html/gio/gvfs-overview.png +0 -0
  406. data/vendor/local/share/gtk-doc/html/gio/highlevel-socket.html +47 -0
  407. data/vendor/local/share/gtk-doc/html/gio/home.png +0 -0
  408. data/vendor/local/share/gtk-doc/html/gio/icons.html +50 -0
  409. data/vendor/local/share/gtk-doc/html/gio/index.html +318 -0
  410. data/vendor/local/share/gtk-doc/html/gio/index.sgml +1795 -0
  411. data/vendor/local/share/gtk-doc/html/gio/left.png +0 -0
  412. data/vendor/local/share/gtk-doc/html/gio/migrating.html +42 -0
  413. data/vendor/local/share/gtk-doc/html/gio/networking.html +57 -0
  414. data/vendor/local/share/gtk-doc/html/gio/pt01.html +39 -0
  415. data/vendor/local/share/gtk-doc/html/gio/pt02.html +293 -0
  416. data/vendor/local/share/gtk-doc/html/gio/resolver.html +47 -0
  417. data/vendor/local/share/gtk-doc/html/gio/right.png +0 -0
  418. data/vendor/local/share/gtk-doc/html/gio/streaming.html +92 -0
  419. data/vendor/local/share/gtk-doc/html/gio/style.css +257 -0
  420. data/vendor/local/share/gtk-doc/html/gio/types.html +41 -0
  421. data/vendor/local/share/gtk-doc/html/gio/up.png +0 -0
  422. data/vendor/local/share/gtk-doc/html/gio/utils.html +33 -0
  423. data/vendor/local/share/gtk-doc/html/gio/volume_mon.html +47 -0
  424. data/vendor/local/share/gtk-doc/html/glib/api-index-2-10.html +180 -0
  425. data/vendor/local/share/gtk-doc/html/glib/api-index-2-12.html +312 -0
  426. data/vendor/local/share/gtk-doc/html/glib/api-index-2-14.html +563 -0
  427. data/vendor/local/share/gtk-doc/html/glib/api-index-2-16.html +362 -0
  428. data/vendor/local/share/gtk-doc/html/glib/api-index-2-18.html +102 -0
  429. data/vendor/local/share/gtk-doc/html/glib/api-index-2-2.html +124 -0
  430. data/vendor/local/share/gtk-doc/html/glib/api-index-2-20.html +83 -0
  431. data/vendor/local/share/gtk-doc/html/glib/api-index-2-22.html +194 -0
  432. data/vendor/local/share/gtk-doc/html/glib/api-index-2-24.html +419 -0
  433. data/vendor/local/share/gtk-doc/html/glib/api-index-2-4.html +389 -0
  434. data/vendor/local/share/gtk-doc/html/glib/api-index-2-6.html +413 -0
  435. data/vendor/local/share/gtk-doc/html/glib/api-index-2-8.html +158 -0
  436. data/vendor/local/share/gtk-doc/html/glib/api-index-deprecated.html +340 -0
  437. data/vendor/local/share/gtk-doc/html/glib/api-index-full.html +7835 -0
  438. data/vendor/local/share/gtk-doc/html/glib/file-name-encodings.png +0 -0
  439. data/vendor/local/share/gtk-doc/html/glib/glib-Arrays.html +893 -0
  440. data/vendor/local/share/gtk-doc/html/glib/glib-Asynchronous-Queues.html +818 -0
  441. data/vendor/local/share/gtk-doc/html/glib/glib-Atomic-Operations.html +413 -0
  442. data/vendor/local/share/gtk-doc/html/glib/glib-Automatic-String-Completion.html +430 -0
  443. data/vendor/local/share/gtk-doc/html/glib/glib-Balanced-Binary-Trees.html +802 -0
  444. data/vendor/local/share/gtk-doc/html/glib/glib-Base64-Encoding.html +372 -0
  445. data/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html +500 -0
  446. data/vendor/local/share/gtk-doc/html/glib/glib-Bookmark-file-parser.html +2054 -0
  447. data/vendor/local/share/gtk-doc/html/glib/glib-Byte-Arrays.html +560 -0
  448. data/vendor/local/share/gtk-doc/html/glib/glib-Byte-Order-Macros.html +1686 -0
  449. data/vendor/local/share/gtk-doc/html/glib/glib-Caches.html +398 -0
  450. data/vendor/local/share/gtk-doc/html/glib/glib-Character-Set-Conversion.html +1187 -0
  451. data/vendor/local/share/gtk-doc/html/glib/glib-Commandline-option-parser.html +1665 -0
  452. data/vendor/local/share/gtk-doc/html/glib/glib-Data-Checksums.html +460 -0
  453. data/vendor/local/share/gtk-doc/html/glib/glib-Datasets.html +528 -0
  454. data/vendor/local/share/gtk-doc/html/glib/glib-Date-and-Time-Functions.html +2042 -0
  455. data/vendor/local/share/gtk-doc/html/glib/glib-Double-ended-Queues.html +1278 -0
  456. data/vendor/local/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html +1406 -0
  457. data/vendor/local/share/gtk-doc/html/glib/glib-Dynamic-Loading-of-Modules.html +548 -0
  458. data/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html +1023 -0
  459. data/vendor/local/share/gtk-doc/html/glib/glib-File-Utilities.html +1810 -0
  460. data/vendor/local/share/gtk-doc/html/glib/glib-GVariant.html +3798 -0
  461. data/vendor/local/share/gtk-doc/html/glib/glib-GVariantType.html +1815 -0
  462. data/vendor/local/share/gtk-doc/html/glib/glib-Glob-style-pattern-matching.html +295 -0
  463. data/vendor/local/share/gtk-doc/html/glib/glib-Hash-Tables.html +1512 -0
  464. data/vendor/local/share/gtk-doc/html/glib/glib-Hook-Functions.html +1367 -0
  465. data/vendor/local/share/gtk-doc/html/glib/glib-Hostname-Utilities.html +229 -0
  466. data/vendor/local/share/gtk-doc/html/glib/glib-I18N.html +629 -0
  467. data/vendor/local/share/gtk-doc/html/glib/glib-IO-Channels.html +2196 -0
  468. data/vendor/local/share/gtk-doc/html/glib/glib-Key-value-file-parser.html +2556 -0
  469. data/vendor/local/share/gtk-doc/html/glib/glib-Keyed-Data-Lists.html +612 -0
  470. data/vendor/local/share/gtk-doc/html/glib/glib-Lexical-Scanner.html +1451 -0
  471. data/vendor/local/share/gtk-doc/html/glib/glib-Limits-of-Basic-Types.html +389 -0
  472. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html +1029 -0
  473. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocators.html +141 -0
  474. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Chunks.html +706 -0
  475. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Slices.html +510 -0
  476. data/vendor/local/share/gtk-doc/html/glib/glib-Message-Logging.html +703 -0
  477. data/vendor/local/share/gtk-doc/html/glib/glib-Miscellaneous-Macros.html +1045 -0
  478. data/vendor/local/share/gtk-doc/html/glib/glib-Miscellaneous-Utility-Functions.html +1523 -0
  479. data/vendor/local/share/gtk-doc/html/glib/glib-N-ary-Trees.html +1466 -0
  480. data/vendor/local/share/gtk-doc/html/glib/glib-Numerical-Definitions.html +204 -0
  481. data/vendor/local/share/gtk-doc/html/glib/glib-Perl-compatible-regular-expressions.html +2648 -0
  482. data/vendor/local/share/gtk-doc/html/glib/glib-Pointer-Arrays.html +752 -0
  483. data/vendor/local/share/gtk-doc/html/glib/glib-Quarks.html +269 -0
  484. data/vendor/local/share/gtk-doc/html/glib/glib-Random-Numbers.html +578 -0
  485. data/vendor/local/share/gtk-doc/html/glib/glib-Relations-and-Tuples.html +483 -0
  486. data/vendor/local/share/gtk-doc/html/glib/glib-Sequences.html +1353 -0
  487. data/vendor/local/share/gtk-doc/html/glib/glib-Shell-related-Utilities.html +238 -0
  488. data/vendor/local/share/gtk-doc/html/glib/glib-Simple-XML-Subset-Parser.html +1283 -0
  489. data/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html +1212 -0
  490. data/vendor/local/share/gtk-doc/html/glib/glib-Spawning-Processes.html +924 -0
  491. data/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html +466 -0
  492. data/vendor/local/share/gtk-doc/html/glib/glib-String-Chunks.html +301 -0
  493. data/vendor/local/share/gtk-doc/html/glib/glib-String-Utility-Functions.html +2947 -0
  494. data/vendor/local/share/gtk-doc/html/glib/glib-Strings.html +1290 -0
  495. data/vendor/local/share/gtk-doc/html/glib/glib-Testing.html +1719 -0
  496. data/vendor/local/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html +3379 -0
  497. data/vendor/local/share/gtk-doc/html/glib/glib-Thread-Pools.html +606 -0
  498. data/vendor/local/share/gtk-doc/html/glib/glib-Threads.html +3411 -0
  499. data/vendor/local/share/gtk-doc/html/glib/glib-Timers.html +245 -0
  500. data/vendor/local/share/gtk-doc/html/glib/glib-Trash-Stacks.html +188 -0
  501. data/vendor/local/share/gtk-doc/html/glib/glib-Type-Conversion-Macros.html +263 -0
  502. data/vendor/local/share/gtk-doc/html/glib/glib-URI-Functions.html +314 -0
  503. data/vendor/local/share/gtk-doc/html/glib/glib-Unicode-Manipulation.html +3356 -0
  504. data/vendor/local/share/gtk-doc/html/glib/glib-Version-Information.html +150 -0
  505. data/vendor/local/share/gtk-doc/html/glib/glib-Warnings-and-Assertions.html +438 -0
  506. data/vendor/local/share/gtk-doc/html/glib/glib-Windows-Compatibility-Functions.html +476 -0
  507. data/vendor/local/share/gtk-doc/html/glib/glib-building.html +438 -0
  508. data/vendor/local/share/gtk-doc/html/glib/glib-changes.html +159 -0
  509. data/vendor/local/share/gtk-doc/html/glib/glib-compiling.html +118 -0
  510. data/vendor/local/share/gtk-doc/html/glib/glib-core.html +64 -0
  511. data/vendor/local/share/gtk-doc/html/glib/glib-cross-compiling.html +160 -0
  512. data/vendor/local/share/gtk-doc/html/glib/glib-data-types.html +120 -0
  513. data/vendor/local/share/gtk-doc/html/glib/glib-fundamentals.html +59 -0
  514. data/vendor/local/share/gtk-doc/html/glib/glib-gettextize.html +93 -0
  515. data/vendor/local/share/gtk-doc/html/glib/glib-regex-syntax.html +2395 -0
  516. data/vendor/local/share/gtk-doc/html/glib/glib-resources.html +121 -0
  517. data/vendor/local/share/gtk-doc/html/glib/glib-running.html +302 -0
  518. data/vendor/local/share/gtk-doc/html/glib/glib-utilities.html +112 -0
  519. data/vendor/local/share/gtk-doc/html/glib/glib.devhelp +2084 -0
  520. data/vendor/local/share/gtk-doc/html/glib/glib.devhelp2 +2556 -0
  521. data/vendor/local/share/gtk-doc/html/glib/glib.html +80 -0
  522. data/vendor/local/share/gtk-doc/html/glib/gtester-report.html +72 -0
  523. data/vendor/local/share/gtk-doc/html/glib/gtester.html +131 -0
  524. data/vendor/local/share/gtk-doc/html/glib/gvariant-format-strings.html +1171 -0
  525. data/vendor/local/share/gtk-doc/html/glib/home.png +0 -0
  526. data/vendor/local/share/gtk-doc/html/glib/index.html +336 -0
  527. data/vendor/local/share/gtk-doc/html/glib/index.sgml +2717 -0
  528. data/vendor/local/share/gtk-doc/html/glib/left.png +0 -0
  529. data/vendor/local/share/gtk-doc/html/glib/mainloop-states.gif +0 -0
  530. data/vendor/local/share/gtk-doc/html/glib/right.png +0 -0
  531. data/vendor/local/share/gtk-doc/html/glib/style.css +257 -0
  532. data/vendor/local/share/gtk-doc/html/glib/tools.html +41 -0
  533. data/vendor/local/share/gtk-doc/html/glib/up.png +0 -0
  534. data/vendor/local/share/gtk-doc/html/gobject/GTypeModule.html +710 -0
  535. data/vendor/local/share/gtk-doc/html/gobject/GTypePlugin.html +453 -0
  536. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-10.html +85 -0
  537. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-12.html +55 -0
  538. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-14.html +51 -0
  539. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-18.html +46 -0
  540. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-2.html +38 -0
  541. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-22.html +46 -0
  542. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-24.html +72 -0
  543. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-4.html +178 -0
  544. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-6.html +42 -0
  545. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-8.html +42 -0
  546. data/vendor/local/share/gtk-doc/html/gobject/api-index-deprecated.html +50 -0
  547. data/vendor/local/share/gtk-doc/html/gobject/api-index-full.html +2577 -0
  548. data/vendor/local/share/gtk-doc/html/gobject/ch01s02.html +136 -0
  549. data/vendor/local/share/gtk-doc/html/gobject/ch06s03.html +113 -0
  550. data/vendor/local/share/gtk-doc/html/gobject/chapter-gobject.html +293 -0
  551. data/vendor/local/share/gtk-doc/html/gobject/chapter-gtype.html +263 -0
  552. data/vendor/local/share/gtk-doc/html/gobject/chapter-intro.html +92 -0
  553. data/vendor/local/share/gtk-doc/html/gobject/chapter-signal.html +214 -0
  554. data/vendor/local/share/gtk-doc/html/gobject/glib-genmarshal.html +355 -0
  555. data/vendor/local/share/gtk-doc/html/gobject/glib-mkenums.html +295 -0
  556. data/vendor/local/share/gtk-doc/html/gobject/glue.png +0 -0
  557. data/vendor/local/share/gtk-doc/html/gobject/gobject-Boxed-Types.html +406 -0
  558. data/vendor/local/share/gtk-doc/html/gobject/gobject-Closures.html +2355 -0
  559. data/vendor/local/share/gtk-doc/html/gobject/gobject-Enumeration-and-Flag-Types.html +847 -0
  560. data/vendor/local/share/gtk-doc/html/gobject/gobject-GParamSpec.html +1423 -0
  561. data/vendor/local/share/gtk-doc/html/gobject/gobject-Generic-values.html +776 -0
  562. data/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html +2741 -0
  563. data/vendor/local/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html +5242 -0
  564. data/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html +2609 -0
  565. data/vendor/local/share/gtk-doc/html/gobject/gobject-Type-Information.html +4227 -0
  566. data/vendor/local/share/gtk-doc/html/gobject/gobject-Value-arrays.html +413 -0
  567. data/vendor/local/share/gtk-doc/html/gobject/gobject-Varargs-Value-Collection.html +230 -0
  568. data/vendor/local/share/gtk-doc/html/gobject/gobject-memory.html +234 -0
  569. data/vendor/local/share/gtk-doc/html/gobject/gobject-properties.html +270 -0
  570. data/vendor/local/share/gtk-doc/html/gobject/gobject-query.html +117 -0
  571. data/vendor/local/share/gtk-doc/html/gobject/gobject.devhelp +723 -0
  572. data/vendor/local/share/gtk-doc/html/gobject/gobject.devhelp2 +757 -0
  573. data/vendor/local/share/gtk-doc/html/gobject/gtype-conventions.html +143 -0
  574. data/vendor/local/share/gtk-doc/html/gobject/gtype-instantiable-classed.html +287 -0
  575. data/vendor/local/share/gtk-doc/html/gobject/gtype-non-instantiable-classed.html +316 -0
  576. data/vendor/local/share/gtk-doc/html/gobject/gtype-non-instantiable.html +76 -0
  577. data/vendor/local/share/gtk-doc/html/gobject/home.png +0 -0
  578. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-chainup.html +100 -0
  579. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-code.html +86 -0
  580. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-construction.html +113 -0
  581. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-destruction.html +122 -0
  582. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-methods.html +257 -0
  583. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject.html +283 -0
  584. data/vendor/local/share/gtk-doc/html/gobject/howto-interface-implement.html +125 -0
  585. data/vendor/local/share/gtk-doc/html/gobject/howto-interface-properties.html +167 -0
  586. data/vendor/local/share/gtk-doc/html/gobject/howto-interface.html +160 -0
  587. data/vendor/local/share/gtk-doc/html/gobject/howto-signals.html +121 -0
  588. data/vendor/local/share/gtk-doc/html/gobject/index.html +187 -0
  589. data/vendor/local/share/gtk-doc/html/gobject/index.sgml +734 -0
  590. data/vendor/local/share/gtk-doc/html/gobject/left.png +0 -0
  591. data/vendor/local/share/gtk-doc/html/gobject/pr01.html +72 -0
  592. data/vendor/local/share/gtk-doc/html/gobject/pt01.html +80 -0
  593. data/vendor/local/share/gtk-doc/html/gobject/pt02.html +66 -0
  594. data/vendor/local/share/gtk-doc/html/gobject/pt03.html +55 -0
  595. data/vendor/local/share/gtk-doc/html/gobject/right.png +0 -0
  596. data/vendor/local/share/gtk-doc/html/gobject/rn01.html +82 -0
  597. data/vendor/local/share/gtk-doc/html/gobject/rn02.html +47 -0
  598. data/vendor/local/share/gtk-doc/html/gobject/signal.html +377 -0
  599. data/vendor/local/share/gtk-doc/html/gobject/style.css +257 -0
  600. data/vendor/local/share/gtk-doc/html/gobject/tools-ginspector.html +35 -0
  601. data/vendor/local/share/gtk-doc/html/gobject/tools-gob.html +40 -0
  602. data/vendor/local/share/gtk-doc/html/gobject/tools-gtkdoc.html +63 -0
  603. data/vendor/local/share/gtk-doc/html/gobject/tools-refdb.html +55 -0
  604. data/vendor/local/share/gtk-doc/html/gobject/tools-vala.html +43 -0
  605. data/vendor/local/share/gtk-doc/html/gobject/up.png +0 -0
  606. data/vendor/local/share/locale/af/LC_MESSAGES/atk10.mo +0 -0
  607. data/vendor/local/share/locale/af/LC_MESSAGES/glib20.mo +0 -0
  608. data/vendor/local/share/locale/am/LC_MESSAGES/atk10.mo +0 -0
  609. data/vendor/local/share/locale/am/LC_MESSAGES/glib20.mo +0 -0
  610. data/vendor/local/share/locale/ar/LC_MESSAGES/atk10.mo +0 -0
  611. data/vendor/local/share/locale/ar/LC_MESSAGES/glib20.mo +0 -0
  612. data/vendor/local/share/locale/as/LC_MESSAGES/atk10.mo +0 -0
  613. data/vendor/local/share/locale/as/LC_MESSAGES/glib20.mo +0 -0
  614. data/vendor/local/share/locale/ast/LC_MESSAGES/atk10.mo +0 -0
  615. data/vendor/local/share/locale/ast/LC_MESSAGES/glib20.mo +0 -0
  616. data/vendor/local/share/locale/az/LC_MESSAGES/atk10.mo +0 -0
  617. data/vendor/local/share/locale/az/LC_MESSAGES/glib20.mo +0 -0
  618. data/vendor/local/share/locale/be/LC_MESSAGES/atk10.mo +0 -0
  619. data/vendor/local/share/locale/be/LC_MESSAGES/gettext-runtime.mo +0 -0
  620. data/vendor/local/share/locale/be/LC_MESSAGES/glib20.mo +0 -0
  621. data/vendor/local/share/locale/be@latin/LC_MESSAGES/atk10.mo +0 -0
  622. data/vendor/local/share/locale/be@latin/LC_MESSAGES/glib20.mo +0 -0
  623. data/vendor/local/share/locale/bg/LC_MESSAGES/atk10.mo +0 -0
  624. data/vendor/local/share/locale/bg/LC_MESSAGES/gettext-runtime.mo +0 -0
  625. data/vendor/local/share/locale/bg/LC_MESSAGES/glib20.mo +0 -0
  626. data/vendor/local/share/locale/bn/LC_MESSAGES/atk10.mo +0 -0
  627. data/vendor/local/share/locale/bn/LC_MESSAGES/glib20.mo +0 -0
  628. data/vendor/local/share/locale/bn_IN/LC_MESSAGES/atk10.mo +0 -0
  629. data/vendor/local/share/locale/bn_IN/LC_MESSAGES/glib20.mo +0 -0
  630. data/vendor/local/share/locale/bs/LC_MESSAGES/atk10.mo +0 -0
  631. data/vendor/local/share/locale/bs/LC_MESSAGES/glib20.mo +0 -0
  632. data/vendor/local/share/locale/ca/LC_MESSAGES/atk10.mo +0 -0
  633. data/vendor/local/share/locale/ca/LC_MESSAGES/gettext-runtime.mo +0 -0
  634. data/vendor/local/share/locale/ca/LC_MESSAGES/glib20.mo +0 -0
  635. data/vendor/local/share/locale/ca@valencia/LC_MESSAGES/atk10.mo +0 -0
  636. data/vendor/local/share/locale/ca@valencia/LC_MESSAGES/glib20.mo +0 -0
  637. data/vendor/local/share/locale/cs/LC_MESSAGES/atk10.mo +0 -0
  638. data/vendor/local/share/locale/cs/LC_MESSAGES/gettext-runtime.mo +0 -0
  639. data/vendor/local/share/locale/cs/LC_MESSAGES/glib20.mo +0 -0
  640. data/vendor/local/share/locale/cy/LC_MESSAGES/atk10.mo +0 -0
  641. data/vendor/local/share/locale/cy/LC_MESSAGES/glib20.mo +0 -0
  642. data/vendor/local/share/locale/da/LC_MESSAGES/atk10.mo +0 -0
  643. data/vendor/local/share/locale/da/LC_MESSAGES/gettext-runtime.mo +0 -0
  644. data/vendor/local/share/locale/da/LC_MESSAGES/glib20.mo +0 -0
  645. data/vendor/local/share/locale/de/LC_MESSAGES/atk10.mo +0 -0
  646. data/vendor/local/share/locale/de/LC_MESSAGES/gettext-runtime.mo +0 -0
  647. data/vendor/local/share/locale/de/LC_MESSAGES/glib20.mo +0 -0
  648. data/vendor/local/share/locale/dz/LC_MESSAGES/atk10.mo +0 -0
  649. data/vendor/local/share/locale/dz/LC_MESSAGES/glib20.mo +0 -0
  650. data/vendor/local/share/locale/el/LC_MESSAGES/atk10.mo +0 -0
  651. data/vendor/local/share/locale/el/LC_MESSAGES/gettext-runtime.mo +0 -0
  652. data/vendor/local/share/locale/el/LC_MESSAGES/glib20.mo +0 -0
  653. data/vendor/local/share/locale/en@boldquot/LC_MESSAGES/gettext-runtime.mo +0 -0
  654. data/vendor/local/share/locale/en@quot/LC_MESSAGES/gettext-runtime.mo +0 -0
  655. data/vendor/local/share/locale/en@shaw/LC_MESSAGES/atk10.mo +0 -0
  656. data/vendor/local/share/locale/en@shaw/LC_MESSAGES/glib20.mo +0 -0
  657. data/vendor/local/share/locale/en_CA/LC_MESSAGES/atk10.mo +0 -0
  658. data/vendor/local/share/locale/en_CA/LC_MESSAGES/glib20.mo +0 -0
  659. data/vendor/local/share/locale/en_GB/LC_MESSAGES/atk10.mo +0 -0
  660. data/vendor/local/share/locale/en_GB/LC_MESSAGES/glib20.mo +0 -0
  661. data/vendor/local/share/locale/eo/LC_MESSAGES/atk10.mo +0 -0
  662. data/vendor/local/share/locale/eo/LC_MESSAGES/gettext-runtime.mo +0 -0
  663. data/vendor/local/share/locale/eo/LC_MESSAGES/glib20.mo +0 -0
  664. data/vendor/local/share/locale/es/LC_MESSAGES/atk10.mo +0 -0
  665. data/vendor/local/share/locale/es/LC_MESSAGES/gettext-runtime.mo +0 -0
  666. data/vendor/local/share/locale/es/LC_MESSAGES/glib20.mo +0 -0
  667. data/vendor/local/share/locale/et/LC_MESSAGES/atk10.mo +0 -0
  668. data/vendor/local/share/locale/et/LC_MESSAGES/gettext-runtime.mo +0 -0
  669. data/vendor/local/share/locale/et/LC_MESSAGES/glib20.mo +0 -0
  670. data/vendor/local/share/locale/eu/LC_MESSAGES/atk10.mo +0 -0
  671. data/vendor/local/share/locale/eu/LC_MESSAGES/glib20.mo +0 -0
  672. data/vendor/local/share/locale/fa/LC_MESSAGES/atk10.mo +0 -0
  673. data/vendor/local/share/locale/fa/LC_MESSAGES/glib20.mo +0 -0
  674. data/vendor/local/share/locale/fi/LC_MESSAGES/atk10.mo +0 -0
  675. data/vendor/local/share/locale/fi/LC_MESSAGES/gettext-runtime.mo +0 -0
  676. data/vendor/local/share/locale/fi/LC_MESSAGES/glib20.mo +0 -0
  677. data/vendor/local/share/locale/fr/LC_MESSAGES/atk10.mo +0 -0
  678. data/vendor/local/share/locale/fr/LC_MESSAGES/gettext-runtime.mo +0 -0
  679. data/vendor/local/share/locale/fr/LC_MESSAGES/glib20.mo +0 -0
  680. data/vendor/local/share/locale/ga/LC_MESSAGES/atk10.mo +0 -0
  681. data/vendor/local/share/locale/ga/LC_MESSAGES/gettext-runtime.mo +0 -0
  682. data/vendor/local/share/locale/ga/LC_MESSAGES/glib20.mo +0 -0
  683. data/vendor/local/share/locale/gl/LC_MESSAGES/atk10.mo +0 -0
  684. data/vendor/local/share/locale/gl/LC_MESSAGES/gettext-runtime.mo +0 -0
  685. data/vendor/local/share/locale/gl/LC_MESSAGES/glib20.mo +0 -0
  686. data/vendor/local/share/locale/gu/LC_MESSAGES/atk10.mo +0 -0
  687. data/vendor/local/share/locale/gu/LC_MESSAGES/glib20.mo +0 -0
  688. data/vendor/local/share/locale/he/LC_MESSAGES/atk10.mo +0 -0
  689. data/vendor/local/share/locale/he/LC_MESSAGES/glib20.mo +0 -0
  690. data/vendor/local/share/locale/hi/LC_MESSAGES/atk10.mo +0 -0
  691. data/vendor/local/share/locale/hi/LC_MESSAGES/glib20.mo +0 -0
  692. data/vendor/local/share/locale/hr/LC_MESSAGES/atk10.mo +0 -0
  693. data/vendor/local/share/locale/hr/LC_MESSAGES/glib20.mo +0 -0
  694. data/vendor/local/share/locale/hu/LC_MESSAGES/atk10.mo +0 -0
  695. data/vendor/local/share/locale/hu/LC_MESSAGES/glib20.mo +0 -0
  696. data/vendor/local/share/locale/hy/LC_MESSAGES/glib20.mo +0 -0
  697. data/vendor/local/share/locale/id/LC_MESSAGES/atk10.mo +0 -0
  698. data/vendor/local/share/locale/id/LC_MESSAGES/gettext-runtime.mo +0 -0
  699. data/vendor/local/share/locale/id/LC_MESSAGES/glib20.mo +0 -0
  700. data/vendor/local/share/locale/is/LC_MESSAGES/atk10.mo +0 -0
  701. data/vendor/local/share/locale/is/LC_MESSAGES/glib20.mo +0 -0
  702. data/vendor/local/share/locale/it/LC_MESSAGES/atk10.mo +0 -0
  703. data/vendor/local/share/locale/it/LC_MESSAGES/gettext-runtime.mo +0 -0
  704. data/vendor/local/share/locale/it/LC_MESSAGES/glib20.mo +0 -0
  705. data/vendor/local/share/locale/ja/LC_MESSAGES/atk10.mo +0 -0
  706. data/vendor/local/share/locale/ja/LC_MESSAGES/gettext-runtime.mo +0 -0
  707. data/vendor/local/share/locale/ja/LC_MESSAGES/glib20.mo +0 -0
  708. data/vendor/local/share/locale/ka/LC_MESSAGES/atk10.mo +0 -0
  709. data/vendor/local/share/locale/ka/LC_MESSAGES/glib20.mo +0 -0
  710. data/vendor/local/share/locale/kn/LC_MESSAGES/atk10.mo +0 -0
  711. data/vendor/local/share/locale/kn/LC_MESSAGES/glib20.mo +0 -0
  712. data/vendor/local/share/locale/ko/LC_MESSAGES/atk10.mo +0 -0
  713. data/vendor/local/share/locale/ko/LC_MESSAGES/gettext-runtime.mo +0 -0
  714. data/vendor/local/share/locale/ko/LC_MESSAGES/glib20.mo +0 -0
  715. data/vendor/local/share/locale/ku/LC_MESSAGES/atk10.mo +0 -0
  716. data/vendor/local/share/locale/ku/LC_MESSAGES/glib20.mo +0 -0
  717. data/vendor/local/share/locale/li/LC_MESSAGES/atk10.mo +0 -0
  718. data/vendor/local/share/locale/locale.alias +77 -0
  719. data/vendor/local/share/locale/lt/LC_MESSAGES/atk10.mo +0 -0
  720. data/vendor/local/share/locale/lt/LC_MESSAGES/glib20.mo +0 -0
  721. data/vendor/local/share/locale/lv/LC_MESSAGES/atk10.mo +0 -0
  722. data/vendor/local/share/locale/lv/LC_MESSAGES/glib20.mo +0 -0
  723. data/vendor/local/share/locale/mai/LC_MESSAGES/atk10.mo +0 -0
  724. data/vendor/local/share/locale/mai/LC_MESSAGES/glib20.mo +0 -0
  725. data/vendor/local/share/locale/mg/LC_MESSAGES/glib20.mo +0 -0
  726. data/vendor/local/share/locale/mk/LC_MESSAGES/atk10.mo +0 -0
  727. data/vendor/local/share/locale/mk/LC_MESSAGES/glib20.mo +0 -0
  728. data/vendor/local/share/locale/ml/LC_MESSAGES/atk10.mo +0 -0
  729. data/vendor/local/share/locale/ml/LC_MESSAGES/glib20.mo +0 -0
  730. data/vendor/local/share/locale/mn/LC_MESSAGES/atk10.mo +0 -0
  731. data/vendor/local/share/locale/mn/LC_MESSAGES/glib20.mo +0 -0
  732. data/vendor/local/share/locale/mr/LC_MESSAGES/atk10.mo +0 -0
  733. data/vendor/local/share/locale/mr/LC_MESSAGES/glib20.mo +0 -0
  734. data/vendor/local/share/locale/ms/LC_MESSAGES/atk10.mo +0 -0
  735. data/vendor/local/share/locale/ms/LC_MESSAGES/glib20.mo +0 -0
  736. data/vendor/local/share/locale/nb/LC_MESSAGES/atk10.mo +0 -0
  737. data/vendor/local/share/locale/nb/LC_MESSAGES/gettext-runtime.mo +0 -0
  738. data/vendor/local/share/locale/nb/LC_MESSAGES/glib20.mo +0 -0
  739. data/vendor/local/share/locale/nds/LC_MESSAGES/glib20.mo +0 -0
  740. data/vendor/local/share/locale/ne/LC_MESSAGES/atk10.mo +0 -0
  741. data/vendor/local/share/locale/ne/LC_MESSAGES/glib20.mo +0 -0
  742. data/vendor/local/share/locale/nl/LC_MESSAGES/atk10.mo +0 -0
  743. data/vendor/local/share/locale/nl/LC_MESSAGES/gettext-runtime.mo +0 -0
  744. data/vendor/local/share/locale/nl/LC_MESSAGES/glib20.mo +0 -0
  745. data/vendor/local/share/locale/nn/LC_MESSAGES/atk10.mo +0 -0
  746. data/vendor/local/share/locale/nn/LC_MESSAGES/gettext-runtime.mo +0 -0
  747. data/vendor/local/share/locale/nn/LC_MESSAGES/glib20.mo +0 -0
  748. data/vendor/local/share/locale/oc/LC_MESSAGES/atk10.mo +0 -0
  749. data/vendor/local/share/locale/oc/LC_MESSAGES/glib20.mo +0 -0
  750. data/vendor/local/share/locale/or/LC_MESSAGES/atk10.mo +0 -0
  751. data/vendor/local/share/locale/or/LC_MESSAGES/glib20.mo +0 -0
  752. data/vendor/local/share/locale/pa/LC_MESSAGES/atk10.mo +0 -0
  753. data/vendor/local/share/locale/pa/LC_MESSAGES/glib20.mo +0 -0
  754. data/vendor/local/share/locale/pl/LC_MESSAGES/atk10.mo +0 -0
  755. data/vendor/local/share/locale/pl/LC_MESSAGES/gettext-runtime.mo +0 -0
  756. data/vendor/local/share/locale/pl/LC_MESSAGES/glib20.mo +0 -0
  757. data/vendor/local/share/locale/ps/LC_MESSAGES/atk10.mo +0 -0
  758. data/vendor/local/share/locale/ps/LC_MESSAGES/glib20.mo +0 -0
  759. data/vendor/local/share/locale/pt/LC_MESSAGES/atk10.mo +0 -0
  760. data/vendor/local/share/locale/pt/LC_MESSAGES/gettext-runtime.mo +0 -0
  761. data/vendor/local/share/locale/pt/LC_MESSAGES/glib20.mo +0 -0
  762. data/vendor/local/share/locale/pt_BR/LC_MESSAGES/atk10.mo +0 -0
  763. data/vendor/local/share/locale/pt_BR/LC_MESSAGES/gettext-runtime.mo +0 -0
  764. data/vendor/local/share/locale/pt_BR/LC_MESSAGES/glib20.mo +0 -0
  765. data/vendor/local/share/locale/ro/LC_MESSAGES/atk10.mo +0 -0
  766. data/vendor/local/share/locale/ro/LC_MESSAGES/gettext-runtime.mo +0 -0
  767. data/vendor/local/share/locale/ro/LC_MESSAGES/glib20.mo +0 -0
  768. data/vendor/local/share/locale/ru/LC_MESSAGES/atk10.mo +0 -0
  769. data/vendor/local/share/locale/ru/LC_MESSAGES/gettext-runtime.mo +0 -0
  770. data/vendor/local/share/locale/ru/LC_MESSAGES/glib20.mo +0 -0
  771. data/vendor/local/share/locale/rw/LC_MESSAGES/atk10.mo +0 -0
  772. data/vendor/local/share/locale/rw/LC_MESSAGES/glib20.mo +0 -0
  773. data/vendor/local/share/locale/si/LC_MESSAGES/atk10.mo +0 -0
  774. data/vendor/local/share/locale/si/LC_MESSAGES/glib20.mo +0 -0
  775. data/vendor/local/share/locale/sk/LC_MESSAGES/atk10.mo +0 -0
  776. data/vendor/local/share/locale/sk/LC_MESSAGES/gettext-runtime.mo +0 -0
  777. data/vendor/local/share/locale/sk/LC_MESSAGES/glib20.mo +0 -0
  778. data/vendor/local/share/locale/sl/LC_MESSAGES/atk10.mo +0 -0
  779. data/vendor/local/share/locale/sl/LC_MESSAGES/gettext-runtime.mo +0 -0
  780. data/vendor/local/share/locale/sl/LC_MESSAGES/glib20.mo +0 -0
  781. data/vendor/local/share/locale/sq/LC_MESSAGES/atk10.mo +0 -0
  782. data/vendor/local/share/locale/sq/LC_MESSAGES/glib20.mo +0 -0
  783. data/vendor/local/share/locale/sr/LC_MESSAGES/atk10.mo +0 -0
  784. data/vendor/local/share/locale/sr/LC_MESSAGES/gettext-runtime.mo +0 -0
  785. data/vendor/local/share/locale/sr/LC_MESSAGES/glib20.mo +0 -0
  786. data/vendor/local/share/locale/sr@ije/LC_MESSAGES/atk10.mo +0 -0
  787. data/vendor/local/share/locale/sr@ije/LC_MESSAGES/glib20.mo +0 -0
  788. data/vendor/local/share/locale/sr@latin/LC_MESSAGES/atk10.mo +0 -0
  789. data/vendor/local/share/locale/sr@latin/LC_MESSAGES/glib20.mo +0 -0
  790. data/vendor/local/share/locale/sv/LC_MESSAGES/atk10.mo +0 -0
  791. data/vendor/local/share/locale/sv/LC_MESSAGES/gettext-runtime.mo +0 -0
  792. data/vendor/local/share/locale/sv/LC_MESSAGES/glib20.mo +0 -0
  793. data/vendor/local/share/locale/ta/LC_MESSAGES/atk10.mo +0 -0
  794. data/vendor/local/share/locale/ta/LC_MESSAGES/glib20.mo +0 -0
  795. data/vendor/local/share/locale/te/LC_MESSAGES/atk10.mo +0 -0
  796. data/vendor/local/share/locale/te/LC_MESSAGES/glib20.mo +0 -0
  797. data/vendor/local/share/locale/th/LC_MESSAGES/atk10.mo +0 -0
  798. data/vendor/local/share/locale/th/LC_MESSAGES/glib20.mo +0 -0
  799. data/vendor/local/share/locale/tk/LC_MESSAGES/atk10.mo +0 -0
  800. data/vendor/local/share/locale/tl/LC_MESSAGES/glib20.mo +0 -0
  801. data/vendor/local/share/locale/tr/LC_MESSAGES/atk10.mo +0 -0
  802. data/vendor/local/share/locale/tr/LC_MESSAGES/gettext-runtime.mo +0 -0
  803. data/vendor/local/share/locale/tr/LC_MESSAGES/glib20.mo +0 -0
  804. data/vendor/local/share/locale/tt/LC_MESSAGES/atk10.mo +0 -0
  805. data/vendor/local/share/locale/tt/LC_MESSAGES/glib20.mo +0 -0
  806. data/vendor/local/share/locale/ug/LC_MESSAGES/atk10.mo +0 -0
  807. data/vendor/local/share/locale/uk/LC_MESSAGES/atk10.mo +0 -0
  808. data/vendor/local/share/locale/uk/LC_MESSAGES/gettext-runtime.mo +0 -0
  809. data/vendor/local/share/locale/uk/LC_MESSAGES/glib20.mo +0 -0
  810. data/vendor/local/share/locale/vi/LC_MESSAGES/atk10.mo +0 -0
  811. data/vendor/local/share/locale/vi/LC_MESSAGES/gettext-runtime.mo +0 -0
  812. data/vendor/local/share/locale/vi/LC_MESSAGES/glib20.mo +0 -0
  813. data/vendor/local/share/locale/wa/LC_MESSAGES/atk10.mo +0 -0
  814. data/vendor/local/share/locale/wa/LC_MESSAGES/glib20.mo +0 -0
  815. data/vendor/local/share/locale/xh/LC_MESSAGES/atk10.mo +0 -0
  816. data/vendor/local/share/locale/xh/LC_MESSAGES/glib20.mo +0 -0
  817. data/vendor/local/share/locale/yi/LC_MESSAGES/atk10.mo +0 -0
  818. data/vendor/local/share/locale/yi/LC_MESSAGES/glib20.mo +0 -0
  819. data/vendor/local/share/locale/zh_CN/LC_MESSAGES/atk10.mo +0 -0
  820. data/vendor/local/share/locale/zh_CN/LC_MESSAGES/gettext-runtime.mo +0 -0
  821. data/vendor/local/share/locale/zh_CN/LC_MESSAGES/glib20.mo +0 -0
  822. data/vendor/local/share/locale/zh_HK/LC_MESSAGES/atk10.mo +0 -0
  823. data/vendor/local/share/locale/zh_HK/LC_MESSAGES/gettext-runtime.mo +0 -0
  824. data/vendor/local/share/locale/zh_HK/LC_MESSAGES/glib20.mo +0 -0
  825. data/vendor/local/share/locale/zh_TW/LC_MESSAGES/atk10.mo +0 -0
  826. data/vendor/local/share/locale/zh_TW/LC_MESSAGES/gettext-runtime.mo +0 -0
  827. data/vendor/local/share/locale/zh_TW/LC_MESSAGES/glib20.mo +0 -0
  828. data/vendor/local/share/man/man1/envsubst.1 +54 -0
  829. data/vendor/local/share/man/man1/gettext.1 +69 -0
  830. data/vendor/local/share/man/man1/glib-genmarshal.1 +307 -0
  831. data/vendor/local/share/man/man1/glib-mkenums.1 +234 -0
  832. data/vendor/local/share/man/man1/gobject-query.1 +83 -0
  833. data/vendor/local/share/man/man1/ngettext.1 +68 -0
  834. data/vendor/local/share/man/man3/bind_textdomain_codeset.3 +72 -0
  835. data/vendor/local/share/man/man3/bindtextdomain.3 +69 -0
  836. data/vendor/local/share/man/man3/dcgettext.3 +1 -0
  837. data/vendor/local/share/man/man3/dcngettext.3 +1 -0
  838. data/vendor/local/share/man/man3/dgettext.3 +1 -0
  839. data/vendor/local/share/man/man3/dngettext.3 +1 -0
  840. data/vendor/local/share/man/man3/gettext.3 +99 -0
  841. data/vendor/local/share/man/man3/ngettext.3 +60 -0
  842. data/vendor/local/share/man/man3/textdomain.3 +57 -0
  843. data/vendor/local/src/tml/packaging/atk_1.30.0-2_win32.log +739 -0
  844. data/vendor/local/src/tml/packaging/atk_1.30.0-2_win32.sh +51 -0
  845. data/vendor/local/src/tml/packaging/gettext_0.18.1.1-2_win32.log +10423 -0
  846. data/vendor/local/src/tml/packaging/gettext_0.18.1.1-2_win32.sh +457 -0
  847. data/vendor/local/src/tml/packaging/glib_2.24.2-2_win32.log +2602 -0
  848. data/vendor/local/src/tml/packaging/glib_2.24.2-2_win32.sh +290 -0
  849. metadata +929 -0
data/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html ADDED
@@ -0,0 +1,1023 @@
1
+ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
+ <html>
3
+ <head>
4
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
+ <title>Error Reporting</title>
6
+ <meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
7
+ <link rel="home" href="index.html" title="GLib Reference Manual">
8
+ <link rel="up" href="glib-core.html" title="GLib Core Application Support">
9
+ <link rel="prev" href="glib-IO-Channels.html" title="IO Channels">
10
+ <link rel="next" href="glib-Warnings-and-Assertions.html" title="Message Output and Debugging Functions">
11
+ <meta name="generator" content="GTK-Doc V1.14 (XML mode)">
12
+ <link rel="stylesheet" href="style.css" type="text/css">
13
+ </head>
14
+ <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
+ <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16
+ <tr valign="middle">
17
+ <td><a accesskey="p" href="glib-IO-Channels.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
+ <td><a accesskey="u" href="glib-core.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19
+ <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20
+ <th width="100%" align="center">GLib Reference Manual</th>
21
+ <td><a accesskey="n" href="glib-Warnings-and-Assertions.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22
+ </tr>
23
+ <tr><td colspan="5" class="shortcuts">
24
+ <a href="#glib-Error-Reporting.synopsis" class="shortcut">Top</a>
25
+  | 
26
+ <a href="#glib-Error-Reporting.description" class="shortcut">Description</a>
27
+ </td></tr>
28
+ </table>
29
+ <div class="refentry" title="Error Reporting">
30
+ <a name="glib-Error-Reporting"></a><div class="titlepage"></div>
31
+ <div class="refnamediv"><table width="100%"><tr>
32
+ <td valign="top">
33
+ <h2><span class="refentrytitle"><a name="glib-Error-Reporting.top_of_page"></a>Error Reporting</span></h2>
34
+ <p>Error Reporting — a system for reporting errors</p>
35
+ </td>
36
+ <td valign="top" align="right"></td>
37
+ </tr></table></div>
38
+ <div class="refsynopsisdiv" title="Synopsis">
39
+ <a name="glib-Error-Reporting.synopsis"></a><h2>Synopsis</h2>
40
+ <pre class="synopsis">
41
+ #include &lt;glib.h&gt;
42
+
43
+ <a class="link" href="glib-Error-Reporting.html#GError" title="GError">GError</a>;
44
+ <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="returnvalue">GError</span></a>* <a class="link" href="glib-Error-Reporting.html#g-error-new" title="g_error_new ()">g_error_new</a> (<em class="parameter"><code><a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> domain</code></em>,
45
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> code</code></em>,
46
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *format</code></em>,
47
+ <em class="parameter"><code>...</code></em>);
48
+ <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="returnvalue">GError</span></a>* <a class="link" href="glib-Error-Reporting.html#g-error-new-literal" title="g_error_new_literal ()">g_error_new_literal</a> (<em class="parameter"><code><a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> domain</code></em>,
49
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> code</code></em>,
50
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *message</code></em>);
51
+ <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="returnvalue">GError</span></a>* <a class="link" href="glib-Error-Reporting.html#g-error-new-valist" title="g_error_new_valist ()">g_error_new_valist</a> (<em class="parameter"><code><a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> domain</code></em>,
52
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> code</code></em>,
53
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *format</code></em>,
54
+ <em class="parameter"><code><span class="type">va_list</span> args</code></em>);
55
+ <span class="returnvalue">void</span> <a class="link" href="glib-Error-Reporting.html#g-error-free" title="g_error_free ()">g_error_free</a> (<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> *error</code></em>);
56
+ <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="returnvalue">GError</span></a>* <a class="link" href="glib-Error-Reporting.html#g-error-copy" title="g_error_copy ()">g_error_copy</a> (<em class="parameter"><code>const <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> *error</code></em>);
57
+ <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Error-Reporting.html#g-error-matches" title="g_error_matches ()">g_error_matches</a> (<em class="parameter"><code>const <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> *error</code></em>,
58
+ <em class="parameter"><code><a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> domain</code></em>,
59
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> code</code></em>);
60
+ <span class="returnvalue">void</span> <a class="link" href="glib-Error-Reporting.html#g-set-error" title="g_set_error ()">g_set_error</a> (<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **err</code></em>,
61
+ <em class="parameter"><code><a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> domain</code></em>,
62
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> code</code></em>,
63
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *format</code></em>,
64
+ <em class="parameter"><code>...</code></em>);
65
+ <span class="returnvalue">void</span> <a class="link" href="glib-Error-Reporting.html#g-set-error-literal" title="g_set_error_literal ()">g_set_error_literal</a> (<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **err</code></em>,
66
+ <em class="parameter"><code><a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> domain</code></em>,
67
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> code</code></em>,
68
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *message</code></em>);
69
+ <span class="returnvalue">void</span> <a class="link" href="glib-Error-Reporting.html#g-propagate-error" title="g_propagate_error ()">g_propagate_error</a> (<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **dest</code></em>,
70
+ <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> *src</code></em>);
71
+ <span class="returnvalue">void</span> <a class="link" href="glib-Error-Reporting.html#g-clear-error" title="g_clear_error ()">g_clear_error</a> (<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **err</code></em>);
72
+ <span class="returnvalue">void</span> <a class="link" href="glib-Error-Reporting.html#g-prefix-error" title="g_prefix_error ()">g_prefix_error</a> (<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **err</code></em>,
73
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *format</code></em>,
74
+ <em class="parameter"><code>...</code></em>);
75
+ <span class="returnvalue">void</span> <a class="link" href="glib-Error-Reporting.html#g-propagate-prefixed-error" title="g_propagate_prefixed_error ()">g_propagate_prefixed_error</a> (<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **dest</code></em>,
76
+ <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> *src</code></em>,
77
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *format</code></em>,
78
+ <em class="parameter"><code>...</code></em>);
79
+ </pre>
80
+ </div>
81
+ <div class="refsect1" title="Description">
82
+ <a name="glib-Error-Reporting.description"></a><h2>Description</h2>
83
+ <p>
84
+ GLib provides a standard method of reporting errors from a called function to
85
+ the calling code. (This is the same problem solved by exceptions in other
86
+ languages.) It's important to understand that this method is both a
87
+ <span class="emphasis"><em>data type</em></span> (the <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> object) and a <span class="emphasis"><em>set of
88
+ rules.</em></span> If you use <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> incorrectly, then your code will not
89
+ properly interoperate with other code that uses <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>, and users of your API
90
+ will probably get confused.
91
+ </p>
92
+ <p>
93
+ First and foremost: <span class="emphasis"><em><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> should only be used to report
94
+ recoverable runtime errors, never to report programming errors.</em></span> If
95
+ the programmer has screwed up, then you should use <a class="link" href="glib-Message-Logging.html#g-warning" title="g_warning()"><code class="function">g_warning()</code></a>,
96
+ <a class="link" href="glib-Warnings-and-Assertions.html#g-return-if-fail" title="g_return_if_fail()"><code class="function">g_return_if_fail()</code></a>, <a class="link" href="glib-Testing.html#g-assert" title="g_assert()"><code class="function">g_assert()</code></a>, <a class="link" href="glib-Message-Logging.html#g-error" title="g_error()"><code class="function">g_error()</code></a>, or some similar facility.
97
+ (Incidentally, remember that the <a class="link" href="glib-Message-Logging.html#g-error" title="g_error()"><code class="function">g_error()</code></a> function should
98
+ <span class="emphasis"><em>only</em></span> be used for programming errors, it should not be used
99
+ to print any error reportable via <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>.)
100
+ </p>
101
+ <p>
102
+ Examples of recoverable runtime errors are "file not found" or "failed to parse
103
+ input." Examples of programming errors are "NULL passed to <code class="function">strcmp()</code>" or
104
+ "attempted to free the same pointer twice." These two kinds of errors are
105
+ fundamentally different: runtime errors should be handled or reported to the
106
+ user, programming errors should be eliminated by fixing the bug in the program.
107
+ This is why most functions in GLib and GTK+ do not use the <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> facility.
108
+ </p>
109
+ <p>
110
+ Functions that can fail take a return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> as their last argument.
111
+ For example:
112
+ </p>
113
+ <div class="informalexample">
114
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
115
+ <tbody>
116
+ <tr>
117
+ <td class="listing_lines" align="right"><pre>1
118
+ 2
119
+ 3
120
+ 4</pre></td>
121
+ <td class="listing_code"><pre class="programlisting"><span class="usertype">gboolean</span><span class="normal"> </span><span class="function"><a href="glib-File-Utilities.html#g-file-get-contents">g_file_get_contents</a></span><span class="normal"> </span><span class="symbol">(</span><span class="keyword">const</span><span class="normal"> </span><span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">filename</span><span class="symbol">,</span>
122
+ <span class="normal"> </span><span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">**</span><span class="normal">contents</span><span class="symbol">,</span>
123
+ <span class="normal"> </span><span class="usertype">gsize</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">length</span><span class="symbol">,</span>
124
+ <span class="normal"> </span><span class="usertype">GError</span><span class="normal"> </span><span class="symbol">**</span><span class="normal">error</span><span class="symbol">);</span></pre></td>
125
+ </tr>
126
+ </tbody>
127
+ </table>
128
+ </div>
129
+
130
+ <p>
131
+ If you pass a non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> value for the <code class="literal">error</code> argument, it should
132
+ point to a location where an error can be placed. For example:
133
+ </p>
134
+ <div class="informalexample">
135
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
136
+ <tbody>
137
+ <tr>
138
+ <td class="listing_lines" align="right"><pre>1
139
+ 2
140
+ 3
141
+ 4
142
+ 5
143
+ 6
144
+ 7
145
+ 8
146
+ 9
147
+ 10
148
+ 11
149
+ 12
150
+ 13
151
+ 14
152
+ 15
153
+ 16</pre></td>
154
+ <td class="listing_code"><pre class="programlisting"><span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">contents</span><span class="symbol">;</span>
155
+ <span class="usertype">GError</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">err </span><span class="symbol">=</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
156
+ <span class="function"><a href="glib-File-Utilities.html#g-file-get-contents">g_file_get_contents</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"foo.txt"</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">contents</span><span class="symbol">,</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">err</span><span class="symbol">);</span>
157
+ <span class="function"><a href="glib-Testing.html#g-assert">g_assert</a></span><span class="normal"> </span><span class="symbol">((</span><span class="normal">contents </span><span class="symbol">==</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a> </span><span class="symbol">&amp;&amp;</span><span class="normal"> err </span><span class="symbol">!=</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">||</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">contents </span><span class="symbol">!=</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a> </span><span class="symbol">&amp;&amp;</span><span class="normal"> err </span><span class="symbol">==</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">));</span>
158
+ <span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">err </span><span class="symbol">!=</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">)</span>
159
+ <span class="normal"> </span><span class="cbracket">{</span>
160
+ <span class="normal"> </span><span class="comment">/* Report error to user, and free error */</span>
161
+ <span class="normal"> </span><span class="function"><a href="glib-Testing.html#g-assert">g_assert</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">contents </span><span class="symbol">==</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
162
+ <span class="normal"> </span><span class="function">fprintf</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">stderr</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Unable to read file: %s</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">,</span><span class="normal"> err</span><span class="symbol">-&gt;</span><span class="normal">message</span><span class="symbol">);</span>
163
+ <span class="normal"> </span><span class="function"><a href="glib-Error-Reporting.html#g-error-free">g_error_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">err</span><span class="symbol">);</span>
164
+ <span class="normal"> </span><span class="cbracket">}</span>
165
+ <span class="keyword">else</span>
166
+ <span class="normal"> </span><span class="cbracket">{</span>
167
+ <span class="normal"> </span><span class="comment">/* Use file contents */</span>
168
+ <span class="normal"> </span><span class="function"><a href="glib-Testing.html#g-assert">g_assert</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">contents </span><span class="symbol">!=</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
169
+ <span class="normal"> </span><span class="cbracket">}</span></pre></td>
170
+ </tr>
171
+ </tbody>
172
+ </table>
173
+ </div>
174
+
175
+ <p>
176
+ Note that <code class="literal">err != NULL</code> in this example is a
177
+ <span class="emphasis"><em>reliable</em></span> indicator of whether
178
+ <a class="link" href="glib-File-Utilities.html#g-file-get-contents" title="g_file_get_contents ()"><code class="function">g_file_get_contents()</code></a> failed. Additionally, <a class="link" href="glib-File-Utilities.html#g-file-get-contents" title="g_file_get_contents ()"><code class="function">g_file_get_contents()</code></a> returns
179
+ a boolean which indicates whether it was successful.
180
+ </p>
181
+ <p>
182
+ Because <a class="link" href="glib-File-Utilities.html#g-file-get-contents" title="g_file_get_contents ()"><code class="function">g_file_get_contents()</code></a> returns <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> on failure, if you are only
183
+ interested in whether it failed and don't need to display an error message, you
184
+ can pass <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> for the <code class="literal">error</code> argument:
185
+ </p>
186
+ <div class="informalexample">
187
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
188
+ <tbody>
189
+ <tr>
190
+ <td class="listing_lines" align="right"><pre>1
191
+ 2
192
+ 3
193
+ 4</pre></td>
194
+ <td class="listing_code"><pre class="programlisting"><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="glib-File-Utilities.html#g-file-get-contents">g_file_get_contents</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"foo.txt"</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">contents</span><span class="symbol">,</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">))</span><span class="normal"> </span><span class="comment">/* ignore errors */</span>
195
+ <span class="normal"> </span><span class="comment">/* no error occurred */</span><span class="normal"> </span><span class="symbol">;</span>
196
+ <span class="keyword">else</span>
197
+ <span class="normal"> </span><span class="comment">/* error */</span><span class="normal"> </span><span class="symbol">;</span></pre></td>
198
+ </tr>
199
+ </tbody>
200
+ </table>
201
+ </div>
202
+
203
+ <p>
204
+ </p>
205
+ <p>
206
+ The <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> object contains three fields: <code class="literal">domain</code> indicates
207
+ the module the error-reporting function is located in, <code class="literal">code</code>
208
+ indicates the specific error that occurred, and <code class="literal">message</code> is a
209
+ user-readable error message with as many details as possible. Several functions
210
+ are provided to deal with an error received from a called function:
211
+ <a class="link" href="glib-Error-Reporting.html#g-error-matches" title="g_error_matches ()"><code class="function">g_error_matches()</code></a> returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the error matches a given domain and code,
212
+ <a class="link" href="glib-Error-Reporting.html#g-propagate-error" title="g_propagate_error ()"><code class="function">g_propagate_error()</code></a> copies an error into an error location (so the calling
213
+ function will receive it), and <a class="link" href="glib-Error-Reporting.html#g-clear-error" title="g_clear_error ()"><code class="function">g_clear_error()</code></a> clears an error location by
214
+ freeing the error and resetting the location to <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. To display an error to the
215
+ user, simply display <code class="literal">error-&gt;message</code>, perhaps along with
216
+ additional context known only to the calling function (the file being opened, or
217
+ whatever -- though in the <a class="link" href="glib-File-Utilities.html#g-file-get-contents" title="g_file_get_contents ()"><code class="function">g_file_get_contents()</code></a> case,
218
+ <code class="literal">error-&gt;message</code> already contains a filename).
219
+ </p>
220
+ <p>
221
+ When implementing a function that can report errors, the basic tool is
222
+ <a class="link" href="glib-Error-Reporting.html#g-set-error" title="g_set_error ()"><code class="function">g_set_error()</code></a>. Typically, if a fatal error occurs you want to <a class="link" href="glib-Error-Reporting.html#g-set-error" title="g_set_error ()"><code class="function">g_set_error()</code></a>,
223
+ then return immediately. <a class="link" href="glib-Error-Reporting.html#g-set-error" title="g_set_error ()"><code class="function">g_set_error()</code></a> does nothing if the error location passed
224
+ to it is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. Here's an example:
225
+ </p>
226
+ <div class="informalexample">
227
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
228
+ <tbody>
229
+ <tr>
230
+ <td class="listing_lines" align="right"><pre>1
231
+ 2
232
+ 3
233
+ 4
234
+ 5
235
+ 6
236
+ 7
237
+ 8
238
+ 9
239
+ 10
240
+ 11
241
+ 12
242
+ 13
243
+ 14
244
+ 15
245
+ 16
246
+ 17</pre></td>
247
+ <td class="listing_code"><pre class="programlisting"><span class="normal"><a href="glib-Basic-Types.html#gint">gint</a></span>
248
+ <span class="function">foo_open_file</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GError</span><span class="normal"> </span><span class="symbol">**</span><span class="normal">error</span><span class="symbol">)</span>
249
+ <span class="cbracket">{</span>
250
+ <span class="normal"> </span><span class="usertype">gint</span><span class="normal"> fd</span><span class="symbol">;</span>
251
+ <span class="normal"> fd </span><span class="symbol">=</span><span class="normal"> </span><span class="function">open</span><span class="normal"> </span><span class="symbol">(</span><span class="string">"file.txt"</span><span class="symbol">,</span><span class="normal"> O_RDONLY</span><span class="symbol">);</span>
252
+ <span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">fd </span><span class="symbol">&lt;</span><span class="normal"> </span><span class="number">0</span><span class="symbol">)</span>
253
+ <span class="normal"> </span><span class="cbracket">{</span>
254
+ <span class="normal"> </span><span class="function"><a href="glib-Error-Reporting.html#g-set-error">g_set_error</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">error</span><span class="symbol">,</span>
255
+ <span class="normal"> FOO_ERROR</span><span class="symbol">,</span><span class="normal"> </span><span class="comment">/* error domain */</span>
256
+ <span class="normal"> FOO_ERROR_BLAH</span><span class="symbol">,</span><span class="normal"> </span><span class="comment">/* error code */</span>
257
+ <span class="normal"> </span><span class="string">"Failed to open file: %s"</span><span class="symbol">,</span><span class="normal"> </span><span class="comment">/* error message format string */</span>
258
+ <span class="normal"> </span><span class="function"><a href="glib-String-Utility-Functions.html#g-strerror">g_strerror</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">errno</span><span class="symbol">));</span>
259
+ <span class="normal"> </span><span class="keyword">return</span><span class="normal"> </span><span class="symbol">-</span><span class="number">1</span><span class="symbol">;</span>
260
+ <span class="normal"> </span><span class="cbracket">}</span>
261
+ <span class="normal"> </span><span class="keyword">else</span>
262
+ <span class="normal"> </span><span class="keyword">return</span><span class="normal"> fd</span><span class="symbol">;</span>
263
+ <span class="cbracket">}</span></pre></td>
264
+ </tr>
265
+ </tbody>
266
+ </table>
267
+ </div>
268
+
269
+ <p>
270
+ </p>
271
+ <p>
272
+ Things are somewhat more complicated if you yourself call another function that
273
+ can report a <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>. If the sub-function indicates fatal errors in some way
274
+ other than reporting a <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>, such as by returning <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> on success, you can
275
+ simply do the following:
276
+ </p>
277
+ <div class="informalexample">
278
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
279
+ <tbody>
280
+ <tr>
281
+ <td class="listing_lines" align="right"><pre>1
282
+ 2
283
+ 3
284
+ 4
285
+ 5
286
+ 6
287
+ 7
288
+ 8
289
+ 9
290
+ 10
291
+ 11
292
+ 12
293
+ 13</pre></td>
294
+ <td class="listing_code"><pre class="programlisting"><span class="normal"><a href="glib-Basic-Types.html#gboolean">gboolean</a></span>
295
+ <span class="function">my_function_that_can_fail</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GError</span><span class="normal"> </span><span class="symbol">**</span><span class="normal">err</span><span class="symbol">)</span>
296
+ <span class="cbracket">{</span>
297
+ <span class="normal"> </span><span class="function"><a href="glib-Warnings-and-Assertions.html#g-return-val-if-fail">g_return_val_if_fail</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">err </span><span class="symbol">==</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a> </span><span class="symbol">||</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">err </span><span class="symbol">==</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">);</span>
298
+ <span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(!</span><span class="function">sub_function_that_can_fail</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">err</span><span class="symbol">))</span>
299
+ <span class="normal"> </span><span class="cbracket">{</span>
300
+ <span class="normal"> </span><span class="comment">/* assert that error was set by the sub-function */</span>
301
+ <span class="normal"> </span><span class="function"><a href="glib-Testing.html#g-assert">g_assert</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">err </span><span class="symbol">==</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a> </span><span class="symbol">||</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">err </span><span class="symbol">!=</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
302
+ <span class="normal"> </span><span class="keyword">return</span><span class="normal"> <a href="glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">;</span>
303
+ <span class="normal"> </span><span class="cbracket">}</span>
304
+ <span class="normal"> </span><span class="comment">/* otherwise continue, no error occurred */</span>
305
+ <span class="normal"> </span><span class="function"><a href="glib-Testing.html#g-assert">g_assert</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">err </span><span class="symbol">==</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a> </span><span class="symbol">||</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">err </span><span class="symbol">==</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
306
+ <span class="cbracket">}</span></pre></td>
307
+ </tr>
308
+ </tbody>
309
+ </table>
310
+ </div>
311
+
312
+ <p>
313
+ </p>
314
+ <p>
315
+ If the sub-function does not indicate errors other than by reporting a <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>,
316
+ you need to create a temporary <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> since the passed-in one may be <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
317
+ <a class="link" href="glib-Error-Reporting.html#g-propagate-error" title="g_propagate_error ()"><code class="function">g_propagate_error()</code></a> is intended for use in this case.
318
+ </p>
319
+ <div class="informalexample">
320
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
321
+ <tbody>
322
+ <tr>
323
+ <td class="listing_lines" align="right"><pre>1
324
+ 2
325
+ 3
326
+ 4
327
+ 5
328
+ 6
329
+ 7
330
+ 8
331
+ 9
332
+ 10
333
+ 11
334
+ 12
335
+ 13
336
+ 14
337
+ 15
338
+ 16
339
+ 17</pre></td>
340
+ <td class="listing_code"><pre class="programlisting"><span class="normal"><a href="glib-Basic-Types.html#gboolean">gboolean</a></span>
341
+ <span class="function">my_function_that_can_fail</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GError</span><span class="normal"> </span><span class="symbol">**</span><span class="normal">err</span><span class="symbol">)</span>
342
+ <span class="cbracket">{</span>
343
+ <span class="normal"> </span><span class="usertype">GError</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">tmp_error</span><span class="symbol">;</span>
344
+ <span class="normal"> </span><span class="function"><a href="glib-Warnings-and-Assertions.html#g-return-val-if-fail">g_return_val_if_fail</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">err </span><span class="symbol">==</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a> </span><span class="symbol">||</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">err </span><span class="symbol">==</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">);</span>
345
+ <span class="normal"> tmp_error </span><span class="symbol">=</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
346
+ <span class="normal"> </span><span class="function">sub_function_that_can_fail</span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">tmp_error</span><span class="symbol">);</span>
347
+ <span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">tmp_error </span><span class="symbol">!=</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">)</span>
348
+ <span class="normal"> </span><span class="cbracket">{</span>
349
+ <span class="normal"> </span><span class="comment">/* store tmp_error in err, if err != NULL,</span>
350
+ <span class="comment"> * otherwise call g_error_free() on tmp_error</span>
351
+ <span class="comment"> */</span>
352
+ <span class="normal"> </span><span class="function"><a href="glib-Error-Reporting.html#g-propagate-error">g_propagate_error</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">err</span><span class="symbol">,</span><span class="normal"> tmp_error</span><span class="symbol">);</span>
353
+ <span class="normal"> </span><span class="keyword">return</span><span class="normal"> <a href="glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">;</span>
354
+ <span class="normal"> </span><span class="cbracket">}</span>
355
+ <span class="normal"> </span><span class="comment">/* otherwise continue, no error occurred */</span>
356
+ <span class="cbracket">}</span></pre></td>
357
+ </tr>
358
+ </tbody>
359
+ </table>
360
+ </div>
361
+
362
+ <p>
363
+ </p>
364
+ <p>
365
+ Error pileups are always a bug. For example, this code is incorrect:
366
+ </p>
367
+ <div class="informalexample">
368
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
369
+ <tbody>
370
+ <tr>
371
+ <td class="listing_lines" align="right"><pre>1
372
+ 2
373
+ 3
374
+ 4
375
+ 5
376
+ 6
377
+ 7
378
+ 8
379
+ 9
380
+ 10
381
+ 11
382
+ 12
383
+ 13
384
+ 14</pre></td>
385
+ <td class="listing_code"><pre class="programlisting"><span class="normal"><a href="glib-Basic-Types.html#gboolean">gboolean</a></span>
386
+ <span class="function">my_function_that_can_fail</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GError</span><span class="normal"> </span><span class="symbol">**</span><span class="normal">err</span><span class="symbol">)</span>
387
+ <span class="cbracket">{</span>
388
+ <span class="normal"> </span><span class="usertype">GError</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">tmp_error</span><span class="symbol">;</span>
389
+ <span class="normal"> </span><span class="function"><a href="glib-Warnings-and-Assertions.html#g-return-val-if-fail">g_return_val_if_fail</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">err </span><span class="symbol">==</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a> </span><span class="symbol">||</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">err </span><span class="symbol">==</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">);</span>
390
+ <span class="normal"> tmp_error </span><span class="symbol">=</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
391
+ <span class="normal"> </span><span class="function">sub_function_that_can_fail</span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">tmp_error</span><span class="symbol">);</span>
392
+ <span class="normal"> </span><span class="function">other_function_that_can_fail</span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">tmp_error</span><span class="symbol">);</span>
393
+ <span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">tmp_error </span><span class="symbol">!=</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">)</span>
394
+ <span class="normal"> </span><span class="cbracket">{</span>
395
+ <span class="normal"> </span><span class="function"><a href="glib-Error-Reporting.html#g-propagate-error">g_propagate_error</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">err</span><span class="symbol">,</span><span class="normal"> tmp_error</span><span class="symbol">);</span>
396
+ <span class="normal"> </span><span class="keyword">return</span><span class="normal"> <a href="glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">;</span>
397
+ <span class="normal"> </span><span class="cbracket">}</span>
398
+ <span class="cbracket">}</span></pre></td>
399
+ </tr>
400
+ </tbody>
401
+ </table>
402
+ </div>
403
+
404
+ <p>
405
+ <code class="literal">tmp_error</code> should be checked immediately after
406
+ <code class="function"><code class="function">sub_function_that_can_fail()</code></code>, and either cleared or propagated upward. The rule
407
+ is: <span class="emphasis"><em>after each error, you must either handle the error, or return it to the
408
+ calling function</em></span>. Note that passing <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> for the error location is the
409
+ equivalent of handling an error by always doing nothing about it. So the
410
+ following code is fine, assuming errors in <code class="function"><code class="function">sub_function_that_can_fail()</code></code> are not
411
+ fatal to <code class="function"><code class="function">my_function_that_can_fail()</code></code>:
412
+ </p>
413
+ <div class="informalexample">
414
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
415
+ <tbody>
416
+ <tr>
417
+ <td class="listing_lines" align="right"><pre>1
418
+ 2
419
+ 3
420
+ 4
421
+ 5
422
+ 6
423
+ 7
424
+ 8
425
+ 9
426
+ 10
427
+ 11
428
+ 12
429
+ 13
430
+ 14</pre></td>
431
+ <td class="listing_code"><pre class="programlisting"><span class="normal"><a href="glib-Basic-Types.html#gboolean">gboolean</a></span>
432
+ <span class="function">my_function_that_can_fail</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GError</span><span class="normal"> </span><span class="symbol">**</span><span class="normal">err</span><span class="symbol">)</span>
433
+ <span class="cbracket">{</span>
434
+ <span class="normal"> </span><span class="usertype">GError</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">tmp_error</span><span class="symbol">;</span>
435
+ <span class="normal"> </span><span class="function"><a href="glib-Warnings-and-Assertions.html#g-return-val-if-fail">g_return_val_if_fail</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">err </span><span class="symbol">==</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a> </span><span class="symbol">||</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">err </span><span class="symbol">==</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">);</span>
436
+ <span class="normal"> </span><span class="function">sub_function_that_can_fail</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span><span class="normal"> </span><span class="comment">/* ignore errors */</span>
437
+ <span class="normal"> tmp_error </span><span class="symbol">=</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
438
+ <span class="normal"> </span><span class="function">other_function_that_can_fail</span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">tmp_error</span><span class="symbol">);</span>
439
+ <span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">tmp_error </span><span class="symbol">!=</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">)</span>
440
+ <span class="normal"> </span><span class="cbracket">{</span>
441
+ <span class="normal"> </span><span class="function"><a href="glib-Error-Reporting.html#g-propagate-error">g_propagate_error</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">err</span><span class="symbol">,</span><span class="normal"> tmp_error</span><span class="symbol">);</span>
442
+ <span class="normal"> </span><span class="keyword">return</span><span class="normal"> <a href="glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">;</span>
443
+ <span class="normal"> </span><span class="cbracket">}</span>
444
+ <span class="cbracket">}</span></pre></td>
445
+ </tr>
446
+ </tbody>
447
+ </table>
448
+ </div>
449
+
450
+ <p>
451
+ </p>
452
+ <p>
453
+ Note that passing <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> for the error location <span class="emphasis"><em>ignores</em></span>
454
+ errors; it's equivalent to <code class="literal">try { <code class="function">sub_function_that_can_fail()</code>; } catch
455
+ (...) {}</code> in C++. It does <span class="emphasis"><em>not</em></span> mean to leave errors
456
+ unhandled; it means to handle them by doing nothing.
457
+ </p>
458
+ <p>
459
+ Error domains and codes are conventionally named as follows:
460
+ </p>
461
+ <div class="itemizedlist"><ul class="itemizedlist" type="disc">
462
+ <li class="listitem">
463
+ <p>
464
+ The error domain is called
465
+ <code class="literal">&lt;NAMESPACE&gt;_&lt;MODULE&gt;_ERROR</code>, for example
466
+ <a class="link" href="glib-Spawning-Processes.html#G-SPAWN-ERROR:CAPS" title="G_SPAWN_ERROR"><code class="literal">G_SPAWN_ERROR</code></a> or <a class="link" href="glib-Threads.html#G-THREAD-ERROR:CAPS" title="G_THREAD_ERROR"><code class="literal">G_THREAD_ERROR</code></a>:
467
+ </p>
468
+ <div class="informalexample">
469
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
470
+ <tbody>
471
+ <tr>
472
+ <td class="listing_lines" align="right"><pre>1
473
+ 2
474
+ 3
475
+ 4
476
+ 5
477
+ 6</pre></td>
478
+ <td class="listing_code"><pre class="programlisting"><span class="preproc">#define</span><span class="normal"> </span><span class="usertype">G_SPAWN_ERROR</span><span class="normal"> </span><span class="function">g_spawn_error_quark</span><span class="normal"> </span><span class="symbol">()</span>
479
+ <span class="normal"><a href="glib-Quarks.html#GQuark">GQuark</a></span>
480
+ <span class="function">g_spawn_error_quark</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
481
+ <span class="cbracket">{</span>
482
+ <span class="normal"> </span><span class="keyword">return</span><span class="normal"> </span><span class="function"><a href="glib-Quarks.html#g-quark-from-static-string">g_quark_from_static_string</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"g-spawn-error-quark"</span><span class="symbol">);</span>
483
+ <span class="cbracket">}</span></pre></td>
484
+ </tr>
485
+ </tbody>
486
+ </table>
487
+ </div>
488
+
489
+ <p>
490
+ </p>
491
+ </li>
492
+ <li class="listitem"><p>
493
+ The error codes are in an enumeration called
494
+ <code class="literal">&lt;Namespace&gt;&lt;Module&gt;Error</code>; for example,
495
+ <a class="link" href="glib-Threads.html#GThreadError" title="enum GThreadError"><span class="type">GThreadError</span></a> or <a class="link" href="glib-Spawning-Processes.html#GSpawnError" title="enum GSpawnError"><span class="type">GSpawnError</span></a>.
496
+ </p></li>
497
+ <li class="listitem"><p>
498
+ Members of the error code enumeration are called <code class="literal">&lt;NAMESPACE&gt;_&lt;MODULE&gt;_ERROR_&lt;CODE&gt;</code>, for example <a class="link" href="glib-Spawning-Processes.html#G-SPAWN-ERROR-FORK:CAPS"><code class="literal">G_SPAWN_ERROR_FORK</code></a> or <a class="link" href="glib-Threads.html#G-THREAD-ERROR-AGAIN:CAPS"><code class="literal">G_THREAD_ERROR_AGAIN</code></a>.
499
+ </p></li>
500
+ <li class="listitem"><p>
501
+ If there's a "generic" or "unknown" error code for unrecoverable errors it
502
+ doesn't make sense to distinguish with specific codes, it should be called
503
+ <code class="literal">&lt;NAMESPACE&gt;_&lt;MODULE&gt;_ERROR_FAILED</code>, for
504
+ example <a class="link" href="glib-Spawning-Processes.html#G-SPAWN-ERROR-FAILED:CAPS"><code class="literal">G_SPAWN_ERROR_FAILED</code></a> or <code class="literal">G_THREAD_ERROR_FAILED</code>.
505
+ </p></li>
506
+ </ul></div>
507
+ <p>
508
+ </p>
509
+ <p>
510
+ Summary of rules for use of <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>:
511
+ </p>
512
+ <div class="itemizedlist"><ul class="itemizedlist" type="disc">
513
+ <li class="listitem"><p>
514
+ Do not report programming errors via <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>.
515
+ </p></li>
516
+ <li class="listitem"><p>
517
+ The last argument of a function that returns an error should be a
518
+ location where a <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> can be placed (i.e. "<a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>** error"). If
519
+ <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> is used with varargs, the <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>** should be the last
520
+ argument before the "...".
521
+ </p></li>
522
+ <li class="listitem"><p>
523
+ The caller may pass <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> for the <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>** if they are not interested
524
+ in details of the exact error that occurred.
525
+ </p></li>
526
+ <li class="listitem"><p>
527
+ If <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is passed for the <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>** argument, then errors should
528
+ not be returned to the caller, but your function should still
529
+ abort and return if an error occurs. That is, control flow should
530
+ not be affected by whether the caller wants to get a <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>.
531
+ </p></li>
532
+ <li class="listitem"><p>
533
+ If a <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> is reported, then your function by definition
534
+ <span class="emphasis"><em>had a fatal failure and did not complete whatever it was supposed
535
+ to do</em></span>. If the failure was not fatal, then you handled it
536
+ and you should not report it. If it was fatal, then you must report it
537
+ and discontinue whatever you were doing immediately.
538
+ </p></li>
539
+ <li class="listitem"><p>
540
+ A <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>* must be initialized to <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> before passing its address to
541
+ a function that can report errors.
542
+ </p></li>
543
+ <li class="listitem"><p>
544
+ "Piling up" errors is always a bug. That is, if you assign a new
545
+ <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> to a <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>* that is non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, thus overwriting the previous
546
+ error, it indicates that you should have aborted the operation instead
547
+ of continuing. If you were able to continue, you should have cleared
548
+ the previous error with <a class="link" href="glib-Error-Reporting.html#g-clear-error" title="g_clear_error ()"><code class="function">g_clear_error()</code></a>. <a class="link" href="glib-Error-Reporting.html#g-set-error" title="g_set_error ()"><code class="function">g_set_error()</code></a> will complain
549
+ if you pile up errors.
550
+ </p></li>
551
+ <li class="listitem"><p>
552
+ By convention, if you return a boolean value indicating success
553
+ then <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> means success and <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> means failure. If <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> is returned,
554
+ the error <span class="emphasis"><em>must</em></span> be set to a non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> value.
555
+ </p></li>
556
+ <li class="listitem"><p>
557
+ A <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> return value is also frequently used to mean that an error
558
+ occurred. You should make clear in your documentation whether <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is
559
+ a valid return value in non-error cases; if <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is a valid value,
560
+ then users must check whether an error was returned to see if the
561
+ function succeeded.
562
+ </p></li>
563
+ <li class="listitem"><p>
564
+ When implementing a function that can report errors, you may want to
565
+ add a check at the top of your function that the error return location
566
+ is either <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> or contains a <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> error
567
+ (e.g. <code class="literal">g_return_if_fail (error == NULL || *error ==
568
+ NULL);</code>).
569
+ </p></li>
570
+ </ul></div>
571
+ <p>
572
+ </p>
573
+ </div>
574
+ <div class="refsect1" title="Details">
575
+ <a name="glib-Error-Reporting.details"></a><h2>Details</h2>
576
+ <div class="refsect2" title="GError">
577
+ <a name="GError"></a><h3>GError</h3>
578
+ <pre class="programlisting">typedef struct {
579
+ GQuark domain;
580
+ gint code;
581
+ gchar *message;
582
+ } GError;
583
+ </pre>
584
+ <p>
585
+ The <span class="structname">GError</span> structure contains
586
+ information about an error that has occurred.
587
+ </p>
588
+ <div class="variablelist"><table border="0">
589
+ <col align="left" valign="top">
590
+ <tbody>
591
+ <tr>
592
+ <td><p><span class="term"><a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> <em class="structfield"><code><a name="GError.domain"></a>domain</code></em>;</span></p></td>
593
+ <td>error domain, e.g. <a class="link" href="glib-File-Utilities.html#G-FILE-ERROR:CAPS" title="G_FILE_ERROR"><span class="type">G_FILE_ERROR</span></a>.
594
+ </td>
595
+ </tr>
596
+ <tr>
597
+ <td><p><span class="term"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> <em class="structfield"><code><a name="GError.code"></a>code</code></em>;</span></p></td>
598
+ <td>error code, e.g. <a class="link" href="glib-File-Utilities.html#G-FILE-ERROR-NOENT:CAPS"><code class="literal">G_FILE_ERROR_NOENT</code></a>.
599
+ </td>
600
+ </tr>
601
+ <tr>
602
+ <td><p><span class="term"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GError.message"></a>message</code></em>;</span></p></td>
603
+ <td>human-readable informative error message.
604
+ </td>
605
+ </tr>
606
+ </tbody>
607
+ </table></div>
608
+ </div>
609
+ <hr>
610
+ <div class="refsect2" title="g_error_new ()">
611
+ <a name="g-error-new"></a><h3>g_error_new ()</h3>
612
+ <pre class="programlisting"><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="returnvalue">GError</span></a>* g_error_new (<em class="parameter"><code><a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> domain</code></em>,
613
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> code</code></em>,
614
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *format</code></em>,
615
+ <em class="parameter"><code>...</code></em>);</pre>
616
+ <p>
617
+ Creates a new <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> with the given <em class="parameter"><code>domain</code></em> and <em class="parameter"><code>code</code></em>,
618
+ and a message formatted with <em class="parameter"><code>format</code></em>.
619
+ </p>
620
+ <div class="variablelist"><table border="0">
621
+ <col align="left" valign="top">
622
+ <tbody>
623
+ <tr>
624
+ <td><p><span class="term"><em class="parameter"><code>domain</code></em> :</span></p></td>
625
+ <td>error domain
626
+ </td>
627
+ </tr>
628
+ <tr>
629
+ <td><p><span class="term"><em class="parameter"><code>code</code></em> :</span></p></td>
630
+ <td>error code
631
+ </td>
632
+ </tr>
633
+ <tr>
634
+ <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
635
+ <td>printf()-style format for error message
636
+ </td>
637
+ </tr>
638
+ <tr>
639
+ <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
640
+ <td>parameters for message format
641
+ </td>
642
+ </tr>
643
+ <tr>
644
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
645
+ <td> a new <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>
646
+ </td>
647
+ </tr>
648
+ </tbody>
649
+ </table></div>
650
+ </div>
651
+ <hr>
652
+ <div class="refsect2" title="g_error_new_literal ()">
653
+ <a name="g-error-new-literal"></a><h3>g_error_new_literal ()</h3>
654
+ <pre class="programlisting"><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="returnvalue">GError</span></a>* g_error_new_literal (<em class="parameter"><code><a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> domain</code></em>,
655
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> code</code></em>,
656
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *message</code></em>);</pre>
657
+ <p>
658
+ Creates a new <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>; unlike <a class="link" href="glib-Error-Reporting.html#g-error-new" title="g_error_new ()"><code class="function">g_error_new()</code></a>, <em class="parameter"><code>message</code></em> is
659
+ not a <code class="function">printf()</code>-style format string. Use this function if
660
+ <em class="parameter"><code>message</code></em> contains text you don't have control over,
661
+ that could include <code class="function">printf()</code> escape sequences.
662
+ </p>
663
+ <div class="variablelist"><table border="0">
664
+ <col align="left" valign="top">
665
+ <tbody>
666
+ <tr>
667
+ <td><p><span class="term"><em class="parameter"><code>domain</code></em> :</span></p></td>
668
+ <td>error domain
669
+ </td>
670
+ </tr>
671
+ <tr>
672
+ <td><p><span class="term"><em class="parameter"><code>code</code></em> :</span></p></td>
673
+ <td>error code
674
+ </td>
675
+ </tr>
676
+ <tr>
677
+ <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
678
+ <td>error message
679
+ </td>
680
+ </tr>
681
+ <tr>
682
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
683
+ <td> a new <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>
684
+ </td>
685
+ </tr>
686
+ </tbody>
687
+ </table></div>
688
+ </div>
689
+ <hr>
690
+ <div class="refsect2" title="g_error_new_valist ()">
691
+ <a name="g-error-new-valist"></a><h3>g_error_new_valist ()</h3>
692
+ <pre class="programlisting"><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="returnvalue">GError</span></a>* g_error_new_valist (<em class="parameter"><code><a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> domain</code></em>,
693
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> code</code></em>,
694
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *format</code></em>,
695
+ <em class="parameter"><code><span class="type">va_list</span> args</code></em>);</pre>
696
+ <p>
697
+ Creates a new <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> with the given <em class="parameter"><code>domain</code></em> and <em class="parameter"><code>code</code></em>,
698
+ and a message formatted with <em class="parameter"><code>format</code></em>.
699
+ </p>
700
+ <div class="variablelist"><table border="0">
701
+ <col align="left" valign="top">
702
+ <tbody>
703
+ <tr>
704
+ <td><p><span class="term"><em class="parameter"><code>domain</code></em> :</span></p></td>
705
+ <td>error domain
706
+ </td>
707
+ </tr>
708
+ <tr>
709
+ <td><p><span class="term"><em class="parameter"><code>code</code></em> :</span></p></td>
710
+ <td>error code
711
+ </td>
712
+ </tr>
713
+ <tr>
714
+ <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
715
+ <td>printf()-style format for error message
716
+ </td>
717
+ </tr>
718
+ <tr>
719
+ <td><p><span class="term"><em class="parameter"><code>args</code></em> :</span></p></td>
720
+ <td>
721
+ <span class="type">va_list</span> of parameters for the message format
722
+ </td>
723
+ </tr>
724
+ <tr>
725
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
726
+ <td> a new <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>
727
+
728
+ </td>
729
+ </tr>
730
+ </tbody>
731
+ </table></div>
732
+ <p class="since">Since 2.22</p>
733
+ </div>
734
+ <hr>
735
+ <div class="refsect2" title="g_error_free ()">
736
+ <a name="g-error-free"></a><h3>g_error_free ()</h3>
737
+ <pre class="programlisting"><span class="returnvalue">void</span> g_error_free (<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> *error</code></em>);</pre>
738
+ <p>
739
+ Frees a <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> and associated resources.
740
+ </p>
741
+ <div class="variablelist"><table border="0">
742
+ <col align="left" valign="top">
743
+ <tbody><tr>
744
+ <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
745
+ <td>a <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>
746
+ </td>
747
+ </tr></tbody>
748
+ </table></div>
749
+ </div>
750
+ <hr>
751
+ <div class="refsect2" title="g_error_copy ()">
752
+ <a name="g-error-copy"></a><h3>g_error_copy ()</h3>
753
+ <pre class="programlisting"><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="returnvalue">GError</span></a>* g_error_copy (<em class="parameter"><code>const <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> *error</code></em>);</pre>
754
+ <p>
755
+ Makes a copy of <em class="parameter"><code>error</code></em>.
756
+ </p>
757
+ <div class="variablelist"><table border="0">
758
+ <col align="left" valign="top">
759
+ <tbody>
760
+ <tr>
761
+ <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
762
+ <td>a <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>
763
+ </td>
764
+ </tr>
765
+ <tr>
766
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
767
+ <td> a new <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>
768
+ </td>
769
+ </tr>
770
+ </tbody>
771
+ </table></div>
772
+ </div>
773
+ <hr>
774
+ <div class="refsect2" title="g_error_matches ()">
775
+ <a name="g-error-matches"></a><h3>g_error_matches ()</h3>
776
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_error_matches (<em class="parameter"><code>const <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> *error</code></em>,
777
+ <em class="parameter"><code><a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> domain</code></em>,
778
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> code</code></em>);</pre>
779
+ <p>
780
+ Returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>error</code></em> matches <em class="parameter"><code>domain</code></em> and <em class="parameter"><code>code</code></em>, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a>
781
+ otherwise. In particular, when <em class="parameter"><code>error</code></em> is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> will
782
+ be returned.
783
+ </p>
784
+ <div class="variablelist"><table border="0">
785
+ <col align="left" valign="top">
786
+ <tbody>
787
+ <tr>
788
+ <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
789
+ <td>a <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
790
+ </td>
791
+ </tr>
792
+ <tr>
793
+ <td><p><span class="term"><em class="parameter"><code>domain</code></em> :</span></p></td>
794
+ <td>an error domain
795
+ </td>
796
+ </tr>
797
+ <tr>
798
+ <td><p><span class="term"><em class="parameter"><code>code</code></em> :</span></p></td>
799
+ <td>an error code
800
+ </td>
801
+ </tr>
802
+ <tr>
803
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
804
+ <td> whether <em class="parameter"><code>error</code></em> has <em class="parameter"><code>domain</code></em> and <em class="parameter"><code>code</code></em>
805
+ </td>
806
+ </tr>
807
+ </tbody>
808
+ </table></div>
809
+ </div>
810
+ <hr>
811
+ <div class="refsect2" title="g_set_error ()">
812
+ <a name="g-set-error"></a><h3>g_set_error ()</h3>
813
+ <pre class="programlisting"><span class="returnvalue">void</span> g_set_error (<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **err</code></em>,
814
+ <em class="parameter"><code><a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> domain</code></em>,
815
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> code</code></em>,
816
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *format</code></em>,
817
+ <em class="parameter"><code>...</code></em>);</pre>
818
+ <p>
819
+ Does nothing if <em class="parameter"><code>err</code></em> is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>; if <em class="parameter"><code>err</code></em> is non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, then *<em class="parameter"><code>err</code></em>
820
+ must be <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. A new <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> is created and assigned to *<em class="parameter"><code>err</code></em>.
821
+ </p>
822
+ <div class="variablelist"><table border="0">
823
+ <col align="left" valign="top">
824
+ <tbody>
825
+ <tr>
826
+ <td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
827
+ <td>a return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
828
+ </td>
829
+ </tr>
830
+ <tr>
831
+ <td><p><span class="term"><em class="parameter"><code>domain</code></em> :</span></p></td>
832
+ <td>error domain
833
+ </td>
834
+ </tr>
835
+ <tr>
836
+ <td><p><span class="term"><em class="parameter"><code>code</code></em> :</span></p></td>
837
+ <td>error code
838
+ </td>
839
+ </tr>
840
+ <tr>
841
+ <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
842
+ <td>printf()-style format
843
+ </td>
844
+ </tr>
845
+ <tr>
846
+ <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
847
+ <td>args for <em class="parameter"><code>format</code></em>
848
+ </td>
849
+ </tr>
850
+ </tbody>
851
+ </table></div>
852
+ </div>
853
+ <hr>
854
+ <div class="refsect2" title="g_set_error_literal ()">
855
+ <a name="g-set-error-literal"></a><h3>g_set_error_literal ()</h3>
856
+ <pre class="programlisting"><span class="returnvalue">void</span> g_set_error_literal (<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **err</code></em>,
857
+ <em class="parameter"><code><a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> domain</code></em>,
858
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> code</code></em>,
859
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *message</code></em>);</pre>
860
+ <p>
861
+ Does nothing if <em class="parameter"><code>err</code></em> is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>; if <em class="parameter"><code>err</code></em> is non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, then *<em class="parameter"><code>err</code></em>
862
+ must be <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. A new <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> is created and assigned to *<em class="parameter"><code>err</code></em>.
863
+ Unlike <a class="link" href="glib-Error-Reporting.html#g-set-error" title="g_set_error ()"><code class="function">g_set_error()</code></a>, <em class="parameter"><code>message</code></em> is not a <code class="function">printf()</code>-style format string.
864
+ Use this function if <em class="parameter"><code>message</code></em> contains text you don't have control over,
865
+ that could include <code class="function">printf()</code> escape sequences.
866
+ </p>
867
+ <div class="variablelist"><table border="0">
868
+ <col align="left" valign="top">
869
+ <tbody>
870
+ <tr>
871
+ <td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
872
+ <td>a return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
873
+ </td>
874
+ </tr>
875
+ <tr>
876
+ <td><p><span class="term"><em class="parameter"><code>domain</code></em> :</span></p></td>
877
+ <td>error domain
878
+ </td>
879
+ </tr>
880
+ <tr>
881
+ <td><p><span class="term"><em class="parameter"><code>code</code></em> :</span></p></td>
882
+ <td>error code
883
+ </td>
884
+ </tr>
885
+ <tr>
886
+ <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
887
+ <td>error message
888
+ </td>
889
+ </tr>
890
+ </tbody>
891
+ </table></div>
892
+ <p class="since">Since 2.18</p>
893
+ </div>
894
+ <hr>
895
+ <div class="refsect2" title="g_propagate_error ()">
896
+ <a name="g-propagate-error"></a><h3>g_propagate_error ()</h3>
897
+ <pre class="programlisting"><span class="returnvalue">void</span> g_propagate_error (<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **dest</code></em>,
898
+ <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> *src</code></em>);</pre>
899
+ <p>
900
+ If <em class="parameter"><code>dest</code></em> is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, free <em class="parameter"><code>src</code></em>; otherwise, moves <em class="parameter"><code>src</code></em> into *<em class="parameter"><code>dest</code></em>.
901
+ The error variable <em class="parameter"><code>dest</code></em> points to must be <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
902
+ </p>
903
+ <div class="variablelist"><table border="0">
904
+ <col align="left" valign="top">
905
+ <tbody>
906
+ <tr>
907
+ <td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td>
908
+ <td>error return location
909
+ </td>
910
+ </tr>
911
+ <tr>
912
+ <td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td>
913
+ <td>error to move into the return location
914
+ </td>
915
+ </tr>
916
+ </tbody>
917
+ </table></div>
918
+ </div>
919
+ <hr>
920
+ <div class="refsect2" title="g_clear_error ()">
921
+ <a name="g-clear-error"></a><h3>g_clear_error ()</h3>
922
+ <pre class="programlisting"><span class="returnvalue">void</span> g_clear_error (<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **err</code></em>);</pre>
923
+ <p>
924
+ If <em class="parameter"><code>err</code></em> is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, does nothing. If <em class="parameter"><code>err</code></em> is non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>,
925
+ calls <a class="link" href="glib-Error-Reporting.html#g-error-free" title="g_error_free ()"><code class="function">g_error_free()</code></a> on *<em class="parameter"><code>err</code></em> and sets *<em class="parameter"><code>err</code></em> to <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
926
+ </p>
927
+ <div class="variablelist"><table border="0">
928
+ <col align="left" valign="top">
929
+ <tbody><tr>
930
+ <td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
931
+ <td>a <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> return location
932
+ </td>
933
+ </tr></tbody>
934
+ </table></div>
935
+ </div>
936
+ <hr>
937
+ <div class="refsect2" title="g_prefix_error ()">
938
+ <a name="g-prefix-error"></a><h3>g_prefix_error ()</h3>
939
+ <pre class="programlisting"><span class="returnvalue">void</span> g_prefix_error (<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **err</code></em>,
940
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *format</code></em>,
941
+ <em class="parameter"><code>...</code></em>);</pre>
942
+ <p>
943
+ Formats a string according to <em class="parameter"><code>format</code></em> and
944
+ prefix it to an existing error message. If
945
+ <em class="parameter"><code>err</code></em> is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> (ie: no error variable) then do
946
+ nothing.
947
+ </p>
948
+ <p>
949
+ If *<em class="parameter"><code>err</code></em> is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> (ie: an error variable is
950
+ present but there is no error condition) then
951
+ also do nothing. Whether or not it makes
952
+ sense to take advantage of this feature is up
953
+ to you.
954
+ </p>
955
+ <div class="variablelist"><table border="0">
956
+ <col align="left" valign="top">
957
+ <tbody>
958
+ <tr>
959
+ <td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
960
+ <td>a return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
961
+ </td>
962
+ </tr>
963
+ <tr>
964
+ <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
965
+ <td>printf()-style format string
966
+ </td>
967
+ </tr>
968
+ <tr>
969
+ <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
970
+ <td>arguments to <em class="parameter"><code>format</code></em>
971
+ </td>
972
+ </tr>
973
+ </tbody>
974
+ </table></div>
975
+ <p class="since">Since 2.16</p>
976
+ </div>
977
+ <hr>
978
+ <div class="refsect2" title="g_propagate_prefixed_error ()">
979
+ <a name="g-propagate-prefixed-error"></a><h3>g_propagate_prefixed_error ()</h3>
980
+ <pre class="programlisting"><span class="returnvalue">void</span> g_propagate_prefixed_error (<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **dest</code></em>,
981
+ <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> *src</code></em>,
982
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *format</code></em>,
983
+ <em class="parameter"><code>...</code></em>);</pre>
984
+ <p>
985
+ If <em class="parameter"><code>dest</code></em> is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, free <em class="parameter"><code>src</code></em>; otherwise,
986
+ moves <em class="parameter"><code>src</code></em> into *<em class="parameter"><code>dest</code></em>. *<em class="parameter"><code>dest</code></em> must be <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
987
+ After the move, add a prefix as with
988
+ <a class="link" href="glib-Error-Reporting.html#g-prefix-error" title="g_prefix_error ()"><code class="function">g_prefix_error()</code></a>.
989
+ </p>
990
+ <div class="variablelist"><table border="0">
991
+ <col align="left" valign="top">
992
+ <tbody>
993
+ <tr>
994
+ <td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td>
995
+ <td>error return location
996
+ </td>
997
+ </tr>
998
+ <tr>
999
+ <td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td>
1000
+ <td>error to move into the return location
1001
+ </td>
1002
+ </tr>
1003
+ <tr>
1004
+ <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
1005
+ <td>printf()-style format string
1006
+ </td>
1007
+ </tr>
1008
+ <tr>
1009
+ <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
1010
+ <td>arguments to <em class="parameter"><code>format</code></em>
1011
+ </td>
1012
+ </tr>
1013
+ </tbody>
1014
+ </table></div>
1015
+ <p class="since">Since 2.16</p>
1016
+ </div>
1017
+ </div>
1018
+ </div>
1019
+ <div class="footer">
1020
+ <hr>
1021
+ Generated by GTK-Doc V1.14</div>
1022
+ </body>
1023
+ </html>