aboutsummaryrefslogtreecommitdiff
path: root/docs/misc/patch.md
diff options
context:
space:
mode:
authorAlyssa Rosenzweig <alyssa@rosenzweig.io>2017-03-20 20:26:48 -0700
committerAlyssa Rosenzweig <alyssa@rosenzweig.io>2017-03-20 20:26:48 -0700
commita62fe03d3e84150e6186f57f53029d5a9abe3d7b (patch)
tree1a1276b32fcc5388165bd42b685c0d9e83380a7b /docs/misc/patch.md
parent07da8fb0c7d513bc73470b69be99f1add0cb95e5 (diff)
downloadlibrebootfr-a62fe03d3e84150e6186f57f53029d5a9abe3d7b.tar.gz
librebootfr-a62fe03d3e84150e6186f57f53029d5a9abe3d7b.zip
undo breakages
Diffstat (limited to 'docs/misc/patch.md')
-rw-r--r--docs/misc/patch.md81
1 files changed, 39 insertions, 42 deletions
diff --git a/docs/misc/patch.md b/docs/misc/patch.md
index 318c7428..9f6125c5 100644
--- a/docs/misc/patch.md
+++ b/docs/misc/patch.md
@@ -1,20 +1,22 @@
-% Diff and patch
+
+Diff and patch
+==============
This is just a quick guide for reference, use 'man' to know more.
[Back to index](./)
+
+
Apply a patch
=============
-To apply a patch to a single file, do that in it's directory:
-
- $ patch < foo.patch
+To apply a patch to a single file, do that in it's directory:\
+**\$ patch < foo.patch**
Assuming that the patch is distributed in unified format identifying the
-file the patch should be applied to, the above will work. Otherwise:
-
- $ patch foo.txt < bar.patch
+file the patch should be applied to, the above will work. Otherwise:\
+**\$ patch foo.txt < bar.patch**
You can apply a patch to an entire directory, but note the "p level".
What this means is that inside patch files will be the files that you
@@ -22,46 +24,43 @@ intend to patch, identified by path names that might be different when
the files ane located on your own computer instead of on the computer
where the patch was created. 'p' level instructs the 'patch' utility
to ignore parts of the path name to identify the files correctly.
-Usually a p level of 1 will work, so you would use:
-
- $ patch -p1 < baz.patch
+Usually a p level of 1 will work, so you would use:\
+**\$ patch -p1 < baz.patch**
Change to the top level directory before running this. If a patch level
of 1 cannot identify the files to patch, then inspect the patch file for
-file names. For example:
-
+file names. For example:\
**/home/user/do/not/panic/yet.c**
-and you are working in a directory that contains panic/yet.c, use:
-
- $ patch -p5 < baz.patch
+and you are working in a directory that contains panic/yet.c, use:\
+**\$ patch -p5 < baz.patch**
You usually count one up for each path separator (forward slash) removed
from the beginning of the path, until you are left with a path that
exists in the current working directory. The count is the p level.
-Removing a patch using the -R flag
-
- $ patch -p5 -R < baz.patch
+Removing a patch using the -R flag\
+**\$ patch -p5 -R < baz.patch**
[Back to top of page.](#pagetop)
+
+
Create a patch with diff
========================
-Diff can create a patch for a single file:
+Diff can create a patch for a single file:\
+**\$ diff -u original.c new.c > original.patch**
- $ diff -u original.c new.c > original.patch
+For diff'ing a source tree:\
+**\$ cp -R original new**
-For diff'ing a source tree:
+Do whatever you want in new/ and then diff it:\
+**\$ diff -rupN original/ new/ > original.patch**
- $ cp -R original new
-
-Do whatever you want in new/ and then diff it:
+[Back to top of page.](#pagetop)
- $ diff -rupN original/ new/ > original.patch
-[Back to top of page.](#pagetop)
git diff
========
@@ -70,34 +69,31 @@ git is something special.
Note: this won't show new files created.
-Just make whatever changes you want to a git clone and then:
-
- $ git diff > patch.git
-
-Note the git revision that you did this with:
-
- $ git log
+Just make whatever changes you want to a git clone and then:\
+**\$ git diff > patch.git**
-Alternatively (better yet), commit your changes and then use:
+Note the git revision that you did this with:\
+**\$ git log**
- $ git format-patch -N
+Alternatively (better yet), commit your changes and then use:\
+\$ **git format-patch -N**\
Replace N with the number of commits that you want to show.
[Back to top of page.](#pagetop)
+
+
git apply
=========
it really is.
Now to apply that patch in the future, just git clone it again and do
-with the git revision you found from above:
-
- $ git reset \--hard REVISIONNUMBER
+with the git revision you found from above:\
+**\$ git reset \--hard REVISIONNUMBER**
-Now put patch.git in the git clone directory and do:
-
- $ git apply patch.git
+Now put patch.git in the git clone directory and do:\
+**\$ git apply patch.git**
If you use a patch from git format-patch, then use **git am patch.git**
instead of **git apply patch.git**. git-am will re-create the commits
@@ -105,8 +101,9 @@ aswell, instead of just applying the patch.
[Back to top of page.](#pagetop)
-Copyright © 2014, 2015 Leah Rowe <info@minifree.org>
+
+Copyright © 2014, 2015 Leah Rowe <info@minifree.org>\
Permission is granted to copy, distribute and/or modify this document
under the terms of the Creative Commons Attribution-ShareAlike 4.0
International license or any later version published by Creative