added API docs for the less obvious functions. Gracefully handle attempts

2003-11-11  Sven Neumann  <sven@gimp.org>

	* app/display/gimpcanvas.c: added API docs for the less obvious
	functions. Gracefully handle attempts to draw on the unrealized
	widget.

	* app/display/gimpdisplayshell-selection.c (selection_draw):
	removed the redundant check for a realized canvas widget.

Also updated API docs.
This commit is contained in:
Sven Neumann
2003-11-11 21:35:50 +00:00
committed by Sven Neumann
parent ed0a346861
commit b219ccb394
12 changed files with 194 additions and 85 deletions

View File

@ -1,3 +1,16 @@
2003-11-11 Sven Neumann <sven@gimp.org>
* app/Makefile.am (IGNORE_HFILES): removed
gimpdisplayshell-marching-ants.h.
* app/app-sections.txt
* libgimp/libgimp-sections.txt
* libgimp/tmpl/gimpgimprc.sgml
* libgimpwidgets/libgimpwidgets-sections.txt
* libgimpwidgets/tmpl/gimpcolorbutton.sgml
* libgimpwidgets/tmpl/gimpdialog.sgml
* libgimpwidgets/tmpl/gimpstock.sgml: updated.
2003-11-11 Sven Neumann <sven@gimp.org>
* app/app-docs.sgml

View File

@ -27,20 +27,19 @@ CFILE_GLOB = $(DOC_SOURCE_DIR)/*.c
# Header files to ignore when scanning
IGNORE_HFILES = \
gimp-composite-dispatch.h \
gimp-composite-regression.h \
gimp-composite-altivec.h \
gimp-composite-3dnow.h \
gimp-composite-mmx.h \
gimp-composite-sse.h \
gimp-composite-sse2.h \
gimp-composite-vis.h \
gimp-composite-x86.h \
gimpimage-convert-data.h \
gimpimage-convert-fsdither.h \
gimphelp-ids.h \
gimprc-blurbs.h \
gimpdisplayshell-marching-ants.h \
gimp-composite-dispatch.h \
gimp-composite-regression.h \
gimp-composite-altivec.h \
gimp-composite-3dnow.h \
gimp-composite-mmx.h \
gimp-composite-sse.h \
gimp-composite-sse2.h \
gimp-composite-vis.h \
gimp-composite-x86.h \
gimpimage-convert-data.h \
gimpimage-convert-fsdither.h \
gimphelp-ids.h \
gimprc-blurbs.h \
paint-funcs-generic.h
# Images to copy into HTML directory

View File

@ -1356,9 +1356,11 @@ GIMP_VIEWABLE_GET_CLASS
<TITLE>GimpCanvas</TITLE>
GimpCanvas
GimpCanvasStyle
GIMP_CANVAS_NUM_STIPPLES
gimp_canvas_new
gimp_canvas_draw_cursor
gimp_canvas_draw_point
gimp_canvas_draw_points
gimp_canvas_draw_line
gimp_canvas_draw_lines
gimp_canvas_draw_rectangle
@ -1367,8 +1369,10 @@ gimp_canvas_draw_polygon
gimp_canvas_draw_segments
gimp_canvas_draw_rgb
gimp_canvas_set_clip_rect
gimp_canvas_set_bg_color
gimp_canvas_set_clip_region
gimp_canvas_set_custom_gc
gimp_canvas_set_stipple_index
gimp_canvas_set_bg_color
<SUBSECTION Standard>
GimpCanvasClass
GIMP_CANVAS
@ -1641,7 +1645,7 @@ gimp_display_shell_scroll_clamp_offsets
<FILE>gimpdisplayshell-selection</FILE>
<TITLE>GimpDisplayShell-selection</TITLE>
Selection
gimp_display_shell_selection_create
gimp_display_shell_selection_new
gimp_display_shell_selection_free
gimp_display_shell_selection_pause
gimp_display_shell_selection_resume

View File

@ -267,7 +267,9 @@ gimp_fonts_set_popup
gimp_gimprc_query
gimp_gimprc_set
gimp_get_default_comment
gimp_get_module_load_inhibit
gimp_get_monitor_resolution
gimp_get_theme_dir
</SECTION>
<SECTION>

View File

@ -42,6 +42,14 @@ Interactions with settings from .gimprc.
@Returns:
<!-- ##### FUNCTION gimp_get_module_load_inhibit ##### -->
<para>
</para>
@Returns:
<!-- ##### FUNCTION gimp_get_monitor_resolution ##### -->
<para>
@ -52,3 +60,11 @@ Interactions with settings from .gimprc.
@Returns:
<!-- ##### FUNCTION gimp_get_theme_dir ##### -->
<para>
</para>
@Returns:

View File

@ -46,6 +46,8 @@ GimpColorButton
gimp_color_button_new
gimp_color_button_set_color
gimp_color_button_get_color
gimp_color_button_set_update
gimp_color_button_get_update
gimp_color_button_has_alpha
gimp_color_button_set_type
<SUBSECTION Standard>
@ -268,6 +270,7 @@ GimpDialog
gimp_dialog_new
gimp_dialog_new_valist
gimp_dialog_add_buttons_valist
gimp_dialog_run
<SUBSECTION Standard>
GIMP_TYPE_DIALOG
GIMP_DIALOG
@ -319,6 +322,7 @@ GIMP_STOCK_RESET
GIMP_STOCK_CLOSE
GIMP_STOCK_MENU_LEFT
GIMP_STOCK_MENU_RIGHT
GIMP_STOCK_MOVE_TO_SCREEN
GIMP_STOCK_INVERT
GIMP_STOCK_LAYER_TO_IMAGESIZE
GIMP_STOCK_MERGE_DOWN

View File

@ -64,6 +64,24 @@ color, the "color_changed" signal is emitted.
@gcb:
<!-- ##### FUNCTION gimp_color_button_set_update ##### -->
<para>
</para>
@button:
@continuous:
<!-- ##### FUNCTION gimp_color_button_get_update ##### -->
<para>
</para>
@button:
@Returns:
<!-- ##### FUNCTION gimp_color_button_has_alpha ##### -->
<para>

View File

@ -67,3 +67,12 @@ dialog-related stuff.
@args:
<!-- ##### FUNCTION gimp_dialog_run ##### -->
<para>
</para>
@dialog:
@Returns:

View File

@ -73,6 +73,14 @@ the ones in dialog size).
<!-- ##### MACRO GIMP_STOCK_MOVE_TO_SCREEN ##### -->
<para>
<inlinegraphic fileref="stock-move-to-screen-24.png" format="png"></inlinegraphic>
<inlinegraphic fileref="stock-move-to-screen-16.png" format="png"></inlinegraphic>
</para>
<!-- ##### MACRO GIMP_STOCK_INVERT ##### -->
<para>
<inlinegraphic fileref="stock-invert-16.png" format="png"></inlinegraphic>