added comment & TODO to recode SymlinkName one day

shared.py

@@ -53,6 +53,14 @@ def LocationIcon(obj):
 
     
 
+# translate a path type, a full FS path and a file into the full FS path of the
+# symlink on the file system.  To note, this is used with file == path, when we
+# want to just get the symlink to the path itself, otherwise file == <path/some_filename>
+### FIXME: I think this is way over-complicated, want to revist one day, with
+#what params are passed in, what we need to get out -- I think the overloaded
+#file/oath use case, and why sometimes we trail with a / or not and then concat
+#last_dir and bit before last_dir, etc. this feels a bit too complicated for
+#what it does OR we comment this much better
 def SymlinkName(ptype, path, file):
     sig_bit=file.replace(path, "")
     last_dir=os.path.basename(path[0:-1])