Signal argument names

[Damon Chaplin <damon kendo fsnet co uk>]

Hi,

I've just created a list of GTK+ signal argument names to use in Glade,
which I've attached here.

We may want to update gtk-doc to use these. Currently it uses names like
'arg1' in quite a few places, which isn't very useful.

Maybe we could let modules provide a $MODULE.signal-arg-names.txt file
to specify these, rather than hard-code them in gtk-doc as we do at
present.

Damon

#
# This file contains descriptive names to use as the arguments for GTK+
# signal callbacks. GTK+ only provides the types of the arguments, not any
# human-readable name. We can provide reasonable names for simple arguments,
# e.g. for a GtkWidget* argument we can just use "widget", but for more
# specific arguments all we can do is output something like "arg1" which
# isn't very useful. Hence this list.
#
# Note that a few of these also include the type of the argument. This is
# used when the type returned from GTK+ isn't as specific as it could be,
# e.g. the last argument for the gtk_tree_model_rows_reordered() signal is
# given as a gpointer by GTK+, but is in fact a pointer to an array of gints.
#
# One signal is described on each line.
# The format is "<ObjectClassName>::<SignalName>" followed by whitespace.
# Then a comma-separated list of argument names (possibly with types).
#
# Note that we don't include the final parameter used for all signal
# callbacks, the "gpointer user_data" parameter.
#

