Edit report at https://bugs.php.net/bug.php?id=76404&edit=1

 ID:                 76404
 Updated by:         [email protected]
 Reported by:        drankinatty at suddenlinkmail dot com
 Summary:            Why isn't there an easy way to navigate to fgetc
                     reference?
 Status:             Open
 Type:               Bug
 Package:            Website problem
 Operating System:   SuSE Leap 42.3
 PHP Version:        7.2.6
 Block user comment: N
 Private report:     N

 New Comment:

Every php.net page has a search field in the header. Typing "fget" there 
reveals this:

------------------------
  Functions:           8
------------------------
fgetc
 Gets character from file pointer

fgetcsv
 Gets line from file pointer and parse for CSV fields

fgets
 Gets line from file pointer

fgetss
 Gets line from file pointer and strip HTML tags

SplFileObject::fgetc
 Gets character from file

SplFileObject::fgetcsv
 Gets line from file and parse as CSV fields

SplFileObject::fgets
 Gets line from file

SplFileObject::fgetss
 Gets line from file and strip HTML tags
------------------------
>> Search php.net for fget
------------------------

Otherwise it sounds like you're looking for this:

  Function and Method listing
  (List of all the functions and methods in the manual)

    http://php.net/manual/en/indexes.functions.php


Previous Comments:
------------------------------------------------------------------------
[2018-06-02 10:33:09] [email protected]

> Where is the simply "File I/O".

https://secure.php.net/manual/en/book.filesystem.php

------------------------------------------------------------------------
[2018-06-02 02:08:48] a at b dot c dot de

If you know you're looking for fgetc (which you would be if you knew you'd need 
to look under 'f' in an index) then http://www.php.net/fgetc will take you to 
the page.

If you don't know the name, then an alphabetical list wouldn't be any help, 
because all that would do is group functions together arbitrarily by the first 
letter of their names - which you don't have. On the other hand, some 
categorisation is required, since There are (let's see...) up to 4747 functions 
in global scope depending on which recognised extensions are installed, and 
that's not counting object methods.

> Where is the simply "File I/O".
Probably under "Filesystem related functions". If I were skimming the list (or, 
given the length, using ctrl-f and searching for "file") that would be the 
standout for me.

> Why is printf buried under "Strings" -- it has absolutely nothing to do with 
> "strings" (other than being about to output one with the %s format-specifier.
It has even less to do with File I/O. It's a one-line wrapper around sprintf() 
(one line in the sense that every paragraph that describes it is a single line).

------------------------------------------------------------------------
[2018-06-02 01:14:05] drankinatty at suddenlinkmail dot com

Description:
------------
Guys (and girls),

  I have used a lot of technical references, as an engineer and attorney, and 
php.net is damn near impossible to navigate to find simple function references. 
I have to google to get to printf, and once there, there is no way to easily 
find a way to navigate to fgets or fgetc? Really.

  Your "Function Reference" isn't a function reference, instead it is a 
collection of extension and how to install them. Where is the simply "File 
I/O". Why is printf buried under "Strings" -- it has absolutely nothing to do 
with "strings" (other than being about to output one with the %s 
format-specifier.

  This is a great opportunity for improvement. A simple function reference for 
people looking to actually use real functions would greatly help. 

Expected result:
----------------
Just a simply function index - it can even just be an alphabetical dump of 
links to the functions. It would take a lot less time to scroll to 'f' than it 
currently does to play hide-and-go-seek across the php.net site looking for 
fgetc hidden somewhere.



------------------------------------------------------------------------



--
Edit this bug report at https://bugs.php.net/bug.php?id=76404&edit=1

-- 
PHP Webmaster List Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php

Reply via email to