The texp Reference Manual

Table of Contents

The texp Reference Manual

This is the texp Reference Manual, generated automatically by Declt version 3.0 "Montgomery Scott" on Mon Apr 19 18:00:25 2021 GMT+0.

1 Introduction

texp

Description:

texp is a domain specific language for producing TeX documents with Common Lisp.

Documentation:

• Manual
• API documentation

2 Systems

The main system appears first, followed by any subsystem dependency.

2.1 texp

Author

Max Rottenkolber <max@mr.gy>

License

GNU Affero General Public License

Description

DSL for outputting TeX expressions using S-expressions.

Dependency

named-readtables

Source

texp.asd (file)

Components

• texp.lisp (file)
• syntax.lisp (file)

3 Files

Files are sorted by type and then listed depth-first from the systems components trees.

3.1 Lisp

3.1.1 texp.asd

Location

texp.asd

Systems

texp (system)

3.1.2 texp/texp.lisp

Parent

texp (system)

Location

texp.lisp

Packages

texp

Exported Definitions

• *escape-table* (special variable)
• deftex (macro)
• escape (function)
• tex (macro)

Internal Definitions

• compile-break (function)
• compile-expression (function)
• compile-expressions (function)
• compile-interpolation (function)
• compile-macro-call (function)
• compile-newline (function)
• compile-parameters (function)
• compile-parenthesized (function)
• compile-with-braces (function)
• compile-with-brackets (function)
• escape-char (function)
• escape-p (function)
• make-parameter-string (function)
• symbol-identifier (function)

3.1.3 texp/syntax.lisp

Dependency

texp.lisp (file)

Parent

texp (system)

Location

syntax.lisp

Internal Definitions

parenthesized-list-reader (function)

4 Packages

Packages are listed by definition order.

4.1 texp

DSL for outputting _TeX_ expressions using S-expressions.

Source

texp.lisp (file)

Use List

• editor-hints.named-readtables
• common-lisp

Exported Definitions

• *escape-table* (special variable)
• deftex (macro)
• escape (function)
• tex (macro)

Internal Definitions

• compile-break (function)
• compile-expression (function)
• compile-expressions (function)
• compile-interpolation (function)
• compile-macro-call (function)
• compile-newline (function)
• compile-parameters (function)
• compile-parenthesized (function)
• compile-with-braces (function)
• compile-with-brackets (function)
• escape-char (function)
• escape-p (function)
• make-parameter-string (function)
• parenthesized-list-reader (function)
• symbol-identifier (function)

5 Definitions

Definitions are sorted by export status, category, package, and then by lexicographic order.

5.1 Exported definitions

5.1.1 Special variables

Special Variable: *escape-table*

*Description:*

_Alist_ mapping _TeX_ special characters to quoted equivalent.

Package

texp

Source

texp.lisp (file)

5.1.2 Macros

Macro: deftex NAME PARAMETERS &body FORMS

_parameters_::= {(}{{}_var_{\}}\*{)}

*Arguments and Values:*

_name_—a _symbol_ or _string_.

_forms_—_forms_.

_var_—a _symbol_.

*Description:*

{deftex} prints the definition of a _TeX_ macro with _name_ that expands to _forms_ to {*standard-output*}. If _name_ is a _symbol_ it will be printed in lower case. _Forms_ are evaluated as if by {tex} with each _var_ in _parameters_ bound to a numeric _TeX_ parameter identifier.

*Examples:*

#code#
(deftex hello (name) "Hello " ($ name))
▷ \def \hello #1{Hello #1}
#

Package

texp

Source

texp.lisp (file)

Macro: tex &rest EXPRESSIONS

_expressions_::= ↓_expression_\*

_expression_::= ↓_break-clause_ | ↓_interpolation-clause_ | ↓_brackets-clause_ | ↓_braces-clause_ | ↓_tex-clause_ | _literal_

_break-clause_::= {(br)}

_interpolation-clause_::= {($} _form_{)}

