#!lesml@en$
## SPDX-FileCopyrightText: 2026 Lady <https://www.ladys.computer/about/#lady>
## SPDX-License-Identifier: CC-BY-SA-4.0

⁌ 🧮🖍 Codemark

☞︎A documentation generator.☜︎

The goal of 🧮🖍 Codemark is to make it easy to convert source files
  in various programming languages into {🔗LesM·L
  files<https://git.ladys.computer/LesML>} which document them.
This is done “simply”; i·e with shell scripting and the programs
  already installed on your (Posix‐compliant) computer.
The broader intention is that this can serve as a component in a
  Make‐based documentation generation program for a repository of
  various files.

§ Usage

»|sh$ sh ./sh/codemark.sh [--] [source_file] [syntax]

• If `source_file´ is not provided, it is taken to be `-´ (standard
  input).

• If `syntax´ is not provided, it is taken from the file extension of
  `source_file´.

The makefile in `make/documentation.make´ provides an example (minimal)
  build system which makes use of the 🧮🖍 Codemark script.

§ Description

The vast majority of markup capabilities are provided by Sed programs,
  which are run on source files and whose output is the result.
Each source format supports a syntax for “documentation comments”,
  which are essentially unwrapped and treated as the main Les·M·L text
  of the file.
The remaining lines are formatted as preformatted text according to the
  conventions described in `PROFILE.lesml´.

With·in a documentation comment, source text in any supported syntax
  `SYNTAX´ may be quoted using the line leader `»|SYNTAX$ ´.

Supported syntaxes are exactly those which have corresponding files in
  the `sed/SYNTAXES´ directory in this repository, plus the special
  format `lesml´.