DOCUMENTATION

SYNOPSIS

PERL PERL PROGRAM NAME: save_button.pm
AUTHOR: 	Juan Lorenzo
DATE: 		May 16 2018 

DESCRIPTION 
    
BASED ON:

previous version (V 0.2) of the main L_SU.pl (V 0.3)
0.02 Nov. 2019  refactoring with gui_history to keep track
of user clicks
 

USE

NOTES

Examples

SEISMIC UNIX NOTES

CHANGES and their DATES V 0.02 refactoring of 2017 version of L_SU.pl

Notes from bash

declare variables

8 off

sub _user_built_flow_Save_perl_file save a unique perl flow built by the user BUT currently does not see to do anything ?? TODO

sub _Save_pre_built_superflow

   	  foreach my $key (sort keys %$save_button) {
          print (" save_button,_Save_pre_built_superflow: key is $key, value is $save_button->{$key}\n");
         }	       	
			print("save_button 2.built_in_flow.pm ONLY save_button superflow_select check_code_button\n");

sub _get_dialog_type

e.g, topic can be Save

sub _get_flow_type

user_built_flow
or
pre_built_superflow

sub director

prior to saving
determine if we are dealing with superflow 
(" menubutton" widget)   
- collect and/or access flow parameters
- default path is the current path

TODO:
or with GUI-made flows ("frame widget")
- collect and/or access flow parameters
- default path is the current path

DB: print("current widget is $LSU->{_current_widget}\n");

 TODO: improve ENCAPSULATION:
 
 Analysis:
 
 i/p: $parameter_values_frame
 i/p: $L_SU_messages
 i/p: $message
 i/p: $param_flow
 i/p: $L_SU
 i/p: $config_superflows
 
 o/p: $gui_history	->set4start_of_Save_button();
 o/p: $gui_history	->set4_save_button
 o/p: $gui_history	->set4end_of_save_button();
  $L_SU 			= $gui_history->get_hash_ref();
 
 o/p: $L_SU
 o/p: $files_LSU
 
 
 save can be of 3 generic types:
 
 dialog type can be save  (Main menu)
 or SaveAs (FileDialog_button function)
 
 i.e. 'either'
 
 or
 	Save  perl program of user-built flow
 or
 	SaveAs perl program of user-built flow
 or	
 	Save pre-built superflow configuration files
		

sub director

sub get_all_hash_ref

return ALL values of the private hash, supposedly
improtant external widgets have not been reset.. only conditions
are reset
TODO: perhaps it is better to have a specific method
	to return one specific widget address at a time?
}

sub _save_button_sub_ref

sub set_dialog_type

 save can be of 3 generic types:
 
 dialog type can be save  (Main menu)
 or SaveAs (FileDialog_button function)
 
 i.e. 'either'
 
 or
 	save  (perl program of user-built flow
 or
 	saveas perl program of user-built flow
 or	
 	save pre-built superflow configuration files
		
	

sub set_flow_type

user_built_flow
or
pre_built_superflow

sub set_hash_ref bring in important widget addresses

sub set_prog_name_sref

in order to know what
_spec file to read for
behaviors