atk 0.90.5-x86-mingw32 → 0.90.6-x86-mingw32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (765) hide show
  1. data/ChangeLog +9 -0
  2. data/Rakefile +8 -70
  3. data/ext/atk/Makefile +160 -0
  4. data/ext/atk/extconf.rb +9 -9
  5. data/ext/atk/rbatkversion.h +24 -0
  6. data/lib/1.8/atk.so +0 -0
  7. data/lib/1.9/atk.so +0 -0
  8. data/vendor/local/lib/pkgconfig/atk.pc +1 -1
  9. metadata +150 -902
  10. data/vendor/local/bin/envsubst.exe +0 -0
  11. data/vendor/local/bin/gettext.exe +0 -0
  12. data/vendor/local/bin/gettext.sh +0 -123
  13. data/vendor/local/bin/glib-genmarshal.exe +0 -0
  14. data/vendor/local/bin/glib-gettextize +0 -188
  15. data/vendor/local/bin/glib-mkenums +0 -537
  16. data/vendor/local/bin/gobject-query.exe +0 -0
  17. data/vendor/local/bin/gspawn-win32-helper-console.exe +0 -0
  18. data/vendor/local/bin/gspawn-win32-helper.exe +0 -0
  19. data/vendor/local/bin/intl.dll +0 -0
  20. data/vendor/local/bin/libasprintf-0.dll +0 -0
  21. data/vendor/local/bin/libgcc_s_dw2-1.dll +0 -0
  22. data/vendor/local/bin/libgio-2.0-0.dll +0 -0
  23. data/vendor/local/bin/libglib-2.0-0.dll +0 -0
  24. data/vendor/local/bin/libgmodule-2.0-0.dll +0 -0
  25. data/vendor/local/bin/libgobject-2.0-0.dll +0 -0
  26. data/vendor/local/bin/libgthread-2.0-0.dll +0 -0
  27. data/vendor/local/bin/ngettext.exe +0 -0
  28. data/vendor/local/include/autosprintf.h +0 -66
  29. data/vendor/local/include/glib-2.0/gio/gappinfo.h +0 -236
  30. data/vendor/local/include/glib-2.0/gio/gasyncinitable.h +0 -119
  31. data/vendor/local/include/glib-2.0/gio/gasyncresult.h +0 -73
  32. data/vendor/local/include/glib-2.0/gio/gbufferedinputstream.h +0 -123
  33. data/vendor/local/include/glib-2.0/gio/gbufferedoutputstream.h +0 -81
  34. data/vendor/local/include/glib-2.0/gio/gcancellable.h +0 -103
  35. data/vendor/local/include/glib-2.0/gio/gcharsetconverter.h +0 -60
  36. data/vendor/local/include/glib-2.0/gio/gcontenttype.h +0 -57
  37. data/vendor/local/include/glib-2.0/gio/gconverter.h +0 -95
  38. data/vendor/local/include/glib-2.0/gio/gconverterinputstream.h +0 -79
  39. data/vendor/local/include/glib-2.0/gio/gconverteroutputstream.h +0 -79
  40. data/vendor/local/include/glib-2.0/gio/gcredentials.h +0 -76
  41. data/vendor/local/include/glib-2.0/gio/gdatainputstream.h +0 -150
  42. data/vendor/local/include/glib-2.0/gio/gdataoutputstream.h +0 -115
  43. data/vendor/local/include/glib-2.0/gio/gdbusaddress.h +0 -58
  44. data/vendor/local/include/glib-2.0/gio/gdbusauthobserver.h +0 -46
  45. data/vendor/local/include/glib-2.0/gio/gdbusconnection.h +0 -562
  46. data/vendor/local/include/glib-2.0/gio/gdbuserror.h +0 -100
  47. data/vendor/local/include/glib-2.0/gio/gdbusintrospection.h +0 -286
  48. data/vendor/local/include/glib-2.0/gio/gdbusmessage.h +0 -149
  49. data/vendor/local/include/glib-2.0/gio/gdbusmethodinvocation.h +0 -73
  50. data/vendor/local/include/glib-2.0/gio/gdbusnameowning.h +0 -112
  51. data/vendor/local/include/glib-2.0/gio/gdbusnamewatching.h +0 -94
  52. data/vendor/local/include/glib-2.0/gio/gdbusproxy.h +0 -167
  53. data/vendor/local/include/glib-2.0/gio/gdbusserver.h +0 -54
  54. data/vendor/local/include/glib-2.0/gio/gdbusutils.h +0 -44
  55. data/vendor/local/include/glib-2.0/gio/gdrive.h +0 -225
  56. data/vendor/local/include/glib-2.0/gio/gemblem.h +0 -58
  57. data/vendor/local/include/glib-2.0/gio/gemblemedicon.h +0 -62
  58. data/vendor/local/include/glib-2.0/gio/gfile.h +0 -1017
  59. data/vendor/local/include/glib-2.0/gio/gfileattribute.h +0 -77
  60. data/vendor/local/include/glib-2.0/gio/gfileenumerator.h +0 -132
  61. data/vendor/local/include/glib-2.0/gio/gfileicon.h +0 -56
  62. data/vendor/local/include/glib-2.0/gio/gfileinfo.h +0 -952
  63. data/vendor/local/include/glib-2.0/gio/gfileinputstream.h +0 -112
  64. data/vendor/local/include/glib-2.0/gio/gfileiostream.h +0 -118
  65. data/vendor/local/include/glib-2.0/gio/gfilemonitor.h +0 -95
  66. data/vendor/local/include/glib-2.0/gio/gfilenamecompleter.h +0 -76
  67. data/vendor/local/include/glib-2.0/gio/gfileoutputstream.h +0 -119
  68. data/vendor/local/include/glib-2.0/gio/gfilterinputstream.h +0 -76
  69. data/vendor/local/include/glib-2.0/gio/gfilteroutputstream.h +0 -76
  70. data/vendor/local/include/glib-2.0/gio/gicon.h +0 -91
  71. data/vendor/local/include/glib-2.0/gio/ginetaddress.h +0 -103
  72. data/vendor/local/include/glib-2.0/gio/ginetsocketaddress.h +0 -69
  73. data/vendor/local/include/glib-2.0/gio/ginitable.h +0 -96
  74. data/vendor/local/include/glib-2.0/gio/ginputstream.h +0 -172
  75. data/vendor/local/include/glib-2.0/gio/gio.h +0 -122
  76. data/vendor/local/include/glib-2.0/gio/gioenums.h +0 -1221
  77. data/vendor/local/include/glib-2.0/gio/gioenumtypes.h +0 -121
  78. data/vendor/local/include/glib-2.0/gio/gioerror.h +0 -52
  79. data/vendor/local/include/glib-2.0/gio/giomodule.h +0 -132
  80. data/vendor/local/include/glib-2.0/gio/gioscheduler.h +0 -52
  81. data/vendor/local/include/glib-2.0/gio/giostream.h +0 -112
  82. data/vendor/local/include/glib-2.0/gio/giotypes.h +0 -375
  83. data/vendor/local/include/glib-2.0/gio/gloadableicon.h +0 -97
  84. data/vendor/local/include/glib-2.0/gio/gmemoryinputstream.h +0 -82
  85. data/vendor/local/include/glib-2.0/gio/gmemoryoutputstream.h +0 -98
  86. data/vendor/local/include/glib-2.0/gio/gmount.h +0 -242
  87. data/vendor/local/include/glib-2.0/gio/gmountoperation.h +0 -123
  88. data/vendor/local/include/glib-2.0/gio/gnativevolumemonitor.h +0 -62
  89. data/vendor/local/include/glib-2.0/gio/gnetworkaddress.h +0 -73
  90. data/vendor/local/include/glib-2.0/gio/gnetworkservice.h +0 -71
  91. data/vendor/local/include/glib-2.0/gio/goutputstream.h +0 -207
  92. data/vendor/local/include/glib-2.0/gio/gpermission.h +0 -118
  93. data/vendor/local/include/glib-2.0/gio/gproxy.h +0 -123
  94. data/vendor/local/include/glib-2.0/gio/gproxyaddress.h +0 -76
  95. data/vendor/local/include/glib-2.0/gio/gproxyaddressenumerator.h +0 -75
  96. data/vendor/local/include/glib-2.0/gio/gproxyresolver.h +0 -96
  97. data/vendor/local/include/glib-2.0/gio/gresolver.h +0 -167
  98. data/vendor/local/include/glib-2.0/gio/gseekable.h +0 -99
  99. data/vendor/local/include/glib-2.0/gio/gsettings.h +0 -258
  100. data/vendor/local/include/glib-2.0/gio/gsettingsbackend.h +0 -138
  101. data/vendor/local/include/glib-2.0/gio/gsimpleasyncresult.h +0 -125
  102. data/vendor/local/include/glib-2.0/gio/gsimplepermission.h +0 -45
  103. data/vendor/local/include/glib-2.0/gio/gsocket.h +0 -194
  104. data/vendor/local/include/glib-2.0/gio/gsocketaddress.h +0 -79
  105. data/vendor/local/include/glib-2.0/gio/gsocketaddressenumerator.h +0 -89
  106. data/vendor/local/include/glib-2.0/gio/gsocketclient.h +0 -152
  107. data/vendor/local/include/glib-2.0/gio/gsocketconnectable.h +0 -74
  108. data/vendor/local/include/glib-2.0/gio/gsocketconnection.h +0 -91
  109. data/vendor/local/include/glib-2.0/gio/gsocketcontrolmessage.h +0 -105
  110. data/vendor/local/include/glib-2.0/gio/gsocketlistener.h +0 -138
  111. data/vendor/local/include/glib-2.0/gio/gsocketservice.h +0 -88
  112. data/vendor/local/include/glib-2.0/gio/gsrvtarget.h +0 -52
  113. data/vendor/local/include/glib-2.0/gio/gtcpconnection.h +0 -68
  114. data/vendor/local/include/glib-2.0/gio/gthemedicon.h +0 -63
  115. data/vendor/local/include/glib-2.0/gio/gthreadedsocketservice.h +0 -81
  116. data/vendor/local/include/glib-2.0/gio/gvfs.h +0 -125
  117. data/vendor/local/include/glib-2.0/gio/gvolume.h +0 -211
  118. data/vendor/local/include/glib-2.0/gio/gvolumemonitor.h +0 -150
  119. data/vendor/local/include/glib-2.0/gio/gzlibcompressor.h +0 -60
  120. data/vendor/local/include/glib-2.0/gio/gzlibdecompressor.h +0 -57
  121. data/vendor/local/include/glib-2.0/glib-object.h +0 -42
  122. data/vendor/local/include/glib-2.0/glib.h +0 -99
  123. data/vendor/local/include/glib-2.0/glib/galloca.h +0 -110
  124. data/vendor/local/include/glib-2.0/glib/garray.h +0 -179
  125. data/vendor/local/include/glib-2.0/glib/gasyncqueue.h +0 -120
  126. data/vendor/local/include/glib-2.0/glib/gatomic.h +0 -105
  127. data/vendor/local/include/glib-2.0/glib/gbacktrace.h +0 -68
  128. data/vendor/local/include/glib-2.0/glib/gbase64.h +0 -57
  129. data/vendor/local/include/glib-2.0/glib/gbitlock.h +0 -43
  130. data/vendor/local/include/glib-2.0/glib/gbookmarkfile.h +0 -215
  131. data/vendor/local/include/glib-2.0/glib/gcache.h +0 -69
  132. data/vendor/local/include/glib-2.0/glib/gchecksum.h +0 -86
  133. data/vendor/local/include/glib-2.0/glib/gcompletion.h +0 -81
  134. data/vendor/local/include/glib-2.0/glib/gconvert.h +0 -162
  135. data/vendor/local/include/glib-2.0/glib/gdataset.h +0 -122
  136. data/vendor/local/include/glib-2.0/glib/gdate.h +0 -263
  137. data/vendor/local/include/glib-2.0/glib/gdatetime.h +0 -217
  138. data/vendor/local/include/glib-2.0/glib/gdir.h +0 -52
  139. data/vendor/local/include/glib-2.0/glib/gerror.h +0 -98
  140. data/vendor/local/include/glib-2.0/glib/gfileutils.h +0 -128
  141. data/vendor/local/include/glib-2.0/glib/ghash.h +0 -166
  142. data/vendor/local/include/glib-2.0/glib/ghook.h +0 -181
  143. data/vendor/local/include/glib-2.0/glib/ghostutils.h +0 -40
  144. data/vendor/local/include/glib-2.0/glib/gi18n-lib.h +0 -38
  145. data/vendor/local/include/glib-2.0/glib/gi18n.h +0 -34
  146. data/vendor/local/include/glib-2.0/glib/giochannel.h +0 -366
  147. data/vendor/local/include/glib-2.0/glib/gkeyfile.h +0 -266
  148. data/vendor/local/include/glib-2.0/glib/glist.h +0 -120
  149. data/vendor/local/include/glib-2.0/glib/gmacros.h +0 -284
  150. data/vendor/local/include/glib-2.0/glib/gmain.h +0 -531
  151. data/vendor/local/include/glib-2.0/glib/gmappedfile.h +0 -49
  152. data/vendor/local/include/glib-2.0/glib/gmarkup.h +0 -163
  153. data/vendor/local/include/glib-2.0/glib/gmem.h +0 -309
  154. data/vendor/local/include/glib-2.0/glib/gmessages.h +0 -343
  155. data/vendor/local/include/glib-2.0/glib/gnode.h +0 -290
  156. data/vendor/local/include/glib-2.0/glib/goption.h +0 -370
  157. data/vendor/local/include/glib-2.0/glib/gpattern.h +0 -49
  158. data/vendor/local/include/glib-2.0/glib/gpoll.h +0 -117
  159. data/vendor/local/include/glib-2.0/glib/gprimes.h +0 -51
  160. data/vendor/local/include/glib-2.0/glib/gprintf.h +0 -52
  161. data/vendor/local/include/glib-2.0/glib/gqsort.h +0 -46
  162. data/vendor/local/include/glib-2.0/glib/gquark.h +0 -52
  163. data/vendor/local/include/glib-2.0/glib/gqueue.h +0 -127
  164. data/vendor/local/include/glib-2.0/glib/grand.h +0 -85
  165. data/vendor/local/include/glib-2.0/glib/gregex.h +0 -471
  166. data/vendor/local/include/glib-2.0/glib/grel.h +0 -101
  167. data/vendor/local/include/glib-2.0/glib/gscanner.h +0 -278
  168. data/vendor/local/include/glib-2.0/glib/gsequence.h +0 -128
  169. data/vendor/local/include/glib-2.0/glib/gshell.h +0 -55
  170. data/vendor/local/include/glib-2.0/glib/gslice.h +0 -86
  171. data/vendor/local/include/glib-2.0/glib/gslist.h +0 -114
  172. data/vendor/local/include/glib-2.0/glib/gspawn.h +0 -139
  173. data/vendor/local/include/glib-2.0/glib/gstdio.h +0 -147
  174. data/vendor/local/include/glib-2.0/glib/gstrfuncs.h +0 -269
  175. data/vendor/local/include/glib-2.0/glib/gstring.h +0 -178
  176. data/vendor/local/include/glib-2.0/glib/gtestutils.h +0 -297
  177. data/vendor/local/include/glib-2.0/glib/gthread.h +0 -407
  178. data/vendor/local/include/glib-2.0/glib/gthreadpool.h +0 -114
  179. data/vendor/local/include/glib-2.0/glib/gtimer.h +0 -65
  180. data/vendor/local/include/glib-2.0/glib/gtimezone.h +0 -44
  181. data/vendor/local/include/glib-2.0/glib/gtree.h +0 -91
  182. data/vendor/local/include/glib-2.0/glib/gtypes.h +0 -451
  183. data/vendor/local/include/glib-2.0/glib/gunicode.h +0 -421
  184. data/vendor/local/include/glib-2.0/glib/gurifuncs.h +0 -81
  185. data/vendor/local/include/glib-2.0/glib/gutils.h +0 -490
  186. data/vendor/local/include/glib-2.0/glib/gvariant.h +0 -248
  187. data/vendor/local/include/glib-2.0/glib/gvarianttype.h +0 -334
  188. data/vendor/local/include/glib-2.0/glib/gwin32.h +0 -114
  189. data/vendor/local/include/glib-2.0/gmodule.h +0 -101
  190. data/vendor/local/include/glib-2.0/gobject/gbinding.h +0 -136
  191. data/vendor/local/include/glib-2.0/gobject/gboxed.h +0 -248
  192. data/vendor/local/include/glib-2.0/gobject/gclosure.h +0 -251
  193. data/vendor/local/include/glib-2.0/gobject/genums.h +0 -261
  194. data/vendor/local/include/glib-2.0/gobject/gmarshal.h +0 -186
  195. data/vendor/local/include/glib-2.0/gobject/gobject.h +0 -567
  196. data/vendor/local/include/glib-2.0/gobject/gobjectnotifyqueue.c +0 -193
  197. data/vendor/local/include/glib-2.0/gobject/gparam.h +0 -415
  198. data/vendor/local/include/glib-2.0/gobject/gparamspecs.h +0 -1137
  199. data/vendor/local/include/glib-2.0/gobject/gsignal.h +0 -509
  200. data/vendor/local/include/glib-2.0/gobject/gsourceclosure.h +0 -51
  201. data/vendor/local/include/glib-2.0/gobject/gtype.h +0 -1736
  202. data/vendor/local/include/glib-2.0/gobject/gtypemodule.h +0 -263
  203. data/vendor/local/include/glib-2.0/gobject/gtypeplugin.h +0 -134
  204. data/vendor/local/include/glib-2.0/gobject/gvalue.h +0 -159
  205. data/vendor/local/include/glib-2.0/gobject/gvaluearray.h +0 -77
  206. data/vendor/local/include/glib-2.0/gobject/gvaluecollector.h +0 -227
  207. data/vendor/local/include/glib-2.0/gobject/gvaluetypes.h +0 -260
  208. data/vendor/local/include/libintl.h +0 -464
  209. data/vendor/local/lib/GNU.Gettext.dll +0 -0
  210. data/vendor/local/lib/gio-2.0.def +0 -1143
  211. data/vendor/local/lib/gio-2.0.lib +0 -0
  212. data/vendor/local/lib/glib-2.0.def +0 -1452
  213. data/vendor/local/lib/glib-2.0.lib +0 -0
  214. data/vendor/local/lib/glib-2.0/include/glibconfig.h +0 -284
  215. data/vendor/local/lib/gmodule-2.0.def +0 -11
  216. data/vendor/local/lib/gmodule-2.0.lib +0 -0
  217. data/vendor/local/lib/gobject-2.0.def +0 -370
  218. data/vendor/local/lib/gobject-2.0.lib +0 -0
  219. data/vendor/local/lib/gthread-2.0.def +0 -3
  220. data/vendor/local/lib/gthread-2.0.lib +0 -0
  221. data/vendor/local/lib/intl.lib +0 -0
  222. data/vendor/local/lib/libasprintf.dll.a +0 -0
  223. data/vendor/local/lib/libgio-2.0.dll.a +0 -0
  224. data/vendor/local/lib/libglib-2.0.dll.a +0 -0
  225. data/vendor/local/lib/libgmodule-2.0.dll.a +0 -0
  226. data/vendor/local/lib/libgobject-2.0.dll.a +0 -0
  227. data/vendor/local/lib/libgthread-2.0.dll.a +0 -0
  228. data/vendor/local/lib/libintl.def +0 -31
  229. data/vendor/local/lib/libintl.dll.a +0 -0
  230. data/vendor/local/lib/pkgconfig/gio-2.0.pc +0 -15
  231. data/vendor/local/lib/pkgconfig/gio-windows-2.0.pc +0 -11
  232. data/vendor/local/lib/pkgconfig/glib-2.0.pc +0 -15
  233. data/vendor/local/lib/pkgconfig/gmodule-2.0.pc +0 -14
  234. data/vendor/local/lib/pkgconfig/gmodule-no-export-2.0.pc +0 -14
  235. data/vendor/local/lib/pkgconfig/gobject-2.0.pc +0 -11
  236. data/vendor/local/lib/pkgconfig/gthread-2.0.pc +0 -11
  237. data/vendor/local/manifest/gettext-runtime-dev_0.18.1.1-2_win32.mft +0 -81
  238. data/vendor/local/manifest/gettext-runtime_0.18.1.1-2_win32.mft +0 -3
  239. data/vendor/local/manifest/glib-dev_2.26.0-2_win32.mft +0 -570
  240. data/vendor/local/manifest/glib_2.26.0-2_win32.mft +0 -102
  241. data/vendor/local/share/aclocal/glib-2.0.m4 +0 -211
  242. data/vendor/local/share/aclocal/glib-gettext.m4 +0 -432
  243. data/vendor/local/share/doc/gettext/bind_textdomain_codeset.3.html +0 -165
  244. data/vendor/local/share/doc/gettext/bindtextdomain.3.html +0 -160
  245. data/vendor/local/share/doc/gettext/csharpdoc/GNU_Gettext.html +0 -8
  246. data/vendor/local/share/doc/gettext/csharpdoc/GNU_Gettext_GettextResourceManager.html +0 -305
  247. data/vendor/local/share/doc/gettext/csharpdoc/GNU_Gettext_GettextResourceSet.html +0 -356
  248. data/vendor/local/share/doc/gettext/csharpdoc/begin.html +0 -11
  249. data/vendor/local/share/doc/gettext/csharpdoc/index.html +0 -10
  250. data/vendor/local/share/doc/gettext/csharpdoc/namespaces.html +0 -6
  251. data/vendor/local/share/doc/gettext/envsubst.1.html +0 -213
  252. data/vendor/local/share/doc/gettext/gettext.1.html +0 -266
  253. data/vendor/local/share/doc/gettext/gettext.3.html +0 -186
  254. data/vendor/local/share/doc/gettext/ngettext.1.html +0 -280
  255. data/vendor/local/share/doc/gettext/ngettext.3.html +0 -143
  256. data/vendor/local/share/doc/gettext/textdomain.3.html +0 -150
  257. data/vendor/local/share/doc/glib-2.26.0/COPYING +0 -482
  258. data/vendor/local/share/doc/glib-dev-2.26.0/COPYING +0 -482
  259. data/vendor/local/share/doc/libasprintf/autosprintf_all.html +0 -174
  260. data/vendor/local/share/glib-2.0/gdb/glib.py +0 -249
  261. data/vendor/local/share/glib-2.0/gdb/gobject.py +0 -305
  262. data/vendor/local/share/glib-2.0/gettext/mkinstalldirs +0 -111
  263. data/vendor/local/share/glib-2.0/gettext/po/Makefile.in.in +0 -279
  264. data/vendor/local/share/glib-2.0/schemas/gschema.dtd +0 -60
  265. data/vendor/local/share/gtk-doc/html/gio/GAppInfo.html +0 -1403
  266. data/vendor/local/share/gtk-doc/html/gio/GAsyncInitable.html +0 -733
  267. data/vendor/local/share/gtk-doc/html/gio/GAsyncResult.html +0 -343
  268. data/vendor/local/share/gtk-doc/html/gio/GBufferedInputStream.html +0 -563
  269. data/vendor/local/share/gtk-doc/html/gio/GBufferedOutputStream.html +0 -291
  270. data/vendor/local/share/gtk-doc/html/gio/GCancellable.html +0 -620
  271. data/vendor/local/share/gtk-doc/html/gio/GCharsetConverter.html +0 -245
  272. data/vendor/local/share/gtk-doc/html/gio/GConverter.html +0 -423
  273. data/vendor/local/share/gtk-doc/html/gio/GCredentials.html +0 -398
  274. data/vendor/local/share/gtk-doc/html/gio/GDBusAuthObserver.html +0 -254
  275. data/vendor/local/share/gtk-doc/html/gio/GDBusConnection.html +0 -6211
  276. data/vendor/local/share/gtk-doc/html/gio/GDBusMessage.html +0 -1833
  277. data/vendor/local/share/gtk-doc/html/gio/GDBusMethodInvocation.html +0 -618
  278. data/vendor/local/share/gtk-doc/html/gio/GDBusProxy.html +0 -2050
  279. data/vendor/local/share/gtk-doc/html/gio/GDBusServer.html +0 -1124
  280. data/vendor/local/share/gtk-doc/html/gio/GDataInputStream.html +0 -1215
  281. data/vendor/local/share/gtk-doc/html/gio/GDataOutputStream.html +0 -540
  282. data/vendor/local/share/gtk-doc/html/gio/GDrive.html +0 -1416
  283. data/vendor/local/share/gtk-doc/html/gio/GEmblem.html +0 -272
  284. data/vendor/local/share/gtk-doc/html/gio/GEmblemedIcon.html +0 -206
  285. data/vendor/local/share/gtk-doc/html/gio/GFile.html +0 -7462
  286. data/vendor/local/share/gtk-doc/html/gio/GFileDescriptorBased.html +0 -120
  287. data/vendor/local/share/gtk-doc/html/gio/GFileEnumerator.html +0 -516
  288. data/vendor/local/share/gtk-doc/html/gio/GFileIOStream.html +0 -312
  289. data/vendor/local/share/gtk-doc/html/gio/GFileIcon.html +0 -155
  290. data/vendor/local/share/gtk-doc/html/gio/GFileInfo.html +0 -3144
  291. data/vendor/local/share/gtk-doc/html/gio/GFileInputStream.html +0 -262
  292. data/vendor/local/share/gtk-doc/html/gio/GFileMonitor.html +0 -353
  293. data/vendor/local/share/gtk-doc/html/gio/GFileOutputStream.html +0 -301
  294. data/vendor/local/share/gtk-doc/html/gio/GFilenameCompleter.html +0 -217
  295. data/vendor/local/share/gtk-doc/html/gio/GFilterInputStream.html +0 -188
  296. data/vendor/local/share/gtk-doc/html/gio/GFilterOutputStream.html +0 -189
  297. data/vendor/local/share/gtk-doc/html/gio/GIOModule.html +0 -261
  298. data/vendor/local/share/gtk-doc/html/gio/GIOStream.html +0 -479
  299. data/vendor/local/share/gtk-doc/html/gio/GIcon.html +0 -331
  300. data/vendor/local/share/gtk-doc/html/gio/GInetAddress.html +0 -717
  301. data/vendor/local/share/gtk-doc/html/gio/GInetSocketAddress.html +0 -196
  302. data/vendor/local/share/gtk-doc/html/gio/GInitable.html +0 -388
  303. data/vendor/local/share/gtk-doc/html/gio/GInputStream.html +0 -808
  304. data/vendor/local/share/gtk-doc/html/gio/GLoadableIcon.html +0 -301
  305. data/vendor/local/share/gtk-doc/html/gio/GMemoryInputStream.html +0 -185
  306. data/vendor/local/share/gtk-doc/html/gio/GMemoryOutputStream.html +0 -393
  307. data/vendor/local/share/gtk-doc/html/gio/GMount.html +0 -1465
  308. data/vendor/local/share/gtk-doc/html/gio/GMountOperation.html +0 -848
  309. data/vendor/local/share/gtk-doc/html/gio/GNetworkAddress.html +0 -343
  310. data/vendor/local/share/gtk-doc/html/gio/GNetworkService.html +0 -311
  311. data/vendor/local/share/gtk-doc/html/gio/GOutputStream.html +0 -1012
  312. data/vendor/local/share/gtk-doc/html/gio/GPermission.html +0 -560
  313. data/vendor/local/share/gtk-doc/html/gio/GProxy.html +0 -312
  314. data/vendor/local/share/gtk-doc/html/gio/GProxyAddress.html +0 -348
  315. data/vendor/local/share/gtk-doc/html/gio/GProxyResolver.html +0 -301
  316. data/vendor/local/share/gtk-doc/html/gio/GResolver.html +0 -787
  317. data/vendor/local/share/gtk-doc/html/gio/GSeekable.html +0 -350
  318. data/vendor/local/share/gtk-doc/html/gio/GSettings.html +0 -2424
  319. data/vendor/local/share/gtk-doc/html/gio/GSettingsBackend.html +0 -609
  320. data/vendor/local/share/gtk-doc/html/gio/GSimpleAsyncResult.html +0 -1193
  321. data/vendor/local/share/gtk-doc/html/gio/GSimplePermission.html +0 -107
  322. data/vendor/local/share/gtk-doc/html/gio/GSocket.html +0 -2438
  323. data/vendor/local/share/gtk-doc/html/gio/GSocketAddress.html +0 -297
  324. data/vendor/local/share/gtk-doc/html/gio/GSocketClient.html +0 -1292
  325. data/vendor/local/share/gtk-doc/html/gio/GSocketConnectable.html +0 -513
  326. data/vendor/local/share/gtk-doc/html/gio/GSocketConnection.html +0 -337
  327. data/vendor/local/share/gtk-doc/html/gio/GSocketControlMessage.html +0 -275
  328. data/vendor/local/share/gtk-doc/html/gio/GSocketListener.html +0 -745
  329. data/vendor/local/share/gtk-doc/html/gio/GSocketService.html +0 -258
  330. data/vendor/local/share/gtk-doc/html/gio/GTcpConnection.html +0 -165
  331. data/vendor/local/share/gtk-doc/html/gio/GThemedIcon.html +0 -377
  332. data/vendor/local/share/gtk-doc/html/gio/GThreadedSocketService.html +0 -197
  333. data/vendor/local/share/gtk-doc/html/gio/GUnixConnection.html +0 -298
  334. data/vendor/local/share/gtk-doc/html/gio/GUnixCredentialsMessage.html +0 -222
  335. data/vendor/local/share/gtk-doc/html/gio/GUnixFDList.html +0 -389
  336. data/vendor/local/share/gtk-doc/html/gio/GUnixFDMessage.html +0 -288
  337. data/vendor/local/share/gtk-doc/html/gio/GUnixInputStream.html +0 -237
  338. data/vendor/local/share/gtk-doc/html/gio/GUnixOutputStream.html +0 -237
  339. data/vendor/local/share/gtk-doc/html/gio/GUnixSocketAddress.html +0 -491
  340. data/vendor/local/share/gtk-doc/html/gio/GVfs.html +0 -274
  341. data/vendor/local/share/gtk-doc/html/gio/GVolume.html +0 -1028
  342. data/vendor/local/share/gtk-doc/html/gio/GVolumeMonitor.html +0 -705
  343. data/vendor/local/share/gtk-doc/html/gio/GZlibCompressor.html +0 -252
  344. data/vendor/local/share/gtk-doc/html/gio/GZlibDecompressor.html +0 -170
  345. data/vendor/local/share/gtk-doc/html/gio/annotation-glossary.html +0 -65
  346. data/vendor/local/share/gtk-doc/html/gio/api-index-2-18.html +0 -153
  347. data/vendor/local/share/gtk-doc/html/gio/api-index-2-20.html +0 -155
  348. data/vendor/local/share/gtk-doc/html/gio/api-index-2-22.html +0 -1084
  349. data/vendor/local/share/gtk-doc/html/gio/api-index-2-24.html +0 -223
  350. data/vendor/local/share/gtk-doc/html/gio/api-index-2-26.html +0 -1598
  351. data/vendor/local/share/gtk-doc/html/gio/api-index-deprecated.html +0 -112
  352. data/vendor/local/share/gtk-doc/html/gio/api-index-full.html +0 -6250
  353. data/vendor/local/share/gtk-doc/html/gio/async.html +0 -44
  354. data/vendor/local/share/gtk-doc/html/gio/ch01.html +0 -207
  355. data/vendor/local/share/gtk-doc/html/gio/ch02.html +0 -50
  356. data/vendor/local/share/gtk-doc/html/gio/ch03.html +0 -180
  357. data/vendor/local/share/gtk-doc/html/gio/ch24.html +0 -75
  358. data/vendor/local/share/gtk-doc/html/gio/ch25.html +0 -217
  359. data/vendor/local/share/gtk-doc/html/gio/ch25s02.html +0 -41
  360. data/vendor/local/share/gtk-doc/html/gio/ch25s03.html +0 -39
  361. data/vendor/local/share/gtk-doc/html/gio/ch26.html +0 -57
  362. data/vendor/local/share/gtk-doc/html/gio/ch26s02.html +0 -59
  363. data/vendor/local/share/gtk-doc/html/gio/ch26s03.html +0 -159
  364. data/vendor/local/share/gtk-doc/html/gio/ch26s04.html +0 -46
  365. data/vendor/local/share/gtk-doc/html/gio/ch26s05.html +0 -48
  366. data/vendor/local/share/gtk-doc/html/gio/ch26s06.html +0 -277
  367. data/vendor/local/share/gtk-doc/html/gio/ch26s07.html +0 -95
  368. data/vendor/local/share/gtk-doc/html/gio/ch27.html +0 -70
  369. data/vendor/local/share/gtk-doc/html/gio/ch27s02.html +0 -130
  370. data/vendor/local/share/gtk-doc/html/gio/ch27s03.html +0 -202
  371. data/vendor/local/share/gtk-doc/html/gio/ch27s04.html +0 -96
  372. data/vendor/local/share/gtk-doc/html/gio/ch27s05.html +0 -823
  373. data/vendor/local/share/gtk-doc/html/gio/ch27s06.html +0 -828
  374. data/vendor/local/share/gtk-doc/html/gio/conversion.html +0 -44
  375. data/vendor/local/share/gtk-doc/html/gio/extending-gio.html +0 -109
  376. data/vendor/local/share/gtk-doc/html/gio/extending.html +0 -41
  377. data/vendor/local/share/gtk-doc/html/gio/failable_initialization.html +0 -38
  378. data/vendor/local/share/gtk-doc/html/gio/file_mon.html +0 -33
  379. data/vendor/local/share/gtk-doc/html/gio/file_ops.html +0 -50
  380. data/vendor/local/share/gtk-doc/html/gio/gdbus-convenience.html +0 -41
  381. data/vendor/local/share/gtk-doc/html/gio/gdbus-lowlevel.html +0 -59
  382. data/vendor/local/share/gtk-doc/html/gio/gdbus.html +0 -243
  383. data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Addresses.html +0 -316
  384. data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Introspection-Data.html +0 -1117
  385. data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Utilities.html +0 -216
  386. data/vendor/local/share/gtk-doc/html/gio/gio-Desktop-file-based-GAppInfo.html +0 -339
  387. data/vendor/local/share/gtk-doc/html/gio/gio-Extension-Points.html +0 -473
  388. data/vendor/local/share/gtk-doc/html/gio/gio-GContentType.html +0 -391
  389. data/vendor/local/share/gtk-doc/html/gio/gio-GConverterInputstream.html +0 -159
  390. data/vendor/local/share/gtk-doc/html/gio/gio-GConverterOutputstream.html +0 -159
  391. data/vendor/local/share/gtk-doc/html/gio/gio-GDBusError.html +0 -908
  392. data/vendor/local/share/gtk-doc/html/gio/gio-GFileAttribute.html +0 -933
  393. data/vendor/local/share/gtk-doc/html/gio/gio-GIOError.html +0 -409
  394. data/vendor/local/share/gtk-doc/html/gio/gio-GIOScheduler.html +0 -297
  395. data/vendor/local/share/gtk-doc/html/gio/gio-GSrvTarget.html +0 -313
  396. data/vendor/local/share/gtk-doc/html/gio/gio-Owning-Bus-Names.html +0 -736
  397. data/vendor/local/share/gtk-doc/html/gio/gio-Unix-Mounts.html +0 -909
  398. data/vendor/local/share/gtk-doc/html/gio/gio-Watching-Bus-Names.html +0 -666
  399. data/vendor/local/share/gtk-doc/html/gio/gio-hierarchy.html +0 -123
  400. data/vendor/local/share/gtk-doc/html/gio/gio-querymodules.html +0 -53
  401. data/vendor/local/share/gtk-doc/html/gio/gio.devhelp +0 -1736
  402. data/vendor/local/share/gtk-doc/html/gio/gio.devhelp2 +0 -2006
  403. data/vendor/local/share/gtk-doc/html/gio/glib-compile-schemas.html +0 -102
  404. data/vendor/local/share/gtk-doc/html/gio/gvfs-overview.png +0 -0
  405. data/vendor/local/share/gtk-doc/html/gio/highlevel-socket.html +0 -53
  406. data/vendor/local/share/gtk-doc/html/gio/home.png +0 -0
  407. data/vendor/local/share/gtk-doc/html/gio/icons.html +0 -50
  408. data/vendor/local/share/gtk-doc/html/gio/index.html +0 -435
  409. data/vendor/local/share/gtk-doc/html/gio/index.sgml +0 -2513
  410. data/vendor/local/share/gtk-doc/html/gio/left.png +0 -0
  411. data/vendor/local/share/gtk-doc/html/gio/migrating.html +0 -62
  412. data/vendor/local/share/gtk-doc/html/gio/networking.html +0 -69
  413. data/vendor/local/share/gtk-doc/html/gio/permissions.html +0 -39
  414. data/vendor/local/share/gtk-doc/html/gio/pt01.html +0 -39
  415. data/vendor/local/share/gtk-doc/html/gio/pt02.html +0 -390
  416. data/vendor/local/share/gtk-doc/html/gio/resolver.html +0 -50
  417. data/vendor/local/share/gtk-doc/html/gio/right.png +0 -0
  418. data/vendor/local/share/gtk-doc/html/gio/settings.html +0 -38
  419. data/vendor/local/share/gtk-doc/html/gio/streaming.html +0 -92
  420. data/vendor/local/share/gtk-doc/html/gio/style.css +0 -265
  421. data/vendor/local/share/gtk-doc/html/gio/tools.html +0 -44
  422. data/vendor/local/share/gtk-doc/html/gio/types.html +0 -41
  423. data/vendor/local/share/gtk-doc/html/gio/up.png +0 -0
  424. data/vendor/local/share/gtk-doc/html/gio/utils.html +0 -33
  425. data/vendor/local/share/gtk-doc/html/gio/volume_mon.html +0 -47
  426. data/vendor/local/share/gtk-doc/html/glib/annotation-glossary.html +0 -77
  427. data/vendor/local/share/gtk-doc/html/glib/api-index-2-10.html +0 -180
  428. data/vendor/local/share/gtk-doc/html/glib/api-index-2-12.html +0 -312
  429. data/vendor/local/share/gtk-doc/html/glib/api-index-2-14.html +0 -559
  430. data/vendor/local/share/gtk-doc/html/glib/api-index-2-16.html +0 -362
  431. data/vendor/local/share/gtk-doc/html/glib/api-index-2-18.html +0 -102
  432. data/vendor/local/share/gtk-doc/html/glib/api-index-2-2.html +0 -124
  433. data/vendor/local/share/gtk-doc/html/glib/api-index-2-20.html +0 -83
  434. data/vendor/local/share/gtk-doc/html/glib/api-index-2-22.html +0 -194
  435. data/vendor/local/share/gtk-doc/html/glib/api-index-2-24.html +0 -420
  436. data/vendor/local/share/gtk-doc/html/glib/api-index-2-26.html +0 -359
  437. data/vendor/local/share/gtk-doc/html/glib/api-index-2-4.html +0 -396
  438. data/vendor/local/share/gtk-doc/html/glib/api-index-2-6.html +0 -417
  439. data/vendor/local/share/gtk-doc/html/glib/api-index-2-8.html +0 -158
  440. data/vendor/local/share/gtk-doc/html/glib/api-index-deprecated.html +0 -419
  441. data/vendor/local/share/gtk-doc/html/glib/api-index-full.html +0 -8214
  442. data/vendor/local/share/gtk-doc/html/glib/file-name-encodings.png +0 -0
  443. data/vendor/local/share/gtk-doc/html/glib/glib-Arrays.html +0 -893
  444. data/vendor/local/share/gtk-doc/html/glib/glib-Asynchronous-Queues.html +0 -818
  445. data/vendor/local/share/gtk-doc/html/glib/glib-Atomic-Operations.html +0 -414
  446. data/vendor/local/share/gtk-doc/html/glib/glib-Automatic-String-Completion.html +0 -466
  447. data/vendor/local/share/gtk-doc/html/glib/glib-Balanced-Binary-Trees.html +0 -802
  448. data/vendor/local/share/gtk-doc/html/glib/glib-Base64-Encoding.html +0 -372
  449. data/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html +0 -500
  450. data/vendor/local/share/gtk-doc/html/glib/glib-Bookmark-file-parser.html +0 -2056
  451. data/vendor/local/share/gtk-doc/html/glib/glib-Byte-Arrays.html +0 -560
  452. data/vendor/local/share/gtk-doc/html/glib/glib-Byte-Order-Macros.html +0 -1686
  453. data/vendor/local/share/gtk-doc/html/glib/glib-Caches.html +0 -398
  454. data/vendor/local/share/gtk-doc/html/glib/glib-Character-Set-Conversion.html +0 -1094
  455. data/vendor/local/share/gtk-doc/html/glib/glib-Commandline-option-parser.html +0 -1671
  456. data/vendor/local/share/gtk-doc/html/glib/glib-Data-Checksums.html +0 -460
  457. data/vendor/local/share/gtk-doc/html/glib/glib-Datasets.html +0 -528
  458. data/vendor/local/share/gtk-doc/html/glib/glib-Date-and-Time-Functions.html +0 -2045
  459. data/vendor/local/share/gtk-doc/html/glib/glib-Double-ended-Queues.html +0 -1278
  460. data/vendor/local/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html +0 -1406
  461. data/vendor/local/share/gtk-doc/html/glib/glib-Dynamic-Loading-of-Modules.html +0 -548
  462. data/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html +0 -1026
  463. data/vendor/local/share/gtk-doc/html/glib/glib-File-Utilities.html +0 -1852
  464. data/vendor/local/share/gtk-doc/html/glib/glib-GDateTime.html +0 -2201
  465. data/vendor/local/share/gtk-doc/html/glib/glib-GTimeZone.html +0 -239
  466. data/vendor/local/share/gtk-doc/html/glib/glib-GVariant.html +0 -4278
  467. data/vendor/local/share/gtk-doc/html/glib/glib-GVariantType.html +0 -1864
  468. data/vendor/local/share/gtk-doc/html/glib/glib-Glob-style-pattern-matching.html +0 -295
  469. data/vendor/local/share/gtk-doc/html/glib/glib-Hash-Tables.html +0 -1512
  470. data/vendor/local/share/gtk-doc/html/glib/glib-Hook-Functions.html +0 -1367
  471. data/vendor/local/share/gtk-doc/html/glib/glib-Hostname-Utilities.html +0 -229
  472. data/vendor/local/share/gtk-doc/html/glib/glib-I18N.html +0 -692
  473. data/vendor/local/share/gtk-doc/html/glib/glib-IO-Channels.html +0 -2196
  474. data/vendor/local/share/gtk-doc/html/glib/glib-Key-value-file-parser.html +0 -2740
  475. data/vendor/local/share/gtk-doc/html/glib/glib-Keyed-Data-Lists.html +0 -612
  476. data/vendor/local/share/gtk-doc/html/glib/glib-Lexical-Scanner.html +0 -1451
  477. data/vendor/local/share/gtk-doc/html/glib/glib-Limits-of-Basic-Types.html +0 -389
  478. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html +0 -1033
  479. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocators.html +0 -141
  480. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Chunks.html +0 -706
  481. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Slices.html +0 -510
  482. data/vendor/local/share/gtk-doc/html/glib/glib-Message-Logging.html +0 -748
  483. data/vendor/local/share/gtk-doc/html/glib/glib-Miscellaneous-Macros.html +0 -1105
  484. data/vendor/local/share/gtk-doc/html/glib/glib-Miscellaneous-Utility-Functions.html +0 -1552
  485. data/vendor/local/share/gtk-doc/html/glib/glib-N-ary-Trees.html +0 -1468
  486. data/vendor/local/share/gtk-doc/html/glib/glib-Numerical-Definitions.html +0 -194
  487. data/vendor/local/share/gtk-doc/html/glib/glib-Perl-compatible-regular-expressions.html +0 -2745
  488. data/vendor/local/share/gtk-doc/html/glib/glib-Pointer-Arrays.html +0 -752
  489. data/vendor/local/share/gtk-doc/html/glib/glib-Quarks.html +0 -269
  490. data/vendor/local/share/gtk-doc/html/glib/glib-Random-Numbers.html +0 -578
  491. data/vendor/local/share/gtk-doc/html/glib/glib-Relations-and-Tuples.html +0 -532
  492. data/vendor/local/share/gtk-doc/html/glib/glib-Sequences.html +0 -1353
  493. data/vendor/local/share/gtk-doc/html/glib/glib-Shell-related-Utilities.html +0 -238
  494. data/vendor/local/share/gtk-doc/html/glib/glib-Simple-XML-Subset-Parser.html +0 -1282
  495. data/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html +0 -1213
  496. data/vendor/local/share/gtk-doc/html/glib/glib-Spawning-Processes.html +0 -924
  497. data/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html +0 -470
  498. data/vendor/local/share/gtk-doc/html/glib/glib-String-Chunks.html +0 -301
  499. data/vendor/local/share/gtk-doc/html/glib/glib-String-Utility-Functions.html +0 -2960
  500. data/vendor/local/share/gtk-doc/html/glib/glib-Strings.html +0 -1291
  501. data/vendor/local/share/gtk-doc/html/glib/glib-Testing.html +0 -1805
  502. data/vendor/local/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html +0 -3478
  503. data/vendor/local/share/gtk-doc/html/glib/glib-Thread-Pools.html +0 -606
  504. data/vendor/local/share/gtk-doc/html/glib/glib-Threads.html +0 -3411
  505. data/vendor/local/share/gtk-doc/html/glib/glib-Timers.html +0 -245
  506. data/vendor/local/share/gtk-doc/html/glib/glib-Trash-Stacks.html +0 -188
  507. data/vendor/local/share/gtk-doc/html/glib/glib-Type-Conversion-Macros.html +0 -263
  508. data/vendor/local/share/gtk-doc/html/glib/glib-URI-Functions.html +0 -400
  509. data/vendor/local/share/gtk-doc/html/glib/glib-Unicode-Manipulation.html +0 -3448
  510. data/vendor/local/share/gtk-doc/html/glib/glib-Version-Information.html +0 -253
  511. data/vendor/local/share/gtk-doc/html/glib/glib-Warnings-and-Assertions.html +0 -438
  512. data/vendor/local/share/gtk-doc/html/glib/glib-Windows-Compatibility-Functions.html +0 -476
  513. data/vendor/local/share/gtk-doc/html/glib/glib-building.html +0 -466
  514. data/vendor/local/share/gtk-doc/html/glib/glib-changes.html +0 -159
  515. data/vendor/local/share/gtk-doc/html/glib/glib-compiling.html +0 -118
  516. data/vendor/local/share/gtk-doc/html/glib/glib-core.html +0 -64
  517. data/vendor/local/share/gtk-doc/html/glib/glib-cross-compiling.html +0 -160
  518. data/vendor/local/share/gtk-doc/html/glib/glib-data-types.html +0 -120
  519. data/vendor/local/share/gtk-doc/html/glib/glib-fundamentals.html +0 -59
  520. data/vendor/local/share/gtk-doc/html/glib/glib-gettextize.html +0 -93
  521. data/vendor/local/share/gtk-doc/html/glib/glib-regex-syntax.html +0 -2217
  522. data/vendor/local/share/gtk-doc/html/glib/glib-resources.html +0 -121
  523. data/vendor/local/share/gtk-doc/html/glib/glib-running.html +0 -319
  524. data/vendor/local/share/gtk-doc/html/glib/glib-utilities.html +0 -118
  525. data/vendor/local/share/gtk-doc/html/glib/glib.devhelp +0 -2183
  526. data/vendor/local/share/gtk-doc/html/glib/glib.devhelp2 +0 -2671
  527. data/vendor/local/share/gtk-doc/html/glib/glib.html +0 -80
  528. data/vendor/local/share/gtk-doc/html/glib/gtester-report.html +0 -72
  529. data/vendor/local/share/gtk-doc/html/glib/gtester.html +0 -131
  530. data/vendor/local/share/gtk-doc/html/glib/gvariant-format-strings.html +0 -1288
  531. data/vendor/local/share/gtk-doc/html/glib/home.png +0 -0
  532. data/vendor/local/share/gtk-doc/html/glib/index.html +0 -344
  533. data/vendor/local/share/gtk-doc/html/glib/index.sgml +0 -2846
  534. data/vendor/local/share/gtk-doc/html/glib/left.png +0 -0
  535. data/vendor/local/share/gtk-doc/html/glib/mainloop-states.gif +0 -0
  536. data/vendor/local/share/gtk-doc/html/glib/right.png +0 -0
  537. data/vendor/local/share/gtk-doc/html/glib/style.css +0 -265
  538. data/vendor/local/share/gtk-doc/html/glib/tools.html +0 -41
  539. data/vendor/local/share/gtk-doc/html/glib/up.png +0 -0
  540. data/vendor/local/share/gtk-doc/html/gobject/GBinding.html +0 -803
  541. data/vendor/local/share/gtk-doc/html/gobject/GTypeModule.html +0 -710
  542. data/vendor/local/share/gtk-doc/html/gobject/GTypePlugin.html +0 -453
  543. data/vendor/local/share/gtk-doc/html/gobject/annotation-glossary.html +0 -47
  544. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-10.html +0 -85
  545. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-12.html +0 -55
  546. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-14.html +0 -51
  547. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-18.html +0 -46
  548. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-2.html +0 -38
  549. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-22.html +0 -46
  550. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-24.html +0 -73
  551. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-26.html +0 -201
  552. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-4.html +0 -178
  553. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-6.html +0 -42
  554. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-8.html +0 -42
  555. data/vendor/local/share/gtk-doc/html/gobject/api-index-deprecated.html +0 -50
  556. data/vendor/local/share/gtk-doc/html/gobject/api-index-full.html +0 -2721
  557. data/vendor/local/share/gtk-doc/html/gobject/ch01s02.html +0 -136
  558. data/vendor/local/share/gtk-doc/html/gobject/ch06s03.html +0 -113
  559. data/vendor/local/share/gtk-doc/html/gobject/chapter-gobject.html +0 -293
  560. data/vendor/local/share/gtk-doc/html/gobject/chapter-gtype.html +0 -263
  561. data/vendor/local/share/gtk-doc/html/gobject/chapter-intro.html +0 -92
  562. data/vendor/local/share/gtk-doc/html/gobject/chapter-signal.html +0 -214
  563. data/vendor/local/share/gtk-doc/html/gobject/glib-genmarshal.html +0 -361
  564. data/vendor/local/share/gtk-doc/html/gobject/glib-mkenums.html +0 -307
  565. data/vendor/local/share/gtk-doc/html/gobject/glue.png +0 -0
  566. data/vendor/local/share/gtk-doc/html/gobject/gobject-Boxed-Types.html +0 -417
  567. data/vendor/local/share/gtk-doc/html/gobject/gobject-Closures.html +0 -2412
  568. data/vendor/local/share/gtk-doc/html/gobject/gobject-Enumeration-and-Flag-Types.html +0 -847
  569. data/vendor/local/share/gtk-doc/html/gobject/gobject-GParamSpec.html +0 -1433
  570. data/vendor/local/share/gtk-doc/html/gobject/gobject-Generic-values.html +0 -776
  571. data/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html +0 -2741
  572. data/vendor/local/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html +0 -5555
  573. data/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html +0 -2875
  574. data/vendor/local/share/gtk-doc/html/gobject/gobject-Type-Information.html +0 -4460
  575. data/vendor/local/share/gtk-doc/html/gobject/gobject-Value-arrays.html +0 -416
  576. data/vendor/local/share/gtk-doc/html/gobject/gobject-Varargs-Value-Collection.html +0 -260
  577. data/vendor/local/share/gtk-doc/html/gobject/gobject-memory.html +0 -234
  578. data/vendor/local/share/gtk-doc/html/gobject/gobject-properties.html +0 -270
  579. data/vendor/local/share/gtk-doc/html/gobject/gobject-query.html +0 -117
  580. data/vendor/local/share/gtk-doc/html/gobject/gobject.devhelp +0 -762
  581. data/vendor/local/share/gtk-doc/html/gobject/gobject.devhelp2 +0 -801
  582. data/vendor/local/share/gtk-doc/html/gobject/gtype-conventions.html +0 -143
  583. data/vendor/local/share/gtk-doc/html/gobject/gtype-instantiable-classed.html +0 -287
  584. data/vendor/local/share/gtk-doc/html/gobject/gtype-non-instantiable-classed.html +0 -316
  585. data/vendor/local/share/gtk-doc/html/gobject/gtype-non-instantiable.html +0 -76
  586. data/vendor/local/share/gtk-doc/html/gobject/home.png +0 -0
  587. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-chainup.html +0 -100
  588. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-code.html +0 -86
  589. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-construction.html +0 -113
  590. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-destruction.html +0 -122
  591. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-methods.html +0 -257
  592. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject.html +0 -283
  593. data/vendor/local/share/gtk-doc/html/gobject/howto-interface-implement.html +0 -125
  594. data/vendor/local/share/gtk-doc/html/gobject/howto-interface-properties.html +0 -167
  595. data/vendor/local/share/gtk-doc/html/gobject/howto-interface.html +0 -160
  596. data/vendor/local/share/gtk-doc/html/gobject/howto-signals.html +0 -121
  597. data/vendor/local/share/gtk-doc/html/gobject/index.html +0 -192
  598. data/vendor/local/share/gtk-doc/html/gobject/index.sgml +0 -786
  599. data/vendor/local/share/gtk-doc/html/gobject/left.png +0 -0
  600. data/vendor/local/share/gtk-doc/html/gobject/pr01.html +0 -72
  601. data/vendor/local/share/gtk-doc/html/gobject/pt01.html +0 -80
  602. data/vendor/local/share/gtk-doc/html/gobject/pt02.html +0 -66
  603. data/vendor/local/share/gtk-doc/html/gobject/pt03.html +0 -55
  604. data/vendor/local/share/gtk-doc/html/gobject/right.png +0 -0
  605. data/vendor/local/share/gtk-doc/html/gobject/rn01.html +0 -85
  606. data/vendor/local/share/gtk-doc/html/gobject/rn02.html +0 -47
  607. data/vendor/local/share/gtk-doc/html/gobject/signal.html +0 -377
  608. data/vendor/local/share/gtk-doc/html/gobject/style.css +0 -265
  609. data/vendor/local/share/gtk-doc/html/gobject/tools-ginspector.html +0 -35
  610. data/vendor/local/share/gtk-doc/html/gobject/tools-gob.html +0 -40
  611. data/vendor/local/share/gtk-doc/html/gobject/tools-gtkdoc.html +0 -63
  612. data/vendor/local/share/gtk-doc/html/gobject/tools-refdb.html +0 -55
  613. data/vendor/local/share/gtk-doc/html/gobject/tools-vala.html +0 -43
  614. data/vendor/local/share/gtk-doc/html/gobject/up.png +0 -0
  615. data/vendor/local/share/locale/af/LC_MESSAGES/glib20.mo +0 -0
  616. data/vendor/local/share/locale/am/LC_MESSAGES/glib20.mo +0 -0
  617. data/vendor/local/share/locale/ar/LC_MESSAGES/glib20.mo +0 -0
  618. data/vendor/local/share/locale/as/LC_MESSAGES/glib20.mo +0 -0
  619. data/vendor/local/share/locale/ast/LC_MESSAGES/glib20.mo +0 -0
  620. data/vendor/local/share/locale/az/LC_MESSAGES/glib20.mo +0 -0
  621. data/vendor/local/share/locale/be/LC_MESSAGES/gettext-runtime.mo +0 -0
  622. data/vendor/local/share/locale/be/LC_MESSAGES/glib20.mo +0 -0
  623. data/vendor/local/share/locale/be@latin/LC_MESSAGES/glib20.mo +0 -0
  624. data/vendor/local/share/locale/bg/LC_MESSAGES/gettext-runtime.mo +0 -0
  625. data/vendor/local/share/locale/bg/LC_MESSAGES/glib20.mo +0 -0
  626. data/vendor/local/share/locale/bn/LC_MESSAGES/glib20.mo +0 -0
  627. data/vendor/local/share/locale/bn_IN/LC_MESSAGES/glib20.mo +0 -0
  628. data/vendor/local/share/locale/bs/LC_MESSAGES/glib20.mo +0 -0
  629. data/vendor/local/share/locale/ca/LC_MESSAGES/gettext-runtime.mo +0 -0
  630. data/vendor/local/share/locale/ca/LC_MESSAGES/glib20.mo +0 -0
  631. data/vendor/local/share/locale/ca@valencia/LC_MESSAGES/glib20.mo +0 -0
  632. data/vendor/local/share/locale/cs/LC_MESSAGES/gettext-runtime.mo +0 -0
  633. data/vendor/local/share/locale/cs/LC_MESSAGES/glib20.mo +0 -0
  634. data/vendor/local/share/locale/cy/LC_MESSAGES/glib20.mo +0 -0
  635. data/vendor/local/share/locale/da/LC_MESSAGES/gettext-runtime.mo +0 -0
  636. data/vendor/local/share/locale/da/LC_MESSAGES/glib20.mo +0 -0
  637. data/vendor/local/share/locale/de/LC_MESSAGES/gettext-runtime.mo +0 -0
  638. data/vendor/local/share/locale/de/LC_MESSAGES/glib20.mo +0 -0
  639. data/vendor/local/share/locale/dz/LC_MESSAGES/glib20.mo +0 -0
  640. data/vendor/local/share/locale/el/LC_MESSAGES/gettext-runtime.mo +0 -0
  641. data/vendor/local/share/locale/el/LC_MESSAGES/glib20.mo +0 -0
  642. data/vendor/local/share/locale/en@boldquot/LC_MESSAGES/gettext-runtime.mo +0 -0
  643. data/vendor/local/share/locale/en@quot/LC_MESSAGES/gettext-runtime.mo +0 -0
  644. data/vendor/local/share/locale/en@shaw/LC_MESSAGES/glib20.mo +0 -0
  645. data/vendor/local/share/locale/en_CA/LC_MESSAGES/glib20.mo +0 -0
  646. data/vendor/local/share/locale/en_GB/LC_MESSAGES/glib20.mo +0 -0
  647. data/vendor/local/share/locale/eo/LC_MESSAGES/gettext-runtime.mo +0 -0
  648. data/vendor/local/share/locale/eo/LC_MESSAGES/glib20.mo +0 -0
  649. data/vendor/local/share/locale/es/LC_MESSAGES/gettext-runtime.mo +0 -0
  650. data/vendor/local/share/locale/es/LC_MESSAGES/glib20.mo +0 -0
  651. data/vendor/local/share/locale/et/LC_MESSAGES/gettext-runtime.mo +0 -0
  652. data/vendor/local/share/locale/et/LC_MESSAGES/glib20.mo +0 -0
  653. data/vendor/local/share/locale/eu/LC_MESSAGES/glib20.mo +0 -0
  654. data/vendor/local/share/locale/fa/LC_MESSAGES/glib20.mo +0 -0
  655. data/vendor/local/share/locale/fi/LC_MESSAGES/gettext-runtime.mo +0 -0
  656. data/vendor/local/share/locale/fi/LC_MESSAGES/glib20.mo +0 -0
  657. data/vendor/local/share/locale/fr/LC_MESSAGES/gettext-runtime.mo +0 -0
  658. data/vendor/local/share/locale/fr/LC_MESSAGES/glib20.mo +0 -0
  659. data/vendor/local/share/locale/ga/LC_MESSAGES/gettext-runtime.mo +0 -0
  660. data/vendor/local/share/locale/ga/LC_MESSAGES/glib20.mo +0 -0
  661. data/vendor/local/share/locale/gl/LC_MESSAGES/gettext-runtime.mo +0 -0
  662. data/vendor/local/share/locale/gl/LC_MESSAGES/glib20.mo +0 -0
  663. data/vendor/local/share/locale/gu/LC_MESSAGES/glib20.mo +0 -0
  664. data/vendor/local/share/locale/he/LC_MESSAGES/glib20.mo +0 -0
  665. data/vendor/local/share/locale/hi/LC_MESSAGES/glib20.mo +0 -0
  666. data/vendor/local/share/locale/hr/LC_MESSAGES/glib20.mo +0 -0
  667. data/vendor/local/share/locale/hu/LC_MESSAGES/glib20.mo +0 -0
  668. data/vendor/local/share/locale/hy/LC_MESSAGES/glib20.mo +0 -0
  669. data/vendor/local/share/locale/id/LC_MESSAGES/gettext-runtime.mo +0 -0
  670. data/vendor/local/share/locale/id/LC_MESSAGES/glib20.mo +0 -0
  671. data/vendor/local/share/locale/is/LC_MESSAGES/glib20.mo +0 -0
  672. data/vendor/local/share/locale/it/LC_MESSAGES/gettext-runtime.mo +0 -0
  673. data/vendor/local/share/locale/it/LC_MESSAGES/glib20.mo +0 -0
  674. data/vendor/local/share/locale/ja/LC_MESSAGES/gettext-runtime.mo +0 -0
  675. data/vendor/local/share/locale/ja/LC_MESSAGES/glib20.mo +0 -0
  676. data/vendor/local/share/locale/ka/LC_MESSAGES/glib20.mo +0 -0
  677. data/vendor/local/share/locale/kk/LC_MESSAGES/glib20.mo +0 -0
  678. data/vendor/local/share/locale/kn/LC_MESSAGES/glib20.mo +0 -0
  679. data/vendor/local/share/locale/ko/LC_MESSAGES/gettext-runtime.mo +0 -0
  680. data/vendor/local/share/locale/ko/LC_MESSAGES/glib20.mo +0 -0
  681. data/vendor/local/share/locale/ku/LC_MESSAGES/glib20.mo +0 -0
  682. data/vendor/local/share/locale/locale.alias +0 -77
  683. data/vendor/local/share/locale/lt/LC_MESSAGES/glib20.mo +0 -0
  684. data/vendor/local/share/locale/lv/LC_MESSAGES/glib20.mo +0 -0
  685. data/vendor/local/share/locale/mai/LC_MESSAGES/glib20.mo +0 -0
  686. data/vendor/local/share/locale/mg/LC_MESSAGES/glib20.mo +0 -0
  687. data/vendor/local/share/locale/mk/LC_MESSAGES/glib20.mo +0 -0
  688. data/vendor/local/share/locale/ml/LC_MESSAGES/glib20.mo +0 -0
  689. data/vendor/local/share/locale/mn/LC_MESSAGES/glib20.mo +0 -0
  690. data/vendor/local/share/locale/mr/LC_MESSAGES/glib20.mo +0 -0
  691. data/vendor/local/share/locale/ms/LC_MESSAGES/glib20.mo +0 -0
  692. data/vendor/local/share/locale/nb/LC_MESSAGES/gettext-runtime.mo +0 -0
  693. data/vendor/local/share/locale/nb/LC_MESSAGES/glib20.mo +0 -0
  694. data/vendor/local/share/locale/nds/LC_MESSAGES/glib20.mo +0 -0
  695. data/vendor/local/share/locale/ne/LC_MESSAGES/glib20.mo +0 -0
  696. data/vendor/local/share/locale/nl/LC_MESSAGES/gettext-runtime.mo +0 -0
  697. data/vendor/local/share/locale/nl/LC_MESSAGES/glib20.mo +0 -0
  698. data/vendor/local/share/locale/nn/LC_MESSAGES/gettext-runtime.mo +0 -0
  699. data/vendor/local/share/locale/nn/LC_MESSAGES/glib20.mo +0 -0
  700. data/vendor/local/share/locale/oc/LC_MESSAGES/glib20.mo +0 -0
  701. data/vendor/local/share/locale/or/LC_MESSAGES/glib20.mo +0 -0
  702. data/vendor/local/share/locale/pa/LC_MESSAGES/glib20.mo +0 -0
  703. data/vendor/local/share/locale/pl/LC_MESSAGES/gettext-runtime.mo +0 -0
  704. data/vendor/local/share/locale/pl/LC_MESSAGES/glib20.mo +0 -0
  705. data/vendor/local/share/locale/ps/LC_MESSAGES/glib20.mo +0 -0
  706. data/vendor/local/share/locale/pt/LC_MESSAGES/gettext-runtime.mo +0 -0
  707. data/vendor/local/share/locale/pt/LC_MESSAGES/glib20.mo +0 -0
  708. data/vendor/local/share/locale/pt_BR/LC_MESSAGES/gettext-runtime.mo +0 -0
  709. data/vendor/local/share/locale/pt_BR/LC_MESSAGES/glib20.mo +0 -0
  710. data/vendor/local/share/locale/ro/LC_MESSAGES/gettext-runtime.mo +0 -0
  711. data/vendor/local/share/locale/ro/LC_MESSAGES/glib20.mo +0 -0
  712. data/vendor/local/share/locale/ru/LC_MESSAGES/gettext-runtime.mo +0 -0
  713. data/vendor/local/share/locale/ru/LC_MESSAGES/glib20.mo +0 -0
  714. data/vendor/local/share/locale/rw/LC_MESSAGES/glib20.mo +0 -0
  715. data/vendor/local/share/locale/si/LC_MESSAGES/glib20.mo +0 -0
  716. data/vendor/local/share/locale/sk/LC_MESSAGES/gettext-runtime.mo +0 -0
  717. data/vendor/local/share/locale/sk/LC_MESSAGES/glib20.mo +0 -0
  718. data/vendor/local/share/locale/sl/LC_MESSAGES/gettext-runtime.mo +0 -0
  719. data/vendor/local/share/locale/sl/LC_MESSAGES/glib20.mo +0 -0
  720. data/vendor/local/share/locale/sq/LC_MESSAGES/glib20.mo +0 -0
  721. data/vendor/local/share/locale/sr/LC_MESSAGES/gettext-runtime.mo +0 -0
  722. data/vendor/local/share/locale/sr/LC_MESSAGES/glib20.mo +0 -0
  723. data/vendor/local/share/locale/sr@ije/LC_MESSAGES/glib20.mo +0 -0
  724. data/vendor/local/share/locale/sr@latin/LC_MESSAGES/glib20.mo +0 -0
  725. data/vendor/local/share/locale/sv/LC_MESSAGES/gettext-runtime.mo +0 -0
  726. data/vendor/local/share/locale/sv/LC_MESSAGES/glib20.mo +0 -0
  727. data/vendor/local/share/locale/ta/LC_MESSAGES/glib20.mo +0 -0
  728. data/vendor/local/share/locale/te/LC_MESSAGES/glib20.mo +0 -0
  729. data/vendor/local/share/locale/th/LC_MESSAGES/glib20.mo +0 -0
  730. data/vendor/local/share/locale/tl/LC_MESSAGES/glib20.mo +0 -0
  731. data/vendor/local/share/locale/tr/LC_MESSAGES/gettext-runtime.mo +0 -0
  732. data/vendor/local/share/locale/tr/LC_MESSAGES/glib20.mo +0 -0
  733. data/vendor/local/share/locale/tt/LC_MESSAGES/glib20.mo +0 -0
  734. data/vendor/local/share/locale/uk/LC_MESSAGES/gettext-runtime.mo +0 -0
  735. data/vendor/local/share/locale/uk/LC_MESSAGES/glib20.mo +0 -0
  736. data/vendor/local/share/locale/vi/LC_MESSAGES/gettext-runtime.mo +0 -0
  737. data/vendor/local/share/locale/vi/LC_MESSAGES/glib20.mo +0 -0
  738. data/vendor/local/share/locale/wa/LC_MESSAGES/glib20.mo +0 -0
  739. data/vendor/local/share/locale/xh/LC_MESSAGES/glib20.mo +0 -0
  740. data/vendor/local/share/locale/yi/LC_MESSAGES/glib20.mo +0 -0
  741. data/vendor/local/share/locale/zh_CN/LC_MESSAGES/gettext-runtime.mo +0 -0
  742. data/vendor/local/share/locale/zh_CN/LC_MESSAGES/glib20.mo +0 -0
  743. data/vendor/local/share/locale/zh_HK/LC_MESSAGES/gettext-runtime.mo +0 -0
  744. data/vendor/local/share/locale/zh_HK/LC_MESSAGES/glib20.mo +0 -0
  745. data/vendor/local/share/locale/zh_TW/LC_MESSAGES/gettext-runtime.mo +0 -0
  746. data/vendor/local/share/locale/zh_TW/LC_MESSAGES/glib20.mo +0 -0
  747. data/vendor/local/share/man/man1/envsubst.1 +0 -54
  748. data/vendor/local/share/man/man1/gettext.1 +0 -69
  749. data/vendor/local/share/man/man1/glib-genmarshal.1 +0 -312
  750. data/vendor/local/share/man/man1/glib-mkenums.1 +0 -246
  751. data/vendor/local/share/man/man1/gobject-query.1 +0 -83
  752. data/vendor/local/share/man/man1/ngettext.1 +0 -68
  753. data/vendor/local/share/man/man3/bind_textdomain_codeset.3 +0 -72
  754. data/vendor/local/share/man/man3/bindtextdomain.3 +0 -69
  755. data/vendor/local/share/man/man3/dcgettext.3 +0 -1
  756. data/vendor/local/share/man/man3/dcngettext.3 +0 -1
  757. data/vendor/local/share/man/man3/dgettext.3 +0 -1
  758. data/vendor/local/share/man/man3/dngettext.3 +0 -1
  759. data/vendor/local/share/man/man3/gettext.3 +0 -99
  760. data/vendor/local/share/man/man3/ngettext.3 +0 -60
  761. data/vendor/local/share/man/man3/textdomain.3 +0 -57
  762. data/vendor/local/src/tml/packaging/gettext_0.18.1.1-2_win32.log +0 -10423
  763. data/vendor/local/src/tml/packaging/gettext_0.18.1.1-2_win32.sh +0 -457
  764. data/vendor/local/src/tml/packaging/glib_2.26.0-2_win32.log +0 -2867
  765. data/vendor/local/src/tml/packaging/glib_2.26.0-2_win32.sh +0 -64
