man pages section 1: User Commands

Exit Print View

Updated: July 2014

lefty (1)


lefty - A Programmable Graphics Editor


lefty [ options ] [ file ]


User Commands                                            LEFTY(1)

     lefty - A Programmable Graphics Editor

     lefty [ options ] [ file ]

     lefty  is a two-view graphics editor for technical pictures.
     This editor has no hardwired knowledge about  specific  pic-
     ture   layouts  or  editing  operations.   Each  picture  is
     described by a program that contains functions to  draw  the
     picture and functions to perform editing operations that are
     appropriate  for  the  specific  picture.   Primitive   user
     actions,  like  mouse and keyboard events, are also bound to
     functions in this program. Besides the graphical view of the
     picture  itself,  the  editor presents a textual view of the
     program that describes the picture. Programmability and  the
     two-view  interface  allow the editor to handle a variety of
     pictures, but are particularly useful for pictures  used  in
     technical  contexts, e.g., graphs and trees. Also, lefty can
     communicate with other processes. This feature allows it  to
     use  existing  tools to compute specific picture layouts and
     allows external processes to use the editor as a  front  end
     to display their data structures graphically.

     The  file  name  is  optional. It may be -, for reading from
     standard input.  lefty uses two environment variables, LEFT-
     YPATH and LEFTYOPTIONS.  LEFTYPATH is a colon separated list
     of directories. When lefty tries to open a file, it searches
     that path for the file. When lefty tries to start up another
     process, it searches LEFTYPATH first, then the standard PATH
     variable.  LEFTYOPTIONS can be used to set specific options.
     Options specified on the command line override  options  set
     through this variable.

     -x   Instructs the editor to exit after processing file.

     -e <expression>
          <expression> is parsed and executed.

     -el <num>
          Set  error  reporting level. The default value is 0.  0
          never prints any messages.   1  prints  severe  errors,
          such as trying to return from a non function.  2 is the
          most useful: it reports function calls that  cannot  be
          executed,  either  because  there  is  no  function, or
          because of argument mismatches.  3 also warns about bad
          variable names.  4,5 warn about expressions that do not
          return a value. Only level 1 messages are real  errors.
          The  rest arise from legal lefty statements, but may be

SunOS 5.11                Last change:                          1

User Commands                                            LEFTY(1)

          caused by some logic errors.

     -sd <num>
          Specifies how much of the stack to show, when an  error
          message is to be printed. The default value is 2.  With
          0, no part of the stack is shown. With 1, only the  top
          stack  frame  is  printed.  With  2,  the full stack is

     -sb <num>
          Specifies how much of each function  in  the  stack  to
          show,  when  an  error  message  is  to be printed. The
          default value is 2.  With 0, no part of the function is
          shown.  With  1,  only  the  line  around  the error is
          printed. With 2, the full function body is printed.

     -df <string>
          Sets the default font. This font  is  used  whenever  a
          requested  font  cannot  be found. The string must be a
          legal X font. If string is '', lefty  will  draw  small
          boxes instead of text.

     -ps <file>
          Specifies  a  default  file  name for postscript files.
          This name is used when no name is specified in the cre-
          atewidget call. The default file name is

     -V   Prints the version.

     See   attributes(5)   for   descriptions  of  the  following

     |Availability   | image/graphviz   |
     |Stability      | Volatile         |
     lefty user guide.

     This  software  was   built   from   source   available   at    The  original
     community       source       was       downloaded       from

SunOS 5.11                Last change:                          2

User Commands                                            LEFTY(1)

     Further information about this software can be found on  the
     open source community website at

SunOS 5.11                Last change:                          3