_brackets-clause_::= {([]} {{}_expression_{\}}\*{)}

_braces-clause_::= {({\}} {{}_expression_{\}}\*{)}

_tex-clause_::= {(} _tex-macro_ {{}_expression_{\}}\*{)}

*Arguments and Values:*

_literal_—a _string_, _symbol_ or _number_.

_form_—a _form_.

_tex-macro_—a _symbol_ or a _string_.

*Description:*

{tex} compiles _TeX expressions_ to {*standard-output*}.

A _Literal_ is printed as follows:

+ a _string_ is printed as it is
+ a _symbol_ is printed in lower case
+ a _number_ is printed _readably_

A _tex-clause_ prints a _TeX_ macro call of _tex-macro_ followed by _expressions_.

A _break-clause_ prints two newlines (e.g. a paragraph separator).

An _interpolation-clause_ evaluates _form_ and prints its result if the result is a _string_.

_Bracket-clause_ and _braces-clause_ print _expressions_ surrounded by brackets ({[}, {]}) and braces ({{}, {\}}) respectively. If the _readtable_ {texp:syntax} is used then _bracket-clause_ and _braces-clause_ can be written as {[} _expression_\* {]} and {{} _expression_\* {}}.

Package

texp

Source

texp.lisp (file)

5.1.3 Functions

Function: escape STRING

*Arguments and Values:*

_string_—a _string_.

*Description:*

{escape} encodes _string_ as defined by {*escape-table*}. E.g. it quotes _TeX_ special characters.

Package

texp

Source

texp.lisp (file)

5.2 Internal definitions

5.2.1 Functions

Function: compile-break ()

Print double newline.

Package

texp

Source

texp.lisp (file)

Function: compile-expression EXPRESSION

Compile _TeX_ EXPRESSION.

Package

texp

Source

texp.lisp (file)

Function: compile-expressions EXPRESSIONS

Compile _TeX_ EXPRESSIONS.

Package

texp

Source

texp.lisp (file)

Function: compile-interpolation EXPRESSION

Interpolate EXPRESSIONS into the TEX macro.

Package

texp

Source

texp.lisp (file)

Function: compile-macro-call NAME &rest ARGUMENTS

Compile call to macro with NAME and ARGUMENTS.

Package

texp

Source

texp.lisp (file)

Function: compile-newline ()

Print explicit newline.

Package

texp

Source

texp.lisp (file)

Function: compile-parameters PARAMETERS

Returns a map of PARAMETERS to _TeX_ macro parameter pointers of the form ’#<N>’ and a parameter string for _TeX_’s \\def.

Package

texp

Source

texp.lisp (file)

Function: compile-parenthesized OPEN CLOSE EXPRESSIONS

Compile EXPRESSIONS parenthesized by OPEN and CLOSE.

Package

texp

Source

texp.lisp (file)

Function: compile-with-braces EXPRESSIONS

Compile EXPRESSIONS parenthesized by braces.

Package

texp

Source

texp.lisp (file)

Function: compile-with-brackets EXPRESSIONS

Compile EXPRESSIONS parenthesized by brackets.

Package

texp

Source

texp.lisp (file)

Function: escape-char CHARACTER

Return escaped string for CHARACTER.

Package

texp

Source

texp.lisp (file)

Function: escape-p CHARACTER

Predicate to test if CHARACTER needs to be escaped.

Package

texp

Source

texp.lisp (file)

Function: make-parameter-string N

Make parameter string for N parameters.

Package

texp

Source

texp.lisp (file)

Function: parenthesized-list-reader TYPE CLOSE

Return read macro function for parenthesized list terminated by CLOSE. It will be consed with TYPE.

Package

texp

Source

syntax.lisp (file)

Function: symbol-identifier SYMBOL

Return identifier string for SYMBOL.

Package

texp

Source

texp.lisp (file)

Appendix A Indexes

A.1 Concepts

A.2 Functions

A.3 Variables

A.4 Data types