5 files changed, 22 insertions, 9 deletions

diff --git a/INDEX b/INDEX
index 791f6ab..d05a009 100644
--- a/INDEX
+++ b/INDEX
@@ -57,10 +57,8 @@ uncompr.c
 zutil.c
 zutil.h
 
-                source files for sample programs:
-example.c
-minigzip.c
-See examples/README.examples for more
+                source files for sample programs
+See examples/README.examples
 
-                unsupported contribution by third parties
+                unsupported contributions by third parties
 See contrib/README.contrib
diff --git a/Makefile.in b/Makefile.in
index c1c37fe..1b8bf3f 100644
--- a/Makefile.in
+++ b/Makefile.in
@@ -126,11 +126,17 @@ match.lo: match.S
         mv _match.o match.lo
         rm -f _match.s
 
-example64.o: example.c zlib.h zconf.h
-        $(CC) $(CFLAGS) -D_FILE_OFFSET_BITS=64 -c -o $@ example.c
+example.o: examples/example.c zlib.h zconf.h
+        $(CC) $(CFLAGS) -I. -c -o $@ examples/example.c
 
-minigzip64.o: minigzip.c zlib.h zconf.h
-        $(CC) $(CFLAGS) -D_FILE_OFFSET_BITS=64 -c -o $@ minigzip.c
+minigzip.o: examples/minigzip.c zlib.h zconf.h
+        $(CC) $(CFLAGS) -I. -c -o $@ examples/minigzip.c
+
+example64.o: examples/example.c zlib.h zconf.h
+        $(CC) $(CFLAGS) -I. -D_FILE_OFFSET_BITS=64 -c -o $@ examples/example.c
+
+minigzip64.o: examples/minigzip.c zlib.h zconf.h
+        $(CC) $(CFLAGS) -I. -D_FILE_OFFSET_BITS=64 -c -o $@ examples/minigzip.c
 
 .SUFFIXES: .lo
 
diff --git a/examples/README.examples b/examples/README.examples
index 56a3171..fddb8df 100644
--- a/examples/README.examples
+++ b/examples/README.examples
@@ -6,6 +6,10 @@ enough.c
     - calculates the maximum table space used in inflate tree
       construction over all possible Huffman codes
 
+example.c
+    usage examples of zlib
+    - used in zlib build Makefile for testing
+
 fitblk.c
     compress just enough input to nearly fill a requested output size
     - zlib isn't designed to do this, but fitblk does it anyway
@@ -34,6 +38,11 @@ gzlog.h
       and deflateSetDictionary()
     - illustrates use of a gzip header extra field
 
+minigzip.c
+    minimal implementation of gzip-like functionality using zlib
+    - used in zlib build Makefile for testing
+    - is not meant for and should not be used as a gzip replacement
+
 zlib_how.html
     painfully comprehensive description of zpipe.c (see below)
     - describes in excruciating detail the use of deflate() and inflate()
diff --git a/example.c b/examples/example.c
index f515a48..f515a48 100644
--- a/example.c
+++ b/examples/example.c
diff --git a/minigzip.c b/examples/minigzip.c
index 8317344..8317344 100644
--- a/minigzip.c
+++ b/examples/minigzip.c