stars here. It's probably best to group changes under the same section layout
as the main perldelta
-=item Obituary
+=head1 Obituary
XXX If any significant core contributor has died, we've added a short obituary
here.
=begin _private
+=over
+
=item _chmod($$;$)
Wrapper to chmod() for debugging and error trapping.
Dies with a special message.
+=back
+
=end _private
=cut
=begin _private
+=over
+
=item _move_file_at_boot( $file, $target, $moan )
OS-Specific, Win32/Cygwin
=begin _private
+
=item _unlink_or_rename( $file, $tryhard, $installing )
OS-Specific, Win32/Cygwin
use it to install under. In all other cases of success returns $file.
On failure throws a fatal error.
+=back
+
=end _private
=cut
=begin _private
+=over
+
=item _get_install_skip
Handles loading the INSTALL.SKIP file. Returns an array of patterns to use.
=end _private
-=over 4
-
=item B<install>
# deprecated forms
=begin _undocumented
+=over
+
=item mkfh()
Make a filehandle. Same kind of idea as Symbol::gensym().
=end _undocumented
+=back
+
=cut
sub __find_relocations
C<linenoise>, C<debug>, C<env>, into effect. It also accepts style
names previously defined with add_style().
-=head2 add_style()
+=head2 add_style ()
This subroutine accepts a new style name and three style arguments as
above, and creates, registers, and selects the newly named style. It is
an error to re-add a style; call set_style_standard() to switch between
several styles.
-=head2 add_callback()
+=head2 add_callback ()
If your newly minted styles refer to any new #variables, you'll need
to define a callback subroutine that will populate (or modify) those
part of the MRO of a class, even though all classes implicitly inherit
methods from C<UNIVERSAL> and its parents.
-=head2 mro::set_mro($classname, $type)
+=head2 mro::set_mro ($classname, $type)
Sets the MRO of the given class to the C<$type> argument (either
C<c3> or C<dfs>).
=back
-=head2 The Pugs prototype Perl 6 Object Model uses C3
+=head2 Pugs
-=head2 Parrot now uses C3
+The Pugs prototype Perl 6 Object Model uses C3
+
+=head2 Parrot
+
+Parrot now uses C3
=over 4
This would make C<Carp> report the error as coming from a caller not
in C<My::Carping::Package>, nor from C<My::Friendly::Caller>.
-Also read the L</"Description"> section above, about how C<Carp> decides
+Also read the L</DESCRIPTION> section above, about how C<Carp> decides
where the error is reported from.
Use C<@CARP_NOT>, instead of C<$Carp::CarpLevel>.
=over 4
-=item * Decimal Versions
+=item Decimal Versions
Any version which "looks like a number", see L<Decimal Versions>. This
also includes versions with a single decimal point and a single embedded
underscore, see L<Decimal Alpha Versions>, even though these must be quoted
to preserve the underscore formatting.
-=item * Dotted-Decimal Versions
+=item Dotted-Decimal Versions
Also referred to as "Dotted-Integer", these contains more than one decimal
point and may have an optional embedded underscore, see L<Dotted-Decimal
=over 4
-=item * New Operator
+=item New Operator
Like all OO interfaces, the new() operator is used to initialize
version objects. One way to increment versions when programming is to
=over 4
-=item * qv()
+=item qv()
An alternate way to create a new version object is through the exported
qv() sub. This is not strictly like other q? operators (like qq, qw),
=over 4
-=item * Normal Form
+=item Normal Form
For any version object which is initialized with multiple decimal
places (either quoted or if possible v-string), or initialized using
=over 4
-=item * Numification
+=item Numification
Although all mathematical operations on version objects are forbidden
by default, it is possible to retrieve a number which corresponds
=over 4
-=item * Stringification
+=item Stringification
The default stringification for version objects returns exactly the same
string as was used to create it, whether you used C<new()> or C<qv()>,
=over 4
-=item * Comparison operators
+=item Comparison operators
Both C<cmp> and C<E<lt>=E<gt>> operators perform the same comparison between
terms (upgrading to a version object automatically). Perl automatically
=over 4
-=item * Logical Operators
+=item Logical Operators
If you need to test whether a version object
has been initialized, you can simply test it directly:
=over
-=item
+=item *
Title of the process (in the C<Ctrl-Esc> list);
-=item
+=item *
window handle of switch entry of the process (in the C<Ctrl-Esc> list);
-=item
+=item *
window handle of the icon of the process;
-=item
+=item *
process handle of the owner of the entry in C<Ctrl-Esc> list;
-=item
+=item *
process id of the owner of the entry in C<Ctrl-Esc> list;
-=item
+=item *
session id of the owner of the entry in C<Ctrl-Esc> list;
-=item
+=item *
whether visible in C<Ctrl-Esc> list;
-=item
+=item *
whether item cannot be switched to (note that it is not actually
grayed in the C<Ctrl-Esc> list));
-=item
+=item *
whether participates in jump sequence;
-=item
+=item *
program type. Possible values are:
session. Likewise, if it's a full-screen WIN-OS/2 program, it runs in
a PROG_VDM session.
-=item
+=item *
switch-entry handle.
In such a case the process needs to be a PM process, or to be morphed
to a PM process via OS2::MorphPM().
-For a temporary morphing to PM use L<OS2::localMorphPM class>.
+For a temporary morphing to PM use the L<OS2::localMorphPM> class.
Keep in mind that PM windows are engaged in 2 "orthogonal" window
trees, as well as in the z-order list.
Use class C<OS2::localClipbrd> to ensure that clipboard is closed even if
the code in the block made a non-local exit.
-See L<"OS2::localMorphPM and OS2::localClipbrd classes">.
+See the L<OS2::localMorphPM> and L<OS2::localClipbrd> classes.
=head2 Control of the PM atom tables
may also provide some performance advantages, since the value of the
constant is cached.
-=head1 OS2::localMorphPM, OS2::localFlashWindow, and OS2::localClipbrd classes
+=head1 L<OS2::localMorphPM>, OS2::localFlashWindow, and OS2::localClipbrd classes
The class C<OS2::localMorphPM> morphs the process to PM for the duration of
the given scope.
}
C<OS2::localFlashWindow> behaves similarly; see
-L<"FlashWindow($hwnd,$doFlash)">.
+L<FlashWindow($hwnd, $doFlash)>.
=head1 EXAMPLES
=head1 DESCRIPTION
-=head2 Create a DLL handle
+=head2 L<Create a DLL handle>
$dll = OS2::DLL->module( NAME [, WHERE] );
$dll = OS2::DLL->new( NAME [, WHERE] );
-Same as L<C<module>|Create a DLL handle>, but in addition to WHERE, looks
+Same as C<module>|L<Create a DLL handle>, but in addition to WHERE, looks
in environment paths PERL5REXX, PERLREXX, PATH (provided for backward
compatibility).
$dll = load OS2::DLL NAME [, WHERE];
-Same as L<C<new>|Create a DLL handle (looking in some strange locations)>,
+Same as C<new>|L<Create a DLL handle (looking in some strange locations)>,
but returns DLL object reference, or undef on failure (in this case one can
get the reason via C<DynaLoader::dl_error()>) (provided for backward
compatibility).
=head1 Notice
+XXX Notice
=head1 Incompatible Changes
stars here. It's probably best to group changes under the same section layout
as the main perldelta
-=item Obituary
+
+=head1 Obituary
XXX If any significant core contributor has died, we've added a short obituary
here.
=back
-=back
-
=head2 Guidelines for Converting Perl 4 Library Scripts into Modules
=over 4
=back
+=back
+
=head1 NOTE
Perl does not enforce private and public parts of its modules as you may
matches zero, one, any alphabetic character, and the percent sign.
+=over 4
+
=item C<$>
Currency symbol
Modifier symbols (accents)
-=back
=back
projects / p5sagit/p5-mst-13.2.git / commitdiff