home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / x / volume15 / xmail / part02 / HelpText.c next >
C/C++ Source or Header  |  1991-10-29  |  18KB  |  410 lines
  1. /*
  2.  * xmail - X window system interface to the mail program
  3.  *
  4.  * Copyright 1990,1991 by National Semiconductor Corporation
  5.  *
  6.  * Permission to use, copy, modify, and distribute this software and its
  7.  * documentation for any purpose is hereby granted without fee, provided that
  8.  * the above copyright notice appear in all copies and that both that
  9.  * copyright notice and this permission notice appear in supporting
  10.  * documentation, and that the name of National Semiconductor Corporation not
  11.  * be used in advertising or publicity pertaining to distribution of the
  12.  * software without specific, written prior permission.
  13.  *
  14.  * NATIONAL SEMICONDUCTOR CORPORATION MAKES NO REPRESENTATIONS ABOUT THE
  15.  * SUITABILITY OF THIS SOFTWARE FOR ANY PURPOSE.  IT IS PROVIDED "AS IS"
  16.  * WITHOUT EXPRESS OR IMPLIED WARRANTY.  NATIONAL SEMICONDUCTOR CORPORATION
  17.  * DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED
  18.  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  IN NO
  19.  * EVENT SHALL NATIONAL SEMICONDUCTOR CORPORATION BE LIABLE FOR ANY SPECIAL,
  20.  * INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
  21.  * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
  22.  * OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  23.  * PERFORMANCE OF THIS SOFTWARE.
  24.  *
  25.  * Author:  Michael C. Wagnitz - National Semiconductor Corporation
  26.  *
  27.  */
  28.  
  29. #include    "global.h"
  30.  
  31.  
  32. String    Autograph_Info[] = {
  33.         "Append your 'Sign'ature (if any) to the message text",
  34.         "Append your 'sign'ature (if any) to the message text",
  35.         NULL
  36.         };
  37.  
  38. String    Copy_Info[] = {
  39.                 "Copy the selected message to the specified folder",
  40.                 "Copy the message to a folder named for it's author",
  41.                 NULL
  42.                 };
  43.  
  44. String    Default_Status_Info = "Use <Shift><Middle-Mouse-Button> for help on any window";
  45.  
  46. String    Delete_Info[] = {
  47.                 "Delete the currently selected message",
  48.                 "Undelete the selected or most recently deleted message",
  49.                 NULL
  50.                 };
  51.  
  52. String    Deliver_Info[] = {
  53.         "Deliver this message",
  54.         "Re-edit this message",
  55.         "Cancel the request but save the text in the dead letter file",
  56.         "Abort this request and discard the text",
  57.         NULL
  58.         };
  59.  
  60. String    Folder_Info[] = {
  61.         "Access the specified folder, or select from the list",
  62.         "Copy this folder name to the fileWindow",
  63.         "Copy the folder path to the fileWindow or view the next level",
  64.         NULL
  65.         };
  66.  
  67. String    Hold_Info[] = {
  68.                 "Preserve the selected message in the system folder",
  69.                 NULL
  70.                 };
  71.  
  72. String    NewMail_Info[] = {
  73.                 "Re-read your system mail folder",
  74.                 "Incorporate new mail without committing any current changes",
  75.                 "Make xmail refresh the folder list next time it's displayed",
  76.                 NULL
  77.                 };
  78.  
  79. String    Print_Info[] = {
  80.                 "Print the selected message on the system printer",
  81.                 NULL
  82.                 };
  83.  
  84. String    Quit_Info[] = {
  85.                 "Quit xmail",
  86.                 "Leave xmail without committing any current changes",
  87.                 NULL
  88.                 };
  89.  
  90. String    Read_Info[] = {
  91.                 "Read the current message",
  92.                 "Read the next message",
  93.                 "Read the previous message",
  94.                 "Read the current message, and include full mail headers",
  95.                 NULL
  96.                 };
  97.  
  98. String    Reply_Info[] = {
  99.                 "Reply to the author of the message",
  100.                 "Reply to the author of, and include the message text",
  101.                 "Include all recipients of the original message in your reply",
  102.                 "Include all recipients, and the text, of this message",
  103.                 NULL
  104.                 };
  105.  
  106. String    Save_Info[] = {
  107.                 "Save the selected message in the specified folder",
  108.                 "Save the message in a folder named for it's author",
  109.                 "Write the message to the folder, but don't include headers",
  110.                 NULL
  111.                 };
  112.  
  113. String    Send_Info[] = {
  114.                 "Compose and send a new mail message",
  115.                 "Forward a copy of the selected mail message",
  116.                 NULL
  117.                 };
  118.  
  119. String    SendMail_Info[] = {
  120.         "Specify the name(s) of the recipient(s)",
  121.         "Enter the subject of this message",
  122.         "Specify the names of any carbon copy recipients",
  123.         "Enter the names of any blind carbon copy recipients",
  124.         NULL
  125.         };
  126.  
  127. String Abort_Help = "\n\n\n\n\n\n\
  128.  Pressing the \"Abort\" button cancels delivery of the\n\
  129.  message, and deletes any text that may have been created.";
  130.  
  131. String    Bcc_Help = "\n\
  132.  Specify any blind carbon copy recipients for this message\n\
  133.  using the Bcc: window.  Blind carbon recipient names are\n\
  134.  removed from the message prior to delivery.\n\n\
  135.  Pressing the right mouse button in this window displays\n\
  136.  a list of your aliases.  Releasing the right mouse\n\
  137.  button while one of the alias names is highlighted\n\
  138.  copies that name into the window, preceding it with a\n\
  139.  comma if necessary.\n\n\
  140.  Standard editing functions associated with the text widget\n\
  141.  are supported, and can be altered using the application\n\
  142.  resources.";
  143.  
  144. String Cancel_Help = "\n\n\n\n\n\
  145.  Pressing the \"Cancel\" button causes delivery of this\n\
  146.  message to be abandoned, but saves a copy of the message\n\
  147.  text in your dead letter file (default $HOME/dead.letter)\n\
  148.  without any header information.";
  149.  
  150. String    Cc_Help = "\n\n\
  151.  Specify carbon copy recipients for this message using the\n\
  152.  Cc: window.  Multiple recipients should be comma separated.\n\n\
  153.  Pressing the right mouse button in this window displays a\n\
  154.  list of your aliases.  Releasing the right mouse button\n\
  155.  while one of the alias names is highlighted copies that\n\
  156.  name into this window, preceded with a comma if needed.\n\n\
  157.  Standard editing functions associated with the text widget\n\
  158.  are supported, and can be altered using the application\n\
  159.  resources.";
  160.  
  161. String    Copy_Help = "\n\
  162.  Pressing this button copies the current message to the\n\
  163.  file or folder named in the File: window, without marking\n\
  164.  the original for removal.  (If a folder name is not\n\
  165.  specified, it will be copied to your mbox folder.)\n\n\
  166.  The right mouse button pops up a menu for both the copy\n\
  167.  and Copy commands.\n\n\
  168.  The uppercase (Copy) command copies the message to a file\n\
  169.  whose name is derived from the author of the message,\n\
  170.  rather than from any name currently in the File: window.\n\n\
  171.  See also the save command help for additional information.";
  172.  
  173. String    Delete_Help = "\
  174.  Pressing this button removes the selected message from the\n\
  175.  current folder.\n\n\
  176.  The right mouse button displays a menu for both the delete\n\
  177.  and undelete commands.\n\n\
  178.  Undelete restores the selected message (if it has been\n\
  179.  marked 'D'eleted), otherwise the deleted message with the\n\
  180.  smallest message number is restored.\n\n\
  181.  Undelete may be used repeatedly to restore all deleted\n\
  182.  messages if changes have not yet been committed.\n\n\
  183.  See also preserve, save, folder, Newmail, and quit.";
  184.  
  185. String    Deliver_Help = "\n\n\n\n\n\
  186.  The Deliver button will send the composed message text\n\
  187.  to your sendmail daemon for delivery to the specified\n\
  188.  recipient(s).";
  189.  
  190. String    File_Help = "\n\
  191.  The File: window provides a mechanism for specifying a\n\
  192.  file or folder name for use by other xmail commands.\n\n\
  193.  Text entered beyond the right margin of the window will\n\
  194.  cause a horizontal scrollbar to appear, for scrolling the\n\
  195.  displayed text to the left or right as needed for viewing.\n\n\
  196.  Pressing the backspace or delete key erases a previously\n\
  197.  entered character.  Control_W (^W) erases a previous word\n\
  198.  and Control_U (^U) the entire line.\n\n\
  199.  See the folder and save commands for more information.";
  200.  
  201. String    Folder_Help = "\
  202.  The left button changes the active folder to the one\n\
  203.  specified in the File: window.  Changing folders COMMITs\n\
  204.  any modifications to the current folder.\n\n\
  205.  The right button brings up a menu of folders from which\n\
  206.  to choose.  Clicking the left button on a directory\n\
  207.  (indicated by trailing slash) while still holding down\n\
  208.  the right, expands that directory if it has files.\n\
  209.  Releasing the right button copies the selected name to\n\
  210.  the File: window.\n\n\
  211.  The current menu can be erased (to include new folders\n\
  212.  created since the menu was last generated) by using the\n\
  213.  Drop option, provided in the Newmail command button menu.";
  214.  
  215. String    Hold_Help = "\n\
  216.  The Preserve command marks the selected message for\n\
  217.  retention in the system mailbox.  Normally when a message\n\
  218.  is 'saved' to some other folder file, it is automatically\n\
  219.  deleted from your system folder.  'Preserve' causes mail\n\
  220.  to not remove the original from your system mail folder.\n\n\
  221.  Pressing the right mouse button on the Preserve command\n\
  222.  presents a menu of three mail (and one xmail) settings\n\
  223.  that may be toggled while currently operating in xmail.\n\n\
  224.  Commands listed denote what state each variable will be\n\
  225.  changed to, if the appropriate label is highlighted when\n\
  226.  the right mouse button is released.";
  227.  
  228. String    Index_Help = "\
  229.  The index window displays a list of mail messages in the\n\
  230.  current folder, as well as the currently selected message.\n\n\
  231.  Pressing the left mouse button anywhere on a line marks\n\
  232.  the message as selected (for other commands) but does not\n\
  233.  automatically display the message in the text window.\n\n\
  234.  Pressing the right button selects and also automatically\n\
  235.  displays the message.\n\
  236.  See also the read command help for additional information.\n\n\
  237.  The index window header list may be scrolled using either\n\
  238.  the scrollbar and mouse or keyboard keys.  See the Text\n\
  239.  window help for a description of the keys supported.";
  240.  
  241. String    NewMail_Help = "\
  242.  The Newmail button will be highlighted with a hatching\n\
  243.  pattern whenever new mail has arrived for your account.\n\n\
  244.  Pressing the NewMail button accesses your system folder\n\
  245.  (if mail exists) and includes any new mail delivered\n\
  246.  since the last time your system folder was accessed.\n\
  247.  This action also resets any button highlighting, and\n\
  248.  COMMITS any changes that may have been made to the\n\
  249.  current folder.  (Confirmation provided if not expert.)\n\n\
  250.  The right mouse button provides a menu for committing\n\
  251.  changes, incorporating new messages without committing\n\
  252.  changes (only if currently in your system folder), or\n\
  253.  causing xmail to redetermine the list of mail folders.";
  254.  
  255. String    Print_Help = "\n\n\n\
  256.  Pressing this button causes the selected message to be\n\
  257.  printed on the system printer.\n\n\
  258.  A message will be displayed in the status window\n\
  259.  indicating which message was printed, along with its\n\
  260.  size in bytes.\n\n\
  261.  See also the Index window for help on selecting a message.";
  262.  
  263. String    Quit_Help = "\n\n\
  264.  quit - terminates xmail, committing changes made to the\n\
  265.  current folder.\n\n\
  266.  The right mouse button pops up a menu for the quit and\n\
  267.  exit commands.\n\n\
  268.  Use exit when you wish to leave xmail without committing\n\
  269.  the current folder's changes.\n\n\
  270.  See also the folder, Newmail, and delete commands.";
  271.  
  272. String    Read_Help = "\n\
  273.  Pressing this button causes the selected message to be\n\
  274.  displayed in the text (bottom) window.\n\n\
  275.  Current message selection is indicated by caret (>) in\n\
  276.  the index (top) window.\n\n\
  277.  The right mouse button displays a menu for reading the\n\
  278.  current message, reading the next or previous message,\n\
  279.  or reading the selected message with full headers (this\n\
  280.  overrides any suppression of normally ignored fields).\n\n\
  281.  See also the Index window help for more information.";
  282.  
  283. String ReEdit_Help = "\n\n\n\n\n\
  284.  Use the ReEdit selection to perform additional changes\n\
  285.  to the current message composition.  When completed, you\n\
  286.  will again be presented with the send completion menu.";
  287.  
  288. String    Reply_Help = "\n\n\
  289.  reply - initiates the mechanism to create and send a mail\n\
  290.  message to the author of a current message.\n\n\
  291.  The right mouse button displays a menu for selecting\n\
  292.  'reply', 'reply included', 'replyall' (which addresses all\n\
  293.  recipients of the original mail), or 'replyall included'.\n\
  294.  The include options automatically copy the original\n\
  295.  message into the new one.\n\nSee also the Send command.";
  296.  
  297. String    Save_Help = "\n\
  298.  save - copies a message to the file or folder named in\n\
  299.  the File: window, marking the original for deletion.\n\
  300.  If none is specified, the name in your environment MBOX\n\
  301.  is used ($HOME/mbox by default).\n\n\
  302.  The right button pops up a menu of related commands.\n\n\
  303.  A written (vs. copied) message does not include mail\n\
  304.  headers or trailing blank line.\n\n\
  305.  Uppercase commands create a file named from the author of\n\
  306.  the message, rather than any name in the File: window.";
  307.  
  308. String    Send_Help = "\n\
  309.  send - initiates the mechanism to create and send a\n\
  310.  message to the designated recipient(s).  The right mouse\n\
  311.  button displays a menu which provides the choice of\n\
  312.  'send'ing, or 'forwarding a message'.  Forwarding includes\n\
  313.  the text of the current message in the new one.\n\n\
  314.  As with the 'reply' command, a dialog box is provided to\n\
  315.  specify the name of the recipient(s), subject, and to whom\n\
  316.  to send copies of this message.  Pressing the 'Deliver'\n\
  317.  button completes the operation.\n\n\
  318.  See also the reply command help for additional information.";
  319.  
  320. String    Sign_Help = "\n\n\n\
  321.  Pressing this Autograph button will append your .mailrc\n\
  322.  defined 'Sign'ature (uppercase 'S') text to the current\n\
  323.  message composition, replacing any backslash-'n' character\n\
  324.  combinations (\\n) found in it with true newline characters.\n\
  325.  (See the Mail(1) man page for details on defining a Sign.)\n\n\
  326.  If your .mailrc does not contain a Sign definition, xmail\n\
  327.  will look for a .Signature file in your home directory,\n\
  328.  appending its contents, if any, to the current composition.";
  329.  
  330. String    sign_Help = "\n\n\n\
  331.  Pressing this autograph button will append your .mailrc\n\
  332.  defined 'sign'ature (lowercase 's') text to the current\n\
  333.  message composition, replacing any backslash-'n' character\n\
  334.  combinations (\\n) found in it with true newline characters.\n\
  335.  (See the Mail(1) man page for details on defining a sign.)\n\n\
  336.  If your .mailrc does not contain a sign definition, xmail\n\
  337.  will look for a .signature file in your home directory,\n\
  338.  appending its contents, if any, to the current composition.";
  339.  
  340. String    Status_Help = "\n\n\n\
  341.  The Status window displays xmail program info, status, and\n\
  342.  error messages.\n\n\
  343.  Error messages usually cause the terminal bell to ring, to\n\
  344.  attract the user's attention.\n\n\
  345.  The BELL can be disabled, by either including the command\n\
  346.  line option -nb, or by specifying the '*bellRing' resource\n\
  347.  as False.";
  348.  
  349. String    Subject_Help = "\n\n\
  350.  The Subject: window provides a method for specifying the\n\
  351.  subject for this mail message.\n\n\
  352.  Text entered beyond the right margin of the window will\n\
  353.  cause a horizontal scrollbar to appear, for scrolling the\n\
  354.  displayed text to the left or right as needed for viewing.\n\n\
  355.  Pressing the backspace or delete key erases a previously\n\
  356.  entered character, while Control_W (^W) erases a previous\n\
  357.  word and Control_U (^U) to the beginning of the line.";
  358.  
  359. String    Text_Help = "\
  360.  The text window displays the currently selected message.\n\
  361.  See the Index window help on how to select a message.\n\n\
  362.  Text and index windows may be scrolled using either the\n\
  363.  mouse and scrollbar, or the keyboard keys in the manner\n\
  364.  of text display programs such as \"more\" and \"less\".\n\n\
  365.  spacebar - scroll down a page      b - scroll up a page\n\
  366.  return   - scroll down a line      k - scroll up a line\n\
  367.    G      - go to end of text       ' - go to top of text\n\n\
  368.  The both windows also support keyboard access to each of\n\
  369.  the command buttons.  See the xmail man page for details\n\
  370.  or press the question mark key (?) within the text window.";
  371.  
  372. String    Text2_Help = "\
  373. Keyboard key defaults that duplicate command button actions:\n\n\
  374.  a - REPLY to all recipients    A  - REPLY to all included\n\
  375.  c - COPY a message             C  - COPY to Author file\n\
  376.  d - DELETE the message         u  - UNDELETE a message\n\
  377.  f - READ with full headers     F  - FORWARD a message\n\
  378.  m - MAIL a message             M  - REPLY to a message\n\
  379.  i - incorporate NEW MAIL       N  - retrieve NEW MAIL\n\
  380.  p - read PREVIOUS message      P  - PRINT a message\n\
  381.  r - READ the message           R  - REPLY included\n\
  382.  s - SAVE current message       S  - SAVE to author\n\
  383.  n - read the NEXT message      w  - WRITE current message\n\
  384.  q - QUIT, committing changes   x  - EXIT, no commits\n\
  385.  ? - DISPLAY this help info   <LF> - REMOVE this help info";
  386.  
  387. String    Title_Help = "\n\n\n\n\
  388. The Titlebar window displays the xmail program name and the\n\
  389. current version number, along with the name of the current\n\
  390. mail folder being accessed, and its message count(s).\n\n\
  391. Pressing the left mouse button on the National Semiconductor\n\
  392. Corporation logo in the top left corner of the title bar\n\
  393. issues an XLib request to iconify this xmail application.";
  394.  
  395. String    To_Help = "\n\
  396.  Use the To: window to specify the recipients for this mail\n\
  397.  message.  Text entered beyond the right margin of the\n\
  398.  window will cause a horizontal scrollbar to appear, for\n\
  399.  scrolling the displayed text left or right as desired for\n\
  400.  viewing.  Pressing the backspace or delete key erases the\n\
  401.  previously entered character, while Control_W (^W) erases\n\
  402.  a previous word and Control_U (^U) to the start of a line.\n\n\
  403.  Pressing the right mouse button in this window displays a\n\
  404.  list of your alias names.  Releasing the right mouse\n\
  405.  button while one of the names is highlighted will copy\n\
  406.  that name into the window, prepending it with a comma if\n\
  407.  needed.";
  408.  
  409. /* HelpText */
  410.