Dokumentacija za svaku funkciju se nalazi u ovakvom obliku i sastoji se iz nekoliko blokova:

NAME - iza čega slijedi ime funkcije i kratak opis čemu služi.

SYNOPSIS - pokazuje način pozivanja iz C-a, a u drugom redu je objašnjenje u kom registru CPU-a treba staviti koji parametar ako funkciju pozivamo iz asemblera (nebitno za C).

Treći red je standardna deklaracija C funkcije (iz koje možemo vidjeti koje tipove podataka funkcija očekuje i šta vraća).

FUNCTION - Nešto detaljniji opis funkcije i način korištenja.

NOTES - Važne napomene i upozorenja.

INPUTS - Opisuje ulazne parametre.

RESULTS - Opisuje parametar koji funkcija vraća.

EXAMPLE - Za neku funkciju je dat i primjer korištenja.

BUGS - Greške koje funkcija eventualno ima/pravi.

SEE ALSO - Zadnja stavka koja nas upućuje na funkcije koje su u nekoj relaciji s ovom.

(Može se desiti da poneki od blokova i izostane.)

Da vidimo kako stoje stvari s našom funkcijom (OpenLibrary):
Ime znamo, a iz gore navedenog vidimo da zahtjeva dva parametra: ime i verziju biblioteke. Iz BUGS napomene vidimo da moramo voditi računa o malim i velikim slovima (uglavnom mala). Version je najmanja verzija biblioteke s kojom naš program može da radi, jer možda starija verzije biblioteke nema funkciju koja nam je potrebna ili je ima, ali je bagovana.

Za nesretnike s kompajlerima koji sami ne otvaraju biblioteke slijedi primjer. Ostali ga mogu i preskočiti da se ne bi zbunjivali bez potrebe. Primjer otvara DOS biblioteku i iz nje koristi funkciju Delay (pogledajte autodoc iz Developera za DOS biblioteku) koja pravi pauzu (u pedesetinkama) i ništa više:

#include <proto/exec.h>
#include <proto/dos.h>
struct DosLibrary *DOSBase;
main()
{
        DOSBase=(struct DosLibrary *)OpenLibrary("dos.library",0);
        if(DOSBase) {
                Delay (100);
                CloseLibrary ((struct Library *)DOSBase);
        }
}

Definiramo pointer tipa "DosLibrary" pod imenom "DOSBase" u koji će se smjestiti adresa DOS biblioteke pošto je otvorimo sa OpenLibrary. Zatim pozivamo funkciju Delay s parametrima "dos.library" i 0 (verzija nam nije važna, jer sve verzije imaju ovu funkciju). Da smo recimo za verziju stavili 39 naš program ne bi radio na Kickstart-ima ispod 3.0 , dok bi racimo sa 49 ne bi uopće radio jer ta verzija biblioteke jos uvijek ne postoji.

Kod nekih funkcija u AutoDoc-ovima je također navedeno od koje verzije biblioteke ta funkcija postoji.

Zatim provjeravamo da li je poziv uspješan - biblioteka otvorena. Ako jeste pozivamo funkciju Delay iz nje, ona čeka dvije sekunde i obavezno zatvaramo biblioteku funkcijom "CloseLibrary". Ako je sve bilo uspješno program će pauzirati i završiti se, a ako nije završit će se odmah.

Primjećuje se jedna nelogičnost: u Developer-u je navedeno da OpenLibrary vraca pointer na strukturu tipa Library, a mi sadržaj smještamo u pointer na strukturu tipa DosLibrary ?!? Pogled na

include:dos/dosextens.h

otkriva da je structura "Library" dio strukture "DosLibrary" i za sve ovo postoji racionalno objašnjenje, mada neki ipak vjeruju da je to dio zavjere iskusnih programera protiv programera početnika. :)

Kada se inkluduju neki "proto/nešto.h" headeri oni nadalje inkluduju skoro sve potrebne header fajlove za rad sa tom bibliotekom, ali nisu svi "proto" header fajlovi isti za sve kompajlere (neki ih čak i nemaju!), pa je ponekad potrebno navesti još po neki header fajl. Npr. iako imate:

#include <proto/exec.h>

morate dodati:

#include <exec/memory.h>

da bi mogli koristiti neke stvari u vezi rada s memorijom.

Srećom, ako imate (a najvjerojatnije imate) "pametan" kompajler koji će ovaj zbunjujući posao odraditi umjesto vas, cijeli ovaj program bi izgledao ovako:

