NAME

       App::Cme::Command::modify - Modify the configuration of an application

VERSION

       version 1.038

SYNOPSIS

         # modify configuration with command line
         cme modify dpkg source 'format="(3.0) quilt"'

DESCRIPTION

       Modify a configuration file with the values passed on the command line.  These command
       must follow the syntax defined in Config::Model::Loader (which is similar to the output of
       cme dump command)

       Example:

          cme modify dpkg 'source format="(3.0) quilt"'
          cme modify multistrap my_mstrap.conf 'sections:base source="http://ftp.fr.debian.org"'

       Some application like dpkg-copyright allows you to override the configuration file name.
       You must then use "-file" option:

          cme modify dpkg-copyright -file ubuntu/copyright 'Comment="Silly example"'

       Finding the right instructions to perform a modification may be difficult when starting
       from scratch.

       To get started, you can run "cme dump --format cml" command to get the content of your
       configuration in the syntax accepted by "cme modify":

        $ cme dump ssh -format cml
        Host:"*" -
        Host:"alioth.debian.org"
          User=dod -
        Host:"*.debian.org"
          IdentityFile:="~/.ssh/id_debian"
          User=dod -

       Then you can use this output to create instruction for a modification:

        $  cme modify ssh 'Host:"*" User=dod'
        Changes applied to ssh configuration:
        - Host:"*" User has new value: 'dod'

Common options

       See "Global Options" in cme.

options

       -savek
           Force a save even if no change was done. Useful to reformat the configuration file.

       -verbose
           Show effect of the modify instructions.

SEE ALSO

       cme

AUTHOR

       Dominique Dumont

COPYRIGHT AND LICENSE

       This software is Copyright (c) 2014-2022 by Dominique Dumont <ddumont@cpan.org>.

       This is free software, licensed under:

         The GNU Lesser General Public License, Version 2.1, February 1999