~jan0sch/darcs-book

Showing details for patch d18be73730e7ac7f34bcc8c87b0dfe1e3a9618ed.
2018-07-01 (Sun), 12:26 PM - - d18be73730e7ac7f34bcc8c87b0dfe1e3a9618ed

add more information about `record` to chapter 3

Summary of changes
1 files modified with 13 lines added and 0 lines removed
  • en/03-working-locally.md with 13 added and 0 removed lines
diff -rN -u old-darcs-book/en/03-working-locally.md new-darcs-book/en/03-working-locally.md
--- old-darcs-book/en/03-working-locally.md	2024-11-24 01:25:39.011366901 +0000
+++ new-darcs-book/en/03-working-locally.md	2024-11-24 01:25:39.011366901 +0000
@@ -163,6 +163,19 @@
     hunk ./Main.hs 1
     +main = putStrLn "Hello World!"
 ```
+
+`record` is  undoubtedly one of the central commands in `darcs` and therefore
+offers a lot of options to make working with it a lot more pleasant. You have
+seen that `darcs` asks you for every change if you want to record it or not.
+That might become super tedious, especially when you already know that you want
+to record all of them. In that case you can always issue `darcs record -a`. The
+`-a` is a short hand for `--all` and it simply tells `darcs` to record all of
+the unrecorded changes. If you just want to `record` the changes of one or more
+specific files you can pass them as arguments to `record` and `darcs` will only
+ask you about recording changes in these files. So if I only wanted to record
+changes for this chapter of the book I would say `darcs record
+en/02-getting-started.md`.
+
 Removing a file
 ---------------