/usr/lib/perl5/Tk/Mwm.pod is in perl-tk 1:804.031-1build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 | =head1 NAME
Tk::Mwm - Communicate with the Motif(tm) window manager.
=for category Tix Extensions
=head1 SYNOPSIS
S< >B<use Tk::Mwm;>
S< >I<$toplevel>-E<gt>B<mwm>I<Option>?(I<args>)?
S< >I<$toplevel>-E<gt>B<mwm>(I<option> ?,I<args>?)
=head1 DESCRIPTION
Interface to special extentions supported by mwm.
=head1 METHODS
=over 4
=item I<$toplevel>-E<gt>B<mwmDecoration>?(?option??=E<gt>value? ?,...?)?
When no options are given, this method returns the values of all the
decorations options for the toplevel window with the I<$toplevel>.
When only one option is given without specifying the value, the
current value of that option is returned.
When more than one "option-value" pairs are passed to this method,
the specified values will be assigned to the corresponding options. As
a result, the appearance of the Motif decorations around the toplevel
window will be changed.
Possible options are: B<-border>, B<-menu>, B<-maximize>,
B<-minimize>, B<-resizeh> and B<-title>. The value must be a
Boolean value. The values returned by this command are undefined when
the window is not managed by mwm.
=item I<$toplevel>-E<gt>B<mwmIsmwmrunning>
This returns value is true if mwm is running on the screen where the specified
window is located, false otherwise.
=item I<$toplevel>-E<gt>B<mwmProtocol>
When no additional options are given, this method returns all
protocols associated with this toplevel window.
=item I<$toplevel>-E<gt>B<mwmProtocol>(B<activate> =E<gt> I<protocol_name>)
Activate the mwm protocol message in mwm's menu.
=item I<$toplevel>-E<gt>B<MwmProtocol>(B<add> =E<gt> I<protocol_name>, I<menu_message>)
Add a new mwm protocol message for this toplevel window. The
message is identified by the string name specified in
I<protocol_name>. A menu item will be added into mwm's menu as
specified by I<menu_message>. Once a new mwm protocol message is
added to a toplevel, it can be caught by the TK B<protocol>
method. Here is an example:
S< >I<$toplevel>-E<gt>B<mwmProtocol>(B<'add'> =E<gt> 'MY_PRINT_HELLO', '"Print Hello" _H CtrlE<lt>KeyE<gt>H');
S< >I<$toplevel>-E<gt>B<protocol>(B<'MY_PRINT_HELLO'> =E<gt> sub {print "Hello"});
=item I<$toplevel>-E<gt>B<mwmProtocol>(B<'deactivate'> =E<gt> I<protocol_name>)
Deactivate the mwm protocol message in mwm's menu.
=item I<$toplevel>-E<gt>B<mwmProtocol>(B<'delete'> =E<gt> I<protocol_name>)
Delete the mwm protocol message from mwm's menu. Please note that the
window manager protocol handler associated with this protocol (by the
B<protocol> method) is not deleted automatically. You have to
delete the protocol handle explicitly. E.g.:
S< >I<$mw>-E<gt>B<mwmProtocol>(B<'delete'> =E<gt> 'MY_PRINT_HELLO');
S< >I<$mw>-E<gt>B<protocol>(B<'MY_PRINT_HELLO'> =E<gt> '');
=back
=head1 BUGS
This is a Tix extension which perl/Tk has adopted. It has not been
tested as perl/Tk's author has not got round to installing a Motif Window
Manager.
On some versions of mwm, the B<-border> will not disappear unless
B<-resizeh> is turned off. Also, the B<-title> will not disappear
unless all of B<-title>, B<-menu>, B<-maximize> and
B<-minimize> are turned off.
=head1 SEE ALSO
L<Tk::Wm|Tk::Wm>
L<Tk::tixWm|Tk::tixWm>
L<Tk::Toplevel|Tk::Toplevel>
=head1 KEYWORDS
window manager, mwm, TIX
=head1 AUTHOR
Ioi Kim Lam - ioi@graphics.cis.upenn.edu
=cut
|