From 1d486f8ec85597c88a2f46acaf21a379ba80aaab Mon Sep 17 00:00:00 2001
From: Narayan Desai <desai@mcs.anl.gov>
Date: Thu, 9 Feb 2006 19:40:36 +0000
Subject: Add information in the specification chapter about Cfg :info
 parameters

git-svn-id: https://svn.mcs.anl.gov/repos/bcfg/trunk/bcfg2@1724 ce84e21b-d406-0410-9b95-82705330c041
---
 doc/specs.xml | 26 +++++++++++++++++++++++++-
 1 file changed, 25 insertions(+), 1 deletion(-)

diff --git a/doc/specs.xml b/doc/specs.xml
index 9b51a3309..4f4aa9f33 100644
--- a/doc/specs.xml
+++ b/doc/specs.xml
@@ -255,7 +255,9 @@
 	group and permissions. If no <filename>:info</filename> is
 	provided, targets are installed with default
 	information. Default metadata is root ownership, root group
-	memberships, and 0644 file permissions.
+	memberships, and 0644 file permissions. This file can also
+	contain an encoding parameter (ascii|base64) and a paranoid
+	flag that causes diffs to be logged on clients. 
       </para>
       <example>
 	<title>Cfg/filepath/:info</title>
@@ -301,6 +303,28 @@
 	construct installation URLs, and set several important fields
 	like package name and version. 
       </para>
+
+      <table>
+	<title>Package Entity Attributes</title>
+	<tgroup cols='2'>
+	  <colspec colnum='1' colwidth='1*'/>
+	  <colspec colnum='2' colwidth='3*'/>
+	  <thead>
+	    <row><entry>Name</entry><entry>Description</entry></row>
+	  </thead>
+	  <tbody>
+	    <row><entry>name</entry><entry>Package Name</entry></row>
+	    <row><entry>version</entry><entry>Package Version</entry></row>
+	    <row><entry>uri</entry>
+	      <entry>URL-style location of file repository (typically http)</entry></row>
+	    <row><entry>file</entry><entry>Package file name. Several
+	    other attributes (name, version, url) can be automatically
+	    defined based on regexes definied in the Pkgmgr plugin.</entry></row>
+	    <row><entry>simplefile</entry><entry>Package file name. No
+	    name parsing is performed, so no extra fields get set</entry></row>
+	  </tbody>
+	</tgroup>
+      </table>
     </section>
     <section>
       <title>Svcmgr</title>
-- 
cgit v1.2.3-1-g7c22