Doc #51333 [Opn->Fbk]: SNMP documentation is very poor
| From: | philip@php.net | 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