FORGEBOX Enterprise 🚀 - Take your ColdFusion (CFML) Development to Modern Times! Learn More...

CommandBox DocBox Commands

v2.2.0+2 CommandBox Modules

DocBox Commands

DocBox Commands is a custom command you can install into CommandBox to generate API (reference) documentation from the commandline. For the main DocBox project, see DocBox on GitHub or the DocBox usage documentation.

LICENSE

Apache License, Version 2.0.

SYSTEM REQUIREMENTS

  • CommandBox 2.5+

Installation

Install the commands via CommandBox like so:

box install commandbox-docbox

Usage

Creates documentation for CFCs JavaDoc style via DocBox

You can pass the strategy options by prefixing them with strategy-. So if a strategy takes in a property of outputDir you will pass it as strategy-outputdir=

Examples:

docbox generate source=/path/to/coldbox mapping=coldbox excludes=tests strategy-outputDir=/output/path strategy-projectTitle="My Docs"

Multiple mappings may be specified, where the key is the mapping and the value is the source directory. For example, the following generates documentation for two different versions of a model:

docbox generate mappings:v1.models=/path/to/modules_app/v1/models mappings:v2.models=/path/to/modules_app/v2/models strategy-outputDir=/output/path strategy-projectTitle="My Docs"

Arguments:

  • strategy - The strategy class to use to generate the docs.
  • source - The directory containing the CFML source.
  • mapping - The base mapping for the source folder.
  • excludes - A regex that will be applied to the input source to exclude from the docs.
  • mappings:* - One or more dynamic parameters defining source and mapping. This argument will override source and mapping if provided.

CREDITS & CONTRIBUTIONS

I THANK GOD FOR HIS WISDOM FOR THIS PROJECT

THE DAILY BREAD

"I am the way, and the truth, and the life; no one comes to the Father, but by me (JESUS)" Jn 14:1-12

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.


Unreleased

2.2.0 - 2024-02-13

2.1.0 - 2024-02-13

Added

  • Bumped core DocBox to version 4.x

2.1.0 - 2024-02-13

Added

  • Updated to new module layout
  • Updated all dependencies
  • Migration to Github Actions

[v2.0.0] => 2021-FEB-22

Added

  • Upgraded to DocBox v3
  • Code Quality updates
  • Automated testing, code quality and s3 binaries

[v1.0.0] => 2018-AUG-3

  • Initial creation of separate CommandBox project

$ box install commandbox-docbox

No collaborators yet.
     
  • {{ getFullDate("2016-01-18T23:17:24Z") }}
  • {{ getFullDate("2024-02-13T20:21:20Z") }}
  • 6,103
  • 108,628