Natural Docs 1.35

Natural Docs is an open-source documentation generator for multiple programming languages. You document your code in a natural syntax that reads like plain English. Natural Docs then scans your code and builds high-quality HTML documentation from it.<br /><br />Features<br />Source Documentation<br />Natural, Readable Syntax<br />Natural Docs???*a*? syntax is designed to be very natural looking, almost transparent. The comments in the source code read just as easily as the generated documentation.<br /><br />Multiple Languages<br />Natural Docs supports nineteen programming languages out of the box, even within the same project. It supports CGI and extensionless files because it can determine their language by their shebang lines.<br /><br />Add Your Own Language<br />If your programming language isn???*a*?t already included with Natural Docs, you can add support for it just by editing a configuration file. Even the most obscure language can have a powerful documentation generator.<br /><br />All or Just Explicit Documentation<br />Depending on your level of language support, you can choose between having Natural Docs document everything or only what you documented, which makes it suitable for generating API references.<br />*<br />Javadoc Compatibility<br />Natural Docs can read most Javadoc comments, so if you???*a*?re already invested in that style you don???*a*?t have to convert your old documentation.<br /><br />Flexible Keywords<br />Natural Docs has many keywords for each of its topic types so you can use whatever???*a*?s most natural to you. You can also customize the existing ones or add your own.<br /><br />Custom Topics and Indexes<br />If you???*a*?d like to document some facet of your code that Natural Docs doesn???*a*?t know about * maybe it???*a*?s something particular to your language or project * you can create your own topic type and keywords for it. Natural Docs will even build it it???*a*?s own index.<br />Lists<br /><br />Natural Docs offers an abbreviated syntax for documenting large groups of small items, like constants. Each one becomes linkable as if it had its own topic.<br /><br />Generated Output<br />Attractive Documentation<br />Unlike most generated documentation, Natural Docs???*a*? output looks professional by default. There are different styles to choose from, or you can make one yourself.<br /><br />Powerful CSS Structure<br />Natural Docs has a powerful, well documented CSS structure that allows full customization. Although the default styles don???*a*?t always show it off, you can do things like have links to functions be one style and links to classes be another. You can even have browser-specific styles in a single CSS file to work around rendering quirks.<br /><br />Framed or Unframed HTML<br />It???*a*?s your documentation so it???*a*?s your choice. You can keep every page be independent and easily linkable, or you can keep the menu in a separate frame for easier navigation.<br />*<br />Search, No Server Required<br />Natural Docs???*a*? search is done entirely in DHTML, so there???*a*?s no server software to set up. Just upload the documentation to your web site and it works. It also works if you???*a*?re just looking at a private copy on your hard drive<br /><br />Tooltips Everywhere<br />Every link to every documented topic has its summary as a tooltip. Links to functions and variables have their fully formatted protoypes in the tooltips as well.<br /><br />Ignore Prefixes in the Index<br />Common prefixes don???*a*?t have to ruin your indexes. If all your classes start with C, or if you have a bunch of functions that start with COM_, you can have Natural Docs ignore them so CCat, CDog, and CMouse appear in C, D, and M instead of all under C.<br /><br />Program<br />Differential Build Process<br />Natural Docs only builds the files that have been changed or added since its last run and the files that depend on them, dramatically reducing run time and making it suitable for larger projects.<br /><br />Extensible Architecture<br />Natural Docs is designed to be easily extended for different programming languages, topics, and CSS styles, all of which are documented on this site.<br /><br />Portable<br />Natural Docs runs anywhere Perl runs, and that???*a*?s quite a lot of places.<br />*<br />Intelligent Configuration Files<br />Natural Docs detects changes you make to the configuration files and will handle the smaller details itself. They automatically reformat so you can make quick-and-dirty edits and still maintain readability. If a change requires everything to be rebuilt, it will do so automatically when it runs.<br /><br />Free and Open<br />Natural Docs is licensed under the GPL, so there???*a*?s no charge and you can fiddle with the source to your heart???*a*?s delight.

Requirements:	No special requirements
Platforms:	Windows, Mac, *nix, Mac OSX, Linux, Perl , BSD Solaris
Keyword:	Developer Tool,  Documentation,  Documentation Generator,  Generator,  Html,  Html Documentation
Users rating:	0/10