update code comments

Author: dlegland

GenericDialog.m

@@ -26,19 +26,18 @@
 %     type = getNextString(gd);
 %     display = getNextBoolean(gd);
 %
-%     % Creates new image, and displays if requested
-%     img = Image.create([width height], type);
-%     img.name = name;
+%     img = zeros([height width], type);
 %     if display
-%         show(img); title(name);
+%         imshow(img);
+%         title(name);
 %     end
 %
 %   See also
-%
+%     inputdlg, figure, uix.VBox
 
 % ------
 % Author: David Legland
-% e-mail: david.legland@inra.fr
+% e-mail: david.legland@inrae.fr
 % Created: 2014-04-18,    using Matlab 7.9.0.529 (R2009b)
 % Copyright 2014 INRA - Cepia Software Platform.
 

demo_GenericDialog.m

@@ -1,4 +1,4 @@
-%GO  run script for GenericDialog class
+%DEMO_GENERICDIALOG Demo script for the GenericDialog class.
 %
 %   output = go(input)
 %
@@ -10,44 +10,44 @@
 %
 % ------
 % Author: David Legland
-% e-mail: david.legland@grignon.inra.fr
+% e-mail: david.legland@inrae.fr
 % Created: 2011-10-18,    using Matlab 7.9.0.529 (R2009b)
 % Copyright 2011 INRA - Cepia Software Platform.
 
 % clean up
 close all
 clear classes %#ok<CLCLS>
 
-% creates a new dialog, and populate it with some fields
+% Creates a new dialog, and populate it with some fields.
+% Each option is defined by a name, a default value, and optionnally some
+% settings.
 gd = GenericDialog('Create Image');
 addTextField(gd, 'Name: ', 'New Image');
 addNumericField(gd, 'Width: ', 320, 0);
 addNumericField(gd, 'Height: ', 200, 0);
 addChoice(gd, 'Type: ', {'uint8', 'uint16', 'double'}, 'uint8');
 addCheckBox(gd, 'Display', true);
-% pack(gd);
 
-% display the dialog, and wait for user
+% display the dialog, and wait for user input
 showDialog(gd);
 
-% check if ok or cancel was clicked
+% check if ok or canceled was clicked
 if wasCanceled(gd)
     return;
 end
 
-
+% retrieve options given by user
 name = gd.getNextString();
 disp(name);
-
 width = getNextNumber(gd);
 height = getNextNumber(gd);
 disp([width height]);
 type = getNextString(gd);
-display = getNextBoolean(gd);
+displayFlag = getNextBoolean(gd);
 
-% Create new image, and display if requested
-img = zeros([height width ], type);
-if display
+% Create a new image, and display if requested
+img = zeros([height width], type);
+if displayFlag
     imshow(img);
     title(name);
 end