h2paspp.1 1.7 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980
  1. .TH h2paspp 1 "12 November 2004" "Free Pascal" "h2pas preprocessor"
  2. .SH NAME
  3. h2paspp \- Free Pascal h2pas preprocessor program.
  4. .SH SYNOPSIS
  5. .B h2paspp [-doih] file1 ... filen
  6. .SH DESCRIPTION
  7. .B h2paspp
  8. reads one or more C header files and preprocesses them, writing the result
  9. to files with the same name as the originals as it goes along.
  10. It does not accept all preprocesser tokens of C, but takes care of the following
  11. preprocessor directives:
  12. .TP
  13. .I #define symbol
  14. Defines the new symbol
  15. .I symbol
  16. . Note that macros are not supported.
  17. .TP
  18. .I #if symbol
  19. The text following this directive is included if
  20. .I symbol
  21. is defined.
  22. .TP
  23. .I #ifdef symbol
  24. The text following this directive is included if
  25. .I symbol
  26. is defined.
  27. .TP
  28. .I #ifndef symbol
  29. The text following this directive is included if
  30. .I symbol
  31. is not defined.
  32. .TP
  33. .I #include filename
  34. Include directives are removed, unless the
  35. .B \-I
  36. option was given, in which case the include file is included and written to
  37. the output file.
  38. .TP
  39. .I #undef symbol
  40. The symbol
  41. .I symbol
  42. is undefined.
  43. .SH USAGE
  44. .B h2paspp
  45. accepts one or more filenames and preprocesses them. It will read the
  46. input, and write output to a file with the same name unless the
  47. .B \-o
  48. option is given, in which case the file is written to the specified file.
  49. Note that only one output filename can be given.
  50. .SH OPTIONS
  51. h2paspp has a small number of options to control its behaviour:
  52. .TP
  53. .B \-dsymbol
  54. Define the symbol
  55. .I symbol
  56. before processing is started.
  57. .TP
  58. .B \-h
  59. emit a small helptext.
  60. .TP
  61. .B \-ooutfile
  62. If this option is given, the output will be written to a file named
  63. .I outfile
  64. . Note that only one output file can be given.
  65. .SH SEE ALSO
  66. .IP
  67. .BR ppc386 (1)
  68. .BR h2pas (1)
  69. .BR cpp (1)