Unicon documentation

This page indexes manuals, technical reports, and HTML shipped under doc/ in the source tree. Paths are relative to doc/.

On the web: the Unicon project site hosts a Books page and a Technical Reports index with downloads and mirrors for many of the same works.

Programming with Unicon
The Icon Programming Language Implementation
Unicon Technical Reports (UTRs)
- Unicode reference data (for UTF-8 / UTR work)
Other documentation
Building PDFs from LaTeX

Programming with Unicon

LaTeX source for the book Programming with Unicon. See also the site’s Books page for published editions and related titles.

README — LaTeX build notes and TeX package dependencies
*.tex sources — book manuscript (no standalone .html / .md in-tree)

Location in tree: doc/book/.

The Icon Programming Language Implementation

Implementation-oriented LaTeX (parts 1–3, appendices) for The Icon Programming Language Implementation.

*.tex sources — full manuscript (no .html / .md / .txt in-tree)

Location in tree: doc/ib/.

Unicon Technical Reports (UTRs)

Numbered project reports (UTR #1, UTR #2, …). HTML, PDF, and office exports may live under doc/utr/, doc/unicon/, or doc/udb/ depending on age and format. The Technical Reports page on unicon.sourceforge.io lists reports with links to PDFs/HTML on unicon.org and elsewhere.

Standard Markdown tables use equal column widths, so a narrow “#” column still wastes space. Each report below is one line: UTR #N — format links — title.

UTR #1 — HTML — An ODBC Interface for the Unicon Programming Language
UTR #2 — PDF — iflex: A Lexical Analyzer Generator for Icon
UTR #3 — PDF — iyacc: A Parser Generator for Icon
UTR #4 — HTML — Writing CGI and PHP Scripts in Icon and Unicon
UTR #5 — PDF, OpenDocument — The Implementation of Graphics in Unicon (V10 PDF; V12 internals in ODT UTR-5b)
UTR #6 — HTML, HTML (Word export), fragment — An IVIB Primer (header.htm is a small fragment; main body is utr6.html)
UTR #7 — HTML — Version 13.1 of Unicon for Microsoft Windows
UTR #8 — HTML, PDF — Unicon Language Reference
UTR #9 — HTML, PDF — Unicon 3D Graphics User’s Guide and Reference Manual
UTR #10 — HTML (utr), HTML (udb), PDF, Word — Debugging With UDB
UTR #11 — HTML — Unicon Manual Page
UTR #12 — HTML — UI: a Unicon Development Environment
UTR #13 — OpenDocument — The Unicon Messaging Facilities
UTR #14 — Word — Unicon Threads User’s Guide and Reference Manual
UTR #21 — HTML — Configuring and Building Version 13 of Unicon

Unicode reference data (for UTF-8 / UTR work)

Machine-readable tables in doc/utr/utf8/:

UnicodeData.txt — Unicode character database
CaseFolding.txt — case-folding mappings
SpecialCasing.txt — special-casing rules
utf8info.txt — UTF-8 / Unicon notes

Other documentation

General Unicon pages

Pages that are not a single numbered UTR (guides, indexes, examples).

File	Title / purpose
faq.html	Unicon: Frequently Asked Questions
posix.html	Unicon: A Posix Interface for the Icon Programming Language
reports.html	Technical Reports — in-tree index; see also the project site Technical Reports
svn.html	Unicon Source Code SVN Repository — legacy (SVN; development uses Git today)
simple.html, simp.html	A Simple Example — Using the CGI Icon Library

Location in tree: doc/unicon/.

Icon 9.3 legacy

Inherited Icon Project documents (IPDs), FAQs, and manual pages.

Index

README — lists IPDs and manual pages

HTML

File	Title
faq.htm	Frequently Asked Questions about the Icon programming language
ipd266.htm	An Overview of the Icon Programming Language; Version 9
ipd281.htm	Graphics Facilities for the Icon Programming Language; Version 9.3
ipd283.htm	The Icon Program Library; Version 9.3.3

PDF — manual pages

icon.1.pdf — icon(1) — Icon interpreter/compiler
icon_vt.1.pdf — icon_vt(1) — variant translator

PDF — Icon Project Documents (IPD)

ipd046.pdf — Trouble report form
ipd112.pdf — Version 8.0 implementation differences
ipd177.pdf — Supporting documentation for XPM
ipd193.pdf — Support Procedures for Icon Program Monitors
ipd237.pdf — Version 9 compiler
ipd238.pdf — Configuring the Version 9 source code
ipd239.pdf — Version 9 implementation differences
ipd240.pdf — Calling C functions
ipd241.pdf — Version 9 benchmark report
ipd243.pdf — Installing Version 9 on UNIX platforms
ipd244.pdf — Icon 9 UNIX Manual Page (icon, icont, iconc)
ipd245.pdf — Variant translators
ipd246.pdf — Icon 9 Variant Translator UNIX Manual Page (icon_vt)
ipd256.pdf — Version 9 UNIX user’s manual
ipd261.pdf — RTL manual
ipd263.pdf — Building source-code processors for Icon
ipd265.pdf — Visual interface builder
ipd266.pdf — An Overview of the Icon Programming Language; Version 9
ipd271.pdf — Version 9 of Icon for Microsoft Windows
ipd278.pdf — Version 9.3 language features
ipd279.pdf — Version 9.3 Icon program library
ipd280.pdf — Icon glossary
ipd281.pdf — Graphics Facilities for the Icon Programming Language; Version 9.3
ipd283.pdf — The Icon Program Library; Version 9.3.3

Location in tree: doc/icon/.

UDB — Unicon debugger

Overview of the source-level debugger. Full treatment of debugging is UTR #10 in Unicon Technical Reports (UTRs) above.

index.html — UDB: The Unicon Source-Level Debugger (overview)

Location in tree: doc/udb/.

Building PDFs from LaTeX

The book, implementation book, and UTR LaTeX trees have Makefile targets. From the repository root:

make -C doc/book
make -C doc/ib
make -C doc/utr

See each directory’s Makefile for targets and prerequisites.