[doc] add back removed comments

Author: fangq

jdict.m

@@ -404,6 +404,7 @@
         % overloaded assignment operator: handling assignments at arbitrary depths
         function obj = subsasgn(obj, idxkey, otherobj)
             % overloading the setter function, obj.('key').('subkey')=otherobj
+            % expanded from rahnema1's sample at https://stackoverflow.com/a/79030223/4271392
 
             % handle curly bracket indexing for setting attributes
             oplen = length(idxkey);
@@ -422,6 +423,7 @@
                 if (iscell(idxkey(oplen).subs) && ~isempty(idxkey(oplen).subs))
                     attrn = idxkey(oplen).subs{1};
                     if (ischar(attrn))
+                        % Build the path by navigating through keys
                         temppath = obj.currentpath__;
                         for i = 1:oplen - 1
                             idx = idxkey(i);
@@ -441,6 +443,7 @@
                                 end
                             end
                         end
+                        % set attribute on original object with computed path
                         obj.setattr(temppath, attrn, otherobj);
                         return
                     end
@@ -451,6 +454,7 @@
             if (oplen >= 2 && strcmp(idxkey(oplen).type, '()'))
                 if (strcmp(idxkey(oplen - 1).type, '.') && ischar(idxkey(oplen - 1).subs))
                     dimname = idxkey(oplen - 1).subs;
+                    % build path to the data
                     temppath = obj.currentpath__;
                     for i = 1:oplen - 2
                         idx = idxkey(i);
@@ -470,15 +474,19 @@
                             end
                         end
                     end
+                    % check if dimname is in dims
                     dims = obj.getattr(temppath, 'dims');
                     if (~isempty(dims) && iscell(dims))
                         dimpos = find(strcmp(dims, dimname));
                         if (~isempty(dimpos) && ~isempty(idxkey(oplen).subs))
+                            % build full indices
                             nddata = length(dims);
                             indices = repmat({':'}, 1, nddata);
                             indices{dimpos(1)} = idxkey(oplen).subs{1};
+                            % perform assignment
                             subsargs = struct('type', '()', 'subs', {indices});
                             if (oplen > 2)
+                                % need to assign back through the chain
                                 subidx = idxkey(1:oplen - 2);
                                 tempdata = subsref(obj.data, subidx);
                                 tempdata = subsasgn(tempdata, subsargs, otherobj);
@@ -495,6 +503,7 @@
             % Fast path: single-level assignment like jd.key = value
             if (oplen == 1 && strcmp(idxkey(1).type, '.') && ischar(idxkey(1).subs))
                 fieldname = idxkey(1).subs;
+                % Skip if JSONPath
                 if (isempty(fieldname) || fieldname(1) ~= char(36))
                     if (isempty(obj.data))
                         obj.data = struct();
@@ -504,6 +513,7 @@
                             obj.data.(fieldname) = otherobj;
                             return
                         catch
+                            % Field name invalid for struct, convert to Map
                             fnames = fieldnames(obj.data);
                             if (~isempty(fnames))
                                 obj.data = containers.Map(fnames, struct2cell(obj.data), 'UniformValues', 0);
@@ -594,6 +604,7 @@
                         continue
                     end
                     if (ischar(idx.subs) && ~(~isempty(idx.subs) && idx.subs(1) == char(36)))
+                        % Handle empty or non-struct/map data
                         if isempty(opcell{i}) || (~isstruct(opcell{i}) && ~ismap_(obj.flags__, opcell{i}))
                             opcell{i} = obj.newkey_();
                         end