home *** CD-ROM | disk | FTP | other *** search
/ Computer Club Elmshorn Atari PD / CCE_PD.iso / mac / 1000 / CCE_1024.ZIP / CCE_1024 / SOZBIN07.LZH / SOZDISTR / DOC / JAS.MAN < prev    next >
Text File  |  1994-10-20  |  3KB  |  96 lines
  1. JAS (1)            USER COMMANDS                JAS(1)
  2.  
  3. NAME
  4.  
  5.         jas  -  Joe's assembler - the SOZOBON(X) assembler
  6.  
  7.  
  8. SYNOPSIS
  9.  
  10.         jas [options] [-o <object file>] <source file>
  11.  
  12.         jas [options] <inputfile> [<outputfile>[ <errorfile>]]
  13.  
  14.         jas [-VvhN8lu] [-L<n>] [-s <dir>] <source file>
  15.                [[-o ]<object file>] [[-E]<errorfile>]
  16.  
  17.  
  18. DESCRIPTION            
  19.  
  20.       The  jas  assembler is designed for compatibility with the Alcyon
  21.       assembler.   It   doesn't  provide  many  features  the  assembly
  22.       language  programmer  might want, but is intended more for use by
  23.       a  compiler  front-end.  Jas generally produces smaller code than
  24.       the  Alcyon  assembler  because  it  is  smarter about generating
  25.       short  branch  instructions.   Also,  jas uses no temporary files
  26.       and runs quite a bit faster than Alcyon.  
  27.  
  28.       Jas works as a filter on the input file (68000 assembler sorce code);
  29.       if no output file is given, the generated object is written to a file
  30.       with same name but suffix '.o'. You can use '-' for input file and
  31.       output file, too. Jas will read then from stdin, and/or write to
  32.       stdout.
  33.  
  34.       Some  of  the command line options are accepted for compatibility
  35.       with  the  Alcyon  assembler,  but  are  actually  ignored.   The
  36.       following command line options are supported: 
  37.  
  38.         --version
  39.         -V      (Version)
  40.            Print a version message and exit.  
  41.  
  42.         -v      (verbose)
  43.            Print a short version info, the size of the generated object
  44.            module and some information about optimizing branches and jumps.
  45.            
  46.         -h      (help)
  47.            Print the usage message and exit.
  48.  
  49.         -N
  50.            Don't optimize (esp. don't generate 'short' branch 
  51.            instructions).  
  52.  
  53.         -8      (short names)
  54.            Don't generate SozobonX symbols for names longer than 8
  55.            characters, but cut them to a length of 8.
  56.  
  57.         -L<n>   (Local symbols) 
  58.            By  default,  no local symbols are placed in the symbol
  59.            table  of  the output. This option instructs jas to put
  60.            all  symbols  into  the  symbol  table  if  n  is  2 or
  61.            greater.  If  the  option '-L1' is given, symbols whose
  62.            name  doesn't  start with 'L' ot 'T' are written to the
  63.            symbol table.  
  64.  
  65.         -o <file> 
  66.  
  67.            By default, the assembler replaces the input file's extension
  68.            ('.s') with '.o' to form the name of the output.  This option
  69.            can be used to write the output to any file. 
  70.  
  71.         ignored for compatibility:
  72.  
  73.         -l 
  74.  
  75.         -u 
  76.  
  77.         -s <dir> 
  78.  
  79.  
  80.  
  81. ENVIRONMENT
  82.  
  83.         If $STDERR is present, stderr handle (2) is used for diagnostic
  84.         output; if not and no ARGV was used it will be CONsole handle (-1).
  85.  
  86.  
  87. BUGREPORTS
  88.  
  89.     Current maintainer is Thorsten Roskowetz. Please send bugreports
  90.     using the bugform' to
  91.     rtroskow@jupiter.rz.Uni-Osnabrueck.DE (Thorsten Roskowetz)
  92.  
  93.  
  94. SEE ALSO
  95.         cc(1), make(1), nm(1)
  96.