Doc #51333 [Fbk->NoF]: SNMP documentation is very poor

From: Date: Mon, 18 Feb 2013 00:34:10 +0000
Subject: Doc #51333 [Fbk->NoF]: SNMP documentation is very poor
References: 1  Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-9534@lists.php.net to get a copy of this message
Edit report at https://bugs.php.net/bug.php?id=51333&edit=1 ID: 51333 Updated by: php-bugs@lists.php.net Reported by: miken32 at gmail dot com Summary: SNMP documentation is very poor -Status: Feedback +Status: No Feedback Type: Documentation Problem Package: Documentation problem PHP Version: Irrelevant New Comment: No feedback was provided. The bug is being suspended because we assume that you are no longer experiencing the problem. If this is not the case and you are able to provide the information that was requested earlier, please do so and change the status of the bug back to "Open". Thank you. Previous Comments: ------------------------------------------------------------------------ [2010-10-25 09:02:34] philip@php.net Automatic comment from SVN on behalf of philip Revision: http://svn.php.net/viewvc/?view=revision&revision=304728 Log: Added skeletons for missing snmp functions. Almost closes PHP bug #51333 ------------------------------------------------------------------------ [2010-10-20 19:30:38] philip@php.net Consider https://edit.php.net/ :) I don't see anyone updating these docs in the near future, so maybe you're willing to tackle them? I'll create skeletons for the missing extensions, so at least people can leave user notes. User notes exist so they can be researched then folded into the manual proper, and this is especially useful for uncommonly used extensions like snmp. ------------------------------------------------------------------------ [2010-03-19 16:53:32] miken32 at gmail dot com Description: ------------ There are more undocumented functions than documented ones. And even many of the documented functions state "This function is currently not documented; only its argument list is available." No mention is made anywhere of support for SNMP versions 2c and 3, although browsing snmp.c one can find these things. I've always been impressed with PHP's documentation, and didn't file this bug years ago because I was always expecting the SNMP docs to be finished one day. Maybe some documentation work needs to be opened to the community in a wiki fashion? The user comments fill in many blanks but can't make up for totally undocumented functions. ------------------------------------------------------------------------ -- Edit this bug report at https://bugs.php.net/bug.php?id=51333&edit=1

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