sty2dtx – Create a .dtx file from a .sty file

The pack­age pro­vides a Perl script that con­verts a .sty file (LaTeX pack­age) to .dtx for­mat (doc­u­mented LaTeX source), by sur­round­ing macro def­i­ni­tions with macro and macrocode en­vi­ron­ments. The macro name is au­to­mat­i­cally in­serted as an ar­gu­ment to the macro en­vi­ronemnt.
Code lines out­side macro def­i­ni­tions are wrapped only in macrocode en­vi­ron­ments. Empty lines are re­moved.
The script should not be thought to be fool proof and 100% ac­cu­rate but rather as a good start to the busi­ness of mak­ing a .dtx file from an un­doc­u­mented style file.
Full .dtx files are gen­er­ated. A tem­plate based on the skele­ton file from 'dtx­tut' is used. User level macros are added au­to­mat­i­cally to the 'Usage' sec­tion of the .dtx file. A cor­re­spond­ing .ins file can be gen­er­ated as well.