r29550 - /trunk/libconfig-model-itself-perl/debian/control

[ddumont-guest at users.alioth.debian.org]

Author: ddumont-guest
Date: Sat Jan 10 20:03:39 2009
New Revision: 29550

URL: http://svn.debian.org/wsvn/pkg-perl/?sc=1&rev=29550
Log:
- re-wrote description by re-using most of upstream README file

Modified:
    trunk/libconfig-model-itself-perl/debian/control

Modified: trunk/libconfig-model-itself-perl/debian/control
URL: http://svn.debian.org/wsvn/pkg-perl/trunk/libconfig-model-itself-perl/debian/control?rev=29550&op=diff
==============================================================================
--- trunk/libconfig-model-itself-perl/debian/control (original)
+++ trunk/libconfig-model-itself-perl/debian/control Sat Jan 10 20:03:39 2009
@@ -22,17 +22,49 @@
          libconfig-model-tkui-perl,
          liblog-log4perl-perl (>= 1.11)
 Description: Graphical model editor for Config::Model
- Config::Model::Itself and its model files provide a model of
- Config:Model (hence the Itself name). If you install also
- Config::Model::TkUI, you get a graphical configuration model
- editor. In others words, you get a GUI to edit configuration models
- like Xorg model.
+
+ Config::Model::Itself and the command config-model-edit provides
+ a Perl/Tk graphical interface to edit configuration models that will
+ be used by Config::Model.  
  .
- Let's step back a little to explain. Any configuration data is, in essence,
- structured data. This data could be stored in an XML file. A configuration
- model is a way to describe the structure and relation of all items of a
- configuration data set.
+ Config::Model::Itself also provides a model for Config::Model
+ (hence the Itself name, you can also think of it as a meta-model).
+ The model editor will use this meta-model to construct the graphical
+ interface so you can edit the configuration model for *your*
+ application. [ Config::Model::Itself is the "eat your own dog food" principle
+ applied to Config::Model ;-) ]
  .
- This configuration model is also expressed as structured data. This structure
- data is structured and follow a set of rules which are described for humans
- in Config::Model.
+ Let's step back a little to explain. Any configuration data is, in
+ essence, structured data. This data could be stored, for instance, in 
+ an XML file. A configuration model is a way to describe the structure 
+ and relation of all items of a configuration data set.
+ .
+ This configuration model is also expressed as structured data. This
+ structure data is structured and follows a set of rules which are
+ described for humans in Config::Model.
+ .
+ The structure and rules documented in Config::Model are also expressed
+ in a model in the files provided with Config::Model::Itself.
+ .
+ Hence the possibity to verify, modify configuration data provided by
+ Config::Model can also be applied on configuration models.
+ .
+ The model editor program is config-model-edit. 
+ .
+ Since the model editor and the configuration data editor are based on
+ the same graphical module, you will use similar UIs to edit
+ configuration data (for instance OpenSsh configuration data from
+ sshd_config) and OpenSsh model (if you need to add new parameters in OpenSsh
+ model)
+ .
+ Once this package is installed, you can run:
+ .
+  $ config-model-edit -model <model_name>
+ .
+ For instance, if you have installed Config::Model::OpenSsh (not yet packaged),
+ you can run:
+ .
+  $ config-model-edit -model OpenSsh
+ .
+ If you save OpenSsh configuration model, config-model-edit will create a 
+ lib directory and write the modified model there.