summaryrefslogtreecommitdiff
path: root/support/lametex/man/man1/lametex.1
blob: a0a574cf76f16c639fabbe74bb6cbd04df3a99d6 (plain)
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
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
.TH lametex 1
.SH NAME
lametex \- The LameTeX Text Formatting System
.SH SYNOPSIS
.nf
lametex [ -p file ] [ -d directory ] [ -t ] yourtexfile.tex
.fi
.SH DESCRIPTION
LameTeX is a text formatting program that understands much of the LaTeX
text formatting language. However, because LameTeX is not built on TeX
macros, it is free to do whatever it pleases directly with PostScript.

You can use LameTeX to format text on a page of arbitrary shape. For
example, you could place text inside a circle shape, or a triangle, or
a picture of a big duck.

The -p option allows you to set the default page shape by specifying a
postscript file.

The -d option allows you to add additional directories that LameTeX
should search in to find PostScript files.  LameTeX searches it's own
"src" postscript directory, the current directory, and any directories
you have defined in an environment variable path LAMETEX_PS_PATH.

The -t option specifies that LameTeX should make a plain textfile
output. LameTeX should not make PostScript output.

There is also an extensive facility for you to add your own PostScript
additions to make your documents look extra-spiffy. You don't have to know
much PostScript to this.

The directory /cs/src/lametex/page contains LameTeX page descriptions,
many of them spiffy. There is also page_latex.ps which emulates LaTeX
without any flashy special effects.

The documentation is in /cs/src/lametex/doc/lametex_doc.ps, which you
can try formatting yourself with either LameTeX or LaTeX from
/cs/src/lametex/doc/lametex_doc.tex. To view the PostScript documentation
file type "/cs/bin/gnu/gs /cs/src/lametex/doc/lametex_doc.ps".

There are lots of examples, especially of the cool stuff. The documentation
will step you through it no problem.

.SH WHY USE IT?
LameTeX is a fancy toy, and a lot of fun. If that's not reason enough,
don't use it! Take a peek at the fancy pictures, at least. Who knows?
You might find a real application for it.

The author, jgm@cs.brown.edu is around for
quick tips and advice, and would love to hear what cool stuff you've 
done with the program.

.SH LAMETEX SPECIAL STEALTH COMMANDS

\\stealth  \-    Allows LameTeX to execute commands inside the comments.
You must do \\begin{stealth} and \\end{stealth}. You cannot just say
\\stealth.

\\postscript  \-    All text in this environment gets dumped directly in
the PostScript output.  You must say \\begin{postscript} and
\\end{postscript}.

\\includeps  \-    Includes a PostScript file in the current position in
the PostScript output.

\\pspage  \-    Registers a new Page Description to be loaded upon
encountering the next page break (a Page Description is in some
PostScript file).

\\ignore  \-    Do a \\begin{ignore} to tell LameTeX to ignore everything
until it sees \\end{ignore}. Use this to include fancy LaTeX commands
in your document that LameTeX cannot handle. You cannot just use
\\ignore.

\\pscmd  \-    Registers a PostScript command to be executed in this exact
place in the word fitting and word printing routines.

\\STEALTH  \-    Defines a stealth environment to the end of the line. You
must do \\STEALTH.  You cannot say \\begin{STEALTH}.

.SH SUPPORTED LATEX COMMANDS

.nf
\\#
\\$
\\%
\\&
\\Huge
\\LARGE
\\Large
\\\\
\\\\_
\\addtolength
\\backslash
\\begin
\\bf
\\bigskip
\\center
\\chapter
\\chapter*
\\clearpage
\\description
\\document
\\documentstyle
\\em
\\end
\\enumerate
\\flushleft
\\flushright
\\footnotesize
\\hspace
\\hspace*
\\huge
\\include
\\it
\\item
\\itemize
\\label
\\large
\\ldots
\\medskip
\\newlength
\\newline
\\normalsize
\\par
\\paragraph
\\paragraph*
\\part
\\part*
\\quotation
\\quote
\\raggedleft
\\raggedright
\\ref
\\rm
\\sc
\\scriptsize
\\section
\\section*
\\setlength
\\sf
\\sl
\\small
\\smallskip
\\subparagraph
\\subparagraph*
\\subsection
\\subsection*
\\subsubsection
\\subsubsection*
\\tiny
\\today
\\tt
\\verse
\\vspace
\\vspace*
\\{
\\}
.fi

.SH BUGS
There are no bugs in LameTeX. However, style points are being awarded
by this author for finding interesting ways of making LameTeX emulate
a bug. There is a section in the documentation which discusses LameTeX's
(ahem) limitations.

.SH AUTHORS
Jonathan Monsarrat
.fi