php - phpDocumentor does not override docs of parent class -

-

so, have following setup:

class {      /**      * documentation      */     public function foo() {}  }  class b extends {      /**      * documentation way more specific in class      */     public function foo() {}  }

when try document phpdocumentor2 displays @ method foo() class b "this documentation", i'd " documentation way more specific in class a". in phpdocumenter 1, looks expected. so, going on here? new default behavior of phpdocumentor2? , if so, there way change it? or bug?

note: while doing research, bumped {@inheritdoc}, i'd have exact opposite behavior.

what expecting see in example should happening -- a::foo() should show "this documentation" while b::foo() should show "this documentation way more specific in class a". if that's not happening, bug. please open issue @ https://github.com/phpdocumentor/phpdocumentor2 on it.

as aside, intent of {@inheritdoc} embed a::foo()'s long description somewhere in middle of b::foo()'s overall doc. having descriptions in b::foo()'s docblock, sort of override proper default behavior of a::foo()'s info being automatically inherited b::foo(). {@inheritdoc} tag created had opportunity write description b::foo() , still able include description a::foo(). placement of {@inheritdoc} in b::foo()'s docblock meant control a:foo()'s description appear in b's overall description.

a vast majority of usage see in wild {@inheritdoc} people think must used inherit descriptions , tags parent. think has been due buggy implementations in phpdoc 1.x natural inheritance did not work correctly, , therefore people thought tag had used, though still did not give them after.


Comments

Post a Comment

Popular posts from this blog

java - Run a .jar on Heroku -

-
i trying run .jar file on heroku, , can't find instructions anywhere on how this. have read wants me compile uploading heroku. possible, , if is, how this? if helps, trying run minecraft craftbukkit server, , don't have pom.xml file yet. you didn't provide details i'll try give , people reaches question way it. first of all, create heroku account , create heroku application (assumed have done that). second, need generate application jar , upload heroku. so, open terminal , install heroku cli (assuming unix terminal): $ sudo npm install -g heroku-cli you need have npm , nodejs installed, can check link: https://www.digitalocean.com/community/tutorials/how-to-install-node-js-on-ubuntu-16-04 once done that, can use npm update node version acceptable heroku-cli: $ sudo npm install -g n $ sudo n 7.10.0 and run: $ sudo npm install -g heroku-cli in order deploy jars, need install deploy plugin: $ sudo heroku plugins:install heroku-cli-deploy ...
Read more

java - Jtable duplicate Rows -

-
Image
when add new rows in jtable duplicate rows many times this method update jtable public final void tableaucomande(){ ((defaulttablemodel)tabcommande.getmodel()).getdatavector().clear(); session s=hibernateutil.getsessionfactory().opensession(); criteria cr1= s.createcriteria(commande.class); list <commande> lcs=cr1.list() ; criteria cr2= s.createcriteria(lignecommande.class); list <lignecommande> lck=cr2.list() ; if(lcs.size()!=0 && lck.size()!=0) { (commande lc:lcs) { for(lignecommande lig:lck){ ((defaulttablemodel)tabcommande.getmodel()).addrow(new object[]{ lc.getid_cmd(),lc.getnumcmd(),lc.getdate_cmd(),lc.getclient().getnomprenom(), lig.getproduit().getlib_prd(),lig.getquantite(),lig.getproduit().getid_prd() }); } } // tabcommande.setrowselectioninterval(tabcommande.getrowcount()-1,tabcommande.getrowcount()-1); } } this code add add data rows displaye...
Read more

validation - How to pass paramaters like unix into windows batch file -

-
i need pass various parameters .cmd file unix format file.cmd -configuration=value -source=value -flag but, try this: startlocal @echo off cls setlocal set cmdline=%* set configuration= set source= set badargs= set validation= goto main :splitargs echo splitargs(%*) if "%*" neq "" ( /f "tokens=1,2,* delims== " %%i in ("%*") call :assignkeyvalue %%i %%j & call :splitargs %%k ) goto :eof :assignkeyvalue echo assignkeyvalue(%1, %2) if /i %1==-configuration ( set configuration=%2 ) else if /i %1==-source ( set source=%2 ) else ( rem append unrecognised [key,value] badargs echo unknown key %1 set badargs=%badargs%[%1, %2] ) goto :eof :validate echo validating set validation=fail if defined configuration ( echo -configuration ok if defined source ( echo -source ok if not defined badargs ( set validation=success ) ) ) goto :eof :main cl...
Read more