emu-init(1)

NAME
emu-init - Create emu sources

SYNOPSIS
emu init [<options>]

DESCRIPTION
Creates an empty emu source, with a .emu directory with subdirectories for hooks, sink refs and the configuration file. The directories are populated using template files.

This command is non-destructive: running it on an existing emu source will not overwrite any existing data. Instead, it can be used to rescue a broken source, as it will silently replace or recreate any missing files. If you have broken a file and would like to revert to the default, delete it and run this command.

First, the init program checks for read and write permissions in the specified directory (by default, the current directory, unless overridden with the --source-dir argument). Once these have been established, it creates the .emu directory and required sub-directories for an emu source, and copies over any files from the templates folder, using the system default if not overriden with the --template-dir argument.

OPTIONS

-t <dir> --template-dir <dir>
    Specify the directory from which templates will be copied.

-f --force
    Operate destructively. If a file exists in both the template and source directories, replace the source file with the template.

-S <dir> --source-dir <dir>
    Specify the directory to initialise as an emu source. Defaults to `.'.

-v --verbose
    Increase verbosity.

--version
    Show version information and quit.

-h --help
    Show this help and quit.

EXAMPLES

Start an emu source in the current directory:
    emu init -v

Use a custom template directory:
    emu init -vt=~/my-source-templates

Repair a broken source:
    emu init -f

EMU
Part of the emu (1) suite

AUTHOR
Chris Cummins <chrisc.101@gmail.com>

SEE ALSO
emu (1)