Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Method call documentation in perlobj.pod #9600

Closed
p5pRT opened this issue Dec 16, 2008 · 5 comments
Closed

Method call documentation in perlobj.pod #9600

p5pRT opened this issue Dec 16, 2008 · 5 comments
Labels
documentation

Comments

@p5pRT
Copy link

p5pRT commented Dec 16, 2008

Migrated from rt.perl.org#61392 (status was 'resolved')

Searchable as RT61392$
@p5pRT
Copy link
Author

p5pRT commented Dec 16, 2008

From @ig3

Following brief discussion on PerlMonks
(http​://www.perlmonks.org/?node_id=730166)
I submit the following patch to perlobj.pod
for your consideration.

$ diff -u /usr/lib/perl5/5.8.8/pod/perlobj.pod ./perlobj.pod
--- /usr/lib/perl5/5.8.8/pod/perlobj.pod 2008-09-18
05​:40​:09.000000000 +1200
+++ ./perlobj.pod 2008-12-16 17​:12​:27.000000000 +1300
@​@​ -312,6 +312,19 @​@​
scalar variable containing either the method name or a subroutine
  reference can also be used.
 
  +If the right side of the arrow is a scalar containing a reference
  +to a subroutine then this is equivalent to calling the referenced
  +subroutine directly with the class name or object on the left side
  +of the arrow as its first argument. No lookup is done and there is
  +no requirement that the subroutine be defined in any package related
  +to the class name or object on the left side of the arrow.
  +
  +For example, the following calls to $display are equivalent​:
  +
  + my $display = sub { my $self = shift; ... };
  + $fred->$display("Height", "Weight");
  + $display->($fred, "Height", "Weight");
  +
  =head2 Indirect Object Syntax
  X<indirect object syntax> X<invocation, indirect> X<indirect>
 
 
Regards,
Ian Goodacre

@p5pRT
Copy link
Author

p5pRT commented Dec 16, 2008

From @ig3

Created by @ig3

Following brief discussion on PerlMonks
(http​://www.perlmonks.org/?node_id=730166)
I submit the following patch to perlobj.pod
for your consideration.

$ diff -u /usr/lib/perl5/5.8.8/pod/perlobj.pod ./perlobj.pod

Inline Patch 
--- /usr/lib/perl5/5.8.8/pod/perlobj.pod        2008-09-18 05:40:09.000000000 +1200
+++ ./perlobj.pod       2008-12-16 17:12:27.000000000 +1300
@@ -312,6 +312,19 @@
 scalar variable containing either the method name or a subroutine 
  reference can also be used.
   
   +If the right side of the arrow is a scalar containing a reference
   +to a subroutine then this is equivalent to calling the referenced
   +subroutine directly with the class name or object on the left side
   +of the arrow as its first argument. No lookup is done and there is

  +no requirement that the subroutine be defined in any package related
  +to the class name or object on the left side of the arrow.
  +
  +For example, the following calls to $display are equivalent​:
  +
  + my $display = sub { my $self = shift; ... };
  + $fred->$display("Height", "Weight");
  + $display->($fred, "Height", "Weight");
  +
  =head2 Indirect Object Syntax
  X<indirect object syntax> X<invocation, indirect> X<indirect>
 
 

Perl Info 

Flags:
    category=docs
    severity=low

This perlbug was built using Perl v5.8.8 in the Red Hat build system.
It is being executed now by Perl v5.8.8 - Wed Sep 17 13:36:13 EDT 2008.

Site configuration information for perl v5.8.8:

Configured by Red Hat, Inc. at Wed Sep 17 13:36:13 EDT 2008.

Summary of my perl5 (revision 5 version 8 subversion 8) configuration:
  Platform:
    osname=linux, osvers=2.6.18-53.1.14.el5pae, archname=i386-linux-thread-multi
    uname='linux builder16.centos.org 2.6.18-53.1.14.el5pae #1 smp wed mar 5 12:07:47 est 2008 i686 athlon i386 gnulinux '
    config_args='-des -Doptimize=-O2 -g -pipe -Wall -Wp,-D_FORTIFY_SOURCE=2 -fexceptions -fstack-protector --param=ssp-buffer-size=4 -m32 -march=i386 -mtune=generic -fasynchronous-unwind-tables -Dversion=5.8.8 -Dmyhostname=localhost -Dperladmin=root@localhost -Dcc=gcc -Dcf_by=Red Hat, Inc. -Dinstallprefix=/usr -Dprefix=/usr -Darchname=i386-linux -Dvendorprefix=/usr -Dsiteprefix=/usr -Duseshrplib -Dusethreads -Duseithreads -Duselargefiles -Dd_dosuid -Dd_semctl_semun -Di_db -Ui_ndbm -Di_gdbm -Di_shadow -Di_syslog -Dman3ext=3pm -Duseperlio -Dinstallusrbinperl=n -Ubincompat5005 -Uversiononly -Dpager=/usr/bin/less -isr -Dd_gethostent_r_proto -Ud_endhostent_r_proto -Ud_sethostent_r_proto -Ud_endprotoent_r_proto -Ud_setprotoent_r_proto -Ud_endservent_r_proto -Ud_setservent_r_proto -Dinc_version_list=5.8.7 5.8.6 5.8.5 -Dscriptdir=/usr/bin'
    hint=recommended, useposix=true, d_sigaction=define
    usethreads=define use5005threads=undef useithreads=define usemultiplicity=define
    useperlio=define d_sfio=undef uselargefiles=define usesocks=undef
    use64bitint=undef use64bitall=undef uselongdouble=undef
    usemymalloc=n, bincompat5005=undef
  Compiler:
    cc='gcc', ccflags ='-D_REENTRANT -D_GNU_SOURCE -fno-strict-aliasing -pipe -Wdeclaration-after-statement -I/usr/local/include -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -I/usr/include/gdbm',
    optimize='-O2 -g -pipe -Wall -Wp,-D_FORTIFY_SOURCE=2 -fexceptions -fstack-protector --param=ssp-buffer-size=4 -m32 -march=i386 -mtune=generic -fasynchronous-unwind-tables',
    cppflags='-D_REENTRANT -D_GNU_SOURCE -fno-strict-aliasing -pipe -Wdeclaration-after-statement -I/usr/local/include -I/usr/include/gdbm'
    ccversion='', gccversion='4.1.2 20071124 (Red Hat 4.1.2-42)', gccosandvers=''
    intsize=4, longsize=4, ptrsize=4, doublesize=8, byteorder=1234
    d_longlong=define, longlongsize=8, d_longdbl=define, longdblsize=12
    ivtype='long', ivsize=4, nvtype='double', nvsize=8, Off_t='off_t', lseeksize=8
    alignbytes=4, prototype=define
  Linker and Libraries:
    ld='gcc', ldflags =' -L/usr/local/lib'
    libpth=/usr/local/lib /lib /usr/lib
    libs=-lresolv -lnsl -lgdbm -ldb -ldl -lm -lcrypt -lutil -lpthread -lc
    perllibs=-lresolv -lnsl -ldl -lm -lcrypt -lutil -lpthread -lc
    libc=/lib/libc-2.5.so, so=so, useshrplib=true, libperl=libperl.so
    gnulibc_version='2.5'
  Dynamic Linking:
    dlsrc=dl_dlopen.xs, dlext=so, d_dlsymun=undef, ccdlflags='-Wl,-E -Wl,-rpath,/usr/lib/perl5/5.8.8/i386-linux-thread-multi/CORE'
    cccdlflags='-fPIC', lddlflags='-shared -O2 -g -pipe -Wall -Wp,-D_FORTIFY_SOURCE=2 -fexceptions -fstack-protector --param=ssp-buffer-size=4 -m32 -march=i386 -mtune=generic -fasynchronous-unwind-tables -L/usr/local/lib'

Locally applied patches:
    


@INC for perl v5.8.8:
    /usr/lib/perl5/site_perl/5.8.8/i386-linux-thread-multi
    /usr/lib/perl5/site_perl/5.8.7/i386-linux-thread-multi
    /usr/lib/perl5/site_perl/5.8.6/i386-linux-thread-multi
    /usr/lib/perl5/site_perl/5.8.5/i386-linux-thread-multi
    /usr/lib/perl5/site_perl/5.8.8
    /usr/lib/perl5/site_perl/5.8.7
    /usr/lib/perl5/site_perl/5.8.6
    /usr/lib/perl5/site_perl/5.8.5
    /usr/lib/perl5/site_perl
    /usr/lib/perl5/vendor_perl/5.8.8/i386-linux-thread-multi
    /usr/lib/perl5/vendor_perl/5.8.7/i386-linux-thread-multi
    /usr/lib/perl5/vendor_perl/5.8.6/i386-linux-thread-multi
    /usr/lib/perl5/vendor_perl/5.8.5/i386-linux-thread-multi
    /usr/lib/perl5/vendor_perl/5.8.8
    /usr/lib/perl5/vendor_perl/5.8.7
    /usr/lib/perl5/vendor_perl/5.8.6
    /usr/lib/perl5/vendor_perl/5.8.5
    /usr/lib/perl5/vendor_perl
    /usr/lib/perl5/5.8.8/i386-linux-thread-multi
    /usr/lib/perl5/5.8.8
    .


Environment for perl v5.8.8:
    HOME=/home/ian
    LANG=en_NZ.UTF-8
    LANGUAGE (unset)
    LD_LIBRARY_PATH (unset)
    LOGDIR (unset)
    PATH=/usr/kerberos/bin:/usr/local/bin:/usr/bin:/bin:/usr/X11R6/bin:/home/ian/bin:/sbin
    PERLDOC_PAGER=less
    PERL_BADLANG (unset)
    SHELL=/bin/bash

@p5pRT
Copy link
Author

p5pRT commented Jan 2, 2009

From @rgs

Thanks, applied to bleadperl.

@p5pRT
Copy link
Author

p5pRT commented Jan 2, 2009

The RT System itself - Status changed from 'new' to 'open'

@p5pRT
Copy link
Author

p5pRT commented Jan 2, 2009

@rgs - Status changed from 'open' to 'resolved'

@p5pRT p5pRT closed this as completed Jan 2, 2009
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
documentation
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
1 participant
@p5pRT