gio2 0.90.5-x86-mingw32 → 0.90.6-x86-mingw32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (830) hide show
  1. data/ChangeLog +41 -0
  2. data/Rakefile +9 -70
  3. data/ext/gio2/extconf.rb +9 -9
  4. data/ext/gio2/gasyncinitable.c +0 -1
  5. data/ext/gio2/gbufferedinputstream.c +0 -19
  6. data/ext/gio2/gbufferedoutputstream.c +0 -34
  7. data/ext/gio2/gcharsetconverter.c +0 -17
  8. data/ext/gio2/gcontenttype.c +1 -8
  9. data/ext/gio2/gconverterinputstream.c +0 -7
  10. data/ext/gio2/gconverteroutputstream.c +0 -7
  11. data/ext/gio2/gdatainputstream.c +34 -57
  12. data/ext/gio2/gdataoutputstream.c +0 -18
  13. data/ext/gio2/gdesktopappinfo.c +0 -2
  14. data/ext/gio2/gemblem.c +0 -19
  15. data/ext/gio2/gfile.c +4 -6
  16. data/ext/gio2/gfileattribute.c +3 -155
  17. data/ext/gio2/gfileattributeinfo.c +89 -0
  18. data/ext/gio2/gfileattributeinfolist.c +109 -0
  19. data/ext/gio2/gfileenumerator.c +0 -2
  20. data/ext/gio2/gfileicon.c +0 -7
  21. data/ext/gio2/gfileinfo.c +4 -11
  22. data/ext/gio2/gfileinputstream.c +0 -2
  23. data/ext/gio2/gfileiostream.c +0 -2
  24. data/ext/gio2/gfilemonitor.c +0 -19
  25. data/ext/gio2/gfileoutputstream.c +1 -5
  26. data/ext/gio2/gfilterinputstream.c +1 -30
  27. data/ext/gio2/gfilteroutputstream.c +1 -30
  28. data/ext/gio2/gicon.c +0 -2
  29. data/ext/gio2/ginetaddress.c +0 -72
  30. data/ext/gio2/ginetsocketaddress.c +0 -16
  31. data/ext/gio2/ginputstream.c +0 -2
  32. data/ext/gio2/gio2.c +11 -1
  33. data/ext/gio2/gio2.h +9 -1
  34. data/ext/gio2/gioerror.c +4 -1
  35. data/ext/gio2/giomodule.c +2 -2
  36. data/ext/gio2/gioscheduler.c +4 -6
  37. data/ext/gio2/giostream.c +0 -23
  38. data/ext/gio2/gloadableicon.c +0 -1
  39. data/ext/gio2/gmemoryoutputstream.c +0 -24
  40. data/ext/gio2/gmount.c +1 -0
  41. data/ext/gio2/gmountoperation.c +1 -103
  42. data/ext/gio2/gnetworkaddress.c +0 -14
  43. data/ext/gio2/gnetworkservice.c +0 -21
  44. data/ext/gio2/goutputstream.c +8 -18
  45. data/ext/gio2/gresolver.c +0 -2
  46. data/ext/gio2/gsocket.c +2 -80
  47. data/ext/gio2/gsocketaddress.c +1 -13
  48. data/ext/gio2/gsocketclient.c +0 -68
  49. data/ext/gio2/gsocketconnection.c +1 -8
  50. data/ext/gio2/gsocketcontrolmessage.c +0 -2
  51. data/ext/gio2/gsocketlistener.c +27 -21
  52. data/ext/gio2/gtcpconnection.c +1 -22
  53. data/ext/gio2/gthreadedsocketservice.c +6 -5
  54. data/ext/gio2/gunixfdlist.c +1 -1
  55. data/ext/gio2/gunixfdmessage.c +0 -9
  56. data/ext/gio2/gunixinputstream.c +0 -24
  57. data/ext/gio2/gunixmounts.c +1 -4
  58. data/ext/gio2/gunixoutputstream.c +0 -24
  59. data/ext/gio2/gunixsocketaddress.c +5 -17
  60. data/ext/gio2/gvfs.c +0 -2
  61. data/ext/gio2/gvolumemonitor.c +0 -2
  62. data/ext/gio2/gzlibcompressor.c +3 -0
  63. data/ext/gio2/util.c +3 -0
  64. data/lib/1.8/gio2.so +0 -0
  65. data/lib/1.9/gio2.so +0 -0
  66. data/lib/gio2.rb +19 -1
  67. data/test/load-test.rb +14 -0
  68. data/test/test_bufferedinputstream.rb +2 -0
  69. data/test/test_charsetconverter.rb +2 -0
  70. data/test/test_datainputstream.rb +7 -0
  71. data/test/test_fileenumerator.rb +8 -0
  72. data/test/test_filemonitor.rb +2 -0
  73. data/test/test_inetaddress.rb +8 -0
  74. metadata +90 -835
  75. data/vendor/local/bin/envsubst.exe +0 -0
  76. data/vendor/local/bin/gettext.exe +0 -0
  77. data/vendor/local/bin/gettext.sh +0 -123
  78. data/vendor/local/bin/glib-genmarshal.exe +0 -0
  79. data/vendor/local/bin/glib-gettextize +0 -188
  80. data/vendor/local/bin/glib-mkenums +0 -537
  81. data/vendor/local/bin/gobject-query.exe +0 -0
  82. data/vendor/local/bin/gspawn-win32-helper-console.exe +0 -0
  83. data/vendor/local/bin/gspawn-win32-helper.exe +0 -0
  84. data/vendor/local/bin/intl.dll +0 -0
  85. data/vendor/local/bin/libasprintf-0.dll +0 -0
  86. data/vendor/local/bin/libgcc_s_dw2-1.dll +0 -0
  87. data/vendor/local/bin/libgio-2.0-0.dll +0 -0
  88. data/vendor/local/bin/libglib-2.0-0.dll +0 -0
  89. data/vendor/local/bin/libgmodule-2.0-0.dll +0 -0
  90. data/vendor/local/bin/libgobject-2.0-0.dll +0 -0
  91. data/vendor/local/bin/libgthread-2.0-0.dll +0 -0
  92. data/vendor/local/bin/ngettext.exe +0 -0
  93. data/vendor/local/include/autosprintf.h +0 -66
  94. data/vendor/local/include/glib-2.0/gio/gappinfo.h +0 -236
  95. data/vendor/local/include/glib-2.0/gio/gasyncinitable.h +0 -119
  96. data/vendor/local/include/glib-2.0/gio/gasyncresult.h +0 -73
  97. data/vendor/local/include/glib-2.0/gio/gbufferedinputstream.h +0 -123
  98. data/vendor/local/include/glib-2.0/gio/gbufferedoutputstream.h +0 -81
  99. data/vendor/local/include/glib-2.0/gio/gcancellable.h +0 -103
  100. data/vendor/local/include/glib-2.0/gio/gcharsetconverter.h +0 -60
  101. data/vendor/local/include/glib-2.0/gio/gcontenttype.h +0 -57
  102. data/vendor/local/include/glib-2.0/gio/gconverter.h +0 -95
  103. data/vendor/local/include/glib-2.0/gio/gconverterinputstream.h +0 -79
  104. data/vendor/local/include/glib-2.0/gio/gconverteroutputstream.h +0 -79
  105. data/vendor/local/include/glib-2.0/gio/gcredentials.h +0 -76
  106. data/vendor/local/include/glib-2.0/gio/gdatainputstream.h +0 -150
  107. data/vendor/local/include/glib-2.0/gio/gdataoutputstream.h +0 -115
  108. data/vendor/local/include/glib-2.0/gio/gdbusaddress.h +0 -58
  109. data/vendor/local/include/glib-2.0/gio/gdbusauthobserver.h +0 -46
  110. data/vendor/local/include/glib-2.0/gio/gdbusconnection.h +0 -562
  111. data/vendor/local/include/glib-2.0/gio/gdbuserror.h +0 -100
  112. data/vendor/local/include/glib-2.0/gio/gdbusintrospection.h +0 -286
  113. data/vendor/local/include/glib-2.0/gio/gdbusmessage.h +0 -149
  114. data/vendor/local/include/glib-2.0/gio/gdbusmethodinvocation.h +0 -73
  115. data/vendor/local/include/glib-2.0/gio/gdbusnameowning.h +0 -112
  116. data/vendor/local/include/glib-2.0/gio/gdbusnamewatching.h +0 -94
  117. data/vendor/local/include/glib-2.0/gio/gdbusproxy.h +0 -167
  118. data/vendor/local/include/glib-2.0/gio/gdbusserver.h +0 -54
  119. data/vendor/local/include/glib-2.0/gio/gdbusutils.h +0 -44
  120. data/vendor/local/include/glib-2.0/gio/gdrive.h +0 -225
  121. data/vendor/local/include/glib-2.0/gio/gemblem.h +0 -58
  122. data/vendor/local/include/glib-2.0/gio/gemblemedicon.h +0 -62
  123. data/vendor/local/include/glib-2.0/gio/gfile.h +0 -1017
  124. data/vendor/local/include/glib-2.0/gio/gfileattribute.h +0 -77
  125. data/vendor/local/include/glib-2.0/gio/gfileenumerator.h +0 -132
  126. data/vendor/local/include/glib-2.0/gio/gfileicon.h +0 -56
  127. data/vendor/local/include/glib-2.0/gio/gfileinfo.h +0 -952
  128. data/vendor/local/include/glib-2.0/gio/gfileinputstream.h +0 -112
  129. data/vendor/local/include/glib-2.0/gio/gfileiostream.h +0 -118
  130. data/vendor/local/include/glib-2.0/gio/gfilemonitor.h +0 -95
  131. data/vendor/local/include/glib-2.0/gio/gfilenamecompleter.h +0 -76
  132. data/vendor/local/include/glib-2.0/gio/gfileoutputstream.h +0 -119
  133. data/vendor/local/include/glib-2.0/gio/gfilterinputstream.h +0 -76
  134. data/vendor/local/include/glib-2.0/gio/gfilteroutputstream.h +0 -76
  135. data/vendor/local/include/glib-2.0/gio/gicon.h +0 -91
  136. data/vendor/local/include/glib-2.0/gio/ginetaddress.h +0 -103
  137. data/vendor/local/include/glib-2.0/gio/ginetsocketaddress.h +0 -69
  138. data/vendor/local/include/glib-2.0/gio/ginitable.h +0 -96
  139. data/vendor/local/include/glib-2.0/gio/ginputstream.h +0 -172
  140. data/vendor/local/include/glib-2.0/gio/gio.h +0 -122
  141. data/vendor/local/include/glib-2.0/gio/gioenums.h +0 -1221
  142. data/vendor/local/include/glib-2.0/gio/gioenumtypes.h +0 -121
  143. data/vendor/local/include/glib-2.0/gio/gioerror.h +0 -52
  144. data/vendor/local/include/glib-2.0/gio/giomodule.h +0 -132
  145. data/vendor/local/include/glib-2.0/gio/gioscheduler.h +0 -52
  146. data/vendor/local/include/glib-2.0/gio/giostream.h +0 -112
  147. data/vendor/local/include/glib-2.0/gio/giotypes.h +0 -375
  148. data/vendor/local/include/glib-2.0/gio/gloadableicon.h +0 -97
  149. data/vendor/local/include/glib-2.0/gio/gmemoryinputstream.h +0 -82
  150. data/vendor/local/include/glib-2.0/gio/gmemoryoutputstream.h +0 -98
  151. data/vendor/local/include/glib-2.0/gio/gmount.h +0 -242
  152. data/vendor/local/include/glib-2.0/gio/gmountoperation.h +0 -123
  153. data/vendor/local/include/glib-2.0/gio/gnativevolumemonitor.h +0 -62
  154. data/vendor/local/include/glib-2.0/gio/gnetworkaddress.h +0 -73
  155. data/vendor/local/include/glib-2.0/gio/gnetworkservice.h +0 -71
  156. data/vendor/local/include/glib-2.0/gio/goutputstream.h +0 -207
  157. data/vendor/local/include/glib-2.0/gio/gpermission.h +0 -118
  158. data/vendor/local/include/glib-2.0/gio/gproxy.h +0 -123
  159. data/vendor/local/include/glib-2.0/gio/gproxyaddress.h +0 -76
  160. data/vendor/local/include/glib-2.0/gio/gproxyaddressenumerator.h +0 -75
  161. data/vendor/local/include/glib-2.0/gio/gproxyresolver.h +0 -96
  162. data/vendor/local/include/glib-2.0/gio/gresolver.h +0 -167
  163. data/vendor/local/include/glib-2.0/gio/gseekable.h +0 -99
  164. data/vendor/local/include/glib-2.0/gio/gsettings.h +0 -258
  165. data/vendor/local/include/glib-2.0/gio/gsettingsbackend.h +0 -138
  166. data/vendor/local/include/glib-2.0/gio/gsimpleasyncresult.h +0 -125
  167. data/vendor/local/include/glib-2.0/gio/gsimplepermission.h +0 -45
  168. data/vendor/local/include/glib-2.0/gio/gsocket.h +0 -194
  169. data/vendor/local/include/glib-2.0/gio/gsocketaddress.h +0 -79
  170. data/vendor/local/include/glib-2.0/gio/gsocketaddressenumerator.h +0 -89
  171. data/vendor/local/include/glib-2.0/gio/gsocketclient.h +0 -152
  172. data/vendor/local/include/glib-2.0/gio/gsocketconnectable.h +0 -74
  173. data/vendor/local/include/glib-2.0/gio/gsocketconnection.h +0 -91
  174. data/vendor/local/include/glib-2.0/gio/gsocketcontrolmessage.h +0 -105
  175. data/vendor/local/include/glib-2.0/gio/gsocketlistener.h +0 -138
  176. data/vendor/local/include/glib-2.0/gio/gsocketservice.h +0 -88
  177. data/vendor/local/include/glib-2.0/gio/gsrvtarget.h +0 -52
  178. data/vendor/local/include/glib-2.0/gio/gtcpconnection.h +0 -68
  179. data/vendor/local/include/glib-2.0/gio/gthemedicon.h +0 -63
  180. data/vendor/local/include/glib-2.0/gio/gthreadedsocketservice.h +0 -81
  181. data/vendor/local/include/glib-2.0/gio/gvfs.h +0 -125
  182. data/vendor/local/include/glib-2.0/gio/gvolume.h +0 -211
  183. data/vendor/local/include/glib-2.0/gio/gvolumemonitor.h +0 -150
  184. data/vendor/local/include/glib-2.0/gio/gzlibcompressor.h +0 -60
  185. data/vendor/local/include/glib-2.0/gio/gzlibdecompressor.h +0 -57
  186. data/vendor/local/include/glib-2.0/glib-object.h +0 -42
  187. data/vendor/local/include/glib-2.0/glib.h +0 -99
  188. data/vendor/local/include/glib-2.0/glib/galloca.h +0 -110
  189. data/vendor/local/include/glib-2.0/glib/garray.h +0 -179
  190. data/vendor/local/include/glib-2.0/glib/gasyncqueue.h +0 -120
  191. data/vendor/local/include/glib-2.0/glib/gatomic.h +0 -105
  192. data/vendor/local/include/glib-2.0/glib/gbacktrace.h +0 -68
  193. data/vendor/local/include/glib-2.0/glib/gbase64.h +0 -57
  194. data/vendor/local/include/glib-2.0/glib/gbitlock.h +0 -43
  195. data/vendor/local/include/glib-2.0/glib/gbookmarkfile.h +0 -215
  196. data/vendor/local/include/glib-2.0/glib/gcache.h +0 -69
  197. data/vendor/local/include/glib-2.0/glib/gchecksum.h +0 -86
  198. data/vendor/local/include/glib-2.0/glib/gcompletion.h +0 -81
  199. data/vendor/local/include/glib-2.0/glib/gconvert.h +0 -162
  200. data/vendor/local/include/glib-2.0/glib/gdataset.h +0 -122
  201. data/vendor/local/include/glib-2.0/glib/gdate.h +0 -263
  202. data/vendor/local/include/glib-2.0/glib/gdatetime.h +0 -217
  203. data/vendor/local/include/glib-2.0/glib/gdir.h +0 -52
  204. data/vendor/local/include/glib-2.0/glib/gerror.h +0 -98
  205. data/vendor/local/include/glib-2.0/glib/gfileutils.h +0 -128
  206. data/vendor/local/include/glib-2.0/glib/ghash.h +0 -166
  207. data/vendor/local/include/glib-2.0/glib/ghook.h +0 -181
  208. data/vendor/local/include/glib-2.0/glib/ghostutils.h +0 -40
  209. data/vendor/local/include/glib-2.0/glib/gi18n-lib.h +0 -38
  210. data/vendor/local/include/glib-2.0/glib/gi18n.h +0 -34
  211. data/vendor/local/include/glib-2.0/glib/giochannel.h +0 -366
  212. data/vendor/local/include/glib-2.0/glib/gkeyfile.h +0 -266
  213. data/vendor/local/include/glib-2.0/glib/glist.h +0 -120
  214. data/vendor/local/include/glib-2.0/glib/gmacros.h +0 -284
  215. data/vendor/local/include/glib-2.0/glib/gmain.h +0 -531
  216. data/vendor/local/include/glib-2.0/glib/gmappedfile.h +0 -49
  217. data/vendor/local/include/glib-2.0/glib/gmarkup.h +0 -163
  218. data/vendor/local/include/glib-2.0/glib/gmem.h +0 -309
  219. data/vendor/local/include/glib-2.0/glib/gmessages.h +0 -343
  220. data/vendor/local/include/glib-2.0/glib/gnode.h +0 -290
  221. data/vendor/local/include/glib-2.0/glib/goption.h +0 -370
  222. data/vendor/local/include/glib-2.0/glib/gpattern.h +0 -49
  223. data/vendor/local/include/glib-2.0/glib/gpoll.h +0 -117
  224. data/vendor/local/include/glib-2.0/glib/gprimes.h +0 -51
  225. data/vendor/local/include/glib-2.0/glib/gprintf.h +0 -52
  226. data/vendor/local/include/glib-2.0/glib/gqsort.h +0 -46
  227. data/vendor/local/include/glib-2.0/glib/gquark.h +0 -52
  228. data/vendor/local/include/glib-2.0/glib/gqueue.h +0 -127
  229. data/vendor/local/include/glib-2.0/glib/grand.h +0 -85
  230. data/vendor/local/include/glib-2.0/glib/gregex.h +0 -471
  231. data/vendor/local/include/glib-2.0/glib/grel.h +0 -101
  232. data/vendor/local/include/glib-2.0/glib/gscanner.h +0 -278
  233. data/vendor/local/include/glib-2.0/glib/gsequence.h +0 -128
  234. data/vendor/local/include/glib-2.0/glib/gshell.h +0 -55
  235. data/vendor/local/include/glib-2.0/glib/gslice.h +0 -86
  236. data/vendor/local/include/glib-2.0/glib/gslist.h +0 -114
  237. data/vendor/local/include/glib-2.0/glib/gspawn.h +0 -139
  238. data/vendor/local/include/glib-2.0/glib/gstdio.h +0 -147
  239. data/vendor/local/include/glib-2.0/glib/gstrfuncs.h +0 -269
  240. data/vendor/local/include/glib-2.0/glib/gstring.h +0 -178
  241. data/vendor/local/include/glib-2.0/glib/gtestutils.h +0 -297
  242. data/vendor/local/include/glib-2.0/glib/gthread.h +0 -407
  243. data/vendor/local/include/glib-2.0/glib/gthreadpool.h +0 -114
  244. data/vendor/local/include/glib-2.0/glib/gtimer.h +0 -65
  245. data/vendor/local/include/glib-2.0/glib/gtimezone.h +0 -44
  246. data/vendor/local/include/glib-2.0/glib/gtree.h +0 -91
  247. data/vendor/local/include/glib-2.0/glib/gtypes.h +0 -451
  248. data/vendor/local/include/glib-2.0/glib/gunicode.h +0 -421
  249. data/vendor/local/include/glib-2.0/glib/gurifuncs.h +0 -81
  250. data/vendor/local/include/glib-2.0/glib/gutils.h +0 -490
  251. data/vendor/local/include/glib-2.0/glib/gvariant.h +0 -248
  252. data/vendor/local/include/glib-2.0/glib/gvarianttype.h +0 -334
  253. data/vendor/local/include/glib-2.0/glib/gwin32.h +0 -114
  254. data/vendor/local/include/glib-2.0/gmodule.h +0 -101
  255. data/vendor/local/include/glib-2.0/gobject/gbinding.h +0 -136
  256. data/vendor/local/include/glib-2.0/gobject/gboxed.h +0 -248
  257. data/vendor/local/include/glib-2.0/gobject/gclosure.h +0 -251
  258. data/vendor/local/include/glib-2.0/gobject/genums.h +0 -261
  259. data/vendor/local/include/glib-2.0/gobject/gmarshal.h +0 -186
  260. data/vendor/local/include/glib-2.0/gobject/gobject.h +0 -567
  261. data/vendor/local/include/glib-2.0/gobject/gobjectnotifyqueue.c +0 -193
  262. data/vendor/local/include/glib-2.0/gobject/gparam.h +0 -415
  263. data/vendor/local/include/glib-2.0/gobject/gparamspecs.h +0 -1137
  264. data/vendor/local/include/glib-2.0/gobject/gsignal.h +0 -509
  265. data/vendor/local/include/glib-2.0/gobject/gsourceclosure.h +0 -51
  266. data/vendor/local/include/glib-2.0/gobject/gtype.h +0 -1736
  267. data/vendor/local/include/glib-2.0/gobject/gtypemodule.h +0 -263
  268. data/vendor/local/include/glib-2.0/gobject/gtypeplugin.h +0 -134
  269. data/vendor/local/include/glib-2.0/gobject/gvalue.h +0 -159
  270. data/vendor/local/include/glib-2.0/gobject/gvaluearray.h +0 -77
  271. data/vendor/local/include/glib-2.0/gobject/gvaluecollector.h +0 -227
  272. data/vendor/local/include/glib-2.0/gobject/gvaluetypes.h +0 -260
  273. data/vendor/local/include/libintl.h +0 -464
  274. data/vendor/local/lib/GNU.Gettext.dll +0 -0
  275. data/vendor/local/lib/gio-2.0.def +0 -1143
  276. data/vendor/local/lib/gio-2.0.lib +0 -0
  277. data/vendor/local/lib/glib-2.0.def +0 -1452
  278. data/vendor/local/lib/glib-2.0.lib +0 -0
  279. data/vendor/local/lib/glib-2.0/include/glibconfig.h +0 -284
  280. data/vendor/local/lib/gmodule-2.0.def +0 -11
  281. data/vendor/local/lib/gmodule-2.0.lib +0 -0
  282. data/vendor/local/lib/gobject-2.0.def +0 -370
  283. data/vendor/local/lib/gobject-2.0.lib +0 -0
  284. data/vendor/local/lib/gthread-2.0.def +0 -3
  285. data/vendor/local/lib/gthread-2.0.lib +0 -0
  286. data/vendor/local/lib/intl.lib +0 -0
  287. data/vendor/local/lib/libasprintf.dll.a +0 -0
  288. data/vendor/local/lib/libgio-2.0.dll.a +0 -0
  289. data/vendor/local/lib/libglib-2.0.dll.a +0 -0
  290. data/vendor/local/lib/libgmodule-2.0.dll.a +0 -0
  291. data/vendor/local/lib/libgobject-2.0.dll.a +0 -0
  292. data/vendor/local/lib/libgthread-2.0.dll.a +0 -0
  293. data/vendor/local/lib/libintl.def +0 -31
  294. data/vendor/local/lib/libintl.dll.a +0 -0
  295. data/vendor/local/lib/pkgconfig/gio-2.0.pc +0 -15
  296. data/vendor/local/lib/pkgconfig/gio-windows-2.0.pc +0 -11
  297. data/vendor/local/lib/pkgconfig/glib-2.0.pc +0 -15
  298. data/vendor/local/lib/pkgconfig/gmodule-2.0.pc +0 -14
  299. data/vendor/local/lib/pkgconfig/gmodule-no-export-2.0.pc +0 -14
  300. data/vendor/local/lib/pkgconfig/gobject-2.0.pc +0 -11
  301. data/vendor/local/lib/pkgconfig/gthread-2.0.pc +0 -11
  302. data/vendor/local/manifest/gettext-runtime-dev_0.18.1.1-2_win32.mft +0 -81
  303. data/vendor/local/manifest/gettext-runtime_0.18.1.1-2_win32.mft +0 -3
  304. data/vendor/local/manifest/glib-dev_2.26.0-2_win32.mft +0 -570
  305. data/vendor/local/manifest/glib_2.26.0-2_win32.mft +0 -102
  306. data/vendor/local/share/aclocal/glib-2.0.m4 +0 -211
  307. data/vendor/local/share/aclocal/glib-gettext.m4 +0 -432
  308. data/vendor/local/share/doc/gettext/bind_textdomain_codeset.3.html +0 -165
  309. data/vendor/local/share/doc/gettext/bindtextdomain.3.html +0 -160
  310. data/vendor/local/share/doc/gettext/csharpdoc/GNU_Gettext.html +0 -8
  311. data/vendor/local/share/doc/gettext/csharpdoc/GNU_Gettext_GettextResourceManager.html +0 -305
  312. data/vendor/local/share/doc/gettext/csharpdoc/GNU_Gettext_GettextResourceSet.html +0 -356
  313. data/vendor/local/share/doc/gettext/csharpdoc/begin.html +0 -11
  314. data/vendor/local/share/doc/gettext/csharpdoc/index.html +0 -10
  315. data/vendor/local/share/doc/gettext/csharpdoc/namespaces.html +0 -6
  316. data/vendor/local/share/doc/gettext/envsubst.1.html +0 -213
  317. data/vendor/local/share/doc/gettext/gettext.1.html +0 -266
  318. data/vendor/local/share/doc/gettext/gettext.3.html +0 -186
  319. data/vendor/local/share/doc/gettext/ngettext.1.html +0 -280
  320. data/vendor/local/share/doc/gettext/ngettext.3.html +0 -143
  321. data/vendor/local/share/doc/gettext/textdomain.3.html +0 -150
  322. data/vendor/local/share/doc/glib-2.26.0/COPYING +0 -482
  323. data/vendor/local/share/doc/glib-dev-2.26.0/COPYING +0 -482
  324. data/vendor/local/share/doc/libasprintf/autosprintf_all.html +0 -174
  325. data/vendor/local/share/glib-2.0/gdb/glib.py +0 -249
  326. data/vendor/local/share/glib-2.0/gdb/gobject.py +0 -305
  327. data/vendor/local/share/glib-2.0/gettext/mkinstalldirs +0 -111
  328. data/vendor/local/share/glib-2.0/gettext/po/Makefile.in.in +0 -279
  329. data/vendor/local/share/glib-2.0/schemas/gschema.dtd +0 -60
  330. data/vendor/local/share/gtk-doc/html/gio/GAppInfo.html +0 -1403
  331. data/vendor/local/share/gtk-doc/html/gio/GAsyncInitable.html +0 -733
  332. data/vendor/local/share/gtk-doc/html/gio/GAsyncResult.html +0 -343
  333. data/vendor/local/share/gtk-doc/html/gio/GBufferedInputStream.html +0 -563
  334. data/vendor/local/share/gtk-doc/html/gio/GBufferedOutputStream.html +0 -291
  335. data/vendor/local/share/gtk-doc/html/gio/GCancellable.html +0 -620
  336. data/vendor/local/share/gtk-doc/html/gio/GCharsetConverter.html +0 -245
  337. data/vendor/local/share/gtk-doc/html/gio/GConverter.html +0 -423
  338. data/vendor/local/share/gtk-doc/html/gio/GCredentials.html +0 -398
  339. data/vendor/local/share/gtk-doc/html/gio/GDBusAuthObserver.html +0 -254
  340. data/vendor/local/share/gtk-doc/html/gio/GDBusConnection.html +0 -6211
  341. data/vendor/local/share/gtk-doc/html/gio/GDBusMessage.html +0 -1833
  342. data/vendor/local/share/gtk-doc/html/gio/GDBusMethodInvocation.html +0 -618
  343. data/vendor/local/share/gtk-doc/html/gio/GDBusProxy.html +0 -2050
  344. data/vendor/local/share/gtk-doc/html/gio/GDBusServer.html +0 -1124
  345. data/vendor/local/share/gtk-doc/html/gio/GDataInputStream.html +0 -1215
  346. data/vendor/local/share/gtk-doc/html/gio/GDataOutputStream.html +0 -540
  347. data/vendor/local/share/gtk-doc/html/gio/GDrive.html +0 -1416
  348. data/vendor/local/share/gtk-doc/html/gio/GEmblem.html +0 -272
  349. data/vendor/local/share/gtk-doc/html/gio/GEmblemedIcon.html +0 -206
  350. data/vendor/local/share/gtk-doc/html/gio/GFile.html +0 -7462
  351. data/vendor/local/share/gtk-doc/html/gio/GFileDescriptorBased.html +0 -120
  352. data/vendor/local/share/gtk-doc/html/gio/GFileEnumerator.html +0 -516
  353. data/vendor/local/share/gtk-doc/html/gio/GFileIOStream.html +0 -312
  354. data/vendor/local/share/gtk-doc/html/gio/GFileIcon.html +0 -155
  355. data/vendor/local/share/gtk-doc/html/gio/GFileInfo.html +0 -3144
  356. data/vendor/local/share/gtk-doc/html/gio/GFileInputStream.html +0 -262
  357. data/vendor/local/share/gtk-doc/html/gio/GFileMonitor.html +0 -353
  358. data/vendor/local/share/gtk-doc/html/gio/GFileOutputStream.html +0 -301
  359. data/vendor/local/share/gtk-doc/html/gio/GFilenameCompleter.html +0 -217
  360. data/vendor/local/share/gtk-doc/html/gio/GFilterInputStream.html +0 -188
  361. data/vendor/local/share/gtk-doc/html/gio/GFilterOutputStream.html +0 -189
  362. data/vendor/local/share/gtk-doc/html/gio/GIOModule.html +0 -261
  363. data/vendor/local/share/gtk-doc/html/gio/GIOStream.html +0 -479
  364. data/vendor/local/share/gtk-doc/html/gio/GIcon.html +0 -331
  365. data/vendor/local/share/gtk-doc/html/gio/GInetAddress.html +0 -717
  366. data/vendor/local/share/gtk-doc/html/gio/GInetSocketAddress.html +0 -196
  367. data/vendor/local/share/gtk-doc/html/gio/GInitable.html +0 -388
  368. data/vendor/local/share/gtk-doc/html/gio/GInputStream.html +0 -808
  369. data/vendor/local/share/gtk-doc/html/gio/GLoadableIcon.html +0 -301
  370. data/vendor/local/share/gtk-doc/html/gio/GMemoryInputStream.html +0 -185
  371. data/vendor/local/share/gtk-doc/html/gio/GMemoryOutputStream.html +0 -393
  372. data/vendor/local/share/gtk-doc/html/gio/GMount.html +0 -1465
  373. data/vendor/local/share/gtk-doc/html/gio/GMountOperation.html +0 -848
  374. data/vendor/local/share/gtk-doc/html/gio/GNetworkAddress.html +0 -343
  375. data/vendor/local/share/gtk-doc/html/gio/GNetworkService.html +0 -311
  376. data/vendor/local/share/gtk-doc/html/gio/GOutputStream.html +0 -1012
  377. data/vendor/local/share/gtk-doc/html/gio/GPermission.html +0 -560
  378. data/vendor/local/share/gtk-doc/html/gio/GProxy.html +0 -312
  379. data/vendor/local/share/gtk-doc/html/gio/GProxyAddress.html +0 -348
  380. data/vendor/local/share/gtk-doc/html/gio/GProxyResolver.html +0 -301
  381. data/vendor/local/share/gtk-doc/html/gio/GResolver.html +0 -787
  382. data/vendor/local/share/gtk-doc/html/gio/GSeekable.html +0 -350
  383. data/vendor/local/share/gtk-doc/html/gio/GSettings.html +0 -2424
  384. data/vendor/local/share/gtk-doc/html/gio/GSettingsBackend.html +0 -609
  385. data/vendor/local/share/gtk-doc/html/gio/GSimpleAsyncResult.html +0 -1193
  386. data/vendor/local/share/gtk-doc/html/gio/GSimplePermission.html +0 -107
  387. data/vendor/local/share/gtk-doc/html/gio/GSocket.html +0 -2438
  388. data/vendor/local/share/gtk-doc/html/gio/GSocketAddress.html +0 -297
  389. data/vendor/local/share/gtk-doc/html/gio/GSocketClient.html +0 -1292
  390. data/vendor/local/share/gtk-doc/html/gio/GSocketConnectable.html +0 -513
  391. data/vendor/local/share/gtk-doc/html/gio/GSocketConnection.html +0 -337
  392. data/vendor/local/share/gtk-doc/html/gio/GSocketControlMessage.html +0 -275
  393. data/vendor/local/share/gtk-doc/html/gio/GSocketListener.html +0 -745
  394. data/vendor/local/share/gtk-doc/html/gio/GSocketService.html +0 -258
  395. data/vendor/local/share/gtk-doc/html/gio/GTcpConnection.html +0 -165
  396. data/vendor/local/share/gtk-doc/html/gio/GThemedIcon.html +0 -377
  397. data/vendor/local/share/gtk-doc/html/gio/GThreadedSocketService.html +0 -197
  398. data/vendor/local/share/gtk-doc/html/gio/GUnixConnection.html +0 -298
  399. data/vendor/local/share/gtk-doc/html/gio/GUnixCredentialsMessage.html +0 -222
  400. data/vendor/local/share/gtk-doc/html/gio/GUnixFDList.html +0 -389
  401. data/vendor/local/share/gtk-doc/html/gio/GUnixFDMessage.html +0 -288
  402. data/vendor/local/share/gtk-doc/html/gio/GUnixInputStream.html +0 -237
  403. data/vendor/local/share/gtk-doc/html/gio/GUnixOutputStream.html +0 -237
  404. data/vendor/local/share/gtk-doc/html/gio/GUnixSocketAddress.html +0 -491
  405. data/vendor/local/share/gtk-doc/html/gio/GVfs.html +0 -274
  406. data/vendor/local/share/gtk-doc/html/gio/GVolume.html +0 -1028
  407. data/vendor/local/share/gtk-doc/html/gio/GVolumeMonitor.html +0 -705
  408. data/vendor/local/share/gtk-doc/html/gio/GZlibCompressor.html +0 -252
  409. data/vendor/local/share/gtk-doc/html/gio/GZlibDecompressor.html +0 -170
  410. data/vendor/local/share/gtk-doc/html/gio/annotation-glossary.html +0 -65
  411. data/vendor/local/share/gtk-doc/html/gio/api-index-2-18.html +0 -153
  412. data/vendor/local/share/gtk-doc/html/gio/api-index-2-20.html +0 -155
  413. data/vendor/local/share/gtk-doc/html/gio/api-index-2-22.html +0 -1084
  414. data/vendor/local/share/gtk-doc/html/gio/api-index-2-24.html +0 -223
  415. data/vendor/local/share/gtk-doc/html/gio/api-index-2-26.html +0 -1598
  416. data/vendor/local/share/gtk-doc/html/gio/api-index-deprecated.html +0 -112
  417. data/vendor/local/share/gtk-doc/html/gio/api-index-full.html +0 -6250
  418. data/vendor/local/share/gtk-doc/html/gio/async.html +0 -44
  419. data/vendor/local/share/gtk-doc/html/gio/ch01.html +0 -207
  420. data/vendor/local/share/gtk-doc/html/gio/ch02.html +0 -50
  421. data/vendor/local/share/gtk-doc/html/gio/ch03.html +0 -180
  422. data/vendor/local/share/gtk-doc/html/gio/ch24.html +0 -75
  423. data/vendor/local/share/gtk-doc/html/gio/ch25.html +0 -217
  424. data/vendor/local/share/gtk-doc/html/gio/ch25s02.html +0 -41
  425. data/vendor/local/share/gtk-doc/html/gio/ch25s03.html +0 -39
  426. data/vendor/local/share/gtk-doc/html/gio/ch26.html +0 -57
  427. data/vendor/local/share/gtk-doc/html/gio/ch26s02.html +0 -59
  428. data/vendor/local/share/gtk-doc/html/gio/ch26s03.html +0 -159
  429. data/vendor/local/share/gtk-doc/html/gio/ch26s04.html +0 -46
  430. data/vendor/local/share/gtk-doc/html/gio/ch26s05.html +0 -48
  431. data/vendor/local/share/gtk-doc/html/gio/ch26s06.html +0 -277
  432. data/vendor/local/share/gtk-doc/html/gio/ch26s07.html +0 -95
  433. data/vendor/local/share/gtk-doc/html/gio/ch27.html +0 -70
  434. data/vendor/local/share/gtk-doc/html/gio/ch27s02.html +0 -130
  435. data/vendor/local/share/gtk-doc/html/gio/ch27s03.html +0 -202
  436. data/vendor/local/share/gtk-doc/html/gio/ch27s04.html +0 -96
  437. data/vendor/local/share/gtk-doc/html/gio/ch27s05.html +0 -823
  438. data/vendor/local/share/gtk-doc/html/gio/ch27s06.html +0 -828
  439. data/vendor/local/share/gtk-doc/html/gio/conversion.html +0 -44
  440. data/vendor/local/share/gtk-doc/html/gio/extending-gio.html +0 -109
  441. data/vendor/local/share/gtk-doc/html/gio/extending.html +0 -41
  442. data/vendor/local/share/gtk-doc/html/gio/failable_initialization.html +0 -38
  443. data/vendor/local/share/gtk-doc/html/gio/file_mon.html +0 -33
  444. data/vendor/local/share/gtk-doc/html/gio/file_ops.html +0 -50
  445. data/vendor/local/share/gtk-doc/html/gio/gdbus-convenience.html +0 -41
  446. data/vendor/local/share/gtk-doc/html/gio/gdbus-lowlevel.html +0 -59
  447. data/vendor/local/share/gtk-doc/html/gio/gdbus.html +0 -243
  448. data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Addresses.html +0 -316
  449. data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Introspection-Data.html +0 -1117
  450. data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Utilities.html +0 -216
  451. data/vendor/local/share/gtk-doc/html/gio/gio-Desktop-file-based-GAppInfo.html +0 -339
  452. data/vendor/local/share/gtk-doc/html/gio/gio-Extension-Points.html +0 -473
  453. data/vendor/local/share/gtk-doc/html/gio/gio-GContentType.html +0 -391
  454. data/vendor/local/share/gtk-doc/html/gio/gio-GConverterInputstream.html +0 -159
  455. data/vendor/local/share/gtk-doc/html/gio/gio-GConverterOutputstream.html +0 -159
  456. data/vendor/local/share/gtk-doc/html/gio/gio-GDBusError.html +0 -908
  457. data/vendor/local/share/gtk-doc/html/gio/gio-GFileAttribute.html +0 -933
  458. data/vendor/local/share/gtk-doc/html/gio/gio-GIOError.html +0 -409
  459. data/vendor/local/share/gtk-doc/html/gio/gio-GIOScheduler.html +0 -297
  460. data/vendor/local/share/gtk-doc/html/gio/gio-GSrvTarget.html +0 -313
  461. data/vendor/local/share/gtk-doc/html/gio/gio-Owning-Bus-Names.html +0 -736
  462. data/vendor/local/share/gtk-doc/html/gio/gio-Unix-Mounts.html +0 -909
  463. data/vendor/local/share/gtk-doc/html/gio/gio-Watching-Bus-Names.html +0 -666
  464. data/vendor/local/share/gtk-doc/html/gio/gio-hierarchy.html +0 -123
  465. data/vendor/local/share/gtk-doc/html/gio/gio-querymodules.html +0 -53
  466. data/vendor/local/share/gtk-doc/html/gio/gio.devhelp +0 -1736
  467. data/vendor/local/share/gtk-doc/html/gio/gio.devhelp2 +0 -2006
  468. data/vendor/local/share/gtk-doc/html/gio/glib-compile-schemas.html +0 -102
  469. data/vendor/local/share/gtk-doc/html/gio/gvfs-overview.png +0 -0
  470. data/vendor/local/share/gtk-doc/html/gio/highlevel-socket.html +0 -53
  471. data/vendor/local/share/gtk-doc/html/gio/home.png +0 -0
  472. data/vendor/local/share/gtk-doc/html/gio/icons.html +0 -50
  473. data/vendor/local/share/gtk-doc/html/gio/index.html +0 -435
  474. data/vendor/local/share/gtk-doc/html/gio/index.sgml +0 -2513
  475. data/vendor/local/share/gtk-doc/html/gio/left.png +0 -0
  476. data/vendor/local/share/gtk-doc/html/gio/migrating.html +0 -62
  477. data/vendor/local/share/gtk-doc/html/gio/networking.html +0 -69
  478. data/vendor/local/share/gtk-doc/html/gio/permissions.html +0 -39
  479. data/vendor/local/share/gtk-doc/html/gio/pt01.html +0 -39
  480. data/vendor/local/share/gtk-doc/html/gio/pt02.html +0 -390
  481. data/vendor/local/share/gtk-doc/html/gio/resolver.html +0 -50
  482. data/vendor/local/share/gtk-doc/html/gio/right.png +0 -0
  483. data/vendor/local/share/gtk-doc/html/gio/settings.html +0 -38
  484. data/vendor/local/share/gtk-doc/html/gio/streaming.html +0 -92
  485. data/vendor/local/share/gtk-doc/html/gio/style.css +0 -265
  486. data/vendor/local/share/gtk-doc/html/gio/tools.html +0 -44
  487. data/vendor/local/share/gtk-doc/html/gio/types.html +0 -41
  488. data/vendor/local/share/gtk-doc/html/gio/up.png +0 -0
  489. data/vendor/local/share/gtk-doc/html/gio/utils.html +0 -33
  490. data/vendor/local/share/gtk-doc/html/gio/volume_mon.html +0 -47
  491. data/vendor/local/share/gtk-doc/html/glib/annotation-glossary.html +0 -77
  492. data/vendor/local/share/gtk-doc/html/glib/api-index-2-10.html +0 -180
  493. data/vendor/local/share/gtk-doc/html/glib/api-index-2-12.html +0 -312
  494. data/vendor/local/share/gtk-doc/html/glib/api-index-2-14.html +0 -559
  495. data/vendor/local/share/gtk-doc/html/glib/api-index-2-16.html +0 -362
  496. data/vendor/local/share/gtk-doc/html/glib/api-index-2-18.html +0 -102
  497. data/vendor/local/share/gtk-doc/html/glib/api-index-2-2.html +0 -124
  498. data/vendor/local/share/gtk-doc/html/glib/api-index-2-20.html +0 -83
  499. data/vendor/local/share/gtk-doc/html/glib/api-index-2-22.html +0 -194
  500. data/vendor/local/share/gtk-doc/html/glib/api-index-2-24.html +0 -420
  501. data/vendor/local/share/gtk-doc/html/glib/api-index-2-26.html +0 -359
  502. data/vendor/local/share/gtk-doc/html/glib/api-index-2-4.html +0 -396
  503. data/vendor/local/share/gtk-doc/html/glib/api-index-2-6.html +0 -417
  504. data/vendor/local/share/gtk-doc/html/glib/api-index-2-8.html +0 -158
  505. data/vendor/local/share/gtk-doc/html/glib/api-index-deprecated.html +0 -419
  506. data/vendor/local/share/gtk-doc/html/glib/api-index-full.html +0 -8214
  507. data/vendor/local/share/gtk-doc/html/glib/file-name-encodings.png +0 -0
  508. data/vendor/local/share/gtk-doc/html/glib/glib-Arrays.html +0 -893
  509. data/vendor/local/share/gtk-doc/html/glib/glib-Asynchronous-Queues.html +0 -818
  510. data/vendor/local/share/gtk-doc/html/glib/glib-Atomic-Operations.html +0 -414
  511. data/vendor/local/share/gtk-doc/html/glib/glib-Automatic-String-Completion.html +0 -466
  512. data/vendor/local/share/gtk-doc/html/glib/glib-Balanced-Binary-Trees.html +0 -802
  513. data/vendor/local/share/gtk-doc/html/glib/glib-Base64-Encoding.html +0 -372
  514. data/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html +0 -500
  515. data/vendor/local/share/gtk-doc/html/glib/glib-Bookmark-file-parser.html +0 -2056
  516. data/vendor/local/share/gtk-doc/html/glib/glib-Byte-Arrays.html +0 -560
  517. data/vendor/local/share/gtk-doc/html/glib/glib-Byte-Order-Macros.html +0 -1686
  518. data/vendor/local/share/gtk-doc/html/glib/glib-Caches.html +0 -398
  519. data/vendor/local/share/gtk-doc/html/glib/glib-Character-Set-Conversion.html +0 -1094
  520. data/vendor/local/share/gtk-doc/html/glib/glib-Commandline-option-parser.html +0 -1671
  521. data/vendor/local/share/gtk-doc/html/glib/glib-Data-Checksums.html +0 -460
  522. data/vendor/local/share/gtk-doc/html/glib/glib-Datasets.html +0 -528
  523. data/vendor/local/share/gtk-doc/html/glib/glib-Date-and-Time-Functions.html +0 -2045
  524. data/vendor/local/share/gtk-doc/html/glib/glib-Double-ended-Queues.html +0 -1278
  525. data/vendor/local/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html +0 -1406
  526. data/vendor/local/share/gtk-doc/html/glib/glib-Dynamic-Loading-of-Modules.html +0 -548
  527. data/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html +0 -1026
  528. data/vendor/local/share/gtk-doc/html/glib/glib-File-Utilities.html +0 -1852
  529. data/vendor/local/share/gtk-doc/html/glib/glib-GDateTime.html +0 -2201
  530. data/vendor/local/share/gtk-doc/html/glib/glib-GTimeZone.html +0 -239
  531. data/vendor/local/share/gtk-doc/html/glib/glib-GVariant.html +0 -4278
  532. data/vendor/local/share/gtk-doc/html/glib/glib-GVariantType.html +0 -1864
  533. data/vendor/local/share/gtk-doc/html/glib/glib-Glob-style-pattern-matching.html +0 -295
  534. data/vendor/local/share/gtk-doc/html/glib/glib-Hash-Tables.html +0 -1512
  535. data/vendor/local/share/gtk-doc/html/glib/glib-Hook-Functions.html +0 -1367
  536. data/vendor/local/share/gtk-doc/html/glib/glib-Hostname-Utilities.html +0 -229
  537. data/vendor/local/share/gtk-doc/html/glib/glib-I18N.html +0 -692
  538. data/vendor/local/share/gtk-doc/html/glib/glib-IO-Channels.html +0 -2196
  539. data/vendor/local/share/gtk-doc/html/glib/glib-Key-value-file-parser.html +0 -2740
  540. data/vendor/local/share/gtk-doc/html/glib/glib-Keyed-Data-Lists.html +0 -612
  541. data/vendor/local/share/gtk-doc/html/glib/glib-Lexical-Scanner.html +0 -1451
  542. data/vendor/local/share/gtk-doc/html/glib/glib-Limits-of-Basic-Types.html +0 -389
  543. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html +0 -1033
  544. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocators.html +0 -141
  545. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Chunks.html +0 -706
  546. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Slices.html +0 -510
  547. data/vendor/local/share/gtk-doc/html/glib/glib-Message-Logging.html +0 -748
  548. data/vendor/local/share/gtk-doc/html/glib/glib-Miscellaneous-Macros.html +0 -1105
  549. data/vendor/local/share/gtk-doc/html/glib/glib-Miscellaneous-Utility-Functions.html +0 -1552
  550. data/vendor/local/share/gtk-doc/html/glib/glib-N-ary-Trees.html +0 -1468
  551. data/vendor/local/share/gtk-doc/html/glib/glib-Numerical-Definitions.html +0 -194
  552. data/vendor/local/share/gtk-doc/html/glib/glib-Perl-compatible-regular-expressions.html +0 -2745
  553. data/vendor/local/share/gtk-doc/html/glib/glib-Pointer-Arrays.html +0 -752
  554. data/vendor/local/share/gtk-doc/html/glib/glib-Quarks.html +0 -269
  555. data/vendor/local/share/gtk-doc/html/glib/glib-Random-Numbers.html +0 -578
  556. data/vendor/local/share/gtk-doc/html/glib/glib-Relations-and-Tuples.html +0 -532
  557. data/vendor/local/share/gtk-doc/html/glib/glib-Sequences.html +0 -1353
  558. data/vendor/local/share/gtk-doc/html/glib/glib-Shell-related-Utilities.html +0 -238
  559. data/vendor/local/share/gtk-doc/html/glib/glib-Simple-XML-Subset-Parser.html +0 -1282
  560. data/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html +0 -1213
  561. data/vendor/local/share/gtk-doc/html/glib/glib-Spawning-Processes.html +0 -924
  562. data/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html +0 -470
  563. data/vendor/local/share/gtk-doc/html/glib/glib-String-Chunks.html +0 -301
  564. data/vendor/local/share/gtk-doc/html/glib/glib-String-Utility-Functions.html +0 -2960
  565. data/vendor/local/share/gtk-doc/html/glib/glib-Strings.html +0 -1291
  566. data/vendor/local/share/gtk-doc/html/glib/glib-Testing.html +0 -1805
  567. data/vendor/local/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html +0 -3478
  568. data/vendor/local/share/gtk-doc/html/glib/glib-Thread-Pools.html +0 -606
  569. data/vendor/local/share/gtk-doc/html/glib/glib-Threads.html +0 -3411
  570. data/vendor/local/share/gtk-doc/html/glib/glib-Timers.html +0 -245
  571. data/vendor/local/share/gtk-doc/html/glib/glib-Trash-Stacks.html +0 -188
  572. data/vendor/local/share/gtk-doc/html/glib/glib-Type-Conversion-Macros.html +0 -263
  573. data/vendor/local/share/gtk-doc/html/glib/glib-URI-Functions.html +0 -400
  574. data/vendor/local/share/gtk-doc/html/glib/glib-Unicode-Manipulation.html +0 -3448
  575. data/vendor/local/share/gtk-doc/html/glib/glib-Version-Information.html +0 -253
  576. data/vendor/local/share/gtk-doc/html/glib/glib-Warnings-and-Assertions.html +0 -438
  577. data/vendor/local/share/gtk-doc/html/glib/glib-Windows-Compatibility-Functions.html +0 -476
  578. data/vendor/local/share/gtk-doc/html/glib/glib-building.html +0 -466
  579. data/vendor/local/share/gtk-doc/html/glib/glib-changes.html +0 -159
  580. data/vendor/local/share/gtk-doc/html/glib/glib-compiling.html +0 -118
  581. data/vendor/local/share/gtk-doc/html/glib/glib-core.html +0 -64
  582. data/vendor/local/share/gtk-doc/html/glib/glib-cross-compiling.html +0 -160
  583. data/vendor/local/share/gtk-doc/html/glib/glib-data-types.html +0 -120
  584. data/vendor/local/share/gtk-doc/html/glib/glib-fundamentals.html +0 -59
  585. data/vendor/local/share/gtk-doc/html/glib/glib-gettextize.html +0 -93
  586. data/vendor/local/share/gtk-doc/html/glib/glib-regex-syntax.html +0 -2217
  587. data/vendor/local/share/gtk-doc/html/glib/glib-resources.html +0 -121
  588. data/vendor/local/share/gtk-doc/html/glib/glib-running.html +0 -319
  589. data/vendor/local/share/gtk-doc/html/glib/glib-utilities.html +0 -118
  590. data/vendor/local/share/gtk-doc/html/glib/glib.devhelp +0 -2183
  591. data/vendor/local/share/gtk-doc/html/glib/glib.devhelp2 +0 -2671
  592. data/vendor/local/share/gtk-doc/html/glib/glib.html +0 -80
  593. data/vendor/local/share/gtk-doc/html/glib/gtester-report.html +0 -72
  594. data/vendor/local/share/gtk-doc/html/glib/gtester.html +0 -131
  595. data/vendor/local/share/gtk-doc/html/glib/gvariant-format-strings.html +0 -1288
  596. data/vendor/local/share/gtk-doc/html/glib/home.png +0 -0
  597. data/vendor/local/share/gtk-doc/html/glib/index.html +0 -344
  598. data/vendor/local/share/gtk-doc/html/glib/index.sgml +0 -2846
  599. data/vendor/local/share/gtk-doc/html/glib/left.png +0 -0
  600. data/vendor/local/share/gtk-doc/html/glib/mainloop-states.gif +0 -0
  601. data/vendor/local/share/gtk-doc/html/glib/right.png +0 -0
  602. data/vendor/local/share/gtk-doc/html/glib/style.css +0 -265
  603. data/vendor/local/share/gtk-doc/html/glib/tools.html +0 -41
  604. data/vendor/local/share/gtk-doc/html/glib/up.png +0 -0
  605. data/vendor/local/share/gtk-doc/html/gobject/GBinding.html +0 -803
  606. data/vendor/local/share/gtk-doc/html/gobject/GTypeModule.html +0 -710
  607. data/vendor/local/share/gtk-doc/html/gobject/GTypePlugin.html +0 -453
  608. data/vendor/local/share/gtk-doc/html/gobject/annotation-glossary.html +0 -47
  609. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-10.html +0 -85
  610. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-12.html +0 -55
  611. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-14.html +0 -51
  612. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-18.html +0 -46
  613. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-2.html +0 -38
  614. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-22.html +0 -46
  615. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-24.html +0 -73
  616. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-26.html +0 -201
  617. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-4.html +0 -178
  618. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-6.html +0 -42
  619. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-8.html +0 -42
  620. data/vendor/local/share/gtk-doc/html/gobject/api-index-deprecated.html +0 -50
  621. data/vendor/local/share/gtk-doc/html/gobject/api-index-full.html +0 -2721
  622. data/vendor/local/share/gtk-doc/html/gobject/ch01s02.html +0 -136
  623. data/vendor/local/share/gtk-doc/html/gobject/ch06s03.html +0 -113
  624. data/vendor/local/share/gtk-doc/html/gobject/chapter-gobject.html +0 -293
  625. data/vendor/local/share/gtk-doc/html/gobject/chapter-gtype.html +0 -263
  626. data/vendor/local/share/gtk-doc/html/gobject/chapter-intro.html +0 -92
  627. data/vendor/local/share/gtk-doc/html/gobject/chapter-signal.html +0 -214
  628. data/vendor/local/share/gtk-doc/html/gobject/glib-genmarshal.html +0 -361
  629. data/vendor/local/share/gtk-doc/html/gobject/glib-mkenums.html +0 -307
  630. data/vendor/local/share/gtk-doc/html/gobject/glue.png +0 -0
  631. data/vendor/local/share/gtk-doc/html/gobject/gobject-Boxed-Types.html +0 -417
  632. data/vendor/local/share/gtk-doc/html/gobject/gobject-Closures.html +0 -2412
  633. data/vendor/local/share/gtk-doc/html/gobject/gobject-Enumeration-and-Flag-Types.html +0 -847
  634. data/vendor/local/share/gtk-doc/html/gobject/gobject-GParamSpec.html +0 -1433
  635. data/vendor/local/share/gtk-doc/html/gobject/gobject-Generic-values.html +0 -776
  636. data/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html +0 -2741
  637. data/vendor/local/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html +0 -5555
  638. data/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html +0 -2875
  639. data/vendor/local/share/gtk-doc/html/gobject/gobject-Type-Information.html +0 -4460
  640. data/vendor/local/share/gtk-doc/html/gobject/gobject-Value-arrays.html +0 -416
  641. data/vendor/local/share/gtk-doc/html/gobject/gobject-Varargs-Value-Collection.html +0 -260
  642. data/vendor/local/share/gtk-doc/html/gobject/gobject-memory.html +0 -234
  643. data/vendor/local/share/gtk-doc/html/gobject/gobject-properties.html +0 -270
  644. data/vendor/local/share/gtk-doc/html/gobject/gobject-query.html +0 -117
  645. data/vendor/local/share/gtk-doc/html/gobject/gobject.devhelp +0 -762
  646. data/vendor/local/share/gtk-doc/html/gobject/gobject.devhelp2 +0 -801
  647. data/vendor/local/share/gtk-doc/html/gobject/gtype-conventions.html +0 -143
  648. data/vendor/local/share/gtk-doc/html/gobject/gtype-instantiable-classed.html +0 -287
  649. data/vendor/local/share/gtk-doc/html/gobject/gtype-non-instantiable-classed.html +0 -316
  650. data/vendor/local/share/gtk-doc/html/gobject/gtype-non-instantiable.html +0 -76
  651. data/vendor/local/share/gtk-doc/html/gobject/home.png +0 -0
  652. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-chainup.html +0 -100
  653. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-code.html +0 -86
  654. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-construction.html +0 -113
  655. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-destruction.html +0 -122
  656. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-methods.html +0 -257
  657. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject.html +0 -283
  658. data/vendor/local/share/gtk-doc/html/gobject/howto-interface-implement.html +0 -125
  659. data/vendor/local/share/gtk-doc/html/gobject/howto-interface-properties.html +0 -167
  660. data/vendor/local/share/gtk-doc/html/gobject/howto-interface.html +0 -160
  661. data/vendor/local/share/gtk-doc/html/gobject/howto-signals.html +0 -121
  662. data/vendor/local/share/gtk-doc/html/gobject/index.html +0 -192
  663. data/vendor/local/share/gtk-doc/html/gobject/index.sgml +0 -786
  664. data/vendor/local/share/gtk-doc/html/gobject/left.png +0 -0
  665. data/vendor/local/share/gtk-doc/html/gobject/pr01.html +0 -72
  666. data/vendor/local/share/gtk-doc/html/gobject/pt01.html +0 -80
  667. data/vendor/local/share/gtk-doc/html/gobject/pt02.html +0 -66
  668. data/vendor/local/share/gtk-doc/html/gobject/pt03.html +0 -55
  669. data/vendor/local/share/gtk-doc/html/gobject/right.png +0 -0
  670. data/vendor/local/share/gtk-doc/html/gobject/rn01.html +0 -85
  671. data/vendor/local/share/gtk-doc/html/gobject/rn02.html +0 -47
  672. data/vendor/local/share/gtk-doc/html/gobject/signal.html +0 -377
  673. data/vendor/local/share/gtk-doc/html/gobject/style.css +0 -265
  674. data/vendor/local/share/gtk-doc/html/gobject/tools-ginspector.html +0 -35
  675. data/vendor/local/share/gtk-doc/html/gobject/tools-gob.html +0 -40
  676. data/vendor/local/share/gtk-doc/html/gobject/tools-gtkdoc.html +0 -63
  677. data/vendor/local/share/gtk-doc/html/gobject/tools-refdb.html +0 -55
  678. data/vendor/local/share/gtk-doc/html/gobject/tools-vala.html +0 -43
  679. data/vendor/local/share/gtk-doc/html/gobject/up.png +0 -0
  680. data/vendor/local/share/locale/af/LC_MESSAGES/glib20.mo +0 -0
  681. data/vendor/local/share/locale/am/LC_MESSAGES/glib20.mo +0 -0
  682. data/vendor/local/share/locale/ar/LC_MESSAGES/glib20.mo +0 -0
  683. data/vendor/local/share/locale/as/LC_MESSAGES/glib20.mo +0 -0
  684. data/vendor/local/share/locale/ast/LC_MESSAGES/glib20.mo +0 -0
  685. data/vendor/local/share/locale/az/LC_MESSAGES/glib20.mo +0 -0
  686. data/vendor/local/share/locale/be/LC_MESSAGES/gettext-runtime.mo +0 -0
  687. data/vendor/local/share/locale/be/LC_MESSAGES/glib20.mo +0 -0
  688. data/vendor/local/share/locale/be@latin/LC_MESSAGES/glib20.mo +0 -0
  689. data/vendor/local/share/locale/bg/LC_MESSAGES/gettext-runtime.mo +0 -0
  690. data/vendor/local/share/locale/bg/LC_MESSAGES/glib20.mo +0 -0
  691. data/vendor/local/share/locale/bn/LC_MESSAGES/glib20.mo +0 -0
  692. data/vendor/local/share/locale/bn_IN/LC_MESSAGES/glib20.mo +0 -0
  693. data/vendor/local/share/locale/bs/LC_MESSAGES/glib20.mo +0 -0
  694. data/vendor/local/share/locale/ca/LC_MESSAGES/gettext-runtime.mo +0 -0
  695. data/vendor/local/share/locale/ca/LC_MESSAGES/glib20.mo +0 -0
  696. data/vendor/local/share/locale/ca@valencia/LC_MESSAGES/glib20.mo +0 -0
  697. data/vendor/local/share/locale/cs/LC_MESSAGES/gettext-runtime.mo +0 -0
  698. data/vendor/local/share/locale/cs/LC_MESSAGES/glib20.mo +0 -0
  699. data/vendor/local/share/locale/cy/LC_MESSAGES/glib20.mo +0 -0
  700. data/vendor/local/share/locale/da/LC_MESSAGES/gettext-runtime.mo +0 -0
  701. data/vendor/local/share/locale/da/LC_MESSAGES/glib20.mo +0 -0
  702. data/vendor/local/share/locale/de/LC_MESSAGES/gettext-runtime.mo +0 -0
  703. data/vendor/local/share/locale/de/LC_MESSAGES/glib20.mo +0 -0
  704. data/vendor/local/share/locale/dz/LC_MESSAGES/glib20.mo +0 -0
  705. data/vendor/local/share/locale/el/LC_MESSAGES/gettext-runtime.mo +0 -0
  706. data/vendor/local/share/locale/el/LC_MESSAGES/glib20.mo +0 -0
  707. data/vendor/local/share/locale/en@boldquot/LC_MESSAGES/gettext-runtime.mo +0 -0
  708. data/vendor/local/share/locale/en@quot/LC_MESSAGES/gettext-runtime.mo +0 -0
  709. data/vendor/local/share/locale/en@shaw/LC_MESSAGES/glib20.mo +0 -0
  710. data/vendor/local/share/locale/en_CA/LC_MESSAGES/glib20.mo +0 -0
  711. data/vendor/local/share/locale/en_GB/LC_MESSAGES/glib20.mo +0 -0
  712. data/vendor/local/share/locale/eo/LC_MESSAGES/gettext-runtime.mo +0 -0
  713. data/vendor/local/share/locale/eo/LC_MESSAGES/glib20.mo +0 -0
  714. data/vendor/local/share/locale/es/LC_MESSAGES/gettext-runtime.mo +0 -0
  715. data/vendor/local/share/locale/es/LC_MESSAGES/glib20.mo +0 -0
  716. data/vendor/local/share/locale/et/LC_MESSAGES/gettext-runtime.mo +0 -0
  717. data/vendor/local/share/locale/et/LC_MESSAGES/glib20.mo +0 -0
  718. data/vendor/local/share/locale/eu/LC_MESSAGES/glib20.mo +0 -0
  719. data/vendor/local/share/locale/fa/LC_MESSAGES/glib20.mo +0 -0
  720. data/vendor/local/share/locale/fi/LC_MESSAGES/gettext-runtime.mo +0 -0
  721. data/vendor/local/share/locale/fi/LC_MESSAGES/glib20.mo +0 -0
  722. data/vendor/local/share/locale/fr/LC_MESSAGES/gettext-runtime.mo +0 -0
  723. data/vendor/local/share/locale/fr/LC_MESSAGES/glib20.mo +0 -0
  724. data/vendor/local/share/locale/ga/LC_MESSAGES/gettext-runtime.mo +0 -0
  725. data/vendor/local/share/locale/ga/LC_MESSAGES/glib20.mo +0 -0
  726. data/vendor/local/share/locale/gl/LC_MESSAGES/gettext-runtime.mo +0 -0
  727. data/vendor/local/share/locale/gl/LC_MESSAGES/glib20.mo +0 -0
  728. data/vendor/local/share/locale/gu/LC_MESSAGES/glib20.mo +0 -0
  729. data/vendor/local/share/locale/he/LC_MESSAGES/glib20.mo +0 -0
  730. data/vendor/local/share/locale/hi/LC_MESSAGES/glib20.mo +0 -0
  731. data/vendor/local/share/locale/hr/LC_MESSAGES/glib20.mo +0 -0
  732. data/vendor/local/share/locale/hu/LC_MESSAGES/glib20.mo +0 -0
  733. data/vendor/local/share/locale/hy/LC_MESSAGES/glib20.mo +0 -0
  734. data/vendor/local/share/locale/id/LC_MESSAGES/gettext-runtime.mo +0 -0
  735. data/vendor/local/share/locale/id/LC_MESSAGES/glib20.mo +0 -0
  736. data/vendor/local/share/locale/is/LC_MESSAGES/glib20.mo +0 -0
  737. data/vendor/local/share/locale/it/LC_MESSAGES/gettext-runtime.mo +0 -0
  738. data/vendor/local/share/locale/it/LC_MESSAGES/glib20.mo +0 -0
  739. data/vendor/local/share/locale/ja/LC_MESSAGES/gettext-runtime.mo +0 -0
  740. data/vendor/local/share/locale/ja/LC_MESSAGES/glib20.mo +0 -0
  741. data/vendor/local/share/locale/ka/LC_MESSAGES/glib20.mo +0 -0
  742. data/vendor/local/share/locale/kk/LC_MESSAGES/glib20.mo +0 -0
  743. data/vendor/local/share/locale/kn/LC_MESSAGES/glib20.mo +0 -0
  744. data/vendor/local/share/locale/ko/LC_MESSAGES/gettext-runtime.mo +0 -0
  745. data/vendor/local/share/locale/ko/LC_MESSAGES/glib20.mo +0 -0
  746. data/vendor/local/share/locale/ku/LC_MESSAGES/glib20.mo +0 -0
  747. data/vendor/local/share/locale/locale.alias +0 -77
  748. data/vendor/local/share/locale/lt/LC_MESSAGES/glib20.mo +0 -0
  749. data/vendor/local/share/locale/lv/LC_MESSAGES/glib20.mo +0 -0
  750. data/vendor/local/share/locale/mai/LC_MESSAGES/glib20.mo +0 -0
  751. data/vendor/local/share/locale/mg/LC_MESSAGES/glib20.mo +0 -0
  752. data/vendor/local/share/locale/mk/LC_MESSAGES/glib20.mo +0 -0
  753. data/vendor/local/share/locale/ml/LC_MESSAGES/glib20.mo +0 -0
  754. data/vendor/local/share/locale/mn/LC_MESSAGES/glib20.mo +0 -0
  755. data/vendor/local/share/locale/mr/LC_MESSAGES/glib20.mo +0 -0
  756. data/vendor/local/share/locale/ms/LC_MESSAGES/glib20.mo +0 -0
  757. data/vendor/local/share/locale/nb/LC_MESSAGES/gettext-runtime.mo +0 -0
  758. data/vendor/local/share/locale/nb/LC_MESSAGES/glib20.mo +0 -0
  759. data/vendor/local/share/locale/nds/LC_MESSAGES/glib20.mo +0 -0
  760. data/vendor/local/share/locale/ne/LC_MESSAGES/glib20.mo +0 -0
  761. data/vendor/local/share/locale/nl/LC_MESSAGES/gettext-runtime.mo +0 -0
  762. data/vendor/local/share/locale/nl/LC_MESSAGES/glib20.mo +0 -0
  763. data/vendor/local/share/locale/nn/LC_MESSAGES/gettext-runtime.mo +0 -0
  764. data/vendor/local/share/locale/nn/LC_MESSAGES/glib20.mo +0 -0
  765. data/vendor/local/share/locale/oc/LC_MESSAGES/glib20.mo +0 -0
  766. data/vendor/local/share/locale/or/LC_MESSAGES/glib20.mo +0 -0
  767. data/vendor/local/share/locale/pa/LC_MESSAGES/glib20.mo +0 -0
  768. data/vendor/local/share/locale/pl/LC_MESSAGES/gettext-runtime.mo +0 -0
  769. data/vendor/local/share/locale/pl/LC_MESSAGES/glib20.mo +0 -0
  770. data/vendor/local/share/locale/ps/LC_MESSAGES/glib20.mo +0 -0
  771. data/vendor/local/share/locale/pt/LC_MESSAGES/gettext-runtime.mo +0 -0
  772. data/vendor/local/share/locale/pt/LC_MESSAGES/glib20.mo +0 -0
  773. data/vendor/local/share/locale/pt_BR/LC_MESSAGES/gettext-runtime.mo +0 -0
  774. data/vendor/local/share/locale/pt_BR/LC_MESSAGES/glib20.mo +0 -0
  775. data/vendor/local/share/locale/ro/LC_MESSAGES/gettext-runtime.mo +0 -0
  776. data/vendor/local/share/locale/ro/LC_MESSAGES/glib20.mo +0 -0
  777. data/vendor/local/share/locale/ru/LC_MESSAGES/gettext-runtime.mo +0 -0
  778. data/vendor/local/share/locale/ru/LC_MESSAGES/glib20.mo +0 -0
  779. data/vendor/local/share/locale/rw/LC_MESSAGES/glib20.mo +0 -0
  780. data/vendor/local/share/locale/si/LC_MESSAGES/glib20.mo +0 -0
  781. data/vendor/local/share/locale/sk/LC_MESSAGES/gettext-runtime.mo +0 -0
  782. data/vendor/local/share/locale/sk/LC_MESSAGES/glib20.mo +0 -0
  783. data/vendor/local/share/locale/sl/LC_MESSAGES/gettext-runtime.mo +0 -0
  784. data/vendor/local/share/locale/sl/LC_MESSAGES/glib20.mo +0 -0
  785. data/vendor/local/share/locale/sq/LC_MESSAGES/glib20.mo +0 -0
  786. data/vendor/local/share/locale/sr/LC_MESSAGES/gettext-runtime.mo +0 -0
  787. data/vendor/local/share/locale/sr/LC_MESSAGES/glib20.mo +0 -0
  788. data/vendor/local/share/locale/sr@ije/LC_MESSAGES/glib20.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/gettext-runtime.mo +0 -0
  791. data/vendor/local/share/locale/sv/LC_MESSAGES/glib20.mo +0 -0
  792. data/vendor/local/share/locale/ta/LC_MESSAGES/glib20.mo +0 -0
  793. data/vendor/local/share/locale/te/LC_MESSAGES/glib20.mo +0 -0
  794. data/vendor/local/share/locale/th/LC_MESSAGES/glib20.mo +0 -0
  795. data/vendor/local/share/locale/tl/LC_MESSAGES/glib20.mo +0 -0
  796. data/vendor/local/share/locale/tr/LC_MESSAGES/gettext-runtime.mo +0 -0
  797. data/vendor/local/share/locale/tr/LC_MESSAGES/glib20.mo +0 -0
  798. data/vendor/local/share/locale/tt/LC_MESSAGES/glib20.mo +0 -0
  799. data/vendor/local/share/locale/uk/LC_MESSAGES/gettext-runtime.mo +0 -0
  800. data/vendor/local/share/locale/uk/LC_MESSAGES/glib20.mo +0 -0
  801. data/vendor/local/share/locale/vi/LC_MESSAGES/gettext-runtime.mo +0 -0
  802. data/vendor/local/share/locale/vi/LC_MESSAGES/glib20.mo +0 -0
  803. data/vendor/local/share/locale/wa/LC_MESSAGES/glib20.mo +0 -0
  804. data/vendor/local/share/locale/xh/LC_MESSAGES/glib20.mo +0 -0
  805. data/vendor/local/share/locale/yi/LC_MESSAGES/glib20.mo +0 -0
  806. data/vendor/local/share/locale/zh_CN/LC_MESSAGES/gettext-runtime.mo +0 -0
  807. data/vendor/local/share/locale/zh_CN/LC_MESSAGES/glib20.mo +0 -0
  808. data/vendor/local/share/locale/zh_HK/LC_MESSAGES/gettext-runtime.mo +0 -0
  809. data/vendor/local/share/locale/zh_HK/LC_MESSAGES/glib20.mo +0 -0
  810. data/vendor/local/share/locale/zh_TW/LC_MESSAGES/gettext-runtime.mo +0 -0
  811. data/vendor/local/share/locale/zh_TW/LC_MESSAGES/glib20.mo +0 -0
  812. data/vendor/local/share/man/man1/envsubst.1 +0 -54
  813. data/vendor/local/share/man/man1/gettext.1 +0 -69
  814. data/vendor/local/share/man/man1/glib-genmarshal.1 +0 -312
  815. data/vendor/local/share/man/man1/glib-mkenums.1 +0 -246
  816. data/vendor/local/share/man/man1/gobject-query.1 +0 -83
  817. data/vendor/local/share/man/man1/ngettext.1 +0 -68
  818. data/vendor/local/share/man/man3/bind_textdomain_codeset.3 +0 -72
  819. data/vendor/local/share/man/man3/bindtextdomain.3 +0 -69
  820. data/vendor/local/share/man/man3/dcgettext.3 +0 -1
  821. data/vendor/local/share/man/man3/dcngettext.3 +0 -1
  822. data/vendor/local/share/man/man3/dgettext.3 +0 -1
  823. data/vendor/local/share/man/man3/dngettext.3 +0 -1
  824. data/vendor/local/share/man/man3/gettext.3 +0 -99
  825. data/vendor/local/share/man/man3/ngettext.3 +0 -60
  826. data/vendor/local/share/man/man3/textdomain.3 +0 -57
  827. data/vendor/local/src/tml/packaging/gettext_0.18.1.1-2_win32.log +0 -10423
  828. data/vendor/local/src/tml/packaging/gettext_0.18.1.1-2_win32.sh +0 -457
  829. data/vendor/local/src/tml/packaging/glib_2.26.0-2_win32.log +0 -2867
  830. data/vendor/local/src/tml/packaging/glib_2.26.0-2_win32.sh +0 -64
