CTAN Comprehensive TeX Archive Network

CTAN Update: sty2dtx

Date: February 2, 2011 6:54:12 PM CET
On Wed, 2 Feb 2011 Martin Scharrer submitted an update to the sty2dtx package. License type: lppl Announcement text:
Changelog: * Better handling of code comments: - Comments direct before a macro or environment definition are now placed inside the corresponding description environment before `\begin{macrocode}`. - Separate comment lines stay as they are and will be normal text in the .DTX file. - Commented text inside definitions will cause the `macrocode` environment to be interrupted and reopened afterwards. - Code lines which are commented out (i.e. are indented and there is no space after the '%' sign) will stay as part of the macro code. * Added '-c' (generate code section only) option. This resembles the output of v1.0 and is useful to insert more code into exisiting .DTX files. * Config files can now include comment lines as well. These lines must start with '%' or '#'.
This package is located at http://mirror.ctan.org/support/sty2dtx . More information is at http://tug.ctan.org/info/?id=sty2dtx (if the package is new it may take a day for that information to appear). We are supported by the TeX Users Group http://www.tug.org . Please join a users group; see http://www.tug.org/usergroups.html . Thanks for the upload. For the CTAN Team Rainer Schöpf

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

The package provides a Perl script that converts a .sty file ( package) to .dtx format (documented source), by surrounding macro definitions with macro and macrocode environments. The macro name is automatically inserted as an argument to the macro environemnt.

Code lines outside macro definitions are wrapped only in macrocode environments. Empty lines are removed.

The script should not be thought to be fool proof and 100% accurate but rather as a good start to the business of making a .dtx file from an undocumented style file.

Full .dtx files are generated. A template based on the skeleton file from 'dtxtut' is used. User level macros are added automatically to the 'Usage' section of the .dtx file. A corresponding .ins file can be generated as well.

Copyright2010–2011 Martin Scharrer
MaintainerMartin Scharrer



Guest Book Sitemap Contact Contact Author