<html>
<head>
<meta content="text/html; charset=iso-8859-2"
http-equiv="Content-Type">
</head>
<body bgcolor="#FFFFFF" text="#000000">
<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 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>