Documentation Insight Express

2.11.2011 16:07:46 #

To je dobrá věc.

Zdeněk Vašků

3.11.2011 16:38:25 #

Zvláštní, ani Express edice, ani plná (podotákám že koupená:-)) přez CTRL+ALT+D mi NEfunguje. Mě to jede jen když napíšu "xdoc" a dám CTRL+J.

Někomu to na CTRL+ALT+D funguje?

B.

p.s. ...a určitě jsem nepřemapovával žádné klávesy

p.p.s. ..."bin\GenDocCLI.exe" jsem neznal! Zrovna hledám tool které to podporuje a nestojí 1000dolarů jak dot-o-matic, díky za info

bullhead

3.11.2011 16:59:11 #

- CTRL+SHIFT+D
...mi otevře/zavře Documentation Insight (ať už zadokované nebo otevřené), ale pokud chci opravdu do kódu dostat xdoc zančky (=/// apod) tak jedině přez "XDOC" a "ctrl+j" (zrovna se snažím rozšířit tu šablonu o další tagy).

- PasDoc
...kdysi ano, ale ten nepodporoval XDOC notaci (=xml ala VS) ale jen PasDoc notaci (ta už je asi překonaná). Na DoxyGen se podívám.

B.

bullhead

3.11.2011 17:16:45 #

...aaaaa ...tak v plné verzi je to jinak - NEjsou žádné záložky, jen nahoře je nějaké žlutá ikonka "switch between editing a reding" - pak jde v tom oklně opravdu editovat a po save se to promítne do kódu.

Postup:
1. otevření okna Documentation Insight
2. klik myší na to co chce člověk pookomentovat
3. objeví se prázdne tagy
4. klik na žlutou ikonu "edit mode"
5. něco do tagu dopsat
6. klik na save v Documentation Insight

B.

p.s. ...trochu mne irituje že generuje pokaždé:
  {$REGION 'Documentation'}
{$ENDREGION}
- to není nutné, XDOC dokumentace se dá defatultně v Delphi zbalit bez regionů ...pokusím se to vypnout

p.p.s ...díval jsem se teď na PasDoc, pokud se dobře dívám pořád neumí XDOC - jen PASDOC

bullhead

3.11.2011 17:20:59 #

...v option se dá ODšrtnout "Surround documentation withing a region" a pak to již NEgeneruje  "{$REGION 'Documentation'}" a je to čistý XDOC

...takže zbývá už jen rozjet korektní generování do CHM (nebo něčeho vyššího) jako program dokumentace

díky za navedení!

B.

bullhead

3.11.2011 17:38:44 #

Ještě pro info.

Pokud jsem něco nepřehlédl tak to umí jen okometovat Classy, funknce, procedury, variable ve var na úrovni unitu, ale např. variable ne úrovni už samotné procedury/funkce nebo komentáře v kódu to už ignoruje (takže tam zbýva "XDOC" + "CTRL+J"). Je zvláštní že ikonka "zabal všechny konmentáře" zabalí i ty kometáře co nevidí:-).

B.

bullhead

4.11.2011 11:59:36 #

Rozumím:-). Ale to je skoro rok kdy slibovali nějakou verzi a dodnes nic.

Našel jsem X toolu, hodně i freewarových (Precision helper apod.), prošel jsem možnosti Delphi (v option v Delphi se dá zapnout generovat XML dokumentaci), pokusím se to nějak komplexně rozjet (kod->kompilace->chm nebo něco podobného) a až budu mít nějaké reálné výsledky dám to zde - třeba to někdo využije.


B.

bullhead