<html>
<head>
<meta content="text/html; charset=iso-8859-2"
http-equiv="Content-Type">
</head>
<body text="#000000" bgcolor="#FFFFFF">
Tak nejak to vidim aj ja s doxygen. Nepouzivam ho, ale ako sa v nom
zapisuju "navody" a popisy k funkciam sa mi paci a pouzivam to tak,
len pre seba. Vedlajsi efekt je, ze keby na to niekto ten doxygen
pustil, tak by z toho asi ta dokumentacia vznikla :) ale ako
niektore IDE pchaju hviezdicky a podobne veci do komentarov vadi aj
mne. C++ komentare zas pouzivam na zapoznamkovanie kusku kodu, ked
nieco odladujem a niektore editory ho daju inou farbou ako bezny
blok poznamky a to mi tiez vyhovuje. Vsetko je hned jasnejsie, co je
poznamka a co "vypnuty kod" :)<br>
<br>
Jaro<br>
<br>
<br>
<div class="moz-cite-prefix">On 06/18/2015 01:48 PM, Milan B. wrote:<br>
</div>
<blockquote cite="mid:5582B018.4090701@bastl.sk" type="cite">
<meta content="text/html; charset=iso-8859-2"
http-equiv="Content-Type">
<div class="moz-cite-prefix">On 6/18/2015 11:57 AM, Karel M wrote:<br>
</div>
<br>
<blockquote
cite="mid:CAN7Z6qLKvu-r46LdOzTYnkocg6YZPTQzf+V2nLYKYv1=34SY7w@mail.gmail.com"
type="cite">
<div dir="ltr">
<div> Doxygen mi přijde jako zanášející bordel do kodu a dělá
jej tak nepřehledným.</div>
</div>
</blockquote>
<br>
Ale no...<br>
<br>
Bordel si tam zanasate sam, pripadne nejake to IDE ci kodovy
generator ktore ich tam sam strka. Doxygen komentare si predsa
pisete sam a formatujete si ich tak, ako chcete; doxygen je
pomerne tolerantny. Tych par klucovych slov zase az tak vela
bordelu nenarobi. Vo vysledku sa doxygenizovany kod sa nemusi
prilis lisit od normalne okomentovaneho kodu. To ze nejake IDE
generuje skarede doxygen komentare neznamena, ze take musia byt.<br>
<br>
Osobne tiez nemam rad ten vseobecne presadzovany a prezentovany
rozvleceny format C-ckovych komentarov. Uprednostnujem C++
komentare, vysledok je kompaktnejsi a prehladnejsi. Ale to je
otazka osobnych preferencii.<br>
<br>
Ale doxygen je kazdopadne dokumentacia kodu, nie dokumentacia
projektu. <br>
<br>
Doxygen moze mat jeden pekny vedlajsi efekt: ked clovek vidi
vygenerovany vystup, tak zacne pisat komentare tak, aby davali
zmysel. <br>
<br>
-m-<br>
<br>
<br>
<blockquote
cite="mid:CAN7Z6qLKvu-r46LdOzTYnkocg6YZPTQzf+V2nLYKYv1=34SY7w@mail.gmail.com"
type="cite">
<div dir="ltr">
<div> Bloková schémata zas příliš jednoduchá nepopisující
souvislosti. Nejde o to popsat každý řádek funkce, spíš něco
co když přečtu tak získám obecný přehled co se tam děje.<br>
</div>
K.<br>
</div>
<div class="gmail_extra"><br>
<div class="gmail_quote">Dne 18. června 2015 10:58 Jan
Waclawek <span dir="ltr"><<a moz-do-not-send="true"
href="mailto:konfera@efton.sk" target="_blank">konfera@efton.sk</a>></span>
napsal(a):<br>
<blockquote class="gmail_quote" style="margin:0 0 0
.8ex;border-left:1px #ccc solid;padding-left:1ex">Pozrite
<a moz-do-not-send="true"
href="http://www.efton.sk/misc/snake.zip"
rel="noreferrer" target="_blank">http://www.efton.sk/misc/snake.zip</a>
(robi to toto:<br>
<a moz-do-not-send="true"
href="https://www.youtube.com/watch?v=pCx6SKWVDkw"
rel="noreferrer" target="_blank">https://www.youtube.com/watch?v=pCx6SKWVDkw</a>)<br>
<br>
Vyznate sa v tom? Tak to berte ako kladny priklad. Ak nie,
berte to ako<br>
zaporny priklad.<br>
<br>
wek<br>
<br>
<br>
PS. zrejme Vam doporucia doxygen - ja osobne to mam
rovnako nerad ako<br>
arduino ;-)<br>
<div>
<div class="h5"><br>
<br>
<br>
----- Original Message ---------------<br>
<br>
>Pěkný den, rád bych provedl dokumentaci programu
psaného v C určeného pro<br>
>MCU AVR, tak aby to snadno mohl převzít jiný
programátor, nebo i já sám<br>
>když bych se po čase k programu vrátil. Bohužel s
tím nemám žádné<br>
>zkušenosti, chtěl bych Vás poprosit, zda nemáte
nějaký naučný příklad.<br>
>Díky<br>
>Karel M.<br>
<br>
</div>
</div>
_______________________________________________<br>
HW-list mailing list - sponsored by <a
moz-do-not-send="true" href="http://www.HW.cz"
rel="noreferrer" target="_blank">www.HW.cz</a><br>
<a moz-do-not-send="true" href="mailto:Hw-list@list.hw.cz">Hw-list@list.hw.cz</a><br>
<a moz-do-not-send="true"
href="http://list.hw.cz/mailman/listinfo/hw-list"
rel="noreferrer" target="_blank">http://list.hw.cz/mailman/listinfo/hw-list</a><br>
</blockquote>
</div>
<br>
</div>
<br>
<fieldset class="mimeAttachmentHeader"></fieldset>
<br>
<pre wrap="">_______________________________________________
HW-list mailing list - sponsored by <a moz-do-not-send="true" class="moz-txt-link-abbreviated" href="http://www.HW.cz">www.HW.cz</a>
<a moz-do-not-send="true" class="moz-txt-link-abbreviated" href="mailto:Hw-list@list.hw.cz">Hw-list@list.hw.cz</a>
<a moz-do-not-send="true" class="moz-txt-link-freetext" href="http://list.hw.cz/mailman/listinfo/hw-list">http://list.hw.cz/mailman/listinfo/hw-list</a>
</pre>
</blockquote>
<br>
<br>
<fieldset class="mimeAttachmentHeader"></fieldset>
<br>
<pre wrap="">_______________________________________________
HW-list mailing list - sponsored by <a class="moz-txt-link-abbreviated" href="http://www.HW.cz">www.HW.cz</a>
<a class="moz-txt-link-abbreviated" href="mailto:Hw-list@list.hw.cz">Hw-list@list.hw.cz</a>
<a class="moz-txt-link-freetext" href="http://list.hw.cz/mailman/listinfo/hw-list">http://list.hw.cz/mailman/listinfo/hw-list</a>
</pre>
</blockquote>
<br>
</body>
</html>