home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / misc~1 / 123 / stcitdoc.arc / FILETAG.DOC < prev    next >
Encoding:
Text File  |  1987-09-10  |  1.9 KB  |  52 lines
  1. FILETAG.DOC
  2.  
  3.     File tagging is the ability to associate a short text description
  4. with a file, which can be displayed on command, along with the file
  5. names.
  6.  
  7.     STadel will now support two different ways to display the
  8. contents of a directory room's directory.  The first is the old way,
  9. and will remain the same --  .R(ead) D(irectory).  The second method
  10. is used to display the file descriptions, and is .R(ead) <E(xtended
  11. directory).
  12.  
  13.     The format of a directory listing using .RE is like this:
  14.  
  15.         fn1      f1size | f1 description (date created)
  16.         fn2      f2size | f2 description (date created)
  17.           .
  18.           .
  19.           .
  20.         fnx      fxsize | fx description (date created)
  21.  
  22.  
  23.     The fnX is filename x, and fXsize is the size of that file in
  24. xmodem sectors.  The output is, of course, formatted to the users
  25. screen, so people with screens <= 40 are going find these listings a
  26. little hard to follow...
  27.  
  28.     So, how do we put these descriptions in, you ask?  (I should let
  29. you folk guess!)  For each directory room that you want to have
  30. descriptions for the files, there must be a file named '.DIR'. 
  31. Within this file will be the descriptions, formatted in the
  32. following way:
  33.  
  34.         fn1<tab>f1 description
  35.         fn2<tab>f2 description
  36.           .
  37.           .
  38.           .
  39.         fnX<tab>fX description
  40.  
  41.     Each fnX is the filename, in the left most column of the screen.
  42. "fX description" is the description for that file.  It is limited to
  43. one* line for each file. However, that line may extend up to 7000
  44. characters, so if you have a text editor that will handle 7000
  45. characters on one line, and really want to do that to your users... 
  46. Between each fnX and its description there must be at least* one tab.
  47.  
  48.     Each filename must be in uppercase, and the filenames must be in
  49. alphabetical order for .RE to work properly. STadel puts new file
  50. descriptions into the .DIR file in the proper order when somebody
  51. uploads a file to the system.
  52.