@@ -1,1026 +0,0 @@
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.15.1 (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">
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">
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">
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 quark function for the error domain is called <code class="literal">&lt;namespace&gt;_&lt;module&gt;_error_quark</code>, for example <code class="function">g_spawn_error_quark()</code> or %<code class="function">g_thread_error_quark()</code>.
494
- </p></li>
495
- <li class="listitem"><p>
496
- The error codes are in an enumeration called
497
- <code class="literal">&lt;Namespace&gt;&lt;Module&gt;Error</code>; for example,
498
- <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>.
499
- </p></li>
500
- <li class="listitem"><p>
501
- 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>.
502
- </p></li>
503
- <li class="listitem"><p>
504
- If there's a "generic" or "unknown" error code for unrecoverable errors it
505
- doesn't make sense to distinguish with specific codes, it should be called
506
- <code class="literal">&lt;NAMESPACE&gt;_&lt;MODULE&gt;_ERROR_FAILED</code>, for
507
- 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>.
508
- </p></li>
509
- </ul></div>
510
- <p>
511
- </p>
512
- <p>
513
- Summary of rules for use of <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>:
514
- </p>
515
- <div class="itemizedlist"><ul class="itemizedlist" type="disc">
516
- <li class="listitem"><p>
517
- Do not report programming errors via <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>.
518
- </p></li>
519
- <li class="listitem"><p>
520
- The last argument of a function that returns an error should be a
521
- 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
522
- <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
523
- argument before the "...".
524
- </p></li>
525
- <li class="listitem"><p>
526
- 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
527
- in details of the exact error that occurred.
528
- </p></li>
529
- <li class="listitem"><p>
530
- 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
531
- not be returned to the caller, but your function should still
532
- abort and return if an error occurs. That is, control flow should
533
- 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>.
534
- </p></li>
535
- <li class="listitem"><p>
536
- 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
537
- <span class="emphasis"><em>had a fatal failure and did not complete whatever it was supposed
538
- to do</em></span>. If the failure was not fatal, then you handled it
539
- and you should not report it. If it was fatal, then you must report it
540
- and discontinue whatever you were doing immediately.
541
- </p></li>
542
- <li class="listitem"><p>
543
- 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
544
- a function that can report errors.
545
- </p></li>
546
- <li class="listitem"><p>
547
- "Piling up" errors is always a bug. That is, if you assign a new
548
- <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
549
- error, it indicates that you should have aborted the operation instead
550
- of continuing. If you were able to continue, you should have cleared
551
- 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
552
- if you pile up errors.
553
- </p></li>
554
- <li class="listitem"><p>
555
- By convention, if you return a boolean value indicating success
556
- 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,
557
- 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.
558
- </p></li>
559
- <li class="listitem"><p>
560
- 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
561
- 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
562
- 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,
563
- then users must check whether an error was returned to see if the
564
- function succeeded.
565
- </p></li>
566
- <li class="listitem"><p>
567
- When implementing a function that can report errors, you may want to
568
- add a check at the top of your function that the error return location
569
- 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
570
- (e.g. <code class="literal">g_return_if_fail (error == NULL || *error ==
571
- NULL);</code>).
572
- </p></li>
573
- </ul></div>
574
- <p>
575
- </p>
576
- </div>
577
- <div class="refsect1">
578
- <a name="glib-Error-Reporting.details"></a><h2>Details</h2>
579
- <div class="refsect2">
580
- <a name="GError"></a><h3>GError</h3>
581
- <pre class="programlisting">typedef struct {
582
- GQuark domain;
583
- gint code;
584
- gchar *message;
585
- } GError;
586
- </pre>
587
- <p>
588
- The <span class="structname">GError</span> structure contains
589
- information about an error that has occurred.
590
- </p>
591
- <div class="variablelist"><table border="0">
592
- <col align="left" valign="top">
593
- <tbody>
594
- <tr>
595
- <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>
596
- <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>.
597
- </td>
598
- </tr>
599
- <tr>
600
- <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>
601
- <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>.
602
- </td>
603
- </tr>
604
- <tr>
605
- <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>
606
- <td>human-readable informative error message.
607
- </td>
608
- </tr>
609
- </tbody>
610
- </table></div>
611
- </div>
612
- <hr>
613
- <div class="refsect2">
614
- <a name="g-error-new"></a><h3>g_error_new ()</h3>
615
- <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>,
616
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> code</code></em>,
617
- <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>,
618
- <em class="parameter"><code>...</code></em>);</pre>
619
- <p>
620
- 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>,
621
- and a message formatted with <em class="parameter"><code>format</code></em>.
622
- </p>
623
- <div class="variablelist"><table border="0">
624
- <col align="left" valign="top">
625
- <tbody>
626
- <tr>
627
- <td><p><span class="term"><em class="parameter"><code>domain</code></em> :</span></p></td>
628
- <td>error domain
629
- </td>
630
- </tr>
631
- <tr>
632
- <td><p><span class="term"><em class="parameter"><code>code</code></em> :</span></p></td>
633
- <td>error code
634
- </td>
635
- </tr>
636
- <tr>
637
- <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
638
- <td>printf()-style format for error message
639
- </td>
640
- </tr>
641
- <tr>
642
- <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
643
- <td>parameters for message format
644
- </td>
645
- </tr>
646
- <tr>
647
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
648
- <td> a new <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>
649
- </td>
650
- </tr>
651
- </tbody>
652
- </table></div>
653
- </div>
654
- <hr>
655
- <div class="refsect2">
656
- <a name="g-error-new-literal"></a><h3>g_error_new_literal ()</h3>
657
- <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>,
658
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> code</code></em>,
659
- <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>
660
- <p>
661
- 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
662
- not a <code class="function">printf()</code>-style format string. Use this function if
663
- <em class="parameter"><code>message</code></em> contains text you don't have control over,
664
- that could include <code class="function">printf()</code> escape sequences.
665
- </p>
666
- <div class="variablelist"><table border="0">
667
- <col align="left" valign="top">
668
- <tbody>
669
- <tr>
670
- <td><p><span class="term"><em class="parameter"><code>domain</code></em> :</span></p></td>
671
- <td>error domain
672
- </td>
673
- </tr>
674
- <tr>
675
- <td><p><span class="term"><em class="parameter"><code>code</code></em> :</span></p></td>
676
- <td>error code
677
- </td>
678
- </tr>
679
- <tr>
680
- <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
681
- <td>error message
682
- </td>
683
- </tr>
684
- <tr>
685
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
686
- <td> a new <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>
687
- </td>
688
- </tr>
689
- </tbody>
690
- </table></div>
691
- </div>
692
- <hr>
693
- <div class="refsect2">
694
- <a name="g-error-new-valist"></a><h3>g_error_new_valist ()</h3>
695
- <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>,
696
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> code</code></em>,
697
- <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>,
698
- <em class="parameter"><code><span class="type">va_list</span> args</code></em>);</pre>
699
- <p>
700
- 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>,
701
- and a message formatted with <em class="parameter"><code>format</code></em>.
702
- </p>
703
- <div class="variablelist"><table border="0">
704
- <col align="left" valign="top">
705
- <tbody>
706
- <tr>
707
- <td><p><span class="term"><em class="parameter"><code>domain</code></em> :</span></p></td>
708
- <td>error domain
709
- </td>
710
- </tr>
711
- <tr>
712
- <td><p><span class="term"><em class="parameter"><code>code</code></em> :</span></p></td>
713
- <td>error code
714
- </td>
715
- </tr>
716
- <tr>
717
- <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
718
- <td>printf()-style format for error message
719
- </td>
720
- </tr>
721
- <tr>
722
- <td><p><span class="term"><em class="parameter"><code>args</code></em> :</span></p></td>
723
- <td>
724
- <span class="type">va_list</span> of parameters for the message format
725
- </td>
726
- </tr>
727
- <tr>
728
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
729
- <td> a new <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>
730
-
731
- </td>
732
- </tr>
733
- </tbody>
734
- </table></div>
735
- <p class="since">Since 2.22</p>
736
- </div>
737
- <hr>
738
- <div class="refsect2">
739
- <a name="g-error-free"></a><h3>g_error_free ()</h3>
740
- <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>
741
- <p>
742
- Frees a <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> and associated resources.
743
- </p>
744
- <div class="variablelist"><table border="0">
745
- <col align="left" valign="top">
746
- <tbody><tr>
747
- <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
748
- <td>a <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>
749
- </td>
750
- </tr></tbody>
751
- </table></div>
752
- </div>
753
- <hr>
754
- <div class="refsect2">
755
- <a name="g-error-copy"></a><h3>g_error_copy ()</h3>
756
- <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>
757
- <p>
758
- Makes a copy of <em class="parameter"><code>error</code></em>.
759
- </p>
760
- <div class="variablelist"><table border="0">
761
- <col align="left" valign="top">
762
- <tbody>
763
- <tr>
764
- <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
765
- <td>a <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>
766
- </td>
767
- </tr>
768
- <tr>
769
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
770
- <td> a new <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>
771
- </td>
772
- </tr>
773
- </tbody>
774
- </table></div>
775
- </div>
776
- <hr>
777
- <div class="refsect2">
778
- <a name="g-error-matches"></a><h3>g_error_matches ()</h3>
779
- <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>,
780
- <em class="parameter"><code><a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> domain</code></em>,
781
- <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>
782
- <p>
783
- 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>
784
- 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
785
- be returned.
786
- </p>
787
- <div class="variablelist"><table border="0">
788
- <col align="left" valign="top">
789
- <tbody>
790
- <tr>
791
- <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
792
- <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>
793
- </td>
794
- </tr>
795
- <tr>
796
- <td><p><span class="term"><em class="parameter"><code>domain</code></em> :</span></p></td>
797
- <td>an error domain
798
- </td>
799
- </tr>
800
- <tr>
801
- <td><p><span class="term"><em class="parameter"><code>code</code></em> :</span></p></td>
802
- <td>an error code
803
- </td>
804
- </tr>
805
- <tr>
806
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
807
- <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>
808
- </td>
809
- </tr>
810
- </tbody>
811
- </table></div>
812
- </div>
813
- <hr>
814
- <div class="refsect2">
815
- <a name="g-set-error"></a><h3>g_set_error ()</h3>
816
- <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>,
817
- <em class="parameter"><code><a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> domain</code></em>,
818
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> code</code></em>,
819
- <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>,
820
- <em class="parameter"><code>...</code></em>);</pre>
821
- <p>
822
- 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>
823
- 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>.
824
- </p>
825
- <div class="variablelist"><table border="0">
826
- <col align="left" valign="top">
827
- <tbody>
828
- <tr>
829
- <td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
830
- <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>
831
- </td>
832
- </tr>
833
- <tr>
834
- <td><p><span class="term"><em class="parameter"><code>domain</code></em> :</span></p></td>
835
- <td>error domain
836
- </td>
837
- </tr>
838
- <tr>
839
- <td><p><span class="term"><em class="parameter"><code>code</code></em> :</span></p></td>
840
- <td>error code
841
- </td>
842
- </tr>
843
- <tr>
844
- <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
845
- <td>printf()-style format
846
- </td>
847
- </tr>
848
- <tr>
849
- <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
850
- <td>args for <em class="parameter"><code>format</code></em>
851
- </td>
852
- </tr>
853
- </tbody>
854
- </table></div>
855
- </div>
856
- <hr>
857
- <div class="refsect2">
858
- <a name="g-set-error-literal"></a><h3>g_set_error_literal ()</h3>
859
- <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>,
860
- <em class="parameter"><code><a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> domain</code></em>,
861
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> code</code></em>,
862
- <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>
863
- <p>
864
- 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>
865
- 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>.
866
- 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.
867
- Use this function if <em class="parameter"><code>message</code></em> contains text you don't have control over,
868
- that could include <code class="function">printf()</code> escape sequences.
869
- </p>
870
- <div class="variablelist"><table border="0">
871
- <col align="left" valign="top">
872
- <tbody>
873
- <tr>
874
- <td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
875
- <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>
876
- </td>
877
- </tr>
878
- <tr>
879
- <td><p><span class="term"><em class="parameter"><code>domain</code></em> :</span></p></td>
880
- <td>error domain
881
- </td>
882
- </tr>
883
- <tr>
884
- <td><p><span class="term"><em class="parameter"><code>code</code></em> :</span></p></td>
885
- <td>error code
886
- </td>
887
- </tr>
888
- <tr>
889
- <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
890
- <td>error message
891
- </td>
892
- </tr>
893
- </tbody>
894
- </table></div>
895
- <p class="since">Since 2.18</p>
896
- </div>
897
- <hr>
898
- <div class="refsect2">
899
- <a name="g-propagate-error"></a><h3>g_propagate_error ()</h3>
900
- <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>,
901
- <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>
902
- <p>
903
- 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>.
904
- 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>.
905
- </p>
906
- <div class="variablelist"><table border="0">
907
- <col align="left" valign="top">
908
- <tbody>
909
- <tr>
910
- <td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td>
911
- <td>error return location
912
- </td>
913
- </tr>
914
- <tr>
915
- <td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td>
916
- <td>error to move into the return location
917
- </td>
918
- </tr>
919
- </tbody>
920
- </table></div>
921
- </div>
922
- <hr>
923
- <div class="refsect2">
924
- <a name="g-clear-error"></a><h3>g_clear_error ()</h3>
925
- <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>
926
- <p>
927
- 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>,
928
- 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>.
929
- </p>
930
- <div class="variablelist"><table border="0">
931
- <col align="left" valign="top">
932
- <tbody><tr>
933
- <td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
934
- <td>a <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> return location
935
- </td>
936
- </tr></tbody>
937
- </table></div>
938
- </div>
939
- <hr>
940
- <div class="refsect2">
941
- <a name="g-prefix-error"></a><h3>g_prefix_error ()</h3>
942
- <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>,
943
- <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>,
944
- <em class="parameter"><code>...</code></em>);</pre>
945
- <p>
946
- Formats a string according to <em class="parameter"><code>format</code></em> and
947
- prefix it to an existing error message. If
948
- <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
949
- nothing.
950
- </p>
951
- <p>
952
- 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
953
- present but there is no error condition) then
954
- also do nothing. Whether or not it makes
955
- sense to take advantage of this feature is up
956
- to you.
957
- </p>
958
- <div class="variablelist"><table border="0">
959
- <col align="left" valign="top">
960
- <tbody>
961
- <tr>
962
- <td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
963
- <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>
964
- </td>
965
- </tr>
966
- <tr>
967
- <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
968
- <td>printf()-style format string
969
- </td>
970
- </tr>
971
- <tr>
972
- <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
973
- <td>arguments to <em class="parameter"><code>format</code></em>
974
- </td>
975
- </tr>
976
- </tbody>
977
- </table></div>
978
- <p class="since">Since 2.16</p>
979
- </div>
980
- <hr>
981
- <div class="refsect2">
982
- <a name="g-propagate-prefixed-error"></a><h3>g_propagate_prefixed_error ()</h3>
983
- <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>,
984
- <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> *src</code></em>,
985
- <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>,
986
- <em class="parameter"><code>...</code></em>);</pre>
987
- <p>
988
- 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,
989
- 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>.
990
- After the move, add a prefix as with
991
- <a class="link" href="glib-Error-Reporting.html#g-prefix-error" title="g_prefix_error ()"><code class="function">g_prefix_error()</code></a>.
992
- </p>
993
- <div class="variablelist"><table border="0">
994
- <col align="left" valign="top">
995
- <tbody>
996
- <tr>
997
- <td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td>
998
- <td>error return location
999
- </td>
1000
- </tr>
1001
- <tr>
1002
- <td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td>
1003
- <td>error to move into the return location
1004
- </td>
1005
- </tr>
1006
- <tr>
1007
- <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
1008
- <td>printf()-style format string
1009
- </td>
1010
- </tr>
1011
- <tr>
1012
- <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
1013
- <td>arguments to <em class="parameter"><code>format</code></em>
1014
- </td>
1015
- </tr>
1016
- </tbody>
1017
- </table></div>
1018
- <p class="since">Since 2.16</p>
1019
- </div>
1020
- </div>
1021
- </div>
1022
- <div class="footer">
1023
- <hr>
1024
- Generated by GTK-Doc V1.15.1</div>
1025
- </body>
1026
- </html>