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

From: Date: Wed, 20 Oct 2010 17:30:38 +0000
Subject: Doc #51333 [Opn->Fbk]: SNMP documentation is very poor
References: 1  Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-5294@lists.php.net to get a copy of this message
Edit report at http://bugs.php.net/bug.php?id=51333&edit=1 ID: 51333 Updated by: philip@php.net Reported by: miken32 at gmail dot com Summary: SNMP documentation is very poor -Status: Open +Status: Feedback Type: Documentation Problem Package: Documentation problem PHP Version: Irrelevant Block user comment: N New Comment: 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. Previous Comments: ------------------------------------------------------------------------ [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 http://bugs.php.net/bug.php?id=51333&edit=1

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