CTAN Comprehensive TeX Archive Network

Directory macros/latex/contrib/codedescribe

README.md

codedescribe / codelisting

These are expl3 based packages for /expl3 code documetation.

codedescribe

provides a series of macros/environments (similar to doc/docx/doc3) for package/classes documentantion

codelisting

provides a few macros for code listing/demo.

They are designed to be 'as class independent as possible', no assumption about underline macros is made. Furthermore, it's assumed that maketitle and the abstract environment were modified by the underline class, so alternatives (based on the article class) are provided.

For more details, see the documentation, codedescribe.pdf


Requirements

  • none besides a fairly recent distribution as recent as 2022/06/01

(with the new in kernel ProcessKeyOptions and NewDocumentCommand)

Installation

The stable version is available at CTAN.

Usage

Stable version

Just place

  \usepackage{codedescribe}

in the preamble and compile away.

Be aware that options might change between versions, so you have to check them manually.

More Information and documentation

More Information can be found in the documentation; you can find a "bleeding edge" version at the github page

Contacting Author

For bug reports and enhacement suggestions, the preferred way is to use the project's issue page. Please be ready to provide an example code showing the bug, if any.

Please do not use the issue page for generic help on how to use the package.


Copyright 2023-present by Alceu Frigeri

This work may be distributed and/or modified under the conditions of

This work has the LPPL maintenance status maintained.

The Current Maintainer of this work is Alceu Frigeri


## This work consists of the files

  • codelisting.sty
    • set of macros to typeset and demonstrate code
  • codedescribe.sty
    • set of macros to document packages
  • README.md (this file)
    • quick introduction
  • codedescribe.tex
    • package documentation
  • codedescribe.pdf
    • documentation in PDF format

Changelog

  • Version 1.4 (this)
    • The 'new', 'update' and 'info' keys can, now, be used multiple times when declaring a codedescribe environment. (see documentation).
  • Version 1.3
    • Added tsresult, a command to just show the result of a stored code (codelisting specific).
  • Version 1.2
    • Added of format key: basicstyle
  • Version 1.1
    • Added two commands to allow <obj-types> customization
      • requiring (now) pifont for EXP/rEXP <format-keys>
      • Added a date command (auxiliary command)
  • Version 1.0
    • Initial release by CTAN

Download the contents of this package in one zip archive (248.6k).

codedescribe – code description and documentation

This package aims to document both document level (i.e. final user) commands, as well package/class level commands. It is fully implemented using expl3 syntax and structures, in particular l3coffins, l3seq and l3keys. Besides those the scontents and listing packages are used to typeset code snippets.

Packagecodedescribe
Bug trackerhttps://github.com/alceu-frigeri/codedescribe/issues
Repositoryhttps://github.com/alceu-frigeri/codedescribe
Version1.4 2024-02-17
LicensesThe Project Public License 1.3c
GNU General Public License
Copyright2023–2024 Alceu Frigeri
MaintainerAlceu Frigeri
Contained inTeX Live as codedescribe
MiKTeX as codedescribe
TopicsDocumentation support
Experimental 3
...
Guest Book Sitemap Contact Contact Author