Blob Blame History Raw
--- libgda-3.0.0/tools/gda-config-3.0.5.man	2007-04-24 09:42:36.000000000 +0200
+++ libgda-3.0.0/tools/gda-config-3.0.5	2007-04-24 09:42:05.000000000 +0200
@@ -0,0 +1,52 @@
+.\" 
+.\" gda-config man page
+.\" (C) 2003 GNOME Foundation
+.\" Author:
+.\"   Gonzalo Paniagua Javier (gonzalo@gnome-db.org)
+.\"
+.TH gda-config-3.0 "5" "January 2003" "libgda" "File Formats"
+.SH NAME
+$(sysconfdir)/libgda/config \- libgda global configuration file.
+$(HOME)/.libgda/config \- libgda user configuration file.
+.SH DESCRIPTION
+The config file of libgda is an XML file. The document starts with
+<libgda-config> tag, which contains sections that hold the configured
+database providers for libgda.
+.PP
+The values in the global configuration file are overriden by the ones in the
+user configuration file.
+.PP
+Each <section> has a 'path' attribute whose value \fImust\fP be something like
+"/apps/libgda/Datasources/XXXXXXXX", where XXXXXXXX is the name of the
+database backend (i.e., postgres, mysql,...)
+.PP
+Inside each <section> you can have for <entry> tags with 'name', 'type' and 'value'
+attributes. Valid values for 'name' are: \fIProvider\fP,
+\fIUsername\fP, \fIDSN\fP and \fIDescription\fP. 'type' value is always
+"string" and 'value' contains the value for the given 'name'.
+.SH EXAMPLE
+This is a sample file. You may modify it manually, add/remove sections,...
+.RS
+.sp
+.nf
+<?xml version="1.0"?>
+<libgda-config>
+  <section path="/apps/libgda/Datasources/postgres">
+    <entry name="Provider" type="string" value="PostgreSQL"/>
+    <entry name="Username" type="string" value="gonzalo"/>
+    <entry name="DSN" type="string"
+           value="DATABASE=test;USER=gonzalo"/>
+    <entry name="Description" type="string"
+           value="Mi favourite provider"/>
+  </section>
+</libgda-config>
+.fi
+.sp
+.RE
+You can also use \fBgda-config-tool-3.0\fR or \fBmergeant\fR (recommended) to modify
+this file.
+.SH SEE ALSO
+.BR mergeant (1),
+.BR gda-config-tool-3.0 (1)
+
+
--- libgda-3.0.0/tools/gda-config-tool-3.0.1.man	2007-04-24 09:42:41.000000000 +0200
+++ libgda-3.0.0/tools/gda-config-tool-3.0.1	2007-04-24 09:41:43.000000000 +0200
@@ -0,0 +1,63 @@
+.\" 
+.\" gda-config-tool man page
+.\" (C) 2002 GNOME Foundation
+.\" Author:
+.\"   Gonzalo Paniagua Javier (gonzalo@gnome-db.org)
+.\"
+.TH gda-config-tool-3.0 "1" "October 2002" "gda-config-tool-3.0 (libgda)" "User Commands"
+.SH NAME
+gda-config-tool-3.0 \- Tool for managing libgda configuration file.
+.SH SYNOPSIS
+.PP
+.B gda-config-tool-3.0 [OPTIONS]
+.SH DESCRIPTION
+The \fIgda-config-tool-3.0\fP program can be used create/edit/remove a libgda
+provider. It can be used both as a command line program and an interactive
+program.
+.SH OPTIONS
+.PP
+The following options are supported:
+.TP
+\fB\-?\fR, \fB\-\-help\fR
+Displays command line options.
+.TP
+\fB--usage\fR
+Display brief usage message.
+.TP
+\fB--l\fR, \fB\-\-list\-providers\fR
+Lists installed providers.
+.TP
+\fB--L\fR, \fB\-\-list\-datasources\fR
+Lists configured data sources.
+.TP
+\fB--n\fR, \fB\-\-name=NAME\fR
+User-assigned name for the provider and connection settings.
+.TP
+\fB--u\fR, \fB\-\-user=NAME\fR
+User name to pass to the provider when connecting.
+.TP
+\fB--p\fR, \fB\-\-password=NAME\fR
+Password for the given user to pass to the DB backend.
+.TP
+\fB--P\fR, \fB\-\-provider=NAME\fR
+Provider name.
+.TP
+\fB--d\fR, \fB\-\-DSN="NAME=VALUE;..."\fR
+Semi-colon separated list of parameter=value option to pass to the provider.
+.SH ENVIRONMENT VARIABLES
+.TP
+NONE
+.SH FILES
+.PP
+$(sysconfdir)/libgda/config
+.IP
+Global configurations settings read for every user.
+.PP
+${HOME}/.libgda/config
+.IP
+User settings. Override global settings.
+.SH SEE ALSO
+.BR mergeant(1),
+.BR gda-config-3.0(5)
+
+