[Quilt-dev] {PATCH] Document the patch grouping feature

[Jean Delvare]

Document the patch grouping feature.

This fixes bug #12428.
---
Comments anyone? If there are other places where this could/should
be documented, please let me know.

 doc/main.tex |    4 ++--
 quilt/new.in |    3 ++-
 2 files changed, 4 insertions(+), 3 deletions(-)

--- a/doc/main.tex
+++ b/doc/main.tex
@@ -202,8 +202,8 @@ Patch files are located in the \textsf{p
 source tree (see Figure~\ref{fig:dir-layout}). The \textsf{QUILT\_PATCHES}
 environment variable can be used to override this location and quilt
 will remember this location by storing its value in the
-\textsf{.pc/.quilt\_patches} file. The
-\textsf{patches} directory may contain sub-directories.
+\textsf{.pc/.quilt\_patches} file. The \textsf{patches} directory may contain
+sub-directories, which is useful for grouping related patches together.
 \textsf{patches} may also be a symbolic link instead of a directory.
 
 A file called \textsf{series} contains a list of patch file names that
--- a/quilt/new.in
+++ b/quilt/new.in
@@ -24,7 +24,8 @@ usage()
        then
                printf $"
 Create a new patch with the specified file name, and insert it after the
-topmost patch.
+topmost patch. The name can be prefixed with a sub-directory name, allowing
+for grouping related patches together.
 
 -p n   Create a -p n style patch (-p0 or -p1 are supported).
 

-- 
Jean Delvare
Suse L3