[Dbconfig-common-devel] dbconfig-common/doc dbapp-policy.html,1.6,1.7 dbconfig-common.html,1.6,1.7

seanius@haydn.debian.org seanius@haydn.debian.org


Update of /cvsroot/dbconfig-common/dbconfig-common/doc
In directory haydn:/org/alioth.debian.org/chroot/home/users/seanius/tmp/cvs-serv1245

Modified Files:
	dbapp-policy.html dbconfig-common.html 
Log Message:
more documentation updates


Index: dbapp-policy.html
===================================================================
RCS file: /cvsroot/dbconfig-common/dbconfig-common/doc/dbapp-policy.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -d -r1.6 -r1.7
--- dbapp-policy.html	3 Mar 2005 22:25:46 -0000	1.6
+++ dbapp-policy.html	17 Mar 2005 00:47:49 -0000	1.7
@@ -228,24 +228,20 @@
 <ul>
 <li>new package's files are then unpacked
 <li>new package configuration (new-package.postinst configure $oldversion):
-<ul>
-  <li>inform admin of upgrade, give chance to backup database.
-  <li>if admin has opted out
   <ul>
-    <li>provide details of what must be done
+    <li>inform admin of upgrade, give chance to backup database.
+    <li>if admin has opted out
+    <ul>
+      <li>provide details of what must be done
+    </ul>
+    <li>perform upgrade
+    <li>if error occurred
+    <ul>
+      <li>DEBCONF NOTE: stuff is broken, man!  reconfigure or downgrade!
+      <li>exit with error status
+    </ul>
   </ul>
-  <li>perform upgrade
-  <li>if error occurred
-  <ul>
-    <li>inform admin, exit with error status
-  <ul>
 </ul>
-  perform upgrade
-  if error
-    backup failed database
-    drop failed database
-    DEBCONF NOTE: stuff is broken, man!  reconfigure or downgrade!
-    exit with error status
 </code>
 </pre>
 
@@ -265,24 +261,17 @@
 as well as the adminsitrator much easier. 
 </p>
 
+<h3>dbconfig-common: a common framework for packaging database applications</h3>
 <p>
-work in-progress packages can be found at the following uris:
+a work in-progress project of such nature can be found at
+sean finney's 
+<a href="http://people.debian.org/~seanius/policy/dbconfig-common.html">
+dbconfig-common</a> page.
 </p>
-<pre>
-deb http://people.debian.org/~seanius/policy/examples/ ./
-deb-src http://people.debian.org/~seanius/policy/examples/ ./
-</pre>
-<p>the following packages (binary and source) are available</p>
-<ul>
-<li><a href="dbconfig-common.html">dbconfig-common: common framework for database applications</a>
-<li>db-test-mysql: an installable package to test dbconfig-common (mysql version)
-</ul>
 
 <h3>dh_installdb</h3>
 <p>is there need for a build-time helper?  clumps of common code could
-be plopped in via debhelper into maintainer scripts.  pre-translated
-templates of debconf could automatically be merged, though this is kind
-of clunky for the packages that would build-depend on it.
+be plopped in via debhelper into maintainer scripts.  
 
 <h2>related threads/discussions</h2>
 <ul>

Index: dbconfig-common.html
===================================================================
RCS file: /cvsroot/dbconfig-common/dbconfig-common/doc/dbconfig-common.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -d -r1.6 -r1.7
--- dbconfig-common.html	3 Mar 2005 22:25:46 -0000	1.6
+++ dbconfig-common.html	17 Mar 2005 00:47:49 -0000	1.7
@@ -44,6 +44,42 @@
     admin)
 </ul>
 
+<h3>try it out!</h3>
+
+<p>
+work-in-progress packages can be found out the following uris:
+</p>
+
+<pre>
+<code>
+	deb http://people.debian.org/~seanius/policy/examples/ ./
+	deb-src http://people.debian.org/~seanius/policy/examples/ ./
+</code>
+</pre>
+
+<p>
+at these uri's, you can find the following packages:
+</p>
+
+<dl>
+<dt>dbconfig-common
+<dd>the common framework package
+<dt>db-test-mysql
+<dd>a sample mysql using package.
+<dt>db-test-pgsql
+<dd>a sample pgsql using package.
+<dt>db-test
+<dd>a sample package supporting multiple formats
+<dt>db-test-mysql-perl
+<dd>a sample package using alternative script-based support 
+</dl>
+
+<p>
+furthermore, there are two versions of the db-test packages available
+in the above location  (though apt may only provide you with the later
+version).  the second set of packages (version 2.1) should illustrate
+the support for upgrading provided by dbconfig-common.
+
 <h3>more information</h3>
 
 <ul>