64.2.5 Documentation String Extraction

The utility etc/make-po scans the file DOC to extract documentation strings and creates a message file doc.po. This file may then be inserted within emacs.po.

Currently, make-po is hard-coded to read from DOC and write to doc.po. In order to extract documentation strings from an add-on package, first run make-docfile on the package to produce the DOC file. Then run make-po -p with the -p argument to indicate that we are extracting documentation for an add-on package.

(The -p argument is a kludge to make up for a subtle difference between pre-loaded documentation and add-on documentation: For add-on packages, the final carriage returns in the strings produced by make-docfile must be ignored.)