[perl.git] branch drolsky/oo-docs, created. v5.15.2-41-g6aa70a5

In perl.git, the branch drolsky/oo-docs has been created

<http://perl5.git.perl.org/perl.git/commitdiff/6aa70a5ba5254c1ea02e56934e9931fe6cd5437b?hp=0000000000000000000000000000000000000000>

        at  6aa70a5ba5254c1ea02e56934e9931fe6cd5437b (commit)

- Log -----------------------------------------------------------------
commit 6aa70a5ba5254c1ea02e56934e9931fe6cd5437b
Author: Dave Rolsky <autarch@urth.org>
Date:   Sun Jul 10 21:58:33 2011 -0500

    Lots of updates based on feedback from sprout, including a few new sections

M	pod/perlobj.pod

commit 621313edafa347de65bfdddd270f7246c45dcaa9
Author: Dave Rolsky <autarch@urth.org>
Date:   Sun Jul 10 18:52:33 2011 -0500

    Some changes based no sprout's feedback

M	pod/perlootut.pod

commit 7a1d9a2deaa95a6a1074ecdecec777f7932497a7
Author: Dave Rolsky <autarch@urth.org>
Date:   Fri Jul 8 17:49:13 2011 -0500

    fix now-broken link to removed section in perlobj

M	cpan/Test-Simple/t/Builder/reset.t
M	pod/perlref.pod

commit ec82c89f544ca54bf488bbe89745e26df0034e21
Author: Dave Rolsky <autarch@urth.org>
Date:   Thu Jul 7 14:32:59 2011 -0500

    Add perldelta entries for all doc changes

M	pod/perldelta.pod

commit 0866c2ae5220a946fa95104ee769a84494305b19
Author: Dave Rolsky <autarch@urth.org>
Date:   Thu Jul 7 14:07:53 2011 -0500

    Redo all examples using File and File::MP3

M	pod/perlootut.pod

commit a626b4e9ebd0c16d88ca3c765dea1b10eecae525
Author: Dave Rolsky <autarch@urth.org>
Date:   Thu Jul 7 13:45:45 2011 -0500

    Remove all references to old OO tutorial docs, and add refs to perlootut where appropriate
    
    Used buildtoc to regenerate pod-related files

M	MANIFEST
M	dist/perlfaq/lib/perlfaq2.pod
M	dist/perlfaq/lib/perlfaq3.pod
M	dist/perlfaq/lib/perlfaq4.pod
M	dist/perlfaq/lib/perlfaq7.pod
M	plan9/mkfile
M	pod.lst
M	pod/perl.pod
M	pod/perlfunc.pod
M	pod/perlintro.pod
M	pod/perlmod.pod
M	pod/perlmodlib.PL
M	pod/perlref.pod
M	pod/perlsub.pod
M	pod/roffitall
M	t/porting/known_pod_issues.dat
M	win32/pod.mak

commit 2069e932ea38ce8e7f87c7000c2976e7589904c6
Author: Dave Rolsky <autarch@urth.org>
Date:   Thu Jul 7 11:43:25 2011 -0500

    remove all old OO tutorials (and perlbot)

D	pod/perlboot.pod
D	pod/perlbot.pod
D	pod/perltooc.pod
D	pod/perltoot.pod

commit 54227c51d5d5e9cad290e6ddfe7354864e539bdc
Author: Dave Rolsky <autarch@urth.org>
Date:   Thu Jul 7 13:51:28 2011 -0500

    Small revisions to the text to increase clarity, suggested by Philip Monsen

M	pod/perlootut.pod

commit c6d65f4ec175b2773aea510261d2a2d98a0b3b6e
Author: Dave Rolsky <autarch@urth.org>
Date:   Thu Jul 7 10:47:35 2011 -0500

    Add more details on inside-out objects from David Golden, and an inside-out class example from Abigail.
    
    Add strict & warning to blessed scalar class example

M	pod/perlobj.pod

commit b411e0236fea51abeac7fce7e9b8755690adbcc8
Author: Dave Rolsky <autarch@urth.org>
Date:   Thu Jul 7 11:35:00 2011 -0500

    heavily revised perlobj.pod

M	pod/perlobj.pod

commit 16b7a4416c4b859abc664c7b37799b5fdd658022
Author: Dave Rolsky <autarch@urth.org>
Date:   Wed Mar 23 10:38:28 2011 -0500

    Use same list of "when to use OO" criteria in perlmodstyle as in perlootut
    
    See my previous commit message for permission from ORA to use this text under
    the same license as Perl itself.

M	pod/perlmodstyle.pod

commit 563dc43992f82aaa9b7ef18dc79712cacd765ac0
Author: Dave Rolsky <autarch@urth.org>
Date:   Wed Mar 23 10:00:05 2011 -0500

    Add Damian's list of when to use OO - copied from PBP
    
    Here's the email from Teri Finn at O'Reilly giving us permission to do so:
    
    -------------------------------------------------------------------------
    
    Dave,
    
    O'Reilly Media is happy to grant you the permissions you have requested below.
    
    If you are able to include the copyright notice in the attribution that would be great.
    
    Damian Conway wrote about when to use OO in Perl Best Practices, Copyright © 2004, Published by O'Reilly Media, Inc.
     His list of criteria for doing so is:
    
    Our best to you on your project.
    
    Teri Finn
    O'Reilly Media, Inc.
    
    ----- Original Message -----
    From: "Dave Rolsky" <autarch@urth.org>
    To: permissions@oreilly.com
    Cc: damian@conway.org
    Sent: Sunday, March 6, 2011 6:58:34 PM GMT -08:00 US/Canada Pacific
    Subject: Usage of text from Perl Best Practices
    
    Hi, ORA,
    
    I'm working on the Perl 5 core documentation, specifically on a new OO
    tutorial. I'd like to include Damian's "when to use OO" list as published
    in Perl Best Practices (pages 320-321).
    
    I don't want to include the entire text verbatim, just the bullet points.
    
    I wrote to Damian and he is okay with having this included in the docs,
    just as an FYI.
    
    To do this, I'd need permission to include the text and distribute it
    under the same license as Perl 5 itself, which is currently version 1 of
    the Artistic license.
    
    I would of course credit Damian and note the book, something like ....
    
       Damian Conway wrote about when to use OO in Perl Best Practices. His
       list of criteria for doing so is:
    
    Thanks,
    
    -dave

M	pod/perlootut.pod

commit 47785d72fb497301287a5c560fd0a4d884b400e8
Author: Dave Rolsky <autarch@urth.org>
Date:   Thu Jul 7 11:36:37 2011 -0500

    Check in new OO tutorial - perlootut

A	pod/perlootut.pod
-----------------------------------------------------------------------

--
Perl5 Master Repository

• [perl.git] branch drolsky/oo-docs, created. v5.15.2-41-g6aa70a5 by Dave Rolsky