Main Content

slreportgen.report.DocBlock.customizeReporter

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

Create custom DocBlock reporter class

Since R2019b

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

expand all

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

ValueDescription
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

expand all

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

Examples

expand all

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 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