summaryrefslogtreecommitdiff
path: root/src/cli/README.md
blob: 26f11d90afb50280b63b57d1857c360a3bbc8fea (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
# cli

A git-compatible command-line interface that uses libgit2.

## Adding commands

1. Individual commands have a `main`-like top-level entrypoint.  For example:

   ```c
   int cmd_help(int argc, char **argv)
   ```

   Although this is the same signature as `main`, commands are not built as
   individual standalone executables, they'll be linked into the main cli.
   (Though there may be an option for command executables to be built as
   standalone executables in the future.)

2. Commands are prototyped in `cmd.h` and added to `main.c`'s list of
   commands (`cli_cmds[]`).  Commands should be specified with their name,
   entrypoint and a brief description that can be printed in `git help`.
   This is done because commands are linked into the main cli.