From: nomennescio <nomennescio@factorcode.org>
Date: Mon, 21 Oct 2019 13:53:16 +0000 (+0200)
Subject: Added instructions on fetching replace objects for source history
X-Git-Tag: 0.99~3385
X-Git-Url: https://gitweb.factorcode.org/gitweb.cgi?p=factor.git;a=commitdiff_plain;h=d1be15c28de1789d7a473685d41e09043636b365

Added instructions on fetching replace objects for source history
---

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