home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / database / adbrows1.arj / ADBROWSE.HLP < prev    next >
Encoding:
Text File  |  1991-12-01  |  19.3 KB  |  522 lines
  1. ~
  2. DVIEW
  3. These are the Browse navigation keys:
  4.  
  5.    ∞ [F1] - displays a context-sensitive Help screen.
  6.    ∞ [SHIFT-F1] - displays this "Using A DATABASE VIEWER" Help 
  7.      screen.
  8.    ∞ [CTRL-F1] - displays a menu of Help screens.
  9.    ∞ [ALT-F1] - displays a " Using HELP " screen.
  10.    ∞ [ESC] - may or maynot exit the viewer.  See the
  11.      context-sensitive Help screen for its actual behavior.
  12.    ∞ [UP] - moves the highlight one record up.
  13.    ∞ [DOWN] - moves the highlight one record down.
  14.    ∞ [CTRL-PGUP] - moves the highlight to the first record.
  15.    ∞ [CTRL-PGDN] - moves the highlight to the last record.
  16.    ∞ [PGUP] - scrolls the display one box up if there are many 
  17.      records.
  18.    ∞ [PGUP] - scrolls the display one box down if there are 
  19.      many records.
  20.    ∞ [LEFT] - moves the highlight one field left.
  21.    ∞ [RIGHTT] - moves the highlight one field right.
  22.    ∞ [HOME] - moves the highlight to the first visible field.
  23.    ∞ [END] - moves the highlight to the last visible field.
  24.    ∞ [CTRL-HOME] - moves the highlight to the first field.
  25.    ∞ [CTRL-END] - moves the highlight to the last field.
  26.  
  27. Other keys may be active.  They are described in the context-
  28. sensitive Help screens.
  29.  
  30. If you are using a mouse, you may click the left button on the
  31. following hot areas:
  32.  
  33.    ∞ A value - moves the highlight to that item.
  34.    ∞ The top/right corner - moves the highlight to the first
  35.      record.
  36.    ∞ The bottom/right corner - moves the highlight to the last
  37.      record.
  38.    ∞ The top line between the left corner and the middle of the
  39.      line - moves the highlight one record up.
  40.    ∞ The bottom line between the left corner and the middle of
  41.      the line - moves the highlight one record down.
  42.    ∞ The top line between the right corner and the middle of the
  43.      line - scrolls the box one screen up.
  44.    ∞ The bottom line between the right corner and the middle of
  45.      the line - scrolls the box one screen down.
  46.    ∞ The left line pans the display to the left.
  47.    ∞ The right line pans the display to the right.
  48.  
  49. Clicking the right button may or maynot exit the viewer.  See
  50. the context-sensitive Help screen for the actual behavior of
  51. the right button.
  52.  
  53. Other mouse hot areas are described in the context-sensitive
  54. Help screens.
  55. ~
  56. ACHOICE
  57. These are the standard active keys:
  58.  
  59.    ∞ [F1] - displays a context-sensitive Help screen.
  60.    ∞ [SHIFT-F1] - displays this "Using A Picklist" Help 
  61.      screen.
  62.    ∞ [CTRL-F1] - displays a menu of Help screens.
  63.    ∞ [ALT-F1] - displays a " Using HELP " screen.
  64.    ∞ [ENTER] - selects the highlighted item.
  65.    ∞ [ESC] - aborts the selection.
  66.    ∞ [UP] - moves the highlight one item up.
  67.    ∞ [DOWN] - moves the highlight one item down.
  68.    ∞ [CTRL-PGUP] - moves the highlight to the first item.
  69.    ∞ [CTRL-PGDN] - moves the highlight to the last item.
  70.    ∞ [PGUP] - scrolls the display one box up if there are many 
  71.      options.
  72.    ∞ [PGUP] - scrolls the display one box down if there are 
  73.      many options.
  74.    ∞ The first letter of an item - moves the highlight to that
  75.      item.  This may or maynot automatically select the item. 
  76.      See the context-sensitive Help screen for an exact
  77.      description of the behavior.
  78.  
  79. Additional keys may be active.  They are described in the
  80. context-sensitive Help screens.
  81.  
  82. If your mouse is active, you may click the left button on the
  83. following places:
  84.  
  85.    ∞ An item in the box - selects it.
  86.    ∞ The top/right corner - moves the highlight to the first
  87.      item.
  88.    ∞ The bottom/right corner - moves the highlight to the last
  89.      item.
  90.    ∞ The top line between the left corner and the middle of the
  91.      line - moves the highlight one item up.
  92.    ∞ The bottom line between the left corner and the middle of
  93.      the line - moves the highlight one item down.
  94.    ∞ The top line between the right corner and the middle of the
  95.      line - scrolls the box one screen up.
  96.    ∞ The bottom line between the right corner and the middle of
  97.      the line - scrolls the box one screen down.
  98.  
  99. You may click the right button to abort selection.
  100.  
  101. Other screen areas that can be clicked are defined in context-
  102. sensitive Help scrrens.
  103. ~
  104. ACHOICE_M
  105. These active keys are common to all Multi-Selectors.
  106.  
  107.    ∞ [F1] - displays a context-sensitive Help screen.
  108.    ∞ [SHIFT-F1] - displays this "Using A Multi-Selector" Help 
  109.      screen.
  110.    ∞ [CTRL-F1] - displays a menu of Help screens.
  111.    ∞ [ALT-F1] - displays a " Using HELP " screen.
  112.    ∞ [ENTER] - checkmarks an unmarked item, or un-checkmarks a
  113.      marked item.
  114.    ∞ [TAB] - selects the marked items.  Make sure you have
  115.      marked at least one menu item.
  116.    ∞ [ESC] - aborts the selection.
  117.    ∞ [UP] - moves the highlight one item up.
  118.    ∞ [DOWN] - moves the highlight one item down.
  119.    ∞ [CTRL-PGUP] - moves the highlight to the first item.
  120.    ∞ [CTRL-PGDN] - moves the highlight to the last item.
  121.    ∞ [PGUP] - scrolls the display one box up if there are many 
  122.      options.
  123.    ∞ [PGUP] - scrolls the display one box down if there are 
  124.      many options.
  125.    ∞ The first letter of an item - moves the highlight to that
  126.      item.
  127.  
  128. Additional keys may be active.  They are described in the
  129. context-sensitive Help screens.
  130.  
  131. If your mouse is active, you may click the left button on the
  132. following hot areas:
  133.  
  134.    ∞ An item in the box - checkmarks it.
  135.    ∞ The top/right corner - moves the highlight to the first
  136.      item.
  137.    ∞ The bottom/right corner - moves the highlight to the last
  138.      item.
  139.    ∞ The top line between the left corner and the middle of the
  140.      line - moves the highlight one item up.
  141.    ∞ The bottom line between the left corner and the middle of
  142.      the line - moves the highlight one item down.
  143.    ∞ The top line between the right corner and the middle of the
  144.      line - scrolls the box one screen up.
  145.    ∞ The bottom line between the right corner and the middle of
  146.      the line - scrolls the box one screen down.
  147.    ∞ The bottom/left corner - selects the marked items.  Make
  148.      sure you have marked at least one menu item.
  149.  
  150. You may click the right button to abort selection.
  151.  
  152. Other screen areas that can be clicked are defined in context-
  153. sensitive Help scrrens.
  154. ~
  155. BOXMENU
  156. These active keys are common to all Box Menus:
  157.  
  158.    ∞ [F1] - displays a context-sensitive Help screen.
  159.    ∞ [SHIFT-F1] - displays this "Using A Box Menu" Help screen.
  160.    ∞ [CTRL-F1] - displays a menu of Help screens.
  161.    ∞ [ALT-F1] - displays a " Using HELP " screen.
  162.    ∞ [ENTER] - selects the highlighted item.
  163.    ∞ [ESC] - may or maynot abort the selection.  See the
  164.      context-sensitive Help screen for actual behavior.
  165.    ∞ [LEFT] - moves the highlight one item left.
  166.    ∞ [RIGHT] - moves the highlight one item right.
  167.    ∞ The first letter of an item - selects that item.
  168.  
  169. If your mouse is active, you may click the left button on a
  170. menu item to select it.  Clicking the right button may or
  171. maynot abort the selection.  Refer to the context-sensitive
  172. Help screen for actual behaviour.
  173. ~
  174. NOCHOICE
  175. You have not marked any item in the multi-selector.  Select "GO
  176. BACK" to return to it, or "ABORT" to abort the selection.
  177.  
  178. To checkmark a selection press [ENTER] or click with the mouse
  179. left button.
  180. ~
  181. USEDBF
  182. Select all the databases you want to open by checkmarking them
  183. with [ENTER].  Then press [TAB] to open them.  Press [ESC] if
  184. you want to abort the selection process.  [F2] displays the
  185. structure of the highlighted database.  You may open as many
  186. databases as your configuration can provide file handles for.
  187.  
  188. If you are using a mouse, click areas in the buttom menu to
  189. initiate an action.  Clicking the right button aborts the
  190. selection process.
  191.  
  192. For a general description of how to use a multi-selector, press
  193. [SHIFT-F1].
  194. ~
  195. BROWSE
  196. Below is a list of functions available while you are browsing
  197. the current database:
  198.  
  199.    ∞ [F1] - displays this Help screen.
  200.    ∞ [SHIFT-F1] - displays "Viewing a Database" Help screen.
  201.    ∞ [CTRL-F1] - displays a menu of Help screens.
  202.    ∞ [ALT-F1] - displays a " Using HELP " screen.
  203.    ∞ [F2] - displays the next open database.
  204.    ∞ [ALT-F2] - displays a picklist of open databases.  Select
  205.      the one you want to display.
  206.    ∞ [F3] - displays a multi-selector of databases found in the
  207.      current directory.  You may open one or more.  You may
  208.      open again one that is currently open.  Each view works
  209.      independently of each other.
  210.    ∞ [ALT-F3] - closes the current database.
  211.    ∞ [F4] - displays a submenu of indexing functions: open
  212.      indexes, close indexes, change the master index, build a
  213.      new index, and rebuild all open indexes.
  214.    ∞ [F5] - lists the current database to a text file, or to
  215.      the line printer.
  216.    ∞ [ESC] - exits to DOS.
  217.  
  218. You may also use the mouse left button to click at the options
  219. in the buttom menu.  Clicking the menu's horizontal line
  220. toggles the menu display between the F-options and the
  221. A-options (regular function keys and alt-function keys). 
  222. ~
  223. INDEX
  224. The following index options are available:
  225.  
  226.    ∞ [F1] - displays this Help screen.
  227.    ∞ [F2] - opens up to 15 indexes via a multi-selector.  If no
  228.      index exists, an appropriate message appears.  In that
  229.      case, pressing [F5] will create one for you.
  230.    ∞ [F3] - closes all open indexes in current workarea.
  231.    ∞ [F4] - selects the master index.
  232.    ∞ [F5] - builds a new index.  It closes all currently open
  233.      indexes before building and automatically opening the new
  234.      one.
  235.    ∞ [F6] - rebuilds the currently open indexes in the current
  236.      area.
  237.    ∞ [ESC] - returns to the main Browse menu.
  238.  
  239. You may use the mouse left button to make a selection.
  240. ~
  241. OPENNTX
  242. Select all the indexes you want to open by checkmarking them
  243. with [ENTER].  Then press [TAB] to open them.  Press [ESC] if
  244. you want to abort the selection process.  [F2] displays the
  245. indexkey of the highlighted index.  You may open as many as 15
  246. indexes as long as your configuration can provide file handles
  247. for them.
  248.  
  249. If you attempt to open an incompatible index, ADBROWSE will
  250. refuse to do so.
  251.  
  252. If you are using a mouse, click areas in the buttom menu to
  253. initiate an action.  Clicking the right button aborts it.
  254.  
  255. For a general description of how to use a multi-selector, press
  256. [ALT-F1].
  257. ~
  258. MASTERNTX
  259. Select from the picklist of currently open indexes the one you
  260. want to make the master.  The current master is the initially
  261. higlighted index.  "NATURAL" displays the database into its
  262. natural order without closing the indexes.  The following are
  263. the active keys:
  264.  
  265.    ∞ [F1] - displays this Help screen.
  266.    ∞ [SHIFT-F1] - displays the "Using a PICKLIST" Help screen.
  267.    ∞ [CTRL-F1] - displays a menu of Help screens.
  268.    ∞ [ALT-F1] - displays a " Using HELP " screen.
  269.    ∞ [F2] - displays the indexkey of the currently higlighted
  270.      index.
  271.    ∞ [ENTER] - selects the highlighted index.
  272.    ∞ [ESC] - aborts the selection.
  273.  
  274. You may select with the by clicking with the left button the
  275. name of the index you want to open.  You may also click any of
  276. the options in the bottom menu.
  277. ~
  278. BUILDNTX
  279. Supply the index filename and the index key expression.  Press
  280. [ENTER] to accept an entry, [ESC] to abort the creation pro-
  281. cess.
  282.  
  283. The file name may not contain an extension.  ".NTX" is assumed.
  284. If a file of the same name already exists, it will be 
  285. overwritten without warning.
  286.  
  287. The maximum length of the index key is 250 spaces. Only 53 
  288. characters are displayed at any time, but the entry is scrolled
  289. automatically horizontally.  You may also press [TAB] to expand
  290. the data entry field.  When in expanded mode, upper-casing is
  291. not automatic.  Also, there is no automatic counting of the
  292. number of characters already entered.  Anything beyond 250 is
  293. truncated.  If it contains an invalid expression, ADBROWSE will
  294. reject it.  
  295.  
  296. If the index is successfully created, all currently open
  297. indexes will be closed, and the new index is opened.
  298. ~
  299. LIST
  300. This function sends an image of the current database to the
  301. line printer or to a text file.  Select the fields you want to
  302. include in the list by checkmarking them in the picklist box.
  303.  
  304. These keys are active while selecting fields:
  305.  
  306.    ∞ [F1] - displays this Help screen.
  307.    ∞ [SHIFT-F1] - displays a "Using a MULTI-SELECTOR" Help
  308.      screen.
  309.    ∞ [CTRL-F1] - displays a menu of Help screens.
  310.    ∞ [ALT-F1] - displays a " Using HELP " screen.
  311.    ∞ [F2] - displays the attributes (type, length, and
  312.      decimals) of the highlighted field.
  313.    ∞ [ENTER] - selects the marked fields.
  314.    ∞ [ESC] - aborts the selection.
  315.  
  316. You may use the mouse by clicking with the left button the
  317. options displayed at the bottom of the screen.
  318. ~
  319. LIST:DEST
  320.    ∞ PRINTER - sends the database image to the line printer. 
  321.      If the printer is not ready, ADBROWSE will ask you to
  322.      retry or abort.
  323.  
  324.    ∞ [FILE] - sends the database image to a text file which
  325.      will be named XXXXXXXX.LST, where XXXXXXXX is the name of
  326.      the database.
  327.  
  328.    ∞ [DESIGN] - designs the format of the list, e.g., page
  329.      length, page width, top margin, left margin, maximum
  330.      column width.
  331.  
  332.    ∞ [ABORT] - aborts the list command.
  333. ~
  334. LIST:DESIGN
  335.    ∞ Page Width - number of spaces in a line.  This will
  336.      depend on the printer setting.  For example: If the paper
  337.      size is 8.5 x 11, the orientation is Portrait, and the
  338.      pitch is 10 cpm, the maximum number of characters per line
  339.      is 80.  You may then specify a page width of 80 or less. 
  340.  
  341.      If the fields cannot be accommodated in the specified page
  342.      width, ADBROWSE will organize the database into one or
  343.      more horizontal pages.
  344.  
  345.    ∞ Page Length - number of lines in a page.  This will
  346.      depend on the printer setting.  For example: If the paper
  347.      size is 8.5 x 11, the orientation is Portrait, and the
  348.      lines-per-inch setting is 6, the maximum number of lines
  349.      per page is 66.  ADBROWSE will send a page break every 66
  350.      lines.  Each new page will have its own column headings.
  351.  
  352.      Specify a high number, like 999999, if you do not want any
  353.      page breaks.
  354.  
  355.    ∞ Top Margin - number of blank lines to preceed the column
  356.      titles.
  357.  
  358.    ∞ Left Margin - number of spaces added to the left of a
  359.      line.
  360.  
  361.    ∞ Bottom Margin - number of blank lines at the bottom of
  362.      every page.
  363.  
  364.    ∞ Max Column Width - maximum number of spaces allocated for
  365.      long character and memo fields.  It defaults to Page Width
  366.      less Left Margin less Right Margin.  That is also the
  367.      maximum value allowed.
  368. ~
  369. NEXTLIST
  370. Select from the picklist of currently open databases the one you
  371. want to make the current database. The following are the active
  372. keys:
  373.  
  374.    ∞ [F1] - displays this Help screen.
  375.    ∞ [SHIFT-F1] - displays the "Using a PICKLIST" Help screen.
  376.    ∞ [CTRL-F1] - displays a menu of Help screens.
  377.    ∞ [ALT-F1] - displays a " Using HELP " screen.
  378.    ∞ [F2] - displays the structure of the currently higlighted
  379.      database.
  380.    ∞ [ENTER] - selects the highlighted database.
  381.    ∞ [ESC] - aborts the selection.
  382.  
  383. You may select with the by clicking with the left button the
  384. name of the database you want to make the current database.  You
  385. may also click any of the options in the bottom menu.
  386. ~
  387. EXIT
  388. Select [YES] to leave ADBROWSE and exit to DOS.
  389. Select [NO] to return to ADBROWSE.
  390.  
  391. If you want to display another open database, press [F2] or
  392. [ALT-F2] while browsing the current database.
  393. ~
  394. HELP
  395. ADBROWSE has four HELP keys:
  396.  
  397.    ∞ [F1] - displays a context-sensitive Help screen.
  398.    ∞ [SHIFT-F1] - displays a Help screen that describes the
  399.      use the current user-interface, e.g., "Using a Picklist",
  400.      "Viewing A Database", etc.
  401.    ∞ [CTRL-F1] - displays a picklist of Help screens.
  402.    ∞ [ALT-F1] - displays this "Using HELP" screen.
  403.  
  404. When viewing a Help screen, the following keys may be used
  405. to scroll it:
  406.  
  407.    ∞ [DOWN] - scrolls one line down.
  408.    ∞ [UP] - scrolls one line up.
  409.    ∞ [PGDN] - scrolls one screen down.
  410.    ∞ [PGUP] - scrolls one screen up.
  411.    ∞ [ESC] - closes the Help screen.
  412. ~
  413. OVERVIEW
  414. ADBROWSE is a database browse utility written in Clipper 5.01.
  415. The intended users are Clipper programmers and database users.
  416.  
  417. ADBROWSE automatically detects the video type and behaves
  418. accordingly.  But if you are using a laptop and you want to 
  419. force B&W, use this command line: ADBROWSE MONO.
  420.  
  421. This current version has the following features:
  422.  
  423.    √ Mouse-supported.
  424.  
  425.    √ Loads any number of databases allowed by your computer
  426.      system configuration.  If you are loading a large number
  427.      of databases, use this command line: ADBROWSE //F:xx,
  428.      where xx is the number of DOS file handles to be made
  429.      available to ADBROWSE.  
  430.      
  431.    √ Allows you to switch from one open database to another
  432.      with one keypress.
  433.  
  434.    √ Does the following index functions: Create, Open, Close,
  435.      Set Master, and Reindex while on Browse mode.
  436.  
  437.    √ Lists a database into the printer or a text file.  Allows
  438.      you to select the fields to include.  Allows you also to
  439.      define such report parameters as pagelength, pagewidth,
  440.      margins and maximum column width.
  441.  
  442.  
  443. I intend to expand ADBROWSE's capabilities. Work is already
  444. being done to add more features, such as:
  445.  
  446.    √ Create and edit databases.
  447.  
  448.    √ Modify the browse image by rotating column positions,
  449.      hiding and unhiding columns, changing column widths,
  450.      freezing columns, and adding calculated field columns.
  451.  
  452.    √ A query feature.
  453.  
  454.    √ A search feature.
  455.  
  456.    √ Ability to establish relations between databases.
  457.  
  458.    √ Restructure a database.
  459.  
  460.    √ A pseudo command dialect.
  461.  
  462. If you care to suggest on which feature I should work on next,
  463. or if you have any comment about ADBROWSE, please send them to
  464. this address:
  465.  
  466.    Angelito Dizon
  467.    6884 Brian Michael Ct
  468.    Springfield VA, 22153
  469.  
  470.  
  471. If there is enough interest from Clipper programmers, I may
  472. publish the function library that I used to create ADBROWSE
  473. and other systems.  Right now, this library contains more
  474. than a hundred functions and pseudo functions.  All user-
  475. interface functions are configurable and mouse-supported. Some
  476. are already documented and many are not.
  477. ~
  478. NODBF
  479.  
  480.  
  481.  
  482.  
  483.  
  484.           There are no databases in the current 
  485.           directory.  Try changing directory, then
  486.           run the program again.
  487.  
  488.           In a future release, a DATABASE CREATE
  489.           option will be available.
  490.  
  491. ~
  492. WELCOME
  493. Thank you for trying ADBROWSE.  This elegant utility is very
  494. friendly.  The user-interface screens have been carefully
  495. designed to be as intuitive as possible.  If you occasionally
  496. get confused as to what to do, there are four Help keys that you
  497. may press to obtain assistance:
  498.  
  499.    ∞ [F1] - displays a context-sensitive Help screen.
  500.  
  501.    ∞ [SHIFT-F1] - displays a Help screen that describes the use
  502.      of the current user-interface, e.g., "Using a Picklist",
  503.      "Viewing A Database", etc.
  504.  
  505.    ∞ [CTRL-F1] - displays a picklist of Help screens, one of
  506.      which, "OVERVIEW", enumerates ADBROWSE's features.
  507.      Another, "README.AD" displays the file of the same name.
  508.    
  509.    ∞ [ALT-F1] - displays a "Using HELP" screen.
  510.  
  511. I believe that these screens, and the README.AD file, are the
  512. only documentation you may need to read in order to fully
  513. utilize ADBROWSE.  
  514.  
  515. You need not read this Welcome Note again.  Delete WELCOME.AD
  516. from the ADBROWSE directory.
  517.  
  518. Enjoy! - The ADBROWSE author.
  519. ~
  520. 
  521. 
  522.