#include <proto/dos.h>
main()
{
                Delay (100);
}

Ovako već može! Inkludujemo dos header i odmah nam je na raspolaganju Delay funkcija.

Bacite pogled i na ostale funkcije DOS biblioteke. Tu ćete naći funkcije za rad s fajlovima, alternativne onim objašnjenim u prošlom nastavku (vidi primjer).

Napišimo sada programčić koji će otvoriti prozor i naškrabati nešto u njemu:

Da vidimo prvo koje nam sve biblioteke trebaju.
Prvo, treba nam intuicija, jer se u njoj nalazi funkcija za otvaranje prozora. Intuicija dakle otvara prozore, ekrane, postavlja gadget-e i uopće vodi računa o interfejsu (GUI-u) programa.
Zatim, da bi nesto u tom prozorčiću iscrtali trebaju nam usluge grafičke biblioteke.
I na kraju, da sve to ne bi samo trepnulo pred našim očima inkludujemo i dos biblioteku zbog, sada nam već poznate, funkcije Delay.

#include <proto/intuition.h>
#include <proto/dos.h>
#include <proto/graphics.h>

Ok. Da vidimo sada kako ćemo otvoriti prozor. U developeru među funkcijama intuition biblioteke tražimo funkciju koja to radi i nalazimo "OpenWindow".

NAME
  OpenWindow -- Open an intuition window. 


SYNOPSIS
    Window = OpenWindow( NewWindow )
    D0                   A0

    struct Window *OpenWindow( struct NewWindow * ); 

      .   .   .

/* ======================================================== */
/* === NewWindow ========================================== */
/* ======================================================== */
/*
 * Note that the new extension fields have been removed.  Use ExtNewWindow
 * structure below to make use of these fields
 */
struct NewWindow
{
    WORD LeftEdge, TopEdge;		/* screen dimensions of window */
    WORD Width, Height;			/* screen dimensions of window */

    UBYTE DetailPen, BlockPen;		/* for bar/border/gadget rendering */

    ULONG IDCMPFlags;			/* User-selected IDCMP flags */

    ULONG Flags;			/* see Window struct for defines */

    /* You supply a linked-list of Gadgets for your Window.
     *	This list DOES NOT include system Gadgets.  You get the standard
     *	system Window Gadgets by setting flag-bits in the variable Flags (see
     *	the bit definitions under the Window structure definition)
     */
    struct Gadget *FirstGadget;

    /* the CheckMark is a pointer to the imagery that will be used when
     * rendering MenuItems of this Window that want to be checkmarked
     * if this is equal to NULL, you'll get the default imagery
     */
    struct Image *CheckMark;

    UBYTE *Title;			  /* the title text for this window */

    /* the Screen pointer is used only if you've defined a CUSTOMSCREEN and
     * want this Window to open in it.	If so, you pass the address of the
     * Custom Screen structure in this variable.  Otherwise, this variable
     * is ignored and doesn't have to be initialized.
     */
    struct Screen *Screen;

    /* WFLG_SUPER_BITMAP Window?  If so, put the address of your BitMap
     * structure in this variable.  If not, this variable is ignored and
     * doesn't have to be initialized
     */
    struct BitMap *BitMap;

    /* the values describe the minimum and maximum sizes of your Windows.
     * these matter only if you've chosen the WFLG_SIZEGADGET option,
     * which means that you want to let the User to change the size of
     * this Window.  You describe the minimum and maximum sizes that the
     * Window can grow by setting these variables.  You can initialize
     * any one these to zero, which will mean that you want to duplicate
     * the setting for that dimension (if MinWidth == 0, MinWidth will be
     * set to the opening Width of the Window).
     * You can change these settings later using SetWindowLimits().
     * If you haven't asked for a SIZING Gadget, you don't have to
     * initialize any of these variables.
     */
    WORD MinWidth, MinHeight;	    /* minimums */
    UWORD MaxWidth, MaxHeight;	     /* maximums */

    /* the type variable describes the Screen in which you want this Window to
     * open.  The type value can either be CUSTOMSCREEN or one of the
     * system standard Screen Types such as WBENCHSCREEN.  See the
     * type definitions under the Screen structure.
     */
    UWORD Type;

};

    WORD LeftEdge, TopEdge;		/* screen dimensions of window */
    WORD Width, Height;			/* screen dimensions of window */

	if (win = OpenWindow ( &defwin ))

  {

    sve je Ok. Uradi sta treba.

    zatvori prozor

  }
  
  kraj

  NAME 
      RectFill-- Fill a rectangular region in a RastPort.

  SYNOPSIS


      RectFill(rp, xmin, ymin, xmax, ymax)
              a1  d0:16 d1:16 d2:16 d3:16

      void RectFill( struc RastPort *, SHORT, SHORT, SHORT, SHORT );

   .    .    .

