Added instructions on fetching replace objects for source history

master
nomennescio 2019-10-21 15:53:16 +02:00 committed by Doug Coleman
parent 96b891f5d8
commit d1be15c28d
1 changed files with 19 additions and 0 deletions

View File

@ -127,6 +127,25 @@ The Factor source tree is organized as follows:
* `misc/` - editor modes, icons, etc * `misc/` - editor modes, icons, etc
* `unmaintained/` - now at [factor-unmaintained](https://github.com/factor/factor-unmaintained) * `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 ## Community
Factor developers meet in the `#concatenative` channel on Factor developers meet in the `#concatenative` channel on