home *** CD-ROM | disk | FTP | other *** search
/ AMIGA PD 1 / AMIGA-PD-1.iso / Programme_zum_Heft / Programmieren / Kurztests / DiceC / doc / fdtolib.doc < prev    next >
Text File  |  1994-02-01  |  3KB  |  79 lines
  1.  
  2. dcc/fdtolib                            dcc/fdtolib
  3.  
  4.                 FDTOLIB.DOC
  5.  
  6.                   Matthew Dillon
  7.                   891 Regal Rd.
  8.                   Berkeley, Ca. 94708
  9.                   USA
  10.  
  11.                   dillon@overload.Berkeley.CA.US        --or--
  12.                   uunet.uu.net!overload!dillon
  13.  
  14. SYNOPSIS
  15.     FDTOLIB files/wildcard.fd [-h hdrfile] -o libname [-mr] [-mD] <more_opts)
  16.  
  17.     files/wildcard.fd    specifies one or more files and/or AmigaDOS
  18.             wildcarding that represents the .FD files that
  19.             are to be processed into a library
  20.  
  21.     -h hdrfile        hdrfile is a .H files that #include's all
  22.             prototypes associated with the FD files.  It
  23.             is only used if the -mr option is specified
  24.  
  25.     -o libname        specify output library name
  26.  
  27.     -mr         specify that a REGISTERED call interface library
  28.             is to be generated (for DICE -m[r,R,RR] options),
  29.             else generates a normal stack-args interface
  30.             library.
  31.  
  32.     -mD         specify large-data model, else small-data model
  33.  
  34.     -I include-dir    passed to DCC
  35.  
  36.     -p prefix        Set prefix (currently only for standard generation,
  37.             doesn't work with -mr).  The default is a single
  38.             unscore.  This option is normally used to generate
  39.             _hyper_ tags for dynamic.library
  40.  
  41.     -prof        Generate profiling code for the tags.  This will
  42.             cause all library calls to be profiled when the
  43.             program that links with this library is run.
  44.  
  45.  
  46. DESCRIPTION
  47.  
  48.     FDTOLIB will create an amiga standard library out of specified .FD
  49.     files (for example, you can generate most of amiga.lib by using
  50.     the .FD files on your 1.3 Extras disk).
  51.  
  52.     Basically, FDTOLIB will generate one of four types of libraries:
  53.  
  54.     default     small-data model
  55.     -mD        large-data model
  56.     -mr        small-data model + DICE registered parameters entry pts
  57.     -mr -mD     large-data model + DICE registered parameters entry pts
  58.  
  59.     If -mr is used suitable prototypes must be specified with the -h option.
  60.     In this case, FDTOLIB will run DCC with a special option to have it
  61.     generate a register-specification file for it to match up again the
  62.     FD files.
  63.  
  64.     FDTOLIB then proceeds to scan the .FD files, creating temporary
  65.     assembly files in T: and assembling them with DAS, then appending
  66.     them to the output library and deleting the scratch files.    This
  67.     step occurs for each function in each .FD files.
  68.  
  69.     (For faster operation, you will want to make DAS resident for the
  70.     duration)
  71.  
  72.     If -mr was specified, FDTOLIB only generates library entries for
  73.     those routines for which a prototype exists.  At the end of the
  74.     run FDTOLIB will report any routines which existed in the .FD files
  75.     but did not have a prototype.
  76.  
  77.  
  78.  
  79.