2a 1.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960
  1. .TH 2A 1
  2. .SH NAME
  3. 1a, 2a, 5a, 7a, 8a, ka, qa, va \- assemblers
  4. .SH SYNOPSIS
  5. .B 2a
  6. [
  7. .I option ...
  8. ]
  9. [
  10. .I name ...
  11. ]
  12. .br
  13. etc.
  14. .SH DESCRIPTION
  15. These programs
  16. assemble the named files into object files
  17. for the corresponding architectures; see
  18. .IR 2c (1)
  19. for the correspondence between an architecture and the character
  20. .RB ( 1 ,
  21. .RB 2 ,
  22. etc.) that specifies it.
  23. The assemblers handle the most common C preprocessor directives and the associated
  24. command-line options
  25. .BR -D
  26. and
  27. .BR -I .
  28. Other options are:
  29. .TP
  30. .BI -o " obj"
  31. Place output in file
  32. .I obj
  33. (allowed only if there is just one input file).
  34. Default is to take the last element of the input path name,
  35. strip any trailing
  36. .BR .s ,
  37. and append
  38. .RI . O ,
  39. where
  40. .I O
  41. is first letter of the assembler's name.
  42. .SH FILES
  43. The directory
  44. .B /sys/include
  45. is searched for include files after
  46. machine-dependent files in
  47. .BR /$objtype/include .
  48. .SH SOURCE
  49. .BR /sys/src/cmd/2a ,
  50. etc.
  51. .SH SEE ALSO
  52. .IR 2c (1),
  53. .IR 2l (1).
  54. .PP
  55. Rob Pike, ``A manual for the Plan 9 assembler''
  56. .SH BUGS
  57. The list of assemblers given above is only partial,
  58. not all architectures are supported on all systems,
  59. some have been retired and some
  60. are provided by third parties.