gnu/dist/gmake/tests/scripts/test_template

   1 $description = "The following test creates a makefile to ...
   2                      <FILL IN DESCRIPTION HERE> ";
   3
   4 $details = "<FILL IN DETAILS OF HOW YOU TEST WHAT YOU SAY YOU ARE TESTING>";
   5
   6 # IF YOU NEED >1 MAKEFILE FOR THIS TEST, USE &get_tmpfile; TO GET
   7 # THE NAME OF THE MAKEFILE.  THIS INSURES CONSISTENCY AND KEEPS TRACK OF
   8 # HOW MANY MAKEFILES EXIST FOR EASY DELETION AT THE END.
   9 # EXAMPLE: $makefile2 = &get_tmpfile;
  10
  11 open(MAKEFILE,"> $makefile");
  12
  13 # The Contents of the MAKEFILE ...
  14
  15 print MAKEFILE " <FILL IN THE CONTENTS OF THE MAKEFILE HERE>  \n";
  16
  17 # END of Contents of MAKEFILE
  18
  19 close(MAKEFILE);
  20
  21
  22 # Run make.  You may specify a makefile, but if you don't want to, just
  23 # insert "" where $make_filename is now.  You may also specify specific
  24 # options to run make with, but you also don't have to. (Insert "" where it
  25 # says <FILL IN OPTIONS HERE>), The last field in this subroutine call
  26 # is the code which is returned from make.  If you think that make should
  27 # execute with no errors, you may OPTIONALLY put 0; Otherwise put the
  28 # error code that you expect back from make for this test.
  29
  30 # Every time you run make, you just need to say &get_logfile and that
  31 # subroutine will get a new logfile name for you in incrementing order
  32 # according to how many times you call it within ONE test.  It is
  33 # reset to 0 at the beginning of every new test script.
  34
  35 &run_make_with_options($makefile,
  36                        "<FILL IN OPTIONS HERE>",
  37                        &get_logfile,
  38                        0);
  39
  40
  41 # THE REST OF THIS FILE DEPENDS HIGHLY ON WHAT KIND OF TEST YOU ARE
  42 # CREATING, SO IT WILL VARY.  BASICALLY, YOU MAY INSERT ANYTHING YOU
  43 # WISH AT THIS POINT TO SEE IF THE TEST WORKED OK.  IF THERE ARE
  44 # ADDITIONAL TESTS BESIDES &compare_output, AND IT FAILES, YOU
  45 # MUST *** SET $test_passed = 0 !!! ***
  46
  47 # Create the answer to what should be produced by this Makefile
  48 $answer = "<INSERT ANSWER HERE>";
  49
  50 # COMPARE RESULTS
  51
  52 # In this call to compare output, you should use the call &get_logfile(1)
  53 # to send the name of the last logfile created.  You may also use
  54 # the special call &get_logfile(1) which returns the same as &get_logfile(1).
  55
  56 &compare_output($answer,&get_logfile(1));
  57
  58 # If you wish to &error ("abort
  59 ") if the compare fails, then add a "|| &error ("abort
  60 ")" to the
  61 # end of the previous line.
  62
  63 # This tells the test driver that the perl test script executed properly.
  64 1;
  65
  66
  67
  68
  69
  70