home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / PMGRP218.ZIP / GRPFILES.DOC < prev    next >
Text File  |  1990-01-30  |  3KB  |  77 lines
  1.                            How to Use GroupFiles
  2.                                     with
  3.                                  GROUP 2.17
  4.  
  5.  
  6. GROUP version 2.17 implements GroupFiles as well as GroupMail.  This is an 
  7. automated file distribution system in the same way the GroupMail is an 
  8. automated message distribution system.  In exactly the same way, in fact.  
  9. GroupFiles are always associated with a GroupMail conference, and the files 
  10. are distributed inside the GroupMail archives.  
  11.  
  12.  
  13. For anyone other than the topstar, receiving GroupFiles is simplicity in 
  14. itself.  For any given conference you receive that distributes group files, 
  15. simply create a directory to receive the files and add a "/F<dirname>" to 
  16. your definition for that conference.  For example, if your AREAS.DOG entry 
  17. for the BLATZ conference looked like this:
  18.  
  19.     GROUP\BLATZ Gzorniblatz Forum  ;520/1015
  20.  
  21. and you wanted gzorniblatz-related files to go into your D:\FILES\BLATZFIL 
  22. directory, you would simply change it to:
  23.  
  24.     GROUP\BLATZ Gzorniblatz Forum  ;520/1015 /fD:\FILES\BLATZFIL
  25.  
  26. If the directory you specify contains a FILES.CAT (Kitten), FILES.DIR 
  27. (TBBS), or a FILES.BBS (Fido/Opus) directory listing, then it will be 
  28. automatically updated as you receive new group files.  (If you don't have 
  29. any of the above, then GROUP will automatically create a FILES.CAT for 
  30. you.)
  31.  
  32.  
  33. For the topstar of a conference, distributing group files is only slightly 
  34. harder.  You must designate a file directory to be associated with the 
  35. conference in exactly the same way as anyone else in the conference.  Then, 
  36. when you want to distribute one or more files, you must create a 
  37. PACKING.LST file in that directory.
  38.  
  39. For example, if you were the topstar of the BLATZ conference, and you had 
  40. associated the D:\FILES\BLATZFIL directory with it (as in our earlier 
  41. example), then to distribute files you would create a file named 
  42. "D:\FILES\BLATZFIL\PACKING.LST".  
  43.  
  44. The format of this file is very simple.  If the first character of a line 
  45. is a double quote, then the rest of the line is a comment.  Otherwise the 
  46. first word on the line must be the name of a file to distribute and the 
  47. rest of the line is a one-line description.  The file must be located in 
  48. the group files directory, and it may not be specified with a drive or 
  49. path.  
  50.  
  51. Also, comments are in some ways associated with the previous file entry 
  52. (they are used that way for creating messages in the conference, and for 
  53. making linked comments on TBBS systems).  You should not make comment lines 
  54. longer than 40 characters, or the results will not look right on a TBBS 
  55. system.  
  56.  
  57. Here is an example of a possible PACKING.LST file:
  58.  
  59.     GROUP.EXE Version 2.17, includes GroupFiles
  60.     "This is the version that introduces
  61.     "GroupFiles for easy automatic 
  62.     "distribution of programs and files.
  63.     GROUP2.EXE GROUP version 2.17 for OS/2
  64.     "Runs in protected mode, no penalty box
  65.     "required.
  66.  
  67. We've indented it here, but in practice everything should be "flush left" 
  68. with NO leading spaces.
  69.  
  70. As of version 2.17 GROUP does NOT update a file directory for the topstar 
  71. like it does for everyone else.  We may add that in a future version.
  72.  
  73.  
  74. That's pretty much it.  As usual, we're open to comments and suggestions if 
  75. anyone has any ideas on how to improve this.  As it stands, it's simple yet 
  76. powerful.  We have great hopes for it.
  77.