NAME

       mconfig, - Utility for modifying .NET configuration files

SYNOPSIS

       mconfig [options] command [command_parameters]

DESCRIPTION

       mconfig  can  be  used  to  edit  .NET  configuration  files,  by  adding "features" (that is sets of xml
       statements) defined in one of the config files read by mconfig. The config file can also  define  layouts
       of default configuration files, which may be useful for bootstrapping your .NET projects.

       To  see  the  list  of recognized commands, default configuration files and features, run mconfig without
       passing any parameters.

OPTIONS

       -c <config_file>, --config=<config_file>
              Read the specified config file after reading  the  other,  preconfigured,  config  files  for  the
              utility. Settings in the specified file override those found in the other configuration locations.

       -t {any | web | application}, --target={any | web | application}
              Features  and default configuration files defined in the mconfig config file(s) can be assigned to
              one of the three targets - web  (for  ASP.NET  features/config  files),  application  -  for  .NET
              applications, any - applicable in both of the previous targets. Defaults to any.

       -?, -h, --help
              Show a summary usage screen.

       -v, --version
              Show the mconfig version

COMMANDS

       {addfeature, af} <feature_name> [config_file_path]
              Adds  the  feature  named  <feature_name>  to  the specified config file. If [config_file_path] is
              omitted, the name of the output configuration file will be chosen based  on  the  selected  target
              (see  the  -t  option).  The  web  target  outputs configuration to file named Web.config, and the
              application target outputs to file named application.exe.config. The any target does  not  have  a
              default output file.

              If  the  specified  config  file  exists,  the  feature  will be injected into it at the locations
              specified by mconfig configuration. If the target config file does not exist, it will  be  created
              and will contain only the specified feature and all its dependencies.

       {defaultconfig, dc} [config_name [target_directory]]
              Generates  a default config file using the configuration entry named [config_name] and outputs the
              resulting configuration file  to  the  directory  given  by  the  [target_directory]  option.   If
              [config_name] is omitted, it defaults to Web.config for the web target and application target. The
              any target does not specify any default  output  configuration  name.  If  the  [target_directory]
              parameter is omitted, it defaults to the current directory.

              Name  of  the  output config file created in [target_directory] is given in the config file layout
              definition.

FILES

       Config files are read in the order given below. Each subsequent file may override settings found  in  the
       files read before it.

       $prefix/etc/mono/mconfig/config.xml
              The  default  configuration  file,  distributed  with mconfig. $prefix is the mconfig installation
              prefix specified on the compilation time.

       $config_dir/mconfig/config.xml
              $config_dir is the directory specified in the XDG_CONFIG_HOME environment variable or,
               if it is empty, in the .config directory located in the user's home directory. This file  is  not
              distributed with Mono.

       ./mconfig.xml
              Local configuration file which can contain per-application settings.

SEE ALSO

       mconfig.config (5)

AUTHOR

       Written by Marek Habersack

COPYRIGHT

       Copyright (C) 2007 Novell, Inc (http://www.novell.com)

MAILING LISTS

       Visit http://lists.ximian.com/mailman/listinfo/mono-devel-list for details.

WEB SITE

       Visit: http://www.mono-project.com for details

                                                                                                   Mono(mconfig)