From: Rafael Garcia-Suarez
Date: Tue, 9 Oct 2007 13:06:26 +0000 (+0000)
Subject: Add a rough, incomplete version of perl5100delta
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=cf6c151c4d1b7ed05e154d608f547018d54674bc;p=p5sagit%2Fp5-mst-13.2.git
Add a rough, incomplete version of perl5100delta
p4raw-id: //depot/perl@32080
---
diff --git a/MANIFEST b/MANIFEST
index 3128cba..7a48bee 100644
--- a/MANIFEST
+++ b/MANIFEST
@@ -3082,6 +3082,7 @@ pod.lst List the pods and their roles
pod/Makefile.SH generate Makefile which makes pods into something else
pod/perl5004delta.pod Perl changes in version 5.004
pod/perl5005delta.pod Perl changes in version 5.005
+pod/perl5100delta.pod Perl changes in version 5.10.0
pod/perl561delta.pod Perl changes in version 5.6.1
pod/perl56delta.pod Perl changes in version 5.6
pod/perl570delta.pod Perl changes in version 5.7.0
diff --git a/Makefile.SH b/Makefile.SH
index a26e753..9dfd1b0 100644
--- a/Makefile.SH
+++ b/Makefile.SH
@@ -883,7 +883,7 @@ extra.pods: miniperl$(EXE_EXT)
-@rm -f pod/perlvms.pod
-@test -f vms/perlvms.pod && cd pod && $(LNS) ../vms/perlvms.pod perlvms.pod && cd .. && echo "pod/perlvms.pod" >> extra.pods
-@rm -f pod/perldelta.pod
- -@test -f pod/perl595delta.pod && cd pod && $(LNS) perl595delta.pod perldelta.pod && cd .. && echo "pod/perldelta.pod" >> extra.pods # See buildtoc
+ -@test -f pod/perl5100delta.pod && cd pod && $(LNS) perl5100delta.pod perldelta.pod && cd .. && echo "pod/perldelta.pod" >> extra.pods # See buildtoc
extras.make: perl$(EXE_EXT)
-@test ! -s extras.lst || PATH="`pwd`:${PATH}" PERL5LIB="`pwd`/lib" $(LDLIBPTH) $(RUN) ./perl -Ilib -MCPAN -e '@ARGV&&make(@ARGV)' `cat extras.lst`
diff --git a/pod.lst b/pod.lst
index a12d3a6..0134d92 100644
--- a/pod.lst
+++ b/pod.lst
@@ -130,7 +130,8 @@ h Miscellaneous
perlhist Perl history records
d perldelta Perl changes since previous version
-D perl595delta Perl changes in version 5.9.5
+D perl5100delta Perl changes in version 5.10.0
+ perl595delta Perl changes in version 5.9.5
perl594delta Perl changes in version 5.9.4
perl593delta Perl changes in version 5.9.3
perl592delta Perl changes in version 5.9.2
diff --git a/pod/perl.pod b/pod/perl.pod
index 80768fa..ce8f298 100644
--- a/pod/perl.pod
+++ b/pod/perl.pod
@@ -146,6 +146,7 @@ For ease of access, the Perl manual has been split up into several sections.
perlhist Perl history records
perldelta Perl changes since previous version
+ perl595delta Perl changes in version 5.9.5
perl594delta Perl changes in version 5.9.4
perl593delta Perl changes in version 5.9.3
perl592delta Perl changes in version 5.9.2
diff --git a/pod/perl5100delta.pod b/pod/perl5100delta.pod
new file mode 100644
index 0000000..6b3db37
--- /dev/null
+++ b/pod/perl5100delta.pod
@@ -0,0 +1,611 @@
+TODO: perl591delta and further
+
+=head1 NAME
+
+perldelta - what is new for perl 5.10.0
+
+=head1 DESCRIPTION
+
+This document describes the differences between the 5.8.8 release and
+the 5.10.0 release.
+
+Many of the bug fixes in 5.10.0 were already seen in the 5.8.X maintenance
+releases; they are not duplicated here and are documented in the set of
+man pages named perl58[1-8]?delta.
+
+=head1 Incompatible Changes
+
+=head2 Packing and UTF-8 strings
+
+=for XXX update this
+
+The semantics of pack() and unpack() regarding UTF-8-encoded data has been
+changed. Processing is now by default character per character instead of
+byte per byte on the underlying encoding. Notably, code that used things
+like C to see through the encoding of string will now
+simply get back the original $string. Packed strings can also get upgraded
+during processing when you store upgraded characters. You can get the old
+behaviour by using C
-X X
+X X, g and c X X
=item Regular Expressions
@@ -2926,7 +2925,7 @@ C<(?(condition)yes-pattern|no-pattern)>
=item PCRE/Python Support
-C<< (?PENAMEEpattern) >>, C<< (?P=NAME) >>, C<< (?P>NAME) >>
+C<< (?Ppattern) >>, C<< (?P=NAME) >>, C<< (?P>NAME) >>
=item BUGS
@@ -4265,31 +4264,32 @@ AnyDBM_File, Archive::Extract, Archive::Tar, Archive::Tar::File,
Attribute::Handlers, AutoLoader, AutoSplit, B, B::Concise, B::Debug,
B::Deparse, B::Lint, B::Showlex, B::Terse, B::Xref, Benchmark, CGI,
CGI::Apache, CGI::Carp, CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push,
-CGI::Switch, CGI::Util, CPAN, CPAN::FirstTime, CPAN::Kwalify, CPAN::Nox,
-CPAN::Version, CPANPLUS, CPANPLUS::Dist::Base, CPANPLUS::Dist::Sample,
-CPANPLUS::Shell::Classic, CPANPLUS::Shell::Default::Plugins::HOWTO, Carp,
-Carp::Heavy, Class::ISA, Class::Struct, Compress::Raw::Zlib,
-Compress::Zlib, Config, Cwd, DB, DBM_Filter, DBM_Filter::compress,
-DBM_Filter::encode, DBM_Filter::int32, DBM_Filter::null, DBM_Filter::utf8,
-DB_File, Data::Dumper, Devel::DProf, Devel::InnerPackage, Devel::Peek,
-Devel::SelfStubber, Digest, Digest::MD5, Digest::SHA, Digest::base,
-Digest::file, DirHandle, Dumpvalue, DynaLoader, Encode, Encode::Alias,
-Encode::Byte, Encode::CJKConstants, Encode::CN, Encode::CN::HZ,
-Encode::Config, Encode::EBCDIC, Encode::Encoder, Encode::Encoding,
-Encode::GSM0338, Encode::Guess, Encode::JP, Encode::JP::H2Z,
-Encode::JP::JIS7, Encode::KR, Encode::KR::2022_KR, Encode::MIME::Header,
-Encode::MIME::Name, Encode::PerlIO, Encode::Supported, Encode::Symbol,
-Encode::TW, Encode::Unicode, Encode::Unicode::UTF7, English, Env, Errno,
-Exporter, Exporter::Heavy, ExtUtils::CBuilder,
-ExtUtils::CBuilder::Platform::Windows, ExtUtils::Command,
-ExtUtils::Command::MM, ExtUtils::Constant, ExtUtils::Constant::Base,
-ExtUtils::Constant::Utils, ExtUtils::Constant::XS, ExtUtils::Embed,
-ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM,
-ExtUtils::MM_AIX, ExtUtils::MM_Any, ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin,
-ExtUtils::MM_DOS, ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2,
-ExtUtils::MM_QNX, ExtUtils::MM_UWIN, ExtUtils::MM_Unix, ExtUtils::MM_VMS,
-ExtUtils::MM_VOS, ExtUtils::MM_Win32, ExtUtils::MM_Win95, ExtUtils::MY,
-ExtUtils::MakeMaker, ExtUtils::MakeMaker::Config, ExtUtils::MakeMaker::FAQ,
+CGI::Switch, CGI::Util, CORE, CPAN, CPAN::API::HOWTO, CPAN::FirstTime,
+CPAN::Kwalify, CPAN::Nox, CPAN::Version, CPANPLUS, CPANPLUS::Dist::Base,
+CPANPLUS::Dist::Sample, CPANPLUS::Shell::Classic,
+CPANPLUS::Shell::Default::Plugins::HOWTO, Carp, Carp::Heavy, Class::ISA,
+Class::Struct, Compress::Raw::Zlib, Compress::Zlib, Config, Cwd, DB,
+DBM_Filter, DBM_Filter::compress, DBM_Filter::encode, DBM_Filter::int32,
+DBM_Filter::null, DBM_Filter::utf8, DB_File, Data::Dumper, Devel::DProf,
+Devel::InnerPackage, Devel::Peek, Devel::SelfStubber, Digest, Digest::MD5,
+Digest::SHA, Digest::base, Digest::file, DirHandle, Dumpvalue, DynaLoader,
+Encode, Encode::Alias, Encode::Byte, Encode::CJKConstants, Encode::CN,
+Encode::CN::HZ, Encode::Config, Encode::EBCDIC, Encode::Encoder,
+Encode::Encoding, Encode::GSM0338, Encode::Guess, Encode::JP,
+Encode::JP::H2Z, Encode::JP::JIS7, Encode::KR, Encode::KR::2022_KR,
+Encode::MIME::Header, Encode::MIME::Name, Encode::PerlIO,
+Encode::Supported, Encode::Symbol, Encode::TW, Encode::Unicode,
+Encode::Unicode::UTF7, English, Env, Errno, Exporter, Exporter::Heavy,
+ExtUtils::CBuilder, ExtUtils::CBuilder::Platform::Windows,
+ExtUtils::Command, ExtUtils::Command::MM, ExtUtils::Constant,
+ExtUtils::Constant::Base, ExtUtils::Constant::Utils,
+ExtUtils::Constant::XS, ExtUtils::Embed, ExtUtils::Install,
+ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM, ExtUtils::MM_AIX,
+ExtUtils::MM_Any, ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin, ExtUtils::MM_DOS,
+ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_QNX,
+ExtUtils::MM_UWIN, ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_VOS,
+ExtUtils::MM_Win32, ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker,
+ExtUtils::MakeMaker::Config, ExtUtils::MakeMaker::FAQ,
ExtUtils::MakeMaker::Tutorial, ExtUtils::MakeMaker::bytes,
ExtUtils::MakeMaker::vmsish, ExtUtils::Manifest, ExtUtils::Mkbootstrap,
ExtUtils::Mksymlists, ExtUtils::Packlist, ExtUtils::ParseXS,
@@ -4353,18 +4353,18 @@ Pod::Simple::TextContent, Pod::Simple::XMLOutStream, Pod::Text,
Pod::Text::Color, Pod::Text::Overstrike, Pod::Text::Termcap, Pod::Usage,
SDBM_File, Safe, Scalar::Util, Search::Dict, SelectSaver, SelfLoader,
Shell, Socket, Storable, Switch, Symbol, Sys::Hostname, Sys::Syslog,
-Term::ANSIColor, Term::Cap, Term::Complete, Term::ReadLine, Term::UI, Test,
-Test::Builder, Test::Builder::Module, Test::Builder::Tester,
-Test::Builder::Tester::Color, Test::Harness, Test::Harness::Assert,
-Test::Harness::Iterator, Test::Harness::Point, Test::Harness::Results,
-Test::Harness::Straps, Test::Harness::TAP, Test::Harness::Util, Test::More,
-Test::Simple, Test::Tutorial, Text::Abbrev, Text::Balanced,
-Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap, Thread,
-Thread::Queue, Thread::Semaphore, Tie::Array, Tie::File, Tie::Handle,
-Tie::Hash, Tie::Hash::NamedCapture, Tie::Memoize, Tie::RefHash,
-Tie::Scalar, Tie::SubstrHash, Time::HiRes, Time::Local, Time::Piece,
-Time::Piece::Seconds, Time::gmtime, Time::localtime, Time::tm, UNIVERSAL,
-Unicode::Collate, Unicode::Normalize, Unicode::UCD, User::grent,
+Sys::Syslog::win32::Win32, Term::ANSIColor, Term::Cap, Term::Complete,
+Term::ReadLine, Term::UI, Test, Test::Builder, Test::Builder::Module,
+Test::Builder::Tester, Test::Builder::Tester::Color, Test::Harness,
+Test::Harness::Assert, Test::Harness::Iterator, Test::Harness::Point,
+Test::Harness::Results, Test::Harness::Straps, Test::Harness::TAP,
+Test::Harness::Util, Test::More, Test::Simple, Test::Tutorial,
+Text::Abbrev, Text::Balanced, Text::ParseWords, Text::Soundex, Text::Tabs,
+Text::Wrap, Thread, Thread::Queue, Thread::Semaphore, Tie::Array,
+Tie::File, Tie::Handle, Tie::Hash, Tie::Hash::NamedCapture, Tie::Memoize,
+Tie::RefHash, Tie::Scalar, Tie::SubstrHash, Time::HiRes, Time::Local,
+Time::Piece, Time::Piece::Seconds, Time::gmtime, Time::localtime, Time::tm,
+UNIVERSAL, Unicode::Collate, Unicode::Normalize, Unicode::UCD, User::grent,
User::pwent, Win32, Win32API::File, Win32CORE, XS::APItest, XS::Typemap,
XSLoader
@@ -4769,9 +4769,10 @@ currently selected output channel, CV
=item D
dangling statement, data structure, data type, datagram, DBM, declaration,
-decrement, default, defined, delimiter, dereference, derived class,
-descriptor, destroy, destructor, device, directive, directory, directory
-handle, dispatch, distribution, dweomer, dwimmer, dynamic scoping
+decrement, default, defined, delimiter, deprecated modules and features,
+dereference, derived class, descriptor, destroy, destructor, device,
+directive, directory, directory handle, dispatch, distribution, (to be)
+dropped modules, dweomer, dwimmer, dynamic scoping
=item E
@@ -5526,7 +5527,7 @@ callback
C - RXf_PMf_MULTILINE, C - RXf_PMf_SINGLELINE, C -
RXf_PMf_FOLD, C - RXf_PMf_EXTENDED, C - RXf_PMf_KEEPCOPY,
RXf_PMf_LOCALE, RXf_UTF8, RXf_SPLIT, RXf_SKIPWHITE, RXf_START_ONLY,
-RXf_WHITE
+RXf_WHITE, RXf_NULL
=item exec
@@ -5792,9 +5793,8 @@ vverify X
=item MRO Functions
-mro_get_linear_isa X, mro_get_linear_isa_c3
-X, mro_get_linear_isa_dfs X,
-mro_method_changed_in X
+mro_get_linear_isa X, mro_method_changed_in
+X
=item Multicall Functions
@@ -6021,7 +6021,8 @@ magic_sethint X, mg_localize X
=item MRO Functions
-mro_isa_changed_in X
+mro_get_linear_isa_c3 X, mro_get_linear_isa_dfs
+X, mro_isa_changed_in X
=item Pad Data Structures
@@ -6397,6 +6398,8 @@ L, L, L
=item test B
+=item Deparse inlined constants
+
=item A decent benchmark
=item fix tainting bugs
@@ -6435,6 +6438,8 @@ L, L, L
=over 4
+=item Modernize the order of directories in @INC
+
=item Make it clear from -v if this is the exact official release
=item Profile Perl - am I hot or not?
@@ -6459,6 +6464,8 @@ L, L, L
=item Unicode and glob()
+=item Unicode and lc/uc operators
+
=item use less 'memory'
=item Re-implement C<:unique> in a way that is actually thread-safe
@@ -6481,10 +6488,18 @@ L, L, L
=over 4
+=item state variable initialization in list context
+
=item Implement $value ~~ 0 .. $range
+=item A does() built-in
+
+=item Tied filehandles and write() don't mix
+
=item Attach/detach debugger from running program
+=item Optimize away empty destructors
+
=item LVALUE functions for lists
=item LVALUE functions in the debugger
@@ -6650,6 +6665,12 @@ and horizontal whitespace, and linebreak
=item bignum, bigint, bigrat
+=item Math::BigInt/Math::BigFloat
+
+config(), import(), roundmode common, bpi(), bcos(), bsin(), batan(),
+batan2(), bmuladd(), bexp(), bnok(), from_hex(), from_oct(), and
+from_bin(), as_oct()
+
=item New Core Modules
=item Module changes
@@ -6691,7 +6712,13 @@ C, C, C, C
=item Static build on Win32
-=item C
+=item win32 builds
+
+=item C and C
+
+=item Help
+
+=item 64bit systems
=item Ports
@@ -6723,6 +6750,145 @@ C, C, C, C
=back
+=head2 perl5100delta, perldelta - what is new for perl 5.10.0
+
+=over 4
+
+=item DESCRIPTION
+
+=item Incompatible Changes
+
+=over 4
+
+=item Packing and UTF-8 strings
+
+=item The C<$*> and C<$#> variables have been removed
+
+=item substr() lvalues are no longer fixed-length
+
+=item Parsing of C<-f _>
+
+=item C<:unique>
+
+=item Scoping of the C pragma
+
+=item Scoping of C, C, C
+
+=item Effect of pragmas in eval
+
+=item chdir FOO
+
+=item Handling of .pmc files
+
+=item @- and @+ in patterns
+
+=item $AUTOLOAD can now be tainted
+
+=item Tainting and printf
+
+=item undef and signal handlers
+
+=item strictures and array/hash dereferencing in defined()
+
+=item C<(?p{})> has been removed
+
+=item Pseudo-hashes have been removed
+
+=item Removal of the bytecode compiler and of perlcc
+
+=item Removal of the JPL
+
+=item Recursive inheritance detected earlier
+
+=back
+
+=item Core Enhancements
+
+=over 4
+
+=item The C pragma
+
+=item New B<-E> command-line switch
+
+=item Defined-or operator
+
+=item Switch and Smart Match operator
+
+=item Regular expressions
+
+Recursive Patterns, Named Capture Buffers, Possessive Quantifiers,
+Backtracking control verbs, Relative backreferences, C<\K> escape, Vertical
+and horizontal whitespace, and linebreak
+
+=item C
+
+=item Lexical C<$_>
+
+=item The C<_> prototype
+
+=item UNITCHECK blocks
+
+=item New Pragma, C
+
+=item readpipe() is now overridable
+
+=item default argument for readline()
+
+=item state() variables
+
+=item Stacked filetest operators
+
+=item UNIVERSAL::DOES()
+
+=item C
+
+=item Formats
+
+=item Byte-order modifiers for pack() and unpack()
+
+=item Byte count feature in pack()
+
+=item C
+
+=item C, C and C on filehandles
+
+=item OS groups
+
+=item Recursive sort subs
+
+=item Exceptions in constant folding
+
+=item Source filters in @INC
+
+=item New internal variables
+
+C<${^RE_DEBUG_FLAGS}>, C<${^CHILD_ERROR_NATIVE}>
+
+=item Miscellaneous
+
+=item UCD 5.0.0
+
+=item MAD
+
+=back
+
+=item Modules and Pragmata
+=head1 Utility Changes
+=head1 New Documentation
+=head1 Performance Enhancements
+=head1 Installation and Configuration Improvements
+=head1 Selected Bug Fixes
+=head1 New or Changed Diagnostics
+=head1 Changed Internals
+=head1 New Tests
+=head1 Known Problems
+=head1 Platform Specific Problems
+=head1 Reporting Bugs
+
+=item SEE ALSO
+
+=back
+
=head2 perl595delta, perldelta - what is new for perl v5.9.5
=over 4
@@ -6785,6 +6951,12 @@ and horizontal whitespace, and linebreak
=item bignum, bigint, bigrat
+=item Math::BigInt/Math::BigFloat
+
+config(), import(), roundmode common, bpi(), bcos(), bsin(), batan(),
+batan2(), bmuladd(), bexp(), bnok(), from_hex(), from_oct(), and
+from_bin(), as_oct()
+
=item New Core Modules
=item Module changes
@@ -6826,7 +6998,13 @@ C, C, C, C
=item Static build on Win32
-=item C
+=item win32 builds
+
+=item C and C
+
+=item Help
+
+=item 64bit systems
=item Ports
@@ -10031,8 +10209,8 @@ C, I, Permissions
=item Optional Libraries for Perl on Cygwin
-C<-lcrypt>, C<-lgdbm> (C), C<-ldb> (C),
-C<-lcygipc> (C), C<-lutil>
+C<-lcrypt>, C<-lgdbm_compat> (C), C<-ldb> (C),
+C (C), C<-lutil>
=item Configure-time Options for Perl on Cygwin
@@ -10042,20 +10220,12 @@ C<-Dmksymlinks>
=item Suspicious Warnings on Cygwin
-I, Win9x and C, Compiler/Preprocessor defines
+Win9x and C, Compiler/Preprocessor defines
=back
=item MAKE ON CYGWIN
-=over 4
-
-=item Errors on Cygwin
-
-=item ld2 on Cygwin
-
-=back
-
=item TEST ON CYGWIN
=over 4
@@ -10074,12 +10244,14 @@ I, Win9x and C, Compiler/Preprocessor defines
=item Script Portability on Cygwin
-Pathnames, Text/Binary, PerlIO, F<.exe>, cygwin vs. windows process ids,
-C, Miscellaneous
+Pathnames, Text/Binary, PerlIO, F<.exe>, Cygwin vs. Windows process ids,
+Cygwin vs. Windows errors, C, Miscellaneous
=item Prebuilt methods:
-C, C, C
+C, C, C,
+C, C,
+C, C, C
=back
@@ -10088,7 +10260,7 @@ C, C, C
=item MANIFEST ON CYGWIN
Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
-Source, Compiled Module Source, Perl Modules/Scripts
+Source, Compiled Module Source, Perl Modules/Scripts, Perl Module Tests
=item BUGS ON CYGWIN
@@ -10281,6 +10453,8 @@ DJGPP, Pthreads
=item nss_delete core dump from op/pwent or op/grent
+=item Miscellaneous
+
=item AUTHOR
=item DATE
@@ -11201,6 +11375,8 @@ Digital UNIX formerly known as DEC OSF/1) systems
=item PERL5LIB and PERLLIB
+=item The Perl Forked Debugger
+
=item PERL_VMS_EXCEPTION_DEBUG
=item Command line
@@ -11283,9 +11459,9 @@ utime LIST, waitpid PID,FLAGS
=item Setting Up Perl on Win32
Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Visual
-C++ 2005 Express Edition, Microsoft Visual C++ Toolkit 2003, Microsoft
-Platform SDK 64-bit Compiler, MinGW release 3 with gcc, MinGW release 1
-with gcc
+C++ 2008 Express Edition Beta 2, Microsoft Visual C++ 2005 Express Edition,
+Microsoft Visual C++ Toolkit 2003, Microsoft Platform SDK 64-bit Compiler,
+MinGW release 3 with gcc, MinGW release 1 with gcc
=item Building
@@ -11470,9 +11646,10 @@ signal name: ..
=item BUGS AND LIMITATIONS
-Threadsafe modules, Using non-threadsafe modules, Parent-child threads,
-Creating threads inside special blocks, Unsafe signals, Perl has been built
-with C (see C), The environment variable
+Thread-safe modules, Using non-thread-safe modules, Current working
+directory, Environment variables, Parent-child threads, Creating threads
+inside special blocks, Unsafe signals, Perl has been built with
+C (see C), The environment variable
C is set to C (see L), The
module L is used, Returning closures from threads,
Returning objects from threads, Perl Bugs and the CPAN Version of
@@ -11751,7 +11928,7 @@ escapes
=item DESCRIPTION
-=item CUSTOM TRANSLATORS
+=item ALIASES
=item CUSTOM ALIASES
@@ -11769,7 +11946,7 @@ escapes
=item charnames::vianame(name)
-=item ALIASES
+=item CUSTOM TRANSLATORS
=item ILLEGAL CHARACTERS
@@ -11799,9 +11976,11 @@ escapes
=item TECHNICAL NOTES
+=item CAVEATS
+
=item BUGS
-=item AUTHOR
+=item AUTHORS
=item COPYRIGHT
@@ -11963,8 +12142,6 @@ upgrading for byte-strings
=item The 'say' feature
-=item the 'err' feature
-
=item the 'state' feature
=back
@@ -12141,8 +12318,6 @@ operations
=back
-=item PERFORMANCE CONSIDERATIONS
-
=item SEE ALSO
=over 4
@@ -12647,6 +12822,10 @@ $ae->extract_path, $ae->files
=item File Extensions
+=item Supporting Very Large Files
+
+=item Bunzip2 support of arbitrary extensions.
+
=back
=item GLOBAL VARIABLES
@@ -12867,7 +13046,7 @@ Can't you lazy-load data instead?, How much memory will an X kb tar file
need?, What do you do with unsupported filetypes in an archive?, I'm using
WinZip, or some other non-POSIX client, and files are not being extracted
properly!, How do I extract only files that have property X from an
-archive?, How do I access .tar.Z files?
+archive?, How do I access .tar.Z files?, How do I handle Unicode strings?
=item TODO
@@ -13257,7 +13436,8 @@ B<-base>I, B<-bigendian>, B<-littleendian>
=item Other options
-B<-main>, B<-nomain>, B<-nobanner>, B<-banner>, B<-banneris> => subref
+B<-src>, B<-stash="somepackage">, B<-main>, B<-nomain>, B<-nobanner>,
+B<-banner>, B<-banneris> => subref
=item Option Stickiness
@@ -13300,7 +13480,8 @@ B<#typenum>
perl -MO=Concise,bar foo.pl, perl -MDigest::MD5=md5 -MO=Concise,md5 -e1,
perl -MPOSIX -MO=Concise,_POSIX_ARG_MAX -e1, perl -MPOSIX -MO=Concise,a -e
'print _POSIX_SAVED_IDS', perl -MPOSIX -MO=Concise,a -e 'sub
-a{_POSIX_SAVED_IDS}'
+a{_POSIX_SAVED_IDS}', perl -MB::Concise -e
+'B::Concise::compile("-exec","-src", \%B::Concise::)->()'
=item Using B::Concise outside of the O framework
@@ -13365,7 +13546,8 @@ BI, B, BIB<.>, B<-x>I
=item ambient_pragmas
-strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
+strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits,
+%^H
=item coderef2text
@@ -13982,6 +14164,22 @@ FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
=back
+=head2 CORE - Pseudo-namespace for Perl's core routines
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item OVERRIDING CORE FUNCTIONS
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
=head2 CPAN - query, download and build perl modules from CPAN sites
=over 4
@@ -14008,10 +14206,14 @@ and the C pragma, Lockfile, Signals
=item mkmyconfig
+=item recent ***EXPERIMENTAL COMMAND***
+
=item recompile
=item report Bundle|Distribution|Module
+=item smoke ***EXPERIMENTAL COMMAND***
+
=item upgrade [Module|/Regex/]...
=item The four C Classes: Author, Bundle, Module, Distribution
@@ -14059,9 +14261,9 @@ cwd, getcwd, fastcwd, backtickcwd
=item Language Specs
-comment [scalar], cpanconfig [hash], disabled [boolean], goto [string],
-install [hash], make [hash], match [hash], patches [array], pl [hash], test
-[hash]
+comment [scalar], cpanconfig [hash], depends [hash] *** EXPERIMENTAL
+FEATURE ***, disabled [boolean], goto [string], install [hash], make
+[hash], match [hash], patches [array], pl [hash], test [hash]
=item Processing Instructions
@@ -14090,7 +14292,8 @@ CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
CPAN::Bundle::readme(), CPAN::Bundle::test(),
CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
-CPAN::Distribution::author, CPAN::Distribution::clean(),
+CPAN::Distribution::author, CPAN::Distribution::pretty_id(),
+CPAN::Distribution::base_id(), CPAN::Distribution::clean(),
CPAN::Distribution::containsmods(), CPAN::Distribution::cvs_import(),
CPAN::Distribution::dir(), CPAN::Distribution::force($method,@args),
CPAN::Distribution::get(), CPAN::Distribution::install(),
@@ -14168,7 +14371,7 @@ http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
=item FAQ
-1), 2), 3), 4), 5), 6), 7), 8), 9), 10), 11), 12), 13), 14), 15)
+1), 2), 3), 4), 5), 6), 7), 8), 9), 10), 11), 12), 13), 14), 15), 16)
=item COMPATIBILITY
@@ -14194,6 +14397,28 @@ http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
=back
+=head2 CPAN::API::HOWTO - a recipe book for programming with CPAN.pm
+
+=over 4
+
+=item RECIPES
+
+=over 4
+
+=item What distribution contains a particular module?
+
+=item What modules does a particular distribution contain?
+
+=back
+
+=item SEE ALSO
+
+=item LICENSE
+
+=item AUTHOR
+
+=back
+
=head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
=over 4
@@ -14202,6 +14427,22 @@ http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
=item DESCRIPTION
+=back
+
+auto_commit, build_cache, build_dir, build_dir_reuse,
+build_requires_install_policy, cache_metadata, check_sigs, colorize_output,
+colorize_print, colorize_warn, colorize_debug, commandnumber_in_prompt,
+ftp_passive, getcwd, histfile, histsize, inactivity_timeout, index_expire,
+inhibit_startup_message, keep_source_where, load_module_verbosity,
+makepl_arg, make_arg, make_install_arg, make_install_make_command,
+mbuildpl_arg, mbuild_arg, mbuild_install_arg, mbuild_install_build_command,
+pager, prefer_installer, prefs_dir, prerequisites_policy,
+randomize_urllist, scan_cache, shell, show_unparsable_versions,
+show_upload_date, show_zero_versions, tar_verbosity, term_is_latin,
+term_ornaments, test_report, use_sqlite, yaml_load_code, yaml_module
+
+=over 4
+
=item LICENSE
=back
@@ -14360,7 +14601,8 @@ verbose => BOOL] )
=over 4
-=item $mod_obj = $cb->parse_module( module => $modname|$distname|$modobj )
+=item $mod_obj = $cb->parse_module( module =>
+$modname|$distname|$modobj|URI )
Text::Bastardize, Text-Bastardize, Text-Bastardize-1.06,
AYRNIEU/Text-Bastardize, AYRNIEU/Text-Bastardize-1.06,
@@ -14603,7 +14845,7 @@ perlwrapper
=item add_SOMETHING( ITEM => VAL, [ITEM => VAL, ITEM => VAL, ... ] );
set|get_conf, set|get_program, _set|_get_build, _set|_get_source,
-_set|_get_mirror, _set|_get_dist, _set|_get_fetch, _set|_get_daemon
+_set|_get_mirror, _set|_get_fetch
=back
@@ -16500,11 +16742,11 @@ C, C, C, C, C, C, C
C, C, C, C, C, C, C,
C, C, C, C, C,
-C, C, C, C, C, C,
-C, C, C, C, C, C, C,
-C, C, C, C, C,
-C, C, C, C, C,
-C, C, C
+C, C, C, C, C, C,
+C, C, C, C, C, C, C,
+C, C, C, C, C,
+C, C, C, C, C,
+C, C
=item d
@@ -16736,7 +16978,7 @@ C, C
C, C, C, C, C,
C, C, C, C, C,
-C, C, C
+C, C, C, C
=item s
@@ -16852,9 +17094,7 @@ abs_path, realpath, fast_abs_path
=back
-=head2 DB - programmatic interface to the Perl debugging API (draft,
-subject to
-change)
+=head2 DB - programmatic interface to the Perl debugging API
=over 4
@@ -17428,7 +17668,7 @@ $md5->add_bits($bitstring), $md5->digest, $md5->hexdigest, $md5->b64digest
=over 4
-=item SYNOPSIS (SHA)
+=item SYNOPSIS
=item SYNOPSIS (HMAC-SHA)
@@ -20035,7 +20275,7 @@ C X
=back
-=head2 File::CheckTree, validate - run many filetest checks on a tree
+=head2 File::CheckTree - run many filetest checks on a tree
=over 4
@@ -20330,7 +20570,7 @@ B<~>, B<~user>, B<.>, B<*>, B>, B<\>, B<[]>, B<{,}>, B<()>
=item FUNCTIONS
-mode, verbose, error, verbose, skip_others, keep_root, result, error
+mode, verbose, error, verbose, safe, keep_root, result, error
=item TRADITIONAL INTERFACE
@@ -20342,10 +20582,27 @@ mode, verbose, error, verbose, skip_others, keep_root, result, error
=item DIAGNOSTICS
+mkdir [path]: [errmsg] (SEVERE), No root path(s) specified, No such file or
+directory, cannot fetch initial working directory: [errmsg], cannot stat
+initial working directory: [errmsg], cannot chdir to [dir]: [errmsg],
+directory [dir] changed before chdir, expected dev=[n] inode=[n], actual
+dev=[n] ino=[n], aborting. (FATAL), cannot make directory [dir]
+read+writeable: [errmsg], cannot read [dir]: [errmsg], cannot reset chmod
+[dir]: [errmsg], cannot chdir to [parent-dir] from [child-dir]: [errmsg],
+aborting. (FATAL), cannot stat prior working directory [dir]: [errmsg],
+aborting. (FATAL), previous directory [parent-dir] changed before entering
+[child-dir], expected dev=[n] inode=[n], actual dev=[n] ino=[n], aborting.
+(FATAL), cannot make directory [dir] writeable: [errmsg], cannot remove
+directory [dir]: [errmsg], cannot restore permissions of [dir] to [0nnn]:
+[errmsg], cannot make file [file] writeable: [errmsg], cannot unlink file
+[file]: [errmsg], cannot restore permissions of [file] to [0nnn]: [errmsg]
+
=item SEE ALSO
=item BUGS
+=item ACKNOWLEDGEMENTS
+
=item AUTHORS
=item COPYRIGHT
@@ -20632,6 +20889,10 @@ devnull
tmpdir
+case_tolerant
+
+file_name_is_absolute
+
catfile
canonpath
@@ -25457,6 +25718,8 @@ Input, Output
=item bsqrt()
+=item broot()
+
=item bfac()
=item round()
@@ -25568,11 +25831,6 @@ bsqrt(), div(), blog(), bexp()
=item EXPORTS
-=item BUGS
-
-broot() does not work, Out of Memory!, Fails to load Calc on Perl prior
-5.6.0
-
=item CAVEATS
bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity handling,
@@ -25718,8 +25976,6 @@ the same terms as Perl itself.
=item bfac()
-=item blog()
-
=item bround()/round()/bfround()
=item bmod()
@@ -25766,6 +26022,10 @@ the same terms as Perl itself.
=item bpow()
+=item bexp()
+
+=item bnok()
+
=item config()
=back
@@ -26476,6 +26736,16 @@ _infer_xs_spec
rscan_dir
+dist_dir
+
+man3page_name
+
+expand_test_dir
+
+_detildefy
+
+find_perl_interpreter
+
=over 4
=item AUTHOR
@@ -26605,6 +26875,10 @@ Module::Build works even if YAML.pm is not installed
=item Caveats
+=item ACKNOWLEDGEMENTS
+
+=item BUG REPORTS
+
=item AUTHOR
=item COPYRIGHT
@@ -26664,6 +26938,8 @@ modules, verbose, nocache
=item See Also
+=item BUG REPORTS
+
=item AUTHOR
=item COPYRIGHT
@@ -27060,8 +27336,8 @@ Net::Ping->new([$proto [, $def_timeout [, $bytes [, $device [, $tos
]]]]]);, $p->ping($host [, $timeout]);, $p->source_verify( { 0 | 1 } );,
$p->service_check( { 0 | 1 } );, $p->tcp_service_check( { 0 | 1 } );,
$p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->open($host);, $p->ack(
-[ $host ] );, $p->nack( $failed_ack_host );, $p->close();, pingecho($host
-[, $timeout]);
+[ $host ] );, $p->nack( $failed_ack_host );, $p->close();,
+$p->port_number([$port_number]), pingecho($host [, $timeout]);
=back
@@ -27520,8 +27796,8 @@ opdump (PAT)
:base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
:base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
-:filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
-:dangerous
+:filesys_write, :subprocess, :ownprocess, :others, :load,
+:still_to_be_decided, :dangerous
=item SEE ALSO
@@ -30091,6 +30367,8 @@ B, B,
B (added in Perl 5.004_02),
B, B
+=item THE RULES OF SYS::SYSLOG
+
=item EXAMPLES
=item CONSTANTS
@@ -30105,18 +30383,31 @@ B, B
=item DIAGNOSTICS
-Invalid argument passed to setlogsock, no connection to syslog available,
-stream passed to setlogsock, but %s is not writable, stream passed to
-setlogsock, but could not find any device, tcp passed to setlogsock, but
-tcp service unavailable, syslog: expecting argument %s, syslog: invalid
-level/facility: %s, syslog: too many levels given: %s, syslog: too many
-facilities given: %s, syslog: level must be given, udp passed to
-setlogsock, but udp service unavailable, unix passed to setlogsock, but
-path not available
+C, C, C, C,
+C, C, C, C, C, C, C, C, C
=item SEE ALSO
-=item AUTHORS
+=over 4
+
+=item Manual Pages
+
+=item RFCs
+
+=item Articles
+
+=item Event Log
+
+=back
+
+=item AUTHORS & ACKNOWLEDGEMENTS
=item BUGS
@@ -30150,6 +30441,8 @@ B, B,
B (added in Perl 5.004_02),
B, B
+=item THE RULES OF SYS::SYSLOG
+
=item EXAMPLES
=item CONSTANTS
@@ -30164,18 +30457,31 @@ B, B
=item DIAGNOSTICS
-Invalid argument passed to setlogsock, no connection to syslog available,
-stream passed to setlogsock, but %s is not writable, stream passed to
-setlogsock, but could not find any device, tcp passed to setlogsock, but
-tcp service unavailable, syslog: expecting argument %s, syslog: invalid
-level/facility: %s, syslog: too many levels given: %s, syslog: too many
-facilities given: %s, syslog: level must be given, udp passed to
-setlogsock, but udp service unavailable, unix passed to setlogsock, but
-path not available
+C, C, C, C,
+C, C, C, C, C, C, C, C, C
=item SEE ALSO
-=item AUTHORS
+=over 4
+
+=item Manual Pages
+
+=item RFCs
+
+=item Articles
+
+=item Event Log
+
+=back
+
+=item AUTHORS & ACKNOWLEDGEMENTS
=item BUGS
@@ -30188,6 +30494,21 @@ tracker, Search CPAN, Kobes' CPAN Search, Perl Documentation
=back
+=head2 Syslog::win32::Win32, Sys::Syslog::Win32 - Win32 support for
+Sys::Syslog
+
+=over 4
+
+=item DESCRIPTION
+
+=item SEE ALSO
+
+=item AUTHORS
+
+=item LICENSE
+
+=back
+
=head2 Term::ANSIColor - Color screen output using ANSI escape sequences
=over 4
@@ -30377,13 +30698,15 @@ record", allow => $ref] );
=item See Also
+=item BUG REPORTS
+
=item AUTHOR
=item COPYRIGHT
=back
-=head2 Term::UI::History, Log::Message::Simple
+=head2 Term::UI::History
=over 4
@@ -31357,8 +31680,7 @@ arrays
=back
-=head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
-by Knuth
+=head2 Text::Soundex - Implementation of the soundex algorithm.
=over 4
@@ -31554,8 +31876,7 @@ SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
=back
-=head2 Tie::Handle, Tie::StdHandle - base class definitions for tied
-handles
+=head2 Tie::Handle - base class definitions for tied handles
=over 4
diff --git a/vms/descrip_mms.template b/vms/descrip_mms.template
index 9bb17a1..53d927a 100644
--- a/vms/descrip_mms.template
+++ b/vms/descrip_mms.template
@@ -386,14 +386,14 @@ x2p : [.x2p]$(DBG)a2p$(E) [.x2p]s2p.com [.x2p]find2perl.com
extra.pods : miniperl
@ @extra_pods.com
-pod0 = [.lib.pods]perl.pod [.lib.pods]perl5004delta.pod [.lib.pods]perl5005delta.pod [.lib.pods]perl561delta.pod [.lib.pods]perl56delta.pod
-pod1 = [.lib.pods]perl570delta.pod [.lib.pods]perl571delta.pod [.lib.pods]perl572delta.pod [.lib.pods]perl573delta.pod [.lib.pods]perl581delta.pod
-pod2 = [.lib.pods]perl582delta.pod [.lib.pods]perl583delta.pod [.lib.pods]perl584delta.pod [.lib.pods]perl585delta.pod [.lib.pods]perl586delta.pod
-pod3 = [.lib.pods]perl587delta.pod [.lib.pods]perl588delta.pod [.lib.pods]perl58delta.pod [.lib.pods]perl590delta.pod [.lib.pods]perl591delta.pod
-pod4 = [.lib.pods]perl592delta.pod [.lib.pods]perl593delta.pod [.lib.pods]perl594delta.pod [.lib.pods]perl595delta.pod [.lib.pods]perlaix.pod
-pod5 = [.lib.pods]perlamiga.pod [.lib.pods]perlapi.pod [.lib.pods]perlapio.pod [.lib.pods]perlapollo.pod [.lib.pods]perlartistic.pod [.lib.pods]perlbeos.pod
-pod6 = [.lib.pods]perlbook.pod [.lib.pods]perlboot.pod [.lib.pods]perlbot.pod [.lib.pods]perlbs2000.pod [.lib.pods]perlcall.pod [.lib.pods]perlce.pod
-pod7 = [.lib.pods]perlcheat.pod [.lib.pods]perlclib.pod [.lib.pods]perlcn.pod [.lib.pods]perlcommunity.pod [.lib.pods]perlcompile.pod
+pod0 = [.lib.pods]perl.pod [.lib.pods]perl5004delta.pod [.lib.pods]perl5005delta.pod [.lib.pods]perl5100delta.pod [.lib.pods]perl561delta.pod
+pod1 = [.lib.pods]perl56delta.pod [.lib.pods]perl570delta.pod [.lib.pods]perl571delta.pod [.lib.pods]perl572delta.pod [.lib.pods]perl573delta.pod
+pod2 = [.lib.pods]perl581delta.pod [.lib.pods]perl582delta.pod [.lib.pods]perl583delta.pod [.lib.pods]perl584delta.pod [.lib.pods]perl585delta.pod
+pod3 = [.lib.pods]perl586delta.pod [.lib.pods]perl587delta.pod [.lib.pods]perl588delta.pod [.lib.pods]perl58delta.pod [.lib.pods]perl590delta.pod
+pod4 = [.lib.pods]perl591delta.pod [.lib.pods]perl592delta.pod [.lib.pods]perl593delta.pod [.lib.pods]perl594delta.pod [.lib.pods]perl595delta.pod
+pod5 = [.lib.pods]perlaix.pod [.lib.pods]perlamiga.pod [.lib.pods]perlapi.pod [.lib.pods]perlapio.pod [.lib.pods]perlapollo.pod [.lib.pods]perlartistic.pod
+pod6 = [.lib.pods]perlbeos.pod [.lib.pods]perlbook.pod [.lib.pods]perlboot.pod [.lib.pods]perlbot.pod [.lib.pods]perlbs2000.pod [.lib.pods]perlcall.pod
+pod7 = [.lib.pods]perlce.pod [.lib.pods]perlcheat.pod [.lib.pods]perlclib.pod [.lib.pods]perlcn.pod [.lib.pods]perlcommunity.pod [.lib.pods]perlcompile.pod
pod8 = [.lib.pods]perlcygwin.pod [.lib.pods]perldata.pod [.lib.pods]perldbmfilter.pod [.lib.pods]perldebguts.pod [.lib.pods]perldebtut.pod
pod9 = [.lib.pods]perldebug.pod [.lib.pods]perldelta.pod [.lib.pods]perldgux.pod [.lib.pods]perldiag.pod [.lib.pods]perldoc.pod [.lib.pods]perldos.pod
pod10 = [.lib.pods]perldsc.pod [.lib.pods]perlebcdic.pod [.lib.pods]perlembed.pod [.lib.pods]perlepoc.pod [.lib.pods]perlfaq.pod [.lib.pods]perlfaq1.pod
@@ -725,6 +725,10 @@ makeppport : $(MINIPERL_EXE) $(ARCHDIR)Config.pm
@ If F$Search("[.lib]pods.dir").eqs."" Then Create/Directory [.lib.pods]
Copy/NoConfirm/Log $(MMS$SOURCE) [.lib.pods]
+[.lib.pods]perl5100delta.pod : [.pod]perl5100delta.pod
+ @ If F$Search("[.lib]pods.dir").eqs."" Then Create/Directory [.lib.pods]
+ Copy/NoConfirm/Log $(MMS$SOURCE) [.lib.pods]
+
[.lib.pods]perl561delta.pod : [.pod]perl561delta.pod
@ If F$Search("[.lib]pods.dir").eqs."" Then Create/Directory [.lib.pods]
Copy/NoConfirm/Log $(MMS$SOURCE) [.lib.pods]
diff --git a/win32/Makefile b/win32/Makefile
index f07a62b..f0dde81 100644
--- a/win32/Makefile
+++ b/win32/Makefile
@@ -1133,7 +1133,7 @@ utils: $(PERLEXE) $(X2P)
copy ..\README.vms ..\pod\perlvms.pod
copy ..\README.vos ..\pod\perlvos.pod
copy ..\README.win32 ..\pod\perlwin32.pod
- copy ..\pod\perl595delta.pod ..\pod\perldelta.pod
+ copy ..\pod\perl5100delta.pod ..\pod\perldelta.pod
$(MAKE) -f ..\win32\pod.mak converters
cd ..\lib
$(PERLEXE) lib_pm.PL
diff --git a/win32/makefile.mk b/win32/makefile.mk
index 2f99285..5b93ad8 100644
--- a/win32/makefile.mk
+++ b/win32/makefile.mk
@@ -1459,7 +1459,7 @@ utils: $(PERLEXE) $(X2P)
copy ..\README.vms ..\pod\perlvms.pod
copy ..\README.vos ..\pod\perlvos.pod
copy ..\README.win32 ..\pod\perlwin32.pod
- copy ..\pod\perl595delta.pod ..\pod\perldelta.pod
+ copy ..\pod\perl5100delta.pod ..\pod\perldelta.pod
cd ..\pod && $(MAKE) -f ..\win32\pod.mak converters
cd ..\lib && $(PERLEXE) lib_pm.PL
$(PERLEXE) $(PL2BAT) $(UTILS)
diff --git a/win32/pod.mak b/win32/pod.mak
index e48d4e9..e74cc0d 100644
--- a/win32/pod.mak
+++ b/win32/pod.mak
@@ -18,6 +18,7 @@ POD = \
perl.pod \
perl5004delta.pod \
perl5005delta.pod \
+ perl5100delta.pod \
perl561delta.pod \
perl56delta.pod \
perl570delta.pod \
@@ -137,6 +138,7 @@ MAN = \
perl.man \
perl5004delta.man \
perl5005delta.man \
+ perl5100delta.man \
perl561delta.man \
perl56delta.man \
perl570delta.man \
@@ -256,6 +258,7 @@ HTML = \
perl.html \
perl5004delta.html \
perl5005delta.html \
+ perl5100delta.html \
perl561delta.html \
perl56delta.html \
perl570delta.html \
@@ -375,6 +378,7 @@ TEX = \
perl.tex \
perl5004delta.tex \
perl5005delta.tex \
+ perl5100delta.tex \
perl561delta.tex \
perl56delta.tex \
perl570delta.tex \