home *** CD-ROM | disk | FTP | other *** search
/ Carsten's PPE Collection / Carstens_PPE_Collection_2007.zip / F / FLAG22.ZIP / FLAG.DOC < prev    next >
Text File  |  1993-09-22  |  5KB  |  101 lines
  1. FLAG.PPE, written by David W. Terry, Copyright (C) 1993 Clark Development Co.
  2. -----------------------------------------------------------------------------
  3.  
  4. FLAG.PPE is a replacement for PCBoard's "more?" prompt which is used when
  5. PCBoard is displaying a list of files for download.  It enhances the caller's
  6. ability to flag or view files by allowing the caller to point and shoot at the
  7. files instead of having to type in the commands and filenames.
  8.  
  9. This PPE was written out of a challenge that arose at ONE BBSCON.  A PCBoard
  10. user has commented that TBBS had the ability to flag files using the space
  11. bar and I had commented that I could write a PPL to do that.  Here it is.
  12.  
  13. Also, on another note, people have commented on Wildcat's usage of numbers down
  14. the left side of the screen which made it easy to flag files.  I have, in the
  15. past, said that this was not doable in a PCBoard environment because the file
  16. descriptions are 79 columns wide, leaving no room for the numbers without
  17. making sysops reformat their file descriptions (what a pain that would be).
  18. So now, with this simple "more?" prompt replacement, you can have a BETTER
  19. flagging system than wildcat has.  <smile>
  20.  
  21. Automatic installation is simple:
  22.  
  23.     1) Unzip the INSTALL.BAT and FLAG*.* files into a temporary directory.
  24.     2) Then use the INSTALL.BAT file.  Example usage:
  25.  
  26.          INSTALL 3 C:\PCB\GEN\PCBTEXT C:\PCB\PPL
  27.  
  28.        The above command would install both FLAG.PPE and FLAG2.PPE into the
  29.        PCBTEXT file while storing the PPS/PPE files in the C:\PCB\PPL
  30.        directory.
  31.  
  32. Manually installing the files would require that you do the following:
  33.  
  34.     1) Copy the FLAG.PPE file to your C:\PCB\PPL directory (or any other
  35.        location of your choosing)
  36.     2) Run MKPCBTXT to edit your PCBTEXT file
  37.     3) Press the F3 function key and select record #549.
  38.     4) You'll see a line that says:
  39.          (@TIMELEFT@ min left), (H)elp, (V)iew, (F)lag, More
  40.  
  41.        Replace it with a line such as this:
  42.          !C:\PCB\PPL\FLAG.PPE
  43.  
  44.     5) If you want to install FLAG2.PPE then, while in MKPCBTXT, press F3
  45.        again to edit record #223 and replace it with a line such as this:
  46.  
  47.          !C:\PCB\PPL\FLAG2.PPE
  48.  
  49.        Likewise, do the same thing to record #585.  Record 223 is the novice
  50.        mode version of the File List Command prompt while record 585 is the
  51.        expert version of that same prompt.
  52.  
  53.     6) You're done!
  54.  
  55. Source code is included in case you want to modify it or even learn from it.
  56. This was actually my *first* full-fledged PPE, so I hope you won't be too
  57. critical of the source code.
  58.  
  59. Enjoy!
  60.  
  61. -----------------------------------------------------------------------------
  62.  
  63. Caveat:  This method of flagging files only works so long as the filename to
  64. be marked is still on the SYSOP's screen (the PCBoard side).  Callers who are
  65. in 50-line mode will only be able to mark the files on the bottom 23 lines of
  66. the screen.  Of course, the (F)lag command is still functional, or the caller
  67. could reduce his page length using the (P)age Length command in PCBoard so
  68. that it does not display more than the bottom 23 lines before a more? prompt
  69. appears.
  70.  
  71. -----------------------------------------------------------------------------
  72.  
  73. NOTE:  Beginning with version 2.0, a FLAG.HIS file is included which is a
  74. history of the changes made to the program.  Including a source-level
  75. description of the changes that were made.
  76.  
  77. -----------------------------------------------------------------------------
  78.  
  79. SPECIAL REQUEST:  To every programmer and would-be programmer that sees the
  80. source code to this PPE, please feel free to utilize it ON YOUR OWN BBS any
  81. way you see fit.  Feel free to modify the source code to your hearts content.
  82. That is why the source is included, so that you can customize it to suit your
  83. needs, so that you can learn from it and perhaps become creative in other
  84. areas of programming PPLs as well.
  85.  
  86. However, please DO NOT DISTRIBUTE YOUR MODIFIED CODE in a manner that would be
  87. confusing to other users of the program.  If you make changes that you want to
  88. get into the "main product" feel free to send your changes to me (David Terry)
  89. and I will review them and decide whether or not to include the modifications
  90. in the main code.
  91.  
  92. Alternatively, you might want to distribute the ORIGINAL/UNMODIFIED source
  93. together with your modifications and then name the archive something other than
  94. the FLAG####.ZIP convention that will be used by the main product.  In other
  95. words, if you create a "SPCLFLAG.ZIP" and include both the original/unmodified
  96. source as well as your own modified source, then there is no confusion as to
  97. who wrote what pieces of the software and who should maintain them or where
  98. the end user should go to find updates to the source being used.
  99.  
  100. -----------------------------------------------------------------------------
  101.