Code/Imports - Launchpad Help

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html;charset=utf-8"> <meta name="robots" content="index,nofollow"> <title>Code/Imports - Launchpad Help</title> <script type="text/javascript" src="/moin_static198/common/js/common.js"></script> <script type="text/javascript">  </script> <link rel="stylesheet" type="text/css" charset="utf-8" media="all" href="/moin_static198/lp20/css/common.css"> <link rel="stylesheet" type="text/css" charset="utf-8" media="screen" href="/moin_static198/lp20/css/screen.css"> <link rel="stylesheet" type="text/css" charset="utf-8" media="print" href="/moin_static198/lp20/css/print.css"> <link rel="stylesheet" type="text/css" charset="utf-8" media="projection" href="/moin_static198/lp20/css/projection.css">   <link rel="alternate" title="Launchpad Help: Code/Imports" href="/Code/Imports?diffs=1&show_att=1&action=rss_rc&unique=0&page=Code%2FImports&ddiffs=1" type="application/rss+xml"> <script type="text/javascript"> var _gaq = _gaq || []; _gaq.push(['_setAccount', 'UA-12833497-4']); _gaq.push(['_trackPageview']); (function() { var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); })(); </script> <link rel="Start" href="/FrontPage"> <link rel="Alternate" title="Wiki Markup" href="/Code/Imports?action=raw"> <link rel="Alternate" media="print" title="Print View" href="/Code/Imports?action=print"> <link rel="Up" href="/Code"> <link rel="Search" href="/FindPage"> <link rel="Index" href="/TitleIndex"> <link rel="Glossary" href="/WordIndex"> <link rel="Help" href="/HelpOnFormatting"> </head> <body lang="en" dir="ltr"> <div id="header"> <h1> <a href="https://help.launchpad.net/" class="header-link"> <img src=' /moin_static198/lp20/img/logo.png ' /> launchpad <strong>help</strong></a> </h1> <div id="finder"> <div class="fixbox"> <form id="searchform" method="get" action=""> <input type="hidden" name="action" value="fullsearch"> <input type="hidden" name="context" value="180"> <input id="searchinput" type="text" name="value" value="" size="20" onfocus="searchFocus(this)" onblur="searchBlur(this)" onkeyup="searchChange(this)" onchange="searchChange(this)" alt="Search"> </form> </div> <ul class="editbar"><li><span class="disabled">Immutable Page</span></li><li><a class="nbinfo" href="/Code/Imports?action=info" rel="nofollow">Info</a></li><li><a class="nbattachments" href="/Code/Imports?action=AttachFile" rel="nofollow">Attachments</a></li><li> <form class="actionsmenu" method="GET" action="/Code/Imports"> <div> <label>More Actions:</label> <select name="action" onchange="if ((this.selectedIndex != 0) && (this.options[this.selectedIndex].disabled == false)) { this.form.submit(); } this.selectedIndex = 0;"> <option value="raw">Raw Text</option> <option value="print">Print View</option> <option value="RenderAsDocbook">Render as Docbook</option> <option value="refresh">Delete Cache</option> <option value="show" disabled class="disabled">------------------------</option> <option value="SpellCheck">Check Spelling</option> <option value="LikePages">Like Pages</option> <option value="LocalSiteMap">Local Site Map</option> <option value="show" disabled class="disabled">------------------------</option> <option value="RenamePage" disabled class="disabled">Rename Page</option> <option value="DeletePage" disabled class="disabled">Delete Page</option> <option value="show" disabled class="disabled">------------------------</option> <option value="show" disabled class="disabled">Subscribe User</option> <option value="show" disabled class="disabled">------------------------</option> <option value="show" disabled class="disabled">Remove Spam</option> <option value="show" disabled class="disabled">Revert to this revision</option> <option value="PackagePages">Package Pages</option> <option value="SyncPages">Sync Pages</option> <option value="show" disabled class="disabled">------------------------</option> <option value="Load">Load</option> <option value="Save">Save</option> <option value="SlideShow">SlideShow</option> </select> <input type="submit" value="Do"> </div> <script type="text/javascript">  </script> </form> </li></ul> </div> </div> <div id="locationline"> </div> <div id="sepbar"> </div> <div id="login"> <div class="fl"> <h1 class="maintitle"> Code/Imports </h1> </div> <div class="fr"> Not logged in - <a href="/?action=login">Log In / Register</a> </div> </div> <div id="pageline"><hr style="display:none;"></div> <div class="message"> </div> <div id="page" lang="en" dir="ltr"> <div dir="ltr" id="content" lang="en"><span class="anchor" id="top"></span> <span class="anchor" id="line-1"></span><span class="anchor" id="line-2"></span><span class="anchor" id="line-3"></span><p class="line867"><small><a href="/FrontPage">Launchpad Help</a> > <a href="/Code">Code</a> > Imports from Bazaar, CVS, Subversion and Git </small> <span class="anchor" id="line-4"></span><span class="anchor" id="line-5"></span><div><table style="&quot; float:right; font-size: 0.9em; width:40%; background:#F1F1ED; margin: 0 0 1em 1em; &quot;"><tbody><tr> <td style="&quot; padding:0.5em; &quot;"><p class="line891"><div class="table-of-contents"><p class="table-of-contents-heading">Contents<ol><li> <a href="#Overview">Overview</a></li><li> <a href="#Trunk_imports">Trunk imports</a></li><li> <a href="#Requesting_an_import">Requesting an import</a><ol><li> <a href="#Import_precision">Import precision</a></li><li> <a href="#Making_your_request">Making your request</a></li></ol></li><li> <a href="#Next_step">Next step</a></li></ol></div></td> </tr> </tbody></table></div><span class="anchor" id="line-6"></span><span class="anchor" id="line-7"></span><p class="line867"> <h1 id="Overview">Overview</h1> <span class="anchor" id="line-8"></span><span class="anchor" id="line-9"></span><p class="line874">There's a lot of free software code available in CVS, Subversion (SVN) and Git repositories, or Bazaar repositories that aren't hosted on Launchpad. Sometimes you're going to want to have this code available on Launchpad in Bazaar. Perhaps you use Bazaar for your project and you'd like to use a Git-based project as a dependency. Perhaps you'd like to do some work on a CVS project but would prefer to use a more modern version control system. Maybe you'd like to hack on a project that uses Subversion, but you don't have commit rights. <span class="anchor" id="line-10"></span><span class="anchor" id="line-11"></span><p class="line874">If any of this is striking a chord, then you probably want to know about Launchpad's code import system. Read on. <span class="anchor" id="line-12"></span><span class="anchor" id="line-13"></span><p class="line867"> <h1 id="Trunk_imports">Trunk imports</h1> <span class="anchor" id="line-14"></span><span class="anchor" id="line-15"></span><p class="line862">Launchpad supports the import of the primary development trunk of a project from CVS, SVN or Git. A good example is the Drupal project. Launchpad imports Drupal's trunk as <a class="https" href="https://launchpad.net/drupal/head">its "head" series</a> in Launchpad. <span class="anchor" id="line-16"></span><span class="anchor" id="line-17"></span><p class="line874">As you can see, there's a Bazaar branch of Drupal's code. Launchpad updates that branch regularly by importing the latest from Drupal's trunk CVS repository. It works just like any other branch in Launchpad: you can see the latest commits and you can create your own Bazaar branch of it and then upload it back to Launchpad. <span class="anchor" id="line-18"></span><span class="anchor" id="line-19"></span><p class="line867"> <h1 id="Requesting_an_import">Requesting an import</h1> <span class="anchor" id="line-20"></span><span class="anchor" id="line-21"></span><p class="line867"> <h2 id="Import_precision">Import precision</h2> <span class="anchor" id="line-22"></span><span class="anchor" id="line-23"></span><p class="line862">Unfortunately, the initial import process is not an exact science. CVS and Subversion don't record enough information for a deterministic import into Bazaar, which is more rigorous about things like renames and changesets. (Git mostly does, but sometimes represents that information <a class="http" href="http://blog.launchpad.net/code/git-branch-imports-now-in-public-beta">quite differently</a> from how Bazaar does.) <span class="anchor" id="line-24"></span><span class="anchor" id="line-25"></span><p class="line874">In most cases, where the CVS and SVN repositories have not been manually edited or altered, we can infer what we need and the import goes through smoothly. Sometimes, however, people have tried to work around limitations in CVS or SVN by altering the repositories behind-the-scenes. This is especially true of CVS, where people have to manually tinker with its internals to do renames. <span class="anchor" id="line-26"></span><span class="anchor" id="line-27"></span><p class="line867"> <h2 id="Making_your_request">Making your request</h2> <span class="anchor" id="line-28"></span><span class="anchor" id="line-29"></span><p class="line874">So, a good import is part voodoo, part science, part luck. An import will not lose data - we can verify that the result of a checkout of the Bazaar branch is identical to a checkout of the CVS branch. But getting it to that point may well require inspection and custom work. <span class="anchor" id="line-30"></span><span class="anchor" id="line-31"></span><p class="line862">For this reason, we don't have an automated process for the import. Instead, you <a class="https" href="https://code.launchpad.net/+code-imports/+new">request one</a> and we put it in a queue. Sometimes it takes just an hour or two, sometimes it can take days to get a good import together. In a very few cases, the old repositories are so wedged that we can't get all the history exactly right. It's best just to get started and see how it goes. We are constantly improving the voodoo. <span class="anchor" id="line-32"></span><span class="anchor" id="line-33"></span><p class="line867"> <h1 id="Next_step">Next step</h1> <span class="anchor" id="line-34"></span><span class="anchor" id="line-35"></span><p class="line862">Informal support happens in many different places in the free software world. Launchpad aims to bring bug tracker-like qualities to giving and asking for help. Let's look at <a href="/Answers">Launchpad Answers</a>. <span class="anchor" id="line-36"></span><span class="anchor" id="line-37"></span><span class="anchor" id="line-38"></span><div><table style="&quot; width: 100%; &quot;"><tbody><tr> <td><p class="line862"> <small><a href="/Code/PersonalBranches">< Personal branches</a> </small> </td> <td style="&quot; text-align: right; &quot;"><p class="line862"> <small><a href="/Answers">Community support ></a> </small> </td> </tr> </tbody></table></div><span class="anchor" id="line-39"></span><span class="anchor" id="bottom"></span></div><p id="pageinfo" class="info" lang="en" dir="ltr">Code/Imports (last edited 2012-09-27 14:41:50 by <span title="??? @ host86-165-56-242.range86-165.btcentralplus.com[86.165.56.242]">host86-165-56-242</span>)</p> <div id="pagebottom"></div> </div> <div id="footer"> <p class="menu"> <a href="https://help.launchpad.net/Legal">Terms of use</a> | <a href="https://launchpad.net/feedback">Help improve Launchpad</a> | <a href="https://launchpad.net/faq">FAQ</a> | <a href="/RecentChanges">Recent Changes</a></p> <p> <a rel="license" href="http://creativecommons.org/licenses/by/2.0/uk/"> <span xmlns:dc="http://purl.org/dc/elements/1.1/" href="http://purl.org/dc/dcmitype/Text" property="dc:title" rel="dc:type">Launchpad Help</span> by <a xmlns:cc="http://creativecommons.org/ns#" href="https://canonical.com/" property="cc:attributionName" rel="cc:attributionURL">Canonical Ltd</a> is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/2.0/uk/">Creative Commons Attribution 2.0 UK: England & Wales License</a>. <img alt="Creative Commons License" style="border-width:0;vertical-align:middle;" src="https://licensebuttons.net/l/by/2.0/uk/80x15.png" /></a> </p> <p>© 2004-2019 <a href="https://canonical.com/" target="_blank">Canonical Limited.</a></p> </div> </body> </html>

CINXE.COM

Code/Imports - Launchpad Help