unitdiff.1 2.4 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495
  1. .TH unitdiff 1 "14 November 2004" "Free Pascal" "FPC unit difference viewer"
  2. .SH NAME
  3. unitdiff \- Describe differences in the interface of a FPC unit.
  4. .SH SYNOPSIS
  5. \fBunitdiff\fP [--disable-arguments] [--disable-private] [--disable-protected]
  6. [--help] [--lang=language] [--list] [--output=filename] [--sparse] file1 file2
  7. .SH Description
  8. .B unitdiff
  9. scans one or two Free Pascal unit source files and either lists all
  10. available identifiers, or describes the differences in identifiers
  11. between the two units.
  12. .SH Usage
  13. You can invoke
  14. .B unitdiff
  15. with as the only required argument a
  16. .B input
  17. filename. It will then simply list all available identifiers.
  18. The regular use is to invoke
  19. .B unitdiff
  20. with
  21. .B input1 input2
  22. arguments. It will then show the difference in interface between the two
  23. units, or list the available identifiers in both units. The output of
  24. .B unitdiff
  25. will go to standard output by default.
  26. .SH Options
  27. .B unitdiff
  28. has some options, most of them optional, defaults will be used in most
  29. cases.
  30. .TP
  31. .BI \-\-disable-arguments
  32. If this option is specified,
  33. .B unitdiff
  34. will not check the arguments of functions and procedures. By
  35. default, these are checked as well.
  36. .TP
  37. .BI \-\-disable-private
  38. By default, private methods of classes are checked. if this option
  39. is specified, private fields or methods are not checked.
  40. .TP
  41. .B \-\-disable-protected
  42. By default, protected methods of classes are checked. if this option
  43. is specified, protected
  44. .I and
  45. private fields or methods are not checked.
  46. .TP
  47. .BI \-\-help
  48. Emit a short help text and exit.
  49. .TP
  50. .BI \-\-lang=language
  51. Sets the language for the output file. This will mainly set the strings used
  52. for the headers in various parts of the documentation files (by default
  53. they're in english). Currently, valid options are
  54. .RS
  55. .TP
  56. .I de
  57. German.
  58. .TP
  59. .I fr
  60. French.
  61. .TP
  62. .I nl
  63. Dutch.
  64. .RE
  65. .TP
  66. .BI \-\-list
  67. If this option is specified, only the list of available identifiers will be
  68. specified for the unit or units. If only 1 unit is specified, this option is
  69. automatically assumed.
  70. .TP
  71. .BI \-\-output=filename
  72. This option tells
  73. .B unitdiff
  74. where the output should go. If this option is not specified, the output is
  75. sent to standard output (the screen).
  76. .TP
  77. .BI \-\-sparse
  78. Turns on sparse mode. In this mode, the output will not contain the types of
  79. the identifiers. Only the names of the identifiers are written to the
  80. output. By default, also type descriptions are written.
  81. .SH SEE ALSO
  82. .IP
  83. .BR ppc386 (1)
  84. .BR fpdoc (1)