name: accommodate typed components in getSuccessor
refs #4570
Change-Id: I8dae1c983663f1d04fbb2e2b82d9fe1e9b4aabda
diff --git a/src/name.hpp b/src/name.hpp
index ad64424..0936d3f 100644
--- a/src/name.hpp
+++ b/src/name.hpp
@@ -486,10 +486,14 @@
*
* Examples:
*
- * - successor for / is /%00
- * - successor for /%00%01/%01%02 is /%00%01/%01%03
- * - successor for /%00%01/%01%FF is /%00%01/%02%00
- * - successor for /%00%01/%FF%FF is /%00%01/%00%00%00
+ * - successor of `/` is
+ * `/sha256digest=0000000000000000000000000000000000000000000000000000000000000000`.
+ * - successor of `/sha256digest=0000000000000000000000000000000000000000000000000000000000000000`
+ * is `/sha256digest=0000000000000000000000000000000000000000000000000000000000000001`.
+ * - successor of `/sha256digest=ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff`
+ * is `/2=...`.
+ * - successor of `/P/A` is `/P/B`.
+ * - successor of `/Q/%FF` is `/Q/%00%00`.
*
* @return a new Name containing the successor
*/