From 124a418fc3b3e8bd8d84cedac7c2ab976d7835fe Mon Sep 17 00:00:00 2001
From: Isaku Yamahata <isaku.yamahata@gmail.com>
Date: Thu, 6 Jun 2019 12:17:05 -0700
Subject: [PATCH] [Makefile.rules] Add comment on how to use rules

---
 Makefile.rules | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/Makefile.rules b/Makefile.rules
index d98da5b5..777f8108 100644
--- a/Makefile.rules
+++ b/Makefile.rules
@@ -1,3 +1,13 @@
+#
+# All Makefiles must follow the following conventions:
+#
+# - Compilation and linking steps must be done via the 'cmd' function:
+#   e.g., use '$(call cmd,ld_so_o)' to create a shared library using LD
+#
+# - File-specific build flags must be specified via variables of the format 'FLAG-filename':
+#   e.g., use 'LDFLAGS-libsysdb.so=...' to specify libsysdb.so-specific linker flags
+#
+
 ifeq ("$(origin V)", "command line")
   BUILD_VERBOSE = $(V)
 endif