This page provides a button to initiate reading a design data file into Xic, and various controls which set modes which will apply while reading.
If No Merge Into Current is the current selection, then merging is turned off. Reading a cell of the same name as the current cell can either overwrite the current cell or the new cell can be ignored, depending on how name clashes are currently handled (as set in the Setup page of this panel).
If one of Merge Cell Into Current or Merge Into Current Recursively is selected, and the Read File button is pressed, the following operations will be performed. The user will be prompted for a file name. The user can respond with the name of a file, or the name of a cell in memory.
If the user passes a cell name found in memory, the contents of that cell will be duplicated and added to the current cell. This completes the command. Note that there is no difference between the Merge Cell Into Current and Merge Into Current Recursively modes in this case.
If the file name is found on disk, the file will be opened in a temporary symbol table. If a cell is found in the temporary symbol table that has the same name as the current cell, the contents of that cell will be merged into the current cell. Otherwise, the user will be prompted for a cell name. If the user enters a valid cell name, the contents of that cell will be duplicated into the current cell. If the menu is set to Merge Cell Into Current, the command is done. The temporary symbol table will be cleared.
If a recursive merge is selected, the hierarchy of the current cell is traversed. For each cell in the hierarchy, if a cell with the same name exists in the temporary symbol table, the contents of that cell will be duplicated into its counterpart under the current cell. Care is taken to handle the details of this recursive merge cleanly.
There is no undo capability for this command, so be sure to save a copy of the current cell hierarchy before merging, in case of trouble.