The smart_insert_categories function fills the array arr with the list of Smart Insert category names defined in the document type configuration file (.dcf) for the document type associated with doc. These categories 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 category names in alphabetical order. The function also returns the number of entries in each array. The first entry is stored at index 1.