# HG changeset patch
# User Sean Farley <sean.michael.farley@gmail.com>
# Date 2013-11-06 16:26:25
# Node ID 20ef533ffb01cf419ca2cdb7129b813468a15ac0
# Parent  c05b968d05eb93762c81d628ea804478565a3015

merge: update comment for future devs

diff --git a/mercurial/merge.py b/mercurial/merge.py
--- a/mercurial/merge.py
+++ b/mercurial/merge.py
@@ -680,7 +680,9 @@ def update(repo, node, branchmerge, forc
     try:
         wc = repo[None]
         if node is None:
-            # tip of current branch
+            # Here is where we should consider bookmarks, divergent bookmarks,
+            # foreground changesets (successors), and tip of current branch;
+            # but currently we are only checking the branch tips.
             try:
                 node = repo.branchtip(wc.branch())
             except error.RepoLookupError: