# HG changeset patch
# User Christian Ebert <blacktrash@gmx.net>
# Date 1246100725 -7200
# Node ID 23da65f04361b66a43ae59c8411c7c0cc0649364
# Parent  3b4d5045a920e2bf3820c65516e03bc2981d9ce2
keyword: improve help for kwfiles

diff -r 3b4d5045a920 -r 23da65f04361 hgkw/keyword.py
--- a/hgkw/keyword.py	Thu Jun 25 12:00:30 2009 +0200
+++ b/hgkw/keyword.py	Sat Jun 27 13:05:25 2009 +0200
@@ -359,11 +359,16 @@
     _kwfwrite(ui, repo, True, *pats, **opts)
 
 def files(ui, repo, *pats, **opts):
-    '''print files currently configured for keyword expansion
+    '''print filenames configured for keyword expansion
+
+    Check which filenames in the working directory are matched by the
+    [keyword] configuration patterns.
 
-    Crosscheck which files in working directory are potential targets
-    for keyword expansion. That is, files matched by [keyword] config
-    patterns but not symlinks.
+    Useful to prevent inadvertent keyword expansion and to speed up
+    execution by including only filenames that are actual candidates
+    for expansion.
+
+    Use -u/--untracked to display untracked filenames as well.
     '''
     kwt = kwtools['templater']
     status = _status(ui, repo, kwt, opts.get('untracked'), *pats, **opts)
diff -r 3b4d5045a920 -r 23da65f04361 tests/test-keyword.out
--- a/tests/test-keyword.out	Thu Jun 25 12:00:30 2009 +0200
+++ b/tests/test-keyword.out	Sat Jun 27 13:05:25 2009 +0200
@@ -50,7 +50,7 @@
 
  kwdemo     print [keywordmaps] configuration and an expansion example
  kwexpand   expand keywords in the working directory
- kwfiles    print files currently configured for keyword expansion
+ kwfiles    print filenames configured for keyword expansion
  kwshrink   revert expanded keywords in the working directory
 
 enabled extensions: