sdcc-extra/historygraphs/dhrystone-stm8/README_C

   1 This "shar" file contains the documentation for the
   2 electronic mail distribution of the Dhrystone benchmark (C version 2.1);
   3 a companion "shar" file contains the source code.
   4 (Because of mail length restrictions for some mailers, I have
   5 split the distribution in two parts.)
   6
   7 For versions in other languages, see the other "shar" files.
   8
   9 Files containing the C version (*.h: Header File, *.c: C Modules)
  10
  11   dhry.h
  12   dhry_1.c
  13   dhry_2.c
  14
  15 The file RATIONALE contains the article
  16
  17   "Dhrystone Benchmark: Rationale for Version 2 and Measurement Rules"
  18
  19 which has been published, together with the C source code (Version 2.0),
  20 in SIGPLAN Notices vol. 23, no. 8 (Aug. 1988), pp. 49-62.
  21 This article explains all changes that have been made for Version 2,
  22 compared with the version of the original publication
  23 in Communications of the ACM vol. 27, no. 10 (Oct. 1984), pp. 1013-1030.
  24 It also contains "ground rules" for benchmarking with Dhrystone
  25 which should be followed by everyone who uses the program and publishes
  26 Dhrystone results.
  27
  28 Compared with the Version 2.0 published in SIGPLAN Notices, Version 2.1
  29 contains a few corrections that have been made after Version 2.0 was
  30 distriobuted over the UNIX network Usenet. These small differences between
  31 Version 2.0 and 2.1 should not affect execution time measurements.
  32 For those who want to compare the exact contents of both versions,
  33 the file "dhry_c.dif" contains the differences between the two versions,
  34 as generated by a file comparison of the corresponding files with the
  35 UNIX utility "diff".
  36
  37 The file VARIATIONS contains the article
  38
  39   "Understanding Variations in Dhrystone Performance"
  40
  41 which has been published in Microprocessor Report, May 1989
  42 (Editor: M. Slater), pp. 16-17. It describes the points that users
  43 should know if C Dhrystone results are compared.
  44
  45 Recipients of this shar file who perform measurements are asked
  46 to send measurement results to the author and/or to Rick Richardson.
  47 Rick Richardson publishes regularly Dhrystone results on the UNIX network
  48 Usenet. For submissions of results to him (preferably by electronic mail,
  49 see address in the program header), he has provided a form which is contained
  50 in the file "submit.frm".
  51
  52
  53 The following files are contained in other "shar" files:
  54
  55 Files containing the Ada version (*.s: Specifications, *.b: Bodies):
  56
  57   d_global.s
  58   d_main.b
  59   d_pack_1.b
  60   d_pack_1.s
  61   d_pack_2.b
  62   d_pack_2.s
  63
  64 File containing the Pascal version:
  65
  66   dhry.p
  67
  68
  69 February 22, 1990
  70
  71                  Reinhold P. Weicker
  72                  Siemens AG, AUT E 51
  73                  Postfach 3220
  74                  D-8520 Erlangen
  75                  Germany (West)
  76
  77                  Phone:  [xxx-49]-9131-7-20330  (8-17 Central European Time)
  78                  UUCP:   ..!mcsun!unido!estevax!weicker