added examples dir and an example

+Fri Oct  1 01:00:00 1999  Sean 'Shaleh' Perry  <shaleh@debian.org>
+
+	* added and examples directory and the first example, from.c
+
 Fri Oct  1 03:17:28 1999  Jakob 'sparky' Kaivo  <jkaivo@gnu.org>
 
 	* libmailbox/*.[ch]: added cleanup patches from Shaleh while he works
@@ -93,4 +97,4 @@ Fri Oct  1 03:17:28 1999  Jakob 'sparky' Kaivo  <jkaivo@gnu.org>
 
 
 
-	
\ No newline at end of file
+	

+/** 
+ * Code in the public domain, Sean 'Shaleh' Perry <shaleh@debian.org>, 1999
+ *
+ * Created as an example of using libmailbox
+ *
+ **/
+#include <mailbox.h>
+#include <paths.h>
+#include <stdio.h>
+
+int main(int argc, char *argv[]) {
+	mailbox *mail;
+	unsigned int i;
+	char *header, *from, *date;
+	char *user;
+	char mailpath[256];
+
+	user = getenv("USER");
+	if (user == NULL)
+      {
+        fprintf(stderr, "who am I?\n");
+        exit(-1);
+      }
+	snprintf (mailpath, 256, "%s/%s", _PATH_MAILDIR, user);
+	mail = mbox_open(mailpath);
+	if( mail == NULL ) {
+		perror("mbox_open: ");
+		exit(-1);
+	}
+	for(i = 0; i < mail->messages; ++i) {
+		header = mbox_get_header(mail, i);
+		if( header == NULL ) {
+			perror("mbox_get_header: ");
+			exit(-1);
+		}
+		from = mbox_header_line(mail, i, "From");
+		if (from == NULL)
+          {
+            perror("mbox_header_line: ");
+            exit(-1);
+          }
+		date = mbox_header_line(mail, i, "Date");
+		if (date == NULL)
+          {
+            perror("mbox_header_line: ");
+            exit(-1);
+          }
+		printf("%s %s\n", from, date);
+		free(header);
+		free(from);
+		free(date);
+	}
+	mbox_close(mail);
+	exit(0);
+}