DOCUMENT ID: 1496-02

SYNOPSIS:    Adding extra buttons to Mailtool 

OS RELEASE:  2.x

PRODUCT:     Solaris x86

KEYWORDS:    button mail mailtool extra


DESCRIPTION:

How to add extra mailtool buttons


SOLUTION:

Mailtool allows just 4 button positions to be customized.  Many
additional buttons may be added using these procedures.  The focal point
is the "~/.mailrc" file.  Inspection of the file contents will yield the
four customizable button definitions.  A typical sample might be:

 #-button 1 0 "Done" done
 #-button 1 1 "Next" nextMessage
 #-button 1 2 "Delete" deleteMessage
 #-button 1 3 "Reply" replyMenu

The entries are changed by the "edit button" "Properties" function hence
the contents of "~/.mailrc" file a voitile below the lines:

 # mailtool defaults from prop sheet 
 # PLEASE MAKE ALL YOUR CHANGES ABOVE THESE 2 LINES

This may seem obvious however the fact is often overlooked.  The anatomy
of a button definition line will be examined using:

 #-button a b "ccc" ddd

 "a" row number, rows start at zero
 "b" column number, columns start at zero
 ccc button caption
 ddd mailtool internal reference token

The first three items may arbitrarily selected with minor restrictions. 
Row zero columns 1 through 4 are dedicated and row 1 columns 1 through 4
are subject to change by the "properties" function.  The caption length
should be kept small. 


Item 4 "ddd" must be selected from this table.

  ----------------------------------------------------------------------
  |typical caption | token                   | definition              |
  ======================================================================
  | AbbvHdr        | abbreviatedHeader       | Limit header contents   |
  | Copy           | copyMessage             | copy a message          |
  | Cut            | cutMessage              | cut a message           |
  | Delete         | deleteMessage           | delete a message        |
  | Done           | done                    | reorganize current file |
  | Find           | findButton              | search by criteria      |
  | Foward         | fowardMessage           | foward message          |
  | FullHdr        | fullHeader              | complete header contents|
  | MailFiles      | mailfiles               | show mail files         |
  | Messages       | viewMessages            | Messages                |
  | New            | composeNew              | popup compose window    |
  | Next           | nextMessage             | foward one message      |
  | Previous       | previousMessage         | backup one message      |
  | Properties     | properties              | properties sheet        |
  | Reply          | replyMenu               | reply menu              |
  | Reply          | replySender             | reply to sender         |
  | ReplyAI        | replyAllInclude         | reply to all include    |
  | ReplyAll       | replyAll                | reply to all            |
  | ReplyInc       | replySenderInclude      | reply sender include    |
  | Save           | saveChanges             | save changes to mail    |
  | Sort           | sortMenu                | display sort by menu    |
  | SortMsgNo      | sortByMsgno             | sort By Message Number  |
  | SortSize       | sortBySize              | sort By Size            |
  | SortSndr       | sortBySender            | sort By Sender          |
  | SortStatus     | sortByStatus            | sort By Status          |
  | SortSubj       | sortBySubject           | sort By Subject         |
  | SortTime       | sortByTimeAndDate       | sort By Time & Date     |
  | Undelete       | undeleteLastMessage     | restore last message    |
  | Undelete       | UndeleteMenu            | Undelete menu           |
  | Vacation       | vacationMenu            | vacation menu           |
  ----------------------------------------------------------------------

  References:

  Mailtool manual page
  Internal mailtool source code 


DATE APPROVED: 09/05/95