From 01792882d62f76b162fe0c703f99ccaf796cd3ae Mon Sep 17 00:00:00 2001
From: Mike DePaulo <mikedep333@gmail.com>
Date: Nov 05 2018 03:05:11 +0000
Subject: Add comment about defcommit() and deftag()


---

diff --git a/linux-system-roles.spec b/linux-system-roles.spec
index cc95fb0..30a4871 100644
--- a/linux-system-roles.spec
+++ b/linux-system-roles.spec
@@ -14,6 +14,10 @@ License: GPLv3+ and MIT and BSD
 %endif
 %global roleprefix %{name}.
 
+# For each role, call either decommit() or deftag(). The other macros
+# (%id and %shortid) can be then used in the same way in both cases.
+# This way  the rest of the spec file des not need to know whether we are
+# dealing with a tag or a commit.
 %define defcommit() %{expand:%%global id%{1} %{2}
 %%global shortid%{1} %%(c=%%{id%{1}}; echo ${c:0:7})
 }