From 746c3f3076fe5994f08d729aa1b958465231b0c8 Mon Sep 17 00:00:00 2001
From: Aleksey Veresov <aleksey@veresov.pro>
Date: Tue, 4 Feb 2020 14:57:11 +0300
Subject: [magi]

---
 examples/Makefile | 31 +++++++++++++++++++++++++------
 1 file changed, 25 insertions(+), 6 deletions(-)

(limited to 'examples/Makefile')

diff --git a/examples/Makefile b/examples/Makefile
index d93176b..2f57b1e 100644
--- a/examples/Makefile
+++ b/examples/Makefile
@@ -1,29 +1,48 @@
-# Uncomment following to enable debug mode:
+# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+#     Compilation Options
+# Debug mode (allowing to debug the examples via gdb):
 # DEBUG    = yes
-
+# Specify your favourite C compiler here (e.g. tcc):
 CC       = gcc
+
+
+# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+#     Preparations
 EXAMPLES = append cookie upload echo
 
+# Compile under the most strict conditions:
 CFLAGS   = -xc -ansi -pedantic -Wall
+# Debug and optimisation are not compatible:
 ifeq '$(DEBUG)' 'yes'
 CFLAGS  += -g -O0
 else
 CFLAGS  += -O3
 endif
 
+# Including magi library headers and setting linker to use it:
 INCLUDE  = -I ../src
 LFLAGS   = -L.. -lmagi
 
+# Specification of library file to produce it, if not provided:
 MAGI     = ../libmagi.a
 
 
+# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+#     Targets
+# 'make' produces all examples by default:
 default: $(EXAMPLES)
 
-$(MAGI):
-	cd ..; $(MAKE)
+# Cleaning means removing everything automatically produced:
+clean:
+	rm -f $(EXAMPLES)
+
 
+# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+#     Compilation
+# Compile executables from corresponding sources and library:
 %: %.c $(MAGI)
 	$(CC) $(CFLAGS) $(INCLUDE) $< $(LFLAGS) -o $@
 
-clean:
-	rm -f $(EXAMPLES)
+# Run make for library to produce it:
+$(MAGI):
+	cd ..; $(MAKE)
-- 
cgit v1.2.3