home *** CD-ROM | disk | FTP | other *** search
/ Commodore Free 63 / Commodore_Free_Issue_63_2012-08-06_-.d64 / easycli < prev    next >
Text File  |  2023-02-26  |  3KB  |  125 lines
  1.  
  2. *************************************
  3.          INTRODUCING EASYCLI
  4. *************************************
  5.  
  6. http://easycli.codeplex.com/
  7.  
  8. EasyCLI is a command shell for the
  9. Commodore 64 computer.
  10.  
  11. EasyCLI is packaged as an EasyFlash
  12. cartridge. This gives EasyCLI the
  13. ability to boot the computer and
  14. bring the user straight to the shell
  15. without having to load and run a
  16. program from disk.
  17.  
  18. RUNNING EASYCLI
  19.  
  20. When it comes to running EasyCLI,
  21. you have a few options. First, you
  22. can run the downloadable cart image
  23. directly from here and load that
  24. cart image in VICE. The emulator
  25. will detect the cartridge as being
  26. in EasyFlash format and
  27. automatically configure the emulator.
  28.  
  29. The second way to run EasyCLI is to
  30. use EasyProg to write the
  31. downloadable cart image to an
  32. EasyFlash or EasyFlash 3 cartridge.
  33.  
  34. WHAT DOES IT DO?
  35.  
  36. EasyCLI comes packaged with several
  37. built in commandlets, each of which
  38. is its own 8K program that is stored
  39. in the EasyFlash cartridge and
  40. loaded on demand. The following
  41. features are planned for version 1.0
  42. through implementation as
  43. commandlets:
  44.  
  45. * HELP - in program help system
  46. * CD - change directory
  47. * DIR - display directory
  48. * MKDIR - make directory
  49. * RMDIR - remove directory
  50. * DEL - delete file
  51. * REN - rename file or directory
  52. * COPY - copy files
  53. * MOVE - move files
  54. * SHOW - display text file
  55. * MKIMG - make disk image
  56. * WRIMG - write disk image
  57.  
  58. In addition to the commandlets that
  59. will be included with EasyCLI, the
  60. dispatcher understands the following
  61. verbs internally:
  62.  
  63. @ Text following the @ sign is
  64.   sent to the current device as a
  65.   command. (ex. "@ui" sends the
  66.   reset command to the current
  67.   drive.)
  68.  
  69. # A number succeeding the # is
  70.   used to assign the current device
  71.   (if that device exists). (ex. "#9"
  72.   sets the current device to device
  73.   9.)
  74.  
  75. : A number succeeding the : is
  76.   used to assign the current drive
  77.   on the current device. There is no
  78.   checking that the drive exists.
  79.   (ex. ":1" sets the current drive
  80.   to drive 1)
  81.  
  82. exit - Leaves EasyCLI. If BASIC
  83.        cannot be started then it
  84.        forces a hard boot.
  85.  
  86. cls - Clears the screen.
  87.  
  88. wait - Waits for user to hit a key.
  89.  
  90. echo - Displays trailing text on a
  91.        new line.
  92.  
  93. Hitting the RESTORE key at any time
  94. re initializes EasyCLI and forces it
  95. to enumerate the drives again. This
  96. is handy if you turn on a drive that
  97. wasn't on when starting EasyCLI.
  98.  
  99. SCRIPTING
  100.  
  101. EasyCLI will use a very simple
  102. scripting language that can be used
  103. to chain together commands. Scripts
  104. reside on the physical devices, not
  105. in the EasyCLI cart image. An
  106. example of a script that cleans up a
  107. couple of CMD-DOS partitions and
  108. then copies in new files from a uIEC
  109. is as follows:
  110.  
  111. #10
  112. @cp50
  113. del :somefile
  114. @cp1
  115. cd //path
  116. del :someotherfile
  117. @cp50
  118. #11
  119. cd image.d64
  120. copy :somefile 10#0:
  121. #10
  122. @cp 1
  123. copy 11#0::someotherfile
  124.  
  125. -------------------------------------