[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>