Doc #51790 [NEW]: Some OpenSSL function parameters are underdocumented

From: Date: Tue, 11 May 2010 07:21:21 +0000
Subject: Doc #51790 [NEW]: Some OpenSSL function parameters are underdocumented
Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-4348@lists.php.net to get a copy of this message
From: aharvey Operating system: Irrelevant PHP version: Irrelevant Package: Documentation problem Bug Type: Documentation Problem Bug description:Some OpenSSL function parameters are underdocumented Description: ------------ A number of OpenSSL functions take "mixed $x509" parameters that are actually either resources or strings. The possible values are documented on a separate page within the OpenSSL chapter (namely "Key/Certificate Parameters"), but the function pages have blank parameter descriptions. It would be better if they either linked to the Key/Certificate Parameters page or included the text on the acceptable values themselves. openssl_x509_export() is an example that shows the problem: note the blank description under the x509 parameter. A similar issue also appears to apply to public and private key parameters within the OpenSSL documentation. -- Edit bug report at http://bugs.php.net/bug.php?id=51790&edit=1 -- Try a snapshot (PHP 5.2): http://bugs.php.net/fix.php?id=51790&r=trysnapshot52 Try a snapshot (PHP 5.3): http://bugs.php.net/fix.php?id=51790&r=trysnapshot53 Try a snapshot (PHP 6.0): http://bugs.php.net/fix.php?id=51790&r=trysnapshot60 Fixed in SVN: http://bugs.php.net/fix.php?id=51790&r=fixed Fixed in SVN and need be documented: http://bugs.php.net/fix.php?id=51790&r=needdocs Fixed in release: http://bugs.php.net/fix.php?id=51790&r=alreadyfixed Need backtrace: http://bugs.php.net/fix.php?id=51790&r=needtrace Need Reproduce Script: http://bugs.php.net/fix.php?id=51790&r=needscript Try newer version: http://bugs.php.net/fix.php?id=51790&r=oldversion Not developer issue: http://bugs.php.net/fix.php?id=51790&r=support Expected behavior: http://bugs.php.net/fix.php?id=51790&r=notwrong Not enough info: http://bugs.php.net/fix.php?id=51790&r=notenoughinfo Submitted twice: http://bugs.php.net/fix.php?id=51790&r=submittedtwice register_globals: http://bugs.php.net/fix.php?id=51790&r=globals PHP 4 support discontinued: http://bugs.php.net/fix.php?id=51790&r=php4 Daylight Savings: http://bugs.php.net/fix.php?id=51790&r=dst IIS Stability: http://bugs.php.net/fix.php?id=51790&r=isapi Install GNU Sed: http://bugs.php.net/fix.php?id=51790&r=gnused Floating point limitations: http://bugs.php.net/fix.php?id=51790&r=float No Zend Extensions: http://bugs.php.net/fix.php?id=51790&r=nozend MySQL Configuration Error: http://bugs.php.net/fix.php?id=51790&r=mysqlcfg

« previous php.doc.bugs (#4348) next »