~jan0sch/darcs-book

Showing details for patch 06418aaee5a8495d74633c2a2e958e39dcce0e96.
2018-06-28 (Thu), 1:59 PM - - 06418aaee5a8495d74633c2a2e958e39dcce0e96

roll back "working tree" terminology

Summary of changes
3 files modified with 37 lines added and 38 lines removed
  • en/02-getting-started.md with 7 added and 8 removed lines
  • en/03-working-locally.md with 16 added and 16 removed lines
  • en/04-happy-little-accidents.md with 14 added and 14 removed lines
diff -rN -u old-darcs-book/en/02-getting-started.md new-darcs-book/en/02-getting-started.md
--- old-darcs-book/en/02-getting-started.md	2024-11-24 05:06:44.706075757 +0000
+++ new-darcs-book/en/02-getting-started.md	2024-11-24 05:06:44.706075757 +0000
@@ -13,18 +13,17 @@
 Don't worry, it won't be much and I'll be introducing new terms as we are going
 along. But here are the basic terms you need to know.
 
-* Working Tree
+* Working Directory
 
-  This is the directory tree where our project files reside, all work is done
-  here.
+  This is the directory where our project files reside, all work is done here.
 
 * Repository
 
   We already talked a bit about this but let's keep our most basic terms in one
-  place. A repository is a place where we store information about our project
-  history. As our working tree changes through time we can record patches that
-  represent those changes and store them in our repository together with
-  additional information like, what changed, who did the changes and when.
+  place. A repository is a place where `darcs` stores information about a
+  project's history. As our working directory changes through time we can record
+  patches that represent those changes and store them in our repository together
+  with additional information like, what changed, who did the changes and when.
 
 * Change
 
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 05:06:44.706075757 +0000
+++ new-darcs-book/en/03-working-locally.md	2024-11-24 05:06:44.706075757 +0000
@@ -53,28 +53,28 @@
 
 This creates a new file `Main.hs` with the content `main = putStrLn "Hello
 World"`, of course you can also use your favorite text editor to do this. By
-doing this we have changed our **working tree**.
+doing this we have changed our **working directory**.
 
-To find out what changes we have done to the working tree we can issue `darcs
-status`.
+To find out what changes we have done to the working directory we can issue
+`darcs status`.
 
 ```
 $ darcs status
 a ./Main.hs
 ```
 
-What `darcs` does here is that it compares the state of your working tree
+What `darcs` does here is that it compares the state of your working directory
 against the state of the repository (recall that the state of the repository is
 a set of changes). In our current repository there are no recorded changes so
-adding something to our working tree surely should constitute a change shouldn't
-it?
+adding something to our working directory surely should constitute a change
+shouldn't it?
 
 Let's take a closer look at the output of `darcs status`. What does the lower
 case `a` in front of `./Main.hs` mean? Well, it means that the file `Main.hs` is
 currently **unadded**. Let's try to `record` a patch and see what happens.
 
 When we want to `record` a new patch we can simply issue `darcs record` and
-`darcs` will compare our current working tree against the state of our
+`darcs` will compare our current working directory against the state of our
 repository and consider all changes for the patch we are about to `record`.
 
 ```
@@ -268,14 +268,14 @@
 Booooooooooring!!!
 ------------------
 
-Remember that **unadded** files are displayed with a lower case `a` in the
-`darcs status` output? This can be a bit annoying because there might be some
-files in our working tree that we would never consider for a patch. For files
-like this we have a list of files that we consider **boring**.
-
-Here's an example. We now have our `Hello.hs` file in our working tree and we
-want to compile that program. When we take a look at the our `status` we get a
-surprise.
+Remember that **unadded** files are displayed with a lower case `a` in the `darcs
+status` output? This can be a bit annoying because there might be some files in
+our working directory that we would never consider for a patch. For files like
+this we have a list of files that we consider **boring**.
+
+Here's an example. We now have our `Hello.hs` file in our working directory and
+we want to compile that program. When we take a look at the our `status` we get
+a surprise.
 
 ```
 $ darcs status
diff -rN -u old-darcs-book/en/04-happy-little-accidents.md new-darcs-book/en/04-happy-little-accidents.md
--- old-darcs-book/en/04-happy-little-accidents.md	2024-11-24 05:06:44.706075757 +0000
+++ new-darcs-book/en/04-happy-little-accidents.md	2024-11-24 05:06:44.706075757 +0000
@@ -22,8 +22,8 @@
 -----------------
 
 The most obvious thing that might go wrong in your development process is that
-you have a lot of changes in your working tree and you have decided that they
-don't make the cut. You want to get rid of them.
+you have a lot of changes in your working directory and you have decided that
+they don't make the cut. You want to get rid of them.
 
 Here's an example. Imagine you are writing a novel and some time light at night
 in some sleep depraved state you decide to rename the novel's protagonist from
@@ -38,8 +38,8 @@
 might have come across them, I certainly did, and they are no fun.
 
 In a situation like this `darcs revert` is exactly what you want. It allows you
-to restore the state of the working tree as if you didn't make any changes since
-the last record.
+to restore the state of the working directory as if you didn't make any changes
+since the last record.
 
 ```
 $ cat story.txt
@@ -94,10 +94,10 @@
 <Space>: accept the current default (which is capitalized)
 ```
 
-If you just want to get rid of everything in your working tree without being
-prompted interactively you can just issue `darcs revert --all` or the short hand
-`darcs revert -a` and `darcs` will `revert` all the unrecorded changes in your
-working tree.
+If you just want to get rid of everything in your working directory without
+being prompted interactively you can just issue `darcs revert --all` or the
+short hand `darcs revert -a` and `darcs` will `revert` all the unrecorded
+changes in your working directory.
 
 Unrevert
 --------
@@ -145,10 +145,10 @@
 
 So, a couple of weeks later we figure that maybe this is just way too much joy
 and we decide to roll back the change. We do that by using `darcs rollback`
-which takes some changes and applies their inverse to the working tree. Just
-like `log` `rollback` can take a `-p` flag to specify a pattern for selecting
-matching patches. I know that the package name contains the word "joy" so I'm
-using that.
+which takes some changes and applies their inverse to the working directory.
+Just like `log` `rollback` can take a `-p` flag to specify a pattern for
+selecting matching patches. I know that the package name contains the word "joy"
+so I'm using that.
 
 ```
 $ darcs rollback -p joy
@@ -169,5 +169,5 @@
 ```
 
 `rollback` does not create any new patches, it just applies the inverses of the
-changes you have selected to your working tree, it's up to you to record a new
-patch from them.
+changes you have selected to your working directory, it's up to you to record a
+new patch from them.