Source code of Windows XP (NT5)
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

160 lines
4.8 KiB

  1. Documentation (no really)
  2. Source Code Documentation Formatting Tool
  3. Version 1.09.04 Oct 16 1989 17:45:39 - MATTS
  4. (more options will be added to future versions)
  5. usage:
  6. docfmt [-x[ ]name] [-r[dh]] [-c[01] [-p[01]
  7. [-o[ ]filename] [-d[ ]dirpath] [-l[ ]logfile] [-Zs] [files]
  8. [@argfile]
  9. -x[ ]name Defines <name> to be included as a valid doc level
  10. generated from the extracted file.
  11. Default if /x option is not specified is 'external.
  12. -Zs No output, error check only. This is compatible with
  13. the 'C' compiler -Zs option.
  14. -rd Generate RTF output for printing.
  15. This generates an RTF file formatted for printed documentation.
  16. -r Same as -rd.
  17. -rh Generate RTF output for WinHelp.
  18. (Default RTF is for printing.)
  19. If no -r option is specified, then output is generated for Ventura.
  20. -p[01] Process output files.
  21. If set to 0, then the temporary files are not copied to
  22. the output file.
  23. if set to 1, then the files are copied.
  24. Default is to process files.
  25. -c[01] Clean up intermediate files.
  26. If set to 0, then then temporary files are not deleted
  27. after the processing step.
  28. If set to 1, then then temporary files are deleted
  29. Default is to delete temporary files.
  30. -ddirpath Specify the directory for temporary files.
  31. (only one tmp path should be specified)
  32. For speed, this should be a RAM drive if one is installed.
  33. Note that many temporary files will be created and the
  34. default RAMdrive setup only allows a minimum number
  35. of files to be created on the RAMdrive.
  36. Default directory is the current directory.
  37. -llogfile Specify the logfile to process. Many different log files
  38. may be specified. These log files must be created by
  39. docfmt (by using /c1 and or /p0 )
  40. The default logfile is <file>.log where <file> is the
  41. complete path and file name (without extension) of
  42. a file to be processed.
  43. -ooutputfile Specify the outputrfile.
  44. (the output file results from processing the logfiles)
  45. The default output is <file>.rtf when in /r output mode
  46. or <file>.vp when in Ventura output mode.
  47. <file> is the complete path and file name (without extension)
  48. of a file to be processed.
  49. files File to be processed. Multiple files can be specified.
  50. This file must be generated by Extract.
  51. @argfile Name of file to get list of arguments from.
  52. This allow a long list of arguments to be stored in a file
  53. similar to the way DOS Link works.
  54. Multiple @arg files may be put on the command line and they
  55. will be processed in order.
  56. The arg file must consist of one argument per line.
  57. Comments can be entered by putting a # or a ';' as the
  58. first significant (non-whitespace) character on a line.
  59. Options may be placed in any order.
  60. example:
  61. docfmt /xinternal /rd dspmgr.ext
  62. Defines the 'internal' doc level to be extracted.
  63. Specifies RTF output for documents.
  64. The input file will be dspmgr.ext
  65. The output file will default to dspmgr.rtf
  66. The log file will default to dspmgr.log.
  67. Temporary directory defaults to the current directory.
  68. Files will be cleaned by default.
  69. Files will be processed by default.
  70. example:
  71. docfmt dspmgr.ext
  72. Defaults to 'external' as the doc level to be extracted.
  73. Defaults to Ventura output for documents.
  74. The input file will be dspmgr.ext
  75. The output file will default to dspmgr.vp
  76. The log file will default to dspmgr.log.
  77. Temporary directory defaults to the current directory.
  78. Files will be cleaned by default.
  79. Files will be processed by default.
  80. example: docfmt /d \tmp /rh dspmgr.ext
  81. Defaults to 'external' as the doc level to be extracted.
  82. Specifies the output will be RTF for help.
  83. The input file will be dspmgr.ext
  84. The output file will default to dspmgr.rtf
  85. The log file will default to dspmgr.log.
  86. Temporary directory is set to \tmp.
  87. Files will be cleaned by default.
  88. Files will be processed by default.
  89. example: docfmt -x internal -x dspmgr -d\tmp /rh dspmgr.ext /c0 /p0
  90. Specifies the 'internal' doc level to be extracted.
  91. Specifies the 'dspmgr' doc level to be extracted.
  92. Specifies the output will be RTF for help.
  93. The input file will be dspmgr.ext
  94. The output file will default to dspmgr.rtf
  95. The log file will default to dspmgr.log.
  96. Temporary directory is set to \tmp.
  97. Files will be not cleaned as specified
  98. Files will be not processed as specified.
  99. example: docfmt /rd @args /c0
  100. @args:
  101. -----
  102. # arg file for dspmgr
  103. -xinternal
  104. -xdspmgr
  105. -d\tmp
  106. /c1
  107. /p0
  108. -----
  109. Specifies the 'internal' doc level to be extracted.
  110. Specifies the 'dspmgr' doc level to be extracted.
  111. Specifies the output will be RTF for documents
  112. The input file will be dspmgr.ext
  113. The output file will default to dspmgr.rtf
  114. The log file will default to dspmgr.log.
  115. Temporary directory is set to \tmp.
  116. Files will be not cleaned as specified (/c0 comes after arg file).
  117. Files will be not processed as specified.