git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Best practices for updating old repos

From
MEMichael Eager <eager@eagerm.com>
Date
Jun 16, 2017, 00:52 UTC
Message-ID
<59432BCC.2040901@eagerm.com>
Hi All --

I'm working with code that is based on a five year old repository. There are 130 local commits since the repo was forked. Naturally, the upstream project has moved on significantly.

I'm wondering about best approaches to updating the repo to the current upstream version. Here are the approaches I've considered:

- Rebase from upstream.  Likely almost every patch will fail with
   multiple merge conflicts.
- Merge local branch into upstream.  Likely many merge failures, but
   fewer than with rebase.
- Apply individual patches from the old repo to the upstream repo.
   Fix merge conflicts, rebuild, fix build failures.  There may be
   some duplication and additional merge problems created, where a
   later patch from the old repo fixes the same conflict or build
   failure.

I've tried each of these approaches on various projects. Each has problems. After resolving merge issues there are build failures which need to be resolved and additional patches created. The result is that the patch history is a bit chaotic, where there are later patches which fix problems with early patches. I've tried to sort the fix patches to follow the patch they correct, so that the fixes were together and I could merge them, but that can be difficult.

I've used Stacked Git a little, but don't know if it will make any of this easier.

On some projects, I've reimplemented changes in the upstream repo, abandoning the patch history from the old repo:

- Create diff of old repo and upstream.  Apply only the changes
   to add new functionality, which are in the patches to the
   old repo.   Fix problems caused by API changes, renamed files, etc.
- Re-implement the changes on the upstream repo.  Some of the old
   code would be re-used, but modified to fit in the current upstream.
   Some new code would be written.

One other variant of the rebase approach I've thought of is to do this incrementally, rebasing the old repo against an upstream commit a short time after the old repo was forked, fixing any conflicts, rebuilding and fixing build failures. Then repeat, with a bit newer commit. Then repeat, until I get to the top. This sounds tedious, but some of it can be automated. It also might result in my making the changes compatible with upstream code which was later abandoned or significantly changed.

Anyone have a different approach that I should consider? Or maybe offer advice on how to make one of these approaches work better? What is best practice to update an old repo?

-- 
Michael Eager	 eager@eagercon.com
1960 Park Blvd., Palo Alto, CA 94306  650-325-8077
Next: Stefan Beller
Message 1 of 5 in “Best practices for updating old repos”
  1. Michael EagerJun 16, 2017
  2. Stefan BellerJun 16, 2017
  3. Michael EagerJun 16, 2017
  4. Michael EagerJun 16, 2017
  5. Fwd: Best practices for updating old reposMichael O'Cleirigh, Jun 16, 2017

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.