File: critcl_introduction.man

package info (click to toggle)
critcl 3.1.9-1
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd, stretch
  • size: 8,608 kB
  • sloc: ansic: 54,882; tcl: 13,717; sh: 4,213; asm: 3,058; pascal: 2,758; ada: 1,681; cpp: 1,001; cs: 879; makefile: 310; perl: 104; xml: 95; f90: 10
file content (70 lines) | stat: -rw-r--r-- 2,444 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
[comment {-*- tcl -*- doctools manpage}]
[include version.inc]
[manpage_begin critcl_introduction 3tcl [vset VERSION]]
[include include/module.inc]
[titledesc {Introduction To CriTcl}]
[description]
[para]
[include include/welcome.inc]
[para]

CriTcl started life as an experiment by Jean-Claude Wippler and was a
self-contained Tcl package to build C code into a Tcl/Tk extension on
the fly. It was somewhat inspired by Brian Ingerson's [term Inline]
for [term Perl], but is considerably more lightweight.

[para]

It is for the last 5% to 10% when pure Tcl, which does go a long way,
is not sufficient anymore. I.e. for

[list_begin enumerated]
[enum] when the last bits of performance are needed,
[enum] access to 3rd party libraries,
[enum] hiding critical pieces of your library or application, and
[enum] simply needing features provided only by C.
[list_end]

[comment {
	Should I discuss the alternatives? And why they are not good?
}]

[para] The following sections first reference a few related documents
which may or may not be of interest to you, depending on if you are
just a plain user of the system, trying to get and build/install it,
or are going deep into the internals for either edification or
modification.

[para] This is followed by an introduction to the modes of operation
supported by the system, and its general architecture as seen by a
user.

[comment {===================================================================}]
[section {Related Documents}]
[list_begin enum]
[enum] [term {Critcl - License}].
[enum] [term {Using Critcl}]
[enum] [term {Critcl - How To Get The Sources}].
[enum] [term {Critcl - The Installer's Guide}].
[enum] [term {Critcl - Application Package Reference}]
[enum] [term {Critcl - Package Reference}]
[enum] [term {Critcl - The Developer's Guide}].
[list_end]

[comment {===================================================================}]
[section {Modes Of Operation/Use}]
[include include/modes.inc]

[comment {===================================================================}]
[section {System Architecture}]
[include include/architecture.inc]

[comment {===================================================================}]
[section {Examples}]
[include include/largeexampleref.inc]
[include include/smallexampleref.inc]

[comment {===================================================================}]
[include include/changes.inc]
[include include/feedback.inc]
[manpage_end]