[Dbconfig-common-devel] dbconfig-common/doc dbconfig-common-using.html,1.9,1.10 dbconfig-common.html,1.7,1.8

[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-serv26422/doc

Modified Files:
	dbconfig-common-using.html dbconfig-common.html 
Log Message:
- updated translation
- added first attempt loading pre-dbc configs into dbc
- updated documentation


Index: dbconfig-common-using.html
===================================================================
RCS file: /cvsroot/dbconfig-common/dbconfig-common/doc/dbconfig-common-using.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -d -r1.9 -r1.10
--- dbconfig-common-using.html	1 May 2005 00:03:23 -0000	1.9
+++ dbconfig-common-using.html	18 May 2005 19:49:38 -0000	1.10
@@ -39,6 +39,7 @@
 <li><a href="#advanced">advanced usage</a>.
   <ul>
   <li><a href="#genconfig"> generating config files in other languages  </a>
+  <li><a href="#import"> importing dbconfig-common into an existing package </a>
   <li><a href="#updates"> database changes in new versions of your package </a>
   <li><a href="#multidb"> packages that support multiple types of databases </a>
   <li><a href="#defaults"> hinting defaults and advanced control of configuration/installation </a>
@@ -161,6 +162,18 @@
 leading <code>format:</code> stripped away for convenience.
 </p>
 
+<a name="import">
+<h4> importing dbconfig-common into an existing package </h4>
+
+<p>
+if your package is already part of debian, dbconfig-common provides some
+support to load pre-existing settings from a specified config file via
+the program <code>dbconfig-load-include</code>.  specify the variable
+<code>dbconfig_load_include</code> as a <code>format:inputfile</code>
+value in your config script, and dbconfig-common will do the best it
+can to bootstrap itself with those options.
+</p>
+
 <a name="updates">
 <h4> database changes in new versions of your package </h4>
 <p>
@@ -273,7 +286,7 @@
 <table>
 <tr>
 <th>variable name
-<th>location used
+<th>location(s) specified
 <th>purpose
 <th>default value
 <tr>
@@ -292,6 +305,11 @@
 <td>database types supported by the package
 <td>empty
 <tr>
+<td>dbc_generate_include
+<td>postinst
+<td>format:outputfile pair for an extra config to be generated by dbconfig-generate-include.
+<td>empty
+<tr>
 <td>dbc_generate_include_owner
 <td>postinst
 <td>set the owner:group of include files generated by dbconfig-generate-include
@@ -305,6 +323,16 @@
 <td>dbc_generate_include_args
 <td>postinst
 <td>arguments passed directly to dbconfig-generate-include
+<td>empty
+<tr>
+<td>dbc_load_include
+<td>config
+<td>format:includefile pair for a config to be read in by dbconfig-load-include
+<td>empty
+<tr>
+<td>dbc_load_include_args
+<td>config
+<td>arguments passed directly to dbconfig-load-include
 <td>empty
 </table>
 </body>

Index: dbconfig-common.html
===================================================================
RCS file: /cvsroot/dbconfig-common/dbconfig-common/doc/dbconfig-common.html,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -d -r1.7 -r1.8
--- dbconfig-common.html	17 Mar 2005 00:47:49 -0000	1.7
+++ dbconfig-common.html	18 May 2005 19:49:38 -0000	1.8
@@ -32,8 +32,10 @@
 <li>access local or remote databases
 <li>upgrade/modify databases when upstream changes database structure
 <li>remove databases and database users
-<li>generate config files in many formats with the database info.
+<li>generate config files in many formats with the database info
+<li>import configs from packages previously managing databases on their own
 <li>prompt users with a set of normalized, pre-translated questions
+<li>handle failures gracefully, with an option to retry.
 <li>do all the hard work automatically
 <li>work for package maintainers with little effort on their part
 <li>work for local admins with little effort on their part