intro.md

   1 # Git is ...
   2 Source Code Management (SCM) and it's great. Check out https://git-scm.com/ for
   3 details.
   4
   5 # Init - do it once per repository
   6 You may clone it like `git clone URL` or create one from a folder by `git
   7 init`.
   8
   9 Also, just after first commit, you may be asked to set up your name and email
  10 address with `git config ...` command. If `--global` is used the name and/or
  11 email will be automatically used for all the commits.
  12
  13 ## Command `git clone`
  14 Copy existing repository that is available online from some server to local
  15 directory.
  16 ```
  17 git clone ssh://git@rtime.felk.cvut.cz/hubacji1/oneflow.git
  18 ```
  19
  20 ## Command `git init`
  21 Initialize directory to be able to use git commands.
  22 ```
  23 git init
  24 ```
  25
  26 ## Command `git config`
  27 Setting up your name and email address is required at minimal.
  28 ```
  29 git config user.name "Your Name"
  30 git config user.email you@example.com
  31 ```
  32
  33 If the name and email should persist as default for any other git repository:
  34 ```
  35 git config --global user.name "Your Name"
  36 git config --global user.email you@example.com
  37 ```
  38
  39 # Explore the repository history
  40 The command that show the whole history is `git log`. The history is build from
  41 commits - changes to files in row scale.
  42
  43 The changes of the commit can be shown by `git show COMMIT_ID`. Where the
  44 `COMMIT_ID` is the identifier obtained from `git log` command.
  45
  46 ## Command `git log`
  47 Show the commited history changes in descending order.
  48 ```
  49 git log
  50 ```
  51
  52 There is some useful parameters that may be combined:
  53 ```
  54 git log --graph
  55 git log --oneline
  56 git log --decorate
  57 ```
  58
  59 ## Command `git show`
  60 Use the change stored in history.
  61 ```
  62 git show COMMIT_ID
  63 ```
  64
  65 # What is repository current state
  66 The status of the repository can be checked by `git status` command. This
  67 allows you to see *new files* that are not yet tracked, *changed files* whose
  68 changes are not yet ready to be commited to the log history and *changed files*
  69 that are ready.
  70
  71 The `git diff` command shows *changes* in not-yet-ready files and `git diff
  72 --cached` shows *changes* that are ready to be committed.
  73
  74 ## Command `git status`
  75 Show information about files in repository.
  76 ```
  77 git status
  78 ```
  79
  80 There are 3 states for file changes (let's call them *patches*) before stored
  81 to git history: *untracked*, *unstaged*, and *staged*. Note that the whole file
  82 may be patch. Also, `git status` command does not show patches, but files
  83 containing these patches.
  84
  85 *Untracked* means that patch was not stored by git yet.
  86
  87 *Unstaged* files has older version stored in git history but patches are not
  88 ready to be stored in git history.
  89
  90 *Staged* files has older version stored in git and patches will be stored to
  91 git history as soon as `git commit` command is used.
  92
  93 ## Command `git diff`
  94 The patches (file changes) may be shown by `git diff` command (because `git
  95 status` show files not patches).
  96
  97 Unstaged patches can be seen by:
  98 ```
  99 git diff
 100 ```
 101
 102 And staged patches by:
 103 ```
 104 git diff --cached
 105 ```
 106
 107 # Build repository history
 108 Use `git commit` to store staged patches to git history. Moving patches and
 109 files between states described above is done by `git add` and `git reset`
 110 commands.
 111
 112 When sure that staged changes should be commited to the history, use `git
 113 commit -m'COMMIT MSG'`. For commit messages, some rules are good to keep in
 114 mind [1][]:
 115 - Separate subject from body with a blank line.
 116 - Limit the subject line to 50 characters.
 117 - Capitalize the subject line.
 118 - Do not end the subject line with a period.
 119 - Use the imperative mood in the subject line.
 120 - Wrap the body at 72 characters.
 121 - Use the body to explain what and why vs. how.
 122
 123 # Cheat sheet
 124 Use `git COMMAND --help` for showing the help!
 125
 126 ## Init
 127 - `git clone URL`
 128 - `git init`
 129 - `git config user.name "Your Name"`
 130 - `git config user.email you@example.com`
 131 - `git config --global user.name "Your Name"`
 132 - `git config --global user.email you@example.com`
 133
 134 ## Explore
 135 - `git log`
 136 - `git log --graph`
 137 - `git log --oneline`
 138 - `git log --decorate`
 139 - `git show COMMIT`
 140
 141 ## Changes
 142 - `git status`
 143 - `git diff`
 144 - `git diff --cached`
 145
 146 ## Commit
 147 - `git add FILE`
 148 - `git add -p FILE`
 149 - `git reset FILE`
 150 - `git reset -p FILE`
 151 - `git commit -m'COMMIT MSG'`
 152 - `git commit`
 153
 154 [1]: https://chris.beams.io/posts/git-commit/