Tutorialsg-client



Prev | Up | Next | Back | Forward | Online Documentation Home Page

SYNOPSIS

       sg-client [X toolkit options] [options]

DESCRIPTION

       Sg-client  is  a  utility  for sending messages to editors
       generated using the Synthesizer Generator, including  Ada-
       ASSURED.   It may be used to start up an editor if none is
       found.

       The script is broadcast to editors using the display  that
       sg-client  is connected to using the X property mechanism.
       Tags are used to direct the message to particular  invoca-
       tions  of  editors.  If a tag is defined, then the message
       is sent to all editors that match the tag.  Undefined tags
       are matched by all editors.

       The  combined length of all options to sg-client should be
       less than 1000 characters.

OPTIONS

       Sg-client accepts all the normal X toolkit options as well
       as the following:

       -command script
               Send  script  to  the  editor for execution.  This
               must be a valid script in  the  editors  scripting
               language.

       -command0 script
               An alternate script to send to the editor for exe-
               cution whenever an editor is started.   This  must
               be  a  valid  script in the editors scripting lan-
               guage.

       The following four options allow definition of the tags:

       -instance name
               The instance name of the editor.

       -class class-name
               The class name of the editor. Only for X  version.

       -service service-name
               The service name of the editor. Only for Microsoft
               Windows version.

       -pid process-id
               The process id of the editor.  See ps(1).

       -user username
               The name of the user who has invoked the editor.

CUSTOMIZATION

       Sg-client defines the following application resources.

       instance (String)
               Specifies the instance tag.

       class (String)
               Specifies the class tag.

       pid (String)
               Specifies the process id tag.

       command (String)
               Specifies the script to send to the editor.

       command0 (String)
               Specifies  the  alternate (startup only) script to
               send to the editor.

       startCommand (String)
               Specifies the command to use to start up the  edi-
               tor.

EXAMPLE

       The  following  example instructs Ada-ASSURED to issue the
       message "Hello, world.".  If not found then it is  invoked
       using the executable at /u0/Ada-ASSURED/bin/aa95.

       sg-client -instance aa95 -command 'Write_message("Hello, world.");' \\
           -startup /u0/Ada-ASSURED/bin/aa95


       The  following  resource  settings set the above values as
       defaults:

       sg-client.instance: aa95
       sg-client.class: SynthesizerGenerator
       sg-client.startCommand: /u0/Ada-ASSURED/bin/aa95
       sg-client.command: Write_message("Hello, world.");

ENVIRONMENT

       DISPLAY To  get  the  default  host,  display  number, and
               screen.

SEE ALSO

       X(1).

       Ada-ASSURED User Guide & Reference Manual
       Part No. AA-RM-3.5, GrammaTech, Inc.,  317 N. Aurora  St.,
       Ithaca, NY 14850.
       Tel: +1 607 273 7340
       Fax: +1 607 273 8752

Forward