XMAIL(1X11) COMMAND REFERENCE XMAIL(1X11) NAME xmail - mail user interface for UTek MH mail utilities SYNOPSIS xmail [ -display display ] [ -geometry geometry ] [ -ic ] DESCRIPTION The user interface xmail provides a X Window System-based user interface to the Rand MH mail utilities. When xmail is invoked, the main window appears. The panes which make up this window are as follows: +------------------------------------------------+ | main title pane (text)| +------------------------------------------------+ | mail operations pane (buttons)| +------------------------------------------------+ | folder operations pane (buttons)| +------------------------------------------------+ | | | message list pane (text)| | | +------------------------------------------------+ | message operations pane (buttons)| +------------------------------------------------+ | | | message pane (text)| | | +------------------------------------------------+ These panes are described in the following sections. USES Creating a Window Once xmail has been invoked there will be about a five second pause then an upper left corner cursor will appear on the screen. Position the cursor at the location you want xmail to appear, then click the left mouse button. There will be a pause of less than 20 seconds, then the xmail window will appear. The compose, forward, and reply windows are created using the same method. Buttons with '...' All buttons which are labeled with a word followed by a " ... " will display a prompt, menu, or list when selected. Buttons with NO '...' All buttons which have a single word as a label Printed 3/22/89 1
XMAIL(1X11) COMMAND REFERENCE XMAIL(1X11) will perform their action immediately after the button is selected. Notification of new mail The xmail program notifies you when new mail has come in. A window pops up with the label when new mail is found. By clicking the left mouse button on the 'yes' button of this window the mail will be incorporated. If the 'no' button is chosen, no action is taken. New mail is sought in the directory specified by the MAIL environment variable, or in /usr/spool/mail/username if MAIL is unset. The interval in seconds between checks for new mail may be specified in environment variable MAILFREQ. The default is 600. If MAILFREQ is set to 0, the user is not notified of new incoming mail. The title pane is the top pane. It contains a label indicating the current folder. The main title pane looks like this: +-------------------+----------------------------+ |current folder name| | +-------------------+----------------------------+ The mail operations pane is the second pane from the top. It contains six buttons and looks like this: +----+----------+---------+-------------+--------------+-------+ |quit|compose...|select...|[dflt folder]|preferences...|help...| +----+----------+---------+-------------+--------------+-------+ Click the left mouse button to select any of the buttons. quit button - exits xmail and returns the MH utilities to their default state. compose button - displays a new window (see the section titled COMPOSE) select button - displays a popup menu for selecting the current folder (see the section titled SELECT FOLDER) [dflt folder] - makes the default folder , namely the initial folder when xmail is run (usually inbox ), the current folder preferences button - displays a popup menu for editing mail configuration files Printed 3/22/89 2
XMAIL(1X11) COMMAND REFERENCE XMAIL(1X11) help button - uses the xhelp utility to display this man page FOLDER OPERATIONS The folder operations pane is the third from the top. It contains eight buttons and looks like this: +-------+----+-----+-----+-------+-------+-------+--------+ |delete.|inc |pack |pick.|rename.|rescan |search.|message.| +-------+----+-----+-----+-------+-------+-------+--------+ Clicking the left mouse button on some of the buttons will cause a prompter to appear. When the prompter appears you may o enter a new value, then click the ok button o click the ok button to accept the default value o click the cancel button to do nothing Actions associated with each button are as follows: delete button - deletes a folder and its contents. inc button - incorporates messages into a folder (using the inc(1) command). By default the new mail is incorporated into the 'inbox' folder. If the XMAILINCPROMPT environment variable is set, a prompt appears for the name of the folder to incorporate into. If XMAILINCPROMPT is not set but XMAILINCFOLDER is set, the new mail is incorporated into the folder whose name matches the value of XMAILINCFOLDER. pack button - renumbers the messages in the current folder (using the pack(1) command) pick button - selects a set of messages from a folder (see the section titled PICK ). rename button - changes the name of the current folder rescan button - forces a new list of messages for the current folder (using the scan(1) command) search button - finds a string in the message list pane (see the section titled SEARCH ) and shows the Printed 3/22/89 3
XMAIL(1X11) COMMAND REFERENCE XMAIL(1X11) message in the message pane. message button - finds a message by its message number and shows it in the message pane. The message list pane is the fourth pane from the top. It contains the output of the MH scan command. Each line represents a single message. The line is made up of the message number, the message date, the name of the person who sent the message, and a short description of the message contents (the subject line). The highlighted (selected) line is the current message. To select a new message just click the left mouse button on the line containing the message. The previous message is "unselected". To select more than one message, position the mouse cursor over the first line and press the left mouse button. move the mouse up or down until the mouse cursor is over the last line to be selected, then release the left mouse button. Use the pick button to select messages which are not sequential. Only the first message will be used for the next, prev, reply and show buttons when more than one message is selected. To scroll the message list either the scroll bar on the left (see the section titled SCROLL BARS ) or the editing movement commands (see the section titled EDITING) may be used. The message operations pane is the fourth from the top. It contains nine buttons and looks like this: +------+--------+-----+----+----+-----+------+-------+----+ |delete|forward.|move.|next|prev|print|reply.|search.|show| +------+--------+-----+----+----+-----+------+-------+----+ delete button - deletes the selected (highlighted) message(s). forward button - displays a compose window with the selected (highlighted) message(s) in it (see the section titled COMPOSE ). move button - prompts the user for a folder name to move the selected (highlighted) message(s) to. next button - shows the next message Printed 3/22/89 4
XMAIL(1X11) COMMAND REFERENCE XMAIL(1X11) prev button - shows the previous message print button - prints the selected (highlighted) message(s). reply button - displays a compose window configured to reply to the selected message (see the section titled COMPOSE ). As in the mh utility called repl, a link called @ is created to the message being replied to. Thus by including the file @ in your draft, you can include all or part of the message to which you are replying. search button - finds a string in the message pane (see the section titled SEARCH ). show button - shows the selected (highlighted) message The message pane is the bottom pane. It contains a copy of the selected (highlighted) message or a previously selected message. When a new message is selected due to an action of the program (as would happen if the user deleted or moved the previously selected message), the program updates the selected message. If the user selects a new message by clicking the mouse in the messagelist window, the show button must be clicked to see the newly selected message. To scroll the message either the scroll bar on the left (see the section titled SCROLL BARS ) or the editing movement commands (see the section titled EDITING) may be used. When the compose, forward, and reply buttons are pressed an editing window will appear. If the XMAILEDIT environment variable is not set, an xterm window running the appropriate UTek mh command: comp, forw, or repl will come up. If the XMAILEDIT environment variable is set, a window in which the X Window System Athena text widget editor is running comes up. This window contain three panes: title pane - identifies the window (clicking on the title iconifies this window) edit pane - allows the user to type in a message button pane - provides the means to send or save a message, get help, or cancel the compose. +--------------------------------+ | compose | +--------------------------------+ |To: | Printed 3/22/89 5
XMAIL(1X11) COMMAND REFERENCE XMAIL(1X11) |Cc: | |Subject: | |------- | | | | | | | | | | | | | | | | | +-------+-------+-------+--------+ |send...|save...|help...|cancel | +-------+-------+-------+--------+ In this case the xmail edit pane uses the X11 text widget editing commands. The help button displays a list of these editing commands. The list of editing commands can be found in the section titled EDITING. The mail header (To:, From:, Subject:) is taken from either a user's Mail/components or the /usr/lib/mh/componentsfile. The compose button pane has four buttons (click the left mouse button to select a button): send - sends the message save - saves the message in a file (you will be prompted for a file name) help - displays a new window describing the editing commands available in the compose editpane. cancel - returns to xmail destroying any text in the editpane. The pick button provides the user with a means of selecting messages by content. When the pick button is chosen a prompt appears. The user has the option of using the current folder or entering a different folder name. Click the ok button once the folder is selected, or click the cancel button to return to the xmail window. Once the ok button has been selected, the pick window appears. The pick window contains eleven panes and looks something like this: +--------------------------------------------------+ |--> Pick from these messages in folder foldername:| +--------------------------------------------------+ |All messages | +--------------------------------------------------+ |--> Pick messages with lines matching this pattern| Printed 3/22/89 6
XMAIL(1X11) COMMAND REFERENCE XMAIL(1X11) +--------------------------------------------------+ |Line beginning with From: < > | +--------------------------------------------------+ |" " To: < > | +--------------------------------------------------+ |" " Cc: < > | +--------------------------------------------------+ |" " Date: < > | +--------------------------------------------------+ |" " Subject:< > | +--------------------------------------------------+ |" " < >: < > | +--------------------------------------------------+ | < > anywhere in message | +----------+----------+---------+---------+--------+ |create |delete |move |print |cancel | +----------+----------+---------+---------+--------+ The first pane, "Pick from these messages in folder foldername:", refers to the second pane. In the second pane the user may enter individual message id numbers, ranges of message id numbers (using a dash character), or the default string "All messages". The third pane, "Pick messages with lines matching this pattern", refers to the next seven panes (all but the bottom pane). These panes are used to setup the criteria for selecting messages. Clicking the left button on any of these panes will display a prompt. The string the user types into the prompt will be searched for in the messages identified in the second pane. These panes are: From: - selects all messages which have the string in the From: line To: - selects all messages which have the string in the To: line Cc: - selects all messages which have the string in the Cc: line Date: - selects all messages which are were dated a specified date (the format of the date is " DD MMM " where DD is a two digit day and MMM is a three letter month abbreviation.) Subject: - selects all messages which have the string in the subject field < >: < > - selects all messages which have the second string Printed 3/22/89 7
XMAIL(1X11) COMMAND REFERENCE XMAIL(1X11) in the first string field (ex. the first string could be "Message-Id" and the second string could be "hammer") < > anywhere in message - selects all messages contain the string anywhere in the message (equivalent to grep). The last pane contains five buttons. The first four perform actions on the messages selected by the pick. The buttons are: Create: - creates a temporary folder named temporary containing the selected messages. The temporary folder becomes the current xmail folder. The temporary folder will be deleted when the user exits xmail. Use the rename button to save the contents of the temporary folder. Delete: - deletes the selected messages Move: - moves the selected messages to a folder. The user is prompted for the folder name. Print: - prints the selected messages Cancel: - return to the xmail window, ignoring any activity which occurred in the pick window. When the select button is chosen the user is asked to position a list of folders. The highlighted folder is the current folder. To select a different folder click the left mouse button on the new folder then click the left mouse button on the open button. If the folder is not visible use the scroll bar (see SCROLL BAR) or the editing movement commands (see EDITING). Click the cancel button to make the list disappear. There are two search buttons in xmail. The following tips should help in using them: o a regular expression may be used as the string o the search will wrap from the bottom of to the top of the message list or message. o the prompt remains visible until the cancel button is pressed. This allows the user to step through a series of searches by just pressing the ok button. o All editing commands are available when entering the string (see EDITING ). Along the left side of many of the xmail panes scroll bars will appear. The scroll bar Printed 3/22/89 8
XMAIL(1X11) COMMAND REFERENCE XMAIL(1X11) consists of three parts: slide region - a long narrow rectangle which represents all of the text (not just the page shown in text pane). thumb - a small rectangle inside the slide region. The thumb is controlled by pressing one of the mouse buttons and moving the mouse up and down. The thumb color is the inverse of the slide region's color. If the thumb is not visible all of the text is being displayed in the text pane. scroll cursors - there are four cursors which appear in the scroll bar depending on which mouse button is being pressed (see below). While the mouse cursor is in the scroll bar's slide region a double headed arrow cursor is visible. The mouse buttons control the movement of the thumb. The mouse buttons have the following effects: left button - scrolls the text up (the up cursor is displayed) middle button - positions the text (the right cursor is displayed) (ex. By placing the mouse cursor in the middle of the slide region, then clicking the middle mouse button, the text will be positioned so that the middle lines of text will be displayed in the text pane). Holding the middle button down while moving up and down the scrollbar allows the user to scroll up and down through the text. right button - scrolls the text down (the down cursor is displayed) The location of the mouse relative to the top and bottom of the slide region affects the left and right mouse actions. If the cursor is at the top of the slide region the text will scroll one line at a time. If the cursor is at the bottom of the slide region the text will scroll one page at a time. If the cursor is between the top and the bottom the text will scroll two to "page-1" lines depending upon the cursor's position. The following are the commands available while the user is in a text pane (message list pane; message pane; compose, forward, and reply edit panes, prompts). Printed 3/22/89 9
XMAIL(1X11) COMMAND REFERENCE XMAIL(1X11) -- CURSOR MOVEMENT -- <Ctrl>F forward character <Ctrl>B backward character <Meta>F forward word <Meta>B backward word <Ctrl>A beginning of line <Ctrl>E end of line <Ctrl>N next line <Ctrl>P previous line <Ctrl>V next page <Meta>V previous page <Ctrl>Z scroll one line up <Meta>Z scroll one line down Printed 3/22/89 10
XMAIL(1X11) COMMAND REFERENCE XMAIL(1X11) -- DELETION AND INSERTION -- <Ctrl>D delete next char <Ctrl>H delete previous char <Meta>D delete next word <Meta>H delete previous word <Meta>Y stuff <Ctrl>J newline and indent <Ctrl>O newline and backup <Ctrl>M newline <Ctrl>W kill selection <Ctrl>K kill to end of line shift<Meta>D kill word <Ctrl>Y unkill shift<Meta>H backward kill word <Meta>K kill to end of paragraph -- OTHER -- <Ctrl>L redraw display <Meta>I insert file -- TEXT SELECTION -- <BtnDown>left select start <PtrMoved>left extend adjust <BtnUp>left extend end <BtnDown>right extend start <PtrMoved>right extend adjust <BtnUp>right extend end The preferences button allows the user to edit the MH and X11 configuration files. The files available for editing are: ~/.mh_profile - the user's .mh_profile file Xresources - the user's resource file used by xrdb(1x11) to obtain client resources. If environment variable XMAILRESOURCES is set the user's home directory is searched for a file whose name matches the value of this variable. If XMAILRESOURCES is not set, the user is prompted for the name of a resources file to edit. If XMAILRESOURCES is set but no file by that name exists, it is created in the user's home directory. ~/Mail/components - the user's personal mail header (To:, From:, ....) (/usr/lib/mh/components is the system default) The usual client resource specifications may be used to customize the behavior of xmail. Here is one user's resource specification for xmail: xmail*Background: MediumGoldenrod xmail*Foreground: Salmon xmail*Text*font: pellucidatypewriter12 Printed 3/22/89 11
XMAIL(1X11) COMMAND REFERENCE XMAIL(1X11) xmail*iconX: 5 xmail*iconY: 106 xmail.Wm_option.autoRaise: on xmail.Wm_option.raiseDelay: 50 OPTIONS display - the display on which xmail will appear. geometry - the size and location of the xmail window. Default size is 820x820. ic - come up as an icon FILES ~/.mh_profile - the user's .mh_profile file /usr/lib/aliases - the system mail aliases file ~/Mail/components or /usr/lib/mh/components - the file which defines the mail header (To:, From:, ....) VARIABLES EDIT specifies the editor used for the preferences actions EDITOR specifies the editor used for the preferences actions if the EDIT variable does not exist. MAIL location of the user's incoming mail. Usually /usr/spool/mail/username, which is the default. MAILFREQ interval in seconds between checks for incoming mail. Default is 600. If set to 0, the user is not notified when new mail arrives. HOME the user's home directory DISPLAY the default X Window System display device XMAILEDIT specifies that the X Window System text widget edit window be used for the comply, forward, and reply actions. XMAILEDIT may be set to any value. XMAILINCFOLDER folder into which to incorporate new mail. Printed 3/22/89 12
XMAIL(1X11) COMMAND REFERENCE XMAIL(1X11) Ignored if XMAILINCPROMPT set. Default value is inbox. XMAILINCPROMPT if set, a prompt is popped up each time the 'inc' button is chosen, asking the user what folder to incorporate into XMAILRESOURCES name of user's X client resources file. If this file is not in the user's home directory, an absolute path must be given. CAVEATS This program is tightly bound to the UTek mh programs, which are derived from Rand MH version 1.7, and have been modified by Tektronix. Use in any other software environment will give unpredictable results. If editing is done using some editor other than the X editor and the user closes the xterm(1x11) window running the editor from outside the xmail program (as, for example, through use of the tekwm(1x11) "Window Operations" menu), the editor process will not be killed, and the xmail window may not disappear when the program exits. In this case, find the process number of the editor (with ps(1) ) and kill(1) it. SEE ALSO mh(1mh), mh_profile(5mh). Printed 3/22/89 13
%%index%% na:336,106; sy:442,553; de:995,3351;4754,4038;9200,3507;13115,4055;17578,3849;21835,3734;25977,2851;29236,4695;34339,3914;38661,436;39505,2593;42506,131; op:42637,550; fi:43187,450; va:43637,1877;45922,762; ca:46684,919; se:47603,166; %%index%%000000000268