data/vendor/local/share/gtk-doc/html/glib/glib-Commandline-option-parser.html DELETED
@@ -1,1671 +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>Commandline option parser</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-utilities.html" title="GLib Utilities">
9
- <link rel="prev" href="glib-Shell-related-Utilities.html" title="Shell-related Utilities">
10
- <link rel="next" href="glib-Glob-style-pattern-matching.html" title="Glob-style pattern matching">
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-Shell-related-Utilities.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
- <td><a accesskey="u" href="glib-utilities.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-Glob-style-pattern-matching.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-Commandline-option-parser.synopsis" class="shortcut">Top</a>
25
-  | 
26
- <a href="#glib-Commandline-option-parser.description" class="shortcut">Description</a>
27
- </td></tr>
28
- </table>
29
- <div class="refentry">
30
- <a name="glib-Commandline-option-parser"></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-Commandline-option-parser.top_of_page"></a>Commandline option parser</span></h2>
34
- <p>Commandline option parser — parses commandline options</p>
35
- </td>
36
- <td valign="top" align="right"></td>
37
- </tr></table></div>
38
- <div class="refsynopsisdiv">
39
- <a name="glib-Commandline-option-parser.synopsis"></a><h2>Synopsis</h2>
40
- <pre class="synopsis">
41
- #include &lt;glib.h&gt;
42
-
43
- enum <a class="link" href="glib-Commandline-option-parser.html#GOptionError" title="enum GOptionError">GOptionError</a>;
44
- #define <a class="link" href="glib-Commandline-option-parser.html#G-OPTION-ERROR:CAPS" title="G_OPTION_ERROR">G_OPTION_ERROR</a>
45
- <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> (<a class="link" href="glib-Commandline-option-parser.html#GOptionArgFunc" title="GOptionArgFunc ()">*GOptionArgFunc</a>) (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *option_name</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> *value</code></em>,
47
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> data</code></em>,
48
- <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
49
- <a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext">GOptionContext</a>;
50
- <a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="returnvalue">GOptionContext</span></a> * <a class="link" href="glib-Commandline-option-parser.html#g-option-context-new" title="g_option_context_new ()">g_option_context_new</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *parameter_string</code></em>);
51
- <span class="returnvalue">void</span> <a class="link" href="glib-Commandline-option-parser.html#g-option-context-set-summary" title="g_option_context_set_summary ()">g_option_context_set_summary</a> (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>,
52
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *summary</code></em>);
53
- const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-Commandline-option-parser.html#g-option-context-get-summary" title="g_option_context_get_summary ()">g_option_context_get_summary</a> (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>);
54
- <span class="returnvalue">void</span> <a class="link" href="glib-Commandline-option-parser.html#g-option-context-set-description" title="g_option_context_set_description ()">g_option_context_set_description</a> (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>,
55
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *description</code></em>);
56
- const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-Commandline-option-parser.html#g-option-context-get-description" title="g_option_context_get_description ()">g_option_context_get_description</a> (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>);
57
- const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * (<a class="link" href="glib-Commandline-option-parser.html#GTranslateFunc" title="GTranslateFunc ()">*GTranslateFunc</a>) (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
58
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> data</code></em>);
59
- <span class="returnvalue">void</span> <a class="link" href="glib-Commandline-option-parser.html#g-option-context-set-translate-func" title="g_option_context_set_translate_func ()">g_option_context_set_translate_func</a> (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>,
60
- <em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GTranslateFunc" title="GTranslateFunc ()"><span class="type">GTranslateFunc</span></a> func</code></em>,
61
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> data</code></em>,
62
- <em class="parameter"><code><a class="link" href="glib-Datasets.html#GDestroyNotify" title="GDestroyNotify ()"><span class="type">GDestroyNotify</span></a> destroy_notify</code></em>);
63
- <span class="returnvalue">void</span> <a class="link" href="glib-Commandline-option-parser.html#g-option-context-set-translation-domain" title="g_option_context_set_translation_domain ()">g_option_context_set_translation_domain</a>
64
- (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>,
65
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *domain</code></em>);
66
- <span class="returnvalue">void</span> <a class="link" href="glib-Commandline-option-parser.html#g-option-context-free" title="g_option_context_free ()">g_option_context_free</a> (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>);
67
- <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Commandline-option-parser.html#g-option-context-parse" title="g_option_context_parse ()">g_option_context_parse</a> (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>,
68
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> *argc</code></em>,
69
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> ***argv</code></em>,
70
- <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
71
- <span class="returnvalue">void</span> <a class="link" href="glib-Commandline-option-parser.html#g-option-context-set-help-enabled" title="g_option_context_set_help_enabled ()">g_option_context_set_help_enabled</a> (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>,
72
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> help_enabled</code></em>);
73
- <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Commandline-option-parser.html#g-option-context-get-help-enabled" title="g_option_context_get_help_enabled ()">g_option_context_get_help_enabled</a> (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>);
74
- <span class="returnvalue">void</span> <a class="link" href="glib-Commandline-option-parser.html#g-option-context-set-ignore-unknown-options" title="g_option_context_set_ignore_unknown_options ()">g_option_context_set_ignore_unknown_options</a>
75
- (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>,
76
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> ignore_unknown</code></em>);
77
- <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Commandline-option-parser.html#g-option-context-get-ignore-unknown-options" title="g_option_context_get_ignore_unknown_options ()">g_option_context_get_ignore_unknown_options</a>
78
- (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>);
79
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-Commandline-option-parser.html#g-option-context-get-help" title="g_option_context_get_help ()">g_option_context_get_help</a> (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>,
80
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> main_help</code></em>,
81
- <em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a> *group</code></em>);
82
- enum <a class="link" href="glib-Commandline-option-parser.html#GOptionArg" title="enum GOptionArg">GOptionArg</a>;
83
- enum <a class="link" href="glib-Commandline-option-parser.html#GOptionFlags" title="enum GOptionFlags">GOptionFlags</a>;
84
- #define <a class="link" href="glib-Commandline-option-parser.html#G-OPTION-REMAINING:CAPS" title="G_OPTION_REMAINING">G_OPTION_REMAINING</a>
85
- <a class="link" href="glib-Commandline-option-parser.html#GOptionEntry" title="GOptionEntry">GOptionEntry</a>;
86
- <span class="returnvalue">void</span> <a class="link" href="glib-Commandline-option-parser.html#g-option-context-add-main-entries" title="g_option_context_add_main_entries ()">g_option_context_add_main_entries</a> (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>,
87
- <em class="parameter"><code>const <a class="link" href="glib-Commandline-option-parser.html#GOptionEntry" title="GOptionEntry"><span class="type">GOptionEntry</span></a> *entries</code></em>,
88
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *translation_domain</code></em>);
89
- <a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup">GOptionGroup</a>;
90
- <span class="returnvalue">void</span> <a class="link" href="glib-Commandline-option-parser.html#g-option-context-add-group" title="g_option_context_add_group ()">g_option_context_add_group</a> (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>,
91
- <em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a> *group</code></em>);
92
- <span class="returnvalue">void</span> <a class="link" href="glib-Commandline-option-parser.html#g-option-context-set-main-group" title="g_option_context_set_main_group ()">g_option_context_set_main_group</a> (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>,
93
- <em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a> *group</code></em>);
94
- <a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="returnvalue">GOptionGroup</span></a> * <a class="link" href="glib-Commandline-option-parser.html#g-option-context-get-main-group" title="g_option_context_get_main_group ()">g_option_context_get_main_group</a> (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>);
95
- <a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="returnvalue">GOptionGroup</span></a> * <a class="link" href="glib-Commandline-option-parser.html#g-option-group-new" title="g_option_group_new ()">g_option_group_new</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *name</code></em>,
96
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *description</code></em>,
97
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *help_description</code></em>,
98
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
99
- <em class="parameter"><code><a class="link" href="glib-Datasets.html#GDestroyNotify" title="GDestroyNotify ()"><span class="type">GDestroyNotify</span></a> destroy</code></em>);
100
- <span class="returnvalue">void</span> <a class="link" href="glib-Commandline-option-parser.html#g-option-group-free" title="g_option_group_free ()">g_option_group_free</a> (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a> *group</code></em>);
101
- <span class="returnvalue">void</span> <a class="link" href="glib-Commandline-option-parser.html#g-option-group-add-entries" title="g_option_group_add_entries ()">g_option_group_add_entries</a> (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a> *group</code></em>,
102
- <em class="parameter"><code>const <a class="link" href="glib-Commandline-option-parser.html#GOptionEntry" title="GOptionEntry"><span class="type">GOptionEntry</span></a> *entries</code></em>);
103
- <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> (<a class="link" href="glib-Commandline-option-parser.html#GOptionParseFunc" title="GOptionParseFunc ()">*GOptionParseFunc</a>) (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>,
104
- <em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a> *group</code></em>,
105
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> data</code></em>,
106
- <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
107
- <span class="returnvalue">void</span> <a class="link" href="glib-Commandline-option-parser.html#g-option-group-set-parse-hooks" title="g_option_group_set_parse_hooks ()">g_option_group_set_parse_hooks</a> (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a> *group</code></em>,
108
- <em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionParseFunc" title="GOptionParseFunc ()"><span class="type">GOptionParseFunc</span></a> pre_parse_func</code></em>,
109
- <em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionParseFunc" title="GOptionParseFunc ()"><span class="type">GOptionParseFunc</span></a> post_parse_func</code></em>);
110
- <span class="returnvalue">void</span> (<a class="link" href="glib-Commandline-option-parser.html#GOptionErrorFunc" title="GOptionErrorFunc ()">*GOptionErrorFunc</a>) (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>,
111
- <em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a> *group</code></em>,
112
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> data</code></em>,
113
- <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
114
- <span class="returnvalue">void</span> <a class="link" href="glib-Commandline-option-parser.html#g-option-group-set-error-hook" title="g_option_group_set_error_hook ()">g_option_group_set_error_hook</a> (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a> *group</code></em>,
115
- <em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionErrorFunc" title="GOptionErrorFunc ()"><span class="type">GOptionErrorFunc</span></a> error_func</code></em>);
116
- <span class="returnvalue">void</span> <a class="link" href="glib-Commandline-option-parser.html#g-option-group-set-translate-func" title="g_option_group_set_translate_func ()">g_option_group_set_translate_func</a> (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a> *group</code></em>,
117
- <em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GTranslateFunc" title="GTranslateFunc ()"><span class="type">GTranslateFunc</span></a> func</code></em>,
118
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> data</code></em>,
119
- <em class="parameter"><code><a class="link" href="glib-Datasets.html#GDestroyNotify" title="GDestroyNotify ()"><span class="type">GDestroyNotify</span></a> destroy_notify</code></em>);
120
- <span class="returnvalue">void</span> <a class="link" href="glib-Commandline-option-parser.html#g-option-group-set-translation-domain" title="g_option_group_set_translation_domain ()">g_option_group_set_translation_domain</a>
121
- (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a> *group</code></em>,
122
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *domain</code></em>);
123
- </pre>
124
- </div>
125
- <div class="refsect1">
126
- <a name="glib-Commandline-option-parser.description"></a><h2>Description</h2>
127
- <p>
128
- The GOption commandline parser is intended to be a simpler replacement
129
- for the popt library. It supports short and long commandline options,
130
- as shown in the following example:
131
- </p>
132
- <p>
133
- <code class="literal">testtreemodel -r 1 --max-size 20 --rand --display=:1.0 -vb -- file1 file2</code>
134
- </p>
135
- <p>
136
- The example demonstrates a number of features of the GOption
137
- commandline parser
138
- </p>
139
- <div class="itemizedlist"><ul class="itemizedlist" type="disc">
140
- <li class="listitem"><p>
141
- Options can be single letters, prefixed by a single dash. Multiple
142
- short options can be grouped behind a single dash.
143
- </p></li>
144
- <li class="listitem"><p>
145
- Long options are prefixed by two consecutive dashes.
146
- </p></li>
147
- <li class="listitem"><p>
148
- Options can have an extra argument, which can be a number, a string or
149
- a filename. For long options, the extra argument can be appended with
150
- an equals sign after the option name, which is useful if the extra
151
- argument starts with a dash, which would otherwise cause it to be
152
- interpreted as another option.
153
- </p></li>
154
- <li class="listitem"><p>
155
- Non-option arguments are returned to the application as rest arguments.
156
- </p></li>
157
- <li class="listitem"><p>
158
- An argument consisting solely of two dashes turns off further parsing,
159
- any remaining arguments (even those starting with a dash) are returned
160
- to the application as rest arguments.
161
- </p></li>
162
- </ul></div>
163
- <p>
164
- </p>
165
- <p>
166
- Another important feature of GOption is that it can automatically
167
- generate nicely formatted help output. Unless it is explicitly turned
168
- off with <a class="link" href="glib-Commandline-option-parser.html#g-option-context-set-help-enabled" title="g_option_context_set_help_enabled ()"><code class="function">g_option_context_set_help_enabled()</code></a>, GOption will recognize
169
- the <code class="option">--help</code>, <code class="option">-?</code>,
170
- <code class="option">--help-all</code> and
171
- <code class="option">--help-</code><em class="replaceable"><code>groupname</code></em> options
172
- (where <em class="replaceable"><code>groupname</code></em> is the name of a
173
- <a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a>) and write a text similar to the one shown in the
174
- following example to stdout.
175
- </p>
176
- <p>
177
- </p>
178
- <div class="informalexample"><pre class="screen">
179
- Usage:
180
- testtreemodel [OPTION...] - test tree model performance
181
-
182
- Help Options:
183
- -h, --help Show help options
184
- --help-all Show all help options
185
- --help-gtk Show GTK+ Options
186
-
187
- Application Options:
188
- -r, --repeats=N Average over N repetitions
189
- -m, --max-size=M Test up to 2^M items
190
- --display=DISPLAY X display to use
191
- -v, --verbose Be verbose
192
- -b, --beep Beep when done
193
- --rand Randomize the data
194
- </pre></div>
195
- <p>
196
- </p>
197
- <p>
198
- GOption groups options in <a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a>s, which makes it easy to
199
- incorporate options from multiple sources. The intended use for this is
200
- to let applications collect option groups from the libraries it uses,
201
- add them to their <a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a>, and parse all options by a single call
202
- to <a class="link" href="glib-Commandline-option-parser.html#g-option-context-parse" title="g_option_context_parse ()"><code class="function">g_option_context_parse()</code></a>. See <a href="http://library.gnome.org/devel/gtk/unstable/gtk3-General.html#gtk-get-option-group"><code class="function">gtk_get_option_group()</code></a> for an example.
203
- </p>
204
- <p>
205
- If an option is declared to be of type string or filename, GOption takes
206
- care of converting it to the right encoding; strings are returned in
207
- UTF-8, filenames are returned in the GLib filename encoding. Note that
208
- this only works if <a class="link" href="glib-running.html#setlocale" title="Locale"><code class="function">setlocale()</code></a> has been called before
209
- <a class="link" href="glib-Commandline-option-parser.html#g-option-context-parse" title="g_option_context_parse ()"><code class="function">g_option_context_parse()</code></a>.
210
- </p>
211
- <p>
212
- Here is a complete example of setting up GOption to parse the example
213
- commandline above and produce the example help output.
214
- </p>
215
- <p>
216
- </p>
217
- <div class="informalexample">
218
- <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
219
- <tbody>
220
- <tr>
221
- <td class="listing_lines" align="right"><pre>1
222
- 2
223
- 3
224
- 4
225
- 5
226
- 6
227
- 7
228
- 8
229
- 9
230
- 10
231
- 11
232
- 12
233
- 13
234
- 14
235
- 15
236
- 16
237
- 17
238
- 18
239
- 19
240
- 20
241
- 21
242
- 22
243
- 23
244
- 24
245
- 25
246
- 26
247
- 27
248
- 28
249
- 29
250
- 30
251
- 31
252
- 32
253
- 33
254
- 34</pre></td>
255
- <td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> </span><span class="usertype">gint</span><span class="normal"> repeats </span><span class="symbol">=</span><span class="normal"> </span><span class="number">2</span><span class="symbol">;</span>
256
- <span class="keyword">static</span><span class="normal"> </span><span class="usertype">gint</span><span class="normal"> max_size </span><span class="symbol">=</span><span class="normal"> </span><span class="number">8</span><span class="symbol">;</span>
257
- <span class="keyword">static</span><span class="normal"> </span><span class="usertype">gboolean</span><span class="normal"> verbose </span><span class="symbol">=</span><span class="normal"> <a href="glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">;</span>
258
- <span class="keyword">static</span><span class="normal"> </span><span class="usertype">gboolean</span><span class="normal"> beep </span><span class="symbol">=</span><span class="normal"> <a href="glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">;</span>
259
- <span class="keyword">static</span><span class="normal"> </span><span class="usertype">gboolean</span><span class="normal"> rand </span><span class="symbol">=</span><span class="normal"> <a href="glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">;</span>
260
-
261
- <span class="keyword">static</span><span class="normal"> </span><span class="usertype">GOptionEntry</span><span class="normal"> entries</span><span class="symbol">[]</span><span class="normal"> </span><span class="symbol">=</span>
262
- <span class="cbracket">{</span>
263
- <span class="normal"> </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"repeats"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">'r'</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> <a href="glib-Commandline-option-parser.html#G-OPTION-ARG-INT:CAPS">G_OPTION_ARG_INT</a></span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">repeats</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Average over N repetitions"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"N"</span><span class="normal"> </span><span class="cbracket">}</span><span class="symbol">,</span>
264
- <span class="normal"> </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"max-size"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">'m'</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> <a href="glib-Commandline-option-parser.html#G-OPTION-ARG-INT:CAPS">G_OPTION_ARG_INT</a></span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">max_size</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Test up to 2^M items"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"M"</span><span class="normal"> </span><span class="cbracket">}</span><span class="symbol">,</span>
265
- <span class="normal"> </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"verbose"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">'v'</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> <a href="glib-Commandline-option-parser.html#G-OPTION-ARG-NONE:CAPS">G_OPTION_ARG_NONE</a></span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">verbose</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Be verbose"</span><span class="symbol">,</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
266
- <span class="normal"> </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"beep"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">'b'</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> <a href="glib-Commandline-option-parser.html#G-OPTION-ARG-NONE:CAPS">G_OPTION_ARG_NONE</a></span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">beep</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Beep when done"</span><span class="symbol">,</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
267
- <span class="normal"> </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"rand"</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> <a href="glib-Commandline-option-parser.html#G-OPTION-ARG-NONE:CAPS">G_OPTION_ARG_NONE</a></span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">rand</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Randomize the data"</span><span class="symbol">,</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
268
- <span class="normal"> </span><span class="cbracket">{</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a> </span><span class="cbracket">}</span>
269
- <span class="cbracket">}</span><span class="symbol">;</span>
270
-
271
- <span class="type">int</span>
272
- <span class="function">main</span><span class="normal"> </span><span class="symbol">(</span><span class="type">int</span><span class="normal"> argc</span><span class="symbol">,</span><span class="normal"> </span><span class="type">char</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">argv</span><span class="symbol">[])</span>
273
- <span class="cbracket">{</span>
274
- <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><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
275
- <span class="normal"> </span><span class="usertype">GOptionContext</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">context</span><span class="symbol">;</span>
276
-
277
- <span class="normal"> context </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Commandline-option-parser.html#g-option-context-new">g_option_context_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"- test tree model performance"</span><span class="symbol">);</span>
278
- <span class="normal"> </span><span class="function"><a href="glib-Commandline-option-parser.html#g-option-context-add-main-entries">g_option_context_add_main_entries</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">context</span><span class="symbol">,</span><span class="normal"> entries</span><span class="symbol">,</span><span class="normal"> <a href="/home/desrt/local/share/gtk-doc/html/xmlroff/xmlroff-fo-utils.html#GETTEXT-PACKAGE:CAPS">GETTEXT_PACKAGE</a></span><span class="symbol">);</span>
279
- <span class="normal"> </span><span class="function"><a href="glib-Commandline-option-parser.html#g-option-context-add-group">g_option_context_add_group</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">context</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/gtk/unstable/gtk3-General.html#gtk-get-option-group">gtk_get_option_group</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="glib-Standard-Macros.html#TRUE:CAPS">TRUE</a></span><span class="symbol">));</span>
280
- <span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(!</span><span class="function"><a href="glib-Commandline-option-parser.html#g-option-context-parse">g_option_context_parse</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">context</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">argc</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">argv</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">error</span><span class="symbol">))</span>
281
- <span class="normal"> </span><span class="cbracket">{</span>
282
- <span class="normal"> </span><span class="function"><a href="glib-Warnings-and-Assertions.html#g-print">g_print</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"option parsing failed: %s</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">,</span><span class="normal"> error</span><span class="symbol">-&gt;</span><span class="normal">message</span><span class="symbol">);</span>
283
- <span class="normal"> </span><span class="function">exit</span><span class="normal"> </span><span class="symbol">(</span><span class="number">1</span><span class="symbol">);</span>
284
- <span class="normal"> </span><span class="cbracket">}</span>
285
-
286
- <span class="normal"> </span><span class="comment">/* ... */</span>
287
-
288
- <span class="cbracket">}</span></pre></td>
289
- </tr>
290
- </tbody>
291
- </table>
292
- </div>
293
-
294
- <p>
295
- </p>
296
- </div>
297
- <div class="refsect1">
298
- <a name="glib-Commandline-option-parser.details"></a><h2>Details</h2>
299
- <div class="refsect2">
300
- <a name="GOptionError"></a><h3>enum GOptionError</h3>
301
- <pre class="programlisting">typedef enum
302
- {
303
- G_OPTION_ERROR_UNKNOWN_OPTION,
304
- G_OPTION_ERROR_BAD_VALUE,
305
- G_OPTION_ERROR_FAILED
306
- } GOptionError;
307
- </pre>
308
- <p>
309
- Error codes returned by option parsing.
310
- </p>
311
- <div class="variablelist"><table border="0">
312
- <col align="left" valign="top">
313
- <tbody>
314
- <tr>
315
- <td><p><a name="G-OPTION-ERROR-UNKNOWN-OPTION:CAPS"></a><span class="term"><code class="literal">G_OPTION_ERROR_UNKNOWN_OPTION</code></span></p></td>
316
- <td>An option was not known to the parser.
317
- This error will only be reported, if the parser hasn't been instructed
318
- to ignore unknown options, see <a class="link" href="glib-Commandline-option-parser.html#g-option-context-set-ignore-unknown-options" title="g_option_context_set_ignore_unknown_options ()"><code class="function">g_option_context_set_ignore_unknown_options()</code></a>.
319
- </td>
320
- </tr>
321
- <tr>
322
- <td><p><a name="G-OPTION-ERROR-BAD-VALUE:CAPS"></a><span class="term"><code class="literal">G_OPTION_ERROR_BAD_VALUE</code></span></p></td>
323
- <td>A value couldn't be parsed.
324
- </td>
325
- </tr>
326
- <tr>
327
- <td><p><a name="G-OPTION-ERROR-FAILED:CAPS"></a><span class="term"><code class="literal">G_OPTION_ERROR_FAILED</code></span></p></td>
328
- <td>A <a class="link" href="glib-Commandline-option-parser.html#GOptionArgFunc" title="GOptionArgFunc ()"><span class="type">GOptionArgFunc</span></a> callback failed.
329
- </td>
330
- </tr>
331
- </tbody>
332
- </table></div>
333
- </div>
334
- <hr>
335
- <div class="refsect2">
336
- <a name="G-OPTION-ERROR:CAPS"></a><h3>G_OPTION_ERROR</h3>
337
- <pre class="programlisting">#define G_OPTION_ERROR (g_option_error_quark ())
338
- </pre>
339
- <p>
340
- Error domain for option parsing. Errors in this domain will
341
- be from the <a class="link" href="glib-Commandline-option-parser.html#GOptionError" title="enum GOptionError"><span class="type">GOptionError</span></a> enumeration. See <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> for information on
342
- error domains.
343
- </p>
344
- </div>
345
- <hr>
346
- <div class="refsect2">
347
- <a name="GOptionArgFunc"></a><h3>GOptionArgFunc ()</h3>
348
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> (*GOptionArgFunc) (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *option_name</code></em>,
349
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *value</code></em>,
350
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> data</code></em>,
351
- <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>
352
- <p>
353
- The type of function to be passed as callback for <a class="link" href="glib-Commandline-option-parser.html#G-OPTION-ARG-CALLBACK:CAPS"><code class="literal">G_OPTION_ARG_CALLBACK</code></a>
354
- options.
355
- </p>
356
- <div class="variablelist"><table border="0">
357
- <col align="left" valign="top">
358
- <tbody>
359
- <tr>
360
- <td><p><span class="term"><em class="parameter"><code>option_name</code></em> :</span></p></td>
361
- <td>The name of the option being parsed. This will be either a
362
- single dash followed by a single letter (for a short name) or two dashes
363
- followed by a long option name.
364
- </td>
365
- </tr>
366
- <tr>
367
- <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
368
- <td>The value to be parsed.
369
- </td>
370
- </tr>
371
- <tr>
372
- <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
373
- <td>User data added to the <a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a> containing the option when it
374
- was created with <a class="link" href="glib-Commandline-option-parser.html#g-option-group-new" title="g_option_group_new ()"><code class="function">g_option_group_new()</code></a>
375
- </td>
376
- </tr>
377
- <tr>
378
- <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
379
- <td>A return location for errors. The error code <a class="link" href="glib-Commandline-option-parser.html#G-OPTION-ERROR-FAILED:CAPS"><code class="literal">G_OPTION_ERROR_FAILED</code></a>
380
- is intended to be used for errors in <a class="link" href="glib-Commandline-option-parser.html#GOptionArgFunc" title="GOptionArgFunc ()"><span class="type">GOptionArgFunc</span></a> callbacks.
381
- </td>
382
- </tr>
383
- <tr>
384
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
385
- <td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the option was successfully parsed, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> if an error
386
- occurred, in which case <em class="parameter"><code>error</code></em> should be set with <a class="link" href="glib-Error-Reporting.html#g-set-error" title="g_set_error ()"><code class="function">g_set_error()</code></a>
387
- </td>
388
- </tr>
389
- </tbody>
390
- </table></div>
391
- </div>
392
- <hr>
393
- <div class="refsect2">
394
- <a name="GOptionContext"></a><h3>GOptionContext</h3>
395
- <pre class="programlisting">typedef struct _GOptionContext GOptionContext;</pre>
396
- <p>
397
- A <span class="structname">GOptionContext</span> struct defines which options
398
- are accepted by the commandline option parser. The struct has only private
399
- fields and should not be directly accessed.
400
- </p>
401
- </div>
402
- <hr>
403
- <div class="refsect2">
404
- <a name="g-option-context-new"></a><h3>g_option_context_new ()</h3>
405
- <pre class="programlisting"><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="returnvalue">GOptionContext</span></a> * g_option_context_new (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *parameter_string</code></em>);</pre>
406
- <p>
407
- Creates a new option context.
408
- </p>
409
- <p>
410
- The <em class="parameter"><code>parameter_string</code></em> can serve multiple purposes. It can be used
411
- to add descriptions for "rest" arguments, which are not parsed by
412
- the <a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a>, typically something like "FILES" or
413
- "FILE1 FILE2...". If you are using <a class="link" href="glib-Commandline-option-parser.html#G-OPTION-REMAINING:CAPS" title="G_OPTION_REMAINING"><span class="type">G_OPTION_REMAINING</span></a> for
414
- collecting "rest" arguments, GLib handles this automatically by
415
- using the <em class="parameter"><code>arg_description</code></em> of the corresponding <a class="link" href="glib-Commandline-option-parser.html#GOptionEntry" title="GOptionEntry"><span class="type">GOptionEntry</span></a> in
416
- the usage summary.
417
- </p>
418
- <p>
419
- Another usage is to give a short summary of the program
420
- functionality, like " - frob the strings", which will be displayed
421
- in the same line as the usage. For a longer description of the
422
- program functionality that should be displayed as a paragraph
423
- below the usage line, use <a class="link" href="glib-Commandline-option-parser.html#g-option-context-set-summary" title="g_option_context_set_summary ()"><code class="function">g_option_context_set_summary()</code></a>.
424
- </p>
425
- <p>
426
- Note that the <em class="parameter"><code>parameter_string</code></em> is translated using the
427
- function set with <a class="link" href="glib-Commandline-option-parser.html#g-option-context-set-translate-func" title="g_option_context_set_translate_func ()"><code class="function">g_option_context_set_translate_func()</code></a>, so
428
- it should normally be passed untranslated.
429
- </p>
430
- <div class="variablelist"><table border="0">
431
- <col align="left" valign="top">
432
- <tbody>
433
- <tr>
434
- <td><p><span class="term"><em class="parameter"><code>parameter_string</code></em> :</span></p></td>
435
- <td>a string which is displayed in
436
- the first line of <code class="option">--help</code> output, after the
437
- usage summary
438
- <code class="literal"><em class="replaceable"><code>programname</code></em> [OPTION...]</code>
439
- </td>
440
- </tr>
441
- <tr>
442
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
443
- <td> a newly created <a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a>, which must be
444
- freed with <a class="link" href="glib-Commandline-option-parser.html#g-option-context-free" title="g_option_context_free ()"><code class="function">g_option_context_free()</code></a> after use.
445
-
446
- </td>
447
- </tr>
448
- </tbody>
449
- </table></div>
450
- <p class="since">Since 2.6</p>
451
- </div>
452
- <hr>
453
- <div class="refsect2">
454
- <a name="g-option-context-set-summary"></a><h3>g_option_context_set_summary ()</h3>
455
- <pre class="programlisting"><span class="returnvalue">void</span> g_option_context_set_summary (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>,
456
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *summary</code></em>);</pre>
457
- <p>
458
- Adds a string to be displayed in <code class="option">--help</code> output
459
- before the list of options. This is typically a summary of the
460
- program functionality.
461
- </p>
462
- <p>
463
- Note that the summary is translated (see
464
- <a class="link" href="glib-Commandline-option-parser.html#g-option-context-set-translate-func" title="g_option_context_set_translate_func ()"><code class="function">g_option_context_set_translate_func()</code></a> and
465
- <a class="link" href="glib-Commandline-option-parser.html#g-option-context-set-translation-domain" title="g_option_context_set_translation_domain ()"><code class="function">g_option_context_set_translation_domain()</code></a>).
466
- </p>
467
- <div class="variablelist"><table border="0">
468
- <col align="left" valign="top">
469
- <tbody>
470
- <tr>
471
- <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
472
- <td>a <a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a>
473
- </td>
474
- </tr>
475
- <tr>
476
- <td><p><span class="term"><em class="parameter"><code>summary</code></em> :</span></p></td>
477
- <td>a string to be shown in <code class="option">--help</code> output
478
- before the list of options, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
479
- </td>
480
- </tr>
481
- </tbody>
482
- </table></div>
483
- <p class="since">Since 2.12</p>
484
- </div>
485
- <hr>
486
- <div class="refsect2">
487
- <a name="g-option-context-get-summary"></a><h3>g_option_context_get_summary ()</h3>
488
- <pre class="programlisting">const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_option_context_get_summary (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>);</pre>
489
- <p>
490
- Returns the summary. See <a class="link" href="glib-Commandline-option-parser.html#g-option-context-set-summary" title="g_option_context_set_summary ()"><code class="function">g_option_context_set_summary()</code></a>.
491
- </p>
492
- <div class="variablelist"><table border="0">
493
- <col align="left" valign="top">
494
- <tbody>
495
- <tr>
496
- <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
497
- <td>a <a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a>
498
- </td>
499
- </tr>
500
- <tr>
501
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
502
- <td> the summary
503
-
504
- </td>
505
- </tr>
506
- </tbody>
507
- </table></div>
508
- <p class="since">Since 2.12</p>
509
- </div>
510
- <hr>
511
- <div class="refsect2">
512
- <a name="g-option-context-set-description"></a><h3>g_option_context_set_description ()</h3>
513
- <pre class="programlisting"><span class="returnvalue">void</span> g_option_context_set_description (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>,
514
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *description</code></em>);</pre>
515
- <p>
516
- Adds a string to be displayed in <code class="option">--help</code> output
517
- after the list of options. This text often includes a bug reporting
518
- address.
519
- </p>
520
- <p>
521
- Note that the summary is translated (see
522
- <a class="link" href="glib-Commandline-option-parser.html#g-option-context-set-translate-func" title="g_option_context_set_translate_func ()"><code class="function">g_option_context_set_translate_func()</code></a>).
523
- </p>
524
- <div class="variablelist"><table border="0">
525
- <col align="left" valign="top">
526
- <tbody>
527
- <tr>
528
- <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
529
- <td>a <a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a>
530
- </td>
531
- </tr>
532
- <tr>
533
- <td><p><span class="term"><em class="parameter"><code>description</code></em> :</span></p></td>
534
- <td>a string to be shown in <code class="option">--help</code> output
535
- after the list of options, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
536
- </td>
537
- </tr>
538
- </tbody>
539
- </table></div>
540
- <p class="since">Since 2.12</p>
541
- </div>
542
- <hr>
543
- <div class="refsect2">
544
- <a name="g-option-context-get-description"></a><h3>g_option_context_get_description ()</h3>
545
- <pre class="programlisting">const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_option_context_get_description (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>);</pre>
546
- <p>
547
- Returns the description. See <a class="link" href="glib-Commandline-option-parser.html#g-option-context-set-description" title="g_option_context_set_description ()"><code class="function">g_option_context_set_description()</code></a>.
548
- </p>
549
- <div class="variablelist"><table border="0">
550
- <col align="left" valign="top">
551
- <tbody>
552
- <tr>
553
- <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
554
- <td>a <a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a>
555
- </td>
556
- </tr>
557
- <tr>
558
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
559
- <td> the description
560
-
561
- </td>
562
- </tr>
563
- </tbody>
564
- </table></div>
565
- <p class="since">Since 2.12</p>
566
- </div>
567
- <hr>
568
- <div class="refsect2">
569
- <a name="GTranslateFunc"></a><h3>GTranslateFunc ()</h3>
570
- <pre class="programlisting">const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * (*GTranslateFunc) (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
571
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
572
- <p>
573
- The type of functions which are used to translate user-visible
574
- strings, for <code class="option">--help</code> output.
575
- </p>
576
- <div class="variablelist"><table border="0">
577
- <col align="left" valign="top">
578
- <tbody>
579
- <tr>
580
- <td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
581
- <td>the untranslated string
582
- </td>
583
- </tr>
584
- <tr>
585
- <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
586
- <td>user data specified when installing the function, e.g.
587
- in <a class="link" href="glib-Commandline-option-parser.html#g-option-group-set-translate-func" title="g_option_group_set_translate_func ()"><code class="function">g_option_group_set_translate_func()</code></a>
588
- </td>
589
- </tr>
590
- <tr>
591
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
592
- <td> a translation of the string for the current locale.
593
- The returned string is owned by GLib and must not be freed.
594
- </td>
595
- </tr>
596
- </tbody>
597
- </table></div>
598
- </div>
599
- <hr>
600
- <div class="refsect2">
601
- <a name="g-option-context-set-translate-func"></a><h3>g_option_context_set_translate_func ()</h3>
602
- <pre class="programlisting"><span class="returnvalue">void</span> g_option_context_set_translate_func (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>,
603
- <em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GTranslateFunc" title="GTranslateFunc ()"><span class="type">GTranslateFunc</span></a> func</code></em>,
604
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> data</code></em>,
605
- <em class="parameter"><code><a class="link" href="glib-Datasets.html#GDestroyNotify" title="GDestroyNotify ()"><span class="type">GDestroyNotify</span></a> destroy_notify</code></em>);</pre>
606
- <p>
607
- Sets the function which is used to translate the contexts
608
- user-visible strings, for <code class="option">--help</code> output.
609
- If <em class="parameter"><code>func</code></em> is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, strings are not translated.
610
- </p>
611
- <p>
612
- Note that option groups have their own translation functions,
613
- this function only affects the <em class="parameter"><code>parameter_string</code></em> (see <a class="link" href="glib-Commandline-option-parser.html#g-option-context-new" title="g_option_context_new ()"><code class="function">g_option_context_new()</code></a>),
614
- the summary (see <a class="link" href="glib-Commandline-option-parser.html#g-option-context-set-summary" title="g_option_context_set_summary ()"><code class="function">g_option_context_set_summary()</code></a>) and the description
615
- (see <a class="link" href="glib-Commandline-option-parser.html#g-option-context-set-description" title="g_option_context_set_description ()"><code class="function">g_option_context_set_description()</code></a>).
616
- </p>
617
- <p>
618
- If you are using <code class="function">gettext()</code>, you only need to set the translation
619
- domain, see <a class="link" href="glib-Commandline-option-parser.html#g-option-context-set-translation-domain" title="g_option_context_set_translation_domain ()"><code class="function">g_option_context_set_translation_domain()</code></a>.
620
- </p>
621
- <div class="variablelist"><table border="0">
622
- <col align="left" valign="top">
623
- <tbody>
624
- <tr>
625
- <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
626
- <td>a <a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a>
627
- </td>
628
- </tr>
629
- <tr>
630
- <td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
631
- <td>the <a class="link" href="glib-Commandline-option-parser.html#GTranslateFunc" title="GTranslateFunc ()"><span class="type">GTranslateFunc</span></a>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
632
- </td>
633
- </tr>
634
- <tr>
635
- <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
636
- <td>user data to pass to <em class="parameter"><code>func</code></em>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
637
- </td>
638
- </tr>
639
- <tr>
640
- <td><p><span class="term"><em class="parameter"><code>destroy_notify</code></em> :</span></p></td>
641
- <td>a function which gets called to free <em class="parameter"><code>data</code></em>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
642
- </td>
643
- </tr>
644
- </tbody>
645
- </table></div>
646
- <p class="since">Since 2.12</p>
647
- </div>
648
- <hr>
649
- <div class="refsect2">
650
- <a name="g-option-context-set-translation-domain"></a><h3>g_option_context_set_translation_domain ()</h3>
651
- <pre class="programlisting"><span class="returnvalue">void</span> g_option_context_set_translation_domain
652
- (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>,
653
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *domain</code></em>);</pre>
654
- <p>
655
- A convenience function to use <code class="function">gettext()</code> for translating
656
- user-visible strings.
657
- </p>
658
- <div class="variablelist"><table border="0">
659
- <col align="left" valign="top">
660
- <tbody>
661
- <tr>
662
- <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
663
- <td>a <a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a>
664
- </td>
665
- </tr>
666
- <tr>
667
- <td><p><span class="term"><em class="parameter"><code>domain</code></em> :</span></p></td>
668
- <td>the domain to use
669
- </td>
670
- </tr>
671
- </tbody>
672
- </table></div>
673
- <p class="since">Since 2.12</p>
674
- </div>
675
- <hr>
676
- <div class="refsect2">
677
- <a name="g-option-context-free"></a><h3>g_option_context_free ()</h3>
678
- <pre class="programlisting"><span class="returnvalue">void</span> g_option_context_free (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>);</pre>
679
- <p>
680
- Frees context and all the groups which have been
681
- added to it.
682
- </p>
683
- <p>
684
- Please note that parsed arguments need to be freed separately (see
685
- <a class="link" href="glib-Commandline-option-parser.html#GOptionEntry" title="GOptionEntry"><span class="type">GOptionEntry</span></a>).
686
- </p>
687
- <div class="variablelist"><table border="0">
688
- <col align="left" valign="top">
689
- <tbody><tr>
690
- <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
691
- <td>a <a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a>
692
- </td>
693
- </tr></tbody>
694
- </table></div>
695
- <p class="since">Since 2.6</p>
696
- </div>
697
- <hr>
698
- <div class="refsect2">
699
- <a name="g-option-context-parse"></a><h3>g_option_context_parse ()</h3>
700
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_option_context_parse (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>,
701
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> *argc</code></em>,
702
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> ***argv</code></em>,
703
- <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>
704
- <p>
705
- Parses the command line arguments, recognizing options
706
- which have been added to <em class="parameter"><code>context</code></em>. A side-effect of
707
- calling this function is that <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-set-prgname" title="g_set_prgname ()"><code class="function">g_set_prgname()</code></a> will be
708
- called.
709
- </p>
710
- <p>
711
- If the parsing is successful, any parsed arguments are
712
- removed from the array and <em class="parameter"><code>argc</code></em> and <em class="parameter"><code>argv</code></em> are updated
713
- accordingly. A '--' option is stripped from <em class="parameter"><code>argv</code></em>
714
- unless there are unparsed options before and after it,
715
- or some of the options after it start with '-'. In case
716
- of an error, <em class="parameter"><code>argc</code></em> and <em class="parameter"><code>argv</code></em> are left unmodified.
717
- </p>
718
- <p>
719
- If automatic <code class="option">--help</code> support is enabled
720
- (see <a class="link" href="glib-Commandline-option-parser.html#g-option-context-set-help-enabled" title="g_option_context_set_help_enabled ()"><code class="function">g_option_context_set_help_enabled()</code></a>), and the
721
- <em class="parameter"><code>argv</code></em> array contains one of the recognized help options,
722
- this function will produce help output to stdout and
723
- call <code class="literal">exit (0)</code>.
724
- </p>
725
- <p>
726
- Note that function depends on the
727
- <a class="link" href="glib-running.html#setlocale" title="Locale">current locale</a> for
728
- automatic character set conversion of string and filename
729
- arguments.
730
- </p>
731
- <div class="variablelist"><table border="0">
732
- <col align="left" valign="top">
733
- <tbody>
734
- <tr>
735
- <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
736
- <td>a <a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a>
737
- </td>
738
- </tr>
739
- <tr>
740
- <td><p><span class="term"><em class="parameter"><code>argc</code></em> :</span></p></td>
741
- <td>a pointer to the number of command line arguments
742
- </td>
743
- </tr>
744
- <tr>
745
- <td><p><span class="term"><em class="parameter"><code>argv</code></em> :</span></p></td>
746
- <td>a pointer to the array of command line arguments
747
- </td>
748
- </tr>
749
- <tr>
750
- <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
751
- <td>a return location for errors
752
- </td>
753
- </tr>
754
- <tr>
755
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
756
- <td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the parsing was successful,
757
- <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> if an error occurred
758
-
759
- </td>
760
- </tr>
761
- </tbody>
762
- </table></div>
763
- <p class="since">Since 2.6</p>
764
- </div>
765
- <hr>
766
- <div class="refsect2">
767
- <a name="g-option-context-set-help-enabled"></a><h3>g_option_context_set_help_enabled ()</h3>
768
- <pre class="programlisting"><span class="returnvalue">void</span> g_option_context_set_help_enabled (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>,
769
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> help_enabled</code></em>);</pre>
770
- <p>
771
- Enables or disables automatic generation of <code class="option">--help</code>
772
- output. By default, <a class="link" href="glib-Commandline-option-parser.html#g-option-context-parse" title="g_option_context_parse ()"><code class="function">g_option_context_parse()</code></a> recognizes
773
- <code class="option">--help</code>, <code class="option">-h</code>,
774
- <code class="option">-?</code>, <code class="option">--help-all</code>
775
- and <code class="option">--help-</code><em class="replaceable"><code>groupname</code></em> and creates
776
- suitable output to stdout.
777
- </p>
778
- <div class="variablelist"><table border="0">
779
- <col align="left" valign="top">
780
- <tbody>
781
- <tr>
782
- <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
783
- <td>a <a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a>
784
- </td>
785
- </tr>
786
- <tr>
787
- <td><p><span class="term"><em class="parameter"><code>help_enabled</code></em> :</span></p></td>
788
- <td>
789
- <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> to enable <code class="option">--help</code>, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> to disable it
790
- </td>
791
- </tr>
792
- </tbody>
793
- </table></div>
794
- <p class="since">Since 2.6</p>
795
- </div>
796
- <hr>
797
- <div class="refsect2">
798
- <a name="g-option-context-get-help-enabled"></a><h3>g_option_context_get_help_enabled ()</h3>
799
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_option_context_get_help_enabled (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>);</pre>
800
- <p>
801
- Returns whether automatic <code class="option">--help</code> generation
802
- is turned on for <em class="parameter"><code>context</code></em>. See <a class="link" href="glib-Commandline-option-parser.html#g-option-context-set-help-enabled" title="g_option_context_set_help_enabled ()"><code class="function">g_option_context_set_help_enabled()</code></a>.
803
- </p>
804
- <div class="variablelist"><table border="0">
805
- <col align="left" valign="top">
806
- <tbody>
807
- <tr>
808
- <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
809
- <td>a <a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a>
810
- </td>
811
- </tr>
812
- <tr>
813
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
814
- <td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if automatic help generation is turned on.
815
-
816
- </td>
817
- </tr>
818
- </tbody>
819
- </table></div>
820
- <p class="since">Since 2.6</p>
821
- </div>
822
- <hr>
823
- <div class="refsect2">
824
- <a name="g-option-context-set-ignore-unknown-options"></a><h3>g_option_context_set_ignore_unknown_options ()</h3>
825
- <pre class="programlisting"><span class="returnvalue">void</span> g_option_context_set_ignore_unknown_options
826
- (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>,
827
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> ignore_unknown</code></em>);</pre>
828
- <p>
829
- Sets whether to ignore unknown options or not. If an argument is
830
- ignored, it is left in the <em class="parameter"><code>argv</code></em> array after parsing. By default,
831
- <a class="link" href="glib-Commandline-option-parser.html#g-option-context-parse" title="g_option_context_parse ()"><code class="function">g_option_context_parse()</code></a> treats unknown options as error.
832
- </p>
833
- <p>
834
- This setting does not affect non-option arguments (i.e. arguments
835
- which don't start with a dash). But note that GOption cannot reliably
836
- determine whether a non-option belongs to a preceding unknown option.
837
- </p>
838
- <div class="variablelist"><table border="0">
839
- <col align="left" valign="top">
840
- <tbody>
841
- <tr>
842
- <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
843
- <td>a <a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a>
844
- </td>
845
- </tr>
846
- <tr>
847
- <td><p><span class="term"><em class="parameter"><code>ignore_unknown</code></em> :</span></p></td>
848
- <td>
849
- <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> to ignore unknown options, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> to produce
850
- an error when unknown options are met
851
- </td>
852
- </tr>
853
- </tbody>
854
- </table></div>
855
- <p class="since">Since 2.6</p>
856
- </div>
857
- <hr>
858
- <div class="refsect2">
859
- <a name="g-option-context-get-ignore-unknown-options"></a><h3>g_option_context_get_ignore_unknown_options ()</h3>
860
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_option_context_get_ignore_unknown_options
861
- (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>);</pre>
862
- <p>
863
- Returns whether unknown options are ignored or not. See
864
- <a class="link" href="glib-Commandline-option-parser.html#g-option-context-set-ignore-unknown-options" title="g_option_context_set_ignore_unknown_options ()"><code class="function">g_option_context_set_ignore_unknown_options()</code></a>.
865
- </p>
866
- <div class="variablelist"><table border="0">
867
- <col align="left" valign="top">
868
- <tbody>
869
- <tr>
870
- <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
871
- <td>a <a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a>
872
- </td>
873
- </tr>
874
- <tr>
875
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
876
- <td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if unknown options are ignored.
877
-
878
- </td>
879
- </tr>
880
- </tbody>
881
- </table></div>
882
- <p class="since">Since 2.6</p>
883
- </div>
884
- <hr>
885
- <div class="refsect2">
886
- <a name="g-option-context-get-help"></a><h3>g_option_context_get_help ()</h3>
887
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_option_context_get_help (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>,
888
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> main_help</code></em>,
889
- <em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a> *group</code></em>);</pre>
890
- <p>
891
- Returns a formatted, translated help text for the given context.
892
- To obtain the text produced by <code class="option">--help</code>, call
893
- <code class="literal">g_option_context_get_help (context, TRUE, NULL)</code>.
894
- To obtain the text produced by <code class="option">--help-all</code>, call
895
- <code class="literal">g_option_context_get_help (context, FALSE, NULL)</code>.
896
- To obtain the help text for an option group, call
897
- <code class="literal">g_option_context_get_help (context, FALSE, group)</code>.
898
- </p>
899
- <div class="variablelist"><table border="0">
900
- <col align="left" valign="top">
901
- <tbody>
902
- <tr>
903
- <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
904
- <td>a <a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a>
905
- </td>
906
- </tr>
907
- <tr>
908
- <td><p><span class="term"><em class="parameter"><code>main_help</code></em> :</span></p></td>
909
- <td>if <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>, only include the main group
910
- </td>
911
- </tr>
912
- <tr>
913
- <td><p><span class="term"><em class="parameter"><code>group</code></em> :</span></p></td>
914
- <td>the <a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a> to create help for, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
915
- </td>
916
- </tr>
917
- <tr>
918
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
919
- <td> A newly allocated string containing the help text
920
-
921
- </td>
922
- </tr>
923
- </tbody>
924
- </table></div>
925
- <p class="since">Since 2.14</p>
926
- </div>
927
- <hr>
928
- <div class="refsect2">
929
- <a name="GOptionArg"></a><h3>enum GOptionArg</h3>
930
- <pre class="programlisting">typedef enum
931
- {
932
- G_OPTION_ARG_NONE,
933
- G_OPTION_ARG_STRING,
934
- G_OPTION_ARG_INT,
935
- G_OPTION_ARG_CALLBACK,
936
- G_OPTION_ARG_FILENAME,
937
- G_OPTION_ARG_STRING_ARRAY,
938
- G_OPTION_ARG_FILENAME_ARRAY,
939
- G_OPTION_ARG_DOUBLE,
940
- G_OPTION_ARG_INT64
941
- } GOptionArg;
942
- </pre>
943
- <p>
944
- The <a class="link" href="glib-Commandline-option-parser.html#GOptionArg" title="enum GOptionArg"><span class="type">GOptionArg</span></a> enum values determine which type of extra argument the
945
- options expect to find. If an option expects an extra argument, it
946
- can be specified in several ways; with a short option:
947
- <code class="option">-x arg</code>, with a long option: <code class="option">--name arg</code>
948
- or combined in a single argument: <code class="option">--name=arg</code>.
949
- </p>
950
- <div class="variablelist"><table border="0">
951
- <col align="left" valign="top">
952
- <tbody>
953
- <tr>
954
- <td><p><a name="G-OPTION-ARG-NONE:CAPS"></a><span class="term"><code class="literal">G_OPTION_ARG_NONE</code></span></p></td>
955
- <td>No extra argument. This is useful for simple flags.
956
- </td>
957
- </tr>
958
- <tr>
959
- <td><p><a name="G-OPTION-ARG-STRING:CAPS"></a><span class="term"><code class="literal">G_OPTION_ARG_STRING</code></span></p></td>
960
- <td>The option takes a string argument.
961
- </td>
962
- </tr>
963
- <tr>
964
- <td><p><a name="G-OPTION-ARG-INT:CAPS"></a><span class="term"><code class="literal">G_OPTION_ARG_INT</code></span></p></td>
965
- <td>The option takes an integer argument.
966
- </td>
967
- </tr>
968
- <tr>
969
- <td><p><a name="G-OPTION-ARG-CALLBACK:CAPS"></a><span class="term"><code class="literal">G_OPTION_ARG_CALLBACK</code></span></p></td>
970
- <td>The option provides a callback to parse the
971
- extra argument.
972
- </td>
973
- </tr>
974
- <tr>
975
- <td><p><a name="G-OPTION-ARG-FILENAME:CAPS"></a><span class="term"><code class="literal">G_OPTION_ARG_FILENAME</code></span></p></td>
976
- <td>The option takes a filename as argument.
977
- </td>
978
- </tr>
979
- <tr>
980
- <td><p><a name="G-OPTION-ARG-STRING-ARRAY:CAPS"></a><span class="term"><code class="literal">G_OPTION_ARG_STRING_ARRAY</code></span></p></td>
981
- <td>The option takes a string argument, multiple
982
- uses of the option are collected into an array of strings.
983
- </td>
984
- </tr>
985
- <tr>
986
- <td><p><a name="G-OPTION-ARG-FILENAME-ARRAY:CAPS"></a><span class="term"><code class="literal">G_OPTION_ARG_FILENAME_ARRAY</code></span></p></td>
987
- <td>The option takes a filename as argument,
988
- multiple uses of the option are collected into an array of strings.
989
- </td>
990
- </tr>
991
- <tr>
992
- <td><p><a name="G-OPTION-ARG-DOUBLE:CAPS"></a><span class="term"><code class="literal">G_OPTION_ARG_DOUBLE</code></span></p></td>
993
- <td>The option takes a double argument. The argument
994
- can be formatted either for the user's locale or for the "C" locale. Since 2.12
995
- </td>
996
- </tr>
997
- <tr>
998
- <td><p><a name="G-OPTION-ARG-INT64:CAPS"></a><span class="term"><code class="literal">G_OPTION_ARG_INT64</code></span></p></td>
999
- <td>The option takes a 64-bit integer. Like <a class="link" href="glib-Commandline-option-parser.html#G-OPTION-ARG-INT:CAPS"><code class="literal">G_OPTION_ARG_INT</code></a>
1000
- but for larger numbers. The number can be in decimal base, or in hexadecimal
1001
- (when prefixed with <code class="literal">0x</code>, for example, <code class="literal">0xffffffff</code>).
1002
- Since 2.12
1003
- </td>
1004
- </tr>
1005
- </tbody>
1006
- </table></div>
1007
- </div>
1008
- <hr>
1009
- <div class="refsect2">
1010
- <a name="GOptionFlags"></a><h3>enum GOptionFlags</h3>
1011
- <pre class="programlisting">typedef enum
1012
- {
1013
- G_OPTION_FLAG_HIDDEN = 1 &lt;&lt; 0,
1014
- G_OPTION_FLAG_IN_MAIN = 1 &lt;&lt; 1,
1015
- G_OPTION_FLAG_REVERSE = 1 &lt;&lt; 2,
1016
- G_OPTION_FLAG_NO_ARG = 1 &lt;&lt; 3,
1017
- G_OPTION_FLAG_FILENAME = 1 &lt;&lt; 4,
1018
- G_OPTION_FLAG_OPTIONAL_ARG = 1 &lt;&lt; 5,
1019
- G_OPTION_FLAG_NOALIAS = 1 &lt;&lt; 6
1020
- } GOptionFlags;
1021
- </pre>
1022
- <p>
1023
- Flags which modify individual options.
1024
- </p>
1025
- <div class="variablelist"><table border="0">
1026
- <col align="left" valign="top">
1027
- <tbody>
1028
- <tr>
1029
- <td><p><a name="G-OPTION-FLAG-HIDDEN:CAPS"></a><span class="term"><code class="literal">G_OPTION_FLAG_HIDDEN</code></span></p></td>
1030
- <td>The option doesn't appear in <code class="option">--help</code>
1031
- output.
1032
- </td>
1033
- </tr>
1034
- <tr>
1035
- <td><p><a name="G-OPTION-FLAG-IN-MAIN:CAPS"></a><span class="term"><code class="literal">G_OPTION_FLAG_IN_MAIN</code></span></p></td>
1036
- <td>The option appears in the main section of the
1037
- <code class="option">--help</code> output, even if it is defined in a group.
1038
- </td>
1039
- </tr>
1040
- <tr>
1041
- <td><p><a name="G-OPTION-FLAG-REVERSE:CAPS"></a><span class="term"><code class="literal">G_OPTION_FLAG_REVERSE</code></span></p></td>
1042
- <td>For options of the <a class="link" href="glib-Commandline-option-parser.html#G-OPTION-ARG-NONE:CAPS"><code class="literal">G_OPTION_ARG_NONE</code></a> kind, this flag
1043
- indicates that the sense of the option is reversed.
1044
- </td>
1045
- </tr>
1046
- <tr>
1047
- <td><p><a name="G-OPTION-FLAG-NO-ARG:CAPS"></a><span class="term"><code class="literal">G_OPTION_FLAG_NO_ARG</code></span></p></td>
1048
- <td>For options of the <a class="link" href="glib-Commandline-option-parser.html#G-OPTION-ARG-CALLBACK:CAPS"><code class="literal">G_OPTION_ARG_CALLBACK</code></a> kind,
1049
- this flag indicates that the callback does not take any argument
1050
- (like a <a class="link" href="glib-Commandline-option-parser.html#G-OPTION-ARG-NONE:CAPS"><code class="literal">G_OPTION_ARG_NONE</code></a> option). Since 2.8
1051
- </td>
1052
- </tr>
1053
- <tr>
1054
- <td><p><a name="G-OPTION-FLAG-FILENAME:CAPS"></a><span class="term"><code class="literal">G_OPTION_FLAG_FILENAME</code></span></p></td>
1055
- <td>For options of the <a class="link" href="glib-Commandline-option-parser.html#G-OPTION-ARG-CALLBACK:CAPS"><code class="literal">G_OPTION_ARG_CALLBACK</code></a>
1056
- kind, this flag indicates that the argument should be passed to the
1057
- callback in the GLib filename encoding rather than UTF-8. Since 2.8
1058
- </td>
1059
- </tr>
1060
- <tr>
1061
- <td><p><a name="G-OPTION-FLAG-OPTIONAL-ARG:CAPS"></a><span class="term"><code class="literal">G_OPTION_FLAG_OPTIONAL_ARG</code></span></p></td>
1062
- <td>For options of the <a class="link" href="glib-Commandline-option-parser.html#G-OPTION-ARG-CALLBACK:CAPS"><code class="literal">G_OPTION_ARG_CALLBACK</code></a>
1063
- kind, this flag indicates that the argument supply is optional. If no argument
1064
- is given then data of <a class="link" href="glib-Commandline-option-parser.html#GOptionParseFunc" title="GOptionParseFunc ()"><code class="literal">GOptionParseFunc</code></a> will be set to NULL. Since 2.8
1065
- </td>
1066
- </tr>
1067
- <tr>
1068
- <td><p><a name="G-OPTION-FLAG-NOALIAS:CAPS"></a><span class="term"><code class="literal">G_OPTION_FLAG_NOALIAS</code></span></p></td>
1069
- <td>This flag turns off the automatic conflict resolution
1070
- which prefixes long option names with <code class="literal">groupname-</code> if
1071
- there is a conflict. This option should only be used in situations where
1072
- aliasing is necessary to model some legacy commandline interface. It is
1073
- not safe to use this option, unless all option groups are under your
1074
- direct control. Since 2.8.
1075
- </td>
1076
- </tr>
1077
- </tbody>
1078
- </table></div>
1079
- </div>
1080
- <hr>
1081
- <div class="refsect2">
1082
- <a name="G-OPTION-REMAINING:CAPS"></a><h3>G_OPTION_REMAINING</h3>
1083
- <pre class="programlisting">#define G_OPTION_REMAINING ""
1084
- </pre>
1085
- <p>
1086
- If a long option in the main group has this name, it is not treated as a
1087
- regular option. Instead it collects all non-option arguments which would
1088
- otherwise be left in <code class="literal">argv</code>. The option must be of type
1089
- <a class="link" href="glib-Commandline-option-parser.html#G-OPTION-ARG-CALLBACK:CAPS"><code class="literal">G_OPTION_ARG_CALLBACK</code></a>, <a class="link" href="glib-Commandline-option-parser.html#G-OPTION-ARG-STRING-ARRAY:CAPS"><code class="literal">G_OPTION_ARG_STRING_ARRAY</code></a>
1090
- or <a class="link" href="glib-Commandline-option-parser.html#G-OPTION-ARG-FILENAME-ARRAY:CAPS"><code class="literal">G_OPTION_ARG_FILENAME_ARRAY</code></a>.
1091
- </p>
1092
- <p>
1093
- Using <a class="link" href="glib-Commandline-option-parser.html#G-OPTION-REMAINING:CAPS" title="G_OPTION_REMAINING"><span class="type">G_OPTION_REMAINING</span></a> instead of simply scanning <code class="literal">argv</code>
1094
- for leftover arguments has the advantage that GOption takes care of
1095
- necessary encoding conversions for strings or filenames.
1096
- </p>
1097
- <p class="since">Since 2.6</p>
1098
- </div>
1099
- <hr>
1100
- <div class="refsect2">
1101
- <a name="GOptionEntry"></a><h3>GOptionEntry</h3>
1102
- <pre class="programlisting">typedef struct {
1103
- const gchar *long_name;
1104
- gchar short_name;
1105
- gint flags;
1106
-
1107
- GOptionArg arg;
1108
- gpointer arg_data;
1109
-
1110
- const gchar *description;
1111
- const gchar *arg_description;
1112
- } GOptionEntry;
1113
- </pre>
1114
- <p>
1115
- A <span class="structname">GOptionEntry</span> defines a single option.
1116
- To have an effect, they must be added to a <a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a> with
1117
- <a class="link" href="glib-Commandline-option-parser.html#g-option-context-add-main-entries" title="g_option_context_add_main_entries ()"><code class="function">g_option_context_add_main_entries()</code></a> or <a class="link" href="glib-Commandline-option-parser.html#g-option-group-add-entries" title="g_option_group_add_entries ()"><code class="function">g_option_group_add_entries()</code></a>.
1118
- </p>
1119
- <div class="variablelist"><table border="0">
1120
- <col align="left" valign="top">
1121
- <tbody>
1122
- <tr>
1123
- <td><p><span class="term">const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GOptionEntry.long-name"></a>long_name</code></em>;</span></p></td>
1124
- <td>The long name of an option can be used to specify it
1125
- in a commandline as --<em class="replaceable"><code>long_name</code></em>. Every
1126
- option must have a long name. To resolve conflicts if multiple
1127
- option groups contain the same long name, it is also possible to
1128
- specify the option as
1129
- --<em class="replaceable"><code>groupname</code></em>-<em class="replaceable"><code>long_name</code></em>.
1130
- </td>
1131
- </tr>
1132
- <tr>
1133
- <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="GOptionEntry.short-name"></a>short_name</code></em>;</span></p></td>
1134
- <td>If an option has a short name, it can be specified
1135
- -<em class="replaceable"><code>short_name</code></em> in a commandline. <em class="parameter"><code>short_name</code></em> must be
1136
- a printable ASCII character different from '-', or zero if the option has no
1137
- short name.
1138
- </td>
1139
- </tr>
1140
- <tr>
1141
- <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="GOptionEntry.flags"></a>flags</code></em>;</span></p></td>
1142
- <td>Flags from <a class="link" href="glib-Commandline-option-parser.html#GOptionFlags" title="enum GOptionFlags"><span class="type">GOptionFlags</span></a>.
1143
- </td>
1144
- </tr>
1145
- <tr>
1146
- <td><p><span class="term"><a class="link" href="glib-Commandline-option-parser.html#GOptionArg" title="enum GOptionArg"><span class="type">GOptionArg</span></a> <em class="structfield"><code><a name="GOptionEntry.arg"></a>arg</code></em>;</span></p></td>
1147
- <td>The type of the option, as a <a class="link" href="glib-Commandline-option-parser.html#GOptionArg" title="enum GOptionArg"><span class="type">GOptionArg</span></a>.
1148
- </td>
1149
- </tr>
1150
- <tr>
1151
- <td><p><span class="term"><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> <em class="structfield"><code><a name="GOptionEntry.arg-data"></a>arg_data</code></em>;</span></p></td>
1152
- <td>If the <em class="parameter"><code>arg</code></em> type is <a class="link" href="glib-Commandline-option-parser.html#G-OPTION-ARG-CALLBACK:CAPS"><code class="literal">G_OPTION_ARG_CALLBACK</code></a>, then <em class="parameter"><code>arg_data</code></em> must
1153
- point to a <a class="link" href="glib-Commandline-option-parser.html#GOptionArgFunc" title="GOptionArgFunc ()"><span class="type">GOptionArgFunc</span></a> callback function, which will be called to handle
1154
- the extra argument. Otherwise, <em class="parameter"><code>arg_data</code></em> is a pointer to a location to store
1155
- the value, the required type of the location depends on the <em class="parameter"><code>arg</code></em> type:
1156
- <div class="variablelist"><table border="0">
1157
- <col align="left" valign="top">
1158
- <tbody>
1159
- <tr>
1160
- <td><p><span class="term"><a class="link" href="glib-Commandline-option-parser.html#G-OPTION-ARG-NONE:CAPS"><code class="literal">G_OPTION_ARG_NONE</code></a></span></p></td>
1161
- <td><p><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><code class="literal">gboolean</code></a></p></td>
1162
- </tr>
1163
- <tr>
1164
- <td><p><span class="term"><a class="link" href="glib-Commandline-option-parser.html#G-OPTION-ARG-STRING:CAPS"><code class="literal">G_OPTION_ARG_STRING</code></a></span></p></td>
1165
- <td><p><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><code class="literal">gchar</code></a>*</p></td>
1166
- </tr>
1167
- <tr>
1168
- <td><p><span class="term"><a class="link" href="glib-Commandline-option-parser.html#G-OPTION-ARG-INT:CAPS"><code class="literal">G_OPTION_ARG_INT</code></a></span></p></td>
1169
- <td><p><a class="link" href="glib-Basic-Types.html#gint" title="gint"><code class="literal">gint</code></a></p></td>
1170
- </tr>
1171
- <tr>
1172
- <td><p><span class="term"><a class="link" href="glib-Commandline-option-parser.html#G-OPTION-ARG-FILENAME:CAPS"><code class="literal">G_OPTION_ARG_FILENAME</code></a></span></p></td>
1173
- <td><p><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><code class="literal">gchar</code></a>*</p></td>
1174
- </tr>
1175
- <tr>
1176
- <td><p><span class="term"><a class="link" href="glib-Commandline-option-parser.html#G-OPTION-ARG-STRING-ARRAY:CAPS"><code class="literal">G_OPTION_ARG_STRING_ARRAY</code></a></span></p></td>
1177
- <td><p><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><code class="literal">gchar</code></a>**</p></td>
1178
- </tr>
1179
- <tr>
1180
- <td><p><span class="term"><a class="link" href="glib-Commandline-option-parser.html#G-OPTION-ARG-FILENAME-ARRAY:CAPS"><code class="literal">G_OPTION_ARG_FILENAME_ARRAY</code></a></span></p></td>
1181
- <td><p><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><code class="literal">gchar</code></a>**</p></td>
1182
- </tr>
1183
- <tr>
1184
- <td><p><span class="term"><a class="link" href="glib-Commandline-option-parser.html#G-OPTION-ARG-DOUBLE:CAPS"><code class="literal">G_OPTION_ARG_DOUBLE</code></a></span></p></td>
1185
- <td><p><a class="link" href="glib-Basic-Types.html#gdouble" title="gdouble"><code class="literal">gdouble</code></a></p></td>
1186
- </tr>
1187
- </tbody>
1188
- </table></div>
1189
- If <em class="parameter"><code>arg</code></em> type is <a class="link" href="glib-Commandline-option-parser.html#G-OPTION-ARG-STRING:CAPS"><code class="literal">G_OPTION_ARG_STRING</code></a> or <a class="link" href="glib-Commandline-option-parser.html#G-OPTION-ARG-FILENAME:CAPS"><code class="literal">G_OPTION_ARG_FILENAME</code></a> the location
1190
- will contain a newly allocated string if the option was given. That string
1191
- needs to be freed by the callee using <a class="link" href="glib-Memory-Allocation.html#g-free" title="g_free ()"><code class="function">g_free()</code></a>. Likewise if <em class="parameter"><code>arg</code></em> type is
1192
- <a class="link" href="glib-Commandline-option-parser.html#G-OPTION-ARG-STRING-ARRAY:CAPS"><code class="literal">G_OPTION_ARG_STRING_ARRAY</code></a> or <a class="link" href="glib-Commandline-option-parser.html#G-OPTION-ARG-FILENAME-ARRAY:CAPS"><code class="literal">G_OPTION_ARG_FILENAME_ARRAY</code></a>, the data should
1193
- be freed using <a class="link" href="glib-String-Utility-Functions.html#g-strfreev" title="g_strfreev ()"><code class="function">g_strfreev()</code></a>.
1194
- </td>
1195
- </tr>
1196
- <tr>
1197
- <td><p><span class="term">const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GOptionEntry.description"></a>description</code></em>;</span></p></td>
1198
- <td>the description for the option in <code class="option">--help</code>
1199
- output. The <em class="parameter"><code>description</code></em> is translated using the <em class="parameter"><code>translate_func</code></em> of the
1200
- group, see <a class="link" href="glib-Commandline-option-parser.html#g-option-group-set-translation-domain" title="g_option_group_set_translation_domain ()"><code class="function">g_option_group_set_translation_domain()</code></a>.
1201
- </td>
1202
- </tr>
1203
- <tr>
1204
- <td><p><span class="term">const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GOptionEntry.arg-description"></a>arg_description</code></em>;</span></p></td>
1205
- <td>The placeholder to use for the extra argument parsed
1206
- by the option in <code class="option">--help</code>
1207
- output. The <em class="parameter"><code>arg_description</code></em> is translated using the <em class="parameter"><code>translate_func</code></em> of the
1208
- group, see <a class="link" href="glib-Commandline-option-parser.html#g-option-group-set-translation-domain" title="g_option_group_set_translation_domain ()"><code class="function">g_option_group_set_translation_domain()</code></a>.
1209
- </td>
1210
- </tr>
1211
- </tbody>
1212
- </table></div>
1213
- </div>
1214
- <hr>
1215
- <div class="refsect2">
1216
- <a name="g-option-context-add-main-entries"></a><h3>g_option_context_add_main_entries ()</h3>
1217
- <pre class="programlisting"><span class="returnvalue">void</span> g_option_context_add_main_entries (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>,
1218
- <em class="parameter"><code>const <a class="link" href="glib-Commandline-option-parser.html#GOptionEntry" title="GOptionEntry"><span class="type">GOptionEntry</span></a> *entries</code></em>,
1219
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *translation_domain</code></em>);</pre>
1220
- <p>
1221
- A convenience function which creates a main group if it doesn't
1222
- exist, adds the <em class="parameter"><code>entries</code></em> to it and sets the translation domain.
1223
- </p>
1224
- <div class="variablelist"><table border="0">
1225
- <col align="left" valign="top">
1226
- <tbody>
1227
- <tr>
1228
- <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
1229
- <td>a <a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a>
1230
- </td>
1231
- </tr>
1232
- <tr>
1233
- <td><p><span class="term"><em class="parameter"><code>entries</code></em> :</span></p></td>
1234
- <td>a <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated array of <a class="link" href="glib-Commandline-option-parser.html#GOptionEntry" title="GOptionEntry"><span class="type">GOptionEntry</span></a>s
1235
- </td>
1236
- </tr>
1237
- <tr>
1238
- <td><p><span class="term"><em class="parameter"><code>translation_domain</code></em> :</span></p></td>
1239
- <td>a translation domain to use for translating
1240
- the <code class="option">--help</code> output for the options in <em class="parameter"><code>entries</code></em>
1241
- with <code class="function">gettext()</code>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
1242
- </td>
1243
- </tr>
1244
- </tbody>
1245
- </table></div>
1246
- <p class="since">Since 2.6</p>
1247
- </div>
1248
- <hr>
1249
- <div class="refsect2">
1250
- <a name="GOptionGroup"></a><h3>GOptionGroup</h3>
1251
- <pre class="programlisting">typedef struct _GOptionGroup GOptionGroup;</pre>
1252
- <p>
1253
- A <span class="structname">GOptionGroup</span> struct defines the options in a single
1254
- group. The struct has only private fields and should not be directly accessed.
1255
- </p>
1256
- <p>
1257
- All options in a group share the same translation function. Libraries which
1258
- need to parse commandline options are expected to provide a function for
1259
- getting a <span class="structname">GOptionGroup</span> holding their options, which
1260
- the application can then add to its <a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a>.
1261
- </p>
1262
- </div>
1263
- <hr>
1264
- <div class="refsect2">
1265
- <a name="g-option-context-add-group"></a><h3>g_option_context_add_group ()</h3>
1266
- <pre class="programlisting"><span class="returnvalue">void</span> g_option_context_add_group (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>,
1267
- <em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a> *group</code></em>);</pre>
1268
- <p>
1269
- Adds a <a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a> to the <em class="parameter"><code>context</code></em>, so that parsing with <em class="parameter"><code>context</code></em>
1270
- will recognize the options in the group. Note that the group will
1271
- be freed together with the context when <a class="link" href="glib-Commandline-option-parser.html#g-option-context-free" title="g_option_context_free ()"><code class="function">g_option_context_free()</code></a> is
1272
- called, so you must not free the group yourself after adding it
1273
- to a context.
1274
- </p>
1275
- <div class="variablelist"><table border="0">
1276
- <col align="left" valign="top">
1277
- <tbody>
1278
- <tr>
1279
- <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
1280
- <td>a <a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a>
1281
- </td>
1282
- </tr>
1283
- <tr>
1284
- <td><p><span class="term"><em class="parameter"><code>group</code></em> :</span></p></td>
1285
- <td>the group to add
1286
- </td>
1287
- </tr>
1288
- </tbody>
1289
- </table></div>
1290
- <p class="since">Since 2.6</p>
1291
- </div>
1292
- <hr>
1293
- <div class="refsect2">
1294
- <a name="g-option-context-set-main-group"></a><h3>g_option_context_set_main_group ()</h3>
1295
- <pre class="programlisting"><span class="returnvalue">void</span> g_option_context_set_main_group (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>,
1296
- <em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a> *group</code></em>);</pre>
1297
- <p>
1298
- Sets a <a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a> as main group of the <em class="parameter"><code>context</code></em>.
1299
- This has the same effect as calling <a class="link" href="glib-Commandline-option-parser.html#g-option-context-add-group" title="g_option_context_add_group ()"><code class="function">g_option_context_add_group()</code></a>,
1300
- the only difference is that the options in the main group are
1301
- treated differently when generating <code class="option">--help</code> output.
1302
- </p>
1303
- <div class="variablelist"><table border="0">
1304
- <col align="left" valign="top">
1305
- <tbody>
1306
- <tr>
1307
- <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
1308
- <td>a <a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a>
1309
- </td>
1310
- </tr>
1311
- <tr>
1312
- <td><p><span class="term"><em class="parameter"><code>group</code></em> :</span></p></td>
1313
- <td>the group to set as main group
1314
- </td>
1315
- </tr>
1316
- </tbody>
1317
- </table></div>
1318
- <p class="since">Since 2.6</p>
1319
- </div>
1320
- <hr>
1321
- <div class="refsect2">
1322
- <a name="g-option-context-get-main-group"></a><h3>g_option_context_get_main_group ()</h3>
1323
- <pre class="programlisting"><a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="returnvalue">GOptionGroup</span></a> * g_option_context_get_main_group (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>);</pre>
1324
- <p>
1325
- Returns a pointer to the main group of <em class="parameter"><code>context</code></em>.
1326
- </p>
1327
- <div class="variablelist"><table border="0">
1328
- <col align="left" valign="top">
1329
- <tbody>
1330
- <tr>
1331
- <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
1332
- <td>a <a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a>
1333
- </td>
1334
- </tr>
1335
- <tr>
1336
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1337
- <td> the main group of <em class="parameter"><code>context</code></em>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if <em class="parameter"><code>context</code></em> doesn't
1338
- have a main group. Note that group belongs to <em class="parameter"><code>context</code></em> and should
1339
- not be modified or freed.
1340
-
1341
- </td>
1342
- </tr>
1343
- </tbody>
1344
- </table></div>
1345
- <p class="since">Since 2.6</p>
1346
- </div>
1347
- <hr>
1348
- <div class="refsect2">
1349
- <a name="g-option-group-new"></a><h3>g_option_group_new ()</h3>
1350
- <pre class="programlisting"><a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="returnvalue">GOptionGroup</span></a> * g_option_group_new (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *name</code></em>,
1351
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *description</code></em>,
1352
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *help_description</code></em>,
1353
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
1354
- <em class="parameter"><code><a class="link" href="glib-Datasets.html#GDestroyNotify" title="GDestroyNotify ()"><span class="type">GDestroyNotify</span></a> destroy</code></em>);</pre>
1355
- <p>
1356
- Creates a new <a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a>.
1357
- </p>
1358
- <div class="variablelist"><table border="0">
1359
- <col align="left" valign="top">
1360
- <tbody>
1361
- <tr>
1362
- <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
1363
- <td>the name for the option group, this is used to provide
1364
- help for the options in this group with <code class="option">--help-</code><em class="parameter"><code>name</code></em>
1365
- </td>
1366
- </tr>
1367
- <tr>
1368
- <td><p><span class="term"><em class="parameter"><code>description</code></em> :</span></p></td>
1369
- <td>a description for this group to be shown in
1370
- <code class="option">--help</code>. This string is translated using the translation
1371
- domain or translation function of the group
1372
- </td>
1373
- </tr>
1374
- <tr>
1375
- <td><p><span class="term"><em class="parameter"><code>help_description</code></em> :</span></p></td>
1376
- <td>a description for the <code class="option">--help-</code><em class="parameter"><code>name</code></em> option.
1377
- This string is translated using the translation domain or translation function
1378
- of the group
1379
- </td>
1380
- </tr>
1381
- <tr>
1382
- <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1383
- <td>user data that will be passed to the pre- and post-parse hooks,
1384
- the error hook and to callbacks of <a class="link" href="glib-Commandline-option-parser.html#G-OPTION-ARG-CALLBACK:CAPS"><code class="literal">G_OPTION_ARG_CALLBACK</code></a> options, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
1385
- </td>
1386
- </tr>
1387
- <tr>
1388
- <td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
1389
- <td>a function that will be called to free <em class="parameter"><code>user_data</code></em>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
1390
- </td>
1391
- </tr>
1392
- <tr>
1393
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1394
- <td> a newly created option group. It should be added
1395
- to a <a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> or freed with <a class="link" href="glib-Commandline-option-parser.html#g-option-group-free" title="g_option_group_free ()"><code class="function">g_option_group_free()</code></a>.
1396
-
1397
- </td>
1398
- </tr>
1399
- </tbody>
1400
- </table></div>
1401
- <p class="since">Since 2.6</p>
1402
- </div>
1403
- <hr>
1404
- <div class="refsect2">
1405
- <a name="g-option-group-free"></a><h3>g_option_group_free ()</h3>
1406
- <pre class="programlisting"><span class="returnvalue">void</span> g_option_group_free (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a> *group</code></em>);</pre>
1407
- <p>
1408
- Frees a <a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a>. Note that you must <span class="emphasis"><em>not</em></span>
1409
- free groups which have been added to a <a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a>.
1410
- </p>
1411
- <div class="variablelist"><table border="0">
1412
- <col align="left" valign="top">
1413
- <tbody><tr>
1414
- <td><p><span class="term"><em class="parameter"><code>group</code></em> :</span></p></td>
1415
- <td>a <a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a>
1416
- </td>
1417
- </tr></tbody>
1418
- </table></div>
1419
- <p class="since">Since 2.6</p>
1420
- </div>
1421
- <hr>
1422
- <div class="refsect2">
1423
- <a name="g-option-group-add-entries"></a><h3>g_option_group_add_entries ()</h3>
1424
- <pre class="programlisting"><span class="returnvalue">void</span> g_option_group_add_entries (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a> *group</code></em>,
1425
- <em class="parameter"><code>const <a class="link" href="glib-Commandline-option-parser.html#GOptionEntry" title="GOptionEntry"><span class="type">GOptionEntry</span></a> *entries</code></em>);</pre>
1426
- <p>
1427
- Adds the options specified in <em class="parameter"><code>entries</code></em> to <em class="parameter"><code>group</code></em>.
1428
- </p>
1429
- <div class="variablelist"><table border="0">
1430
- <col align="left" valign="top">
1431
- <tbody>
1432
- <tr>
1433
- <td><p><span class="term"><em class="parameter"><code>group</code></em> :</span></p></td>
1434
- <td>a <a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a>
1435
- </td>
1436
- </tr>
1437
- <tr>
1438
- <td><p><span class="term"><em class="parameter"><code>entries</code></em> :</span></p></td>
1439
- <td>a <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated array of <a class="link" href="glib-Commandline-option-parser.html#GOptionEntry" title="GOptionEntry"><span class="type">GOptionEntry</span></a>s
1440
- </td>
1441
- </tr>
1442
- </tbody>
1443
- </table></div>
1444
- <p class="since">Since 2.6</p>
1445
- </div>
1446
- <hr>
1447
- <div class="refsect2">
1448
- <a name="GOptionParseFunc"></a><h3>GOptionParseFunc ()</h3>
1449
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> (*GOptionParseFunc) (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>,
1450
- <em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a> *group</code></em>,
1451
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> data</code></em>,
1452
- <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>
1453
- <p>
1454
- The type of function that can be called before and after parsing.
1455
- </p>
1456
- <div class="variablelist"><table border="0">
1457
- <col align="left" valign="top">
1458
- <tbody>
1459
- <tr>
1460
- <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
1461
- <td>The active <a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a>
1462
- </td>
1463
- </tr>
1464
- <tr>
1465
- <td><p><span class="term"><em class="parameter"><code>group</code></em> :</span></p></td>
1466
- <td>The group to which the function belongs
1467
- </td>
1468
- </tr>
1469
- <tr>
1470
- <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
1471
- <td>User data added to the <a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a> containing the option when it
1472
- was created with <a class="link" href="glib-Commandline-option-parser.html#g-option-group-new" title="g_option_group_new ()"><code class="function">g_option_group_new()</code></a>
1473
- </td>
1474
- </tr>
1475
- <tr>
1476
- <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1477
- <td>A return location for error details
1478
- </td>
1479
- </tr>
1480
- <tr>
1481
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1482
- <td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the function completed successfully, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> if an error
1483
- occurred, in which case <em class="parameter"><code>error</code></em> should be set with <a class="link" href="glib-Error-Reporting.html#g-set-error" title="g_set_error ()"><code class="function">g_set_error()</code></a>
1484
- </td>
1485
- </tr>
1486
- </tbody>
1487
- </table></div>
1488
- </div>
1489
- <hr>
1490
- <div class="refsect2">
1491
- <a name="g-option-group-set-parse-hooks"></a><h3>g_option_group_set_parse_hooks ()</h3>
1492
- <pre class="programlisting"><span class="returnvalue">void</span> g_option_group_set_parse_hooks (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a> *group</code></em>,
1493
- <em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionParseFunc" title="GOptionParseFunc ()"><span class="type">GOptionParseFunc</span></a> pre_parse_func</code></em>,
1494
- <em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionParseFunc" title="GOptionParseFunc ()"><span class="type">GOptionParseFunc</span></a> post_parse_func</code></em>);</pre>
1495
- <p>
1496
- Associates two functions with <em class="parameter"><code>group</code></em> which will be called
1497
- from <a class="link" href="glib-Commandline-option-parser.html#g-option-context-parse" title="g_option_context_parse ()"><code class="function">g_option_context_parse()</code></a> before the first option is parsed
1498
- and after the last option has been parsed, respectively.
1499
- </p>
1500
- <p>
1501
- Note that the user data to be passed to <em class="parameter"><code>pre_parse_func</code></em> and
1502
- <em class="parameter"><code>post_parse_func</code></em> can be specified when constructing the group
1503
- with <a class="link" href="glib-Commandline-option-parser.html#g-option-group-new" title="g_option_group_new ()"><code class="function">g_option_group_new()</code></a>.
1504
- </p>
1505
- <div class="variablelist"><table border="0">
1506
- <col align="left" valign="top">
1507
- <tbody>
1508
- <tr>
1509
- <td><p><span class="term"><em class="parameter"><code>group</code></em> :</span></p></td>
1510
- <td>a <a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a>
1511
- </td>
1512
- </tr>
1513
- <tr>
1514
- <td><p><span class="term"><em class="parameter"><code>pre_parse_func</code></em> :</span></p></td>
1515
- <td>a function to call before parsing, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
1516
- </td>
1517
- </tr>
1518
- <tr>
1519
- <td><p><span class="term"><em class="parameter"><code>post_parse_func</code></em> :</span></p></td>
1520
- <td>a function to call after parsing, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
1521
- </td>
1522
- </tr>
1523
- </tbody>
1524
- </table></div>
1525
- <p class="since">Since 2.6</p>
1526
- </div>
1527
- <hr>
1528
- <div class="refsect2">
1529
- <a name="GOptionErrorFunc"></a><h3>GOptionErrorFunc ()</h3>
1530
- <pre class="programlisting"><span class="returnvalue">void</span> (*GOptionErrorFunc) (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a> *context</code></em>,
1531
- <em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a> *group</code></em>,
1532
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> data</code></em>,
1533
- <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>
1534
- <p>
1535
- The type of function to be used as callback when a parse error occurs.
1536
- </p>
1537
- <div class="variablelist"><table border="0">
1538
- <col align="left" valign="top">
1539
- <tbody>
1540
- <tr>
1541
- <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
1542
- <td>The active <a class="link" href="glib-Commandline-option-parser.html#GOptionContext" title="GOptionContext"><span class="type">GOptionContext</span></a>
1543
- </td>
1544
- </tr>
1545
- <tr>
1546
- <td><p><span class="term"><em class="parameter"><code>group</code></em> :</span></p></td>
1547
- <td>The group to which the function belongs
1548
- </td>
1549
- </tr>
1550
- <tr>
1551
- <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
1552
- <td>User data added to the <a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a> containing the option when it
1553
- was created with <a class="link" href="glib-Commandline-option-parser.html#g-option-group-new" title="g_option_group_new ()"><code class="function">g_option_group_new()</code></a>
1554
- </td>
1555
- </tr>
1556
- <tr>
1557
- <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1558
- <td>The <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> containing details about the parse error
1559
- </td>
1560
- </tr>
1561
- </tbody>
1562
- </table></div>
1563
- </div>
1564
- <hr>
1565
- <div class="refsect2">
1566
- <a name="g-option-group-set-error-hook"></a><h3>g_option_group_set_error_hook ()</h3>
1567
- <pre class="programlisting"><span class="returnvalue">void</span> g_option_group_set_error_hook (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a> *group</code></em>,
1568
- <em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionErrorFunc" title="GOptionErrorFunc ()"><span class="type">GOptionErrorFunc</span></a> error_func</code></em>);</pre>
1569
- <p>
1570
- Associates a function with <em class="parameter"><code>group</code></em> which will be called
1571
- from <a class="link" href="glib-Commandline-option-parser.html#g-option-context-parse" title="g_option_context_parse ()"><code class="function">g_option_context_parse()</code></a> when an error occurs.
1572
- </p>
1573
- <p>
1574
- Note that the user data to be passed to <em class="parameter"><code>error_func</code></em> can be
1575
- specified when constructing the group with <a class="link" href="glib-Commandline-option-parser.html#g-option-group-new" title="g_option_group_new ()"><code class="function">g_option_group_new()</code></a>.
1576
- </p>
1577
- <div class="variablelist"><table border="0">
1578
- <col align="left" valign="top">
1579
- <tbody>
1580
- <tr>
1581
- <td><p><span class="term"><em class="parameter"><code>group</code></em> :</span></p></td>
1582
- <td>a <a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a>
1583
- </td>
1584
- </tr>
1585
- <tr>
1586
- <td><p><span class="term"><em class="parameter"><code>error_func</code></em> :</span></p></td>
1587
- <td>a function to call when an error occurs
1588
- </td>
1589
- </tr>
1590
- </tbody>
1591
- </table></div>
1592
- <p class="since">Since 2.6</p>
1593
- </div>
1594
- <hr>
1595
- <div class="refsect2">
1596
- <a name="g-option-group-set-translate-func"></a><h3>g_option_group_set_translate_func ()</h3>
1597
- <pre class="programlisting"><span class="returnvalue">void</span> g_option_group_set_translate_func (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a> *group</code></em>,
1598
- <em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GTranslateFunc" title="GTranslateFunc ()"><span class="type">GTranslateFunc</span></a> func</code></em>,
1599
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> data</code></em>,
1600
- <em class="parameter"><code><a class="link" href="glib-Datasets.html#GDestroyNotify" title="GDestroyNotify ()"><span class="type">GDestroyNotify</span></a> destroy_notify</code></em>);</pre>
1601
- <p>
1602
- Sets the function which is used to translate user-visible
1603
- strings, for <code class="option">--help</code> output. Different
1604
- groups can use different <a class="link" href="glib-Commandline-option-parser.html#GTranslateFunc" title="GTranslateFunc ()"><span class="type">GTranslateFunc</span></a>s. If <em class="parameter"><code>func</code></em>
1605
- is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, strings are not translated.
1606
- </p>
1607
- <p>
1608
- If you are using <code class="function">gettext()</code>, you only need to set the translation
1609
- domain, see <a class="link" href="glib-Commandline-option-parser.html#g-option-group-set-translation-domain" title="g_option_group_set_translation_domain ()"><code class="function">g_option_group_set_translation_domain()</code></a>.
1610
- </p>
1611
- <div class="variablelist"><table border="0">
1612
- <col align="left" valign="top">
1613
- <tbody>
1614
- <tr>
1615
- <td><p><span class="term"><em class="parameter"><code>group</code></em> :</span></p></td>
1616
- <td>a <a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a>
1617
- </td>
1618
- </tr>
1619
- <tr>
1620
- <td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
1621
- <td>the <a class="link" href="glib-Commandline-option-parser.html#GTranslateFunc" title="GTranslateFunc ()"><span class="type">GTranslateFunc</span></a>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
1622
- </td>
1623
- </tr>
1624
- <tr>
1625
- <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
1626
- <td>user data to pass to <em class="parameter"><code>func</code></em>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
1627
- </td>
1628
- </tr>
1629
- <tr>
1630
- <td><p><span class="term"><em class="parameter"><code>destroy_notify</code></em> :</span></p></td>
1631
- <td>a function which gets called to free <em class="parameter"><code>data</code></em>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
1632
- </td>
1633
- </tr>
1634
- </tbody>
1635
- </table></div>
1636
- <p class="since">Since 2.6</p>
1637
- </div>
1638
- <hr>
1639
- <div class="refsect2">
1640
- <a name="g-option-group-set-translation-domain"></a><h3>g_option_group_set_translation_domain ()</h3>
1641
- <pre class="programlisting"><span class="returnvalue">void</span> g_option_group_set_translation_domain
1642
- (<em class="parameter"><code><a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a> *group</code></em>,
1643
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *domain</code></em>);</pre>
1644
- <p>
1645
- A convenience function to use <code class="function">gettext()</code> for translating
1646
- user-visible strings.
1647
- </p>
1648
- <div class="variablelist"><table border="0">
1649
- <col align="left" valign="top">
1650
- <tbody>
1651
- <tr>
1652
- <td><p><span class="term"><em class="parameter"><code>group</code></em> :</span></p></td>
1653
- <td>a <a class="link" href="glib-Commandline-option-parser.html#GOptionGroup" title="GOptionGroup"><span class="type">GOptionGroup</span></a>
1654
- </td>
1655
- </tr>
1656
- <tr>
1657
- <td><p><span class="term"><em class="parameter"><code>domain</code></em> :</span></p></td>
1658
- <td>the domain to use
1659
- </td>
1660
- </tr>
1661
- </tbody>
1662
- </table></div>
1663
- <p class="since">Since 2.6</p>
1664
- </div>
1665
- </div>
1666
- </div>
1667
- <div class="footer">
1668
- <hr>
1669
- Generated by GTK-Doc V1.15.1</div>
1670
- </body>
1671
- </html>