home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / robot-pd / 12400.ZIP / 12400B.DSK / manual04.txt < prev    next >
Text File  |  1998-04-30  |  10KB  |  315 lines
  1.  
  2.                  C H A P T E R   F O U R
  3.  
  4.  
  5. 4. Transient Programs
  6.  
  7. 4.2 CTX - Centrox Text Editor
  8.  
  9. Description :Centrox TeXt Editor
  10.  
  11. Format :CTX [+<line.number>][<source file path>
  12.  [<dest file path>]]
  13.  
  14. On invocation, if no file paths are given, CTX will simply
  15. enter control mode and wait for the  user  to  issue  some
  16. command.
  17.  
  18. If a source file path is given, the file  will  be  loaded
  19. into memory from the disk. If the destination file path is
  20. given, CTX will default to this name  when  saving  files,
  21. instead of defaulting to the source name.
  22.  
  23. Note:As far as single drive users are concerned the source
  24. and destination files do NOT have to be on the  same  disk
  25. as they won't be open at the same time.
  26.  
  27. The construct "+<line number>" can be  used  to  make  CTX
  28. place the cursor at a specific line in the text  after  it
  29. has been loaded. This feature  is  useful  when  debugging
  30. compiler source code.
  31.  
  32. NB:Due to Centrox translation, the double quote  character
  33. is not displayed as such, instead it looks  similar  to  a
  34. single forward quote..see SYMBOL in the previous chapter.
  35.  
  36.  
  37. 4.3 Control Mode
  38.  
  39. The control mode operates as a command  interpreter.  This
  40. implies that each request is invoked by  typing  its  name
  41. and arguments in response to a prompt.  In  practice,  the
  42. arguments to a command do not need to be supplied with the
  43. name-CTX will prompt for any missing parameters.  Commands
  44. may be abbreviated by truncating the  name  and  adding  a
  45. dot.
  46.  
  47. Shell  commands  are  freely  available,  but  at  present
  48. require that the Shell be running in Permanent  mode,  and
  49. present in memory. The next version of  Centrox  may  well
  50. rectify this problem.
  51.  
  52.  
  53. 4.3.1 The SAVE Command
  54.  
  55. Format :SAVE <file path>
  56.  
  57. Instructs CTX to tidy the text  and  save  the  result  to
  58. disk. The tidying up operation can take a significant time
  59. to complete if the text in memory is quite long.
  60.  
  61. The current output file path can be selected by entering a
  62. NULL file path at  the  destination  prompt.  The  current
  63. input (and output) file names are displayed on the left of
  64. the status window.
  65.  
  66.  
  67. 4.3.2 The LOAD Command
  68.  
  69. Format :LOAD <file path>
  70.  
  71. Instructs CTX to delete the text currently in  memory  and
  72. load a new  file  from  disk.  If  an  error  occurs  when
  73. specifying the file path, the text in memory will  not  be
  74. deleted. However, if the requested file  does  not  exist,
  75. the text WILL be deleted. The output file name will be set
  76. to the input file name as passed  to  LOAD  by  the  user.
  77. There is no way to change the  default  output  using  the
  78. LOAD command, so see OUTPUT.
  79.  
  80. The current input (and output) file names are displayed on
  81. the left side of the status window.
  82.  
  83.  
  84. 4.3.3 The QUIT Command
  85.  
  86. Format :QUIT
  87.  
  88. Instructs CTX  to  exit  back  to  Centrox.  No  check  is
  89. performed to ensure that the text has been saved first. It
  90. is assumed that the  QUIT  command  can't  be  invoked  by
  91. accident.
  92.  
  93.  
  94. 4.3.4 The OUTPUT Command
  95.  
  96. Format :OUTPUT <dest file path>
  97.  
  98. This allows the user to  change  the  default  destination
  99. name for the text. This function is  described  under  the
  100. SAVE section.
  101.  
  102. The current input (and output) lines are displayed on  the
  103. left side of the status window.
  104.  
  105.  
  106. 4.3.5 The EDIT Command
  107.  
  108. Format :[RETURN]
  109.  
  110. Pressing [RETURN] at the prompt will return  the  user  to
  111. text edit mode.
  112.  
  113.  
  114. 4.3.6 Centrox Commands
  115.  
  116. Shell commands can be executed from within CTX  by  typing
  117. the standard command line at the  prompt.  Note,  however,
  118. that the ALIAS function will no longer work, nor will  the
  119. DO command history be updated. DO can, however,  still  be
  120. used to access previous commands.  External  commands  can
  121. not  be  invoked-instead  the   error   message   "Command
  122. unavailable" will be returned.
  123.  
  124. If the  Shell  is  running  in  Transient  mode,  all  its
  125. commands become "unavailable".
  126.  
  127.  
  128. 4.3.7 The GOTO Command
  129.  
  130. Format :GOTO <line number>
  131.  
  132. Positions the cursor at  the  given  line  of  text.  This
  133. function can be pre-requested by using the "+"  invocation
  134. option. Note that "GOTO $" moves the cursor  to  the  last
  135. line of text.
  136.  
  137.  
  138. 4.3.8 The FETCH Command
  139.  
  140. Format :FETCH <file path>
  141.  
  142. This is similar to  LOAD  except  that  the  new  text  is
  143. inserted into the text in memory  at  the  current  cursor
  144. position. The cursor position will not be altered.
  145.  
  146.  
  147. 4.3.9 The CLEAR Command
  148.  
  149. This clears all text  from  memory.  WARNING:THERE  IS  NO
  150. CONFIRMATION FOR THIS COMMAND-IT IS ASSUMED THAT YOU WON'T
  151. TYPE CLEAR BY ACCIDENT !
  152.  
  153.  
  154. 4.4 Edit Mode
  155.  
  156. Edit mode allows the user to alter the text  currently  in
  157. memory. It is entered by typing [RETURN]  at  the  control
  158. prompt.
  159.  
  160. Edit mode operates in two ways. The first way is INSERTION
  161. mode. In this mode, space is made for characters  as  they
  162. are typed into a line. Words that are pushed off  the  end
  163. of a line "wrap round" onto the line below.  In  OVERWRITE
  164. mode characters simply obliterate  those  they  are  typed
  165. over.
  166.  
  167. The current entry mode is displayed in the middle  of  the
  168. status window, on the bottom line.
  169.  
  170. If no keys are pressed for three `blinks' of  the  cursor,
  171. the amount of free memory, and position of the cursor will
  172. be displayed in the top status window.
  173.  
  174.  
  175. 4.5 Edit Control Keys
  176.  
  177. All the following keys must be pressed while the [CONTROL]
  178. key is being held down.
  179.  
  180.  
  181. 4.5.1 "D" - End Of Data
  182.  
  183. <CONTROL>+<D> causes an EOD signal to be emitted. This  is
  184. trapped by CTX and recognised as a request  to  return  to
  185. the Control mode. Edit mode can be  re-entered  by  typing
  186. <RETURN>
  187.  
  188.  
  189. 4.5.2 "I" - Insert Mode
  190.  
  191. This causes INSERTION mode to be  entered.  This  mode  is
  192. described in section (4.4).
  193.  
  194.  
  195. 4.5.3 "O" - Overwrite Mode
  196.  
  197. This causes OVERWRITE mode to be  entered.  This  mode  is
  198. described in section (4.4).
  199.  
  200.  
  201. 4.5.4 "U" - Upper Case
  202.  
  203. This forces the letter under the cursor to change to upper
  204. case. After  the  operation,  the  cursor  will  move  one
  205. position to the right.
  206.  
  207.  
  208. 4.5.5 "L" - Lower Case
  209.  
  210. This performs the reverse operation to <CONTROL>+<U>.
  211.  
  212.  
  213. 4.5.6 "Y" - Insert Line
  214.  
  215. This causes a new blank line to be inserted at the current
  216. line. WordStar users may have  noticed  that  CTX  is  not
  217. entirely WordStar compatible...!
  218.  
  219.  
  220. 4.5.7 "P" - PCC Request
  221.  
  222. This allows  the  user  to  enter  PCCs  (Printer  Control
  223. Characters) into the text. Each of the PCCs can be defined
  224. by the user. This is only relevant to FORMAT and  will  be
  225. discussed in that section of the manual.
  226.  
  227. In the mean time, note that there  are  twenty  six  PCCs.
  228. They are represented by the letters "A" to "Z". When shown
  229. on screen they will appear in inverse video - except  when
  230. the cursor is on top of them. A  capital  letter  turns  a
  231. function on while  the  corresponding  lower  case  letter
  232. turns the function off.
  233.  
  234. Note that the PCCs are not affected by the <CONTROL>  +<U>
  235. / +<L> commands. Also note that the  following  PCCs  have
  236. special "reserved" meanings:-
  237.  
  238.           A : Elite
  239.           B : Proportional
  240.           C : Condensed
  241.           D : Enlarged
  242.           E : NLQ
  243.           F : Bold
  244.           G : Double Strike
  245.           H : Italics
  246.           I : Superscript
  247.           J : Subscript
  248.           K : Underlined
  249.  
  250.  
  251. 4.5.8 <CURSOR KEYS>
  252.  
  253. When unshifted, these move the cursor around the screen as
  254. expected. When SHIFTed, UP and DOWN jump a screen of  text
  255. in the required direction. LEFT & RIGHT move one  word  in
  256. the required direction. [CONTROL] with LEFT and RIGHT move
  257. the cursor to the START / END of the  current  line.  When
  258. pressed with [CONTROL] UP and DOWN move to the START/  END
  259. of the text respectively.
  260.  
  261.  
  262. 4.5.9 [DEL],[RETURN] & [CLR]
  263.  
  264. These work as normal expect that  [CONTROL]+[DEL]  deletes
  265. the current line, and [RETURN] moves  to  the  first  NONE
  266. SPACE character of the next line. Note that if the  cursor
  267. is not at the left edge of a line (and if the current line
  268. is not blank) when [CONTROL] & [DEL] is pressed, then only
  269. the contents of the line will  be  deleted-the  line  will
  270. still exist (as a blank line).
  271.  
  272.  
  273. 4.5.10 "X" - Compress Text
  274.  
  275. This causes CTX to remove all surplus spaces from the ends
  276. of lines and to re-establish the true end  of  text.  This
  277. function is interrupt driven as it may take some  time  to
  278. complete.  Text  alterations  can   continue   while   the
  279. operation is working. When it has finished,  the  size  of
  280. the file and cursor position are displayed.
  281.  
  282. SAVE invokes this operation automatically.
  283.  
  284.  
  285. 4.5.11 [TAB]
  286.  
  287. Pressed with [SHIFT] sets or unsets a tab  stop.  Pressing
  288. [TAB] moves the cursor to  the  next  tab  stop.  Pressing
  289. [CONTROL] and [TAB] moves the cursor back to the  previous
  290. tab stop. TAB stops are shown on the bars both  above  and
  291. below the main text window. Note that attempting to  unset
  292. the left (and right) edge stops will clear all OTHER  stop
  293. positions-in particular, attempting to  change  the  right
  294. edge tab stop will return the tab stops to  their  default
  295. setting.
  296.  
  297.  
  298. 4.5.12 "G" - Where Am I ?
  299.  
  300. This shows the current cursor position and the free memory
  301. available for text. It is recommended that the user  press
  302. these keys occasionally to allow the computer to "reclaim"
  303. unused areas of its memory.
  304.  
  305. Alternatively,  the  position  update  brought  about   by
  306. allowing the cursor  to  blink  three  times  is  just  as
  307. effective.
  308.    ╩C H A P T E R   F O U RΩ
  309.  
  310.  
  311. ╩4. Transient ProgramsΩ
  312.  
  313. ╩4.2 CTX - Centrox Text EditorΩ
  314.  
  315. ╩DescriptionΩ :