argra****@users*****
argra****@users*****
2012年 4月 26日 (木) 04:29:58 JST
Index: docs/perl/5.16.0/perl5160delta.pod diff -u docs/perl/5.16.0/perl5160delta.pod:1.7 docs/perl/5.16.0/perl5160delta.pod:1.8 --- docs/perl/5.16.0/perl5160delta.pod:1.7 Wed Apr 25 18:11:12 2012 +++ docs/perl/5.16.0/perl5160delta.pod Thu Apr 26 04:29:58 2012 @@ -2282,44 +2282,94 @@ =head1 Documentation +(ææ¸) + =head2 New Documentation +(æ°ããææ¸) + =head3 L<perldtrace> +=begin original + L<perldtrace> describes Perl's DTrace support, listing the provided probes and gives examples of their use. +=end original + +L<perldtrace> 㯠Perl ã® DTrace 対å¿ã«ã¤ãã¦è¨è¿°ããæä¾ãã¦ãã +ããã¼ãã®ä¸è¦§ã¨ä½¿ç¨ä¾ãæä¾ãã¾ãã + =head3 L<perlexperiment> +=begin original + This document is intended to provide a list of experimental features in Perl. It is still a work in progress. +=end original + +ãã®ææ¸ã¯ Perl ã®å®é¨çæ©è½ã®ä¸è¦§ãæä¾ãããã¨ãæå³ãã¦ãã¾ãã +ããã¯ã¾ã ä½æ¥ä¸ã§ãã + =head3 L<perlootut> +=begin original + This a new OO tutorial. It focuses on basic OO concepts, and then recommends that readers choose an OO framework from CPAN. +=end original + +ããã¯æ°ãã OO ãã¥ã¼ããªã¢ã«ã§ãã +åºæ¬ç㪠OO ã³ã³ã»ããã«ç¦ç¹ãåãããèªè ã CPAN ãã OO ãã¬ã¼ã ã¯ã¼ã¯ã +é¸ã¶ãã¨ãæ¨å¥¨ãã¦ãã¾ãã + =head3 L<perlxstypemap> +=begin original + The new manual describes the XS typemapping mechanism in unprecedented detail and combines new documentation with information extracted from L<perlxs> and the previously unofficial list of all core typemaps. +=end original + +ãã®æ°ããããã¥ã¢ã«ã¯ãåä¾ã®ãªãã»ã©è©³ç´°ã« XS typemap æ©æ§ã«ã¤ãã¦è¨è¿°ãã +æ°ããææ¸ã L<perlxs> ããæ½åºãããæ å ±ããã³ä»¥åã¯éå ¬å¼ã ã£ã +å ¨ã¦ã®ã³ã¢ typemap ã®ä¸è¦§ã¨çµåãã¾ãã + =head2 Changes to Existing Documentation +(æ¢åã®ææ¸ã®å¤æ´) + =head3 L<perlapi> =over 4 =item * +=begin original + The HV API has long accepted negative lengths to indicate that the key is in UTF8. Now this is documented. +=end original + +HV API ã¯é·ãéããã¼ã UTF8 ã§ãããã¨ã示ãããã®è² æ°ã®é·ãã +åãä»ãã¦ãã¾ããã +ãããææ¸åããã¾ããã + =item * +=begin original + The C<boolSV()> macro is now documented. +=end original + +C<boolSV()> ãææ¸åããã¾ããã + =back =head3 L<perlfunc> @@ -2328,23 +2378,49 @@ =item * +=begin original + C<dbmopen> treats a 0 mode as a special case, that prevents a nonexistent file from being created. This has been the case since Perl 5.000, but was never documented anywhere. Now the perlfunc entry mentions it [perl #90064]. +=end original + +C<dbmopen> ã¯ã¢ã¼ã 0 ãç¹æ®ãªå ´åã¨ãã¦æ±ãããã®å ´ååå¨ããªããã¡ã¤ã«ã +ä½æãã¾ããã +ãã㯠Perl 5.000 ããããã¾ããããã©ãã«ãææ¸åããã¦ãã¾ããã§ããã +perlfunc ã®ã¨ã³ããªã§ããã«è§¦ããããã«ãªãã¾ãã [perl #90064]ã + =item * +=begin original + As an accident of history, C<open $fh, "<:", ...> applies the default layers for the platform (C<:raw> on Unix, C<:crlf> on Windows), ignoring whatever is declared by L<open.pm|open>. This seems such a useful feature it has been documented in L<perlfunc|perlfunc/open> and L<open>. +=end original + +æ´å²ä¸ã®å¶ç¶ã«ãããC<open $fh, "<:", ...> ã¯ãã©ãããã©ã¼ã ã®ããã©ã«ã層 +(Unix ã§ã¯ C<:raw>ãWindows ã§ã¯ C<:crlf>)ãé©ç¨ããL<open.pm|open> 㧠+宣è¨ããã¦ãããã®ãç¡è¦ãã¦ãã¾ããã +ããã¯æå¹ãªæ©è½ã«æããã®ã§ãL<perlfunc|perlfunc/open> 㨠L<open> ã« +ææ¸åããã¾ããã + =item * +=begin original + The entry for C<split> has been rewritten. It is now far clearer than before. +=end original + +C<split> ã®ã¨ã³ããªãæ¸ãç´ããã¾ããã +以åããé¥ãã«æ確ã«ãªãã¾ããã + =back =head3 L<perlguts> @@ -2353,16 +2429,33 @@ =item * +=begin original + A new section, L<Autoloading with XSUBs|perlguts/Autoloading with XSUBs>, has been added, which explains the two APIs for accessing the name of the autoloaded sub. +=end original + +ãªã¼ããã¼ãããããµãã«ã¼ãã³ã®ååã«ã¢ã¯ã»ã¹ããããã®äºã¤ã® API ã« +ã¤ãã¦èª¬æãã +L<Autoloading with XSUBs|perlguts/Autoloading with XSUBs> ã¨ããæ°ãã +ç« ã追å ããã¾ããã + =item * +=begin original + Some of the function descriptions in L<perlguts> were confusing, as it was not clear whether they referred to the function above or below the description. This has been clarified [perl #91790]. +=end original + +L<perlguts> ã®ããã¤ãã®é¢æ°ã®èª¬æã¯æ··ä¹±ãã¦ãã¦ã説æã®ä¸ã«æ¸ãã¦ãã +é¢æ°ã®ãã¨ãä¸ã«æ¸ãã¦ããé¢æ°ã®ãã¨ããã¯ã£ãããã¦ãã¾ããã§ããã +ããã¯æ確åããã¾ãã [perl #91790]ã + =back =head3 L<perlobj> @@ -2371,9 +2464,15 @@ =item * +=begin original + This document has been rewritten from scratch, and its coverage of various OO concepts has been expanded. +=end original + +ãã®ææ¸ã¯æåããæ¸ãç´ãããæ§ã 㪠OO ã³ã³ã»ããã®ç¯å²ãæ¡å¼µããã¾ããã + =back =head3 L<perlop> @@ -2382,31 +2481,71 @@ =item * +=begin original + Documentation of the smartmatch operator has been reworked and moved from perlsyn to perlop where it belongs. +=end original + +ã¹ãã¼ããããã³ã°æ¼ç®åã®ææ¸ãæ¸ãç´ãããperlsyn ããå±ããå ´æã§ãã +perlopã«ç§»åãã¾ããã + +=begin original + It has also been corrected for the case of C<undef> on the left-hand side. The list of different smart match behaviours had an item in the wrong place. +=end original + +å·¦å´ã® C<undef> ã®å ´åãä¿®æ£ããã¾ããã +ã¹ãã¼ããããã³ã°ã®æ¯ãèãã®éãã®ä¸è¦§ã¯ééã£ãä½ç½®ã®ã¢ã¤ãã ã« +ããã¾ããã + =item * +=begin original + Documentation of the ellipsis statement (C<...>) has been reworked and moved from perlop to perlsyn. +=end original + +çç¥æ (C<...>) ã®ææ¸ãæ¸ãç´ãããperlop ãã perlsyn ã«ç§»åãã¾ããã + =item * +=begin original + The explanation of bitwise operators has been expanded to explain how they work on Unicode strings (5.14.1). +=end original + +ãããåä½æ¼ç®åã®èª¬æã¯ãUnicode æååã«å¯¾ãã¦ã©ã®ããã«åä½ãããã® +説æã追å ããã¾ãã (5.14.1)ã + =item * +=begin original + More examples for C<m//g> have been added (5.14.1). +=end original + +C<m//g> ã«é¢ãããããªãä¾ã追å ããã¾ãã (5.14.1)ã + =item * +=begin original + The C<<< <<\FOO >>> here-doc syntax has been documented (5.14.1). +=end original + +C<<< <<\FOO >>> ãã¤ããã¥ã¡ã³ãææ³ã追å ããã¾ãã (5.14.1)ã + =back =head3 L<perlpragma> @@ -2415,9 +2554,16 @@ =item * +=begin original + There is now a standard convention for naming keys in the C<%^H>, documented under L<Key naming|perlpragma/Key naming>. +=end original + +C<%^H> ã®ãã¼ã®å½åã«æ¨æºè¦åãå®ãããã +L<Key naming|perlpragma/Key naming> ã§ææ¸åããã¾ããã + =back =head3 L<perlsec/Laundering and Detecting Tainted Data> @@ -2426,11 +2572,21 @@ =item * +=begin original + The example function for checking for taintedness contained a subtle error. C<$@> needs to be localized to prevent its changing this global's value outside the function. The preferred method to check for this remains L<Scalar::Util/tainted>. +=end original + +æ±æããã§ãã¯ããä¾ã®é¢æ°ã«å ããªãã¹ãããã¾ããã +C<$@> ã¯é¢æ°ã®å¤å´ã§ãã®ã°ãã¼ãã«ãªå¤ãå¤æ´ãããªãããã«ãã¼ã«ã«åãã +å¿ è¦ãããã¾ãã +ããããã§ãã¯ããããã®æã¾ããã¡ã½ããã¯ãã¯ã +L<Scalar::Util/tainted> ã§ãã + =back =head3 L<perllol> @@ -2439,9 +2595,16 @@ =item * +=begin original + L<perllol> has been expanded with examples using the new C<push $scalar> syntax introduced in Perl 5.14.0 (5.14.1). +=end original + +L<perllol> ã¯ãPerl 5.14.0 ã§å°å ¥ãããæ°ãã C<push $scalar> ææ³ã +使ã£ãä¾ã追å ããã¾ãã (5.14.1)ã + =back =head3 L<perlmod> @@ -2450,10 +2613,18 @@ =item * +=begin original + L<perlmod> now states explicitly that some types of explicit symbol table manipulation are not supported. This codifies what was effectively already the case [perl #78074]. +=end original + +L<perlmod> ã¯æ示çãªã·ã³ãã«ãã¼ãã«æä½ã®ããã¤ãã®ç¨®é¡ã¯å¯¾å¿ãã¦ããªã +ãã¨ãæ示çã«è¨ãããã«ãªãã¾ããã +ããã¯ä½ãäºå®ä¸ãã§ã«å¯¾å¿ãã¦ããªãããææåãã¦ãã¾ã [perl #78074]ã + =back =head3 L<perlpodstyle> @@ -2462,14 +2633,28 @@ =item * +=begin original + The tips on which formatting codes to use have been corrected and greatly expanded. +=end original + +ã©ã®ãã©ã¼ãããã£ã³ã°ã³ã¼ãã使ããã®å°æãä¿®æ£ãããå¤§å¹ ã« +æ¡å¼µããã¾ããã + =item * +=begin original + There are now a couple of example one-liners for previewing POD files after they have been edited. +=end original + +POD ãã¡ã¤ã«ãä¿®æ£ããå¾ãã¬ãã¥ã¼ããããã®ããã¤ãã®ä¾ã¨ãªãä¸è¡ééã +追å ããã¾ããã + =back =head3 L<perlre> @@ -2478,9 +2663,17 @@ =item * +=begin original + The C<(*COMMIT)> directive is now listed in the right section (L<Verbs without an argument|perlre/Verbs without an argument>). +=end original + +C<(*COMMIT)> æ示åã¯æ£ããç¯ +(L<Verbs without an argument|perlre/Verbs without an argument>) ã« +æããããããã«ãªãã¾ããã + =back =head3 L<perlrun> @@ -2489,10 +2682,18 @@ =item * +=begin original + L<perlrun> has undergone a significant clean-up. Most notably, the B<-0x...> form of the B<-0> flag has been clarified, and the final section on environment variables has been corrected and expanded (5.14.1). +=end original + +L<perlrun> ã¯å¤§å¹ ã«æ´çããã¾ããã +æã注ç®ããã¹ãæã¯ãB<-0> ãã©ã°ã® B<-0x...> å½¢å¼ãæ確åããã +ç°å¢å¤æ°ã®æå¾ã®ç¯ãä¿®æ£ãæ¡å¼µããã¾ãã(5.14.1)ã + =back =head3 L<perlsub> @@ -2501,10 +2702,17 @@ =item * +=begin original + The ($;) prototype syntax, which has existed for rather a long time, is now documented in L<perlsub>. It allows a unary function to have the same precedence as a list operator. +=end original + +ããªãé·ãéåå¨ãã¦ãã ($;) ãããã¿ã¤ãã L<perlsub> ã§ææ¸åããã¾ããã +ãªã¹ãæ¼ç®åã¨åãåªå é ä½ãæã¤åé é¢æ°ãå¯è½ã«ãªãã¾ãã + =back =head3 L<perltie> @@ -2513,8 +2721,14 @@ =item * +=begin original + The required syntax for tying handles has been documented. +=end original + +ãã³ãã«ã tie ããããã«å¿ è¦ãªææ³ãææ¸åããã¾ããã + =back =head3 L<perlvar> @@ -2523,16 +2737,33 @@ =item * +=begin original + The documentation for L<$!|perlvar/$!> has been corrected and clarified. It used to state that $! could be C<undef>, which is not the case. It was also unclear as to whether system calls set C's C<errno> or Perl's C<$!> [perl #91614]. +=end original + +L<$!|perlvar/$!> ã®ææ¸ãä¿®æ£ããæ確åããã¾ããã +以å㯠$! 㯠C<undef> ã«ãªããã¨ãããã¨æ¸ããã¦ãã¾ãããããããªããã¨ã¯ +ããã¾ããã§ããã +ã¾ããã·ã¹ãã ã³ã¼ã«ã C ã® C<errno> ãè¨å®ããã®ã Perl ã® C<$!> ã +è¨å®ããã®ããä¸æ確ã§ãã [perl #91614]ã + =item * +=begin original + Documentation for L<$$|perlvar/$$> has been amended with additional cautions regarding changing the process ID. +=end original + +L<$$|perlvar/$$> ã®ææ¸ã¯ãããã»ã¹ ID ã®å¤æ´ã«é¢ãã追å ã®æ³¨æã +追è¨ããã¾ããã + =back =head3 Other Changes