Main Content

builddocsearchdb

Build searchable documentation database

Description

builddocsearchdb(folder) builds a searchable database, also referred to as a search index, from HTML files in the specified folder.

The builddocsearchdb function creates a subfolder, helpsearch-v4, to contain the database files. The database enables MATLAB® to search for content within the HTML files assuming the MATLAB version is the same version used to create the database.

example

Examples

collapse all

Build a search database for custom help files.

The Upslope Area Toolbox is a sample toolbox used for demonstrating how to create a custom toolbox and supporting documentation. The upslope toolbox folder included with this example contains a file named info.xml, which is required to display custom documentation, and a subfolder named html, which contains HTML documentation and supporting files.

Create a search database for the Upslope Area Toolbox.

addpath("upslope")
folder = fullfile("upslope","html");
builddocsearchdb(folder);
Removing existing index directory at upslope\html\helpsearch-v4_en
Process Duration: 0.004826
Successfully created search database.

Open your system web browser and navigate to the MathWorks® documentation home page. Search for the term tarboton, which appears in several of the example help files. The search returns the results in the MathWorks documentation.

On the left side of the page, under Refine by Source, select Supplemental Software to view the results for the Upslope Area Toolbox.

Input Arguments

collapse all

Full path to a folder with HTML files, specified as a character vector. The folder must be:

  • On the MATLAB search path

  • Outside the matlabroot folder

  • Outside any installed Hardware Support Package help folder

To include a particular HTML document in the search database, the builddocsearchdb function requires that:

  • The document has a title.

  • The content is different from the title.

Example: builddocsearchdb('c:\myfiles\html')

Version History

Introduced in R2007a

expand all