| = cargo-init(1) |
| :idprefix: cargo_init_ |
| :doctype: manpage |
| |
| == NAME |
| |
| cargo-init - Create a new Cargo package in an existing directory |
| |
| == SYNOPSIS |
| |
| `cargo init [_OPTIONS_] [_PATH_]` |
| |
| == DESCRIPTION |
| |
| This command will create a new Cargo manifest in the current directory. Give a |
| path as an argument to create in the given directory. |
| |
| If there are typically-named Rust source files already in the directory, those |
| will be used. If not, then a sample `src/main.rs` file will be created, or |
| `src/lib.rs` if `--lib` is passed. |
| |
| If the directory is not already in a VCS repository, then a new repository |
| is created (see `--vcs` below). |
| |
| include::description-new-authors.adoc[] |
| |
| See man:cargo-new[1] for a similar command which will create a new package in |
| a new directory. |
| |
| == OPTIONS |
| |
| === Init Options |
| |
| include::options-new.adoc[] |
| |
| === Display Options |
| |
| include::options-display.adoc[] |
| |
| === Common Options |
| |
| include::options-common.adoc[] |
| |
| include::section-environment.adoc[] |
| |
| include::section-exit-status.adoc[] |
| |
| == EXAMPLES |
| |
| . Create a binary Cargo package in the current directory: |
| |
| cargo init |
| |
| == SEE ALSO |
| man:cargo[1], man:cargo-new[1] |
