=for comment based on iup-3.5 - http://www.tecgraf.puc-rio.br/iup/en/elem/iupuser.html

=head1 NAME

IUP::User - [special] user element which is not associated to any interface element

=head1 DESCRIPTION

Creates a user element in IUP, which is not associated to any interface
element. It is used to map an external element to a IUP element. Its
use is usually done by CPI elements, but you can use it to create an
Ihandle* to store private attributes.

=head1 USAGE

=head2 CREATION - new() method

 $user = IUP::User->new();

B<Returns:> the identifier of the created element, or C<undef> if an error occurs.

NOTE: You can pass to C<new()> other C<ATTRIBUTE=E<gt>'value'> or C<CALLBACKNAME=E<gt>\&func> pairs relevant
to this element - see L<IUP::Manual::02_Elements|IUP::Manual::02_Elements/"new()">.

=head2 ATTRIBUTES

=over

=item B<CLEARATTRIBUTES>

I<(write-only, non inheritable)> It will clear all attributes stored internally and remove all references. 

=back

=head1 EXAMPLES


The element B<IUP::User> is used in the following sample scripts:

=over

=item * L<0-basic/text_format.pl|https://metacpan.org/source/KMX/IUP-0.303/examples/0-basic/text_format.pl> - IUP::Text (formating) example

=back 



=head1 SEE ALSO

The original doc: L<iupuser.html|http://www.tecgraf.puc-rio.br/iup/en/elem/iupuser.html>
 

=cut