~ubuntu-branches/ubuntu/lucid/graphviz/lucid-security

« back to all changes in this revision

Viewing changes to lefty/lefty.1

  • Committer: Bazaar Package Importer
  • Author(s): Stephen M Moraco
  • Date: 2002-02-05 18:52:12 UTC
  • Revision ID: james.westby@ubuntu.com-20020205185212-8i04c70te00rc40y
Tags: upstream-1.7.16
ImportĀ upstreamĀ versionĀ 1.7.16

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.TH LEFTY 1
 
2
.SH NAME
 
3
lefty \- A Programmable Graphics Editor
 
4
.SH SYNOPSIS
 
5
.B lefty
 
6
[
 
7
.I options
 
8
] [
 
9
.I file
 
10
]
 
11
.SH DESCRIPTION
 
12
.B lefty
 
13
is a two-view graphics editor for technical pictures. This editor has
 
14
no hardwired knowledge about specific picture layouts or editing operations.
 
15
Each picture is described by a program that contains functions to draw the
 
16
picture and functions to perform editing operations that are appropriate for
 
17
the specific picture. Primitive user actions, like mouse and keyboard events,
 
18
are also bound to functions in this program. Besides the graphical view of the
 
19
picture itself, the editor presents a textual view of the program that
 
20
describes the picture. Programmability and the two-view interface allow the
 
21
editor to handle a variety of pictures, but are particularly useful for
 
22
pictures used in technical contexts, e.g., graphs and trees. Also,
 
23
.B lefty
 
24
can communicate with other processes. This feature allows it to use existing
 
25
tools to compute specific picture layouts and allows external processes to use
 
26
the editor as a front end to display their data structures graphically.
 
27
.SH USAGE
 
28
The file name is optional. It may be
 
29
.BR - ,
 
30
for reading from standard input.
 
31
.B lefty
 
32
uses two environment variables,
 
33
.B LEFTYPATH
 
34
and
 
35
.BR LEFTYOPTIONS .
 
36
.B LEFTYPATH
 
37
is a colon separated list of directories. When
 
38
.B lefty
 
39
tries to open a file, it searches that path for the file. When
 
40
.B lefty
 
41
tries to start up another process, it searches
 
42
.B LEFTYPATH
 
43
first, then the standard
 
44
.B PATH
 
45
variable.
 
46
.B LEFTYOPTIONS
 
47
can be used to set specific options. Options specified on the command line
 
48
override options set through this variable.
 
49
.SH OPTIONS
 
50
.TP
 
51
.B -x
 
52
Instructs the editor to exit after processing
 
53
.BR file .
 
54
.TP
 
55
.B "-e <expression>"
 
56
.B <expression>
 
57
is parsed and executed.
 
58
.TP
 
59
.B -el <num>
 
60
Set error reporting level. The default value is
 
61
.BR 0 .
 
62
.B 0
 
63
never prints any messages.
 
64
.B 1
 
65
prints severe errors, such as trying to return from a non function.
 
66
.B 2
 
67
is the most useful: it reports function calls that cannot be executed, either
 
68
because there is no function, or because of argument mismatches.
 
69
.B 3
 
70
also warns about bad variable names.
 
71
.B 4,5
 
72
warn about expressions that do not return a value. Only level
 
73
.B 1
 
74
messages are real errors. The rest arise from legal
 
75
.B lefty
 
76
statements, but may be cased by some logic errors.
 
77
.TP
 
78
.B "-sd <num>"
 
79
Specifies how much of the stack to show, when an error message is to be
 
80
printed. The defualt value is
 
81
.BR 2 .
 
82
With
 
83
.BR 0 ,
 
84
no part of the stack is shown. With
 
85
.BR 1 ,
 
86
only the top stack frame is printed. With
 
87
.BR 2 ,
 
88
the full stack is printed.
 
89
.TP
 
90
.B "-sb <num>"
 
91
Specifies how much of each function in the stack to show, when an error message
 
92
is to be printed. The default value is
 
93
.BR 2 .
 
94
With
 
95
.BR 0 ,
 
96
no part of the function is shown. With
 
97
.BR 1 ,
 
98
only the line around the error is printed. With
 
99
.BR 2 ,
 
100
the full function body is printed.
 
101
.TP
 
102
.B "-df <string>"
 
103
Sets the default font. This font is used whenever a requested font cannot be
 
104
found. The string must be a legal X font. If string is
 
105
.BR "''" ,
 
106
.B lefty
 
107
will draw small boxes instead of text.
 
108
.TP
 
109
.B "-ps <file>"
 
110
Specifies a default file name for postscript files. This name is used when no
 
111
name is specified in the
 
112
.B createwidget
 
113
call. The default file name is
 
114
.BR out.ps .
 
115
.TP
 
116
.B -V
 
117
Prints the version.
 
118
.SH SEE ALSO
 
119
.I lefty
 
120
user guide.