CTAN Update: sty2dtx
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 (LaTeX package) to .dtx format (documented LaTeX 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.
Package | sty2dtx |
Version | 2.4 2022-10-18 |
Copyright | 2010–2022 Martin Scharrer |
Maintainer | Martin Scharrer |