how_to_install

一个很不错的程序切片工具,希望大家来讨论以下,对测试人员很有帮助

                             Installing Unravel 2.2


          _1.  _I_n_t_r_o_d_u_c_t_i_o_n

               Unravel is  a  prototype  program  slicer  for  ANSI  C
          developed  at  the National Institute of Standards and Tech-
          nology (NIST).  Unravel is  usually  easy  to  install  but,
          there are some rough edges that can bite.  This file identi-
          fies the supporting software that you need, gives some hints
          for  finding  it  on  your system or the Internet, and gives
          instructions for running make.


          _2.  _U_n_r_a_v_e_l _R_e_q_u_i_r_e_m_e_n_t_s

               Unravel is written for the UNIX (or POSIX) environment.
          Unravel  needs  to  be  able to run several common UNIX com-
          mands, including: csh, sed, echo, date, yacc, and lex.   The
          echo command should allow the -n option (to indicate no new-
          line).  The original unravel development was under SunOs 4.1
          but,  we  have  compiled under Solaris, ULTRIX, SGI/IRIX and
          DEC OSF/1.

               The unravel interface was developed under X Window Sys-
          tem  X11R5  using the Xt toolkit and the MIT Athena widgets.
          Unravel should compile and run under X11R6; it also compiles
          and runs under X11R4.

               Unravel needs a C preprocessor (that  is  ANSI  C  com-
          plient  if unravel is to be used on ANSI C source code) from
          a C compiler to invoke when unravel  is  looking  at  source
          code.   Unravel compiles under either a K&R C compiler or an
          ANSI C compiler.  The gcc compiler is ANSI  complient,  pro-
          duced by the Free Software Foundation (the GNU project), and
          can be obtained over the WWW from
              http://www.yahoo.com/Computers/Software/Gnu_Software
          or by ftp to
                                prep.ai.mit.edu
          in subdirectory pub/gnu/.

          _3.  _R_u_n_n_i_n_g _m_a_k_e _o_n _U_n_r_a_v_e_l

               Before making unravel, the following should be done:

              Obtain unravel source via ftp from hissa.ncsl.nist.gov
              uncompress and un-tar the source code somewhere on your system
              Locate the X Window System tree with includes and libs
              Decide on a C compiler for installing unravel
              Decide on a home for installing unravel





          @(#)how.nr 1.5             - 1 -          August 23, 1995










          _3._1.  _O_b_t_a_i_n_i_n_g _U_n_r_a_v_e_l

               The    unravel    source    code    is    located    on
          hissa.ncsl.nist.gov  at  the National Institute of Standards
          and Technology.  Use ftp with  a  user  name  of  _a_n_o_n_y_m_o_u_s.
          Please  use  your _u_s_e_r _n_a_m_e  followed by an _a_t _s_i_g_n as pass-
          word (e.g., jimmy@).   This  directory  also  contains  both
          volumes  of  _N_I_S_T_I_R  _5_6_9_1  _U_n_r_a_v_e_l:  _A  _C_A_S_E  _T_o_o_l _t_o _A_s_s_i_s_t
          _E_v_a_l_u_a_t_i_o_n _o_f _H_i_g_h _I_n_t_e_g_r_i_t_y _S_o_f_t_w_a_r_e.  Volume  1  describes
          the software design of unravel and volume 2 is a user manual
          for unravel.

               The location (directory) where the unravel source  code
          is  unpacked and compiled should be selected carefully since
          once the programs are compiled, they cannot be moved without
          compiling again.

          _3._2.  _U_n_p_a_c_k_i_n_g

               The files have been collected into one file by tar  and
          then compressed by compress.

          _3._3.  _F_i_n_d_i_n_g _t_h_e _X _W_i_n_d_o_w _S_y_s_t_e_m

               If you don't know where your X Window  System  tree  is
          you  can either ask your system administrator or try the csh
          script find_software (in the unravel source directory).

               The X Window System tree  usually  has  subdirectories:
          bin,  man,  include  and  lib.  Sometimes the X includes are
          part of /usr/include and /usr/lib, but usually the MIT  dis-
          tribution of X is installed in /usr/local.

               After the X Window System tree is located the  environ-
          ment  variable  WINHOME  must be set before make can be run.
          This environment variable only needs to be  set  during  the
          make, not needed after unravel has been compiled.  For exam-
          ple, on Sun systems, the default location  of  the  tree  is
          sometimes /usr/openwin.
                          setenv WINHOME /usr/openwin

          _3._4.  _C _C_o_m_p_i_l_e_r

               The C compiler needs to  be  set  in  two  places,  the
          makefile and the file config.h.

               In the makefile, look for the compiler definition line:
                                 CC = something
          _s_o_m_e_t_h_i_n_g should be changed to either gcc (if you  have  the
          GNU  C  compiler)  or  cc (to use the compiler provided with
          your system).




          @(#)how.nr 1.5             - 2 -          August 23, 1995










               Unravel needs a C preprocessor  to  help  parse  source
          program  files.  The makefile invokes a csh script, find_cc,
          to locate a C compiler that  can  be  invoked  (via  the  -E
          option) to run just the C preprocessor.  The script searches
          the directories in the path variable  for  either  acc  (Sun
          ANSI  C compiler), gcc or cc.  If the script fails to find a
          C compiler or if you want to use a compiler  different  from
          the one found, then the file config.h must be changed.  Set-
          ting the C compiler in config.h is  a  little  tricky.   The
          file  config.h  is  generated by rules in the makefile so if
          you try to edit the file at the wrong time things might  not
          work.   The  config.h  file  must be created by running make
          before config.h can be edited.  The best method is to  check
          the config.h after make finishes.  Then to change the C com-
          piler, edit config.h and run make again.

          _3._5.  _I_n_s_t_a_l_l _D_i_r_e_c_t_o_r_y

               Once the make finishes, the  unravel  files  cannot  be
          moved  since  the  location  (directory)  where  the unravel
          source code is located is compiled into the unravel programs
          so  that  they  can find certain files (e.g., icons and help
          files).  However, the main control program can be  installed
          anywhere  in the file directory tree.  The install directory
          is  selected  by  setting  the  INSTALL_DIR  macro  in   the
          makefile.   To  set the INSTALL_DIR macro, edit the makefile
          and find the line: INSTALL_DIR = .
          Replace the dot with the selected  install  directory  name.
          For example, to install in /usr/local, change the line to:
                            INSTALL_DIR = /usr/local
          This puts the main control program (called unravel)  in  the
          directory  /usr/local/bin  and  adds  an unravel man page to
          /usr/local/man/man1.  Note that the  bin  and  man/man1  are
          added automatically to the INSTALL_DIR directory name.

          _3._6.  _R_u_n_n_i_n_g _m_a_k_e

               After WINHOME is set in the environment and CC  is  set
          in the makefile, type: make
          This should compile each unravel source program.   Depending
          on  the  compiler used and how it is installed, there may be
          lots of warning messages (especially if using an ANSI C com-
          piler).

               If everything has compiled correctly,  unravel  can  be
          tried  out on the simple programs in the directory examples.
          The file flavors.c has several obvious slices  and  makes  a
          good trial run.

               To run the install script, type: make install
          This copies the unravel program file and  man  page  to  the
          install subdirectories.



          @(#)how.nr 1.5             - 3 -          August 23, 1995










          _4.  _H_e_l_p

               For more information and very very  limited  help  con-
          tact:

              Dr. James R. Lyle at NIST
              email: [e-mail]
              phone: [phone]
              fax: [phone]














































          @(#)how.nr 1.5             - 4 -          August 23, 1995