Just use CommandBox! No, really.
Installing and using DocBox consists of three main steps:
Alternatively, you can download the DocBox source code and drop it into a
docboxfolder in your application.
If DocBox is not installed in the root of your application, you will need to create a
docboxmapping that points to the DocBox source code location:
this.mappings[ "docbox" ] = expandPath( "./libraries/doctorBox" );
In addition to the Docbox mapping, you will need a Coldfusion server mapping for each source code location. For example, documenting a component with
implements="cbsecurity.interfaces.IAuthService"will require a mapping of
cbsecurityto the installed
cbsecuritysource code so DocBox can find the referenced interface.
The final step to get DocBox running is to write a CFML script which initializes, configures, and runs DocBox against your application code.
We also have a CommandBox module called DocBox Commands which enables generating documentation from the CLI.
box install commandbox-docboxto install the
docbox helpto get a list of commands
docbox generate helpto show help for the