Crystal -- 2009-03-08
röviden a javadoc-ról: ez a JDK (java developer kit) által tartalmazott dokumentációs eszköz, ami nagyon hasznos tud lenni, mert a forráskódba beírt kommentekből (a javadoc kommenteknek kicsit speciális szintaxisuk van de ebbe most nem megyek bele) tud az adott programhoz, API-hoz dokumentációt készíteni. Ennek nagyon örülünk, mert a speciális javadoc "tagek"-kel szépen, szisztematikusan tudjuk dokumentálni a programunkat, ami nagyon nagy segítség fejlesztéskor ill. API-k használatakor, maga a javadoc kommentek önmagukban sok jó lehetőséget adnak.
Na nem azér írok én postot a blogomba, hogy istenítsem a cuccot, ez csak a bevezető volt, most jön a fikázás. Totál falramászok tőle, hogy a javadoc a kommentekből html formátumú, frames doksit csinál, amiben nem lehet normálisan keresni, és az osztályok, interfészek stb ugyan megvannak egy oldalsó frameben, egy másikban pedig a csomagok szépen sorban, de ha az ember mondjuk keres egy metódust, ami nem tudja hogy melyik objektumon belül van, akkor már meg van lőve. A generált html-t ugyan lehet formázni ha jól tudom, de az alap frames szerkezet az marad. Nemtom mér nem lehet megoldani hogy a javadoc mondjuk chm formátumot is tudjon generálni, azt ezerszer könnyebb lenne használni, de néhanapján jól jönne a pdf is. Néhány API-hoz ugyan lehet találni a neten chm formátumot, de pl a Java SE doksiját nem lehet megtalálni a sun portálján, csak html formátumban (máshol találtam chm-et is).
Attól meg aztán főleg falramászok, hogy egyes vendorok nem teszik egy zip-ben letölthetővé a generált javadocot, hanem a html-t szépen kinyomják a honlapjukra, aztán ha az ember azt használni akarja, akkor vagy turkál benne online, amitől én alapból fázok (nagy élmény mikor be van lassulva a szeró), vagy letölti... úgy értem letölti a rahedni html-t tartalmazó mappát, parancssorból, wget -r -rel (nemtom van-e rá grafikus megoldás, meg azt se hogy windowsos alternatíva van-e) - hát ez teljesen nonszensz. Már nem tudom hanyadik doksit szedem wget -r, de most pl épp a Log4j doksi jön (magyarul egyáltalán nem jelentéktelen cucc doksija van hót amatőr módon publikálva). Falramászok, elegem van, borogassatok...
Na nem azér írok én postot a blogomba, hogy istenítsem a cuccot, ez csak a bevezető volt, most jön a fikázás. Totál falramászok tőle, hogy a javadoc a kommentekből html formátumú, frames doksit csinál, amiben nem lehet normálisan keresni, és az osztályok, interfészek stb ugyan megvannak egy oldalsó frameben, egy másikban pedig a csomagok szépen sorban, de ha az ember mondjuk keres egy metódust, ami nem tudja hogy melyik objektumon belül van, akkor már meg van lőve. A generált html-t ugyan lehet formázni ha jól tudom, de az alap frames szerkezet az marad. Nemtom mér nem lehet megoldani hogy a javadoc mondjuk chm formátumot is tudjon generálni, azt ezerszer könnyebb lenne használni, de néhanapján jól jönne a pdf is. Néhány API-hoz ugyan lehet találni a neten chm formátumot, de pl a Java SE doksiját nem lehet megtalálni a sun portálján, csak html formátumban (máshol találtam chm-et is).
Attól meg aztán főleg falramászok, hogy egyes vendorok nem teszik egy zip-ben letölthetővé a generált javadocot, hanem a html-t szépen kinyomják a honlapjukra, aztán ha az ember azt használni akarja, akkor vagy turkál benne online, amitől én alapból fázok (nagy élmény mikor be van lassulva a szeró), vagy letölti... úgy értem letölti a rahedni html-t tartalmazó mappát, parancssorból, wget -r -rel (nemtom van-e rá grafikus megoldás, meg azt se hogy windowsos alternatíva van-e) - hát ez teljesen nonszensz. Már nem tudom hanyadik doksit szedem wget -r, de most pl épp a Log4j doksi jön (magyarul egyáltalán nem jelentéktelen cucc doksija van hót amatőr módon publikálva). Falramászok, elegem van, borogassatok...
