home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / unix / volume13 / vn.jan.88 / part04 / help.c < prev    next >
Encoding:
C/C++ Source or Header  |  1988-01-30  |  5.4 KB  |  214 lines
  1. /*
  2. ** vn news reader.
  3. **
  4. ** help.c - print help
  5. **
  6. ** see copyright disclaimer / history in vn.c source file
  7. */
  8. #include <stdio.h>
  9. #include <setjmp.h>
  10. #include "config.h"
  11. #include "tty.h"
  12. #include "tune.h"
  13. #include "node.h"
  14. #include "page.h"
  15. #include "reader.h"
  16. #include "vn.h"
  17.  
  18. extern int L_allow;
  19. extern int C_allow;
  20. extern int Digest;
  21. extern char *Contstr;
  22. extern char Cxptoi[], Cxrtoi[];
  23.  
  24. /*
  25.     Help message table.  Character for command, plus its help
  26.     message.  Table order is order of presentation to user.
  27. */
  28. static struct HELPTAB
  29. {
  30.     char cmd, *msg;
  31.     int dig;
  32.     char *amsg;
  33. } 
  34. Helptab [] =
  35. {
  36.     { QUIT, "quit", 1, NULL},
  37.     { UP, "(or up arrow) move up [number of lines]", 1, NULL},
  38.     { DOWN, "(or down arrow) move down [number of lines]", 1, NULL},
  39. #ifdef PAGEARROW
  40.     { BACK, "(or left arrow) previous page [number of pages]", 1, NULL},
  41.     { FORWARD, "(or right arrow) next page [number of pages]", 1, NULL},
  42. #else
  43.     { BACK, "previous page [number of pages]", 1, NULL},
  44.     { FORWARD, "next page [number of pages]", 1, NULL},
  45. #endif
  46.     { TOPMOVE, "move to top of page", 1, NULL},
  47.     { BOTMOVE, "move to bottom of page", 1, NULL},
  48.     { ALTBOTTOM, "move to bottom of page (alternate L)", 1, NULL},
  49.     { MIDMOVE, "move to middle of page", 1, NULL},
  50.     { DIGEST, "unpack digest", 1, "exit digest"},
  51.     { READ, "read article [number of articles]", 1, NULL},
  52.     { ALTREAD, "read article (alternate 'r')", 1, NULL},
  53.     { READALL, "read all articles on page", 1, NULL},
  54.     { READSTRING, "specify articles to read", 1, NULL},
  55.     { SAVE, "save or pipe article [number of articles]", 1, NULL},
  56.     { SAVEALL, "save or pipe all articles on page", 1, NULL},
  57.     { SAVESTRING, "specify articles to save", 1, NULL},
  58.     { ALTSAVE, "specify articles to save (alternate ctl-s)", 1, NULL},
  59.     { PRINT, "print article [number of articles]", 1, NULL},
  60.     { PRINTALL, "print all article on page", 1, NULL},
  61.     { PRINTSTRING, "specify articles to print", 1, NULL},
  62.     { UPDATE, "update .newsrc status to cursor", 0, NULL},
  63.     { UPALL, "update .newsrc status for whole newsgroup", 0, NULL},
  64.     { UPSEEN, "update .newsrc status for all pages displayed", 0, NULL},
  65.     { ORGGRP, "recover original .newsrc status for newsgroup", 0, NULL},
  66.     { ORGSTAT, "recover all original .newsrc status", 0, NULL},
  67.     { SSTAT, "display count of groups and pages - shown and total", 0, NULL},
  68.     { GRPLIST, "list newsgroups with new article, updated counts", 0, NULL},
  69.     { NEWGROUP, "specify newsgroup to display and/or resubscribe to", 1, NULL},
  70.     { UNSUBSCRIBE, "unsubscribe from group", 0, NULL},
  71.     { MARK, "mark/unmark article [number of articles]", 1, NULL},
  72.     { ART_MARK, "mark/unmark article [number of articles]", 1, NULL},
  73.     { UNMARK, "erase marks on articles", 1, NULL},
  74.     { HEADTOG, "toggle flag for display of headers when reading", 1, NULL},
  75.     { SETROT, "toggle rotation for reading", 1, NULL},
  76.     { REDRAW, "redraw screen", 1, NULL},
  77.     { UNESC, "escape to UNIX to execute a command", 1, NULL},
  78.     { PRTVERSION, "show vn version", 1, NULL},
  79.     { HELP, "show this help menu", 1, NULL}
  80. };
  81.  
  82. #define HTSIZE (sizeof(Helptab)/sizeof(struct HELPTAB))
  83.  
  84. /*
  85.     help from main screen
  86. */
  87. help ()
  88. {
  89.     int i,lcount,lim; 
  90.     term_set (ERASE);
  91.     lim = L_allow + RECBIAS - 2;
  92.     printf("%s\n",HELP_HEAD);
  93.     lcount = HHLINES;
  94.     for (i=0; i < (sizeof(Helptab))/(sizeof(struct HELPTAB)); ++i)
  95.     {
  96.         if (Digest && !(Helptab[i].dig))
  97.             continue;
  98.         ++lcount;
  99.         if (Digest && Helptab[i].amsg != NULL)
  100.             h_print (Cxptoi[Helptab[i].cmd],Helptab[i].amsg);
  101.         else
  102.             h_print (Cxptoi[Helptab[i].cmd],Helptab[i].msg);
  103.         if (lcount >= lim)
  104.         {
  105.             printf ("\n%s",Contstr);
  106.             getnoctl ();
  107.             term_set (MOVE,0,lim+1);
  108.             term_set (ZAP,0,strlen(Contstr));
  109.             term_set (MOVE,0,lim-1);
  110.             putchar ('\n');
  111.             lcount = 0;
  112.         }
  113.     }
  114.     if (lcount > 0)
  115.     {
  116.         printf ("\n%s",Contstr);
  117.         getnoctl ();
  118.     }
  119. }
  120.  
  121. /*
  122.     help from reader
  123. */
  124. help_rd()
  125. {
  126.     h_print (Cxrtoi[PG_NEXT],HPG_NEXT);
  127.     h_print (Cxrtoi[PG_QUIT],HPG_QUIT);
  128.     h_print (Cxrtoi[PG_FLIP],HPG_FLIP);
  129.     h_print (Cxrtoi[PG_REWIND],HPG_REWIND);
  130.     h_print (Cxrtoi[PG_WIND],HPG_WIND);
  131.     h_print (Cxrtoi[PG_SEARCH],HPG_SEARCH);
  132.     h_print (Cxrtoi[PG_STEP],HPG_STEP);
  133.     h_print (Cxrtoi[PG_REPLY],HPG_REPLY);
  134.     h_print (Cxrtoi[PG_FOLLOW],HPG_FOLLOW);
  135.     h_print (Cxrtoi[SAVE],HPG_SAVE);
  136.     h_print (Cxrtoi[PRINT],HPG_PRINT);
  137.     h_print (Cxrtoi[SETROT],HPG_ROT);
  138.     h_print (Cxrtoi[HEADTOG],HPG_HEAD);
  139.     h_print (Cxrtoi[PG_HELP],HPG_HELP);
  140.     printf ("%s\n",HPG_DEF);
  141. }
  142.  
  143. srch_help(c,dig)
  144. char c;
  145. int *dig;
  146. {
  147.     int i;
  148.  
  149.     for (i=0; i < HTSIZE; ++i)
  150.         if (Helptab[i].cmd == c)
  151.             break;
  152.     if (i < HTSIZE)
  153.     {
  154.         *dig = Helptab[i].dig;
  155.         return (0);
  156.     }
  157.     return(-1);
  158. }
  159.  
  160. /*
  161.     h_print prints a character and a legend for a help menu.
  162. */
  163. static
  164. h_print(c,s)
  165. char c,*s;
  166. {
  167.     if (strlen(s) > (C_allow - 14))
  168.         s [C_allow - 14] = '\0';
  169.     if (c > ' ' && c != '\177')
  170.         printf ("     %c - %s\n",c,s);
  171.     else
  172.     {
  173.         switch (c)
  174.         {
  175.         case '\177':
  176.             printf ("  <delete> - %s\n",s);  
  177.             break;
  178.         case '\040':
  179.             printf ("   <space> - %s\n",s);  
  180.             break;
  181.         case '\033':
  182.             printf ("  <escape> - %s\n",s);  
  183.             break;
  184.         case '\n':
  185.             printf ("  <return> - %s\n",s);  
  186.             break;
  187.         case '\t':
  188.             printf ("     <tab> - %s\n",s);  
  189.             break;
  190.         case '\b':
  191.             printf (" <back sp> - %s\n",s);  
  192.             break;
  193.         case '\f':
  194.             printf ("<formfeed> - %s\n",s);  
  195.             break;
  196.         case '\07':
  197.             printf ("    <bell> - %s\n",s);  
  198.             break;
  199.         case '\0':
  200.             printf ("    <null> - %s\n",s);  
  201.             break;
  202.         default:
  203.             if (c < '\033')
  204.             {
  205.                 c += 'a' - 1;
  206.                 printf(" control-%c - %s\n",c,s);
  207.             }
  208.             else
  209.                 printf("       %c0%o - %s\n",'\\',(int) c,s);
  210.             break;
  211.         }
  212.     }
  213. }
  214.