From d1be15c28de1789d7a473685d41e09043636b365 Mon Sep 17 00:00:00 2001 From: nomennescio Date: Mon, 21 Oct 2019 15:53:16 +0200 Subject: [PATCH] Added instructions on fetching replace objects for source history --- README.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/README.md b/README.md index 5901506db2..f9f7fde4f7 100644 --- a/README.md +++ b/README.md @@ -127,6 +127,25 @@ The Factor source tree is organized as follows: * `misc/` - editor modes, icons, etc * `unmaintained/` - now at [factor-unmaintained](https://github.com/factor/factor-unmaintained) +## Source History + +During Factor's lifetime, sourcecode has lived in many repositories. Unfortunately, the first import in Git did not keep history. History has been partially recreated from what could be salvaged. Due to the nature of Git, it's only possible to add history without disturbing upstream work, by using replace objects. These need to be manually fetched, or need to be explicitly added to your git remote configuration. + +Use: +`git fetch origin 'refs/replace/*:refs/replace/*'` + +or add the following line to your configuration file + +``` +[remote "origin"] + url = ... + fetch = +refs/heads/*:refs/remotes/origin/* + ... + fetch = +refs/replace/*:refs/replace/* +``` + +Then subsequent fetches will automatically update any replace objects. + ## Community Factor developers meet in the `#concatenative` channel on -- 2.34.1