1CONVERT(1L) CONVERT(1L)
2
6 convert - convert GENESIS 1.x scripts to GENESIS 2.x syntax and command
7 names
8
10 convert [ oldscriptfile [ newscriptfile ] ] [ -noX1compat ] [ -con‐
11 stants scriptfile ... ]
12
14 Convert converts a GENESIS 1.x script file to GENESIS 2.x syntax
15 replacing old command names and arguments with their GENESIS 2.x coun‐
16 terparts. Without arguments convert will read standard input and write
17 to standard output. With arguments convert reads from and writes to
18 the given file names. If the newscriptfile argument is not given, con‐
19 vert will output to a file with the same name as the input file less
20 any directory path. If a directory path is not given for the input
21 file output is written to standard output.
22 To convert entire script sets UNIX command shell loops may be used.
24 Assuming that an old set of scripts lives in the directory ../old‐
25 scripts, then the following will convert the entire script set.
26 For csh:
28 foreach file (../oldscripts/*.g)
30 convert $file
31 end
32 For sh:
34 for file in ../oldscripts/*.g
36 do
37 convert $file
38 done
39
41 -constants
42 To correctly translate a script Convert needs to know the names of
44 globally defined variables in a script set. The -constants option is
45 used to identify the scripts in which these global script variables are
46 defined. More than one script may be specified.
47 -noX1compat
49 The automatic translation of create commands for Xodus objects to
51 objects in the X1compat library may be suppressed using the -noX1compat
52 option. In this case, converted scripts will use the Xodus 2 objects
53 directly. This will work most of the time for the standard Xodus 1
54 interface objects, but will likely fail for the draw widgets and pixes.
55 xgraph widgets may also fail when not using X1compat but have a better
56 chance of working than xdraw et al.
57
59 The GENESIS 1.x to GENESIS 2.x conversion section of the GENESIS Refer‐
60 ence Manual.
61
63 Convert is not a complete conversion solution. See the Doc/convert.doc
64 help file for a complete discussion of conversion issues including a
65 list of problem areas.
66 Convert will delete the contents of the input file if the output file‐
68 name is the same as the input file name. This can be done implicitly
69 if the input filename path refers to a file in the current directory
70 using a relative path (e.g. convert ./file.g).
71 Convert makes use of the X1compat script set for compatibility with
73 GENESIS 1.x graphical interface elements. The X1compat script direc‐
74 tory should be added to the SIMPATH and the X1compat script called from
75 the .simrc or the main simulation script.
76 Convert translates network models using GENESIS 1.x connections to com‐
78 mands in the connection compatibility library. This library is not
79 included by default in the GENESIS 2.x executable. See the GENESIS
80 Reference Manual for details on compiling GENESIS 2.x with the connec‐
81 tion compatibility library and for tips on rewriting network simula‐
82 tions using the new network modeling objects and commands.
83 3 October 1994 CONVERT(1L)