Context
&warn.undocumented.func; renders as "This function is currently not documented; only its argument list is available." It is still used in 302 files, spread over 24 extensions. On those pages a reader gets a signature and nothing else: no behaviour, no parameter semantics, no return value description.
This is a tracking issue, not a proposal to change anything about the entity itself. It just puts the remaining occurrences in one place so they can be picked up individually.
Scope
Extensions planned to move to the third-party extension manual are excluded. The filter used is the target column of the migration table in php/doc-extensions#12, so only books that stay in this manual are listed.
The list reflects the state of master at the time of writing and may drift slightly as pages are fixed.
How to help
Pick any file, write the missing description, remove the entity. There is no need to claim a whole extension: one file is a perfectly good contribution, and the small ones (ftp, image, posix, soap, ...) are a reasonable place to start.
- A file counts as done once
&warn.undocumented.func; is gone and replaced by a real description of what the function or method does.
- Filling in the parameter and return value sections is welcome but not required for the entity to go.
- Ticking the box below (or naming the file in the pull request) helps avoid two people writing the same page.
The occurrences can be re-derived at any time with:
$ grep -rl 'warn.undocumented.func' reference/
Remaining files
reference/spl (108)
reference/intl (81)
reference/reflection (21)
reference/sodium (19)
reference/random (15)
reference/ffi (14)
reference/ldap (8)
reference/mysqli (5)
reference/phpdbg (4)
reference/sockets (4)
reference/zlib (3)
reference/gmp (2)
reference/hash (2)
reference/openssl (2)
reference/pdo_sqlite (2)
reference/phar (2)
reference/pspell (2)
reference/stream (2)
reference/ftp (1)
reference/image (1)
reference/pdo (1)
reference/pgsql (1)
reference/posix (1)
reference/soap (1)
Context
&warn.undocumented.func;renders as "This function is currently not documented; only its argument list is available." It is still used in 302 files, spread over 24 extensions. On those pages a reader gets a signature and nothing else: no behaviour, no parameter semantics, no return value description.This is a tracking issue, not a proposal to change anything about the entity itself. It just puts the remaining occurrences in one place so they can be picked up individually.
Scope
Extensions planned to move to the third-party extension manual are excluded. The filter used is the target column of the migration table in php/doc-extensions#12, so only books that stay in this manual are listed.
The list reflects the state of
masterat the time of writing and may drift slightly as pages are fixed.How to help
Pick any file, write the missing description, remove the entity. There is no need to claim a whole extension: one file is a perfectly good contribution, and the small ones (
ftp,image,posix,soap, ...) are a reasonable place to start.&warn.undocumented.func;is gone and replaced by a real description of what the function or method does.The occurrences can be re-derived at any time with:
$ grep -rl 'warn.undocumented.func' reference/Remaining files
reference/spl(108)reference/spl/arrayiterator/append.xmlreference/spl/arrayiterator/construct.xmlreference/spl/arrayiterator/count.xmlreference/spl/arrayiterator/getarraycopy.xmlreference/spl/arrayiterator/offsetexists.xmlreference/spl/arrayiterator/offsetget.xmlreference/spl/arrayiterator/offsetset.xmlreference/spl/arrayiterator/serialize.xmlreference/spl/arrayiterator/unserialize.xmlreference/spl/arrayobject/serialize.xmlreference/spl/arrayobject/unserialize.xmlreference/spl/cachingiterator/construct.xmlreference/spl/cachingiterator/count.xmlreference/spl/cachingiterator/current.xmlreference/spl/cachingiterator/getflags.xmlreference/spl/cachingiterator/hasnext.xmlreference/spl/cachingiterator/key.xmlreference/spl/cachingiterator/next.xmlreference/spl/cachingiterator/offsetexists.xmlreference/spl/cachingiterator/offsetget.xmlreference/spl/cachingiterator/offsetset.xmlreference/spl/cachingiterator/offsetunset.xmlreference/spl/cachingiterator/rewind.xmlreference/spl/cachingiterator/setflags.xmlreference/spl/cachingiterator/tostring.xmlreference/spl/cachingiterator/valid.xmlreference/spl/emptyiterator/current.xmlreference/spl/emptyiterator/key.xmlreference/spl/emptyiterator/next.xmlreference/spl/emptyiterator/rewind.xmlreference/spl/filteriterator/construct.xmlreference/spl/filteriterator/current.xmlreference/spl/filteriterator/key.xmlreference/spl/filteriterator/next.xmlreference/spl/filteriterator/rewind.xmlreference/spl/multipleiterator/attachiterator.xmlreference/spl/multipleiterator/containsiterator.xmlreference/spl/multipleiterator/countiterators.xmlreference/spl/multipleiterator/current.xmlreference/spl/multipleiterator/detachiterator.xmlreference/spl/multipleiterator/getflags.xmlreference/spl/multipleiterator/key.xmlreference/spl/multipleiterator/next.xmlreference/spl/multipleiterator/rewind.xmlreference/spl/multipleiterator/setflags.xmlreference/spl/multipleiterator/valid.xmlreference/spl/norewinditerator/current.xmlreference/spl/norewinditerator/key.xmlreference/spl/norewinditerator/next.xmlreference/spl/norewinditerator/valid.xmlreference/spl/parentiterator/accept.xmlreference/spl/parentiterator/construct.xmlreference/spl/parentiterator/getchildren.xmlreference/spl/parentiterator/haschildren.xmlreference/spl/parentiterator/next.xmlreference/spl/parentiterator/rewind.xmlreference/spl/recursivecachingiterator/construct.xmlreference/spl/recursivecachingiterator/getchildren.xmlreference/spl/recursivecachingiterator/haschildren.xmlreference/spl/recursivedirectoryiterator/getchildren.xmlreference/spl/recursivedirectoryiterator/haschildren.xmlreference/spl/recursivedirectoryiterator/key.xmlreference/spl/recursivedirectoryiterator/next.xmlreference/spl/recursivedirectoryiterator/rewind.xmlreference/spl/recursiveiteratoriterator/beginchildren.xmlreference/spl/recursiveiteratoriterator/beginiteration.xmlreference/spl/recursiveiteratoriterator/callhaschildren.xmlreference/spl/recursiveiteratoriterator/current.xmlreference/spl/recursiveiteratoriterator/endchildren.xmlreference/spl/recursiveiteratoriterator/enditeration.xmlreference/spl/recursiveiteratoriterator/getdepth.xmlreference/spl/recursiveiteratoriterator/getinneriterator.xmlreference/spl/recursiveiteratoriterator/getmaxdepth.xmlreference/spl/recursiveiteratoriterator/getsubiterator.xmlreference/spl/recursiveiteratoriterator/key.xmlreference/spl/recursiveiteratoriterator/next.xmlreference/spl/recursiveiteratoriterator/nextelement.xmlreference/spl/recursiveiteratoriterator/rewind.xmlreference/spl/recursiveiteratoriterator/setmaxdepth.xmlreference/spl/recursiveiteratoriterator/valid.xmlreference/spl/recursivetreeiterator/beginchildren.xmlreference/spl/recursivetreeiterator/beginiteration.xmlreference/spl/recursivetreeiterator/callgetchildren.xmlreference/spl/recursivetreeiterator/callhaschildren.xmlreference/spl/recursivetreeiterator/construct.xmlreference/spl/recursivetreeiterator/current.xmlreference/spl/recursivetreeiterator/endchildren.xmlreference/spl/recursivetreeiterator/enditeration.xmlreference/spl/recursivetreeiterator/getentry.xmlreference/spl/recursivetreeiterator/getpostfix.xmlreference/spl/recursivetreeiterator/getprefix.xmlreference/spl/recursivetreeiterator/key.xmlreference/spl/recursivetreeiterator/next.xmlreference/spl/recursivetreeiterator/nextelement.xmlreference/spl/recursivetreeiterator/rewind.xmlreference/spl/recursivetreeiterator/setpostfix.xmlreference/spl/recursivetreeiterator/setprefixpart.xmlreference/spl/recursivetreeiterator/valid.xmlreference/spl/regexiterator/getregex.xmlreference/spl/spldoublylinkedlist/serialize.xmlreference/spl/spldoublylinkedlist/unserialize.xmlreference/spl/splfixedarray/serialize.xmlreference/spl/splfixedarray/unserialize.xmlreference/spl/splobserver/update.xmlreference/spl/splpriorityqueue/getextractflags.xmlreference/spl/splsubject/attach.xmlreference/spl/splsubject/detach.xmlreference/spl/splsubject/notify.xmlreference/intl(81)reference/intl/intlbreakiterator/createcharacterinstance.xmlreference/intl/intlbreakiterator/createcodepointinstance.xmlreference/intl/intlbreakiterator/createlineinstance.xmlreference/intl/intlbreakiterator/createsentenceinstance.xmlreference/intl/intlbreakiterator/createtitleinstance.xmlreference/intl/intlbreakiterator/createwordinstance.xmlreference/intl/intlbreakiterator/current.xmlreference/intl/intlbreakiterator/first.xmlreference/intl/intlbreakiterator/following.xmlreference/intl/intlbreakiterator/geterrorcode.xmlreference/intl/intlbreakiterator/geterrormessage.xmlreference/intl/intlbreakiterator/getlocale.xmlreference/intl/intlbreakiterator/getpartsiterator.xmlreference/intl/intlbreakiterator/gettext.xmlreference/intl/intlbreakiterator/isboundary.xmlreference/intl/intlbreakiterator/last.xmlreference/intl/intlbreakiterator/next.xmlreference/intl/intlbreakiterator/preceding.xmlreference/intl/intlbreakiterator/previous.xmlreference/intl/intlbreakiterator/settext.xmlreference/intl/intlcodepointbreakiterator/getlastcodepoint.xmlreference/intl/intlgregoriancalendar/construct.xmlreference/intl/intliterator/current.xmlreference/intl/intliterator/key.xmlreference/intl/intliterator/next.xmlreference/intl/intliterator/rewind.xmlreference/intl/intliterator/valid.xmlreference/intl/intlpartsiterator/getbreakiterator.xmlreference/intl/intlrulebasedbreakiterator/construct.xmlreference/intl/intlrulebasedbreakiterator/getbinaryrules.xmlreference/intl/intlrulebasedbreakiterator/getrules.xmlreference/intl/intlrulebasedbreakiterator/getrulestatus.xmlreference/intl/intlrulebasedbreakiterator/getrulestatusvec.xmlreference/intl/intltimezone/countequivalentids.xmlreference/intl/intltimezone/createdefault.xmlreference/intl/intltimezone/createenumeration.xmlreference/intl/intltimezone/createtimezone.xmlreference/intl/intltimezone/createtimezoneidenumeration.xmlreference/intl/intltimezone/fromdatetimezone.xmlreference/intl/intltimezone/getcanonicalid.xmlreference/intl/intltimezone/getdisplayname.xmlreference/intl/intltimezone/getdstsavings.xmlreference/intl/intltimezone/getequivalentid.xmlreference/intl/intltimezone/geterrorcode.xmlreference/intl/intltimezone/geterrormessage.xmlreference/intl/intltimezone/getgmt.xmlreference/intl/intltimezone/getid.xmlreference/intl/intltimezone/getidforwindowsid.xmlreference/intl/intltimezone/getoffset.xmlreference/intl/intltimezone/getrawoffset.xmlreference/intl/intltimezone/getregion.xmlreference/intl/intltimezone/gettzdataversion.xmlreference/intl/intltimezone/getunknown.xmlreference/intl/intltimezone/getwindowsid.xmlreference/intl/intltimezone/hassamerules.xmlreference/intl/intltimezone/todatetimezone.xmlreference/intl/intltimezone/usedaylighttime.xmlreference/intl/spoofchecker/setallowedlocales.xmlreference/intl/transliterator/create.xmlreference/intl/transliterator/createfromrules.xmlreference/intl/transliterator/createinverse.xmlreference/intl/transliterator/geterrorcode.xmlreference/intl/transliterator/geterrormessage.xmlreference/intl/uconverter/construct.xmlreference/intl/uconverter/convert.xmlreference/intl/uconverter/fromucallback.xmlreference/intl/uconverter/getaliases.xmlreference/intl/uconverter/getavailable.xmlreference/intl/uconverter/getdestinationencoding.xmlreference/intl/uconverter/getdestinationtype.xmlreference/intl/uconverter/geterrorcode.xmlreference/intl/uconverter/geterrormessage.xmlreference/intl/uconverter/getsourceencoding.xmlreference/intl/uconverter/getsourcetype.xmlreference/intl/uconverter/getstandards.xmlreference/intl/uconverter/getsubstchars.xmlreference/intl/uconverter/reasontext.xmlreference/intl/uconverter/setdestinationencoding.xmlreference/intl/uconverter/setsourceencoding.xmlreference/intl/uconverter/setsubstchars.xmlreference/intl/uconverter/toucallback.xmlreference/reflection(21)reference/reflection/reflection/export.xmlreference/reflection/reflectionclassconstant/export.xmlreference/reflection/reflectionobject/export.xmlreference/reflection/reflectionparameter/clone.xmlreference/reflection/reflectionparameter/export.xmlreference/reflection/reflectionparameter/getclass.xmlreference/reflection/reflectionparameter/iscallable.xmlreference/reflection/reflectionproperty/clone.xmlreference/reflection/reflectionproperty/export.xmlreference/reflection/reflectionproperty/getrawvalue.xmlreference/reflection/reflectionproperty/hashooks.xmlreference/reflection/reflectionproperty/isfinal.xmlreference/reflection/reflectionzendextension/clone.xmlreference/reflection/reflectionzendextension/export.xmlreference/reflection/reflectionzendextension/getauthor.xmlreference/reflection/reflectionzendextension/getcopyright.xmlreference/reflection/reflectionzendextension/getname.xmlreference/reflection/reflectionzendextension/geturl.xmlreference/reflection/reflectionzendextension/getversion.xmlreference/reflection/reflectionzendextension/tostring.xmlreference/reflection/reflector/export.xmlreference/sodium(19)reference/sodium/functions/sodium-crypto-core-ristretto255-add.xmlreference/sodium/functions/sodium-crypto-core-ristretto255-from-hash.xmlreference/sodium/functions/sodium-crypto-core-ristretto255-is-valid-point.xmlreference/sodium/functions/sodium-crypto-core-ristretto255-random.xmlreference/sodium/functions/sodium-crypto-core-ristretto255-scalar-add.xmlreference/sodium/functions/sodium-crypto-core-ristretto255-scalar-complement.xmlreference/sodium/functions/sodium-crypto-core-ristretto255-scalar-invert.xmlreference/sodium/functions/sodium-crypto-core-ristretto255-scalar-mul.xmlreference/sodium/functions/sodium-crypto-core-ristretto255-scalar-negate.xmlreference/sodium/functions/sodium-crypto-core-ristretto255-scalar-random.xmlreference/sodium/functions/sodium-crypto-core-ristretto255-scalar-reduce.xmlreference/sodium/functions/sodium-crypto-core-ristretto255-scalar-sub.xmlreference/sodium/functions/sodium-crypto-core-ristretto255-sub.xmlreference/sodium/functions/sodium-crypto-kx-seed-keypair.xmlreference/sodium/functions/sodium-crypto-pwhash-scryptsalsa208sha256-str-verify.xmlreference/sodium/functions/sodium-crypto-pwhash-scryptsalsa208sha256-str.xmlreference/sodium/functions/sodium-crypto-scalarmult-ristretto255-base.xmlreference/sodium/functions/sodium-crypto-scalarmult-ristretto255.xmlreference/sodium/functions/sodium-crypto-shorthash-keygen.xmlreference/random(15)reference/random/random/engine/mt19937/debuginfo.xmlreference/random/random/engine/mt19937/generate.xmlreference/random/random/engine/mt19937/serialize.xmlreference/random/random/engine/mt19937/unserialize.xmlreference/random/random/engine/pcgoneseq128xslrr64/debuginfo.xmlreference/random/random/engine/pcgoneseq128xslrr64/generate.xmlreference/random/random/engine/pcgoneseq128xslrr64/serialize.xmlreference/random/random/engine/pcgoneseq128xslrr64/unserialize.xmlreference/random/random/engine/xoshiro256starstar/debuginfo.xmlreference/random/random/engine/xoshiro256starstar/generate.xmlreference/random/random/engine/xoshiro256starstar/serialize.xmlreference/random/random/engine/xoshiro256starstar/unserialize.xmlreference/random/random/randomizer/construct.xmlreference/random/random/randomizer/serialize.xmlreference/random/random/randomizer/unserialize.xmlreference/ffi(14)reference/ffi/ctype/getalignment.xmlreference/ffi/ctype/getarrayelementtype.xmlreference/ffi/ctype/getarraylength.xmlreference/ffi/ctype/getattributes.xmlreference/ffi/ctype/getenumkind.xmlreference/ffi/ctype/getfuncabi.xmlreference/ffi/ctype/getfuncreturntype.xmlreference/ffi/ctype/getkind.xmlreference/ffi/ctype/getname.xmlreference/ffi/ctype/getpointertype.xmlreference/ffi/ctype/getsize.xmlreference/ffi/ctype/getstructfieldnames.xmlreference/ffi/ctype/getstructfieldoffset.xmlreference/ffi/ctype/getstructfieldtype.xmlreference/ldap(8)reference/ldap/functions/ldap-connect-wallet.xmlreference/ldap/functions/ldap-first-reference.xmlreference/ldap/functions/ldap-next-reference.xmlreference/ldap/functions/ldap-parse-reference.xmlreference/ldap/functions/ldap-sasl-bind.xmlreference/ldap/functions/ldap-set-rebind-proc.xmlreference/ldap/functions/ldap-start-tls.xmlreference/ldap/functions/ldap-t61-to-8859.xmlreference/mysqli(5)reference/mysqli/mysqli_driver/embedded-server-end.xmlreference/mysqli/mysqli_driver/embedded-server-start.xmlreference/mysqli/mysqli_result/getiterator.xmlreference/mysqli/mysqli_stmt/get-warnings.xmlreference/mysqli/mysqli_stmt/insert-id.xmlreference/phpdbg(4)reference/phpdbg/functions/phpdbg-end-oplog.xmlreference/phpdbg/functions/phpdbg-exec.xmlreference/phpdbg/functions/phpdbg-get-executable.xmlreference/phpdbg/functions/phpdbg-start-oplog.xmlreference/sockets(4)reference/sockets/functions/socket-cmsg-space.xmlreference/sockets/functions/socket-export-stream.xmlreference/sockets/functions/socket-recvmsg.xmlreference/sockets/functions/socket-sendmsg.xmlreference/zlib(3)reference/zlib/functions/inflate-get-read-len.xmlreference/zlib/functions/zlib-decode.xmlreference/zlib/functions/zlib-encode.xmlreference/gmp(2)reference/gmp/gmp/serialize.xmlreference/gmp/gmp/unserialize.xmlreference/hash(2)reference/hash/hashcontext/serialize.xmlreference/hash/hashcontext/unserialize.xmlreference/openssl(2)reference/openssl/functions/openssl-cms-read.xmlreference/openssl/functions/openssl-pkcs7-read.xmlreference/pdo_sqlite(2)reference/pdo_sqlite/pdo/sqlite/loadextension.xmlreference/pdo_sqlite/pdo/sqlite/openblob.xmlreference/phar(2)reference/phar/Phar/getAlias.xmlreference/phar/Phar/getPath.xmlreference/pspell(2)reference/pspell/functions/pspell-config-data-dir.xmlreference/pspell/functions/pspell-config-dict-dir.xmlreference/stream(2)reference/stream/functions/stream-bucket-append.xmlreference/stream/functions/stream-bucket-new.xmlreference/ftp(1)reference/ftp/functions/ftp-append.xmlreference/image(1)reference/image/functions/imageaffine.xmlreference/pdo(1)reference/pdo/pdostatement/getiterator.xmlreference/pgsql(1)reference/pgsql/functions/pg-socket.xmlreference/posix(1)reference/posix/functions/posix-pathconf.xmlreference/soap(1)reference/soap/soapclient/getcookies.xml