home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / PCCEDIT.ZIP / PCCFE.DOC next >
Text File  |  1988-06-05  |  13KB  |  240 lines
  1.  
  2.  
  3.                           "PcConnect File Editor"
  4.                                Documentation
  5.  
  6.  
  7.                 I  love to make speeches, but writing was never one of
  8.          my more likeable ways of getting a messages across.   However
  9.          Gary  assured  me  that this had to be done & here I go.  The
  10.          file editor is a real cute piece of work.  One that I am very
  11.          proud of for several reasons.  The chief being, "It allows me
  12.          to edit my file {areas/dir's}.
  13.  
  14.                 If you have chosen to read  this  before  running  the
  15.          editor,  you  have done yourself a favor.  I will now proceed
  16.          to take you through the setting up of your file areas.  First
  17.          you should have a good idea of  what  file  areas  you  want.
  18.          Below   is a list of mine as an example.
  19.  
  20.  
  21. ╔════════════════════════════════[ File Areas ]════════════════════════════════╗
  22. ║╔══════════════════════════════════════╦═════════════════════════════════════╗║
  23. ║║ 1 - -=[ UPLOADS ]=-                  ║ 2 - PASCAL                          ║║
  24. ║║ 3 - BASIC                            ║ 4 - ASSEMBLY                        ║║
  25. ║║ 5 - "C" Language                     ║ 6 - TURBO PASCAL 4.0                ║║
  26. ║║ 7 - UTILITIES                        ║ 8 - DIAGNOSTICS                     ║║
  27. ║║ 9 - TEXT & INFO                      ║10 - COMMUNICATIONS                  ║║
  28. ║║11 - ***** PRIVATE *****              ║12 - APPLICATIONS                    ║║
  29. ║║13 - Omen Technology Software         ║14 - New Dimension Software          ║║
  30. ║║15 - EDITORS                          ║16 - MISC.                           ║║
  31. ║║17 - Per.Comp.Prog.Co Software        ║                                     ║║
  32. ║╚══════════════════════════════════════╩═════════════════════════════════════╝║
  33.  
  34.  
  35.                 If you do not have a FILEAREA.PCC created, then when
  36.          you run PCCFE you will be told that it does not exist, as if
  37.          you   didn't  know already.  You can answer yes to create the
  38.          file or no to quit without creation. If you answer Y you will
  39.          next  be  asked for the name or description of you first file
  40.          area.  Don't be confused, name or description being  one  and
  41.          the  same.   Some  call  it  one, some the other.  Just enter
  42.          what you want the user to see when they enter the  file  area
  43.          and  do a list areas command.  You must next tell PCCFE where
  44.          the DOS path to the file area  is.  (i.e.  D:\UPLOADS)  tells
  45.          PCCFE  to  create  or find DIR.PCC in that dos directory.  If
  46.          the  dos  directory  doesn't  exist,  PCCFE  will  make   the
  47.          directory  and  then  create a DIR.PCC file in the area.  The
  48.          DIR.PCC file contains no files at this time.  Next  you  need
  49.          to  enter  the  Upload  and  Access  level  for the area.  My
  50.          suggestion would be to set  the Access level to  your NEWUSER
  51.          level and Upload level to SYSOP LEVEL.  This is your means of
  52.          controlling  system  access  to the file area.  (e.g.  if you
  53.          desire everyone to have full access when they  first  log  on
  54.          then  set all area accesses to NEWUSER level. Set your Upload
  55.          level to SYSOP LEVEL with the exception of your  UPLOAD  AREA
  56.          which  you'll  want  at  NEWUSER  LEVEL.   If  you  prefer to
  57.          checkout a newuser and award access per behavior etc...  then
  58.          set  the  access  level  according  to  the access levels you
  59.          purpose to have for varing  levels  of  system  access.)   If
  60.          you'll  notice above, area 11 says PRIVATE.  This is the area
  61.          that  GARY  and  I  use  in  exchanging  PcConnect  files  so
  62.          naturally  we  want the access high enough [ SYSOP LEVEL ] to
  63.          exclude the casual user.
  64.  
  65.                 After you have entered all information  for the  first
  66.          area,  the  program  proceeds  to continue in normal fashion.
  67.          You may now from the main screen  enter  this  new  area  and
  68.          begin  the process of adding files if you wish or pressing F2
  69.          to continue adding other fileareas to the system.  F2  causes
  70.          a  menu  to pop up and you may elect to ADD,DELETE,MODIFY any
  71.          file area you choose.  A word about deleting a file area.   I
  72.          found it very useful not to delete the DIR.PCC from the disk.
  73.          So if you decide to delete an area the DIR.PCC is still there
  74.          and  you  may add it back to the FILEAREA.PCC by selecting F2
  75.          and going through the motions outlined above.
  76.  
  77.  
  78.                 Briefly on  adding  files  to  the  DIR.PCC.   If  the
  79.          DIR.PCC file  contains  nothing  then  you  are  told so upon
  80.          entering the area.  You are then asked if  you  wish  to  add
  81.          files  at  this  time.  If you say yes, AND you have files in
  82.          the dos directory, you will be shown all the directory  files
  83.          from  which you may move the bar around to select the file to
  84.          add.  Once the selection is made you are prompted for a short
  85.          description of the file, and finially asked if  you  want  to
  86.          add  the file to the DIR.PCC. Yes does / No don't.  So on and
  87.          so forth until you run out of files or  get  tired  whichever
  88.          comes first.  As you will notice, every file in the directory
  89.          is  offered for selection except the DIR.PCC & DIR.BAK files.
  90.          As you continue to select files and add them to the  DIR.PCC,
  91.          those  you  have  added will no longer show up for selection.
  92.          If you accidently select say a doc file you unarched  outside
  93.          of  PCCFE  to view and do not want this added to the DIR.PCC,
  94.          simply tap the enter key until asked if you wish to add it to
  95.          the DIR.PCC.  Press "N" and continue as before.
  96.  
  97.  
  98.                 Listed below are the help screens from  within  PCCFE,
  99.          they  may  help shed still further light on any questions you
  100.          may have. There are no hidden keys to know about  other  than
  101.          the  "J"  while  working  in  the DIR.PCC and it is explained
  102.          below.  All functions are labeled with the  program  and  you
  103.          should have little trouble figuring out just what is what and
  104.          how  things  function.  Simplicity  was  one thing  that  was
  105.          inportant in the work on the editor to make using  it  a  joy
  106.          instead  of the chore that some I've run across have been. IF
  107.          in the course of your BBSin' you see something you would like
  108.          to have added to the editor. Call, Write, or drop by  anytime
  109.          and  I  will see that you get just what you want if within my
  110.          power to do so.
  111.  
  112.  
  113.          (409)598-3809 voice
  114.          (409)598-9057 data
  115.          (301)598-4331 data
  116.  
  117.  
  118.  
  119. HELP FOR MAIN SCREEN:
  120.  
  121. Use the arrow keys to move highlited bar/cursor over the file area.
  122. UpArrow moves up, DownArrow moves Down, LeftArrow steps backward through
  123. areas and stops on 1, RightArrow steps forward through areas and wraps back
  124. to one etc...  Enter\Return selects highlited area and opens DIR.PCC in
  125. selected directory.  If the program fails to find DIR.PCC you are told about
  126. it.  Press space bar to reset the screen, exit with F10 and verify that the
  127. directory exsists and DIR.PCC resides in the directory.  If a retry produces
  128. the same result, verify that the path shown in the error window is the correct
  129. path.  If not, then F2 will allow you to modify the FileArea->Path. It
  130. should be noted that the installation program does not create your file
  131. directories.  That is a function of PcConnect or the File Editor.
  132.  
  133. F10 exits to DOS. Note: F10 is exclusive in exiting program segments.
  134.  
  135. All yes/no prompts are defaulted and indicated by a capital Y or N in the
  136. prompt. e.g. [Y,n] yes is the default.  Enter/Return selects the default.
  137.  
  138. The opening process of selecting a directory area may be bypassed by entering
  139. the path to DIR.PCC.  Since PC Connect does not require your file areas to be
  140. within it's home directory, it is necessary for the entire path to be entered.
  141. i.e. C:\FILES\UPLOADS  However, certain ways of processing the command line
  142. enable you to access certain directories differently.  The drive letter and
  143. colon i.e. "D:" is only needed if a drive other than the log drive is to be
  144. accessed. If the directory containing DIR.PCC is a subdir. of the rootdir.
  145. of the loggeddrive, then all you need enter is "\UPLOADS" e.g. PCCFE \UPLOADS .
  146. If the directory containing DIR.PCC is a subdir. of PC Connect''s home directory
  147. then all you need enter is "UPLOADS" e.g. PCCFE UPLOADS .  The command line
  148. entry should always be delimited with a space. e.g. "PCCFE d:\dir\dir...
  149. Errors in the above formats will cause PCCFE not to find the DIR.PCC and the
  150. program will continue to run allowing you to select the area from the main
  151. screen.
  152.  
  153. Help screens are available in each program segment via the F1 key.
  154.  
  155. F2 selects the FILEAREA.PCC support menu. You may ADD/DELETE or MODIFY any
  156.    area you wish.
  157.  
  158. F4 selects the create a catalog feature.  You will be prompted for a lock-out
  159.    level.  This allows you to create a catalog of files from your non private
  160.    file areas.  Private file areas are only private to those people who do not
  161.    have the file access level to enter the directory.  The catalog contains
  162.    all the information about the files on your system.  You may modify this
  163.    ascii file to suit your desires.
  164.  
  165.  
  166.  
  167. HELP FOR DIR.PCC SCREEN:
  168.  
  169.  
  170. The F1 key you used to read this of course. Each assigned function key is');
  171. labeled specific for a special task.  Multi-Tasks are not assigned. i.e. Move');
  172. is move and copy is copy etc...');
  173.  
  174. The F2 key enters the MOVE a file section.  You may move any file contained in');
  175. the Dir.pcc to any file section presently contained in you FileArea.pcc.  You');
  176. can not leave a copy of the record in the current Dir.pcc. More than one file');
  177. may be moved by seperating each file number with a "," (i.e. 1,4,6,8<enter>).');
  178.  
  179. The F3 key enters the COPY a file section.  You may do just that, copy a file');
  180. from the current Dir.pcc to another FileArea Dir.pcc.  Two copies of the file');
  181. will now exist on the drive in seperate directories.');
  182.  
  183. The F4 key enters the ADD a file section.  You may add/append a file to the');
  184. current Dir.pcc.  If the file is not presently in the subdirectory, then the');
  185. you won''t see it in the pik-file list.  No provision is made for manual entry');
  186. of a file which doesn''t exsist in the directory.');
  187.  
  188. The F5 key will allow you to delete a file from the current Dir.pcc.  You will');
  189. be prompted to delete the file from the disk subdirectory. The default is YES.');
  190.  
  191. The F6 key will allow you to modify/change information about a file in the');
  192. Dir.pcc.  No change to the Disk file is made.');
  193.  
  194. The F7 key will sort the DIR.PCC by filename for the current FileArea.');
  195.  
  196. The F8 key will allow you to globally set the file cost of the files in the ');
  197. current DIR.PCC only. ');
  198.  
  199. The F9 key causes a prompt in the lower right corner to ask you for the file');
  200. name of the archive.  You may add the .ext if you wish, but it''s not needed.');
  201. Providing all is well, you will be shown the contents of the archive 15 files');
  202. files per page, and a horiz menu of selections to choose from. All work is ');
  203. done to an archive in it''s own directory.  Nothing special is needed.');
  204.  
  205. HOME END PgUp PgDn and the arrow keys all work here to move through the ');
  206. files.');
  207.  
  208. Another feature is the "J" key.  Pressing this key prompts you');
  209. for the file number you want to [jump] to.  This file will will be shown');
  210. in the middle of the page.  Of course if you select one at the end or the');
  211. top of the list then we''ll start from the top or bottom whichever comes');
  212.  
  213. Many other features are planned for PCCFE but as of this release date I');
  214. just haven''t been able to take the time from other projects and devote it');
  215. this one.  If PcConnect does well, the next release will see many nice things');
  216. that I as a Sysop, and others like to know about their files.');
  217.  
  218.  
  219.                                      Drue Kennon
  220.  
  221.  
  222. P.S.
  223.     A short word about the archive viewing/extracting and so forth.  It was
  224.     regrettable that Tom has given up on expanding his ARCxxx program but I
  225.     can understand his reasons.  None the less, Phil Katz is still going with
  226.     PK(x)ARC and we will attempt to stay up with him on this.  The editor is
  227.     written in Turbo Pas 4.0 which is fast but it is not as fast as it's "C"
  228.     counterparts in extracting files. Every slick trick I know went into
  229.     the fixing of what was once dearcsq.com to get these features to work.
  230.     Anyone who has fooled around with that file knows that crunch versions
  231.     5,6,7 would not uncrunch with the written coding scheme.  I don't remember
  232.     the name but someone uploaded a file on Gary's board that he was to have
  233.     converted to 4.0....  He didn't figure it out either.  Alas I was forced
  234.     to trace and debug the whole thing, rewriting it from TOM's arc520 source
  235.     in "C".  No small task this turned out to be.  I'll give you one hint
  236.     if anyone decides to try.  In TP4 types are very inportant.  More so than
  237.     in any other language.
  238.  
  239. 
  240.