Registrace nového uživatele     Návod     Kluby     Archív  Lopuchu     Lopuch.cz  

Komu se nelení,
tomu se zelení.

Lopuch.cz
Jméno:
Heslo:
Podpora LCD:
 
Klub Programování [ŽP: neomezená] (kategorie Programování) moderuje tvx.
Archiv
  Nastavení klubu     Nastavení práv     Homepage     Anketa     Přítomní     Oblíbené     Lopuch     Kategorie  
autor: 
text: 
vyplnit a 
Help
 Titulek, text příspěvku  
Opište pozpátku následující text bez prostředního znaku: ikzbnwv
[ 857 ] <Novější  <<<Nejnovější  Nejstarší>>>  Starší>  
bredy 27.9.2006 09:26  526
_davedoporucuju doxygen. A pak shortcut do prostredi "vygeneruj dokumentaci"

Zvlaste v době navrhu nějakých tříd, kdy člověk píše syntaxi, ale funkčních částí kódu je málo, píšu hodně dokumentaci ke každé částí tímto stylem. V IDE pak jedním tlačítkem vypadne dokumentace toho co jsem napsal včetně všech vztahů mezi třídami a člověk si může zkotrolovat správnost souvislostí.
_dave 25.9.2006 22:24  525
osobne pisu komentare u funkci stylem
/**
* popis funkce
* @params parametry - popis
* @return navratove hodnoty
**/

a ve zdrojacich funkci jen u slozitejsich konstrukci a algoritmu. Dale pak u datovych struktur.
No je to klasicky zapis komentaru pro JavaDoc ale naucil jsem se to pouzivat treba v Delphi ci C++ ono to silene setri praci (i kdyz vam javadoc nevygeneruje tu dokumentaci)
nekromancer 25.9.2006 14:26  524
mach: No, to už je hodně přehnaný. Lpší je jen na začátku funkce popsat spíš rámcově a stručně co je jejím úkolem a konkrétní algoritmus už čtenář pochopí sám, případně se ještě zdokumentují "magická čísla", pokud jejich smysl nevyplyne z použitého řešení. Je blbost komentovat každou řádku třídícího nebo hledacího algoritmu; stačí uvést co to dělá, jaké jsou parametry a co to vrací.
mach 25.9.2006 14:22  523
Vdyt tam nejsou zadny komentare. V nejakym navodu na psani dokumentace k zapoctaku je napsany, ze komentar ma byt i u radku typu:

pocet_aut++;
druh_5618 Druh_5618 25.9.2006 14:11  522
A na těchhle konkrétních příkladech?
operator304 25.9.2006 12:49  521
Herout je borec. Jeho literaturu fakt doporucuju. Vono i nazivo to stoji za to.
nekromancer 25.9.2006 11:45  520
DRUH: velice dobrou metodiku čtení zdrojáků uváděl Pavel Herout v Učebnici jazyka C. V podstatě jen do podrobností rozvedené to, co píše _dave. Z názvů funkcí a kostry aplikace pochopíš její základní filosofii, a podrobnosti si v případě potřeby dohledáš. Rozhodně je blbost to číst všechno komplet podrobně, kromě toho leccos se dá odhadnout i z formátování a odsazení textu bez toho že bys to vůbec četl, zvlášť pokud máš editor, který klíčová slova vysází kapitálkami a názvy proměnných obarví podle typu a autor důsledně dodržoval schéma pro pojmenovávání funkcí a proměnných. To si pak připadáš jak Cipher v Matrixu :-) Prostě to vidíš.
A čtení výrazů se samozřejmě řídí logikou jazyka, obecně platí že ve složitějších výrazech je přehlednější používat závorky i když je pořadí operátorů zrovna nevyžaduje.
_dave 25.9.2006 11:35  519
no aspon ja ctu zdrojaky tou nejjednodusi moznou metodou: prectu si nazvy funkci/metod a komentare k funkci pripadne dokumentaci, pokdu je. Kdyz neni tak se to snazim odhadnout podle toho kde je pouzita a pripadne jak se jmenuje. Dokud nepotrebuju tak se nepoustim do cteni samotnych tel funkci, kdyz potrebuju tuto funkci do sveho programu tak se snazim implementovat celou funkci pokud mozno beze zmen.
druh_5618 Druh_5618 25.9.2006 08:37  518
Návod na čtení zdrojáků? Myslím, že jednou z věcí, která chybí středně pokročilým, je že je nikdo neučí ČÍST zdrojové kódy. Maximálně se objeví "Čtěte", ale ne JAK číst.
Mohl by mi některý zkušenější kolega popsat proces, jakým postupuje, když se mu do ruky dostane nějaký zdroják???


Pro začátek například sft13, který bych řek, že jsem snad i pochopil.
Potom třeba JpegCrop, který je dost rozsáhlý (za prozkomání stojí celá doména). Já vím, jak funguje JPEG, ale než psát vlastní implementaci, bude rozumnější snažit se pochopit (upravit si) tuhle.
operator304 31.8.2006 07:28  517
DRUH 5618Dobry, uz jsem na vsechno co jsem potreboval prisel :-)
druh_5618 Druh_5618 30.8.2006 13:29  516
operator304 Bohužel ano. Ptej se…
operator304 29.8.2006 18:50  515
Zdar. Ma tu nekdo zkusenost v programovani skriptu v Matlabu?
king King Born to be king - ... 24.8.2006 15:54  514
imho urcite python
tvx tvx Myslet si, že svět je JEN takový, jak - ho v daný čas můžeme pochopit je hloupé. 24.8.2006 14:38  513
jakej jazyk bude nejlepsi na programovani sem tam nejaky linux aplikace, nejlip sem tam i s nejakym tim gui oknem a to interpretovany? napada me python/perl? pricemz python asi bude v tomto smeru vymakanejsi?
bredy 24.8.2006 11:24  512
Pro inspiraci (C++)Multiple Interface a Instance Factory
[ 857 ] <Novější  <<<Nejnovější  Nejstarší>>>  Starší>  

(c) 2001-2011 Lopuch.cz   
Kontakt