vtk-m/Utilities/GitSetup
Kenneth Moreland 394369368c Revert spelling correction in GitSetup script
A recent merge request corrected several spelling errors in VTK-m.
One such correction was in the git-gitlab-sync script in the
Utilities/GitSetup directory. This commit reverts the change in
this specific file for two reasons.

1. The changed introduced a \' inside a single quote string (to
correct cant to can't). However, single quotes in shell scripts
do not allow you to escape characters like that, and thus this
causes an error when running the script.

2. This script actually comes from a separate repository
(https://gitlab.kitware.com/utils/gitsetup) that we occasionally
syncronize with. To prevent confusion, we should minimize the
divergence between this repository and that one. If someone wants
to make this change, it should really be made in the GitSetup
repository.
2018-01-31 15:59:57 -07:00
..
.gitattributes Merge branch 'upstream-GitSetup' into add_setup_for_development 2017-06-07 09:58:36 -04:00
config Enable SetupForDevelopment in VTK-m 2017-06-07 10:02:38 -04:00
git-gitlab-push Merge branch 'upstream-GitSetup' 2017-10-23 15:35:29 -06:00
git-gitlab-sync Revert spelling correction in GitSetup script 2018-01-31 15:59:57 -07:00
LICENSE Merge branch 'upstream-GitSetup' into add_setup_for_development 2017-06-07 09:58:36 -04:00
NOTICE Merge branch 'upstream-GitSetup' into add_setup_for_development 2017-06-07 09:58:36 -04:00
README Merge branch 'upstream-GitSetup' into add_setup_for_development 2017-06-07 09:58:36 -04:00
setup-gitlab Merge branch 'upstream-GitSetup' into add_setup_for_development 2017-06-07 09:58:36 -04:00
setup-hooks Fix errors with variable names with hyphen in git setup scripts 2017-09-19 10:40:51 -06:00
setup-ssh Fix errors with variable names with hyphen in git setup scripts 2017-09-19 10:40:51 -06:00
setup-upstream Merge branch 'upstream-GitSetup' into add_setup_for_development 2017-06-07 09:58:36 -04:00
setup-user Merge branch 'upstream-GitSetup' into add_setup_for_development 2017-06-07 09:58:36 -04:00
tips Fix errors with variable names with hyphen in git setup scripts 2017-09-19 10:40:51 -06:00

Kitware Local Git Setup Scripts


Introduction
------------

This is a collection of local Git development setup scripts meant for
inclusion in project source trees to aid their development workflow.
Project-specific information needed by the scripts may be configured
in a "config" file added next to them in the project.


Import
------

A project may import these scripts into their source tree by
initializing a subtree merge.  Bring up a Git prompt and set the
current working directory inside a clone of the target project.
Fetch the "setup" branch from the GitSetup repository:

 $ git fetch ../GitSetup setup:setup

Prepare to merge the branch but place the content in a subdirectory.
Any prefix (with trailing '/') may be chosen so long as it is used
consistently within a project through the rest of these instructions:

 $ git merge -s ours --no-commit setup
 $ git read-tree -u --prefix=Utilities/GitSetup/ setup

Commit the merge with an informative message:

 $ git commit
 ------------------------------------------------------------------------
 Merge branch 'setup'

 Add Utilities/GitSetup/ directory using subtree merge from
 the general GitSetup repository "setup" branch.
 ------------------------------------------------------------------------

Optionally add to the project ".gitattributes" file the line

 /Utilities/GitSetup export-ignore

to exclude the GitSetup directory from inclusion by "git archive"
since it does not make sense in source tarballs.


Configuration
-------------

Read the "Project configuration instructions" comment in each script.
Add a "config" file next to the scripts with desired configuration
(optionally copy and modify "config.sample").  For example, to
configure the "setup-hooks" script:

 $ git config -f Utilities/GitSetup/config hooks.url "$url"

where "$url" is the project repository publishing the "hooks" branch.
When finished, add and commit the configuration file:

 $ git add Utilities/GitSetup/config
 $ git commit


Update
------

A project may update these scripts from the GitSetup repository.
Bring up a Git prompt and set the current working directory inside a
clone of the target project.  Fetch the "setup" branch from the
GitSetup repository:

 $ git fetch ../GitSetup setup:setup

Merge the "setup" branch into the subtree:

 $ git merge -X subtree=Utilities/GitSetup setup

where "Utilities/GitSetup" is the same prefix used during the import
setup, but without a trailing '/'.


License
-------

Distributed under the Apache License 2.0.
See LICENSE and NOTICE for details.