|  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Doc Bug #54892 Confusing optional parameter in fbsql_autocommit()
Submitted: 2011-05-20 14:22 UTC Modified: 2011-07-02 18:55 UTC
From: gwarnants at gmail dot com Assigned:
Status: Wont fix Package: Documentation problem
PHP Version: Irrelevant OS:
Private report: No CVE-ID: None
View Add Comment Developer Edit
Welcome! If you don't have a Git account, you can't do anything here.
You can add a comment by following this link or if you reported this bug, you can edit this bug over here.
Block user comment
Status: Assign to:
Bug Type:
From: gwarnants at gmail dot com
New email:
PHP Version: OS:


 [2011-05-20 14:22 UTC] gwarnants at gmail dot com
From manual page:

In the function prototype, the first parameter is truly not optional. But in the parameter description, we can read it can be not specified. So either it should be surrounded with brackets in the prototype or there is something wrong in the description.

"If optional and not specified, the function will try to find an open link to the FrontBase server"



Add a Patch

Pull Requests

Add a Pull Request


AllCommentsChangesGit/SVN commitsRelated reports
 [2011-06-30 01:04 UTC]
The online documentation editor link relevant to this bug report:
 [2011-07-02 18:55 UTC]
-Status: Open +Status: Wont fix
 [2011-07-02 18:55 UTC]
In the manual sources, we use something called language-snippets entities to 
reduce the number of times we have to copy the same text between multiple 
reference pages.

All of the fbsql functions which have the link_identifier parameter use a 
language snippet which that produces the parameter description you see. The 
reason it sounds weird is that some functions have that parameter as optional, 
while others don't.

So what the description is saying is that *when* it's optional, and not 
specified, it'll do <x>. Otherwise, it'll of course throw an error about a 
parameter being missing.

I don't feel that this possibly-confusing text warrants rewriting all of the 
parameter descriptions for fbsql functions, so I'm going to set this bug to 
PHP Copyright © 2001-2024 The PHP Group
All rights reserved.
Last updated: Fri Apr 12 15:01:30 2024 UTC