File: dbp.man.dbp.importorig.html

package info (click to toggle)
darcs-buildpackage 0.5.12.2
links: PTS
area: main
in suites: squeeze
size: 716 kB
ctags: 2
sloc: haskell: 452; sh: 62; makefile: 56
file content (491 lines) | stat: -rw-r--r-- 8,368 bytes
parent folder | download | duplicates (2)
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>dbp-importorig</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="Building Debian Packages with darcs-buildpackage"
HREF="dbp.html"><LINK
REL="UP"
TITLE="Command Reference"
HREF="dbp.man.reference.html"><LINK
REL="PREVIOUS"
TITLE="dbp-importdsc"
HREF="dbp.man.dbp.importdsc.html"><LINK
REL="NEXT"
TITLE="dbp-markdeb"
HREF="dbp.man.dbp.markdeb.html"><STYLE
TYPE="text/css"
>.synopsis, .classsynopsis {
    background: #eeeeee;
    border: solid 1px #aaaaaa;
    padding: 0.5em;
}
.programlisting {
    background: #eeeeff;
    border: solid 1px #aaaaff;
    padding: 0.5em;
}
.variablelist {
    padding: 4px;
    margin-left: 3em;
}
.navigation {
    background: #ffeeee;
    border: solid 1px #ffaaaa;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
}
.navigation a {
    color: #770000;
}
.navigation a:visited {
    color: #550000;
}
.navigation .title {
    font-size: 200%;
}</STYLE
></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><TABLE
WIDTH="100%"
CLASS="navigation"
SUMMARY="Navigation header"
CELLPADDING="2"
CELLSPACING="2"
><TR
VALIGN="middle"
><TD
><A
ACCESSKEY="p"
HREF="dbp.man.dbp.importdsc.html"
><IMG
SRC="left.png"
WIDTH="24"
HEIGHT="24"
BORDER="0"
ALT="Prev"></A
></TD
><TD
><A
ACCESSKEY="u"
HREF="dbp.man.reference.html"
><IMG
SRC="up.png"
WIDTH="24"
HEIGHT="24"
BORDER="0"
ALT="Up"></A
></TD
><TD
><A
ACCESSKEY="h"
HREF="dbp.html"
><IMG
SRC="home.png"
WIDTH="24"
HEIGHT="24"
BORDER="0"
ALT="Home"></A
></TD
><TH
WIDTH="100%"
align="center"
>Building Debian Packages with darcs-buildpackage</TH
><TD
><A
ACCESSKEY="n"
HREF="dbp.man.dbp.markdeb.html"
><IMG
SRC="right.png"
WIDTH="24"
HEIGHT="24"
BORDER="0"
ALT="Next"></A
></TD
></TR
></TABLE
><H1
><A
NAME="DBP.MAN.DBP.IMPORTORIG"
></A
>dbp-importorig</H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN376"
></A
><H2
>Name</H2
>dbp-importorig&nbsp;--&nbsp;Import an upstream source into a <SPAN
CLASS="APPLICATION"
>darcs-buildpackage</SPAN
>
      archive</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN380"
></A
><H2
>Synopsis</H2
><P
><B
CLASS="COMMAND"
>dbp-importorig</B
>   <TT
CLASS="REPLACEABLE"
><I
>filename_or_dir</I
></TT
>   <TT
CLASS="REPLACEABLE"
><I
>package</I
></TT
>   <TT
CLASS="REPLACEABLE"
><I
>version</I
></TT
> </P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="DBP.MAN.DBP.IMPORTORIG.DESCRIPTION"
></A
><H2
>Description</H2
><P
>	<B
CLASS="COMMAND"
>dbp-importorig</B
> imports the tar.gz file given by
	<SPAN
CLASS="PROPERTY"
>filename</SPAN
> (or a directory, if
	<SPAN
CLASS="PROPERTY"
>filename</SPAN
> is one) into the <SPAN
CLASS="APPLICATION"
>darcs-buildpackage</SPAN
>
	archive.  Since upstream tarballs do not contain the package
	and version information in a unified format, you must specify
	that on the command line as well.
      </P
><P
>        It is an
        error to run <B
CLASS="COMMAND"
>dbp-importorig</B
> on a package when a newer version
        already exists in the archive.  <B
CLASS="COMMAND"
>dbp-importorig</B
> detects this
        condition and will terminate without causing harm.
      </P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="DBP.MAN.DBP.IMPORTORIG.OPTIONS"
></A
><H2
>Options</H2
><P
></P
><TABLE
CLASS="variablelist"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
><TBODY
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
><A
NAME="AEN402"><SPAN
STYLE="white-space: nowrap"
>filename_or_dir</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>	      Gives the path to a tar.gz file to import.
	    </P
