neue Asuro Lib V2.70 (Release Candidate 3)

[Sternthaler]

schon den ein oder anderen Neuling überfordert.

Mhhmm, ich weiss nicht so recht. m.a.r.v.i.n hat die Datei install.txt angefangen und das ist ja schon ein funktionsfähiger Anfang.
OK, da kann man bestimmt noch dran arbeiten.
Wenn man aber davon ausgeht, dass bis jetzt ja noch nicht allzu viele Leute an der Lib mitgearbeitet haben und somit für die 'Endanwender' der Lib eigendlich nur noch das Kopieren an die richtige Stelle übrig bleibt, denke ich, dass doch auch Anfänger damit zurecht kommen werden.

Nun aber zu meinem ersten Muster aus der zerlegten m.a.r.v.i.n-Lib.
Als Anmerkung vorab:
Ich bin der Haarspalter und habe den angehängten Source nicht nur kommentiert (ganz bestimmt nicht im Sinne von Doxygen; den Hint von stochri habe ich jetzt gerade erst gelesen), sondern auch etwas umformatiert.
- Als erstes habe ich die TAB-Zeichen in BLANKS getauscht, so dass jeder beliebiege Editor einen einheitlich formatierten Text sehen kann.
- Dann habe ich vor die öffneden Klammern ( und [ immer ein Leerzeichen gesetzt.
- Alle Variablen und Funktionen habe ich 'besonders' eingerückt. Dazu folgendes Muster, warum ich das so gemacht habe:

volatile unsigned char  count36kHz;
static   unsigned char  global_daten1;
         unsigned long  global_daten2;
                  char  global_daten3 [100];


                  void  funktion (
         unsigned int  *data)
{
static   unsigned char  lokal_daten1;
         unsigned long  lokal_daten2;
                  char  lokal_daten3 [100];
}


static            int  *andere_funktion (
         unsigned int  *data,
                  char  steuerung)
{
static   unsigned char  lokal_daten1;
         unsigned long  lokal_daten2;
                  char  lokal_daten3 [100];
}

Und nun erst einmal die Datei adc.c als erster Versuch einer Kommentierung.