<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">Zkuste GITBOOK. Je to online služba,
ale můžete si stáhnout řádkové nástroje na generování dokumentace
(jsou opensource).<br>
Dokumentace se píše pomocí jednoduchého značkovacího jazyka
Markdown. <a class="moz-txt-link-freetext" href="http://gitbookio.gitbooks.io/markdown/content/">http://gitbookio.gitbooks.io/markdown/content/</a><br>
<br>
Dokumentace je primárně v HTML, ale lze ji zkonvertovat do EPUB
nebo PDF.<br>
<br>
Já jsem používal Publican, což je generátor postavený nad DocBook,
ale bohužel poslední verze se mi nedaří bezchybně rozběhat na
Ubuntu. Tak jsem našel GitBook.<br>
<br>
Pokus o dokumentaci, která byla dříve v Publicanu je na
<a class="moz-txt-link-freetext" href="http://ondrejjanovsky.gitbooks.io/m2mscript/content/">http://ondrejjanovsky.gitbooks.io/m2mscript/content/</a> <br>
<br>
Oja<br>
<br>
<br>
Dne 18.6.2015 v 11:57 Karel M napsal(a):<br>
</div>
<blockquote
cite="mid:CAN7Z6qLKvu-r46LdOzTYnkocg6YZPTQzf+V2nLYKYv1=34SY7w@mail.gmail.com"
type="cite">
<div dir="ltr">
<div>Ano, vyznal bych se v tom, ale měl jsem na mysli něco jako
souhrnný dokument, obsahující např. jaké funkce mám k
dispozici, jaké procesy se dějí v přerušení od timerů, prostě
celkový náhled na složitý projekt násobně větší než ten snake
game. Doxygen mi přijde jako zanášející bordel do kodu a dělá
jej tak nepřehledným. 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>
<br>
<div class="moz-signature">-- <br>
<b>Ondřej Janovský<br>
Alarex-Group s.r.o.<br>
</b>
<br>
mobil: +420 723 616 751<br>
em@il: <a class="moz-txt-link-abbreviated" href="mailto:ondrej.janovsky@alarex.cz">ondrej.janovsky@alarex.cz</a>
<br>
<br>
<a href="http://www.m2marchitect.cz">www.m2marchitect.cz</a><br>
<a href="http://www.alarex.cz">www.alarex.cz</a></div>
</body>
</html>