请输入您要查询的百科知识:

 

词条 HeaderDoc
释义

  1. Supported plain text languages

  2. Additional Features

  3. See also

  4. External links

{{Infobox software
| name = HeaderDoc
| logo =
| screenshot =
| caption =
| collapsible =
| author =
| developer = Apple Inc.
| released = September 13, 2000
| latest release version = 8.9
| latest release date = June 8, 2009
| latest preview version =
| latest preview date =
| programming language = Perl, C (helpers)
| operating system = Mac OS X, UNIX, Linux
| platform =
| language =
| status =
| genre = Documentation generator
| license = Apple Public Source License 2.0
| website = https://developer.apple.com/opensource/tools/headerdoc.html
}}

HeaderDoc is a documentation generator developed and maintained by Apple Inc. Using specially commented source code files as input, HeaderDoc generates documentation for the code in HTML or XML format. Syntax for HeaderDoc comment tags is largely similar to, and as of HeaderDoc version 8, supportive of Javadoc tags. HeaderDoc 8.7 and later also provides partial support for many Doxygen tags (@ form only, and must conform to HeaderDoc tag ordering rules). Apple's HeaderDoc project is free, open source software distributed under the Apple Public Source License.

Supported plain text languages

  • AppleScript
  • Bash
  • Bourne Shell
  • C Shell
  • C
  • C++
  • Korn Shell
  • Java
  • JavaScript
  • Mach MIG definitions [https://developer.apple.com/mac/library/documentation/Darwin/Conceptual/KernelProgramming/boundaries/boundaries.html#//apple_ref/doc/uid/TP30000905-CH217-BEHJDFCA]
  • Objective-C
  • Pascal
  • Perl
  • PHP
  • Python
  • Ruby
  • Tcl

The HeaderDoc tool set consists of the main utility, headerdoc2html, and gatherheaderdoc. The headerdoc2html tool generates a directory of either HTML (or optionally XML) files from the commented source files specified. Afterwards, the gatherheaderdoc utility may be executed to create a table of contents file for the documentation. Finally, the resolveLinks utility may be used to resolve cross-references between multiple documentation collections.

Apple's Xcode development environment contains features designed to assist the process of creating documentation using the HeaderDoc syntax and tools.

Additional Features

HeaderDoc has the following core features:

  • C preprocessing, allowing user-selected #define macros to alter the content, and allowing the user to pass command-line flags to ignore portions of the input.
  • Syntax coloring with user-defined styles.
  • Template-driven landing pages for indices.
  • Cross-platform (written mostly in Perl).

The HeaderDoc suite also includes several tools that may be used independently:

  • MPGL—a set of tools designed to simplify creation of UNIX manual pages using a lightweight XML syntax consisting of a subset of XHTML plus section tags, parameter tags, etc. HeaderDoc also provides a bridging tool that helps generate manual pages from header comments for functions via HeaderDoc's XML output mode.
  • resolveLinks—a tool that allows for rapid web site relinking when content moves to a different address through the use of embedded anchors and link requests.
  • filtermacros.pl—a tool that can be used to filter out sections of headers based on C preprocessor macros. This is currently available only by downloading the source tarball. As of HeaderDoc 8.9, this functionality is built into the headerdoc2html tool itself.

See also

{{Portal|Free and open-source software}}
  • Comparison of documentation generators
  • Standard interface documentation

External links

  • [https://developer.apple.com/legacy/library/documentation/DeveloperTools/Conceptual/HeaderDoc/intro/intro.html Legacy Documentation: HeaderDoc User Guide]
  • http://opensource.apple.com Latest version] (currently 8.9.28)
  • HeaderDoc mailing list (commonly used for getting help, patches, etc.)
{{programming-software-stub}}

1 : Free documentation generators

随便看

 

开放百科全书收录14589846条英语、德语、日语等多语种百科知识,基本涵盖了大多数领域的百科知识,是一部内容自由、开放的电子版国际百科全书。

 

Copyright © 2023 OENC.NET All Rights Reserved
京ICP备2021023879号 更新时间:2024/9/24 2:21:51