Difference between revisions of "Documentation/Nightly/Developers/FAQ/SVNtoGitHub"

From Slicer Wiki
Jump to: navigation, search
Tag: 2017 source edit
Tag: 2017 source edit
 
(9 intermediate revisions by the same user not shown)
Line 11: Line 11:
 
To ensure existing references to both Git SHA and Pull Requests are reachable, the mirrored GitHub repository has been renamed to https://github.com/Slicer/SlicerGitSVNArchive
 
To ensure existing references to both Git SHA and Pull Requests are reachable, the mirrored GitHub repository has been renamed to https://github.com/Slicer/SlicerGitSVNArchive
  
== What is SlicerGitSVNArchive repository ? ==
+
== Where are the data files removed from the filtered history ? ==
  
This corresponds to the original GitHub repository that was a mirror of the Slicer SVN authoritative repository. See former <code>https://github.com/Slicer/Slicer</code> was renamed into https://github.com/Slicer/SlicerGitSVNArchive
+
Before filtering the history, we made sure all large data files were effectively removed from the latest version and downloaded using either ExternalData CMake module or SampleData Slicer module.
  
== What happen to SVN repository ? ==
+
For older version, each commit introducing large files has been updated by removing the large files and updating the file <tt>GIT_MIGRATION_DATA_REMOVED.txt</tt> by listing the corresponding SHA256 and file paths.
  
Until September 2020, SVN server http://svn.slicer.org hosting the Dart, NAMICSandBox, Slicer3, Slicer3-lib-mirrors and Slicer4 will remain available.
+
Corresponding files have been uploaded as release assets named <tt>&lt;filename&gt;_&lt;sha256&gt;</tt>. See https://github.com/Slicer/SlicerGitMigrationDataRemoved/releases
 +
 
 +
 
 +
== What is the SlicerGitSVNArchive repository ? ==
 +
 
 +
