git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH 66/66] Use imperative form in help usage to describe an action

From
Nguyễn Thái Ngọc Duy <pclouds@gmail.com>
Date
Aug 20, 2012, 12:32 UTC
Message-ID
<1345465975-16927-67-git-send-email-pclouds@gmail.com>
In-Reply-To
<1345465975-16927-1-git-send-email-pclouds@gmail.com>
Signed-off-by: Nguyễn Thái Ngọc Duy <pclouds@gmail.com>
---
 My guts tell me this is correct, but my English foundation is shaking
 so I say "change in the name of consistency"!
 builtin/apply.c          | 2 +-
 builtin/checkout-index.c | 4 ++--
 builtin/config.c         | 8 ++++----
 builtin/grep.c           | 2 +-
 builtin/push.c           | 2 +-
 builtin/update-ref.c     | 2 +-
 6 files changed, 10 insertions(+), 10 deletions(-)
diff --git a/builtin/apply.c b/builtin/apply.c
index d453c83..0ab81e3 100644
--- a/builtin/apply.c
+++ b/builtin/apply.c
@@ -4297,7 +4297,7 @@ int cmd_apply(int argc, const char **argv, const char *prefix_)
 		OPT_NOOP_NOARG(0, "allow-binary-replacement"),
 		OPT_NOOP_NOARG(0, "binary"),
 		OPT_BOOLEAN(0, "numstat", &numstat,
-			N_("shows number of added and deleted lines in decimal notation")),
+			N_("show number of added and deleted lines in decimal notation")),
 		OPT_BOOLEAN(0, "summary", &summary,
 			N_("instead of applying the patch, output a summary for the input")),
 		OPT_BOOLEAN(0, "check", &check,
diff --git a/builtin/checkout-index.c b/builtin/checkout-index.c
index 86b7d36..b1feda7 100644
--- a/builtin/checkout-index.c
+++ b/builtin/checkout-index.c
@@ -184,8 +184,8 @@ int cmd_checkout_index(int argc, const char **argv, const char *prefix)
 	int force = 0, quiet = 0, not_new = 0;
 	struct option builtin_checkout_index_options[] = {
 		OPT_BOOLEAN('a', "all", &all,
-			N_("checks out all files in the index")),
-		OPT__FORCE(&force, N_("forces overwrite of existing files")),
+			N_("check out all files in the index")),
+		OPT__FORCE(&force, N_("force overwrite of existing files")),
 		OPT__QUIET(&quiet,
 			N_("no warning for existing files and files not in index")),
 		OPT_BOOLEAN('n', "no-create", &not_new,
diff --git a/builtin/config.c b/builtin/config.c
index 41032cc..31e1354 100644
--- a/builtin/config.c
+++ b/builtin/config.c
@@ -59,13 +59,13 @@ static struct option builtin_config_options[] = {
 	OPT_BIT(0, "get-all", &actions, N_("get all values: key [value-regex]"), ACTION_GET_ALL),
 	OPT_BIT(0, "get-regexp", &actions, N_("get values for regexp: name-regex [value-regex]"), ACTION_GET_REGEXP),
 	OPT_BIT(0, "replace-all", &actions, N_("replace all matching variables: name value [value_regex]"), ACTION_REPLACE_ALL),
-	OPT_BIT(0, "add", &actions, N_("adds a new variable: name value"), ACTION_ADD),
-	OPT_BIT(0, "unset", &actions, N_("removes a variable: name [value-regex]"), ACTION_UNSET),
-	OPT_BIT(0, "unset-all", &actions, N_("removes all matches: name [value-regex]"), ACTION_UNSET_ALL),
+	OPT_BIT(0, "add", &actions, N_("add a new variable: name value"), ACTION_ADD),
+	OPT_BIT(0, "unset", &actions, N_("remove a variable: name [value-regex]"), ACTION_UNSET),
+	OPT_BIT(0, "unset-all", &actions, N_("remove all matches: name [value-regex]"), ACTION_UNSET_ALL),
 	OPT_BIT(0, "rename-section", &actions, N_("rename section: old-name new-name"), ACTION_RENAME_SECTION),
 	OPT_BIT(0, "remove-section", &actions, N_("remove a section: name"), ACTION_REMOVE_SECTION),
 	OPT_BIT('l', "list", &actions, N_("list all"), ACTION_LIST),
-	OPT_BIT('e', "edit", &actions, N_("opens an editor"), ACTION_EDIT),
+	OPT_BIT('e', "edit", &actions, N_("open an editor"), ACTION_EDIT),
 	OPT_STRING(0, "get-color", &get_color_slot, N_("slot"), N_("find the color configured: [default]")),
 	OPT_STRING(0, "get-colorbool", &get_colorbool_slot, N_("slot"), N_("find the color setting: [stdout-is-tty]")),
 	OPT_GROUP(N_("Type")),
diff --git a/builtin/grep.c b/builtin/grep.c
index d73841c..c9a65b3 100644
--- a/builtin/grep.c
+++ b/builtin/grep.c
@@ -682,7 +682,7 @@ int cmd_grep(int argc, const char **argv, const char *prefix)
 		OPT_BOOLEAN(0, "cached", &cached,
 			N_("search in index instead of in the work tree")),
 		OPT_NEGBIT(0, "no-index", &use_index,
-			 N_("finds in contents not managed by git"), 1),
+			 N_("find in contents not managed by git"), 1),
 		OPT_BOOLEAN(0, "untracked", &untracked,
 			N_("search in both tracked and untracked files")),
 		OPT_SET_INT(0, "exclude-standard", &opt_exclude,
diff --git a/builtin/push.c b/builtin/push.c
index 4840bc2..8686a7a 100644
--- a/builtin/push.c
+++ b/builtin/push.c
@@ -364,7 +364,7 @@ int cmd_push(int argc, const char **argv, const char *prefix)
 		OPT_BIT( 0,  "porcelain", &flags, N_("machine-readable output"), TRANSPORT_PUSH_PORCELAIN),
 		OPT_BIT('f', "force", &flags, N_("force updates"), TRANSPORT_PUSH_FORCE),
 		{ OPTION_CALLBACK, 0, "recurse-submodules", &flags, N_("check"),
-			N_("controls recursive pushing of submodules"),
+			N_("control recursive pushing of submodules"),
 			PARSE_OPT_OPTARG, option_parse_recurse_submodules },
 		OPT_BOOLEAN( 0 , "thin", &thin, N_("use thin pack")),
 		OPT_STRING( 0 , "receive-pack", &receivepack, "receive-pack", N_("receive pack program")),
diff --git a/builtin/update-ref.c b/builtin/update-ref.c
index b30394f..51d2684 100644
--- a/builtin/update-ref.c
+++ b/builtin/update-ref.c
@@ -16,7 +16,7 @@ int cmd_update_ref(int argc, const char **argv, const char *prefix)
 	int delete = 0, no_deref = 0, flags = 0;
 	struct option options[] = {
 		OPT_STRING( 'm', NULL, &msg, N_("reason"), N_("reason of the update")),
-		OPT_BOOLEAN('d', NULL, &delete, N_("deletes the reference")),
+		OPT_BOOLEAN('d', NULL, &delete, N_("delete the reference")),
 		OPT_BOOLEAN( 0 , "no-deref", &no_deref,
 					N_("update <refname> not the one it points to")),
 		OPT_END(),
-- 
1.7.12.rc2.18.g61b472e
Previous: Nguyễn Thái Ngọc DuyNext: Drew Northup
Message 67 of 69 in “parseopt i18n marking (again)”
  1. 00/66 parseopt i18n marking (again)Nguyễn Thái Ngọc Duy, Aug 20, 2012
  2. 01/66 i18n: mark "style" in OPT_COLUMN() for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  3. 02/66 i18n: archive: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  4. 03/66 i18n: add: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  5. 04/66 i18n: bisect--helper: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  6. 05/66 i18n: blame: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  7. 06/66 i18n: branch: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  8. 07/66 i18n: cat-file: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  9. 08/66 i18n: check-attr: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  10. 09/66 i18n: checkout-index: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  11. 10/66 i18n: checkout: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  12. 11/66 i18n: cherry: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  13. 12/66 i18n: clean: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  14. 13/66 i18n: clone: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  15. 14/66 i18n: column: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  16. 15/66 i18n: commit: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  17. 16/66 i18n: config: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  18. 17/66 i18n: count-objects: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  19. 18/66 i18n: describe: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  20. 19/66 i18n: fast-export: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  21. 20/66 i18n: fetch: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  22. 21/66 i18n: fmt-merge-msg: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  23. 22/66 i18n: for-each-ref: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  24. 23/66 i18n: format-patch: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  25. 24/66 i18n: fsck: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  26. 25/66 i18n: gc: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  27. 26/66 i18n: grep: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  28. 27/66 i18n: hash-object: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  29. 28/66 i18n: help: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  30. 29/66 i18n: init-db: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  31. 30/66 i18n: log: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  32. 31/66 i18n: ls-files: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  33. 32/66 i18n: ls-tree: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  34. 33/66 i18n: merge-base: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  35. 34/66 i18n: merge-file: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  36. 35/66 i18n: merge: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  37. 36/66 i18n: mktree: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  38. 37/66 i18n: mv: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  39. 38/66 i18n: name-rev: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  40. 39/66 i18n: notes: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  41. 40/66 i18n: pack-objects: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  42. 41/66 i18n: pack-refs: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  43. 42/66 i18n: prune-packed: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  44. 43/66 i18n: prune: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  45. 44/66 i18n: push: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  46. 45/66 i18n: read-tree: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  47. 46/66 i18n: remote: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  48. 47/66 i18n: replace: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  49. 48/66 i18n: status: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  50. 49/66 i18n: rerere: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  51. 50/66 i18n: reset: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  52. 51/66 i18n: rev-parse: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  53. 52/66 i18n: revert, cherry-pick: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  54. 53/66 i18n: rm: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  55. 54/66 i18n: shortlog: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  56. 55/66 i18n: show-branch: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  57. 56/66 i18n: show-ref: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  58. 57/66 i18n: symbolic-ref: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  59. 58/66 i18n: tag: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  60. 59/66 i18n: update-index: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  61. 60/66 i18n: update-ref: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  62. 61/66 i18n: update-server-info: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  63. 62/66 i18n: verify-pack: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  64. 63/66 i18n: verify-tag: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  65. 64/66 i18n: write-tree: mark parseopt strings for translationNguyễn Thái Ngọc Duy, Aug 20, 2012
  66. 65/66 Reduce translations by using same terminologiesNguyễn Thái Ngọc Duy, Aug 20, 2012
  67. 66/66 Use imperative form in help usage to describe an actionNguyễn Thái Ngọc Duy, Aug 20, 2012
  68. Drew NorthupAug 22, 2012
  69. Junio C HamanoAug 20, 2012

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.