aboutsummaryrefslogtreecommitdiffstats
path: root/git-package.1
blob: ac3e5cf6cada8421656a45499a9ea4e85195dc50 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
.Dd May 22, 2021
.Dt GIT-PACKAGE 1
.Os
.Sh NAME
.Nm git-package
.Nd create an archive of a named tree suitable for distribution
.Sh SYNOPSIS
.Nm git package
.Op Fl f Ar format
.Ar tree-ish
.Op Ar path...
.Sh DESCRIPTION
.Nm
creates an archive of a named tree (or specific paths within that tree, if
specified) that is suitable for distribution on the world wide web.
It saves the archive to
.Pa <name>-<tree-ish>.<format> ,
where
.Em name
is the title of the repository.
For supported archive formats, see
.Xr git-archive 1 .
A default archive format can be set via
.Xr git-config 1 ,
using the
.Em package.format
option.
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl f Ar format
The format to archive
.Ar tree-ish
as.
Defaults to
.Em package.format ,
or tar.gz if unset.
.El
.Sh SEE ALSO
.Xr git 1 ,
.Xr git-archive 1 ,
.Xr git-config 1
.Sh HISTORY
.Nm
was written due to the lack of a convenient tool to create release
archives for distribution.
.Xr git-archive 1
was considered, but was found to be too burdensome to be deployed regularly.
.Sh AUTHORS
.An -nosplit
.Nm
was written by
.An Wolfgang Müller Aq Mt wolf@oriole.systems .