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