><P
>	      Alternatively, gives the path to a directory to import
	      without unpacking anything.
	    </P
></TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
><A
NAME="AEN407"><SPAN
STYLE="white-space: nowrap"
>package</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>Gives the Debian source package name
	      corresponding to this upstream package.
	    </P
></TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
><A
NAME="AEN411"><SPAN
STYLE="white-space: nowrap"
>version</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>Gives the package version
	      corresponding to this upstream package.  This should not
	      contain the Debian part (-1, -2, etc).
	    </P
></TD
></TR
></TBODY
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN415"
></A
><H2
>Files</H2
><P
>        The following specific files are used by this application:
      </P
><P
></P
><TABLE
CLASS="variablelist"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
><TBODY
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
><A
NAME="AEN419"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="FILENAME"
>~/.darcs-buildpackage</TT
></SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>              Specifies the location of the canonical Debian and
              upstream repositories.
	    </P
></TD
></TR
></TBODY
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN424"
></A
><H2
>Environment</H2
><P
>        This application uses no environment variables directly, but
        other programs it calls may do so.
      </P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN427"
></A
><H2
>Copyright</H2
><P
>    darcs-buildpackage, all associated scripts and programs, this manual,
    and all build scripts are Copyright &copy; 2003 - 2005 John Goerzen.
  </P
><P
>        This program is free software; you can redistribute it and/or modify
        it under the terms of the GNU General Public License as published by
        the Free Software Foundation; either version 2 of the License, or
        (at your option) any later version.
      </P
><P
>        This program is distributed in the hope that it will be useful,
        but WITHOUT ANY WARRANTY; without even the implied warranty of
        MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
        GNU General Public License for more details.
      </P
><P
>        You should have received a copy of the GNU General Public License
        along with this program; if not, write to the Free Software
        Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
      </P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN433"
></A
><H2
>Author</H2
><P
>	<SPAN
CLASS="APPLICATION"
>darcs-buildpackage</SPAN
>, its modules, documentation, executables, and all
	included files, except where noted, was written by
	John Goerzen <CODE
CLASS="EMAIL"
>&#60;<A
HREF="mailto:jgoerzen@complete.org"
>jgoerzen@complete.org</A
>&#62;</CODE
> and
	copyright is held as stated in the COPYRIGHT section.
      </P
><P
>	<SPAN
CLASS="APPLICATION"
>darcs-buildpackage</SPAN
> may be downloaded from the Debian packaging system or at
	<A
HREF="http://packages.debian.org/darcs-buildpackage"
TARGET="_top"
>http://packages.debian.org/darcs-buildpackage</A
>.
      </P
><P
>	<SPAN
CLASS="APPLICATION"
>darcs-buildpackage</SPAN
> may also be downloaded using Darcs by running
        <B
CLASS="COMMAND"
>darcs get --partial
        http://darcs.complete.org/darcs-buildpackage</B
>.
      </P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN444"
></A
><H2
>See Also</H2
><P
>    Detailed usage information, including a background and a description of how
    the tools fit together, can be found in the darcs-buildpackage Manual.  On
    Debian systems, you may find this at
    <TT
CLASS="FILENAME"
>/usr/share/doc/darcs-buildpackage</TT
>.
  </P
><P
>    <SPAN
CLASS="APPLICATION"
>darcs-buildpackage</SPAN
> applications have references in that manual and the
    following manpages: 
    <SPAN
CLASS="APPLICATION"
>dbp-importdsc</SPAN
>(1),
    <SPAN
CLASS="APPLICATION"
>dbp-importorig</SPAN
>(1),
    <SPAN
CLASS="APPLICATION"
>dbp-markdeb</SPAN
>(1),
    <SPAN
CLASS="APPLICATION"
>darcs-buildpackage</SPAN
>(1).
  </P
><P
>	Other related references include:
	<SPAN
CLASS="APPLICATION"
>darcs</SPAN
>(1),
	<SPAN
CLASS="APPLICATION"
>dpkg-source</SPAN
>(1),
	<SPAN
CLASS="APPLICATION"
>tar</SPAN
>(1).
      </P
></DIV
><TABLE
CLASS="navigation"
WIDTH="100%"
SUMMARY="Navigation footer"
CELLPADDING="2"
CELLSPACING="2"
><TR
VALIGN="middle"
><TD
ALIGN="left"
><A
ACCESSKEY="p"
HREF="dbp.man.dbp.importdsc.html"
><B
>&lt;&lt;&lt;&nbsp;dbp-importdsc</B
></A
></TD
><TD
ALIGN="right"
><A
ACCESSKEY="n"
HREF="dbp.man.dbp.markdeb.html"
><B
>dbp-markdeb&nbsp;&gt;&gt;&gt;</B
></A
></TD
></TR
></TABLE
></BODY
></HTML
>