summaryrefslogtreecommitdiffhomepage
path: root/docs/manpages/gbp-import-dscs.xml
blob: d0d1f11cc7396b0d6d02d67ace9a6a8bf4254e20 (plain)
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
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
<refentry id="man.gbp.import.dscs">
  <refentryinfo>
    <address>
      &dhemail;
    </address>
    <author>
      &dhfirstname;
      &dhsurname;
    </author>
  </refentryinfo>
  <refmeta>
    <refentrytitle>gbp-import-dscs</refentrytitle>
    &dhsection;
  </refmeta>
  <refnamediv>
    <refname>gbp-import-dscs</refname>
    <refpurpose>Import multiple versions of a Debian source packages into a Git repository</refpurpose>
  </refnamediv>
  <refsynopsisdiv>
    <cmdsynopsis>
      &gbp-import-dscs;
      <arg><option>options</option></arg>
      <arg><option>gbp import-dsc options</option></arg>
      <arg choice="plain"><replaceable>pkg_1.dsc</replaceable></arg>
      <arg choice="plain"><replaceable>pkg_2.dsc</replaceable></arg>
      <arg choice="plain"><replaceable>...</replaceable></arg>
    </cmdsynopsis>

    <para>or</para>

    <cmdsynopsis>
      &gbp-import-dscs;
      <arg choice="req">--debsnap</arg>
      <arg><option>options</option></arg>
      <arg><option>gbp import-dsc options</option></arg>
      <arg choice="req"><replaceable>package</replaceable></arg>
    </cmdsynopsis>
  </refsynopsisdiv>
  <refsect1>
    <title>DESCRIPTION</title>
    <para>
    &gbp-import-dscs; imports several versions of a Debian source package into
    a &git; repository. To do so, it sorts the packages by their versions first,
    and then imports them via calling &gbp-import-dsc; on each package. 
    </para> 

    <para>
    If the current directory isn't a &git; repository already, the repository is
    created in a subdir of the current working directory, named after the first
    imported package, otherwise the &git; repository in the current working
    directory is being used. This allows for incremental imports.
    </para>
  </refsect1>
  <refsect1>
    <title>OPTIONS</title>
    <variablelist>
      <varlistentry>
        <term><option>--debsnap</option>
        </term>
        <listitem>
	  <para>Fetch snapshots from snapshots.debian.org using debsnap.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><option>--ignore-repo-config</option>
        </term>
        <listitem>
	  <para>Ignore <filename>gbp.conf</filename> files stored in the git
repository itself. This can be useful to ignore branch information and other
options shipped in the package source.</para>
        </listitem>
      </varlistentry>
     </variablelist>
    <para>
    All other options are passed on verbatim to &gbp-import-dsc;.
    </para>
  </refsect1>
  <refsect1>
    <title>SEE ALSO</title>

    <para>
      <xref linkend="man.gbp.import.dsc"/>,
      <xref linkend="man.gbp.buildpackage"/>,
      <xref linkend="man.gbp.import.orig"/>,
      <xref linkend="man.gbp.dch"/>,
      <xref linkend="man.gbp.conf"/>,
      &man.seealso.common;
    </para>
  </refsect1>
  <refsect1>
    <title>AUTHOR</title>

    <para>&dhusername; &dhemail;</para>

  </refsect1>
</refentry>