The smart_insert_category_elements function fills the array arr with a list of element names for the Smart Insert category defined in the document type configuration file (.dcf) for the document type associated with doc. These category elements are used in the Insert Markup dialog box when Smart Insert is turned on. If doc is omitted or 0, the current document is used.

The function returns an array containing the element names in the order in which they are declared in the .dcf file. The function also returns the number of entries in the array. The first entry is stored at index 1.