diff --git a/software/cdist/man/VERSION b/software/cdist/man/VERSION new file mode 100644 index 00000000..2885db57 --- /dev/null +++ b/software/cdist/man/VERSION @@ -0,0 +1 @@ +1.6.0-39-gdfd0eef diff --git a/software/cdist/man/cdist-deploy-to.html b/software/cdist/man/cdist-deploy-to.html index 764d156e..b499ff83 100644 --- a/software/cdist/man/cdist-deploy-to.html +++ b/software/cdist/man/cdist-deploy-to.html @@ -1,6 +1,6 @@ -cdist-deploy-to(1)

cdist-deploy-to(1)


Table of Contents

1. NAME
2. SYNOPSIS
3. DESCRIPTION
4. ENVIRONMENT
5. SEE ALSO
6. COPYING

1. NAME

cdist-deploy-to - Deploy configuration to host

2. SYNOPSIS

cdist-deploy-to HOSTNAME

3. DESCRIPTION

Deploy configurations to the specified host, as configured in the initial +cdist-deploy-to(1)

cdist-deploy-to(1)


1. NAME

cdist-deploy-to - Deploy configuration to host

2. SYNOPSIS

cdist-deploy-to HOSTNAME

3. DESCRIPTION

Deploy configurations to the specified host, as configured in the initial manifest. This script triggers the execution of several other scripts, in so called stages. It is intented to run either from the command line or from cron.

4. ENVIRONMENT

If the environment variable cdist_conf_dir is not set, the configuration is read from <git-checkout>/conf. The local output directory can @@ -10,6 +10,8 @@ cdist(7)

  • cdist-config(1)
  • +cdist-mass-deploy(1) +
  • cdist-reference(7)
  • cdist-stages(7) diff --git a/software/cdist/man/cdist-hacker.html b/software/cdist/man/cdist-hacker.html index 7c594ce3..5e8b8d6c 100644 --- a/software/cdist/man/cdist-hacker.html +++ b/software/cdist/man/cdist-hacker.html @@ -1,17 +1,18 @@ -cdist-hacker(7)

    cdist-hacker(7)


    1. NAME

    cdist-hacker - How to get (stuff) into cdist

    2. WELCOME

    Welcome dear hacker! I invite you to a tour of pointers to +cdist-hacker(7)

    cdist-hacker(7)


    1. NAME

    cdist-hacker - How to get (stuff) into cdist

    2. WELCOME

    Welcome dear hacker! I invite you to a tour of pointers to get into the usable configuration mangament system, cdist.

    The first thing to know is probably that cdist is brought to you by people who care about how code looks like and who think twice before merging or implementing a feature: Less features with good usability are far better than the opposite.

    3. UNDERSTANDING CDIST INTERNALS

    IF you are interested in how cdist internally works, you can open bin/cdist-config and bin/cdist-deploy-to in your favorite editor and read the scripts bin/cdist-deploy-to calls. The magnificent HACKERS_README -may be of great help as well.

    4. CODING CONVENTIONS (CORE)

    • +may be of great help as well.

    4. CODING CONVENTIONS (EVERYWHERE)

    If something should be better done or needs to fixed, add the word FIXME +nearby, so grepping for FIXME gives all positions that need to be fixed.

    5. CODING CONVENTIONS (CORE)

    • All variables exported by cdist are prefixed with a double underscore (__)
    • All cdist-internal variables are prefixed with _cdist and are generally not exported. -

    5. HOW TO SUBMIT STUFF FOR INCLUSION INTO UPSTREAM CDIST

    If you did some cool changes to cdist, which you value as a benefit for +

  • 6. HOW TO SUBMIT STUFF FOR INCLUSION INTO UPSTREAM CDIST

    If you did some cool changes to cdist, which you value as a benefit for everybody using cdist, you’re welcome to propose inclusion into upstream.

    There are though some requirements to ensure your changes don’t break others work nor kill the authors brain:

    • Code submission must be done via git @@ -28,11 +29,11 @@ Do not add conf/manifest/init - This file should only be touched in your private branch!

    As soon as your work meets these requirements, you can contact me (IRC, Mailinglist, Phone, RFC 1149) and I’ll check your code before -including it.

    6. HOW TO SUBMIT A NEW TYPE

    Submitting a type works as described above, with the additional requirement +including it.

    7. HOW TO SUBMIT A NEW TYPE

    Submitting a type works as described above, with the additional requirement that a corresponding manpage named man.text in asciidoc format with the manpage-name "cdist-type__NAME" is included in the type directory AND asciidoc is able to compile it (i.e. do NOT have to many "=" in the second -line).

    7. SEE ALSO

    • +line).

    8. SEE ALSO

    • cdist(7) -

    8. COPYING

    Copyright (C) 2011 Nico Schottelius. Free use of this software is +

    9. COPYING

    Copyright (C) 2011 Nico Schottelius. Free use of this software is granted under the terms of the GNU General Public License version 3 (GPLv3).

    diff --git a/software/cdist/man/cdist-reference.html b/software/cdist/man/cdist-reference.html index f39da8e2..a6cc3a9b 100644 --- a/software/cdist/man/cdist-reference.html +++ b/software/cdist/man/cdist-reference.html @@ -1,6 +1,6 @@ -cdist-reference(7)

    cdist-reference(7)


    1. NAME

    cdist-reference - Variable, path and type reference for cdist

    2. DESCRIPTION

    This reference summarises

    • +cdist-reference(7)

      cdist-reference(7)


      1. NAME

      cdist-reference - Variable, path and type reference for cdist

      2. DESCRIPTION

      This reference summarises

      • environment variables
      • paths diff --git a/software/cdist/man/cdist-type__package_pkg_openbsd.html b/software/cdist/man/cdist-type__package_pkg_openbsd.html new file mode 100644 index 00000000..d3acc334 --- /dev/null +++ b/software/cdist/man/cdist-type__package_pkg_openbsd.html @@ -0,0 +1,30 @@ + + +cdist-type__package_pkg(7)

        cdist-type__package_pkg(7)

        Andi Brönnimann


        1. NAME

        cdist-type__package_pkg_openbsd - Manage OpenBSD packages

        2. DESCRIPTION

        This type is usually used on OpenBSD to manage packages.

        3. REQUIRED PARAMETERS

        +state +
        + Either "installed" or "removed". +

        4. OPTIONAL PARAMETERS

        +name +
        + If supplied, use the name and not the object id as the package name. +
        +flavor +
        + If supplied, use to avoid ambiguity. +

        5. EXAMPLES

        # Ensure zsh is installed
        +__package_pkg_openbsd zsh --state installed
        +
        +# Ensure vim is installed, use flavor no_x11
        +__package_pkg_openbsd vim --state installed --flavor no_x11
        +
        +# If you don't want to follow pythonX packages, but always use python
        +__package_pkg_openbsd python --state installed --name python2
        +
        +# Remove obsolete package
        +__package_pkg_openbsd puppet --state removed

        6. SEE ALSO

        • +cdist-type(7) +
        • +cdist-type__package(7) +

        7. COPYING

        Copyright (C) 2011 Andi Brönnimann. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).