#include <proto/intuition.h>
#include <proto/dos.h>
#include <proto/graphics.h>
main()
{
	struct NewWindow defwin={
0, 0,                            // Gornji lijevi kut
320, 256,                        // Dimenzije prozora
1,0,                             // Boje kojima ce se po default-u crtati po prozoru
0,                               // IDCMP flag-ovi, o njima kasnije
WFLG_DRAGBAR | WFLG_DEPTHGADGET, // promena velicine i skrivanje prozora
NULL,                            // Bez gadget-a
NULL,                            // Bez slicice
"Prozorcic",                     // Ime prozora
NULL,                            // Na kome ekranu da se otvori prozor
NULL,                            // Ne alociramo sami mem. za prozor 
0,0,                             // minimalne dimenzije prozora
320,256,                         // maksimalne dimenzije prozora
WBENCHSCREEN,                    // Na workBench-u
};


	struct Window *win; //pointer na strukturu tipa "Window"


	if (win = OpenWindow ( &defwin )) // da li je otvaranje prozora uspelo?
	{

		RectFill(win->RPort,100,100,150,150); // crtaj pravougaonik
		Move(win->RPort,300,200);            // pomeri graficki kursor na(300,200)
		SetAPen(win->RPort,2);               //nadalje koristi boju 2
		Draw(win->RPort,150,50);           //  crtaj liniju (300,200)-(150,50)
		Move(win->RPort,100,100);         // pomeri G.K. na (100,100)
		SetAPen(win->RPort,1);             // boja 1
		Text (win->RPort,"Text",4);     // ispisi tekst "Text" duzine 4 slova
		Delay(150);	

		CloseWindow (win);   // Obavezno moramo zatvoriti sve sto smo otvorili

	}

}

#include <exec/types.h> //Zbog UBYTE tipa-dodajte kad god koristite ovu f-ju!
#include <stdio.h>
int MouseKey(void);

main()
{
	while (MouseKey()!=3)  // Dok se ne pritisnu oba gumba
 	 printf("%d\n",MouseKey());
}

int MouseKey(void)
{
	register UBYTE *LMB=(UBYTE *)0xbfe001;
	register UBYTE *RMB=(UBYTE *)0xdff016;
	register int a=0;
	if ((*LMB & 64)== 0) a=1;
	if ((*RMB & 4) == 0) a=a+2;
	return a;
}

#include <stdio.h>
#include <proto/dos.h>        // Dakle DOS
main (int argc, char *argv[]) // Ovo više ne treba objašnjavati.
{
	BPTR in;  // 2 BPTR-a. Ne pointera!
	BPTR out; // jer treba otvoriti 2 fajla
	char c;   // pomoćna varijabla za privremeni smještaj podataka
	if (argc!=3) // da li je pogrešno pozvan program?
	{
		Printf("Usage: convert pcfile amigafile\n");
		return(0); // ako jeste izađi iz programa.
	}
	in=Open(argv[1],MODE_OLDFILE); // otvaramo fajl za čitanje 
	if (in==0)  // Jel' fajl pronađen ?
	{
		Printf("Can't open file %s.\n",argv[1]);
		return(1); // Ako nije opet je greška po sredi
	}
	out=Open(argv[2],MODE_NEWFILE); // otvori fajl za snimanje 
	if(out==0)  // jel' to uspješno obavljeno?
	{
		Close(in); // Ako nije potrebno je zatvoriti prethodno otvoreni 
		Printf("Can't save file.\n");  // ispisati prigodnu poruku
		return(2);    // i izaći iz programa
	}
	Printf("Converting %s to %s.\n",argv[1],argv[2]); // najzad je sve Ok.

	while ((c=FGetC(in))!=EOF) // Char-ovi se uzimaju dok se ne naiđe na EOF 
	{
		if (c!=13)  // ako c nije 13 (CR)
			FPutC(out,c); // treba ga snimiti
	}
	Close(in);  // sve što je otvoreno
	Close(out); // mora se uvijek i zatvoriti.
	Printf("Finished!\n");  // gotovo (napokon)
}