NAME¶

git-clean-forge-fork - create tidy forks for pull requests

VERSION¶

version 0.006

SYNOPSIS¶

git clean-forge-fork [--upstream=REMOTE]

DESCRIPTION¶

Creates a fork for proposing changes to a project hosted on a git forge, like GitHub or GitLab. Also configures the fork to make it obvious that it only exists for submitting changes, so that the fork clutters up your git forge profile a bit less. Also adds a 'fork' remote to which you can push your proposed changes.

OPTIONS¶

--upstream=REMOTE

Specify the name of the upstream git remote, i.e., what you want to fork. Defaults to "origin".

FILES¶

$XDG_CONFIG_HOME/.config/gitforge/access_tokens/DOMAIN

Where DOMAIN is the domain name of the git forge (e.g. "github.com", "salsa.debian.org"), this file should contain an API access token to log in to your account at the git forge. If unset, $XDG_CONFIG_HOME defaults to ~/.config.

SEE ALSO¶

git-nuke-forge-fork(1), git-clean-forge-repo(1)

AUTHOR¶

Sean Whitton <spwhitton@spwhitton.name>

COPYRIGHT AND LICENSE¶

This software is Copyright (c) 2017, 2020 by Sean Whitton <spwhitton@spwhitton.name>.

This is free software, licensed under:

  The GNU General Public License, Version 3, June 2007