I personally use Text::Template when I am making lengthy POD documents. The big issue with an include for POD would be that it would have two modes of inclusion:
1- when including source code, you need to indent it at least one space so that it is considered verbatim source code 2- in other cases, the foreign text should be included as normal paragraph text. So you would have to have two args to include - filename + (program_code|paragraph_text), not to mention you would need to have to specify whether you are dealing with relative or absolute paths, which would mean some sort of -I option to include a set of paths to search for files in. By that time, we may as well have replaced POD with the Template Toolkit or something... hey not a bad idea! --
