summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorJan Pokorný <jpokorny@redhat.com>2014-05-22 16:35:53 +0200
committerJan Pokorný <jpokorny@redhat.com>2014-05-22 17:25:55 +0200
commita1050583443cb8a9f2c9bd96dee8c32c85315012 (patch)
treecf8aebb661d08547229069077ed7ab7f24f202bf /doc
parentdcb829f4c9342b93e120bf656a47fbf136f07bff (diff)
downloadclufter-a1050583443cb8a9f2c9bd96dee8c32c85315012.tar.gz
clufter-a1050583443cb8a9f2c9bd96dee8c32c85315012.tar.xz
clufter-a1050583443cb8a9f2c9bd96dee8c32c85315012.zip
Introduce an explicit notion about target system+distro
...which is, in an unified way, used for both deciding alias targets and for decisions within commands/filters. Signed-off-by: Jan Pokorný <jpokorny@redhat.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/HACKING12
1 files changed, 12 insertions, 0 deletions
diff --git a/doc/HACKING b/doc/HACKING
index 90b2a39..65e5c48 100644
--- a/doc/HACKING
+++ b/doc/HACKING
@@ -43,6 +43,18 @@ relationships:
(consisting of atomic ones)
+Command context
+---------------
+
+This is a declared set of keys that should always be present and are
+intended for public use:
+
+- system: lowercased system specifier (e.g., linux)
+- system_extra: tuple of string values with details about the system
+ (depending on ``system'', distro name, release, codename,
+ etc.; e.g. ``('fedora', '20', 'heisenbug')'' for ``linux'')
+
+
Low-level Terms
---------------