# BRANCH SHOWMAIN

> Show main branch with the Unity Version Control CLI.

## Description

Shows the main branch of a repository. The main branch of your repository is `/main` by default.

### Usage

```bash
cm branch | br showmain [<repspec>] [--encoding=<name>] [--format=<format_str>] [--dateformat=<date_format>]
```

### Options

| Option / Argument | Description                                  |
| :---------------- | :------------------------------------------- |
| `--encoding`      | Specifies the encoding to use in the output, |

1. : utf-8. See the MSDN documentation at [http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx](http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx) to get the table of supported encodings and its format, (at the end of the page, in the "Name" column). --**format**            Retrieves the output message in a specific format. See Remarks for more info. --**dateformat**        Format used to output dates. repspec             The repository specification where to show the main branch. If no repspec is specified, the command will show the main branch for the repository of the current workspace. (Use `**cm** **help** **objectspec**` to learn more about rep specs.)

## Help

### Remarks

This command shows the main branch of a repository.

#### Output format parameters (--**format** option)

This command accepts a format string to show the output. The output parameters of this command are the following:

| Option / Argument | Description                   |
| :---------------- | :---------------------------- |
| `{id}`            | Branch id.                    |
| `{comment}`       | Comment.                      |
| `{date}`          | Date.                         |
| `{name}`          | Name.                         |
| `{owner}`         | Owner.                        |
| `{parent}`        | Parent branch name.           |
| `{repository}`    | Repository.                   |
| `{repname}`       | Repository name.              |
| `{repserver}`     | Server.                       |
| `{changeset}`     | Head changeset of the branch. |

### Examples

```bash
cm branch showmain
```

(Displays the main branch for the repository of the current workspace.)

```bash
cm branch showmain repo@server:8084
```

(Displays the main branch for the repository `repo` in server `server:8084`.)

```bash
cm br showmain --dateformat="yyyy, dd MMMM" --encoding=utf-8
```

(Displays the main branch of the repository with a given date format, and the output is in utf-8.)

```bash
cm br showmain --format="{id} - {name}"
```

(Displays the main branch of the repository, printing only its id and name.)