home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 545a.lha / PowerVisor_v1.0 / docs.LZH / docs / GettingStarted < prev    next >
Encoding:
Text File  |  1991-09-01  |  25.7 KB  |  626 lines
  1. *--------------------------------------*
  2. * Tutorial : general use of PowerVisor * Sun Sep  1 14:46:12 1991
  3. *--------------------------------------*
  4.  
  5. ===================== Commands used in this tutorial =========================
  6.  
  7.    disp        Display integer
  8.    help        Ask for help
  9.    hold        Go to 'hold' mode (PowerVisor closes screen and window)
  10.    info        Give information on element in list
  11.    kill        Kill a task or process
  12.    list        Show a list (tasks, libraries, message ports, ...)
  13.    memory      List memory
  14.    mode        Set PowerVisor preferences
  15.    port        Go to the message port list
  16.    saveconfig  Save config file
  17.    task        Go to the task list
  18.    why         Ask more information about an error
  19.    prefs       Set/Get preferences for PowerVisor
  20.  
  21.  
  22. =========================== Starting PowerVisor ==============================
  23.  
  24. To ²²start PowerVisor, you can simply type (Before you continue, note that
  25. I assume that the ¹s:PowerVisor-config file does not exist and that the
  26. ¹s:PowerVisor-startup file is minimal (like on the original disk). If this
  27. is not the case some output may not be the same as in this tutorial. If
  28. you want to be absolutely sure, delete s:PowerVisor-config and
  29. ¹s:PowerVisor-startup (or rename them)) :
  30.  
  31. < pv <enter>
  32.  
  33. or
  34.  
  35. < run pv <enter>
  36.  
  37. (PowerVisor has ²commandline options but these are not important at this
  38. moment, see the reference section for more info)
  39.  
  40. Normally PowerVisor will now open a screen. If this does not work it
  41. is possible that you do not have enough memory. Quit some programs and
  42. try again. PowerVisor is not very memory consuming. Also note that
  43. you need the ¹powervisor.library (1.3 : and the ¹arp.library) installed
  44. in your libs: directory.
  45.  
  46. If everything is fine you will see the PowerVisor screen. This screen
  47. is very sober. The bottom line of the screen is the ¹¹stringgadget where
  48. you must type all PowerVisor commands. This stringgadget is automatically
  49. activated whenever the PowerVisor window becomes active.
  50.   (1.3 : due to a bug in AmigaDOS 1.2/1.3 you can get problems when you
  51.   use a ¹sunmouse like program. If the PowerVisor stringgadget is active,
  52.   no other window can be activated. If this happens you must activate
  53.   the window by clicking on it.)
  54. The stringgadget buffer is 400 bytes long by default. This is also the
  55. largest command that you can execute (you can change this value with
  56. the 'prefs' command, see the reference section).
  57. The rest of the screen is dedicated for PowerVisor output. After startup
  58. this screen is normally empty (except for the copyright message).
  59.  
  60. Because the PowerVisor commandline is a stringgadget you can use all
  61. ²editing facilities provided for stringgadgets.
  62.  
  63. You will also see a blue bar (this color may be different if you use other
  64. color preferences or if you use AmigaDOS 1.3) just below the screen bar
  65. containing the word 'Main' at the left and a strange box at the right.
  66. These things will be explained in the 'Screen' tutorial chapter.
  67.  
  68.  
  69. ================== Current list and some basic commands ======================
  70.  
  71. Left from the stringgadget is the ³³current list indicator. Default is
  72. 'task'. The ²current list is the list that is used for ²string parsing
  73. (see later) and the 'list' command. Try this :
  74.  
  75. < list <enter>
  76.  
  77. And you get something like this :
  78.  
  79. > Task node name      : Node     Pri StackPtr  StackS Stat Command         Acc
  80. > ----------------------------------------------------------------------------
  81. > RAM                 : 07E25260 00  07E2554E    1200 Rdy             PROC -
  82. > Background Process  : 07E26BA8 00  07E2CBD8    4000 Wait iprefs     (02) -
  83. > RexxMaster          : 07E39BA8 04  07E3A3EA    2048 Wait            (00) -
  84. > PowerSnap 1.0 by Nic: 07E48450 05  07E48C9A    2000 Wait            PROC -
  85. > SYS:System/CLI      : 07E52958 00  07E53862    4096 Wait            (00) -
  86. > CON                 : 07E569B8 05  07E574BA    3200 Wait            PROC -
  87. > Background CLI      : 07E654B0 00  07E65EFE    3200 Wait            (01) -
  88. > ramlib              : 07E1F680 00  07E1FE80    2048 Wait            PROC -
  89. > PowerVisor1.0.task  : 07E8CE60 00  07E8E656    1024 Wait            TASK -
  90. > console.device      : 07E0E1A2 00  07E0F1A4    4096 Wait            TASK -
  91. > SCSI bus handler    : 07E0AFD0 0C  07E0B3B6    1000 Wait            TASK -
  92. > scsi.device         : 07E0A3F8 0B  07E0A396    1000 Wait            TASK -
  93. > WB_2.x              : 07E11488 0A  07E11E4E    2400 Wait            PROC -
  94. > DF0                 : 07E17208 0A  07E17BCE    2400 Wait            PROC -
  95. > Workbench           : 07E548C8 01  07E568EE    8192 Wait            (05) -
  96. > Work                : 07E19940 0A  07E1A306    2400 Wait            PROC -
  97. > trackdisk.device    : 07E0F988 05  07E0FB96     512 Wait            TASK -
  98. > Background Process  : 07E3B4A0 00  07E5256C    4000 Wait clock      (03) -
  99. > input.device        : 07E08AF2 14  07E09AF8    4096 Wait            TASK -
  100. > Background Process  : 07E7BE08 04  07E7BAD6    4000 Run  pv         (04) -
  101.  
  102. You can also get this list by typing :
  103.  
  104. < list task <enter>
  105.  
  106. But since 'task' is the current list (at this moment) this is not
  107. necessary.
  108.  
  109. In this list you see all the tasks currently in the system. 'Node' is the
  110. address in memory, 'Pri' is the task priority (in hexadecimal), 'StackPtr'
  111. is the contents of A7 or SP, 'StackS' is the size of the stack, 'Stat'
  112. is the state of the task ('Rdy' for ready, 'Wait' for waiting and 'Run'
  113. for running) and 'Command' is the executing command (this is only for cli
  114. processes). After the command name you can see 'TASK' for tasks, 'PROC' for
  115. a process and '(xx)' for a cli. 'Acc' is for accounting information, it
  116. is disabled at this moment.
  117.  
  118. All hexadecimal numbers are padded with zeroes.
  119.  
  120. You can also go to another current list by typing the list name :
  121.  
  122. < p <enter>
  123.  
  124. (Note how the current list indicator has changed)
  125.  
  126. < l <enter>
  127.  
  128. Note that we used ¹abbreviations for the commands. 'l' is the same as
  129. 'list' and 'p' is equivalent to 'port'. Most commands can be
  130. abbreviated. You can type 'help commands' to see all commands with their
  131. ¹shortcuts (the capital letters represent the required bit of the command,
  132. all other characters are optional).
  133.  
  134. You get something like this :
  135.  
  136. > MsgPort node name   : Node     Pri SigBit SigTask
  137. > ----------------------------------------------------------------------------
  138. > REXX                : 07E2B13C 00      31 07E39BA8
  139. > AREXX               : 07E3A438 00      30 07E39BA8
  140. > PowerVisor1.0.port  : 07E81996 00       1 00000000
  141. > IPrefs.rendezvous   : 07E23800 E2      31 07E26BA8
  142. > SetPatch Port       : 07E23060 9C       0 00000000
  143.  
  144. Now we go back to the task list :
  145.  
  146. < t <enter>
  147.  
  148. or
  149.  
  150. < task <enter>
  151.  
  152. and ask a list :
  153.  
  154. < list <enter>
  155.  
  156. > Task node name      : Node     Pri StackPtr  StackS Stat Command         Acc
  157. > ----------------------------------------------------------------------------
  158. > RAM                 : 07E25260 00  07E2554E    1200 Rdy             PROC -
  159. > Background Process  : 07E26BA8 00  07E2CBD8    4000 Wait iprefs     (02) -
  160. > RexxMaster          : 07E39BA8 04  07E3A3EA    2048 Wait            (00) -
  161. > PowerSnap 1.0 by Nic: 07E48450 05  07E48C9A    2000 Wait            PROC -
  162. > SYS:System/CLI      : 07E52958 00  07E53862    4096 Wait            (00) -
  163. > CON                 : 07E569B8 05  07E574BA    3200 Wait            PROC -
  164. > Background CLI      : 07E654B0 00  07E65EFE    3200 Wait            (01) -
  165. > ramlib              : 07E1F680 00  07E1FE80    2048 Wait            PROC -
  166. > PowerVisor1.0.task  : 07E8CE60 00  07E8E656    1024 Wait            TASK -
  167. > console.device      : 07E0E1A2 00  07E0F1A4    4096 Wait            TASK -
  168. > SCSI bus handler    : 07E0AFD0 0C  07E0B3B6    1000 Wait            TASK -
  169. > scsi.device         : 07E0A3F8 0B  07E0A396    1000 Wait            TASK -
  170. > WB_2.x              : 07E11488 0A  07E11E4E    2400 Wait            PROC -
  171. > DF0                 : 07E17208 0A  07E17BCE    2400 Wait            PROC -
  172. > Workbench           : 07E548C8 01  07E568EE    8192 Wait            (05) -
  173. > Work                : 07E19940 0A  07E1A306    2400 Wait            PROC -
  174. > trackdisk.device    : 07E0F988 05  07E0FB96     512 Wait            TASK -
  175. > Background Process  : 07E3B4A0 00  07E5256C    4000 Wait clock      (03) -
  176. > input.device        : 07E08AF2 14  07E09AF8    4096 Wait            TASK -
  177. > Background Process  : 07E7BE08 04  07E7BAD6    4000 Run  pv         (04) -
  178.  
  179. Now we are going to ask some information about a task.
  180.  
  181. < info powervisor <enter>
  182.  
  183. and we get something like this :
  184.  
  185. > Task node name      : Node     Pri StackPtr  StackS Stat Command         Acc
  186. > ----------------------------------------------------------------------------
  187. > PowerVisor1.0.task  : 07E8CE60 00  07E8E656    1024 Wait            TASK -
  188. >
  189. > IDNestCnt    : 00       | TDNestCnt    : FF       | SigAlloc     : E000FFFF
  190. > SigWait      : E0000000 | SigRecvd     : 00000000 | SigExcept    : 00000000
  191. > TrapAlloc    : 8000     | TrapAble     : 0000     | ExceptData   : 00000000
  192. > ExceptCode   : 00F83A9C | TrapData     : 00000000 | TrapCode     : 07E810DE
  193. > SpLower      : 07E8E2A8 | SpUpper      : 07E8E6A8 | SpReg        : 07E8E656
  194. > MemEntry     : 07E8CEAA | UserData     : 00000000 |
  195.  
  196. This is the listing of the task structure. If you ask info about a
  197. process you get more information. If you ask info about a cli process
  198. you get even more information.
  199.   (1.3 : The amount of information is a bit less in 1.3 because there
  200.   are some new fields in AmigaDOS 2.0).
  201.  
  202. Because the task list was the current list we can use the names present
  203. in this list instead of the pointer to the task. This name is not case
  204. sensitive and need not be the complete name. All the following commands
  205. would be equivalent (see the 'Expressions' tutorial file for more
  206. info) :
  207.  
  208. < info powerv <enter>
  209.  
  210. < info 07E8CE60 <enter>
  211.  
  212. < info 07e8ce60 <enter>
  213.  
  214. < info 'PoWerVisor1.0.tASK' <enter>
  215.  
  216. < info task:powerv task <enter>
  217.  
  218. Look at the last command. We would have needed this notation if our current
  219. list wasn't the task list. The '<list>:' notation can be used everywhere.
  220. (Do not forget the extra 'task' argument, otherwise PowerVisor can crash)
  221.  
  222. You see that it can be handy to set the current list right.
  223.  
  224. Some commands (like 'kill', 'freeze', ...) do not need the current list.
  225. They automatically assume the current list which is right in most cases for
  226. that particular command (this feature is called '¹autodefault'). For
  227. example (Don't type this, because it can crash your Amiga !) :
  228.  
  229.     Go to another list :
  230.  
  231.     < port <enter>
  232.  
  233.     Try to kill the PowerVisor task :
  234.  
  235.     < kill powervisor <enter>
  236.  
  237.     Although the current list is 'port', you need not preceed 'powervisor'
  238.     with 'task:'. The 'kill' command automatically assumes the 'task' list.
  239.     If you still want to 'kill' a port you can always type :
  240.  
  241.     < kill port:someport <enter>
  242.  
  243. The 'info' command (see above) does not set it's own current list because
  244. it can be used on all lists.
  245.  
  246.  
  247. ============================== Snapping away =================================
  248.  
  249. It is not always possible to use names. If you have two tasks with the
  250. same name it would be ambiguous. In that case you must use the address of
  251. the task. Try the following :
  252.  
  253. List the screens :
  254.  
  255. < list scrs <enter>
  256.  
  257. and you will get something like this :
  258.  
  259. > Screen name         : Address  Left  Top Width Height FirstWindow
  260. > ----------------------------------------------------------------------------
  261. > PowerVisor   (V1.00 : 07E8EB20    0    0   692    452 07E8F818
  262. > Other screen        : 07E748E0    0    0   704    456 07E753F8
  263. > Workbench Screen    : 07E3AF88    0 -572   692   1024 07E507C8
  264.  
  265. Type (Don't press enter)
  266.  
  267. < info <space>
  268.  
  269. and position the mouse on the address 07E8EB20 :
  270.  
  271. < <click left mouse button> scrs
  272.  
  273. On the commandline there should now be something like 'info 07E8EB20 scrs'.
  274.  
  275. < <click right mouse button>
  276. or
  277. < <enter>
  278.  
  279. and we get :
  280.  
  281. > Screen name         : Address  Left  Top Width Height FirstWindow
  282. > ----------------------------------------------------------------------------
  283. > PowerVisor   (V1.00 : 07E8EB20    0    0   692    452 07E8F818
  284. >
  285. > Flags        : 021F     | Font         : 07E8ECA6 | ViewPort     : 07E8EB4C
  286. > RastPort     : 07E8EB74 | BitMap       : 07E8EBD8 | FirstGadget  : 07E7D17C
  287. > DefaultTitle : PowerVisor   (V1.00 beta)
  288. > DetailPen    : 00       | BlockPen     : 01       | ExtData      : 00000000
  289. > UserData     : 00000000 | BarHeight    : 0A       | BarVBorder   : 01
  290. > BarHBorder   : 05       | MenuVBorder  : 02       | MenuHBorder  : 04
  291. > WBorTop      : 02       | WBorLeft     : 04       | WBorRight    : 04
  292. > WBorBottom   : 02       | LayerInfo    : 07E8EC00 | BarLayer     : 07E8F650
  293. >
  294. > Flags: CUSTOMSCREEN SHOWTITLE SCREENHIRES
  295.  
  296. This feature of PowerVisor is called '¹snapping'. The left mouse button
  297. copies the word under the mousepointer to the stringgadget. The right mouse
  298. button is equivalent to <enter>. If you snap a word PowerVisor will
  299. automatically add a space to the commandline below. If you do not like this
  300. you can disable this feature with the 'mode' command (see the reference
  301. section).
  302.  
  303. Also note the special form of the 'info' command. The second argument to
  304. 'info' is optional and is a name of a list. You MUST use the second argument
  305. if you want info about something that is not in the current list. Otherwise
  306. 'info' will try to interprete a screen as a task or something else. This
  307. could crash the Amiga !
  308.  
  309.  
  310. =========================== PowerVisor hot key ===============================
  311.  
  312. Go to the Workbench screen :
  313.  
  314. < <left amiga> n
  315.  
  316. If you want PowerVisor back you can use the ¹hotkey (if you have QWERTY):
  317.  
  318. < <right alt>+<right shift>+/
  319.  
  320. For any other keyboard you must press the key left from the <right shift>
  321. key.
  322.  
  323. The PowerVisor screen snaps back to life.
  324.  
  325. You can also use this key combination if PowerVisor is in hold-mode.
  326.  
  327. < hold <enter>
  328.  
  329. The PowerVisor screen disappears.
  330.  
  331. < <right alt>+<right shift>+/
  332.  
  333. The PowerVisor screen is opened again.
  334.  
  335. This keycombination can be redefined with the 'prefs' command (see
  336. 'InstallingPowerVisor' section).
  337.  
  338.  
  339. ================================= Errors =====================================
  340.  
  341. Everybody makes mistakes. Therefore PowerVisor needs some sort of
  342. ²error handling. Make sure that you have the following files installed in you
  343. 's:' directory before you continue: ¹PowerVisor-errors, ¹PowerVisor-help and
  344. ¹PowerVisor-ctrl.
  345.  
  346. Try this :
  347.  
  348. < task <enter>
  349. < list <enter>
  350.  
  351. > Task node name      : Node     Pri StackPtr  StackS Stat Command         Acc
  352. > ----------------------------------------------------------------------------
  353. > RAM                 : 07E25260 00  07E2554E    1200 Rdy             PROC -
  354. > Background Process  : 07E26BA8 00  07E2CBD8    4000 Wait iprefs     (02) -
  355. > RexxMaster          : 07E39BA8 04  07E3A3EA    2048 Wait            (00) -
  356. > PowerSnap 1.0 by Nic: 07E48450 05  07E48C9A    2000 Wait            PROC -
  357. > SYS:System/CLI      : 07E529C0 00  07E538CA    4096 Wait            (00) -
  358. > ramlib              : 07E1F680 00  07E1FE80    2048 Wait            PROC -
  359. > CON                 : 07E56A20 05  07E57522    3200 Wait            PROC -
  360. > Background CLI      : 07E65518 00  07E65F66    3200 Wait            (01) -
  361. > console.device      : 07E0E1A2 00  07E0F1A4    4096 Wait            TASK -
  362. > SCSI bus handler    : 07E0AFD0 0C  07E0B3B6    1000 Wait            TASK -
  363. > scsi.device         : 07E0A3F8 0B  07E0A396    1000 Wait            TASK -
  364. > WB_2.x              : 07E11488 0A  07E11E4E    2400 Wait            PROC -
  365. > DF0                 : 07E17208 0A  07E17BCE    2400 Wait            PROC -
  366. > Workbench           : 07E54930 01  07E56956    8192 Wait            (05) -
  367. > PowerVisor1.0.task  : 07E8FD10 00  07E90BA6    1024 Wait            TASK -
  368. > Work                : 07E19940 0A  07E1A306    2400 Wait            PROC -
  369. > trackdisk.device    : 07E0F988 05  07E0FB96     512 Wait            TASK -
  370. > Background Process  : 07E3B4A0 00  07E52354    4000 Wait clock      (03) -
  371. > input.device        : 07E08AF2 14  07E09AF8    4096 Wait            TASK -
  372. > Background Process  : 07E7BF18 04  07E800B6    4000 Run  pv         (04) -
  373.  
  374. < info07E8FD10 <enter>
  375.  
  376. > Syntax Error !
  377.  
  378. Now you have done something wrong ! But what ? Well we should ask
  379. PowerVisor :
  380.  
  381. < why <enter>
  382.  
  383. > Syntax Error !
  384. >    You typed a command that powervisor did not understand, or some
  385. >    of your arguments are badly formed.
  386.  
  387. The 'why' command can be very handy sometimes. You now notice that you forgot
  388. a <space> between 'info' and '07E8FD10'.
  389.  
  390.  
  391. ================================ Templates ===================================
  392.  
  393. If you forgot the ¹syntax for some command you can ask the ²command template.
  394.  
  395. < memory? <enter>
  396. or
  397. < memory ? <enter>
  398.  
  399. > Memory [<start> [<bytes>]]
  400.  
  401. You can read the following information from this output :
  402.    - You can use 'm' as an abbreviation for 'memory' (the uppercase
  403.      part of the command 'Memory')
  404.    - <start> is an optional argument
  405.    - <bytes> is also optional but you must supply a <start> value if
  406.      you want to supply a <bytes> value.
  407.  
  408. The templates for these commands are located in the '¹PowerVisor-help' file.
  409. You can also show the template using the 'help' command :
  410.  
  411. < help memory_tmp <enter>
  412. > Memory [<start> [<bytes>]]
  413.  
  414. This is the only way to ask a template for an ²ARexx command that has no
  415. equivalent on the PowerVisor commandline :
  416.  
  417. < help assign_tmp <enter>
  418. > ASSIGN <assignment string>
  419.  
  420. (Note that 'ASSIGN' is completely in uppercase. This is normal because
  421. in ¹ARexx you can't use ³abbreviations for commands)
  422.  
  423.  
  424. ========================= Interrupting PowerVisor ============================
  425.  
  426. Try the following :
  427.  
  428. < memory <enter>
  429.  
  430. or
  431.  
  432. < m <enter>
  433.  
  434. and you get something like :
  435.  
  436. > 00000000: 00000000  07E007E4  00F807FA  00F80ADE           ................
  437. > 00000010: 00F80AA2  00F80AA4  00F80AA6  00F80AA8           ................
  438. > 00000020: 00F80BC8  00F80AAC  00F80AAF  00F80AB0           ................
  439. > 00000030: 00F80AB2  00F80AB4  00F80AB6  00F80AB8           ................
  440. > 00000040: 00F80ABA  00F80ABC  00F80ABE  00F80AC0           ................
  441. > 00000050: 00F80AC2  00F80AC4  00F80AC6  00F80AC8           ................
  442. > 00000060: 00F80ACA  00F810BC  00F8111A  00F81150           ...............P
  443. > 00000070: 00F811AE  00F81244  00F8128E  00F812D8           .......D........
  444. > 00000080: 00F80B38  00F80B3A  00F80B3C  00F80B3E           ...8...:...<...>
  445. > 00000090: 00F80B40  00F80B42  00F80B44  00F80B46           ...@...B...D...F
  446. > 000000A0: 00F80B48  00F80B4A  00F80B4C  00F80B4E           ...H...J...L...N
  447. > 000000B0: 00F80B50  00F80B52  FFFFFFFF  00F80B56           ...P...R.......V
  448. > 000000C0: 00F80B58  00F80B5A  00F80B5C  00F80B5E           ...X...Z...\...^
  449. > 000000D0: 00F80B60  00F80B62  00F80B64  00F80B66           ...`...b...d...f
  450. > 000000E0: 00F80B68  00F80B6A  00F80B6C  00F80B6E           ...h...j...l...n
  451. > 000000F0: 00F80B70  00F80B72  00F80B74  00F80B76           ...p...r...t...v
  452. > 00000100: 66FFE6FC  66D7FE08  66FFAEF7  00000000           f...f...f.......
  453. > 00000110: 66FF6EFA  66FBE67F  66FFAE7F  66FF66F1           f.n.f..f..f.f.
  454. > 00000120: 66FFF6FB  66F7E6DF  66FFE67F  66FF6EF7           f...f...f..f.n.
  455. > 00000130: 66FF66F9  66FF67FF  66FF6EFF  66DFB6E7           f.f.f.g.f.n.f...
  456.  
  457. This is a memory listing.
  458.  
  459. Now try this :
  460.  
  461. < memory 0 100000 <enter>
  462.  
  463. PowerVisor will now list 100000 bytes beginning at 0 :
  464.  
  465. > 00000000: 00000000  07E007E4  00F807FA  00F80ADE           ................
  466. > 00000010: 00F80AA2  00F80AA4  00F80AA6  00F80AA8           ................
  467. > 00000020: 00F80BC8  00F80AAC  00F80AAF  00F80AB0           ................
  468. > 00000030: 00F80AB2  00F80AB4  00F80AB6  00F80AB8           ................
  469. > 00000040: 00F80ABA  00F80ABC  00F80ABE  00F80AC0           ................
  470. > 00000050: 00F80AC2  00F80AC4  00F80AC6  00F80AC8           ................
  471. > 00000060: 00F80ACA  00F810BC  00F8111A  00F81150           ...............P
  472. > 00000070: 00F811AE  00F81244  00F8128E  00F812D8           .......D........
  473. > 00000080: 00F80B38  00F80B3A  00F80B3C  00F80B3E           ...8...:...<...>
  474. > 00000090: 00F80B40  00F80B42  00F80B44  00F80B46           ...@...B...D...F
  475. > 000000A0: 00F80B48  00F80B4A  00F80B4C  00F80B4E           ...H...J...L...N
  476. > 000000B0: 00F80B50  00F80B52  FFFFFFFF  00F80B56           ...P...R.......V
  477. > ...
  478.  
  479. If the page is full PowerVisor will wait for you. The ³current list indicator
  480. changes to '-MORE-'. Press <space> everytime you want to proceed to the
  481. next page. If you want to stop this listing you can press <esc>.
  482.  
  483. You can use the <esc> key to interrupt PowerVisor whenever you want. Or you
  484. can use the <right-alt>+<help> key to pause the PowerVisor output.
  485.  
  486. Note that if you do not want PowerVisor to stop at each page you can use
  487. the 'mode' command to disable this feature :
  488.  
  489. < mode nomore <enter>
  490.  
  491. < memory 0 100000 <enter>
  492.  
  493. > 00000000: 00000000  07E007E4  00F807FA  00F80ADE            ................
  494. > 00000010: 00F80AA2  00F80AA4  00F80AA6  00F80AA8            ................
  495. > 00000020: 00F80BC8  00F80AAC  00F80AAF  00F80AB0            ................
  496. > 00000030: 00F80AB2  00F80AB4  00F80AB6  00F80AB8            ................
  497. > 00000040: 00F80ABA  00F80ABC  00F80ABE  00F80AC0            ................
  498. > 00000050: 00F80AC2  00F80AC4  00F80AC6  00F80AC8            ................
  499. > 00000060: 00F80ACA  00F810BC  00F8111A  00F81150            ...............P
  500. > 00000070: 00F811AE  00F81244  00F8128E  00F812D8            .......D........
  501. > 00000080: 00F80B38  00F80B3A  00F80B3C  00F80B3E            ...8...:...<...>
  502. > 00000090: 00F80B40  00F80B42  00F80B44  00F80B46            ...@...B...D...F
  503. > 000000A0: 00F80B48  00F80B4A  00F80B4C  00F80B4E            ...H...J...L...N
  504. > 000000B0: 00F80B50  00F80B52  FFFFFFFF  00F80B56            ...P...R.......V
  505. > ...
  506.  
  507. < <esc>
  508.  
  509. < mode more <enter>
  510.  
  511. The interrupt and pause keys can be redefined with the 'prefs' command.
  512. (See the 'Screen' tutorial file for more info about 'more')
  513. (See the 'InstallingPowerVisor' file for more info about the 'prefs' command)
  514.  
  515.  
  516. ============================= History buffer =================================
  517.  
  518. PowerVisor has a ²history buffer so you can easily retrieve previous commands.
  519. This can be handy if you want to repeat a command a few times, or if you
  520. want to correct an error in a commandline.
  521.  
  522. For example type :
  523.  
  524. < help <enter>
  525. > PowerVisor help (1.0 Beta/2.0 Beta)
  526. > -----------------------------------
  527. > (Sat Apr 27 16:13:39 1991)
  528. > You can type one of the following for more information on a specific
  529. > item:
  530. >
  531. >       help                 for this screen
  532. >       help general         for general information
  533. >
  534. >       help commands        for a list of all available commands
  535. >       help functions       for a list of all available functions
  536. >       help syslists        for a list of all available lists
  537. >       help <command>_cmd   gives help for a specific command
  538. >       help <command>_tmp   gives a command template (or <command> ?)
  539. >       help <function>_func gives help for a specific function
  540. >       help <list>_list     gives help for a specific list
  541. >
  542. >       help cmdline         shows all the commandline options available
  543. >       help arguments       gives help for all possible argument types
  544. >       help libfuncs        information about library functions
  545. >       help bugs            for all bugs in the current version
  546. >       help debugging       for general debugging help
  547. >
  548. > You can use abbreviations ('h gen' instead of 'help general')
  549. > Note that you could get the wrong help when you do this.
  550. > ('help li' will probably not give what you wanted: list, libfuncs, ...)
  551.  
  552. < <arrow up>
  553.  
  554. On the commandline appears 'help', this is the previous command.
  555.  
  556. Use the stringgadget key to go to the end of the line :
  557.  
  558. < <shift>+<arrow right>
  559.  
  560. < <space> general <enter>
  561.  
  562. Now you have executed the command 'help general'.
  563.  
  564. > Help general
  565. > ------------
  566. > You can type one of the following for more information on a specific
  567. > item:
  568. >
  569. >       help snap            for the screen snap feature
  570. >       help keys            for information about keys
  571. >       help input           for info about the input editing possibilities
  572. >       help redirection     for redirection to a file
  573. >       help files           for all the files PowerVisor uses
  574. >       help historybuf      the history buffer
  575. >       help portprint       for the portprint facility
  576. >       help autodefault     for the automatic default feature
  577. >       help templates       for the template feature
  578.  
  579. You can use the <arrow up> and <arrow down> keys to scroll in the
  580. ²history buffer. Normally only 20 lines are remembered in the history buffer.
  581. Try this :
  582.  
  583. < prefs history <enter>
  584. > 00000014 , 20
  585.  
  586. < prefs history 100 <enter>
  587.  
  588. < prefs history <enter>
  589. > 00000064 , 100
  590.  
  591. You see that you can change the maximum number of lines in the history with
  592. the 'prefs' command. Note that setting another number clears the history
  593. buffer. (Also see the 'InstallingPowerVisor' file for more info about
  594. the 'prefs' command)
  595.  
  596.  
  597. =================== Making a Config file for PowerVisor ======================
  598.  
  599. PowerVisor uses the ¹¹s:PowerVisor-config file (if present) to set default
  600. preferences. This file contains, for example, the value of the 'mode'
  601. variable. If you have installed PowerVisor as you wish (with the 'mode'
  602. command) you can use 'saveconfig' to save the config file.
  603.  
  604. The s:PowerVisor-config file contains the following information :
  605.  
  606.    - All things you can set with the 'mode' command
  607.    - All things you can set with the 'prefs' command
  608.      Some examples :
  609.          - The maximum length for a commandline
  610.          - Some default values for logical windows
  611.          - Some keydefinitions
  612.          - historybuffer length
  613.          - startup on workbench screen instead of own screen
  614.          - ...
  615.  
  616. I recommend that you work with the default values until you now more about
  617. PowerVisor. Especially the logical window preferences are difficult to set
  618. right if you are a first time user. If you think you can cope you can
  619. read the 'InstallingPowerVisor' file.
  620.  
  621.  
  622. ================================= The end ====================================
  623.  
  624. This is it. Now you can get started with the real work, but I recommend that
  625. you read the 'Expressions' tutorial file first.
  626.