# HG changeset patch
# User Mathias De Maré
# Date 2015-11-25 17:10:31
# Node ID fab21bac10242ecf873972278384b4f17b8a1479
# Parent 060f83d219b9b7e345b836df06310fe3720113a0
commands: add example for 'hg add'
diff --git a/mercurial/commands.py b/mercurial/commands.py
--- a/mercurial/commands.py
+++ b/mercurial/commands.py
@@ -190,17 +190,31 @@ def add(ui, repo, *pats, **opts):
.. container:: verbose
- An example showing how new (unknown) files are added
- automatically by :hg:`add`::
-
- $ ls
- foo.c
- $ hg status
- ? foo.c
- $ hg add
- adding foo.c
- $ hg status
- A foo.c
+ Examples:
+
+ - New (unknown) files are added
+ automatically by :hg:`add`::
+
+ $ ls
+ foo.c
+ $ hg status
+ ? foo.c
+ $ hg add
+ adding foo.c
+ $ hg status
+ A foo.c
+
+ - Specific files to be added can be specified::
+
+ $ ls
+ bar.c foo.c
+ $ hg status
+ ? bar.c
+ ? foo.c
+ $ hg add bar.c
+ $ hg status
+ A bar.c
+ ? foo.c
Returns 0 if all files are successfully added.
"""
diff --git a/tests/test-help.t b/tests/test-help.t
--- a/tests/test-help.t
+++ b/tests/test-help.t
@@ -372,17 +372,30 @@ Verbose help for add
If no names are given, add all files to the repository.
- An example showing how new (unknown) files are added automatically by "hg
- add":
+ Examples:
+
+ - New (unknown) files are added automatically by "hg add":
- $ ls
- foo.c
- $ hg status
- ? foo.c
- $ hg add
- adding foo.c
- $ hg status
- A foo.c
+ $ ls
+ foo.c
+ $ hg status
+ ? foo.c
+ $ hg add
+ adding foo.c
+ $ hg status
+ A foo.c
+
+ - Specific files to be added can be specified:
+
+ $ ls
+ bar.c foo.c
+ $ hg status
+ ? bar.c
+ ? foo.c
+ $ hg add bar.c
+ $ hg status
+ A bar.c
+ ? foo.c
Returns 0 if all files are successfully added.
@@ -1995,9 +2008,10 @@ Dish up an empty repo; serve it cold.
If no names are given, add all files to the repository.
- An example showing how new (unknown) files are added
- automatically by "hg add":
+ Examples:
+
+ - New (unknown) files are added automatically by "hg add":
\$ ls (re)
foo.c
@@ -2008,6 +2022,19 @@ Dish up an empty repo; serve it cold.
\$ hg status (re)
A foo.c
+ - Specific files to be added can be specified:
+
+ \$ ls (re)
+ bar.c foo.c
+ \$ hg status (re)
+ ? bar.c
+ ? foo.c
+ \$ hg add bar.c (re)
+ \$ hg status (re)
+ A bar.c
+ ? foo.c
+
+
Returns 0 if all files are successfully added.