This corresponds to the original GitHub repository that was a mirror of the Slicer SVN authoritative repository. The former <b>Slicer/Slicer</b> repository was renamed into <b>[https://github.com/Slicer/SlicerGitSVNArchive Slicer/SlicerGitSVNArchive]</b>
 +
 
 +
== What happen to the SVN repository ? ==
 +
 
 +
Until September 2020, SVN server http://svn.slicer.org hosting the Dart, NAMICSandBox, Slicer3, Slicer3-lib-mirrors and Slicer4 repositories will remain available.
  
 
The web server http://viewvc.slicer.org/ will be converted into a static html website.
 
The web server http://viewvc.slicer.org/ will be converted into a static html website.
  
 +
== What happen to the Mantis issue tracker ? ==
 +
 +
Mantis issue tracker has been retired and new issues should be created here: https://github.com/Slicer/Slicer/issues
 +
 +
For every mantis issues, a GitHub issue has been created with a link to the retired mantis tracker.
 +
 +
To support this, the following redirections have been established:
 +
* https://issues.slicer.org redirects to https://github.com/Slicer/Slicer/issues
 +
* https://mantisarchive.slicer.org redirects to the retired mantis issue tracker
 +
* <tt><nowiki>https://issues.slicer.org/XXX</nowiki></tt> redirects to <tt><nowiki>https://github.com/Slicer/Slicer/issues/XXX</nowiki></tt>
 +
* <tt><nowiki>https://issues.slicer.org/view.php?id=XXX</nowiki></tt> redirects to <tt><nowiki>https://github.com/Slicer/Slicer/issues/XXX</nowiki></tt>
 +
 +
Slicer4 project has been disabled in Mantis. This means that no issues will be visible on the main page and that user will not be able to create issues in mantis.
 +
 +
== How to update the forked origin of your online Slicer fork ? ==
 +
 +
Following the rename of <tt>Slicer</tt> to <tt>SlicerGitSVNArchive</tt>, existing GitHub fork are referencing the "incorrect" repository:
 +
 +
[[File:Slicer-fork-reference-SlicerGitSVNArchive.png]]
 +
 +
To address this, you may delete your fork and re-fork https://github.com/Slicer/Slicer
 +
 +
If there are branches published on your fork that you would like to keep, you have two options:
 +
* before deleting your online fork, clone your Slicer fork locally so that you could rebase and re-publish your branches
 +
* rename your Slicer fork to <tt>SlicerGitSVNArchive</tt> (this should be instead of deleting your online fork)
 +
 +
== How to update existing Slicer custom application ? ==
  
== What happen to Slicer mantis issue tracker ? ==
+
To ensure Slicer sources can be checked out using the provided Git SHA, in <tt>CMakeLists.txt</tt> file, replace lines like:
  
TBD
+
  GIT_REPOSITORY git://github.com/Slicer/Slicer
  
== How to update existing Slicer checkout ? ==
+
with
  
TBD
+
  GIT_REPOSITORY git://github.com/Slicer/SlicerGitSVNArchive

Latest revision as of 02:53, 13 March 2020

Home < Documentation < Nightly < Developers < FAQ < SVNtoGitHub


For the latest Slicer documentation, visit the read-the-docs.


SVNtoGitHub

What happen to the existing Slicer GitHub repository ?

Between 2011 and March 2020, Slicer sources were maintained in a SVN repository automatically mirrored on GitHub. To speedup time required to checkout Slicer source code, large data files have been removed from the Slicer commit history.

To ensure existing references to both Git SHA and Pull Requests are reachable, the mirrored GitHub repository has been renamed to https://github.com/Slicer/SlicerGitSVNArchive

Where are the data files removed from the filtered history ?

Before filtering the history, we made sure all large data files were effectively removed from the latest version and downloaded using either ExternalData CMake module or SampleData Slicer module.

For older version, each commit introducing large files has been updated by removing the large files and updating the file GIT_MIGRATION_DATA_REMOVED.txt by listing the corresponding SHA256 and file paths.

Corresponding files have been uploaded as release assets named <filename>_<sha256>. See https://github.com/Slicer/SlicerGitMigrationDataRemoved/releases


What is the SlicerGitSVNArchive repository ?

This corresponds to the original GitHub repository that was a mirror of the Slicer SVN authoritative repository. The former Slicer/Slicer repository was renamed into Slicer/SlicerGitSVNArchive

What happen to the SVN repository ?

Until September 2020, SVN server http://svn.slicer.org hosting the Dart, NAMICSandBox, Slicer3, Slicer3-lib-mirrors and Slicer4 repositories will remain available.

The web server http://viewvc.slicer.org/ will be converted into a static html website.

What happen to the Mantis issue tracker ?

Mantis issue tracker has been retired and new issues should be created here: https://github.com/Slicer/Slicer/issues

For every mantis issues, a GitHub issue has been created with a link to the retired mantis tracker.

To support this, the following redirections have been established:

Slicer4 project has been disabled in Mantis. This means that no issues will be visible on the main page and that user will not be able to create issues in mantis.

How to update the forked origin of your online Slicer fork ?

Following the rename of Slicer to SlicerGitSVNArchive, existing GitHub fork are referencing the "incorrect" repository:

Slicer-fork-reference-SlicerGitSVNArchive.png

To address this, you may delete your fork and re-fork https://github.com/Slicer/Slicer

If there are branches published on your fork that you would like to keep, you have two options:

  • before deleting your online fork, clone your Slicer fork locally so that you could rebase and re-publish your branches
  • rename your Slicer fork to SlicerGitSVNArchive (this should be instead of deleting your online fork)

How to update existing Slicer custom application ?

To ensure Slicer sources can be checked out using the provided Git SHA, in CMakeLists.txt file, replace lines like:

 GIT_REPOSITORY git://github.com/Slicer/Slicer

with

 GIT_REPOSITORY git://github.com/Slicer/SlicerGitSVNArchive