GtkAccelGroup::accel-activate		accelgroup,object,key,modifier
GtkAccelGroup::accel-changed		accelgroup,key,modifier,closure
GtkCellRendererText::edited		cellrenderertext,path,new_text
GtkCellRendererToggle::toggled		cellrenderertoggle,path
GtkCList::click-column			clist,column
GtkCList::extend-selection		clist,scroll_type,position,auto_start_selection
GtkCList::resize-column			clist,column,width
GtkCList::row-move			clist,source_row,dest_row
GtkCList::scroll-horizontal		clist,scroll_type,position
GtkCList::scroll-vertical		clist,scroll_type,position
GtkCList::select-row			clist,row,column,event
GtkCList::set-scroll-adjustments	clist,hadjustment,vadjustment
GtkCList::unselect-row			clist,row,column,event
GtkCTree::change-focus-row-expansion	ctree,expansion
GtkCTree::tree-collapse			ctree,node
GtkCTree::tree-expand			ctree,node
GtkCTree::tree-move			ctree,node,new_parent,new_sibling
GtkCTree::tree-select-row		ctree,node,column
GtkCTree::tree-unselect-row		ctree,node,column
GtkDialog::response			dialog,response_id
GtkEditable::delete-text		editable,start_pos,end_pos
GtkEditable::insert-text		editable,new_text,new_text_length,position
GtkEntry::delete-from-cursor		entry,type,count
GtkEntry::insert-at-cursor		entry,string
GtkEntry::move-cursor			entry,step,count,extend_selection
GtkEntry::populate-popup		entry,menu
GtkInputDialog::disable-device		inputdialog,device
GtkInputDialog::enable-device		inputdialog,device
GtkIMContext::commit			imcontext,string
GtkIMContext::delete-surrounding	imcontext,offset,n_chars
GtkLabel::move-cursor			label,step,count,extend_selection
GtkLabel::populate-popup		label,menu
GtkLayout::set-scroll-adjustments	layout,hadjustment,vadjustment
GtkListItem::extend-selection		listitem,scroll_type,position,auto_start_selection
GtkListItem::scroll-horizontal		listitem,scroll_type,position
GtkListItem::scroll-vertical		listitem,scroll_type,position
GtkMenuItem::toggle-size-allocate	menuitem,allocation
GtkMenuItem::toggle-size-request	menuitem,gint *requisition
GtkMenuShell::activate-current		menushell,force_hide
GtkMenuShell::cycle-focus		menushell,direction
GtkMenuShell::move-current		menushell,direction
GtkNotebook::change-current-page	notebook,offset
GtkNotebook::focus-tab			notebook,type
GtkNotebook::move-focus-out		notebook,direction
GtkNotebook::select-page		notebook,move_focus
GtkNotebook::switch-page		notebook,GtkNotebookPage *page,page_num
GtkOldEditable::kill-char		oldeditable,direction
GtkOldEditable::kill-line		oldeditable,direction
GtkOldEditable::kill-word		oldeditable,direction
GtkOldEditable::move-cursor		oldeditable,x,y
GtkOldEditable::move-page		oldeditable,x,y
GtkOldEditable::move-to-column		oldeditable,column
GtkOldEditable::move-to-row		oldeditable,row
GtkOldEditable::move-word		oldeditable,offset
GtkOldEditable::set-editable		oldeditable,is_editable
GtkPaned::cycle-child-focus		paned,reverse
GtkPaned::cycle-handle-focus		paned,reverse
GtkPaned::move-handle			paned,scroll
GtkRange::adjust-bounds			range,value
GtkRange::move-slider			range,scroll
GtkScale::format-value			scale,value
GtkScrolledWindow::move-focus-out	scrolledwindow,direction
GtkScrolledWindow::scroll-child		scrolledwindow,scroll,horizontal
GtkSpinButton::change-value		spinbutton,scroll
GtkSpinButton::input			spinbutton,gdouble *new_value
GtkStatusbar::text-popped		statusbar,context_id,text
GtkStatusbar::text-pushed		statusbar,context_id,text
GtkTextBuffer::apply-tag		textbuffer,tag,start,end
GtkTextBuffer::delete-range		textbuffer,start,end
GtkTextBuffer::insert-child-anchor	textbuffer,iter,anchor
GtkTextBuffer::insert-pixbuf		textbuffer,iter,pixbuf
GtkTextBuffer::insert-text		textbuffer,iter,text,length
GtkTextBuffer::mark-deleted		textbuffer,mark
GtkTextBuffer::mark-set			textbuffer,iter,mark
GtkTextBuffer::remove-tag		textbuffer,tag,start,end
GtkText::set-scroll-adjustments		text,hadjustment,vadjustment
GtkTextTag::event			texttag,object,event,iter
GtkTextTagTable::tag-added		texttagtable,tag
GtkTextTagTable::tag-changed		texttagtable,tag,size_changed
GtkTextTagTable::tag-removed		texttagtable,tag
GtkTextView::delete-from-cursor		textview,type,count
GtkTextView::insert-at-cursor		textview,string
GtkTextView::move-cursor		textview,step,count,extend_selection
GtkTextView::move-focus			textview,direction
GtkTextView::page-horizontally		textview,count,extend_selection
GtkTextView::populate-popup		textview,menu
GtkTextView::set-scroll-adjustments	textview,hadjustment,vadjustment
GtkTipsQuery::widget-entered		tipsquery,widget,tip_text,tip_private
GtkTipsQuery::widget-selected		tipsquery,widget,tip_text,tip_private,event
GtkToolbar::orientation-changed		toolbar,orientation
GtkToolbar::style-changed		toolbar,style
GtkTreeModel::row-changed		treemodel,path,iter
GtkTreeModel::row-deleted		treemodel,path
GtkTreeModel::row-has-child-toggled	treemodel,path,iter
GtkTreeModel::row-inserted		treemodel,path,iter
GtkTreeModel::rows-reordered		treemodel,path,iter,gint *new_order
GtkTreeView::expand-collapse-cursor-row	treeview,logical,expand,open_all
GtkTreeView::move-cursor		treeview,step,count
GtkTreeView::row-activated		treeview,path,column
GtkTreeView::row-collapsed		treeview,iter,path
GtkTreeView::row-expanded		treeview,iter,path
GtkTreeView::select-cursor-row		treeview,start_editing
GtkTreeView::set-scroll-adjustments	treeview,hadjustment,vadjustment
GtkTreeView::test-collapse-row		treeview,iter,path
GtkTreeView::test-expand-row		treeview,iter,path
GtkViewport::set-scroll-adjustments	viewport,hadjustment,vadjustment
GtkWidget::child-notify			widget,pspec
GtkWidget::direction-changed		widget,old_direction
GtkWidget::drag-begin			widget,drag_context
GtkWidget::drag-data-delete		widget,drag_context
GtkWidget::drag-data-get		widget,drag_context,data,info,time
GtkWidget::drag-data-received		widget,drag_context,x,y,data,info,time
GtkWidget::drag-drop			widget,drag_context,x,y,time
GtkWidget::drag-end			widget,drag_context
GtkWidget::drag-leave			widget,drag_context,time
GtkWidget::drag-motion			widget,drag_context,x,y,time
GtkWidget::focus			widget,direction
GtkWidget::grab-notify			widget,was_grabbed
GtkWidget::mnemonic-activate		widget,group_cycling
GtkWidget::parent-set			widget,old_parent
GtkWidget::selection-get		widget,data,info,time
GtkWidget::selection-received		widget,data,time
GtkWidget::show-help			widget,help_type
GtkWidget::size-allocate		widget,allocation
GtkWidget::size-request			widget,requisition
GtkWidget::state-changed		widget,state
GtkWidget::style-set			widget,previous_style
GtkWindow::move-focus			window,direction