From 5791ec5b8539e872343667dbdf190dd0d3e493ed Mon Sep 17 00:00:00 2001 From: Owen Taylor Date: Tue, 5 Dec 2000 20:43:58 +0000 Subject: [PATCH] add images Tue Dec 5 15:41:23 2000 Owen Taylor * glib/Makefile.am glib/mainloop-states*: add images * glib/glib-sections.txt: Updated * glib/tmpl/main.sgml: More documentation, move function docs to .c file. --- docs/reference/ChangeLog | 9 + docs/reference/glib/Makefile.am | 10 +- docs/reference/glib/glib-sections.txt | 73 +- docs/reference/glib/mainloop-states.eps | 306 +++++++++ docs/reference/glib/mainloop-states.fig | 65 ++ docs/reference/glib/mainloop-states.gif | Bin 0 -> 7088 bytes docs/reference/glib/mainloop-states.png | Bin 0 -> 15258 bytes docs/reference/glib/tmpl/arrays.sgml | 19 + docs/reference/glib/tmpl/arrays_byte.sgml | 19 + docs/reference/glib/tmpl/arrays_pointer.sgml | 19 + docs/reference/glib/tmpl/completion.sgml | 11 + docs/reference/glib/tmpl/glib-unused.sgml | 43 ++ docs/reference/glib/tmpl/iochannels.sgml | 12 +- docs/reference/glib/tmpl/linked_lists_double.sgml | 11 + docs/reference/glib/tmpl/linked_lists_single.sgml | 11 + docs/reference/glib/tmpl/main.sgml | 781 +++++++++++++++------- docs/reference/glib/tmpl/trees-binary.sgml | 10 + docs/reference/gobject/tmpl/gobject-unused.sgml | 74 +- 18 files changed, 1190 insertions(+), 283 deletions(-) create mode 100644 docs/reference/glib/mainloop-states.eps create mode 100644 docs/reference/glib/mainloop-states.fig create mode 100644 docs/reference/glib/mainloop-states.gif create mode 100644 docs/reference/glib/mainloop-states.png diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index dbb12e7..9f02516 100644 --- a/docs/reference/ChangeLog +++ b/docs/reference/ChangeLog @@ -1,3 +1,12 @@ +Tue Dec 5 15:41:23 2000 Owen Taylor + + * glib/Makefile.am glib/mainloop-states*: add images + + * glib/glib-sections.txt: Updated + + * glib/tmpl/main.sgml: More documentation, move function + docs to .c file. + Mon Nov 13 00:18:55 2000 Owen Taylor * glib/glib-sections.sgml: Move conversion functions diff --git a/docs/reference/glib/Makefile.am b/docs/reference/glib/Makefile.am index 1749bc2..08bc535 100644 --- a/docs/reference/glib/Makefile.am +++ b/docs/reference/glib/Makefile.am @@ -74,6 +74,12 @@ tmpl_sources = \ tmpl/warnings.sgml \ tmpl/windows.sgml +extra_files = \ + mainloop-states.fig \ + mainloop-states.png \ + mainloop-states.eps \ + mainloop-states.gif + #################################### # Everything below here is generic # @@ -82,6 +88,7 @@ tmpl_sources = \ TARGET_DIR=$(HTML_DIR)/$(DOC_MODULE) EXTRA_DIST = \ + $(extra_files) \ $(DOC_MAIN_SGML_FILE) \ $(DOC_MODULE)-decl.txt \ $(DOC_MODULE)-sections.txt \ @@ -117,6 +124,7 @@ sgml: html: test -d $(srcdir)/html || mkdir $(srcdir)/html -cd $(srcdir)/html && gtkdoc-mkhtml $(DOC_MODULE) ../$(DOC_MAIN_SGML_FILE) + cp $(srcdir)/*.gif $(srcdir)/html @echo '-- Fixing Crossreferences' cd $(srcdir) && gtkdoc-fixxref --module-dir=html --html-dir=$(HTML_DIR) $(FIXXREF_OPTIONS) @@ -159,6 +167,6 @@ dist-hook: dist-check-gtkdoc -cp $(srcdir)/sgml/*.sgml $(distdir)/sgml -cp $(srcdir)/sgml/*.bottom $(srcdir)/sgml/*.top $(distdir)/sgml -cp $(srcdir)/html/index.sgml $(distdir)/html - -cp $(srcdir)/html/*.html $(srcdir)/html/*.css $(distdir)/html + -cp $(srcdir)/html/*.html $(srcdir)/html/*.css $(srcdir)/html/*.gif $(distdir)/html .PHONY : html sgml templates scan diff --git a/docs/reference/glib/glib-sections.txt b/docs/reference/glib/glib-sections.txt index da7b1d4..2c2a17a 100644 --- a/docs/reference/glib/glib-sections.txt +++ b/docs/reference/glib/glib-sections.txt @@ -319,13 +319,16 @@ g_clear_error The Main Event Loop main GMainLoop +g_main_loop_new +g_main_loop_destroy +g_main_loop_run +g_main_loop_quit +g_main_loop_is_running g_main_new g_main_destroy g_main_run -g_main_is_running -g_main_pending -g_main_iteration g_main_quit +g_main_is_running G_PRIORITY_HIGH @@ -335,31 +338,64 @@ G_PRIORITY_DEFAULT_IDLE G_PRIORITY_LOW +GMainContext +g_main_context_get +g_main_context_default +g_main_context_iteration +g_main_iteration +g_main_context_pending +g_main_pending +g_main_context_find_source_by_id +g_main_context_find_source_by_user_data +g_main_context_find_source_by_funcs_user_data +g_main_context_prepare +g_main_context_query +g_main_context_check +g_main_context_dispatch +g_main_context_set_poll_func +g_main_context_get_poll_func +GPollFunc +g_main_context_add_poll +g_main_context_remove_poll +g_main_set_poll_func + + +g_timeout_source_new g_timeout_add g_timeout_add_full -GSourceFunc +g_idle_source_new g_idle_add g_idle_add_full g_idle_remove_by_data -g_main_add_poll GPollFD -g_main_remove_poll -g_main_set_poll_func -g_main_win32_get_poll_func -GPollFunc - - -g_source_add +GSource GSourceFuncs +GSourceCallbackFuncs +g_source_new +g_source_ref +g_source_unref +g_source_add +g_source_destroy +g_source_set_priority +g_source_get_priority +g_source_set_can_recurse +g_source_get_can_recurse +g_source_get_id +g_source_get_context +g_source_connect +GSourceFunc +g_source_connect_indirect +g_source_add_poll +g_source_remove_poll +g_source_get_current_time g_source_remove g_source_remove_by_funcs_user_data -g_source_remove_by_source_data g_source_remove_by_user_data @@ -558,6 +594,7 @@ g_io_channel_ref g_io_channel_unref +g_io_create_watch g_io_add_watch g_io_add_watch_full GIOCondition @@ -1067,6 +1104,7 @@ G_MODULE_IMPORT GCompletion g_completion_new GCompletionFunc +GCompletionStrcmpFunc g_completion_add_items g_completion_remove_items g_completion_clear_items @@ -1155,6 +1193,7 @@ g_list_length g_list_copy g_list_reverse g_list_sort +g_list_sort_with_data GCompareFunc g_list_concat g_list_foreach @@ -1202,6 +1241,7 @@ g_slist_length g_slist_copy g_slist_reverse g_slist_sort +g_slist_sort_with_data g_slist_concat g_slist_foreach @@ -1341,6 +1381,8 @@ g_array_insert_val g_array_insert_vals g_array_remove_index g_array_remove_index_fast +g_array_sort +g_array_sort_with_data g_array_index g_array_set_size g_array_free @@ -1357,6 +1399,8 @@ g_ptr_array_remove g_ptr_array_remove_index g_ptr_array_remove_fast g_ptr_array_remove_index_fast +g_ptr_array_sort +g_ptr_array_sort_with_data g_ptr_array_set_size g_ptr_array_index g_ptr_array_free @@ -1373,6 +1417,8 @@ g_byte_array_append g_byte_array_prepend g_byte_array_remove_index g_byte_array_remove_index_fast +g_byte_array_sort +g_byte_array_sort_with_data g_byte_array_set_size g_byte_array_free @@ -1383,6 +1429,7 @@ g_byte_array_free trees-binary GTree g_tree_new +g_tree_new_with_data g_tree_insert g_tree_nnodes g_tree_height diff --git a/docs/reference/glib/mainloop-states.eps b/docs/reference/glib/mainloop-states.eps new file mode 100644 index 0000000..b3d159b --- /dev/null +++ b/docs/reference/glib/mainloop-states.eps @@ -0,0 +1,306 @@ +%!PS-Adobe-2.0 EPSF-2.0 +%%Title: mainloop-stages.eps +%%Creator: fig2dev Version 3.2 Patchlevel 3c +%%CreationDate: Wed Nov 29 12:23:52 2000 +%%For: otaylor@fresnel.labs.redhat.com (Owen Taylor) +%%BoundingBox: 0 0 503 291 +%%Magnification: 1.0000 +%%EndComments +/$F2psDict 200 dict def +$F2psDict begin +$F2psDict /mtrx matrix put +/col-1 {0 setgray} bind def +/col0 {0.000 0.000 0.000 srgb} bind def +/col1 {0.000 0.000 1.000 srgb} bind def +/col2 {0.000 1.000 0.000 srgb} bind def +/col3 {0.000 1.000 1.000 srgb} bind def +/col4 {1.000 0.000 0.000 srgb} bind def +/col5 {1.000 0.000 1.000 srgb} bind def +/col6 {1.000 1.000 0.000 srgb} bind def +/col7 {1.000 1.000 1.000 srgb} bind def +/col8 {0.000 0.000 0.560 srgb} bind def +/col9 {0.000 0.000 0.690 srgb} bind def +/col10 {0.000 0.000 0.820 srgb} bind def +/col11 {0.530 0.810 1.000 srgb} bind def +/col12 {0.000 0.560 0.000 srgb} bind def +/col13 {0.000 0.690 0.000 srgb} bind def +/col14 {0.000 0.820 0.000 srgb} bind def +/col15 {0.000 0.560 0.560 srgb} bind def +/col16 {0.000 0.690 0.690 srgb} bind def +/col17 {0.000 0.820 0.820 srgb} bind def +/col18 {0.560 0.000 0.000 srgb} bind def +/col19 {0.690 0.000 0.000 srgb} bind def +/col20 {0.820 0.000 0.000 srgb} bind def +/col21 {0.560 0.000 0.560 srgb} bind def +/col22 {0.690 0.000 0.690 srgb} bind def +/col23 {0.820 0.000 0.820 srgb} bind def +/col24 {0.500 0.190 0.000 srgb} bind def +/col25 {0.630 0.250 0.000 srgb} bind def +/col26 {0.750 0.380 0.000 srgb} bind def +/col27 {1.000 0.500 0.500 srgb} bind def +/col28 {1.000 0.630 0.630 srgb} bind def +/col29 {1.000 0.750 0.750 srgb} bind def +/col30 {1.000 0.880 0.880 srgb} bind def +/col31 {1.000 0.840 0.000 srgb} bind def + +end +save +newpath 0 291 moveto 0 0 lineto 503 0 lineto 503 291 lineto closepath clip newpath +-106.0 402.0 translate +1 -1 scale + +/cp {closepath} bind def +/ef {eofill} bind def +/gr {grestore} bind def +/gs {gsave} bind def +/sa {save} bind def +/rs {restore} bind def +/l {lineto} bind def +/m {moveto} bind def +/rm {rmoveto} bind def +/n {newpath} bind def +/s {stroke} bind def +/sh {show} bind def +/slc {setlinecap} bind def +/slj {setlinejoin} bind def +/slw {setlinewidth} bind def +/srgb {setrgbcolor} bind def +/rot {rotate} bind def +/sc {scale} bind def +/sd {setdash} bind def +/ff {findfont} bind def +/sf {setfont} bind def +/scf {scalefont} bind def +/sw {stringwidth} bind def +/tr {translate} bind def +/tnt {dup dup currentrgbcolor + 4 -2 roll dup 1 exch sub 3 -1 roll mul add + 4 -2 roll dup 1 exch sub 3 -1 roll mul add + 4 -2 roll dup 1 exch sub 3 -1 roll mul add srgb} + bind def +/shd {dup dup currentrgbcolor 4 -2 roll mul 4 -2 roll mul + 4 -2 roll mul srgb} bind def +/$F2psBegin {$F2psDict begin /$F2psEnteredState save def} def +/$F2psEnd {$F2psEnteredState restore end} def + +$F2psBegin +%%Page: 1 1 +10 setmiterlimit + 0.06000 0.06000 sc +% +% Fig objects follow +% +/Times-Roman ff 270.00 scf sf +9300 6225 m +gs 1 -1 sc (Initial[n+1]) dup sw pop 2 div neg 0 rm col0 sh gr +/Times-Roman ff 270.00 scf sf +9300 6540 m +gs 1 -1 sc (\(Recursion\)) dup sw pop 2 div neg 0 rm col0 sh gr +% Polyline +15.000 slw + [60] 0 sd +n 1905 6000 m 1800 6000 1800 6420 105 arcto 4 {pop} repeat + 1800 6525 3120 6525 105 arcto 4 {pop} repeat + 3225 6525 3225 6105 105 arcto 4 {pop} repeat + 3225 6000 1905 6000 105 arcto 4 {pop} repeat + cp gs col0 s gr [] 0 sd +% Polyline + [60] 0 sd +gs clippath +3865 5498 m 3806 5431 l 3688 5535 l 3808 5490 l 3747 5602 l cp +3184 5976 m 3243 6043 l 3361 5939 l 3242 5985 l 3302 5872 l cp +eoclip +n 3225 6000 m + 3825 5475 l gs col0 s gr gr + [] 0 sd +% arrowhead +n 3302 5872 m 3242 5985 l 3361 5939 l 3302 5872 l cp gs 0.00 setgray ef gr col0 s +% arrowhead +n 3747 5602 m 3808 5490 l 3688 5535 l 3747 5602 l cp gs 0.00 setgray ef gr col0 s +% Polyline +n 4980 5775 m 4875 5775 4875 6270 105 arcto 4 {pop} repeat + 4875 6375 6870 6375 105 arcto 4 {pop} repeat + 6975 6375 6975 5880 105 arcto 4 {pop} repeat + 6975 5775 4980 5775 105 arcto 4 {pop} repeat + cp gs col0 s gr +% Polyline + [60] 0 sd +gs clippath +8457 5969 m 8515 5900 l 8394 5799 l 8458 5911 l 8337 5868 l cp +8042 5505 m 7984 5574 l 8105 5675 l 8042 5564 l 8162 5606 l cp +eoclip +n 8025 5550 m + 8475 5925 l gs col0 s gr gr + [] 0 sd +% arrowhead +n 8162 5606 m 8042 5564 l 8105 5675 l 8162 5606 l cp gs 0.00 setgray ef gr col0 s +% arrowhead +n 8337 5868 m 8458 5911 l 8394 5799 l 8337 5868 l cp gs 0.00 setgray ef gr col0 s +% Polyline + [60] 0 sd +n 8580 5850 m 8475 5850 8475 6570 105 arcto 4 {pop} repeat + 8475 6675 10020 6675 105 arcto 4 {pop} repeat + 10125 6675 10125 5955 105 arcto 4 {pop} repeat + 10125 5850 8580 5850 105 arcto 4 {pop} repeat + cp gs col0 s gr [] 0 sd +% Polyline +n 7155 3825 m 7050 3825 7050 4320 105 arcto 4 {pop} repeat + 7050 4425 9045 4425 105 arcto 4 {pop} repeat + 9150 4425 9150 3930 105 arcto 4 {pop} repeat + 9150 3825 7155 3825 105 arcto 4 {pop} repeat + cp gs col0 s gr +% Polyline +n 5055 2100 m 4950 2100 4950 2595 105 arcto 4 {pop} repeat + 4950 2700 6945 2700 105 arcto 4 {pop} repeat + 7050 2700 7050 2205 105 arcto 4 {pop} repeat + 7050 2100 5055 2100 105 arcto 4 {pop} repeat + cp gs col0 s gr +% Polyline +n 2730 3900 m 2625 3900 2625 4395 105 arcto 4 {pop} repeat + 2625 4500 4620 4500 105 arcto 4 {pop} repeat + 4725 4500 4725 4005 105 arcto 4 {pop} repeat + 4725 3900 2730 3900 105 arcto 4 {pop} repeat + cp gs col0 s gr +% Polyline + [60] 0 sd +n 8580 1875 m 8475 1875 8475 2295 105 arcto 4 {pop} repeat + 8475 2400 9645 2400 105 arcto 4 {pop} repeat + 9750 2400 9750 1980 105 arcto 4 {pop} repeat + 9750 1875 8580 1875 105 arcto 4 {pop} repeat + cp gs col0 s gr [] 0 sd +% Polyline + [60] 0 sd +gs clippath +8518 2419 m 8451 2358 l 8345 2474 l 8460 2416 l 8412 2534 l cp +8003 2848 m 8070 2909 l 8176 2793 l 8062 2852 l 8109 2733 l cp +eoclip +n 8047 2868 m + 8475 2400 l gs col0 s gr gr + [] 0 sd +% arrowhead +n 8109 2733 m 8062 2852 l 8176 2793 l 8109 2733 l cp gs 0.00 setgray ef gr col0 s +% arrowhead +n 8412 2534 m 8460 2416 l 8345 2474 l 8412 2534 l cp gs 0.00 setgray ef gr col0 s +% Polyline +2 slj +gs clippath +3340 4475 m 3252 4494 l 3286 4648 l 3305 4522 l 3374 4629 l cp +eoclip +n 4875 6075 m 4874 6075 l 4872 6074 l 4868 6073 l 4861 6072 l 4852 6070 l + 4839 6067 l 4824 6064 l 4805 6059 l 4783 6054 l 4759 6048 l + 4731 6041 l 4701 6033 l 4669 6025 l 4635 6015 l 4600 6004 l + 4563 5993 l 4526 5981 l 4487 5967 l 4448 5953 l 4408 5937 l + 4367 5920 l 4326 5901 l 4284 5881 l 4241 5859 l 4198 5835 l + 4154 5809 l 4109 5781 l 4063 5749 l 4016 5715 l 3968 5678 l + 3920 5638 l 3872 5595 l 3825 5550 l 3780 5503 l 3737 5455 l + 3697 5407 l 3660 5359 l 3626 5312 l 3594 5266 l 3566 5221 l + 3540 5177 l 3516 5134 l 3494 5091 l 3474 5049 l 3455 5008 l + 3438 4967 l 3422 4927 l 3408 4888 l 3394 4849 l 3382 4812 l + 3371 4775 l 3360 4740 l 3350 4706 l 3342 4674 l 3334 4644 l + 3327 4616 l 3321 4592 l 3316 4570 l 3311 4551 l 3308 4536 l + 3305 4523 l 3303 4514 l + 3300 4500 l gs col0 s gr gr + +% arrowhead +0 slj +n 3374 4629 m 3305 4522 l 3286 4648 l 3374 4629 l cp gs 0.00 setgray ef gr col0 s +% Polyline +2 slj +gs clippath +6943 6114 m 6978 6197 l 7123 6135 l 6995 6141 l 7087 6052 l cp +eoclip +n 8475 4500 m 8475 4501 l 8475 4503 l 8475 4508 l 8475 4515 l 8474 4525 l + 8474 4538 l 8473 4553 l 8472 4573 l 8470 4594 l 8468 4619 l + 8465 4646 l 8462 4675 l 8457 4706 l 8452 4739 l 8445 4773 l + 8437 4808 l 8427 4845 l 8416 4882 l 8403 4921 l 8388 4961 l + 8370 5002 l 8350 5045 l 8326 5090 l 8299 5137 l 8268 5186 l + 8232 5237 l 8192 5290 l 8148 5345 l 8100 5400 l 8057 5445 l + 8013 5490 l 7968 5533 l 7923 5573 l 7878 5612 l 7833 5649 l + 7789 5684 l 7745 5717 l 7701 5749 l 7658 5779 l 7615 5807 l + 7573 5834 l 7531 5861 l 7489 5886 l 7447 5910 l 7407 5933 l + 7366 5955 l 7327 5977 l 7288 5997 l 7250 6017 l 7214 6035 l + 7180 6052 l 7147 6068 l 7117 6083 l 7090 6096 l 7065 6108 l + 7043 6118 l 7025 6127 l 7010 6134 l 6998 6140 l 6989 6144 l + + 6975 6150 l gs col0 s gr gr + +% arrowhead +0 slj +n 7087 6052 m 6995 6141 l 7123 6135 l 7087 6052 l cp gs 0.00 setgray ef gr col0 s +% Polyline +2 slj +gs clippath +8433 3848 m 8521 3831 l 8493 3676 l 8471 3803 l 8404 3693 l cp +eoclip +n 7050 2400 m 7051 2400 l 7054 2401 l 7058 2401 l 7066 2403 l 7076 2404 l + 7090 2407 l 7107 2410 l 7127 2414 l 7150 2418 l 7177 2424 l + 7206 2430 l 7238 2437 l 7271 2445 l 7306 2454 l 7343 2463 l + 7381 2474 l 7419 2486 l 7458 2499 l 7498 2513 l 7538 2528 l + 7579 2545 l 7621 2564 l 7663 2585 l 7706 2608 l 7750 2634 l + 7795 2662 l 7841 2694 l 7887 2728 l 7933 2766 l 7980 2807 l + 8025 2850 l 8068 2895 l 8109 2942 l 8147 2988 l 8181 3034 l + 8213 3080 l 8241 3125 l 8267 3169 l 8290 3212 l 8311 3254 l + 8330 3296 l 8347 3337 l 8362 3377 l 8376 3417 l 8389 3456 l + 8401 3494 l 8412 3532 l 8421 3569 l 8430 3604 l 8438 3637 l + 8445 3669 l 8451 3698 l 8457 3725 l 8461 3748 l 8465 3768 l + 8468 3785 l 8471 3799 l 8472 3809 l + 8475 3825 l gs col0 s gr gr + +% arrowhead +0 slj +n 8404 3693 m 8471 3803 l 8493 3676 l 8404 3693 l cp gs 0.00 setgray ef gr col0 s +% Polyline +2 slj +gs clippath +4970 2442 m 4959 2353 l 4803 2372 l 4928 2403 l 4814 2461 l cp +eoclip +n 3375 3900 m 3375 3899 l 3376 3897 l 3377 3892 l 3378 3886 l 3380 3876 l + 3383 3863 l 3386 3848 l 3391 3828 l 3396 3806 l 3402 3781 l + 3409 3753 l 3417 3722 l 3425 3689 l 3435 3655 l 3446 3619 l + 3457 3581 l 3469 3543 l 3483 3504 l 3497 3464 l 3513 3423 l + 3530 3383 l 3549 3341 l 3569 3299 l 3591 3257 l 3615 3214 l + 3641 3170 l 3669 3125 l 3701 3080 l 3735 3034 l 3772 2988 l + 3812 2941 l 3855 2895 l 3900 2850 l 3950 2804 l 4001 2762 l + 4052 2723 l 4102 2687 l 4152 2655 l 4201 2625 l 4248 2599 l + 4295 2576 l 4340 2555 l 4385 2536 l 4429 2519 l 4472 2504 l + 4515 2490 l 4557 2477 l 4598 2466 l 4638 2456 l 4677 2447 l + 4715 2439 l 4751 2432 l 4784 2426 l 4815 2420 l 4843 2415 l + 4868 2411 l 4890 2408 l 4908 2406 l 4922 2404 l 4933 2402 l + + 4950 2400 l gs col0 s gr gr + +% arrowhead +0 slj +n 4814 2461 m 4928 2403 l 4803 2372 l 4814 2461 l cp gs 0.00 setgray ef gr col0 s +/Times-Roman ff 360.00 scf sf +5925 6225 m +gs 1 -1 sc (Initial[n]) dup sw pop 2 div neg 0 rm col0 sh gr +/Times-Roman ff 360.00 scf sf +8100 4275 m +gs 1 -1 sc (Dispatching) dup sw pop 2 div neg 0 rm col0 sh gr +/Times-Roman ff 360.00 scf sf +3675 4350 m +gs 1 -1 sc (Prepared) dup sw pop 2 div neg 0 rm col0 sh gr +/Times-Roman ff 360.00 scf sf +5925 2550 m +gs 1 -1 sc (Polling) dup sw pop 2 div neg 0 rm col0 sh gr +/Times-Roman ff 270.00 scf sf +4050 3300 m +gs 1 -1 sc (query\(\)) col0 sh gr +/Times-Roman ff 270.00 scf sf +7800 3225 m +gs 1 -1 sc (check\(\)) dup sw pop neg 0 rm col0 sh gr +/Times-Roman ff 270.00 scf sf +2475 6375 m +gs 1 -1 sc (Working) dup sw pop 2 div neg 0 rm col0 sh gr +/Times-Roman ff 270.00 scf sf +3900 5400 m +gs 1 -1 sc (prepare\(\)) col0 sh gr +/Times-Roman ff 270.00 scf sf +8025 5325 m +gs 1 -1 sc (dispatch\(\)) dup sw pop neg 0 rm col0 sh gr +/Times-Roman ff 270.00 scf sf +9150 2250 m +gs 1 -1 sc (Working) dup sw pop 2 div neg 0 rm col0 sh gr +$F2psEnd +rs diff --git a/docs/reference/glib/mainloop-states.fig b/docs/reference/glib/mainloop-states.fig new file mode 100644 index 0000000..6acbedb --- /dev/null +++ b/docs/reference/glib/mainloop-states.fig @@ -0,0 +1,65 @@ +#FIG 3.2 +Landscape +Center +Inches +Letter +100.00 +Single +-2 +1200 2 +6 8625 6000 9975 6600 +4 1 0 50 0 0 18 0.0000 4 240 1290 9300 6225 Initial[n+1]\001 +4 1 0 50 0 0 18 0.0000 4 255 1335 9300 6540 (Recursion)\001 +-6 +2 4 1 2 0 7 50 0 -1 4.000 0 0 7 0 0 5 + 3225 6525 3225 6000 1800 6000 1800 6525 3225 6525 +2 1 1 2 0 7 50 0 -1 4.000 0 0 -1 1 1 2 + 1 1 2.00 90.00 120.00 + 1 1 2.00 90.00 120.00 + 3225 6000 3825 5475 +2 4 0 2 0 7 50 0 -1 0.000 0 0 7 0 0 5 + 6975 6375 6975 5775 4875 5775 4875 6375 6975 6375 +2 1 1 2 0 7 50 0 -1 4.000 0 0 -1 1 1 2 + 1 1 2.00 90.00 120.00 + 1 1 2.00 90.00 120.00 + 8025 5550 8475 5925 +2 4 1 2 0 7 50 0 -1 4.000 0 0 7 0 0 5 + 10125 6675 10125 5850 8475 5850 8475 6675 10125 6675 +2 4 0 2 0 7 50 0 -1 0.000 0 0 7 0 0 5 + 9150 4425 9150 3825 7050 3825 7050 4425 9150 4425 +2 4 0 2 0 7 50 0 -1 0.000 0 0 7 0 0 5 + 7050 2700 7050 2100 4950 2100 4950 2700 7050 2700 +2 4 0 2 0 7 50 0 -1 0.000 0 0 7 0 0 5 + 4725 4500 4725 3900 2625 3900 2625 4500 4725 4500 +2 4 1 2 0 7 50 0 -1 4.000 0 0 7 0 0 5 + 9750 2400 9750 1875 8475 1875 8475 2400 9750 2400 +2 1 1 2 0 7 50 0 -1 4.000 0 0 -1 1 1 2 + 1 1 2.00 90.00 120.00 + 1 1 2.00 90.00 120.00 + 8047 2868 8475 2400 +3 2 0 2 0 7 50 0 -1 0.000 0 1 0 3 + 1 1 2.00 90.00 120.00 + 4875 6075 3825 5550 3300 4500 + 0.000 -1.000 0.000 +3 2 0 2 0 7 50 0 -1 0.000 0 1 0 3 + 1 1 2.00 90.00 120.00 + 8475 4500 8100 5400 6975 6150 + 0.000 -1.000 0.000 +3 2 0 2 0 7 50 0 -1 0.000 0 1 0 3 + 1 1 2.00 90.00 120.00 + 7050 2400 8025 2850 8475 3825 + 0.000 -1.000 0.000 +3 2 0 2 0 7 50 0 -1 0.000 0 1 0 3 + 1 1 2.00 90.00 120.00 + 3375 3900 3900 2850 4950 2400 + 0.000 -1.000 0.000 +4 1 0 50 0 0 24 0.0000 4 315 1290 5925 6225 Initial[n]\001 +4 1 0 50 0 0 24 0.0000 4 330 1770 8100 4275 Dispatching\001 +4 1 0 50 0 0 24 0.0000 4 330 1320 3675 4350 Prepared\001 +4 1 0 50 0 0 24 0.0000 4 330 1050 5925 2550 Polling\001 +4 0 0 50 0 0 18 0.0000 4 255 825 4050 3300 query()\001 +4 2 0 50 0 0 18 0.0000 4 255 855 7800 3225 check()\001 +4 1 0 50 0 0 18 0.0000 4 255 990 2475 6375 Working\001 +4 0 0 50 0 0 18 0.0000 4 255 1050 3900 5400 prepare()\001 +4 2 0 50 0 0 18 0.0000 4 255 1140 8025 5325 dispatch()\001 +4 1 0 50 0 0 18 0.0000 4 255 990 9150 2250 Working\001 diff --git a/docs/reference/glib/mainloop-states.gif b/docs/reference/glib/mainloop-states.gif new file mode 100644 index 0000000000000000000000000000000000000000..0ba1a8999c5ba981c58b7d53999c6f7c0f82cd49 GIT binary patch literal 7088 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 literal 0 HcmV?d00001 diff --git a/docs/reference/glib/mainloop-states.png b/docs/reference/glib/mainloop-states.png new file mode 100644 index 0000000000000000000000000000000000000000..4e9fc9d9a46d128af43a962b5f9ca1535305c8dd GIT binary patch literal 15258 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%0AF`p=IdJ?3i%aTN-(%I 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 literal 0 HcmV?d00001 diff --git a/docs/reference/glib/tmpl/arrays.sgml b/docs/reference/glib/tmpl/arrays.sgml index bf1f0d1..f4eea22 100644 --- a/docs/reference/glib/tmpl/arrays.sgml +++ b/docs/reference/glib/tmpl/arrays.sgml @@ -209,6 +209,25 @@ g_array_remove_index(). @Returns: the #GArray. + + + + + +@array: +@compare_func: + + + + + + + +@array: +@compare_func: +@user_data: + + Returns the element of a #GArray at the given index. diff --git a/docs/reference/glib/tmpl/arrays_byte.sgml b/docs/reference/glib/tmpl/arrays_byte.sgml index 0a454e6..9d2fb83 100644 --- a/docs/reference/glib/tmpl/arrays_byte.sgml +++ b/docs/reference/glib/tmpl/arrays_byte.sgml @@ -123,6 +123,25 @@ g_byte_array_remove_index(). @Returns: the #GByteArray. + + + + + +@array: +@compare_func: + + + + + + + +@array: +@compare_func: +@user_data: + + Sets the size of the #GByteArray, expanding it if necessary. diff --git a/docs/reference/glib/tmpl/arrays_pointer.sgml b/docs/reference/glib/tmpl/arrays_pointer.sgml index fa6659a..f44d90f 100644 --- a/docs/reference/glib/tmpl/arrays_pointer.sgml +++ b/docs/reference/glib/tmpl/arrays_pointer.sgml @@ -156,6 +156,25 @@ g_ptr_array_remove_index(). @Returns: the pointer which was removed. + + + + + +@array: +@compare_func: + + + + + + + +@array: +@compare_func: +@user_data: + + Sets the size of the array, expanding it if necessary. diff --git a/docs/reference/glib/tmpl/completion.sgml b/docs/reference/glib/tmpl/completion.sgml index 6bb7681..80500e2 100644 --- a/docs/reference/glib/tmpl/completion.sgml +++ b/docs/reference/glib/tmpl/completion.sgml @@ -47,6 +47,7 @@ g_completion_complete(). @func: @prefix: @cache: +@strncmp_func: @@ -70,6 +71,16 @@ This is used when you use data structures as #GCompletion items. @Returns: the string corresponding to the item. + + + + + +@s1: +@s2: +@Returns: + + Adds items to the #GCompletion. diff --git a/docs/reference/glib/tmpl/glib-unused.sgml b/docs/reference/glib/tmpl/glib-unused.sgml index f954eee..debc85f 100644 --- a/docs/reference/glib/tmpl/glib-unused.sgml +++ b/docs/reference/glib/tmpl/glib-unused.sgml @@ -1,3 +1,10 @@ + + +Removes a file descriptor from the list being polled. + + +@fd: the #GPollFD to remove. + @@ -17,6 +24,22 @@ + + +Adds a file descriptor to be polled. +This is usually combined with g_source_add() to add an event source. +The event source's check function will typically test the revents +field in the #GPollFD struct and return TRUE if events need to be processed. + + +@fd: a #GPollFD, which is a file descriptor together with a bitwise +combination of #GIOCondition flags determining which events to poll for. +@priority: the priority of the poll, which should be the same as the priority +used for g_source_add() to ensure that the file descriptor is polled whenever +the results may be needed. +See #G_PRIORITY_DEFAULT, #G_PRIORITY_DEFAULT_IDLE, #G_PRIORITY_HIGH, +#G_PRIORITY_HIGH_IDLE, and #G_PRIORITY_LOW. + @@ -42,6 +65,19 @@ Turns the argument into a string literal by using the '#' stringizing operator. + + +Removes the first event source found with the given source data. + + +Event sources are sorted with the highest priority first. Sources with equal +priority are stored in the order in which they were added. + + +@source_data: the source data, which contains information specific to the +type of source. +@Returns: TRUE if an event source was found and removed. + @@ -78,3 +114,10 @@ Turns the argument into a string literal by using the '#' stringizing operator. + + + + + +@Returns: + diff --git a/docs/reference/glib/tmpl/iochannels.sgml b/docs/reference/glib/tmpl/iochannels.sgml index 1c44eb2..ebfdd05 100644 --- a/docs/reference/glib/tmpl/iochannels.sgml +++ b/docs/reference/glib/tmpl/iochannels.sgml @@ -209,6 +209,16 @@ Decrements the reference count of a #GIOChannel. @channel: a #GIOChannel. + + + + + +@channel: +@condition: +@Returns: + + Adds the #GIOChannel into the @@ -314,6 +324,6 @@ generic way. @io_write: @io_seek: @io_close: -@io_add_watch: +@io_create_watch: @io_free: diff --git a/docs/reference/glib/tmpl/linked_lists_double.sgml b/docs/reference/glib/tmpl/linked_lists_double.sgml index ab995f0..8812d8a 100644 --- a/docs/reference/glib/tmpl/linked_lists_double.sgml +++ b/docs/reference/glib/tmpl/linked_lists_double.sgml @@ -268,6 +268,17 @@ value if the first element comes after the second. @Returns: the start of the sorted #GList. + + + + + +@list: +@compare_func: +@user_data: +@Returns: + + Specifies the type of a comparison function used to compare two diff --git a/docs/reference/glib/tmpl/linked_lists_single.sgml b/docs/reference/glib/tmpl/linked_lists_single.sgml index 3bb1a4e..780240f 100644 --- a/docs/reference/glib/tmpl/linked_lists_single.sgml +++ b/docs/reference/glib/tmpl/linked_lists_single.sgml @@ -271,6 +271,17 @@ value if the first element comes after the second. @Returns: the start of the sorted #GList. + + + + + +@list: +@compare_func: +@user_data: +@Returns: + + Adds the second #GSList onto the end of the first #GSList. diff --git a/docs/reference/glib/tmpl/main.sgml b/docs/reference/glib/tmpl/main.sgml index 0af7652..4957d02 100644 --- a/docs/reference/glib/tmpl/main.sgml +++ b/docs/reference/glib/tmpl/main.sgml @@ -5,123 +5,197 @@ The Main Event Loop manages all available sources of events. + + The main event loop manages all the available sources of events for + GLib and GTK+ applications. These events can come from any number of + different types of sources such as file descriptors (plain files, + pipes or sockets) and timeouts. New types of event sources can also + be added using g_source_add(). + + + To allow multiple independent sets of sources to be handled in + different threads, each source is associated with a #GMainContext. + A #GMainContext can only be running in a single thread, but + sources can be added and removed from it from other threads. + + + Each event source is assigned a priority. The default priority, + #G_PRIORITY_DEFAULT, is 0. Values less than 0 denote higher + priorities. Values greater than 0 denote lower priorities. Events + from high priority sources are always processed before events from + lower priority sources. + + + Idle functions can also be added, and assigned a priority. These will + be run whenever no events with a higher priority are ready to be + processed. + + + The #GMainLoop data type represents a main event loop. A #GMainLoop + is created with g_main_loop_new(). After adding the initial event sources, + g_main_run() is called. This continuously checks for new events from + each of the event sources and dispatches them. Finally, the + processing of an event from one of the sources leads to a call to + g_main_quit() to exit the main loop, and g_main_run() returns. + + + It is possible to create new instances of #GMainLoop recursively. + This is often used in GTK+ applications when showing modal dialog + boxes. Note that event sources are associated with a particular + #GMainContext, and will be checked and dispatched for all main + loops associated with that #GMainContext. + + + GTK+ contains wrappers of many of these functions, e.g. gtk_main(), + gtk_main_quit(), gtk_events_pending(), gtk_idle_add(), + gtk_timeout_add() and gtk_input_add_full(). + + + Creating new sources types + + One of the unusual features of the GTK+ main loop functionality + is that new types of event source can be created and used in + addition to the builtin type of event source. A new event source + type is used for handling GDK events. A new source type is + created by deriving from the #GSource + structure. The derived type of source is represented by a + structure that has the #GSource structure as a first elemeent, + and other elements specific to the new source type. To create + an instance of the new source type, call g_source_new() passing + in the size of the derived structure and a table of functions. + These #GSourceFuncs determine the behavior of the new source + types. + + + New source types basically interact with with the main context + in two ways. Their prepare function in #GSourceFuncs can set + a timeout to determine the maximum amount of time that the + main loop will sleep before checking the source again. In + addition, or as well, the source can add file descriptors to + the set that the main context checks using g_source_add_poll(). + + + + Customizing the main loop iteration + + Single iterations of a #GMainContext can be run with + g_main_context_iteration(). In some cases, more detailed control + of exactly how the details of the main loop work is desired, + for instance, when integrating the #GMainLoop with an external + main loop. In such cases, you can call the component functions + of g_main_context_iteration() directly. These functions + are g_main_context_prepare(), g_main_context_query(), + g_main_context_check() and g_main_context_dispatch(). + + + The operation of these functions can best be seen in terms + of a state diagram, as shown in . + +
+ States of a Main Context + +
+ + -The main event loop manages all the available sources of events for GLib -and GTK+ applications. These events can come from any number of different -types of sources such as file descriptors (plain files, pipes or sockets) -and timeouts. -New types of event sources can also be added using g_source_add(). - - -Each event source is assigned a priority. -The default priority, #G_PRIORITY_DEFAULT, is 0. -Values less than 0 denote higher priorities. -Values greater than 0 denote lower priorities. -Events from high priority sources -are always processed before events from lower priority sources. - - -Idle functions can also be added, and assigned a priority. These will be -run whenever no events with a higher priority are ready to be processed. - - -The #GMainLoop data type represents a main event loop. -A #GMainLoop is created with g_main_new(). After adding the initial event -sources, g_main_run() is called. This continuously checks for new events -from each of the event sources and dispatches them. -Finally, the processing of an event from one of the sources leads to a call -to g_main_quit() to exit the main loop, and g_main_run() returns. + + + -It is possible to create new instances of #GMainLoop recursively. -This is often used in GTK+ applications when showing modal dialog boxes. -However, all event sources are global; they are not tied to a particular -#GMainLoop. +The #GMainLoop struct is an opaque data type representing the main event loop +of a GLib or GTK+ application. + + + -GTK+ contains wrappers of many of these functions, -e.g. gtk_main(), gtk_main_quit(), gtk_events_pending(), gtk_idle_add(), -gtk_timeout_add() and gtk_input_add_full(). -In a GTK+ application, these wrapper functions should be used instead. + - +@context: +@is_running: +@Returns: + + + - +@loop: + + + -The #GMainLoop struct is an opaque data type representing the main event loop -of a GLib or GTK+ application. + +@loop: - + + -Creates a new #GMainLoop. + -@is_running: set to TRUE to indicate that the loop is running. This is not -very important since calling g_main_run() will set this to TRUE anyway. -@Returns: a new #GMainLoop. +@loop: - + -Frees the memory allocated for the #GMainLoop. + -@loop: a #GMainLoop. +@loop: +@Returns: - + -Runs a main loop until it stops running, which occurs when g_main_quit() -is called. +Creates a new #GMainLoop for the default main loop. A compatibility +macro, see g_main_loop_new(). -@loop: a #GMainLoop. +@is_running: set to TRUE to indicate that the loop is running. This is not +very important since calling g_main_run() will set this to TRUE anyway. +@Returns: a new #GMainLoop. - + -Returns TRUE if the main loop is running. +Frees the memory allocated for the #GMainLoop. A compatibility macro, see +g_main_loop_destroy(). @loop: a #GMainLoop. -@Returns: TRUE if the main loop is running. - + -Returns TRUE if any events are pending (i.e. ready to be processed). +Runs a main loop until it stops running. A compatibility macro, see g_main_loop_run(). -@Returns: TRUE if any events are pending. +@loop: a #GMainLoop. - + -Runs a single iteration of the main loop. -This will check which event sources are ready to be processed, and will -process the highest priority event sources which are ready. +Stops the #GMainLoop. If g_main_run() was called to run the #GMainLoop, +it will now return. A compatibility macro, see g_main_loop_quit(). -@may_block: set to TRUE if it should block (i.e. wait) until an event source -becomes ready. It will return after an event source has been processed. -If set to FALSE it will return immediately if no event source is ready to be -processed. -@Returns: TRUE if more events are pending. +@loop: a #GMainLoop. - + -Stops the #GMainLoop. If g_main_run() was called to run the #GMainLoop, -it will now return. +Checks if the main loop is running. A compatibility macro, see +g_main_loop_is_running(). @loop: a #GMainLoop. +@Returns: %TRUE if the main loop is running. @@ -169,188 +243,162 @@ It is not used within GLib or GTK+. - + -Sets a function to be called at regular intervals, with the default priority, -#G_PRIORITY_DEFAULT. -The function is called repeatedly until it returns FALSE, at which point -the timeout is automatically destroyed and the function will not be called -again. -The first call to the function will be at the end of the first @interval. + + + + -Note that timeout functions may be delayed, due to the processing of other -event sources. Thus they should not be relied on for precise timing. -After each call to the timeout function, the time of the next -timeout is recalculated based on the current time and the given interval -(it does not try to 'catch up' time lost in delays). + -@interval: the time between calls to @function, in milliseconds (1/1000ths -of a second.) -@function: the function to call at each interval. -@data: data to pass to @function. -@Returns: the id of the event source. +@thread: +@Returns: - + -Sets a function to be called at regular intervals, with the given priority. -The function is called repeatedly until it returns FALSE, at which point -the timeout is automatically destroyed and the function will not be called -again. -The @notify function is called when the timeout is destroyed. -The first call to the function will be at the end of the first @interval. + + +@Returns: + + + -Note that timeout functions may be delayed, due to the processing of other -event sources. Thus they should not be relied on for precise timing. -After each call to the timeout function, the time of the next -timeout is recalculated based on the current time and the given interval -(it does not try to 'catch up' time lost in delays). + -@priority: the priority of the function. See #G_PRIORITY_DEFAULT, -#G_PRIORITY_DEFAULT_IDLE, #G_PRIORITY_HIGH, #G_PRIORITY_HIGH_IDLE, and -#G_PRIORITY_LOW. -@interval: the time between calls to the function, in milliseconds (1/1000ths -of a second.) -@function: the function to call at each interval. -@data: data to pass to @function (and @notify). -@notify: the function to call when the timeout is destroyed, or NULL. -@Returns: the id of event source. +@context: +@may_block: +@Returns: - + -Specifies the type of function passed to g_timeout_add(), g_timeout_add_full(), -g_idle_add(), and g_idle_add_full(). +Runs a single iteration for the default #GMainContext. +A compatibility macro, see g_main_context_iteration(). -@data: data passed to the function, set when the source was created with one -of the above functions. -@Returns: it should return FALSE if the source should be removed. +@may_block: set to TRUE if it should block (i.e. wait) until an event source +becomes ready. It will return after an event source has been processed. +If set to FALSE it will return immediately if no event source is ready to be +processed. +@Returns: TRUE if more events are pending. - + -Adds a function to be called whenever there are no higher priority events -pending. The function is given the default idle priority, -#G_PRIORITY_DEFAULT_IDLE. -If the function returns FALSE it is automatically removed from the list of -event sources and will not be called again. + -@function: the function to call. -@data: data to pass to the function. -@Returns: the id of the event source. +@context: +@Returns: - + -Adds a function to be called whenever there are no higher priority events -pending. -If the function returns FALSE it is automatically removed from the list of -event sources and will not be called again. +Checks if any events are pending for the default #GMainContext +(i.e. ready to be processed). A compatibility macro, see +g_main_context_pending(). -@priority: the priority of the idle function, which should be somewhere around -#G_PRIORITY_DEFAULT_IDLE and #G_PRIORITY_HIGH_IDLE. -@function: the function to call. -@data: data to pass to the function. -@destroy: the function to call when the timeout is destroyed, or NULL. -@Returns: the id of the event source. +@Returns: %TRUE if any events are pending. - + -Removes the idle function with the given data. + -@data: the data which is passed to the idle function. -@Returns: TRUE if the idle function was found. +@context: +@id: +@Returns: - + -Adds a file descriptor to be polled. -This is usually combined with g_source_add() to add an event source. -The event source's check function will typically test the revents -field in the #GPollFD struct and return TRUE if events need to be processed. + -@fd: a #GPollFD, which is a file descriptor together with a bitwise -combination of #GIOCondition flags determining which events to poll for. -@priority: the priority of the poll, which should be the same as the priority -used for g_source_add() to ensure that the file descriptor is polled whenever -the results may be needed. -See #G_PRIORITY_DEFAULT, #G_PRIORITY_DEFAULT_IDLE, #G_PRIORITY_HIGH, -#G_PRIORITY_HIGH_IDLE, and #G_PRIORITY_LOW. +@context: +@user_data: +@Returns: - + - - - + - -#gint fd; -the file descriptor to poll (or a HANDLE on Win32 platforms). - +@context: +@funcs: +@user_data: +@Returns: + +@source_data: - -#gushort events; -a bitwise combination of flags from #GIOCondition, specifying which -events should be polled for. Typically for reading from a file descriptor -you would use %G_IO_IN | %G_IO_HUP | %G_IO_ERR, and for writing you would use -%G_IO_OUT | %G_IO_ERR. - - - -#gushort revents; -a bitwise combination of flags from #GIOCondition, returned from the -poll() function to indicate which events occurred. - - - + + -@fd: -@events: -@revents: +@context: +@priority: +@Returns: - + + -Removes a file descriptor from the list being polled. + -@fd: the #GPollFD to remove. +@context: +@max_priority: +@timeout: +@fds: +@n_fds: +@Returns: - + -Sets the function to use to handle polling of file descriptors. -It will be used instead of the poll() system call -(or GLib's replacement function, which is used where -poll() isn't available). + + +@context: +@max_priority: +@fds: +@n_fds: +@Returns: + + + -This function could possibly be used to integrate the GLib event loop -with an external event loop. + -@func: the function to call to poll all file descriptors. +@context: + + + + + - +@context: +@func: + + + +@context: @Returns: @@ -364,25 +412,148 @@ The semantics of the function should match those of the @ufds: an array of #GPollFD elements. @nfsd: the number of elements in @ufds. @timeout: the maximum time to wait for an event of the file descriptors. + A negative value indicates an infinite timeout. @Returns: the number of #GPollFD elements which have events or errors reported, or -1 if an error occurred. - + + + + + +@context: +@fd: +@priority: + + + + + + + +@context: +@fd: + + + + +Sets the function to use for the handle polling of file descriptors +for the default main context. This is a compatability macro, see +g_main_context_set_poll_func() for full details. + + +@func: the function to call to poll all file descriptors. + + + + + + + +@interval: +@Returns: + + + + + + +@interval: +@function: +@data: +@Returns: + + + + + + +@priority: +@interval: +@function: +@data: +@notify: +@Returns: + + + -Adds an event source to the main loop. + -@priority: the priority of the event source. See #G_PRIORITY_DEFAULT, -#G_PRIORITY_DEFAULT_IDLE, #G_PRIORITY_HIGH, #G_PRIORITY_HIGH_IDLE, and -#G_PRIORITY_LOW. -@can_recurse: if it is safe to call the source functions recursively. -@funcs: the functions to handle the source. -@source_data: data specific to the type of event source. -@user_data: user data which will be passed to the user function handling the -source. -@notify: the function to call when the source is destroyed. -@Returns: the id of the event source. +@Returns: + + + + + + +@function: +@data: +@Returns: + + + + + + +@priority: +@function: +@data: +@notify: +@Returns: + +@destroy: + + + + + + +@data: +@Returns: + + + + + + + + + + +#gint fd; +the file descriptor to poll (or a HANDLE on Win32 platforms). + + + +#gushort events; +a bitwise combination of flags from #GIOCondition, specifying which +events should be polled for. Typically for reading from a file descriptor +you would use %G_IO_IN | %G_IO_HUP | %G_IO_ERR, and for writing you would use +%G_IO_OUT | %G_IO_ERR. + + + + +#gushort revents; +a bitwise combination of flags from #GIOCondition, returned from the +poll() function to indicate which events occurred. + + + + + + +@fd: +@events: +@revents: + + + + + @@ -399,7 +570,7 @@ event sources in a generic manner. Called before all the file descriptors are polled. If the source can determine that it is ready here (without waiting for the -results of the poll() call) it should return TRUE. +results of the poll() call) it should return %TRUE. It can also return a @timeout value which should be the maximum timeout (in milliseconds) which should be passed to the poll() call. The actual timeout used will be -1 if all sources returned -1, or it will @@ -411,7 +582,7 @@ be the minimum of all the @timeout values returned which were >= 0. check Called after all the file descriptors are polled. -The source should return TRUE if it is ready to be processed. +The source should return %TRUE if it is ready to be dispatched. Note that some time may have passed since the previous prepare function was called, so the source should be checked again here. @@ -420,16 +591,19 @@ called, so the source should be checked again here. dispatch -Called to process the event source, after it has returned TRUE in either -its @prepare or its @check function. +Called to dispatch the event source, after it has returned %TRUE in +either its @prepare or its @check function. The @dispatch function is +passed in a callback function and data. The callback function may be +%NULL if the source was never connected using g_source_connect(). The +@dispatch function should call the callback function with data and +whatever additional parameters are needed for this type of event source. destroy -Called when the source is destroyed. It will be called with the user data -parameter passed to the g_source_add() and related functions. +Called when the source is destroyed. @@ -462,57 +636,202 @@ the required condition has been met, and returns TRUE if so. @dispatch: @destroy: - + -Removes the event source with the given id. -The id is returned when the source is created, either directly with -g_source_add(), or indirectly with g_idle_add(), g_idle_add_full(), -g_timeout_add() and g_timeout_add_full(). + -@tag: the id of the event source to remove. -@Returns: TRUE if the source was found and removed. +@ref: +@unref: +@get: + + - + + +@source_funcs: +@struct_size: +@Returns: + + + + + + + +@source: +@Returns: + + + -Removes the first event source found with the given #GSourceFuncs and user -data. + + +@source: + + + -Event sources are sorted with the highest priority first. Sources with equal -priority are stored in the order in which they were added. -@funcs: the #GSourceFuncs of the source to remove. -@user_data: the user data of the source to remove. -@Returns: TRUE if an event source was found and removed. +@source: +@context: +@Returns: - + -Removes the first event source found with the given source data. + + +@source: + + + -Event sources are sorted with the highest priority first. Sources with equal -priority are stored in the order in which they were added. + -@source_data: the source data, which contains information specific to the -type of source. -@Returns: TRUE if an event source was found and removed. +@source: +@priority: - + -Removes the first event source found with the given user data. + + +@source: +@Returns: + + + -Event sources are sorted with the highest priority first. Sources with equal -priority are stored in the order in which they were added. + -@user_data: the user data of the source to remove. -@Returns: TRUE if an event source was found and removed. +@source: +@can_recurse: + + + + + + + +@source: +@Returns: + + + + + + + +@source: +@Returns: + + + + + + + +@source: +@Returns: + + + + + + + +@source: +@func: +@data: +@notify: + + + + +Specifies the type of function passed to g_timeout_add(), g_timeout_add_full(), +g_idle_add(), and g_idle_add_full(). + + +@data: data passed to the function, set when the source was created with one +of the above functions. +@Returns: it should return FALSE if the source should be removed. + + + + + + + +@source: +@callback_data: +@callback_funcs: + + + + + + + +@source: +@fd: + + + + + + + +@source: +@fd: + + + + + + + +@source: +@timeval: + + + + + + +@tag: +@Returns: + + + + + + +@funcs: +@user_data: +@Returns: + + + + + + +@user_data: +@Returns: + + + diff --git a/docs/reference/glib/tmpl/trees-binary.sgml b/docs/reference/glib/tmpl/trees-binary.sgml index 104c66a..11ab995 100644 --- a/docs/reference/glib/tmpl/trees-binary.sgml +++ b/docs/reference/glib/tmpl/trees-binary.sgml @@ -61,6 +61,16 @@ second. @Returns: a new #GTree. + + + + + +@key_compare_func: +@user_data: +@Returns: + + Inserts a key/value pair into a #GTree. diff --git a/docs/reference/gobject/tmpl/gobject-unused.sgml b/docs/reference/gobject/tmpl/gobject-unused.sgml index ba06d96..0cedc32 100644 --- a/docs/reference/gobject/tmpl/gobject-unused.sgml +++ b/docs/reference/gobject/tmpl/gobject-unused.sgml @@ -1,33 +1,36 @@ - + - + @plugin: - + -@G_SIGNAL_RUN_FIRST: -@G_SIGNAL_RUN_LAST: -@G_SIGNAL_RUN_CLEANUP: -@G_SIGNAL_NO_RECURSE: -@G_SIGNAL_ACTION: -@G_SIGNAL_NO_HOOKS: +@itype: - + + + + + +@plugin_ref: +@plugin_unref: +@complete_type_info: +@complete_interface_info: @@ -41,59 +44,60 @@ @after: @Returns: - -gtypemodule.sgml - - - + -@plugin: +@G_SIGNAL_RUN_FIRST: +@G_SIGNAL_RUN_LAST: +@G_SIGNAL_RUN_CLEANUP: +@G_SIGNAL_NO_RECURSE: +@G_SIGNAL_ACTION: +@G_SIGNAL_NO_HOOKS: - + -@instance: +@plugin: +@g_type: +@info: +@value_table: - + -@type: -@flags: -@Returns: - + @plugin: -@g_type: -@info: -@value_table: - + -@itype: +@instance: - + -@plugin_ref: -@plugin_unref: -@complete_type_info: -@complete_interface_info: +@type: +@flags: +@Returns: + + +gtypemodule.sgml + @@ -105,7 +109,3 @@ gtypemodule.sgml @instance_type: @info: - - - - -- 2.7.4