NAME

vuepad - The HP VUE Text Editor .

SYNOPSIS

vuepad [file ...]

DESCRIPTION

The Vuepad program is a text editor for use within the X Window System environment.  The Text Editor allows the use of the mouse for moving the edit cursor and for selecting portions of text for editing operations.  The Text Editor also supports the HP VUE drag and drop, allowing the user to drag file icons from the HP VUE file manager onto the Text Editor window for editing. 
 
When started with no options, or with the -server option, the Text Editor can simultaneously display and edit many files.  Subsequent invocations of the Text Editor will cause the first running copy to open a new window editing the specified file.  If the original Text Editor cannot access the specified file directory, then the Text Editor process which sent the message will continue to run and will open its own window.  Only one Text Editor can be started with the -server option to a single X Display. 
 
The multi-window feature restricts the ability to change resources for a particular window.  Only Those resources listed below, with the exception of useMessaging and exitOnLastClose can be set (via command line options) for an individual Text Editor window.  If more control is required, the use of the -standAlone command line option will allow access to any and all normally exposed resources such as fontList or colors. 
 

OPTIONS

The following options are available from the command line

-session session file
This option takes the name of a session file as an additional parameter. The text editor is run with the specified session file name.  The session file is a file that was previously saved by the text editor through a session shutdown.  This option causes all other command line options to be ignored, as all settings are taken from the specified session file.

-noMessaging
This option forces the Text Editor to forego connecting to the BMS.  This will result in the Text Editor only displaying and editing a single file. In addition, the Text Editor is unable to support the dragging and dropping of files in this mode.  This is equivalent to setting the useMessaging resource to False. 

-standAlone
This option forces the Text Editor to ignore the presence of other running copies of the Text Editor but still connect to the BMS.  This can be useful if one desires an instance of the Text Editor with an environment different from that of other Text Editor windows.  An example would be running an instance under a different locale, or with different color resources. The Text Editor is able to support the dragging and dropping of files in this mode.  This is equivalent to setting the standAlone resource to True. 

-confirmationString String
Specifies a string to be put in a dialog box to ask the user a yes/no question immediately before exiting the editor.  This is typically used by an invoking program.  As an example, a mail program could use this resource to ask the user if they wish to send the message.  The user’s response to the dialog box determines the exit status of the Text Editor. A "Yes" response results in an exit status of 0, and a "No" response causes an exit status of 1.

-mainTitle String
Specifies the string to be used as the window title.  If this resource is non-NULL, then this string is combined with the current file name to form the window’s title.  The string is also used in the title of all dialogs displayed by the Text Editor.

-wordWrapOn
Specifies that the Word Wrap option in the Edit menu be enabled at start up. 

-noBlocking
Specifies that the Text Editor process terminate as soon as the server Editor signifies that it can edit a file in the referenced directory. In the absence of this option the Text Editor will block, waiting for notification from the server Editor indicating that the window has been closed.

-idString String
Specifies a string by which a particular Text Editor window can be referenced.  This allows subsequent invocations to reference the same idString and cause the Text Editor to change the contents of the referenced window.  This can be used by another program to provide a consistant "viewer" window. 

-server
Specifies that the Text Editor should run with no initial window displayed. In this mode the Text Editor waits for a message telling it to open a window editing a particular file.  The Broadcast Message Server (BMS) is normally configured to use this option to start the Text Editor.

RESOURCES.

The following table and descriptions define resources used to specify data for the vuepad program. 

blocking
Specifies that the editor should block waiting for the user to Exit or Close the window associated with this particular edit request.  Setting this resource False is equivalent to specifying the -noBlocking command line option. 

confirmationString
Specifies the string to be put in a dialog box to ask the user a yes/no question immediately before exiting the editor.  This is typically used by an invoking program.  As an example, the HP VUE mailer uses this resource to ask the user if they wish to send the message.  The user’s response determines the exit status of the Text Editor, with a "Yes" response resulting in an exit status of 0, and a no response resulting in an exit status of 1.

mainTitle
Specifies the string to be used as the window title.  If this resource is non-NULL, then the window’s title will not be updated when and if the user uses the "Open" menu item to edit a different file.  This is functionally equivalent to the -mainTitle command line option

session
Specifies the saved session file to use in restoring a previously saved Editor session.  This is functionally equivalent to the -session command line argument. 

useMessaging
Used by the HP VUE Lite configuration.  Setting this resource to True is equivalent to specifying the -noMessaging command line option. 

standAlone
Specifies whether the Text Editor should attempt to connect to an already running copy of the Editor. Setting this resource to True is equivalent to specifying the -standAlone command line option. 

wordWrapOn
Specifies whether the Text Editor should have word wrap enabled (True) or disabled (False) when the editor is started.  Setting this resource to True is equivalent to specifying the -wordWrapOn command line option. 

exitOnLastClose
Specifies whether the Text Editor process should terminate  when the last active edit window is closed.  If this resource is False, then Vuepad will continue to run, ready to receive a message to edit a file.  If this resource it True, the the Text Editor will terminate when the last active edit window is closed. 

COPYRIGHT

Copyright 1991, 1992 Hewlett-Packard Company. 

ORIGIN

Hewlett-Packard Company. 
 

  —  HP VUE 2.01 (9/91)