diff --git a/mercurial/commands.py b/mercurial/commands.py
--- a/mercurial/commands.py
+++ b/mercurial/commands.py
@@ -42,6 +42,8 @@ def add(ui, repo, *pats, **opts):
          adding foo.c
          $ hg status
          A foo.c
+
+    Returns 0 if all files are successfully added.
     """
 
     bad = []
@@ -2732,6 +2734,8 @@ def paths(ui, repo, search=None):
     :hg:`bundle`) operations.
 
     See :hg:`help urls` for more information.
+
+    Returns 0 on success.
     """
     if search:
         for name, path in ui.configitems("paths"):
diff --git a/tests/test-help.out b/tests/test-help.out
--- a/tests/test-help.out
+++ b/tests/test-help.out
@@ -252,6 +252,8 @@ add the specified files on the next comm
 
     If no names are given, add all files to the repository.
 
+    Returns 0 if all files are successfully added.
+
 use "hg -v help add" to show verbose help
 
 options:
@@ -287,6 +289,8 @@ add the specified files on the next comm
       $ hg status
       A foo.c
 
+    Returns 0 if all files are successfully added.
+
 options:
 
  -I --include PATTERN [+]  include names matching the given patterns
@@ -332,6 +336,8 @@ add the specified files on the next comm
 
     If no names are given, add all files to the repository.
 
+    Returns 0 if all files are successfully added.
+
 use "hg -v help add" to show verbose help
 
 options:
@@ -355,6 +361,8 @@ add the specified files on the next comm
 
     If no names are given, add all files to the repository.
 
+    Returns 0 if all files are successfully added.
+
 use "hg -v help add" to show verbose help
 
 options: