From d8b85fe8dc48fafe87b482ae36eb388a33c806f0 Mon Sep 17 00:00:00 2001 From: Mohammad Akhlaghi Date: Wed, 1 Jan 2020 14:46:50 +0000 Subject: Added step README-hacking's checklist to avoid merging dummy files During the checklist we guide the user to delete the dummy `delete-me*' files from their custom branch. Later, if the dummy files are updated in the template's master branch, if the user merges with the template branch, these files will be written back into their project! This is very annoying! With this commit, a step was added in the `README-hacking.md' checklist, just after deleting the dummy files to avoid this problem using the `.gitattributes' file, telling Git to keep the changes as implemented in the merging branch (`ours'). --- README-hacking.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/README-hacking.md b/README-hacking.md index 75d869c..f545fa0 100644 --- a/README-hacking.md +++ b/README-hacking.md @@ -653,6 +653,21 @@ First custom commit $ ./project make ``` + - Tell Git _not_ to merge changes in the dummy `delete-me` files (by + keeping their names in a `.gitattributes` file. Note that only the + first one is a `>` (to re-write the file), the rest are `>>` (to + append to it). After doing this step in your own branch, when future + commits of the template make a change in the dummy files, they will + not be imported into your project's branch (it can be annoying!). + + ```shell + $ echo "tex/src/delete-me.mk merge=ours" > .gitattributes + $ echo "tex/src/delete-me-demo.mk merge=ours" >> .gitattributes + $ echo "reproduce/analysis/make/delete-me.mk merge=ours" >> .gitattributes + $ echo "reproduce/analysis/config/delete-me-num.mk merge=ours" >> .gitattributes + $ git add .gitattributes + ``` + - **Copyright and License notice**: To be usable/modifiable by others after publication, _all_ the "copyright-able" files in your project (those larger than 10 lines) must have a copyright notice and license -- cgit v1.2.1