Copying the Tutorial Files

Mentor Graphics design objects contain absolute directory path references. Since many of these paths are self-referencing, using the cp or mv command in Unix to copy or move these design objects to new directories can break those references. The Mentor Graphics Design Architect allows design objects to be copied or moved across directories by adjusting path references within each design object as it is relocated.

To demonstrate the Copy operation in Design Manager, perform the following steps:

1. In the Navigator window, move to the directory where the tutorial files were installed.
   
   
2. Select the calc_sch directory.
   
   
3. To see the references in this design, choose Right Mouse Button Report Show References For Design.
   
   A List of Unique References underneath the calc_sot directory is displayed. An example reference item might be:
   
   $XILINX_TUTORIAL/calc_sot/alu/alu:mgc_symbol[6]
   
   This indicates that an ALU symbol (version 6 under Mentor Graphics' versioning system) is referenced by the path $XILINX_TUTORIAL/calc_sot/alu/alu.
   
   All references in the design should contain either $LCA or $XILINX_TUTORIAL.
   
   
4. Close the List of Unique References window.
   
   
5. With the calc_sch directory selected in the Navigator window, choose Right Mouse Button Edit Copy.
   
   A dialog box appears.
   
   
6. In the dialog box, type the directory path where you want the working copy of the tutorial files copied. For example, if you want to copy the files to /home/dum/tutor/mentor, enter /home/dum/tutor/mentor/calc_sch. Click OK.
   
   
7. Use the Navigator to change directories to the location of the working copy of calc_sch. In the example above, you would click the “four-arrow” button at the bottom of the Navigator window, then type /home/dum/tutor/mentor in the dialog box.
   
   
8. Select the calc_sch directory.
   
   
9. As before, choose Right Mouse Button Report Show References For Design. The example reference above with the ALU symbol appears:
   
   /home/dum/tutor/mentor/calc_sch/alu/alu:mgc_symbol[6]
   
   
10. Close the List of Unique References window.
    
    
11. Modify your MGC_LOCATION_MAP file so that the $XILINX_TUTORIAL variable points to the directory where the copy of calc_sch is located. In the example above, change the $XILINX_TUTORIAL section of the file so that it reads:
    
    $XILINX_TUTORIAL
    /home/dum/tutor/mentor
    
    
12. Read the newly modified location map into Design Architect by selecting MGC Location Map Read Map from the menu bar.
    
    
13. In the dialog box, type $MGC_LOCATION_MAP, then click OK.
    
    The $XILINX_TUTORIAL soft name now points to the new tutorial area. However, references in the calc_sch directory use /home/dum/tutor/mentor instead of its new equivalent, $XILINX_TUTORIAL. While this is legal, it is best in Mentor to use soft names wherever possible.
    
    
14. To convert the hard name back into a soft name, select the calc_sch directory and choose Right Mouse Button Edit Change References.
    
    
15. In the Change References dialog box, enter for From: /home/dum/tutor/mentor (or whatever directory is applicable to your case). For To, enter $XILINX_TUTORIAL.
    
    

    Figure 9.2 Change References Dialog Box

16. Click OK.
    
    The Change References process begins.
    
    
17. After the process is finished, you can do another Show References operation to verify that all references have been changed properly.
    
    

    ---

    NOTE

    You can copy or move a design object without rewriting path references by selecting Options Convert References? No from the Copy or Move dialog box.

    ---