More stuff

Author: DilumAluthge

examples/MyLib/Makefile

@@ -1,43 +1,67 @@
 # Makefile
 
+# This is the default target:
 .DEFAULT_GOAL := all
-
 .PHONY: all
 all: build-library build-executable
 
+# ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+# The user can override these to use custom locations for Julia and/or GCC:
 JULIA ?= julia
 GCC ?= gcc
 
+# We automatically compute DLEXT:
 DLEXT := $(shell $(JULIA) --startup-file=no -e 'import Libdl; print(Libdl.dlext)')
 
+# Define TARGET in one place, so that we don't need to keep retyping it.
 TARGET="MyLibCompiled"
 
+# ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+# build-library and build-executable are just for convenience:
+
+.PHONY: build-library
+build-library: $(TARGET)/lib/libmylib.$(DLEXT)
+
+.PHONY: build-executable
+build-executable: my_application.out
+
+# ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+.PHONY: clean
+clean:
+	$(RM) *.o
+	$(RM) *.out
+	$(RM) *.$(DLEXT)
+	$(RM) -rf $(TARGET)
+
+# ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+# Library:
+
 MYLIB_INCLUDES = $(TARGET)/include/julia_init.h $(TARGET)/include/mylib.h
 MYLIB_PATH := $(TARGET)/lib/libmylib.$(DLEXT)
 
+# We split this up into multiple lines, just so that we don't end up with a single really long line.
 DEPS_build_library := src/MyLib.jl
 DEPS_build_library += build/build.jl
 DEPS_build_library += build/generate_precompile.jl build/additional_precompile.jl
 DEPS_build_library += build/mylib.h
 DEPS_build_library += build/Project.toml build/Manifest.toml
 
-.PHONY: build-library
-build-library: MyLibCompiled/lib/libmylib.dylib
-
-MyLibCompiled/lib/libmylib.dylib: $(DEPS_build_library)
+$(TARGET)/lib/libmylib.$(DLEXT): $(DEPS_build_library)
 	$(JULIA) --startup-file=no --project=. -e 'import Pkg; Pkg.instantiate(); Pkg.precompile()'
 	$(JULIA) --startup-file=no --project=build -e 'import Pkg; Pkg.instantiate(); Pkg.precompile()'
 	$(JULIA) --startup-file=no --project=build -e 'include("build/build.jl")'
 
 INCLUDE_DIR = $(TARGET)/include
 
-.PHONY: build-executable
-build-executable: my_application.out
+# ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+# Application (my_application.out):
 
-my_application.out: MyLibCompiled/lib/libmylib.dylib
+my_application.out: $(TARGET)/lib/libmylib.$(DLEXT)
 	$(GCC) my_application.c -o my_application.out -I$(INCLUDE_DIR) -L$(TARGET)/lib -ljulia -lmylib
 
-.PHONY: clean
-clean:
-	$(RM) *~ *.o *.$(DLEXT)
-	$(RM) -Rf $(TARGET)
+# ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++