slreportgen.report.DocBlock.customizeReporter

Class: slreportgen.report.DocBlock
Namespace: slreportgen.report

Create custom DocBlock reporter class

Syntax

reporter = slreportgen.report.DocBlock.customizeReporter(classpath)


Description

reporter = slreportgen.report.DocBlock.customizeReporter(classpath) creates a class definition file that defines a subclass of slreportgen.report.DocBlock at the location specified by classpath. The method also copies the default reporter templates to the resources/templates subfolder of the folder that contains the class definition file. You can use the class definition file as a starting point to design a custom DocBlock reporter class for your report.

Input Arguments

classpath — Path and name of new class definition file

string scalar | character vector

Path and name of the new class definition file, specified as a string scalar or character vector.

Value	Description
slreportgen.report.DocBlock.customizeReporter("myFolder/MyClass")	Create MyClass.m in the subfolder myFolder of the current folder.
slreportgen.report.DocBlock.customizeReporter("myFolder/@MyClass")	Create the reporter class in a class folder by preceding the class name with the @ character. Do not specify the .m extension. See Folders Containing Class Definitions.
slreportgen.report.DocBlock.customizeReporter("+myOrg/@MyClass")	Create the reporter class in a class namespace by preceding the folder name with the + character.

Note

You can specify a relative path or an absolute path.

Data Types: string | char

Output Arguments

reporter — Path and file name of new reporter class

string scalar

Path and file name of the new reporter class, returned as a string scalar.

Examples

Create Custom DocBlock Reporter

Create a custom DocBlock reporter, MyDocBlock, and its associated default templates in the subfolder MyFolder of the current working folder.

slreportgen.report.DocBlock.customizeReporter('MyFolder/MyDocBlock')

ans = 

    "MyFolder\MyDocBlock.m"

After editing this new class file, you can use it as your DocBlock reporter.

rptr = MyDocBlock();

Create Custom DocBlock Reporter in a Class Folder Inside a Namespace Folder

Create a custom DocBlock reporter and its associated default templates in a class folder that is a subfolder of a namespace folder.

slreportgen.report.DocBlock.customizeReporter("+MyNamespace/@MyDocBlock")

ans = 

    "+MyNamespace\@MyDocBlock\MyDocBlock.m"

After editing this new class file, you can use it as your DocBlock reporter.

rptr = MyNamespace.MyDocBlock();

Version History

Introduced in R2019b