From 4fbd0a50ca3299fe18f6bbf382ea4bbba29ba4ec Mon Sep 17 00:00:00 2001
From: Alexander <2683344+terminalnode@users.noreply.github.com>
Date: Thu, 9 May 2019 18:16:35 +0200
Subject: [PATCH] diff: clarified and elaborated examples (#3000)

---
 pages/common/diff.md | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/pages/common/diff.md b/pages/common/diff.md
index 12f7d9ac6..6ac5815e8 100644
--- a/pages/common/diff.md
+++ b/pages/common/diff.md
@@ -2,26 +2,26 @@
 
 > Compare files and directories.
 
-- Compare files:
+- Compare files (lists changes to turn `old_file` into `new_file`):
 
-`diff {{file1}} {{file2}}`
+`diff {{old_file}} {{new_file}}`
 
 - Compare files, ignoring white spaces:
 
-`diff -w {{file1}} {{file2}}`
+`diff -w {{old_file}} {{new_file}}`
 
 - Compare files, showing the differences side by side:
 
-`diff -y {{file1}} {{file2}}`
+`diff -y {{old_file}} {{new_file}}`
 
 - Compare files, showing the differences in unified format (as used by `git diff`):
 
-`diff -u {{file1}} {{file2}}`
+`diff -u {{old_file}} {{new_file}}`
 
-- Compare directories recursively:
+- Compare directories recursively (shows names for differing files/directories as well as changes made to files):
 
-`diff -r {{directory1}} {{directory2}}`
+`diff -r {{old_directory}} {{new_directory}}`
 
 - Compare directories, only showing the names of files that differ:
 
-`diff -rq {{directory1}} {{directory2}}`
+`diff -rq {{old_directory}} {{new_directory}}`