home » zplus/clif.git
ID: 8ab79fd8546a3d1a92c245801855113144082336
91 lines — 2K — View raw


Users
-------------------------------------------------------------------------------

# List commands available to the user over SSH

    ssh git@example.org help

# List user repositories and access permissions

    ssh git@example.org info




Repositories
-------------------------------------------------------------------------------

# Clone repository anonymously

    git clone https://example.org/<repository>.git

# Clone repository (for registered users)

    git clone git@example.org:<repository>

# Create new repository

Either clone, or push to, a nonexistent path. A new repository will be initiated
automatically.

    git clone git@example.org:<repository>
    git push git@example.org:<repository> <branch>

# Set repository description

    ssh git@example.org desc <repository> <description>

# Push to repository

    git push git@example.org:<repository>

# Change default branch by repointing HEAD

    ssh git@example.org symbolic-ref <repository> HEAD refs/heads/<branch>

# Delete repository (with D command)

    ssh git@example.org D unlock <repository>
    ssh git@example.org D rm <repository>




Mailing lists
-------------------------------------------------------------------------------

# Create new mailing list

Create a new repository with the suffix ".mlist":

    git clone git@example.org:<repository>.mlist

CLIF will then begin accepting emails for <repository>@example.org and it will
store them inside the <repository>.mlist repository.

# Subscribe to lists

Send an email to the list address with the +subscribe suffix.

    From: You <you@example.org>
    To: <repository>+subscribe@example.org

# Unsubscribe from lists

Send an email to the list address with the +unsubscribe suffix.

    From: You <you@example.org>
    To: <repository>+unsubscribe@example.org

# New thread

Send a new email to any list address.

# Join existing thread

Send an email containing the "In-Reply-To: <Message-ID>" header, where <Message-ID>
is the ID of any previous message.

    From: You <you@example.org>
    To: <repository>@example.org
    In-Reply-To: <Message-ID>