Artifact e592c6493fc3a1c2472e79d540f3673d7cc71a5a:


0000: 76 61 63 61 6c 6c 20 2d 20 43 20 66 75 6e 63 74  vacall - C funct
0010: 69 6f 6e 73 20 63 61 6c 6c 65 64 20 77 69 74 68  ions called with
0020: 20 76 61 72 69 61 62 6c 65 20 61 72 67 75 6d 65   variable argume
0030: 6e 74 73 0a 0a 54 68 69 73 20 6c 69 62 72 61 72  nts..This librar
0040: 79 20 61 6c 6c 6f 77 73 20 43 20 66 75 6e 63 74  y allows C funct
0050: 69 6f 6e 73 20 74 6f 20 62 65 20 63 61 6c 6c 65  ions to be calle
0060: 64 20 77 69 74 68 20 76 61 72 69 61 62 6c 65 20  d with variable 
0070: 61 72 67 75 6d 65 6e 74 73 20 61 6e 64 0a 74 6f  arguments and.to
0080: 20 72 65 74 75 72 6e 20 76 61 72 69 61 62 6c 65   return variable
0090: 20 72 65 74 75 72 6e 20 76 61 6c 75 65 73 2e 20   return values. 
00a0: 54 68 69 73 20 69 73 20 6d 75 63 68 20 6c 69 6b  This is much lik
00b0: 65 20 74 68 65 20 76 61 72 61 72 67 73 28 33 29  e the varargs(3)
00c0: 20 66 61 63 69 6c 69 74 79 2c 0a 62 75 74 20 61   facility,.but a
00d0: 6c 73 6f 20 61 6c 6c 6f 77 73 20 74 68 65 20 72  lso allows the r
00e0: 65 74 75 72 6e 20 76 61 6c 75 65 20 74 6f 20 62  eturn value to b
00f0: 65 20 73 70 65 63 69 66 69 65 64 20 61 74 20 72  e specified at r
0100: 75 6e 20 74 69 6d 65 2e 0a 0a 41 20 74 79 70 69  un time...A typi
0110: 63 61 6c 20 75 73 65 20 69 73 20 74 68 65 20 69  cal use is the i
0120: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66  mplementation of
0130: 20 63 61 6c 6c 2d 62 61 63 6b 20 66 75 6e 63 74   call-back funct
0140: 69 6f 6e 73 20 69 6e 20 65 6d 62 65 64 64 65 64  ions in embedded
0150: 0a 69 6e 74 65 72 70 72 65 74 65 72 73 2e 0a 0a  .interpreters...
0160: 0a 49 6e 73 74 61 6c 6c 61 74 69 6f 6e 20 69 6e  .Installation in
0170: 73 74 72 75 63 74 69 6f 6e 73 3a 0a 0a 20 20 20  structions:..   
0180: 20 20 20 20 20 2e 2f 63 6f 6e 66 69 67 75 72 65       ./configure
0190: 0a 20 20 20 20 20 20 20 20 6d 61 6b 65 0a 20 20  .        make.  
01a0: 20 20 20 20 20 20 6d 61 6b 65 20 63 68 65 63 6b        make check
01b0: 0a 20 20 20 20 20 20 20 20 6d 61 6b 65 20 69 6e  .        make in
01c0: 73 74 61 6c 6c 0a 0a 0a 46 69 6c 65 73 20 69 6e  stall...Files in
01d0: 20 74 68 69 73 20 70 61 63 6b 61 67 65 3a 0a 0a   this package:..
01e0: 20 20 20 20 44 6f 63 75 6d 65 6e 74 61 74 69 6f      Documentatio
01f0: 6e 3a 0a 0a 20 20 20 20 20 20 20 20 52 45 41 44  n:..        READ
0200: 4d 45 20 20 20 20 20 20 20 20 20 20 74 68 69 73  ME          this
0210: 20 74 65 78 74 0a 20 20 20 20 20 20 20 20 43 4f   text.        CO
0220: 50 59 49 4e 47 20 20 20 20 20 20 20 20 20 66 72  PYING         fr
0230: 65 65 20 73 6f 66 74 77 61 72 65 20 6c 69 63 65  ee software lice
0240: 6e 73 65 0a 20 20 20 20 20 20 20 20 50 4c 41 54  nse.        PLAT
0250: 46 4f 52 4d 53 20 20 20 20 20 20 20 6c 69 73 74  FORMS       list
0260: 20 6f 66 20 73 75 70 70 6f 72 74 65 64 20 70 6c   of supported pl
0270: 61 74 66 6f 72 6d 73 0a 20 20 20 20 20 20 20 20  atforms.        
0280: 76 61 63 61 6c 6c 2e 33 20 20 20 20 20 20 20 20  vacall.3        
0290: 6d 61 6e 75 61 6c 20 70 61 67 65 20 69 6e 20 55  manual page in U
02a0: 6e 69 78 20 6d 61 6e 20 66 6f 72 6d 61 74 0a 20  nix man format. 
02b0: 20 20 20 20 20 20 20 76 61 63 61 6c 6c 2e 6d 61         vacall.ma
02c0: 6e 20 20 20 20 20 20 6d 61 6e 75 61 6c 20 70 61  n      manual pa
02d0: 67 65 0a 20 20 20 20 20 20 20 20 76 61 63 61 6c  ge.        vacal
02e0: 6c 2e 68 74 6d 6c 20 20 20 20 20 6d 61 6e 75 61  l.html     manua
02f0: 6c 20 70 61 67 65 20 69 6e 20 48 54 4d 4c 20 66  l page in HTML f
0300: 6f 72 6d 61 74 0a 0a 20 20 20 20 53 6f 75 72 63  ormat..    Sourc
0310: 65 3a 0a 0a 20 20 20 20 20 20 20 20 76 61 63 61  e:..        vaca
0320: 6c 6c 2e 68 2e 69 6e 20 20 20 20 20 6d 61 73 74  ll.h.in     mast
0330: 65 72 20 66 6f 72 20 6d 61 69 6e 20 69 6e 63 6c  er for main incl
0340: 75 64 65 20 66 69 6c 65 20 76 61 63 61 6c 6c 2e  ude file vacall.
0350: 68 0a 20 20 20 20 20 20 20 20 76 61 63 61 6c 6c  h.        vacall
0360: 2d 2a 2e 63 20 20 20 20 20 20 73 6f 75 72 63 65  -*.c      source
0370: 20 66 6f 72 20 74 68 65 20 69 6e 74 65 72 66 61   for the interfa
0380: 63 65 20 66 75 6e 63 74 69 6f 6e 0a 20 20 20 20  ce function.    
0390: 20 20 20 20 76 61 63 61 6c 6c 2d 2a 2e 5b 73 53      vacall-*.[sS
03a0: 5d 20 20 20 69 74 73 20 74 72 61 6e 73 6c 61 74  ]   its translat
03b0: 69 6f 6e 20 74 6f 20 61 73 73 65 6d 62 6c 79 20  ion to assembly 
03c0: 6c 61 6e 67 75 61 67 65 0a 20 20 20 20 20 20 20  language.       
03d0: 20 6d 69 73 63 2e 63 20 20 20 20 20 20 20 20 20   misc.c         
03e0: 20 61 75 78 69 6c 69 61 72 79 20 66 75 6e 63 74   auxiliary funct
03f0: 69 6f 6e 73 0a 20 20 20 20 20 20 20 20 74 65 73  ions.        tes
0400: 74 73 2e 63 20 20 20 20 20 20 20 20 20 74 65 73  ts.c         tes
0410: 74 20 70 72 6f 67 72 61 6d 0a 0a 20 20 20 20 49  t program..    I
0420: 6e 73 74 61 6c 6c 61 74 69 6f 6e 3a 0a 0a 20 20  nstallation:..  
0430: 20 20 20 20 20 20 63 6f 6e 66 69 67 75 72 65 20        configure 
0440: 20 20 20 20 20 20 63 6f 6e 66 69 67 75 72 61 74        configurat
0450: 69 6f 6e 20 73 63 72 69 70 74 0a 20 20 20 20 20  ion script.     
0460: 20 20 20 63 6f 6e 66 69 67 75 72 65 2e 69 6e 20     configure.in 
0470: 20 20 20 61 75 74 6f 63 6f 6e 66 2d 32 2e 31 32     autoconf-2.12
0480: 20 73 6f 75 72 63 65 20 66 6f 72 20 74 68 65 20   source for the 
0490: 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 73 63  configuration sc
04a0: 72 69 70 74 0a 20 20 20 20 20 20 20 20 2e 2e 2f  ript.        ../
04b0: 61 75 74 6f 63 6f 6e 66 2f 2a 20 20 20 61 75 78  autoconf/*   aux
04c0: 69 6c 69 61 72 79 20 63 6f 6e 66 69 67 75 72 61  iliary configura
04d0: 74 69 6f 6e 20 73 63 72 69 70 74 73 0a 20 20 20  tion scripts.   
04e0: 20 20 20 20 20 4d 61 6b 65 66 69 6c 65 2e 69 6e       Makefile.in
04f0: 20 20 20 20 20 4d 61 6b 65 66 69 6c 65 20 6d 61       Makefile ma
0500: 73 74 65 72 0a 20 20 20 20 20 20 20 20 63 6f 6e  ster.        con
0510: 66 69 67 2e 68 2e 69 6e 20 20 20 20 20 63 6f 6e  fig.h.in     con
0520: 66 69 67 2e 68 20 6d 61 73 74 65 72 0a 0a 20 20  fig.h master..  
0530: 20 20 50 6f 72 74 69 6e 67 3a 0a 0a 20 20 20 20    Porting:..    
0540: 20 20 20 20 4d 61 6b 65 66 69 6c 65 2e 64 65 76      Makefile.dev
0550: 65 6c 20 20 64 65 76 65 6c 6f 70 65 72 27 73 20  el  developer's 
0560: 4d 61 6b 65 66 69 6c 65 0a 20 20 20 20 20 20 20  Makefile.       
0570: 20 75 6e 64 65 72 73 63 6f 72 65 2e 68 20 20 20   underscore.h   
0580: 20 75 73 65 64 20 74 6f 20 62 75 69 6c 64 20 74   used to build t
0590: 68 65 20 2a 2e 53 20 66 69 6c 65 73 0a 0a 0a 43  he *.S files...C
05a0: 6f 70 79 72 69 67 68 74 20 6e 6f 74 69 63 65 3a  opyright notice:
05b0: 0a 0a 43 6f 70 79 72 69 67 68 74 20 31 39 39 35  ..Copyright 1995
05c0: 20 42 72 75 6e 6f 20 48 61 69 62 6c 65 2c 20 3c   Bruno Haible, <
05d0: 62 72 75 6e 6f 40 63 6c 69 73 70 2e 6f 72 67 3e  bruno@clisp.org>
05e0: 0a 0a 54 68 69 73 20 69 73 20 66 72 65 65 20 73  ..This is free s
05f0: 6f 66 74 77 61 72 65 20 64 69 73 74 72 69 62 75  oftware distribu
0600: 74 65 64 20 75 6e 64 65 72 20 74 68 65 20 47 4e  ted under the GN
0610: 55 20 47 65 6e 65 72 61 6c 20 50 75 62 6c 69 63  U General Public
0620: 20 4c 69 63 65 6e 63 65 0a 64 65 73 63 72 69 62   Licence.describ
0630: 65 64 20 69 6e 20 74 68 65 20 66 69 6c 65 20 43  ed in the file C
0640: 4f 50 59 49 4e 47 2e 20 43 6f 6e 74 61 63 74 20  OPYING. Contact 
0650: 74 68 65 20 61 75 74 68 6f 72 20 69 66 20 79 6f  the author if yo
0660: 75 20 64 6f 6e 27 74 20 68 61 76 65 20 74 68 69  u don't have thi
0670: 73 0a 6f 72 20 63 61 6e 27 74 20 6c 69 76 65 20  s.or can't live 
0680: 77 69 74 68 20 69 74 2e 20 54 68 65 72 65 20 69  with it. There i
0690: 73 20 41 42 53 4f 4c 55 54 45 4c 59 20 4e 4f 20  s ABSOLUTELY NO 
06a0: 57 41 52 52 41 4e 54 59 2c 20 65 78 70 6c 69 63  WARRANTY, explic
06b0: 69 74 20 6f 72 20 69 6d 70 6c 69 65 64 2c 0a 6f  it or implied,.o
06c0: 6e 20 74 68 69 73 20 73 6f 66 74 77 61 72 65 2e  n this software.
06d0: 0a 0a 0a 42 72 75 6e 6f 20 48 61 69 62 6c 65 0a  ...Bruno Haible.
06e0: 3c 62 72 75 6e 6f 40 63 6c 69 73 70 2e 6f 72 67  <bruno@clisp.org
06f0: 3e 0a 0a                                         >..