~jan0sch/darcs-book

Showing details for patch 037e7d107050d5141604a97cc911a6a42c484d56.
2018-06-28 (Thu), 7:28 AM - - 037e7d107050d5141604a97cc911a6a42c484d56

use "working tree" terminology

Summary of changes
3 files modified with 30 lines added and 29 lines removed
  • en/02-getting-started.md with 6 added and 5 removed lines
  • en/03-working-locally.md with 16 added and 16 removed lines
  • en/04-happy-little-accidents.md with 8 added and 8 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 04:30:23.585902679 +0000
+++ new-darcs-book/en/02-getting-started.md	2024-11-24 04:30:23.589902686 +0000
@@ -13,16 +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 Directory
+* Working Tree
 
-  This is where our project files reside, all work is done here.
+  This is the directory tree 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 directory changes through time we can record patches
-  that represent those changes and store them in our repository together with
+  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.
 
 * 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 04:30:23.585902679 +0000
+++ new-darcs-book/en/03-working-locally.md	2024-11-24 04:30:23.589902686 +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 directory**.
+doing this we have changed our **working tree**.
 
-To find out what changes we have done to the working directory we can issue
-`darcs status`.
+To find out what changes we have done to the working tree we can issue `darcs
+status`.
 
 ```
 $ darcs status
 a ./Main.hs
 ```
 
-What `darcs` does here is that it compares the state of your working directory
+What `darcs` does here is that it compares the state of your working tree
 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 directory surely should constitute a change
-shouldn't it?
+adding something to our working tree 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 directory against the state of our
+`darcs` will compare our current working tree 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 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.
+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.
 
 ```
 $ 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 04:30:23.585902679 +0000
+++ new-darcs-book/en/04-happy-little-accidents.md	2024-11-24 04:30:23.589902686 +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 directory 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 tree 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 directory as if you didn't make any changes
-since the last record.
+to restore the state of the working tree 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 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.
+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.
 
 Unrevert
 --------