[p4] How to use Perforce P4/PERL API to get filelog info?

[David Foglesong]

> The section called "P4::Revision" (near the middle-top of the document)
> does NOT includes an entry for the Integrations() function.

No, the summary table doesn't list the Integrations() class method. So the Perforce tech writers need to update the table to include it. I'm sure if you send an email to P4 support, they'll do that. (Posting it here most likely won't help, since P4 support doesn't actively monitor this list.)

If you scroll further down on that same page to where the P4::Revision class is explained in detail (describing the data type that gets returned from each method, etc.), the Integrations() method is listed there.

----------------------------------------
> Subject: RE: [p4] How to use Perforce P4/PERL API to get filelog info?
> Date: Tue, 26 Jan 2010 14:30:38 -0600
> From: SGross at sjm.com
> To: defoglesong at msn.com; jeff.n.grills at disney.com; perforce-user at perforce.com
>
>> Coming from many years of using Perl, I'd disagree. The POD text in a
>> module is the canonical reference for how to use the module. Online
>> documentation can get separated from the module or out of date, but
> the
>> POD is always there. If you're using Perl, running perldoc should be
>> the first step when using a module. (And if the module doesn't have
> POD
>> text, the author should get pinged to add it.)
>>
>> I'd expect the Python API to provide the same info via pydoc, Java API
>> to have JavaDoc comments, etc., for the same reasons.
>
> It's the responsibility of the vendor to offer up-to-date, accurate
> documentation everywhere. Perforce's responsibility is to ensure that
> all of their "official" documentation is correct. As a customer, I
> assume the correctness of the content on Perforce's website; I shouldn't
> have to second-guess that information.
>
>> FWIW, the online docs do reference the Integrations() method. It's a
>> method on the P4::Revision object:
>>
> http://www.perforce.com/perforce/doc.092/manuals/p4script/02_perl.html#
>> 1051751
>
> The reference documentation I used was:
>
> http://www.perforce.com/perforce/doc.current/manuals/p4script/02_perl.ht
> ml#1047951
>
> The section called "P4::Revision" (near the middle-top of the document)
> does NOT includes an entry for the Integrations() function.
>
> --Steve
>
> This communication, including any attachments, may contain information that is proprietary, privileged, confidential or legally exempt from disclosure. If you are not a named addressee, you are hereby notified that you are not authorized to read, print, retain a copy of or disseminate any portion of this communication without the consent of the sender and that doing so may be unlawful. If you have received this communication in error, please immediately notify the sender via return e-mail and delete it from your system.
 		 	   		  
_________________________________________________________________
Hotmail: Free, trusted and rich email service.
http://clk.atdmt.com/GBL/go/196390708/direct/01/