[Quilt-dev] README quick-references

[Randy.Dunlap]

Any interest in this?


I'm a wimp and sometimes I need a crutch.

Add a README quick-reference section for Typical Usages.

---

 doc/README.in |   78 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 78 insertions(+)

diff -Naurp quilt-0.42/doc/README.in~quick_ref quilt-0.42/doc/README.in
--- quilt-0.42/doc/README.in~quick_ref  2005-07-02 14:14:50.000000000 -0700
+++ quilt-0.42/doc/README.in    2005-11-07 19:58:00.000000000 -0800
@@ -33,3 +33,81 @@ backup-files
        A simple utility that creates / restores / removes
        backup files.
 
+
+Typical Usages:  New patches; Importing patches; Patch management
+======================================================================
+
+Add new patches:
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+1.  create a new patch:                quilt new {patchname, e.g., 
sysctl_fix.patch}
+
+2.  add/edit file(s):          quilt edit filepath
+or:
+2a. add file(s) to patch:      quilt add {filepath}
+2b. manual edit file(s)                use your $editor
+
+3.  update the patch diff:             quilt refresh
+3b. list the patch description:                quilt header [patch]
+3c. update the patch description:      quilt header -e [patch]
+
+4.  list files in the patch:   quilt files
+
+5.  show the patch:            quilt diff
+
+6.  apply current, ready for next:     quilt push
+
+7.  remove file(s) from patch: quilt remove {filepath}
+
+Importing patches:
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+1.  import a patch:            quilt import patchfile
+
+2.  apply it:                  quilt push
+
+3.  update the patch diff:             quilt refresh
+3b. list the patch description:                quilt header [patch]
+3c. update the patch description:      quilt header -e [patch]
+
+4.  list files in the patch:   quilt files
+
+5.  show the patch:            quilt diff
+
+Import/Apply a series file + patches to a tree:
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+1.  cp(1) the patches directory ('series' file + all patch files) to
+    the expected patches location (as specified in your .quiltrc file)
+
+2.  apply all of series:       quilt push -a
+
+Other patch management:
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+1.  list files in a patch:     quilt files {patchname}
+
+2.  remove files from a patch: quilt remove {filepath}
+
+3.  remove unapplied patch:    quilt delete {patchname}
+
+4.  list all patch names:      quilt series
+
+5.  list all applied/unapplied:        quilt applied | unapplied
+
+6.  list top/previous/next patch name: quilt top | previous | next
+
+7.  list patches modifying file:       quilt patches {filepath}
+
+8.  rename a patch:            quilt rename {patchname}
+
+9.  duplicate a patch:         quilt fork {patchname}
+
+10. prepare or send mails:     quilt mail ...
+
+11. search in source files:    quilt grep ...
+
+12. create snapshot:           quilt snapshot
+
+13. init from RPM spec or series file: quilt setup
+
+14. combine patches for distribution:  quilt diff --combine
+       and distribute the patches/ directory content
+
+###


---