comparison man/widget.texi @ 37448:a788be76cf22

widget-define => define-widget.

37447:0bc52782144f

@cindex widget library, files
@table @file
@item widget.el
This will declare the user variables, define the function
@code{widget-define}, and autoload the function @code{widget-create}. 
@item wid-edit.el
Everything else is here, there is no reason to load it explicitly, as
it will be autoloaded when needed.
@end table

@comment  node-name,  next,  previous,  up
@section Defining New Widgets
@cindex new widgets
@cindex defining new widgets

You can define specialized widgets with @code{widget-define}.  It allows
you to create a shorthand for more complex widgets, including specifying
component widgets and new default values for the keyword
arguments. 

@defun widget-define name class doc &rest args
Define a new widget type named @var{name} from @code{class}.

@var{name} and class should both be symbols, @code{class} should be one
of the existing widget types. 

@end lisp
@end itemize

@end defun

Using @code{widget-define} just stores the definition of the widget type
in the @code{widget-type} property of @var{name}, which is what
@code{widget-create} uses.

If you only want to specify defaults for keywords with no complex
conversions, you can use @code{identity} as your conversion function.

37448:a788be76cf22

@cindex widget library, files
@table @file
@item widget.el
This will declare the user variables, define the function
@code{define-widget}, and autoload the function @code{widget-create}. 
@item wid-edit.el
Everything else is here, there is no reason to load it explicitly, as
it will be autoloaded when needed.
@end table

@comment  node-name,  next,  previous,  up
@section Defining New Widgets
@cindex new widgets
@cindex defining new widgets

You can define specialized widgets with @code{define-widget}.  It allows
you to create a shorthand for more complex widgets, including specifying
component widgets and new default values for the keyword
arguments. 

@defun define-widget name class doc &rest args
Define a new widget type named @var{name} from @code{class}.

@var{name} and class should both be symbols, @code{class} should be one
of the existing widget types. 

@end lisp
@end itemize

@end defun

Using @code{define-widget} just stores the definition of the widget type
in the @code{widget-type} property of @var{name}, which is what
@code{widget-create} uses.

If you only want to specify defaults for keywords with no complex
conversions, you can use @code{identity} as your conversion function.