Base: Update diff(1) man page to latest set of options

Describe how to use the two new context and unified format options in
the diff utility. Also change the example comparison of two files so
they contain more lines as that is much more interesting (and useful).
This commit is contained in:
Shannon Booth 2023-07-05 18:56:39 +12:00 committed by Sam Atkins
parent c57658fffa
commit dfcd5ffaba
Notes: sideshowbarker 2024-07-17 05:41:34 +09:00

View file

@ -5,7 +5,7 @@ diff - compare files line by line
## Synopsis ## Synopsis
```**sh ```**sh
$ diff [files...] $ diff [options...] [files...]
``` ```
## Description ## Description
@ -16,16 +16,39 @@ Compare `files` line by line.
* `files`: files to compare ex: `file1 file2` * `files`: files to compare ex: `file1 file2`
## Options
* `-u`, `-U <context>`, `--unified <context>`: Write diff in unified format with `<unified>` number of surrounding context lines (default 3).
* `-c`, `-C <context>`, `--context <context>`: Write diff in context format with `<context>` number of surrounding context lines (default 3).
## Examples ## Examples
First we create two files to compare:
```sh ```sh
# View differences in two files $ printf '1\n2\n3\n' > file1
$ echo 123 > file1 $ printf '1\nb\n3\n' > file2
$ echo 456 > file2
$ diff file1 file2
1c1
< 123
---
> 456
``` ```
Here's how to view differences between the two files in normal format:
```sh
$ diff file1 file2
2c2
< 2
---
> b
```
Here's how to view differences between the two files in unified format:
```sh
$ diff -u file1 file2
--- file1
+++ file2
@@ -1,3 +1,3 @@
1
-2
+b
3
```