php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Doc Bug #52306 finfo procedural/oop syntax
Submitted: 2010-07-11 15:41 UTC Modified: 2010-09-21 18:09 UTC
From: ch@php.net Assigned: markskilbeck (profile)
Status: Closed Package: Documentation problem
PHP Version: Irrelevant OS:
Private report: No CVE-ID: None
 [2010-07-11 15:41 UTC] ch@php.net
Description:
------------
http://de3.php.net/manual/en/function.finfo-file.php currently reads:

----------------------------------------
Description
  string finfo_file ( resource $finfo , string $file_name = NULL [, int $options = FILEINFO_NONE [, resource $context = NULL ]] )

     finfo
       string file ( string $file_name = NULL [, int $options = FILEINFO_NONE [, resource $context = NULL ]] )
----------------------------------------

Where file is a hyperlink to the PHP file() function. It was not quite clear to me what this syntax description of a file() function was trying to tell me until I came across http://de3.php.net/manual/en/function.finfo-open.php which clearly describes the first as "procedural style" and the second as "object oriented style:".
Maybe that can be done for the other functions, too.


Test script:
---------------
-

Expected result:
----------------
-

Actual result:
--------------
-

Patches

Add a Patch

Pull Requests

Add a Pull Request

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2010-09-20 18:34 UTC] philip@php.net
-Summary: finfo_file irritating method syntax +Summary: finfo procedural/oop syntax
 [2010-09-20 18:34 UTC] philip@php.net
Changing this bug. I no longer see the file() link but all of the finfo 
documentation should better explain the oop/procedural differences.
 [2010-09-21 18:08 UTC] markskilbeck@php.net
Automatic comment from SVN on behalf of markskilbeck
Revision: http://svn.php.net/viewvc/?view=revision&revision=303644
Log: Clarifies documentation (procedural vs oop) re #52306
 [2010-09-21 18:09 UTC] markskilbeck@php.net
-Status: Open +Status: Closed -Assigned To: +Assigned To: markskilbeck
 [2010-09-21 18:09 UTC] markskilbeck@php.net
This bug has been fixed in the documentation's XML sources. Since the
online and downloadable versions of the documentation need some time
to get updated, we would like to ask you to be a bit patient.

Thank you for the report, and for helping us make our documentation better.

I've added the procedural vs. OOP stuff :)
 
PHP Copyright © 2001-2024 The PHP Group
All rights reserved.
Last updated: Mon Jun 17 00:01:29 2024 UTC