home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR19 / CED21B.ZIP / CED.DOC next >
Text File  |  1993-01-22  |  183KB  |  3,108 lines
  1. ******************************************************************************
  2.  
  3.                           CED - The Clipper Environment
  4.  
  5. ******************************************************************************
  6.  
  7. CED Version 2.1b Released on 15 January 1993. Copyright (c) 1993 Scott
  8. Daughtry, All Rights Reserved.
  9.  
  10. CED Version 2.1b is not and has never been free software! You are given a
  11. limited license to use this fully working version of CED for evaluation only. If
  12. you wish to continue using CED you must register by sending $39.00, plus $6.00
  13. for shipping and handling, to the address listed below. By registering this
  14. product, you become entitled to the following benefits:
  15.  
  16.     *  The current CED program without the time constraints.
  17.     *  Notification of future updates automatically by mail.
  18.     *  Reduced pricing on future upgrades.
  19.     *  Technical assistance for one year.
  20.     *  My sincere thanks for your support and encouragement.
  21.  
  22. Unregistered users will not recieve technical support in ANY manner, unless they
  23. are reporting a bug in the program. Persons discovering bugs in CED will
  24. automatically recieve full registration for CED; a bug-free version will be
  25. sent automatically at no charge. The only restriction to this policy would be if
  26. the bug is already known and is being corrected, or if this version has been
  27. superceded by a newer version.
  28.  
  29. Scott Daughtry, 2222A Hidalgo Loop, HAFB NM  88330
  30.  
  31. Messages can be left at these BBS phone numbers:
  32.  
  33. Compu-Tech - (505)434-5366                   CED Support BBS
  34. dClip Support - (714)263-0226
  35. Superlib Support - (405)340-4714
  36.  
  37. *******************************************************************************
  38.  
  39. INTRODUCTION
  40. ════════════
  41.  
  42. CED has been created to provide the Clipper programmer an environment similiar
  43. to those found in other programming languages to simplify program design and
  44. debugging. It provides a turbo-style shell that allows you to incorporate
  45. your most often used development tools that you've grown accustomed to
  46. using from the Ms-Dos prompt into an organized workspace. Many features are
  47. integrated into CED that will be familiar to anyone that has used another
  48. programming language, or any version of dBase:
  49.  
  50.     *  User definable color scheme - use predefined color palettes or create
  51.        your own.
  52.     *  Create Clipper *.Ntx files.
  53.     *  View any size and any type file.
  54.     *  Ms-Dos utilities for copying, renaming and deleting files.
  55.     *  Add/Browse/Edit/Delete/Search/Query *.Dbf files.
  56.     *  Compile *.Prg files into *.Obj files.
  57.     *  Compile *.Obj files into *.Exe files.
  58.     *  Use your favorite Make utility.
  59.     *  Execute another *.Exe file, and return back to CED.
  60.     *  Ability to create,edit,save and print customized labels, formletters and
  61.        tabular style reports that can optionally use a filter or query to limit
  62.        the output as desired.
  63.     *  View dBase compatible *.Mem files.
  64.     *  "Metafunction"-style *.Dbf utilities that allow you to:
  65.            *  Perform intelligent "Append From" actions on *.Dbf files.
  66.            *  Copy selected fields from an existing *.Dbf to new *.Dbf.
  67.            *  Do statistical analysis on numeric fields.
  68.            *  Do selective global replace of a *.Dbf field.
  69.            *  Duplicate record finder with delete/copy options.
  70.            *  Pack an existing database.
  71.            *  Convert a delimited file to a *.Dbf
  72.            *  Export *.Dbf to delimited or SDF files.
  73.            *  Create mailmerge files for Wordperfect or MS Word.
  74.            *  Erase all records of an existing database.
  75.            *  Create or edit dBase compatible *.Lbl and *.Frm files.
  76.     *  Display Inkey and Lastkey values.
  77.     *  Popup Ascii chart that shows Ascii value and actual character.
  78.     *  Fully integrated menuing program that allows you to shell to Ms-Dos and
  79.        return to CED, or execute your favorite utilities from a menu and return
  80.        to CED.
  81.     *  Use the built-in text editor, or use your own without leaving CED.
  82.     *  Ability to set up default *.Obj,*.Lib and *.Clp files for the link
  83.        process; CED will automatically figure out which way to compile based
  84.        upon your defaults.
  85.  
  86. Even if you do not program in the Clipper language, you can still use CED to
  87. perform an extremely wide variety of normal database chores; most of the
  88. functionality of dBase and it's clone spinoffs is present in CED, as well as
  89. some features that are exclusive to itself. Future versions of CED may become
  90. language independant for use with other programming languages other then
  91. Clipper.
  92.  
  93. System Requirements:
  94. ════════════════════
  95.  
  96. CED requires an IBM-compatible XT or AT machine running Ms-Dos version 3.2
  97. or greater. All video modes are supported. A hard drive is not absolutely
  98. required, but it would be a wise investment. The program files for CED occupy
  99. about 850k, and if extended or expanded memory is unavailable it will use
  100. another 500k for a temporary swap file when called upon. An ideal computer setup
  101. would be at least a 386SX machine with a fast hard drive and 2 meg of ram. You
  102. may use Pklite 1.14 to compress the Ced.Exe file to conserve space if you
  103. choose.
  104.  
  105. INSTALLATION:
  106. ═════════════
  107.  
  108. CED most likely came in a compressed file; it should have been self-extracting
  109. to ease installation woes. You may place the files anywhere on the hard drive;
  110. I recommend you ensure that the files are located in the system path so that
  111. you may use it from any directory on the drive. The following files are
  112. included or created by CED:
  113.  
  114.     NAME                     DESCRIPTION
  115.     ════                     ═══════════
  116.     Ced.Doc                  CED manual
  117.     Ced.Exe                  Main executable file
  118.     Order.Doc                 CED Order Form
  119.     Read.Me                     Description File    
  120.  
  121. I recommend that you make at least ONE backup copy of all program files
  122. and store the disk in a safe place. You may use the Ms-Dos Attrib command to
  123. make Ced.Exe read-only; do NOT make Setup.sys read-only or hidden (you won't be
  124. able to customize CED to your liking if you do!)
  125.  
  126. LIMITATIONS:
  127. ════════════
  128.  
  129. This is a fully functional evaluation copy of CED; all functions are fully
  130. operational. The only difference between this version and the registered copy is
  131. that the 10 minute time limitation is removed. This method of protection was
  132. chosen to provide the best of both worlds: it gives you the opportunity to try
  133. all the bells and whistles, and give myself a method to encourage
  134. users to register my product. CED has taken more than 150 hours to
  135. write, debug, and write documentation for. Because there is no other product
  136. like this one in this price range, and the functionality it provides, $39
  137. is a reasonable figure in my mind. NOTE: While I have tested the demo version
  138. extensively with the time limit inacted, it is usually safe practice to not
  139. have a database file open at the time of a program ending. Therefore, I
  140. recommend that you try not to have *.Dbf files open at the ten minute mark just
  141. to be on the safe side. The dBase file format is prone to being corrupted when
  142. it is open and the calling program is terminated abruptly.
  143.  
  144. ACKNOWLEDGEMENTS
  145. ════════════════
  146.  
  147. I am thankful to several people, of whom I would have never finished this
  148. program:
  149.  
  150. - To my wife, who spent many nights without me, while I was sitting in front of
  151. this computer.
  152.  
  153. - To my father, to give me the insight into computers in the first place.
  154.  
  155. - To Kenneth Williams and other beta testers who diligently hammered away at CED
  156. and pointed out my mistakes.
  157.  
  158. - To Allen Lichtenwalner, who listened to this idea and encouraged me to proceed
  159. forward with it.
  160.  
  161. - To Garry Prefontaine, for writing the best Clipper library available.
  162.  
  163. - To Roger Donnay, whose dClip product blew me away. I know this product pales
  164. in comparison, but we all have to start somewhere!
  165.  
  166. It is my hope that you'll enjoy working with CED.
  167.  
  168. WARRANTY
  169. ════════
  170. Concerning the physical diskette sent to registered owners, the author
  171. warrants the same to be free from defects in materials and workmanship for 60
  172. days from the date of registration. In the event of notification
  173. within the warranty period of defects in material or workmanship of the diskette
  174. the author will replace the defective diskette. The remedy for breach of this
  175. warranty shall be limited to replacement and shall not encompass any other
  176. damages, including but not limited to loss of profit, any special, incidental,
  177. consequental or other similiar claims.
  178.  
  179. In no event shall the author be liable for any loss of profit or any other
  180. commercial damage resulting from the use (or inability of use) of CED, even if
  181. the author has been advised ahead of time that the possibility of damage exists.
  182.  
  183. While all the above legalese sounds daunting, this program has not caused my
  184. data files to blow up or set my computer on fire! No low level functions have
  185. been written into this program; it has been tested on many different type
  186. machines and versions of Ms-Dos without incident.
  187.  
  188. COPYRIGHT NOTICES
  189. ═════════════════
  190.  
  191. CED is copyrighted software of Scott Daughtry
  192. Scott.Lib is copyrighted software of Scott Daughtry
  193. Clipper is copyrighted software of Computer Associates
  194. Superlib is copyrighted software of Functional Software
  195. dClip is copyrighted software of Donnay Systems
  196. Overlay is copyrighted software of Sofdesign
  197. Multi-Edit is copyrighted software of American Cybernetics
  198. Blinker is copyrighted software of BlinkInc
  199. Ms-Dos is copyrighted software of Microsoft
  200. Grumpfish is copyrighted software of Grumpfish
  201.  
  202. CED TECHNICAL NOTES
  203. ═══════════════════
  204.  
  205. CED was developed on a home-brew 386/40 with a 130 meg drive and 4 meg of ram.
  206. Software used in creating CED include the following:
  207.  
  208. Editor - MultiEdit 6.10
  209. Compiler - Clipper 5.01a
  210. Linker - Blinker 1.52
  211. Libraries - Superlib 3.0, Grumpfish, Scott.Lib, Nanforum 2.1, dClip 3.0
  212.  
  213. The load size of CED is 390K; CED can use XMS memory in it's database
  214. utilities; the swap routine (Overlay 3.5) can use either XMS or EXT memory
  215. automatically to dramatically speed up the swap routine. File size limitations
  216. are:
  217.  
  218. Ascii viewer    - unlimited
  219. *.Dbf utilities - 1 billion records or available disk space
  220. Word processor  - 64K
  221.  
  222. USING CED
  223. ═════════
  224.  
  225. This section of the manual will be dedicated to exploring each CED module in
  226. the order that they appear on the pulldown menu. A screen capture will show
  227. you what the screen will look like, and descriptive text will follow. For the
  228. most part, the menu options are intuitive; I've always felt that the best way
  229. to learn software is to play with it (I would bank safe money that
  230. quite a few people who use this product will never read this far in the
  231. documentation.) Wherever the possibility exists of changing a file on the hard
  232. drive, the user will have the option to abort the procedure and return back
  233. to the main menu without incident.
  234.  
  235. NOTE: CED is continually being upgraded; in some instances the screen depictions
  236. will not quite match the documentation; a mousable interface is being gradually
  237. implemented into CED piecemeal. This explains why the mouse will work in some
  238. areas and not in others. The leftmost mouse button will choose a menu/prompt
  239. choice, and the rightmost mouse button will simulate the Enter key.  I
  240. apologize for this temporary inconvenience; hopefully soon all CED functions
  241. will be mousable.
  242.  
  243. ╒═════════════════════════════════╕
  244. │FILES - USE A DATABASE (DBF) FILE│
  245. ╘═════════════════════════════════╛
  246.  
  247. This option allows you to open a *.dbf file (and it's *.dbt file)
  248. for usage within CED for it's various functions. CED will allow you to open
  249. only ONE *.dbf/*.dbt file at a time. Upon execution, this file selection box
  250. will appear onscreen to allow you to choose a database file (NOTE: Do NOT
  251. open Colors.dbf; it keep's track of CED's customized colors).
  252. After you have selected a datafile for use, the filename will be displayed on
  253. the status line at the top right of the screen.
  254.                             ┌[Select: ]─────────┐
  255.                             │    COLORS.DBF     │
  256.                             │    TEST.DBF       │  <-- We Chose This One
  257.                             └───────────────────┘
  258.  
  259. ──────────────────────────────────────┬─────────────────┬──────────────────────
  260. D:\CLIPPER5\APPS\DCLIP                │DBF: TEST.DBF    │NTX:
  261. ──────────────────────────────────────┴─────────────────┴──────────────────────
  262.  
  263. ╒═════════════════════════════╕
  264. │ FILES - CLOSE OPEN DATABASE │
  265. ╘═════════════════════════════╛
  266.  
  267. This option will close an open datafile, and blank out the database name on
  268. the status line.
  269.  
  270. ╒═══════════════════════════════╕
  271. │FILES - USE AN INDEX (NTX) FILE│
  272. ╘═══════════════════════════════╛
  273.  
  274. This option is used to open an existing index file (*.ntx) for use with the
  275. database utilities built into CED. You MUST have already opened a database
  276. file before you use this menu option; you will be given an error message if
  277. you don't follow that sequence. A popup box will appear onscreen for you to
  278. choose an index file; once you have chosen an index, it will display the name
  279. on the status line:
  280.                             ┌[Select: ]─────────┐
  281.                             │    COLORS.NTX     │
  282.                               │    TEST.NTX       │  <-- We Chose This One
  283.                             └───────────────────┘
  284. ──────────────────────────────────────┬─────────────────┬──────────────────────
  285. D:\CLIPPER5\APPS\DCLIP                │DBF: TEST.DBF    │NTX: TEST.NTX
  286. ──────────────────────────────────────┴─────────────────┴──────────────────────
  287.  
  288. If no *.Ntx files exist in the current logged directory, the following error
  289. message box will appear onscreen:
  290.                ┌─────────────────────────────────────────────┐
  291.                │ There Are No Index Files In This Directory! │
  292.                │                                             │
  293.                │ Press a key...                              │
  294.                └─────────────────────────────────────────────┘
  295.  
  296. ╒══════════════════════════╕
  297. │FILES - DOS FILE DIRECTORY│
  298. ╘══════════════════════════╛
  299.  
  300. This option lets you view files in the current logged directory only; the
  301. filename, filesize, date created and time created will be displayed onscreen.
  302. If more than 12 files exist, use the arrow or PgUp/PgDn keys to scroll
  303. farther down the list. The Escape key or Enter key will abort you back to the
  304. main menu.
  305.  
  306.   ┌─Show Directory─────────────────────────────< = Scroll  Esc= Exit >─┐
  307.   │           File          Dir      Size    Date     Time               │
  308.   │──────────────────────────────────────────────────────────────────────│
  309.   │           .             <DIR>            12/09/92 07:42:58           │
  310.   │           ..            <DIR>            12/09/92 07:42:58           │
  311.   │           DC.PRG                   24562 01/05/93 16:12:04           │
  312.   │           DC.BAK                   24390 01/05/93 16:03:48           │
  313.   │           SETUP.SYS                  545 01/05/93 15:50:38           │
  314.   │           TEST.DBF                   246 01/05/93 07:57:16           │
  315.   │           DC.BIF                     696 01/05/93 16:15:56           │
  316.   │           MEERR.TMP                  422 01/05/93 16:14:04           │
  317.   │           DC.EXE                  805088 01/05/93 16:16:00           │
  318.   │           COLORS.DBF                 569 01/05/93 08:20:20           │
  319.   │           DC.OBJ                   21486 01/05/93 16:12:16           │
  320.   │           STATUS.ME                 1320 01/05/93 16:15:08           │
  321.   │──────────────────────────────────────────────────────────────────────│
  322.   │ D:\CLIPPER5\APPS\DCLIP\*.*                                           │
  323.   └──────────────────────────────────────────────────────────────────────┘
  324.  
  325. ╒═══════════════════╕
  326. │FILES - DELETE FILE│
  327. ╘═══════════════════╛
  328.  
  329. This option allows you to delete a file in the current logged directory. A popup
  330. box similiar to the Show Directory menu option will be displayed onscreen.
  331. Escape will abort the process at any time; the Enter key will select a file
  332. and popup a message box confirming if you truly wish to delete the file.
  333.   ┌─Delete File────────────────────────────────< = Scroll  Esc= Exit >─┐
  334.   │           File          Dir      Size    Date     Time               │
  335.   │──────────────────────────────────────────────────────────────────────│
  336.   │           DC.PRG                   24562 01/05/93 16:12:04           │
  337.   │           DC.BAK                   24390 01/05/93 16:03:48           │
  338.   │           SETUP.SYS                  545 01/05/93 15:50:38           │
  339.   │           TEST.DBF                   246 01/05/93 07:57:16           │
  340.   │           DC.BIF                     696 01/05/93 16:15:56           │
  341.   │           MEERR.TMP                  422 01/05/93 16:14:04           │
  342.   │           DC.EXE                  805088 01/05/93 16:16:00           │
  343.   │           COLORS.DBF                 569 01/05/93 08:20:20           │
  344.   │           DC.OBJ                   21486 01/05/93 16:12:16           │
  345.   │           SAFE.PRG                 24562 01/06/93 07:26:12           │
  346.   │           AHBKAPFK                     0 01/06/93 07:26:14           │
  347.   │           STATUS.ME                 1320 01/05/93 16:15:08           │
  348.   │──────────────────────────────────────────────────────────────────────│
  349.   │ D:\CLIPPER5\APPS\DCLIP\*.*                  ENTER = Select           │
  350.   └──────────────────────────────────────────────────────────────────────┘
  351.               ┌──────────────────────────────────────────────┐
  352.               │ Are You Postive you Wish To Delete DC.OBJ?   │
  353.               │                   No  Yes                    │
  354.               └──────────────────────────────────────────────┘
  355.  
  356. ╒═════════════════╕
  357. │FILES - COPY FILE│
  358. ╘═════════════════╛
  359.  
  360. This option allows you to copy a file to a new filename in the current logged
  361. directory. A popup box similiar to the Show Directory menu option will be
  362. displayed. Escape will abort the process at any time; the Enter key will select
  363. a file and popup a message box asking you to enter the new filename.
  364.   ┌─Copy File──────────────────────────────────< = Scroll  Esc= Exit >─┐
  365.   │           File          Dir      Size    Date     Time               │
  366.   │──────────────────────────────────────────────────────────────────────│
  367.   │           DC.PRG                   24562 01/05/93 16:12:04           │
  368.   │           DC.BAK                   24390 01/05/93 16:03:48           │
  369.   │           SETUP.SYS                  545 01/05/93 15:50:38           │
  370.   │           TEST.DBF                   246 01/05/93 07:57:16           │
  371.   │           DC.BIF                     696 01/05/93 16:15:56           │
  372.   │           MEERR.TMP                  422 01/05/93 16:14:04           │
  373.   │           DC.EXE                  805088 01/05/93 16:16:00           │
  374.   │           COLORS.DBF                 569 01/05/93 08:20:20           │
  375.   │           DC.OBJ                   21486 01/05/93 16:12:16           │
  376.   │           STATUS.ME                 1320 01/05/93 16:15:08           │
  377.   │           DC.LNK                     204 01/02/93 14:00:00           │
  378.   │                                                                      │
  379.   │──────────────────────────────────────────────────────────────────────│
  380.   │ D:\CLIPPER5\APPS\DCLIP\*.*                  ENTER = Select           │
  381.   └──────────────────────────────────────────────────────────────────────┘
  382.  
  383.                            ┌────────────────────┐
  384.                            │ Enter New Filename │
  385.                            │         .          │
  386.                            └────────────────────┘
  387.  
  388. ╒═══════════════════╕
  389. │FILES - RENAME FILE│
  390. ╘═══════════════════╛
  391.  
  392. This option allows you to rename a file in the current logged directory. A
  393. scrolling list box will be displayed onscreen.  Escape will abort the process
  394. at any time; the Enter key will select a file and popup a message box asking
  395. you to enter the new filename.
  396.  
  397.   ┌─Rename File────────────────────────────────< = Scroll  Esc= Exit >─┐
  398.   │           File          Dir      Size    Date     Time               │
  399.   │──────────────────────────────────────────────────────────────────────│
  400.   │           DC.PRG                   24562 01/05/93 16:12:04           │
  401.   │           DC.BAK                   24390 01/05/93 16:03:48           │
  402.   │           SETUP.SYS                  545 01/05/93 15:50:38           │
  403.   │           TEST.DBF                   246 01/05/93 07:57:16           │
  404.   │           DC.BIF                     696 01/05/93 16:15:56           │
  405.   │           MEERR.TMP                  422 01/05/93 16:14:04           │
  406.   │           DC.EXE                  805088 01/05/93 16:16:00           │
  407.   │           COLORS.DBF                 569 01/05/93 08:20:20           │
  408.   │           SAFE.PRG                 24562 01/06/93 07:26:12           │
  409.   │           AHBKAPFK                     0 01/06/93 07:26:14           │
  410.   │           STATUS.ME                 1320 01/05/93 16:15:08           │
  411.   │           DC.LNK                     204 01/02/93 14:00:00           │
  412.   │──────────────────────────────────────────────────────────────────────│
  413.   │ D:\CLIPPER5\APPS\DCLIP\*.*                  ENTER = Select           │
  414.   └──────────────────────────────────────────────────────────────────────┘
  415.                            ┌────────────────────┐
  416.                            │ Enter New Filename │
  417.                            │         .          │
  418.                            └────────────────────┘
  419.  
  420. ╒═══════════════════════╕
  421. │FILES - VIEW ASCII FILE│
  422. ╘═══════════════════════╛
  423.  
  424. This option allows you to view an Ascii-formatted file of any size in a fully
  425. scrollable window onscreen; ANY type file can be viewed, but may be
  426. indecipherable onscreen. A popup message box will appear onscreen asking you
  427. for a filename that you wish to view. You may either manually enter a
  428. filename, or you can press the Enter key to choose a file from a scrolling
  429. listbox; the Enter key will select the filename that is now highlighted
  430. in the list box.
  431.       ┌───────────────────────────────────────────────────────────────┐
  432.       │ File to list (ENTER or *Wildcards for picklist - ESC to exit) │
  433.       │ _____________________________________________                 │
  434.       └───────────────────────────────────────────────────────────────┘
  435. I pressed the Enter key to display the files picklist:
  436.                             ┌[Select: ]─────────┐
  437.                             │    AHBKAPFK       │
  438.                             │    COLORS.DBF     │
  439.                             │    DC.BAK         │
  440.                             │    DC.EXE         │
  441.                             │    DC.LNK         │
  442.                             │    DC.PRG         │
  443.                             │    DELETE.ME      │
  444.                             │    MEERR.TMP      │
  445.                             │    SAFE.PRG       │
  446.                             │    SETUP.SYS      │
  447.                             │    STATUS.ME      │
  448.                             │    TEST.DBF       │
  449.                             └───────────────────┘
  450. ┌─[DC.LNK]──────────────────────────────────────────────────────────────────┐
  451. │file dc                                                                    │
  452. │lib dclipnl                                                                │
  453. │beginarea                                                                  │
  454. │  allocate dclip                                                           │
  455. │  allocate sf_xtra                                                         │
  456. │  allocate grump                                                           │
  457. │  allocate nanfor                                                          │
  458. │  allocate super30                                                         │
  459. │  allocate extend                                                          │
  460. │endarea                                                                    │
  461. │lib dclipr                                                                 │
  462. │search clipper                                                             │
  463. │                                                                           │
  464. │                                                                           │
  465. │                                                                           │
  466. ├───────────────────────────────────────────────────────────────────────────┤
  467. │                    PGUP PGDN HOME END    ESC=Quit                     │
  468. │                          S=Search  M=Mark/Endmark                         │
  469. └───────────────────────────────────────────────────────────────────────────┘
  470.  
  471. ╒═══════════════════════════╕
  472. │BUILD - DATABASE (DBF) FILE│
  473. ╘═══════════════════════════╛
  474.  
  475. This option allows you to create a new *.Dbf/*.Dbt file without using
  476. dBase. You can create the new file entirely from scratch, or copy the
  477. structure from a database file located in the current directory. You may
  478. also edit an existing *.Dbf/*.Dbt file structure.A popup window will appear
  479. asking if you wish to create a new datafile or edit an existing database
  480. file structure (if no *.Dbf files are in the directory, only the <Create New
  481. Datafile> prompt will appear onscreen).
  482.                          ┌[DBF to Modify]─────────┐
  483.                          │<Create New Datafile>   │
  484.                          │COLORS.DBF              │
  485.                          │SCOTT.DBF               │
  486.                          └────────────────────────┘
  487.  
  488. If you choose to create a database file from scratch, this popup message box
  489. will appear onscreen:
  490.          ┌────────────────────────────────────────────────────────┐
  491.          │ Name of datafile to create (Escape aborts):            │
  492.          └────────────────────────────────────────────────────────┘
  493. Another popup box will appear onscreen, asking if you wish to copy the
  494. structure of an existing database file; the example shown below is for the
  495. answer "YES"; it inserts all the data from the existing *.dbf
  496. file and inserts it into the Structure Modification box; if we had chosen
  497. "NO" then that same box would be empty.
  498.                  ┌────────────────────────────────────────┐
  499.                  │Copy structure from an existing DBF ?   │
  500.                  │                YES  NO                 │
  501.                  └────────────────────────────────────────┘
  502.  
  503. ┌[Structure Modification]─────────┐┌[Instructions]──────────────────────────┐
  504. │#   Name       Type Length Dec   ││  Key              Action               │
  505. │──────────────────────────────── ││  ──────────────────────────────────────│
  506. │  1 SETNAME     C       40     0 ││  F10              Quit                 │
  507. │  2 DMAINCOL    C       40     0 ││  Arrows         Move up or down 1    │
  508. │  3 DMAINMENU   C       40     0 ││  PGUP, PGDN       Move up or down 10   │
  509. │  4 DPOPCOL     C       40     0 ││  HOME,END         First or last field  │
  510. │  5 DPOPMENU    C       40     0 ││  A-Z              Find matching first  │
  511. │  6 DFRAME      C       40     0 ││                  letter of field       │
  512. │  7 DSHADATT    N        3     0 ││  ENTER            Edit current field   │
  513. │  8 DSHADPOS    N        1     0 ││  INSERT           Add field            │
  514. │  9 DEXPLODE    L        1     0 ││  DELETE           Delete field(s)      │
  515. │                                 ││  ALT-U            Un-delete field      │
  516. │                                 ││  SPACE BAR        Move field           │
  517. │                                 ││  ALT-A            Alphabetize fields   │
  518. │                                 ││  ALT-R            Reset to original    │
  519. │                                 ││                                        │
  520. │                                 ││  Field Types                           │
  521. │                                 ││  ──────────────────────────────────────│
  522. │                                 ││  C   Character     D  Date             │
  523. │                                 ││  N   Numeric       L  Logical          │
  524. │                                 ││  M   Memo                              │
  525. └─────────────────────────────────┘└────────────────────────────────────────┘
  526.  
  527. Simply follow the instructions in the right side instruction box to create
  528. your database file (or edit an existing file); make sure you press the F10
  529. key when finished, or the changes will NOT be permanent. If you are editing
  530. an existing database file, you will be permitted to make only safe changes to
  531. the file to ensure data integrity.
  532.  
  533. ╒════════════════════════╕
  534. │BUILD - INDEX (NTX) FILE│
  535. ╘════════════════════════╛
  536.  
  537. This option allows you to create Clipper compatible index files that end with
  538. an *.Ntx file extension. A database file must be open in order for
  539. you to proceed; you will recieve this error message if you don't:
  540.                   ┌──────────────────────────────────────┐
  541.                   │ You Must First Open A Database File! │
  542.                   │                                      │
  543.                   │ Press a key...                       │
  544.                   └──────────────────────────────────────┘
  545.  
  546. A box will appear onscreen that contains a scrollable menu of options; the
  547. bottom box onscreen displays the index string as you define it:
  548.  
  549. ┌──────────────────────────────────────────────────────────────────────────────┐
  550. │┌───[Index Builder]────────────────────┐                                      │
  551. ││ Define Index Expression              │                                      │
  552. ││ Create Index File from Expression    │                                      │
  553. ││ View records against Expression      │                                      │
  554. ││ Toggle order: descending/ASCENDING   │                                      │
  555. ││ Quit                                 │                                      │
  556. ││                                      │                                      │
  557. │└──────────────────────────────────────┘                                      │
  558. │                                                                              │
  559. │                                                                              │
  560. │                                                                              │
  561. │                                                                              │
  562. │                                                                              │
  563. │                                                                              │
  564. │                                                                              │
  565. │                                                                              │
  566. │                                                                              │
  567. │┌Current Index Key Expression:───────────────────────────────────────────────┐│
  568. ││                                                                            ││
  569. ││                                                                            ││
  570. ││                                                                            ││
  571. ││                                                                            ││
  572. │└────────────────────────────────────────────────────────────────────────────┘│
  573. └──────────────────────────────────────────────────────────────────────────────┘
  574.  
  575. The menu is set up sequentially in the order they appear (except for the
  576. Toggle Order option: it simply toggles if you want the index to be in
  577. ascending or descending sequence. Choose the desired sequence BEFORE you
  578. create the index file).  When you choose Define Index Expression, a
  579. list box will appear onscreen to choose field(s) for the index string. The
  580. current index key expression will automatically update itself as you
  581. choose/unchoose fields.
  582.  
  583.                     ┌[Index Expression Builder]─────────┐
  584.                     │ Field                             │
  585.                     │ SETNAME                           │
  586.                     │ DMAINCOL                          │
  587.                     │ DMAINMENU                         │
  588.                     │ DPOPCOL                           │
  589.                     │ DPOPMENU                          │
  590.                     │ DFRAME                            │
  591.                     │ DSHADATT                          │
  592.                     │ DSHADPOS                          │
  593.                     │ DEXPLODE                          │
  594.                     │                                   │
  595.                     │───────────────────────────────────│
  596.                     │Enter to select , F10 to quit      │
  597.                     │                                   │
  598.                     └───────────────────────────────────┘
  599. ┌Current Index Key Expression:───────────────────────────────────────────────┐
  600. │ SETNAME+DMAINCOL+DMAINMENU+DPOPCOL                                         │
  601. │                                                                            │
  602. │                                                                            │
  603. │                                                                            │
  604. └────────────────────────────────────────────────────────────────────────────┘
  605.  
  606. When you have finished choosing fields with the F10 key, you will be prompted
  607. to create the index. If you choose no, you will return to the menu again; else,
  608. you will be prompted to give the index a filename (without the extension). The
  609. index will be created with a visual 'thermometer' display to keep you informed
  610. of the indexing status.
  611.                         ┌───────────────────────────┐
  612.                         │Create this index now ?    │
  613.                         │         YES  NO           │
  614.                         └───────────────────────────┘
  615.                         ┌───────────────────────────┐
  616.                         │ Name of index:   TEST     │
  617.                         └───────────────────────────┘
  618.  
  619. You can view the open database with the new index file active by choosing the
  620. View records against Expression menu option:
  621. ┌─────────────────────────────────────────────────────────────────────────────┐
  622. │Alpha Electronics                                                            │
  623. │Beta Physics                                                                 │
  624. └─────────────────────────────────────────────────────────────────────────────┘
  625.  
  626. ╒════════════════════════╕
  627. │BUILD - LABEL (LBL) FILE│
  628. ╘════════════════════════╛
  629.  
  630. This option allows you to modify an existing dBase *.Lbl file, or create a
  631. new *.Lbl file (This type file is used for printing labels). If no *.Lbl
  632. files exist in the current directory, you will see a popup box asking which
  633. course of action you want to take (create a new file, or abort). If
  634. you choose abort you will return to the main menu; we are not going to do that!
  635.               ┌─────────────────────────────────────────────────┐
  636.               │  ERROR - No *.Lbl Files In Current Directory!   │
  637.               │             Create New One  Abort               │
  638.               └─────────────────────────────────────────────────┘
  639.  
  640. Chose 'Create New One' here, and recieve a prompt box to enter a filename
  641. for this new file (without entering the extension of course):
  642.                    ┌──────────────────────────────────────────┐
  643.                    │ Enter New Filename Without The Extension │
  644.                    │ FORMS                                    │
  645.                    └──────────────────────────────────────────┘
  646.  
  647. You are presented the main menu for manipulating *.Lbl files:
  648.  
  649.                ┌─────────────────────────────────────────────────┐
  650.                │            ** LABEL FORM EDITOR **              │
  651.                │                                                 │
  652.                │ LABEL File        : FORMS.LBL                   │
  653.                │ Primary Data File : FORM                        │
  654.                │                                                 │
  655.                │      L = Edit Form Layout                       │
  656.                │      T = Select Form Type (Defaults)            │
  657.                │      F = Edit Form Fields (Lines)               │
  658.                │                                                 │
  659.                │                                                 │
  660.                │                                                 │
  661.                │      X = EXIT and Save File Changes             │
  662.                │                                                 │
  663.                │  Press ESCape to EXIT without saving Changes    │
  664.                │                                                 │
  665.                │                                                 │
  666.                └─────────────────────────────────────────────────┘
  667.  
  668. Options are explained in sequential order; choosing L = Edit Form Layout, you
  669. are presented this screen:
  670.  ┌─────────────────────────────────────────────────────────────────────────────┐
  671.  │                                                                             │
  672.  │ LABEL FILE: FORMS.LBL                                                       │
  673.  │                                                                             │
  674.  │ DIMENSIONS:                                                                 │
  675.  │                                                                             │
  676.  │    Width     35                                                             │
  677.  │    Height     5                                                             │
  678.  │    Across     1                                                             │
  679.  │                                                                             │
  680.  │                                                                             │
  681.  │ FORMATTING:                                                                 │
  682.  │                                                                             │
  683.  │    Margin     0                                                             │
  684.  │    Lines      1                                                             │
  685.  │    Spaces     0                                                             │
  686.  │    Remarks                                                                  │
  687.  │                                                                             │
  688.  └─────────────────────────────────────────────────────────────────────────────┘
  689.  
  690. Here you are simply defining the dimensions for the desired label. Choosing
  691. T = Select Form Type (Defaults) displays predefined label formats:
  692.             ┌───────────────────────────────────────────────────────┐
  693.             │          A =      3 1/2 x 15/16 by 1                  │
  694.             │          B =      3 1/2 x 15/16 by 2                  │
  695.             │          C =      3 1/2 x 15/16 by 3                  │
  696.             │          D =        4 x 17/16 by 1                    │
  697.             │          E = 3 2/10 x 11/12 by 3 (Cheshire)           │
  698.             └───────────────────────────────────────────────────────┘
  699.  
  700. Select your desired size. Choosing F = Edit Form Fields (Lines):
  701. ╔═════════════════╡ LABEL FORM FIELDS ┌────────┤ Select a Field Below ├────────┐
  702. ╟─┬───────────┬───────────────────────│ DESCRIPT             Character  50     │
  703. ║ │  Line     │ Contents              │ MEMO_ORIG            Memo       10     │
  704. ║ ├───────────┼───────────────────────│                                        │
  705. ║│  Line  1  │                       │                                        │
  706. ║ │  Line  2  │                       │                                        │
  707. ║ │  Line  3  │                       │                                        │
  708. ║ │  Line  4  │                       │                                        │
  709. ║ │  Line  5  │                       │                                        │
  710. ║ │           │                       │                                        │
  711. ║ │           │                       │                                        │
  712. ║ │           │                       │                                        │
  713. ║ │           │                       │                                        │
  714. ║ │           │                       │                                        │
  715. ║ │           │                       │                                        │
  716. ║ │           │                       │                                        │
  717. ║ │           │                       │                                        │
  718. ║ │           │                       │                                        │
  719. ║ │           │                       │                                        │
  720. ║ │           │                       │                                        │
  721. ║ │           │                       │                                        │
  722. ║ ├───────┌───────────────────────────│                                        │
  723. ║ │       │ Press Key F2 for field lis│                                        │
  724. ╚═╧═══════└───────────────────────────└────────────────────────────────────────┘
  725.  
  726. Here you are going to set up which fields are going to be printed in lines 1-5
  727. of the label. On the left side of the screen are blank values for lines 1-5,
  728. and by pressing the F2 key, pop-up a scrolling list of fields in the open
  729. database file. Pressing the Enter key on the highlighted field inserts
  730. that fieldname and it's pertinent values into the corresponding line on the
  731. left side of the screen (as we have done here). Finish defining what fields
  732. will go where, then press the 'X' key to exit back to the main menu
  733. of the application. The information is automatically saved to the filename you
  734. gave when you started (or to the filename that existing beforehand if we were
  735. modifying an exist *.Lbl file).
  736.  
  737. ╒═════════════════════════╕
  738. │BUILD - REPORT (FRM) FILE│
  739. ╘═════════════════════════╛
  740.  
  741. This option allows you to modify an existing dBase *.Frm file, or create a
  742. new *.Frm file (This type file is used for printing reports). If no *.Frm
  743. files exist in the current directory, you will see a popup box asking which
  744. course of action you wish to take (create a new file, or abort). If you choose
  745. abort you will be returned to the main menu; we are not going to do that:
  746.               ┌─────────────────────────────────────────────────┐
  747.               │  ERROR - No *.Frm Files In Current Directory!   │
  748.               │             Create New One  Abort               │
  749.               └─────────────────────────────────────────────────┘
  750.  
  751. We chose 'Create New One' here, and recieve a prompt box to enter a filename
  752. for this new file (without entering the extension):
  753.                    ┌──────────────────────────────────────────┐
  754.                    │ Enter New Filename Without The Extension │
  755.                    │ FORM                                     │
  756.                    └──────────────────────────────────────────┘
  757.  
  758. Presented is the main menu for manipulating *.Frm files:
  759.                ┌─────────────────────────────────────────────────┐
  760.                │            ** REPORT FORM EDITOR **             │
  761.                │                                                 │
  762.                │ REPORT File       : FORM.FRM                    │
  763.                │ Primary Data File : FORM                        │
  764.                │                                                 │
  765.                │      L = Edit Form Layout                       │
  766.                │      G = Edit Form Groups                       │
  767.                │      F = Edit Form Fields                       │
  768.                │                                                 │
  769.                │                                                 │
  770.                │                                                 │
  771.                │      X = EXIT and Save File Changes             │
  772.                │                                                 │
  773.                │  Press ESCape to EXIT without saving Changes    │
  774.                │                                                 │
  775.                │                                                 │
  776.                └─────────────────────────────────────────────────┘
  777.  
  778. Explanations of options are in sequential order; choosing L = Edit Form Layout,
  779. displays this screen:
  780.  ┌─────────────────────────────────────────────────────────────────────────────┐
  781.  │ FILE: FORM.FRM                                                              │
  782.  │                                                                             │
  783.  │ PAGE HEADER:                                                                │
  784.  │                                                                             │
  785.  │                                                                             │
  786.  │                                                                             │
  787.  │                                                                             │
  788.  │                                                                             │
  789.  │                                                                             │
  790.  │ FORMATTING:                                                                 │
  791.  │                         Page Width               80                         │
  792.  │                         Left Margin               8                         │
  793.  │                         Right Margin              0                         │
  794.  │                         Lines Per Page           58                         │
  795.  │                         Double Spaced?          N                           │
  796.  │                                                                             │
  797.  │                                                                             │
  798.  │ PRINTER DIRECTIVES:                                                         │
  799.  │                      Page Eject Before Print Y                              │
  800.  │                      Page Eject After Print  N                              │
  801.  │                      Plain Page              N                              │
  802.  └─────────────────────────────────────────────────────────────────────────────┘
  803.  
  804. You're simply defining the dimensions for the desired report output. Choosing
  805. T = Select Form Type (Defaults). This is for grouping and sub-grouping
  806. options:
  807.  ┌─────────────────────────────────────────────────────────────────────────────┐
  808.  │ FILE: FORM.FRM                                                              │
  809.  │                                                                             │
  810.  │ GROUP SPECIFICATIONS:                                                       │
  811.  │                                                                             │
  812.  │ Group On Expression                                                         │
  813.  │ Group Heading                                                               │
  814.  │                                                                             │
  815.  │                                                                             │
  816.  │                                                                             │
  817.  │ Summary Report Only     N                                                   │
  818.  │ PageEject After Group   N                                                   │
  819.  │                                                                             │
  820.  │                                                                             │
  821.  │                                                                             │
  822.  │ SUB-GROUP SPECIFICATIONS:                                                   │
  823.  │                                                                             │
  824.  │ Sub-Group On Expression                                                     │
  825.  │ Sub-Group Heading                                                           │
  826.  │                                                                             │
  827.  │                                                                             │
  828.  │                                                                             │
  829.  └─────────────────────────────────────────────────────────────────────────────┘
  830.  
  831. This presents a means of defining fields that will be used in the report.
  832. Pressing the F2 key pops up a list of all fields available in the open database
  833. file; by highlighting a field and pressing the Enter key keyboard's it into the
  834. current column. The bottom line of the screen gives you options to (A)dd (E)dit
  835. (I)nsert (D)elete fields defined (or about to be defined) while setting up the
  836. report specifications:
  837. ╔════════════════╡ REPORT FORM FIELDS (COLUMNS) File: FORM.FRM╞════════════════╗
  838. ╟─┬────────┬─────────────────────────────┬────────────────────┬──────────────┬─╢
  839. ║ │ Field  │ Contents                    │ Header             │Width Dec Tot │ ║
  840. ║ ├────────┼─────────────────────────────┼────────────────────┼──────────────┤ ║
  841. ║│   1    │DESCRIPT                     │                    │  10    0  N  │║
  842. ║┌─────────────────────────────────────────────────────────────────────────────┐
  843. ║│                                                                             │
  844. ║│ Press Key F2 for field list                                                 │
  845. ║│                                                                             │
  846. ║│ Field/Column Number  1                                                      │
  847. ║│                                                                             │
  848. ║│ Contents  DESCRIPT                                                          │
  849. ║│                                                                             │
  850. ║│ Header                                                                      │
  851. ║│                                                                             │
  852. ║│                                                                             │
  853. ║│                                                                             │
  854. ║│                                                                             │
  855. ║│ Width     10                                                                │
  856. ║│ Decimals   0                                                                │
  857. ║│ Totals?   N                                                                 │
  858. ║└─────────────────────────────────────────────────────────────────────────────┤
  859. ║  Edit       Add        Insert        Delete                       X=EXIT     │
  860. ╙──────────────────────────────────────────────────────────────────────────────┘
  861.  
  862. Finish defining the report attributes; press 'X' to save the *.Frm information
  863. and return back to the program main menu.
  864.  
  865. ╒═════════════════╕
  866. │EDIT - ASCII FILE│
  867. ╘═════════════════╛
  868.  
  869.  This menu option allows you to edit Ascii formatted files using either the
  870.  built-in editor (a highly-modified MEMOEDIT), or your own editor if you have
  871.  defined one in the CED program. Since you should know how to use your own
  872.  editor, we will concentrate on using the built-in editor. While it may be no
  873.  Multi-Edit, it does come in quite handy for on-the-spot editing tasks. The
  874.  first prompt will ask which editor you desire to  use:
  875.                        ┌─────────────────────────────┐
  876.                        │Which Editor Will You Use?   │
  877.                        │   Built-In  User-Defined    │
  878.                        └─────────────────────────────┘
  879.  
  880. The screen will clear, and present a prompt at the bottom for a filename; you
  881. may manually type in the filename, or press the Enter key to pop-up a list of
  882. filenames located in the current directory (executable files will automatically
  883. be filtered out, as well as files larger than 64k):
  884. ╓──────────────────────────────────────────────────────────────────────────────╖
  885. ║                                                                              ║
  886. ║                                                                              ║
  887. ║                                                                              ║
  888. ║                                                                              ║
  889. ║                                                                              ║
  890. ║                                                                              ║
  891. ║                                                                              ║
  892. ║                                                                              ║
  893. ║                                                                              ║
  894. ║                                                                              ║
  895. ║                                                                              ║
  896. ║                                                                              ║
  897. ║                                                                              ║
  898. ║                                                                              ║
  899. ║                                                                              ║
  900. ║                                                                              ║
  901. ║                                                                              ║
  902. ║                                                                              ║
  903. ║                                                                              ║
  904. ║                                                                              ║
  905. ║                                                                              ║
  906. ╟──────────────────────────────────────────────────────────────────────────────╢
  907. ║ ENTER FILE NAME TO EDIT:                                                     ║
  908. ╙──────────────────────────────────────────────────────────────────────────────╜
  909.  
  910. This is what the screen will look like if you press the Enter key to display
  911. a pop-up of files; press the Enter key on a highlighted file to edit it:
  912. ╓──────────────────────────────────────────────────────────────────────────────╖
  913. ║                                                                              ║
  914. ║                            ┌───────┤ *.* ├──────┐                            ║
  915. ║                            │    NEW FILE        │                            ║
  916. ║                            │    SAVE.BAT        │                            ║
  917. ║                            │    DC.PRG          │                            ║
  918. ║                            │    DC.LNK          │                            ║
  919. ║                            │    DC.ILF          │                            ║
  920. ║                            │    READ.BAK        │                            ║
  921. ║                            │    DC.BIF          │                            ║
  922. ║                            │    SCREEN.BAK      │                            ║
  923. ║                            │    SETUP.SYS       │                            ║
  924. ║                            │                    │                            ║
  925. ║                            │                    │                            ║
  926. ║                            │                    │                            ║
  927. ║                            │                    │                            ║
  928. ║                            └────────────────────┘                            ║
  929. ║                                                                              ║
  930. ║                                                                              ║
  931. ║            ┌────────────────────────────────────────────────────┐            ║
  932. ║            │ Move highlight bar to desired file and press Enter │            ║
  933. ║            └────────────────────────────────────────────────────┘            ║
  934. ╟──────────────────────────────────────────────────────────────────────────────╢
  935. ║                                                                              ║
  936. ╙──────────────────────────────────────────────────────────────────────────────╜
  937.  
  938. Here is the screen after picking Save.Bat; it is an uncluttered workplace in
  939. which editing occurs. Pressing Alt-H will pop-up a help screen of commands used
  940. for the editor:
  941. ╓──────────────────────────────────────────────────────────────────Alt-H = Help╖
  942. ║attrib -h safe.prg                                                            ║
  943. ║copy dc.prg safe.prg                                                          ║
  944. ║attrib +h safe.prg                                                            ║
  945. ║                                                                              ║
  946. ║                                                                              ║
  947. ║                                                                              ║
  948. ║                                                                              ║
  949. ║                                                                              ║
  950. ║                                                                              ║
  951. ║                                                                              ║
  952. ║                                                                              ║
  953. ║                                                                              ║
  954. ║                                                                              ║
  955. ║                                                                              ║
  956. ║                                                                              ║
  957. ║                                                                              ║
  958. ║                                                                              ║
  959. ║                                                                              ║
  960. ║                                                                              ║
  961. ║                                                                              ║
  962. ║                                                                              ║
  963. ╟──────────────────────────────────────────────────────────────────────────────╢
  964. ║ SAVE.BAT                                 L 1    C 1  LM  1 RM  80 <Wrap><Ins>║
  965. ╙──────────────────────────────────────────────────────────────────────────────╜
  966.  
  967. Here is the help screen for the editor:
  968. ╓──────────────────────────────────────────────────────────────────Alt-H = Help╖
  969. ║                                MNEMONIC KEYS                                 ║
  970. ║      Alt-A  (A)ppend file                                                    ║
  971. ║      Alt-G  (G)oto line                 Alt-B  place (B)lock marker          ║
  972. ║      Alt-H  show (H)elp screen          Alt-I  (I)nsert buffer               ║
  973. ║      Alt-K  (K)ut and Paste             Alt-L  page (L)ength                 ║
  974. ║      Alt-M  change (M)argins            Alt-N  edit (N)ew file               ║
  975. ║      Alt-P  (P)rint file                Alt-Q  (Q)uit w/ save                ║
  976. ║      Alt-R  search and (R)eplace        Alt-S  (S)ave file & continue        ║
  977. ║      Alt-T  (T)oggle wordwrap on/off    Alt-V  (V)iew buffer contents        ║
  978. ║      Alt-W  (W)rite to file             Alt-X  e(X)it without saving         ║
  979. ║      Alt-Y  change director(Y)                                               ║
  980. ║      ^E     Go up one line              ^X     Go down one line              ║
  981. ║      ^S     Go left one char            ^D     Go right one char             ║
  982. ║      ^A     Go left one word            ^F     Go right one word             ║
  983. ║      HOME    Go to start of line        END    Go to end of line             ║
  984. ║      ^HOME   Top corner of window       ^END   Bottom corner of window       ║
  985. ║      ^PgUp   Go to start of file        ^PgDn  Go to end of file             ║
  986. ║      Esc     Abort edit, no save        ^Y     Delete current line           ║
  987. ║                                                                              ║
  988. ║                                                                              ║
  989. ║                       Press any key to resume editing                        ║
  990. ╟──────────────────────────────────────────────────────────────────────────────╢
  991. ║ SAVE.BAT                                 L 1    C 1  LM  1 RM  80 <Wrap><Ins>║
  992. ╙──────────────────────────────────────────────────────────────────────────────╜
  993.  
  994. ╒════════════════════╕
  995. │EDIT - DATABASE FILE│
  996. ╘════════════════════╛
  997.  
  998. This menu option allows you to manipulate records in a standard dBase or
  999. Clipper *.Dbf/*.Dbt file. Provided you have already opened a database file
  1000. for use (you will not be allowed to edit a file if it isn't already open),
  1001. the screen resembles the one displayed below:
  1002. ╔═ Menu ══════╗┌──  V·I·E·W  P·O·R·T  for file: FORM ──────────────────────────┐
  1003. ║             ║│                                                               │
  1004. ║ Next Record ║│        DESCRIPT                                               │
  1005. ║ Prev Record ║│        MEMO_ORIG       (memo)                                 │
  1006. ║ Search File ║│                                                               │
  1007. ║ Key Search  ║│                                                               │
  1008. ║ TableView   ║│                                                               │
  1009. ║ Hardcopy    ║│                                                               │
  1010. ║ Viewmemo    ║│                                                               │
  1011. ║ Build Query ║│                                                               │
  1012. ║ Field Order ║│                                                               │
  1013. ║ Edit Record ║│                                                               │
  1014. ║ Add Record  ║│                                                               │
  1015. ║ Memo Edit   ║│                                                               │
  1016. ║ Delete      ║│                                                               │
  1017. ║ Quit        ║│                                                               │
  1018. ║             ║│                                                               │
  1019. ║             ║│                                                               │
  1020. ║──────────── ║│                                                               │
  1021. ║ Rec#        ║│                                                               │
  1022. ║       1     ║│                                                               │
  1023. ║ of #        ║│                                                               │
  1024. ║          0  ║│                                                               │
  1025. ║             ║│                                                               │
  1026. ╚═════════════╝└───────────────────────────────────────────────────────────────┘
  1027.  
  1028. There are quite a bit of options to play with here! Options are explained in
  1029. sequential order:
  1030.  
  1031.     *  Next Record: Move to next record on file.
  1032.  
  1033.     *  Prev Record: Move to previous record on file.
  1034.  
  1035.     *  Search File: Search for record(s) in the database file using a variety of
  1036.        methods:
  1037.                           ┌[Search for:]──────────────┐
  1038.                         │ Field Contents Match      │
  1039.                         │ Query match               │
  1040.                         │ End of file               │
  1041.                         │ Beginning of File         │
  1042.                         │ Deleted Records           │
  1043.                         │ Memo contents             │
  1044.                         │ Never Mind                │
  1045.                         └───────────────────────────┘
  1046.  
  1047.         * Field contents match: Display popup of fields in the current database:
  1048.                         ┌[  Select Search Field  ] ───┐
  1049.                        │DESCRIPT                     │
  1050.                        │MEMO_ORIG                    │
  1051.                        └─────────────────────────────┘
  1052.  
  1053.           You will be prompted on how to search the database for the field
  1054.           selected:
  1055.                   ┌[ Locate record where DESCRIPT: ] ─────┐
  1056.                   │== is exactly equal to                 │
  1057.                   │>  is greater than                     │
  1058.                   │<  is less than                        │
  1059.                   │>= is greater than or equal to         │
  1060.                   │<= is less than or equal to            │
  1061.                   │#  is not equal to                     │
  1062.                   │$  contains                            │
  1063.                   │S  starts with                         │
  1064.                   │E  ends with                           │
  1065.                   │?  WILDCARD                            │
  1066.                   └───────────────────────────────────────┘
  1067.  
  1068.           Highlight the desired method (we've chosen "is exactly equal to"
  1069.           for this example), and press the Enter key. Type in the text string
  1070.           you want the string compared to (in this example we are searching for
  1071.           "sample":
  1072.  ┌────────────────────────────────────────────────────────────────────────┐
  1073.  │ Locate for DESCRIPT is exactly equal to                                │
  1074.  │ sample__________________________________________________               │
  1075.  └────────────────────────────────────────────────────────────────────────┘
  1076.  
  1077.           The database file will be searched from beginning to end; if the
  1078.           record is found it will be displayed; else an error message box
  1079.           will be displayed:
  1080.                             ┌───────────────────┐
  1081.                             │ No match found... │
  1082.                             │                   │
  1083.                             │ Press a key...    │
  1084.                             └───────────────────┘
  1085.  
  1086.     *  Query Match: Allows you to build a "Query" to search the database for
  1087.        highly specific information; an example of a query would be: Your boss
  1088.        wants to know names of clients that purchased widget X in the months
  1089.        of Jan-Mar, and paid retail for the part. The query would be defined
  1090.        as such: Widget = 'X' .and. Month = 'Jan' .or. Month = 'Feb' .or.
  1091.        Month = 'Apr' .and. Price = 'Retail'. It would take a while to manually
  1092.        type all that in; you use scrollable lists of field names and operators
  1093.        to choose from. The first prompt is a simple one:
  1094.                     ┌───────────────────────────────────┐
  1095.                     │No query set .....BUILD ONE NOW?   │
  1096.                     │             YES  NO               │
  1097.                     └───────────────────────────────────┘
  1098.  
  1099.        Choose YES, and proceed forward to create the query:
  1100.                     ┌[Online Query Builder]────────────┐
  1101.                     │                                  │
  1102.                     │  Build a new Query               │
  1103.                     │  Add to current query            │
  1104.                     │  Count matching records          │
  1105.                     │  Zap (remove) existing Query     │
  1106.                     │  Save current Query to disk      │
  1107.                     │  Restore Query from disk         │
  1108.                     │  Delete stored queries           │
  1109.                     │  What is current Query           │
  1110.                     │  Edit current Query              │
  1111.                     │  View records matching Query     │
  1112.                     │  Quit                            │
  1113.                     │                                  │
  1114.                     │  No Query Active                 │
  1115.                     └──────────────────────────────────┘
  1116.  
  1117.        WOW - lot's of options to choose from! Looking down the list, you can
  1118.        reason that most deal with existing queries already built.
  1119.  
  1120.            * Build a new Query: Defines a new query. Displays a popup of fields
  1121.            from the current opened database:
  1122.  
  1123.                           ┌[Database Field List]──┐
  1124.                           │      < Deleted? >     │
  1125.                           │      DESCRIPT         │
  1126.                           │      MEMO_ORIG        │
  1127.                           │                       │
  1128.                           │                       │
  1129.                           │                       │
  1130.                           │                       │
  1131.                           │                       │
  1132.                           │                       │
  1133.                           │                       │
  1134.                           │                       │
  1135.                           │                       │
  1136.                           │───────────────────────│
  1137.                           │ ENTER to select       │
  1138.                           └───────────────────────┘
  1139.  
  1140.              We chose the field named 'Descript' by highlighting that field,
  1141.              then pressing the Enter key to select it. Another popup box will
  1142.              appears to define what action is taken:
  1143.                        ┌────────────────────────────┐
  1144.                        │ =   (EXACTLY EQUAL TO)     │
  1145.                        │ <>  (NOT EQUAL TO)         │
  1146.                        │ <   (LESS THAN)            │
  1147.                        │ >   (GREATER THAN)         │
  1148.                        │ <=  (LESS THAN OR EQUAL TO │
  1149.                        │ >=  (GREATER OR EQUAL TO)  │
  1150.                        │ $   (CONTAINS)             │
  1151.                        │ !$  (DOES NOT CONTAIN)     │
  1152.                        │ ?*  (WILDCARD MATCH)       │
  1153.                        │ S   (IS SIMILIAR TO)       │
  1154.                        │ B   (BEGINS WITH)          │
  1155.                        │ E   (ENDS WITH)            │
  1156.                        │                            │
  1157.                        └────────────────────────────┘
  1158.  
  1159.              Highlight your choice and press the Enter key to proceed forward;
  1160.              we chose '= (Exactly Equal To)' for this example. Another popup
  1161.              box appears onscreen asking what to search for in this field:
  1162.             ┌Compare to ───────────────────────────────────────┐
  1163.             │ Type in a value to compare                       │
  1164.             │ Select a single value from the database (scroll) │
  1165.             │ Compare to another field in the same record      │
  1166.             └──────────────────────────────────────────────────┘
  1167.  
  1168.             Highlight your choice and press the Enter key to proceed forward.
  1169.             Here we have entered the word Jones to search for manually; Choosing
  1170.             the second option would popup a scrolling list of previously entered
  1171.             data in the field Descript that could be chosen from, or the third
  1172.             choice would compare the Descript field with another field in the
  1173.             open database. Choosing the first option and manually typed in the
  1174.             word 'Jones':
  1175.        ┌────────────────────────────────────────────────────────────┐
  1176.        │VALUE TO COMPARE     (TYPE CHARACTER)                       │
  1177.        │Jones_______________________________________________        │
  1178.        │                                                            │
  1179.        │                                                            │
  1180.        └────────────────────────────────────────────────────────────┘
  1181.             Choosing the Enter key, another popup box asks where you wish to
  1182.             go from here; choose DONE if you have finished defining search
  1183.             criteria; choosing one of the other choices further narrows down
  1184.             the search pattern. We'll choose DONE in this example (if we
  1185.             hadn't, we would simply repeat the process of picking another
  1186.             field, entering a value to compare to and end up here again). This
  1187.             process can be as simple or complex as you deem necessary; there is
  1188.             no limitation on how complicated the query can be. Keep in mind
  1189.             that if you are going to define a query a couple of layers down
  1190.             using the .AND.  operator, remember that if the first instance is
  1191.             not found in the database, it will not attempt to search for the
  1192.             second! An example of this would be: a sample query where Descript
  1193.             = 'Jones' .and.  Descript = 'Moore'. The database would be searched
  1194.             from beginning to end for any occurance of Jones; if none were found,
  1195.             then the query would stop because in the query we have defined both
  1196.             as needing to return a value of True. When no occurances were found,
  1197.             the query returned a value of False, therefore aborting the query
  1198.             and stopping the database from searching for Moore. If we had defined
  1199.             the query like this, it wouldn't matter if zero occurances of Jones
  1200.             were found, because the value from the first search would become
  1201.             inconsequential: Descript = 'Jones' .or.  Descript = 'Moore'.
  1202.                                 ┌────────────┐
  1203.                                 │ DONE       │
  1204.                                 │ AND        │
  1205.                                 │ OR         │
  1206.                                 │ AND NOT    │
  1207.                                 │ OR NOT     │
  1208.                                 └────────────┘
  1209.  
  1210.             A temporary index is created to speed up the search process; a
  1211.             progress bar is displayed onscreen to inform you how long it will
  1212.             take to complete the search, and also show you how many matches were
  1213.             found:
  1214.        ┌─Counting matches─────────────────────────────────────────────┐
  1215.        │                                                              │
  1216.        │    0%   10%  20%  30%  40%  50%  60%  70%  80%  90% 100%     │
  1217.        │    ├────┼────┼────┼────┼────┼────┼────┼────┼────┼─────┤      │
  1218.        │                                                              │
  1219.        │     ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒       │
  1220.        │                                                              │
  1221.        │                    4 matches of 220 scanned                  │
  1222.        └─Done - press a key───────────────────────────────────────────┘
  1223.  
  1224.             You will now be returned to the main menu to manipulate your
  1225.             query, or view records matching the query condition.
  1226.  
  1227.            * Add to current query: If you have defined a query beforehand, you
  1228.              can add more criteria to it to further narrow the information
  1229.              retrieved from the query.
  1230.  
  1231.            * Count matching records: Counts the number of matches found.
  1232.  
  1233.            * Zap (remove) existing query: Clears the active query.
  1234.  
  1235.            * Save current Query to disk: Save a query that has been defined to
  1236.              the hard drive for later use. A popup message box will appear
  1237.              onscreen prompting you for a descriptive name for the active
  1238.              query. You are not restricted to only eight characters like a
  1239.              Ms-Dos filename, so allow yourself the luxury of giving a name you
  1240.              or someone else may understand!
  1241.   ┌────────────────────────────────────────────────────────────────────────┐
  1242.   │ Enter a description for this query ___________________________________ │
  1243.   └────────────────────────────────────────────────────────────────────────┘
  1244.  
  1245.              The name of the query and the query definition is stored into a
  1246.              database file that is used only by the query function; if that
  1247.              file is erased you will lose all existing queries!
  1248.  
  1249.            * Restore Query from disk: Retrieve a query that has been previously
  1250.              saved; a popup message box appears onscreen with a scrolling
  1251.              list of previously saved queries. To enable that query you
  1252.              only have to highlight it and press the Enter key. If no queries
  1253.              exist, you will recieve this error message onscreen:
  1254.                    ┌───────────────────────────────────────┐
  1255.                    │ No stored queries match this database │
  1256.                    │                                       │
  1257.                    │ Press a key...                        │
  1258.                    └───────────────────────────────────────┘
  1259.  
  1260.            * Delete stored queries: Delete an existing query; A scrolling list
  1261.              of saved queries displayed; highlight the query you want to remove
  1262.              and press the Enter key. WARNING: If you decide to remove a query,
  1263.              it will be removed forever!!
  1264.  
  1265.            * What is current Query: Let's you see what the active query is. A
  1266.              popup box will display onscreen to inform you what the current
  1267.              query is:
  1268.                               ┌─────────────────┐
  1269.                               │ Current QUERY   │
  1270.                               │ (DESCRIPT=Jones)│
  1271.                               │                 │
  1272.                               │                 │
  1273.                               │                 │
  1274.                               │                 │
  1275.                               │ Press a key...  │
  1276.                               └─────────────────┘
  1277.  
  1278.            * Edit current Query: If you are at home with dBase syntax, or
  1279.              know operators are, you can directly edit an active query from the
  1280.              command line without having to use all the popup field lists
  1281.              and operator pickboxes. A full screen editing window will appear:
  1282.  
  1283. ┌─[Evaluation of Query Expressions]──────────────────────────────────────────┐
  1284. │                                                                            │
  1285. │     A query expression may contain several different operators.            │
  1286. │     Each operation is performed by the computer in a particular order,     │
  1287. │     with precedence as follows:                                            │
  1288. │                                                                            │
  1289. │     1. Operations within parentheses                ()                     │
  1290. │     2. Concatenation of character expressions       + -                    │
  1291. │     3. Mathematical operations (in this order)      ^*/%-+                 │
  1292. │     4. Comparison operations                        = < > != $ ==          │
  1293. │     5. Logical operations (in this order)           .NOT. .AND. .OR.       │
  1294. │                                                                            │
  1295. │     To ensure an operation is done first, enclose it in parentheses.       │
  1296. │                                                                            │
  1297. │                                                                            │
  1298. │[Edit Query]────────────────────────────────────────────────────────────────│
  1299. │ Query:                                                                     │
  1300. │ (DESCRIPT="Jones")                                                         │
  1301. └────────────────────────────────────────────────────────────────────────────┘
  1302.              Instructions are on screen for available operators; the
  1303.              current query is displayed on the bottom line. Ensure that your
  1304.              finished query is enclosed within parenthesis. Press the Enter
  1305.              key to save the query and return back to the Query menu.
  1306.  
  1307.            * View records matching Query: If a query is active and more than
  1308.              one record has met the query criteria, you can view the
  1309.              record(s) in the database. This is particularly useful when you
  1310.              want to ensure that the query is correct before printing a
  1311.              report. The bottom of the window shows navigation keys:
  1312.        ┌──────RECORD       1 ]───────────────────────────────────────────────┐
  1313.     │      < Deleted? >         F                                         │
  1314.     │      DESCRIPT             scott                                     │
  1315.     │      MEMO_ORIG            (MEMO FIELD)                              │
  1316.     │                                                                     │
  1317.     │                                                                     │
  1318.     │                                                                     │
  1319.     │                                                                     │
  1320.     │                                                                     │
  1321.     │                                                                     │
  1322.     │                                                                     │
  1323.     │                                                                     │
  1324.     │                                                                     │
  1325.     │                                                                     │
  1326.     │                                                                     │
  1327.     │                                                                     │
  1328.     │                                                                     │
  1329.     └─[ ( N )Next  ( P )Prior  ( Q )Quit   (V)iew Memo   ()More]────────┘
  1330.  
  1331.         * End of file: Jump to the last record of the database file.
  1332.  
  1333.         * Beginning of File: Jump to the first record of the database file.
  1334.  
  1335.         * Deleted Records: View only deleted records.
  1336.  
  1337.         * Memo contents: Search memo fields for a text string; only works if
  1338.           the open database file has a memo field.
  1339.  
  1340.         * Never Mind: Aborts the search process and return to the main menu.
  1341.  
  1342.     *  KEY SEARCH: Search the current open database file using an index file
  1343.        (which must be open) to search for a value. A popup box will appear
  1344.        onscreen for you to enter a search string. The database will be searched
  1345.        for the first occurance; if found the record pointer is moved to that
  1346.        record and the contents are displayed onscreen; if not a popup message
  1347.        appears:
  1348.            ┌─────────────┐                    ┌─────────────────┐
  1349.            │ Seek value: │    ────────────   │ Not Found       │
  1350.            │ scott       │                    │                 │
  1351.            └─────────────┘                    │ Press a key...  │
  1352.                                               └─────────────────┘
  1353.  
  1354.     *  TABLEVIEW: Browse all records in the current open database in a tabular
  1355.        manner. The arrow keys and PgUp/PgDn keys are used for navigating through
  1356.        the file; the record highlighted becomes the 'active' record. Pressing
  1357.        the Enter key returns you to main menu once again, and the record
  1358.        highlighted is displayed on the right 3/4 of the screen.
  1359.  
  1360.     *  HARDCOPY: Print the current record contents, and optionally print the
  1361.        memo field contents if desired if the file has a memo field defined. A
  1362.        popup window appears onscreen asking which of the two you wish to print;
  1363.        highlight your choice and press the Enter key (make sure the printer is
  1364.        online):
  1365.                             ┌Hardcopy of:─────────┐
  1366.                             │ Current record      │
  1367.                             │ Attached Memo field │
  1368.                             └─────────────────────┘
  1369.  
  1370.     * VIEWMEMO: View a memo field onscreen in a popup window that will
  1371.       temporarily overwrite the location where the field information normally
  1372.       appears (if a memo field is present):
  1373.  
  1374. ╔═ Menu ══════╗┌──[VIEWING MEMO FIELD: MEMO_ORIG Press ESCAPE when done]───────┐
  1375. ║             ║│ Sample memo field entry for the CED documentation.            │
  1376. ║ Next Record ║│                                                               │
  1377. ║ Prev Record ║│                                                               │
  1378. ║ Search File ║│                                                               │
  1379. ║ Key Search  ║│                                                               │
  1380. ║ TableView   ║│                                                               │
  1381. ║ Hardcopy    ║│                                                               │
  1382. ║ Viewmemo    ║│                                                               │
  1383. ║ Build Query ║│                                                               │
  1384. ║ Field Order ║│                                                               │
  1385. ║ Edit Record ║│                                                               │
  1386. ║ Add Record  ║│                                                               │
  1387. ║ Memo Edit   ║│                                                               │
  1388. ║ Delete      ║│                                                               │
  1389. ║ Quit        ║│                                                               │
  1390. ║             ║│                                                               │
  1391. ║             ║│                                                               │
  1392. ║──────────── ║│                                                               │
  1393. ║ Rec#        ║│                                                               │
  1394. ║       1     ║│                                                               │
  1395. ║ of #        ║│                                                               │
  1396. ║          1  ║│                                                               │
  1397. ║             ║│                                                               │
  1398. ╚═════════════╝└───────────────────────────────────────────────────────────────┘
  1399.  
  1400.     *  BUILD QUERY:  See the notes above for "Search File" to understand what
  1401.        this function does.
  1402.  
  1403.     *  FIELD ORDER: Change the sequence fields are displayed onscreen. This is
  1404.        especially useful for data entry if you only have to enter a few fields
  1405.        worth of information, and the remainder are skipped. Moving the often
  1406.        used fields to the top in an order that matches the information source
  1407.        can cut down on the amount of typing needed to get the job finished. A
  1408.        popup window will appear onscreen; highlight the field and press Enter.
  1409.        You will be asked what field number you wish to make it. After a number
  1410.        has been entered, you will notice that the fields in the box will re-
  1411.        order themselves to accomodate the change(s). You may continue this
  1412.        process until satisfied. Press Escape and the fields will be updated in
  1413.        this new sequence and allow you to continue adding/editing/etc.
  1414.            ┌──────────────────┬────────────────────────────────────┐
  1415.            │                  │  Field Viewing Order:              │
  1416.            │     DESCRIPT     │                                    │
  1417.            │     MEMO_ORIG    │ The fields for this datafile may   │
  1418.            │                  │ be viewed in any order.            │
  1419.            │                  │                                    │
  1420.            │                  │                                    │
  1421.            │                  │                                    │
  1422.            │                  │                                    │
  1423.            │                  │ Press ENTER to select a field to   │
  1424.            │                  │ move. You will be prompted for the │
  1425.            │                  │ position to move it to.            │
  1426.            │                  │                                    │
  1427.            │                  │                                    │
  1428.            │                  │                                    │
  1429.            │                  │                                    │
  1430.            ├──────────────────┤                                    │
  1431.            │                  │ Press ESCAPE when done.            │
  1432.            │Total Fields:2    │                                    │
  1433.            └──────────────────┴────────────────────────────────────┘
  1434.  
  1435.     *  EDIT RECORD: Edit the current record displayed on the right 3/4 of the
  1436.        screen. A highlight bar will appear on the first field, and the cursor
  1437.        will come on for the edit mode. You may make any editing changes deemed
  1438.        necessary at this point. Reaching the last field will display a popup
  1439.        box onscreen to optionally save your changes. If you only have a few
  1440.        changes to make, you may press the F10 key to save the changes without
  1441.        scrolling through the rest of the fields onscreen:
  1442. ╔═ Menu ══════╗┌──  V·I·E·W  P·O·R·T  for file: FORM ──────────────────────────┐
  1443. ║             ║│                                                               │
  1444. ║ Next Record ║│        DESCRIPT        scott                                  │
  1445. ║ Prev Record ║│        MEMO_ORIG       (memo)                                 │
  1446. ║ Search File ║│                                                               │
  1447. ║ Key Search  ║│                                                               │
  1448. ║ TableView   ║│                                                               │
  1449. ║ Hardcopy    ║│                                                               │
  1450. ║ Viewmemo    ║│                                                               │
  1451. ║ Build Query ║│                                                               │
  1452. ║ Field Order ║│                                                               │
  1453. ║ Edit Record ║│                                                               │
  1454. ║ Add Record  ║│                                                               │
  1455. ║ Memo Edit   ║│                                                               │
  1456. ║ Delete      ║│                                                               │
  1457. ║ Quit        ║│                                                               │
  1458. ║             ║│                                                               │
  1459. ║             ║│                                                               │
  1460. ║──────────── ║│                                                               │
  1461. ║ Rec#        ║│                                                               │
  1462. ║       1     ║│                                                               │
  1463. ║ of #        ║│                                                               │
  1464. ║          1  ║│                                                               │
  1465. ║             ║│                                                               │
  1466. ╚═════════════╝└──╢ F10 to save       ESC to cancel                    ╟───────┘
  1467.  
  1468.     *  ADD RECORD: Add a record to the current database file. What makes this
  1469.        option convienient is that you can copy the last records contents into
  1470.        the new record; this becomes a timesaver if data inputted doesn't change
  1471.        very much. Once you have 'carried' this information over, you can edit
  1472.        for any needed changes, then save it to the database file. A popup box
  1473.        will appear asking if you choose to do this:
  1474.                 ┌────────────────────────────────────────────┐
  1475.                 │Carry contents of current record forward?   │
  1476.                 │                  No  Yes                   │
  1477.                 └────────────────────────────────────────────┘
  1478.  
  1479.        A highlight bar appears on the first field, and the cursor will
  1480.        appear. Pressing the F10 key saves the newly entered information; you
  1481.        can abort the add routine by pressing the Escape key.
  1482.  
  1483.     *  MEMO EDIT: Edit a memo fields contents if the currently open database
  1484.        file has a memo field defined. A popup window temporarily appears over
  1485.        the area normally occupied with field information. You can optionally
  1486.        import an Ascii file (as long as the size is under 64k) into the field
  1487.        by using the F5 key; when you have finished with the field you can
  1488.        export it's contents to an Ascii type file by pressing the F6 key.
  1489.        F10 will save the information, and Escape will abort the process:
  1490. ╔═ Menu ══════╗┌[MEMO PAD]────Line:    1──Col:    0────────────────────────────┐
  1491. ║             ║│                                                               │
  1492. ║ Next Record ║│                                                               │
  1493. ║ Prev Record ║│                                                               │
  1494. ║ Search File ║│                                                               │
  1495. ║ Key Search  ║│                                                               │
  1496. ║ TableView   ║│                                                               │
  1497. ║ Hardcopy    ║│                                                               │
  1498. ║ Viewmemo    ║│                                                               │
  1499. ║ Build Query ║│                                                               │
  1500. ║ Field Order ║│                                                               │
  1501. ║ Edit Record ║│                                                               │
  1502. ║ Add Record  ║│                                                               │
  1503. ║ Memo Edit   ║│                                                               │
  1504. ║ Delete      ║│                                                               │
  1505. ║ Quit        ║│                                                               │
  1506. ║             ║│                                                               │
  1507. ║             ║│                                                               │
  1508. ║──────────── ║│                                                               │
  1509. ║ Rec#        ║│                                                               │
  1510. ║       2     ║│                                                               │
  1511. ║ of #        ║│                                                               │
  1512. ║          2  ║│                                                               │
  1513. ║             ║│                                                               │
  1514. ╚═════════════╝└[ F10:SAVE | ESC:EXIT | F5:Import |F6:Export]──────────────────┘
  1515.  
  1516.     *  DELETE:  This function acts as a toggle to delete/undelete the current
  1517.        record. This works exactly as it does in dBase; the record's first
  1518.        position is marked with an asterisk when marked as deleted. The record
  1519.        still exists until you use the Pack command. The undelete will remove
  1520.        the asterisk. You will notice that if a record is marked as 'Deleted'
  1521.        that the bottom left side will say 'Deleted', and the menu prompt will
  1522.        change from 'Delete' to 'Undelete'.
  1523.  
  1524.     *  QUIT: Return back to the main menu.
  1525.  
  1526. ╒══════════════════╕
  1527. │RUN - COMPILE ONLY│
  1528. ╘══════════════════╛
  1529.  
  1530. Execute the Clipper compiler on source code files ending with *.Prg. A popup
  1531. box is displayed onscreen for files with a .Prg file extension in the current
  1532. directory; if none are found an error message is displayed:
  1533.                             ┌[Select: ]─────────┐
  1534.                             │      DC.PRG       │
  1535.                             │      SAMPLE.PRG   │
  1536.                             └───────────────────┘
  1537.  
  1538. Press the Enter key to compile the file; CED swaps itself out of memory (all
  1539. but 12k) and runs the Clipper compiler. If you have defined switches to use
  1540. with Clipper they will be passed to Clipper.
  1541.  
  1542. ╒═══════════════╕
  1543. │RUN - LINK ONLY│
  1544. ╘═══════════════╛
  1545.  
  1546. Execute the linker defined in the CED setup to convert the *.Obj file created
  1547. by Clipper into a stand-alone *.Exe file. A popup window will appear if *.Obj
  1548. files are located in the current directory; if none exist an error message box
  1549. will appear onscreen:
  1550.                                ┌[Select: ]─────────┐
  1551.                              │   DC.OBJ          │
  1552.                              │   SAMPLE.OBJ      │
  1553.                              └───────────────────┘
  1554.  
  1555. Highlight your file and press the Enter key to execute your linker; if you have
  1556. defined other *.Obj files to be linked in by default (such as Errorsys.Obj) CED
  1557. will link it in; any libraries you have defined will also be linked. If
  1558. successful, you will be told so by a message box; if not, you will also be
  1559. informed by a message box (CED checks if the name of the object file with an
  1560. *.Exe file extension is in the current dirctory after it has finished linking
  1561. to determine success or not).
  1562.  
  1563. ╒══════════════════╕
  1564. │RUN - COMPILE/LINK│
  1565. ╘══════════════════╛
  1566.  
  1567. This menu option combines the two separate options above into a one-step
  1568. process. A scrolling picklist appears onscreen to choose a *.Prg file to
  1569. compile (if no files exist an error box will appear onscreen). Pressing
  1570. the Enter key starts the process of compile/link automatically, using all
  1571. default settings you have configured CED with. A message box will be displayed
  1572. to inform you if the compile/link was successful.
  1573.  
  1574. ╒═════════════════════════╕
  1575. │RUN - USE A MAKE FACILITY│
  1576. ╘═════════════════════════╛
  1577.  
  1578. Execute your Make utility used for maintaining large applications. You may use
  1579. Rmake that is supplied with Clipper, or any of the other Make utilities
  1580. available. You must configure CED with the name of your utility, or you will
  1581. recieve this error message onscreen:
  1582.             ┌───────────────────────────────────────────────────┐
  1583.             │ ERROR: You Haven't Configured A Make Utility Yet! │
  1584.             │                                                   │
  1585.             │ Press a key...                                    │
  1586.             └───────────────────────────────────────────────────┘
  1587.  
  1588. CED swaps itself out of memory (all but 12k) to execute the Make utility, then
  1589. returns itself to the main menu when it has ran it's course. Consult your make
  1590. utility for further guidance on usage.
  1591.  
  1592. ╒════════════════╕
  1593. │RUN - *.EXE FILE│
  1594. ╘════════════════╛
  1595.  
  1596. Execute any file ending with a *.Exe file extension located in the current
  1597. directory. CED swaps all but 12k of itself to execute the file, then returns
  1598. back to itself upon that program's termination. You will be given a scrolling
  1599. box to choose a file from; highlight your choice and press the Enter key to
  1600. run it:
  1601.                             ┌[Select: ]─────────┐
  1602.                             │      DC.EXE       │
  1603.                             │                   │
  1604.                             └───────────────────┘
  1605.  
  1606. ╒════════════════════════════════╕
  1607. │PRINT - CREATE/PRINT FORMLETTERS│
  1608. ╘════════════════════════════════╛
  1609.  
  1610. Integrate database file contents into formletters painlessly and easily. It is
  1611. a self-contained module; the only prerequisite is that a database file needs
  1612. opened before calling the function (you will be given an error message if not).
  1613. The main menu for this option appears:
  1614. ┌──────────────────────────────────────────────────────────────────────────────┐
  1615. │   ┌[Form Letters Utility]────────┐                             [No Query    ]│
  1616. │   │   Select form                │                                           │
  1617. │   │   Create new Form            │                                           │
  1618. │   │   Delete Forms               │                                           │
  1619. │   │   Edit current form          │                                           │
  1620. │   │   Print form letters         │                                           │
  1621. │   │   Width of Form : 79         │                                           │
  1622. │   │   Output to :PRINTER         │                                           │
  1623. │   │   Assign Printer Port        │                                           │
  1624. │   │   Filter :ALL RECORDS        │                                           │
  1625. │   │                              │                                           │
  1626. │   │   Quit                       │                                           │
  1627. │   └──────────────────────────────┘                                           │
  1628. │                                                                              │
  1629. │                                                                              │
  1630. │                                                                              │
  1631. │                                                                              │
  1632. │                                                                              │
  1633. │                                                                              │
  1634. │┌────────────────────────────────────────────────────────────────────────────┐│
  1635. ││  CURRENT FORM ->                                                           ││
  1636. ││  DATAFILE     ->SAMPLE                                                     ││
  1637. │└────────────────────────────────────────────────────────────────────────────┘│
  1638. └──────────────────────────────────────────────────────────────────────────────┘
  1639.  
  1640. Options are explained in sequential order:
  1641.  
  1642.   * Select form: Retrieve a formletter previously created and saved.If no forms
  1643.     are on file (they are stored in a database file), an error message is
  1644.     displayed:
  1645.                              ┌──────────────────┐
  1646.                              │ No forms on file │
  1647.                              │                  │
  1648.                              │ Press a key...   │
  1649.                              └──────────────────┘
  1650.  
  1651.   Otherwise, a scrolling list of available formletters will be displayed
  1652.   onscreen; highlight a choice and press the Enter key to select it.
  1653.  
  1654.   *    Create new Form: A popup box will appear asking for a name for the new
  1655.    form; you are not limited to the normal 8 character filename as you are in
  1656.    Ms-Dos, so feel free to provide a meaningful description:
  1657.             ┌────────────────────────────────────────────────────┐
  1658.             │ Enter a description for the form letter            │
  1659.             │ _________________________________________________  │
  1660.             └────────────────────────────────────────────────────┘
  1661.  
  1662.    You will now be prompted if you wish to use an existing formletter as a
  1663.    template; if you choose yes, you will be given a popup list of formletters
  1664.    to choose from. Pressing the Enter key will import the file into the
  1665.    editing workspace:
  1666.                    ┌───────────────────────────────────────┐
  1667.                    │Use another form letter as a shell ?   │
  1668.                    │             No  Yes                    │
  1669.                    └───────────────────────────────────────┘
  1670.  
  1671.    If you choose No, another popup will appear asking if you want to use an
  1672.    existing Ascii formatted text file as a template; if you choose yes it will
  1673.    be imported into the editing workspace:
  1674.                      ┌──────────────────────────────────┐
  1675.                      │Import a text file as a shell ?   │
  1676.                      │             No  Yes              │
  1677.                      └──────────────────────────────────┘
  1678.  
  1679.    You will now be presented the Formletter editing workarea onscreen for
  1680.    editing the letter:
  1681.  
  1682. ┌───── F1:HELP     F2:Field picklist     F10:SAVE       ESC:CANCEL  ───────────┐
  1683. │Dear «Trim(Proper(NAME))»                                                     │
  1684. │                                                                              │
  1685. │    This letter is to inform you that your bill is overdue; please submit the │
  1686. │sum of «Trim(Proper(DUE))» to our office to prevent other action to collect   │
  1687. │monies due to occur.                                                          │
  1688. │                                                                              │
  1689. │                                                Sincerely,                    │
  1690. │                                                The IRS                       │
  1691. │                                                                              │
  1692. │                                                                              │
  1693. │                                                                              │
  1694. │                                                                              │
  1695. │                                                                              │
  1696. │                                                                              │
  1697. │                                                                              │
  1698. │                                                                              │
  1699. │                                                                              │
  1700. │                                                                              │
  1701. │                                                                              │
  1702. │                                                                              │
  1703. │                                                                              │
  1704. │                                                                              │
  1705. │                                                                              │
  1706. └─────  Line:    8──  Col:   55────────────────────────────────────────────────┘
  1707.  
  1708.    The top line shows basic command help; I have already pressed the F2 key to
  1709.    'popup' a list of fields that can be imported into the letter. I've already
  1710.    typed in a basic letter to show what how the screen would appear as; when you
  1711.    select a field you will be given the opportunity to change it's appearance
  1712.    (uppercase/lowercase/trim blank spaces/uppercase the first letter only). The
  1713.    «» characters on the screen and the Trim/Proper statements will NOT
  1714.    be printed; they appear onscreen to show what is happening with that field.
  1715.    It may take so playing with to get the final output aligned properly, since
  1716.    what you see onscreen isn't necessarily what the final product will look
  1717.    like. Pressing the F10 key or the Escape key will present a popup box asking
  1718.    if you wish to save the file or not:
  1719.                         ┌────────────────────────────┐
  1720.                         │Save changes and exit?      │
  1721.                         │ Save and Exit  Don't Exit  │
  1722.                         └────────────────────────────┘
  1723.  
  1724.   * Delete Forms: If any forms have been created and saved, this will allow for
  1725.     you to purge old formletters from the file that are no longer needed.
  1726.     Highlight the file and press the Enter key to delete the formletter.
  1727.  
  1728.     ┌[Tag Records to Delete]──────────────────────────────────────────────┐
  1729.     │         SPACE = tag  C = clear  S = search  ESC = done          │
  1730.     │─────────────────────────────────────────────────────────────────────│
  1731.     │Tag        DESCRIPT                                                  │
  1732.     │─────────────────────────────────────────────────────────────────────│
  1733.     │ √ │       SAMPLE FORMLETTER                                         │
  1734.     │   │                                                                 │
  1735.     │   │                                                                 │
  1736.     │   │                                                                 │
  1737.     │   │                                                                 │
  1738.     │   │                                                                 │
  1739.     │   │                                                                 │
  1740.     │   │                                                                 │
  1741.     │   │                                                                 │
  1742.     │   │                                                                 │
  1743.     │   │                                                                 │
  1744.     │─────────────────────────────────────────────────────────────────────│
  1745.     │                          0 records tagged                           │
  1746.     └─────────────────────────────────────────────────────────────────────┘
  1747.  
  1748.   *    Edit current form: Edit an existing form.
  1749.  
  1750.   *    Print form letters: Print a formletter that has been saved. If the printer
  1751.   is not ready, you will receive an error box informing you of the problem:
  1752.                     ┌Printer (LPT1) apparently not ready─┐
  1753.                     │ Try again                          │
  1754.                     │ Abort                              │
  1755.                     │ Ignore                             │
  1756.                     │ Change Printer Port                │
  1757.                     └────────────────────────────────────┘
  1758.  
  1759.   *    Width of Form : Change the right margin of the page the formletter will be
  1760.   printed on. A popup box will appear to allow the new entry:
  1761.                              ┌──────────────────┐
  1762.                              │ Form width    79 │
  1763.                              └──────────────────┘
  1764.  
  1765.   *    Output to : Gives you the ability to save the output to a file instead of
  1766.     using the printer. The default is to the printer; if you choose filename
  1767.     you may give a unique filename+extension for the output to go to.
  1768.  
  1769.   * Assign Printer Port: Change which printer port the output needs
  1770.     directed to. A popup box will appear onscreen; highlight your choice and
  1771.     press the Enter key to begin that choice:
  1772.                                ┌─[Printer Port]┐
  1773.                                │   LPT1        │
  1774.                                │   LPT2        │
  1775.                                │   LPT3        │
  1776.                                └───────────────┘
  1777.  
  1778.   * Filter: Define a subset of data that needs printed; default is all records
  1779.     in the open database; a popup box will appear onscreen if you wish to
  1780.     change this:
  1781.                              ┌Filter type────────┐
  1782.                              │ None - All records│
  1783.                              │ Query Matches     │
  1784.                              │ Tagged Records    │
  1785.                              │ Single Record     │
  1786.                              └───────────────────┘
  1787.  
  1788.     The Query Matches option lets you define a query to narrow down records
  1789.     requiring printing (for help with setting up queries reread the section
  1790.     about this in the Edit Database section); Tagged Records allows you
  1791.     to individually tag single/multiple records by scrolling through the
  1792.     database. A popup window will appear onscreen to tag records:
  1793.     ┌─────────────────────────────────────────────────────────────────────┐
  1794.     │         SPACE = tag  C = clear  S = search  ESC = done          │
  1795.     │─────────────────────────────────────────────────────────────────────│
  1796.     │Tag                        ONE        TWO                            │
  1797.     │─────────────────────────────────────────────────────────────────────│
  1798.     │ √ │                       scott     │scott                          │
  1799.     │   │                                 │                               │
  1800.     │   │                                 │                               │
  1801.     │   │                                 │                               │
  1802.     │   │                                 │                               │
  1803.     │   │                                 │                               │
  1804.     │   │                                 │                               │
  1805.     │   │                                 │                               │
  1806.     │   │                                 │                               │
  1807.     │   │                                 │                               │
  1808.     │   │                                 │                               │
  1809.     │─────────────────────────────────────────────────────────────────────│
  1810.     │                          1 record tagged                            │
  1811.     └─────────────────────────────────────────────────────────────────────┘
  1812.  
  1813.     The Single record option allows for printing a formletter from a single
  1814.     record in the database (where the record pointer is positioned in the
  1815.     database file). You may either browse through the database file and tag the
  1816.     record, or use the current record:
  1817.                            ┌──────────────────────┐
  1818.                            │Select record?        │
  1819.                            │ Browse  Use current  │
  1820.                            └──────────────────────┘
  1821.  
  1822.     I chose Browse to display this screen:
  1823. ┌────[Browse Window]───────────────────────────────────────────────────────────┐
  1824. │    [Record #             1]                      (F1 for Navigation keys)    │
  1825. └──────────────────────────────────────────────────────────────────────────────┘
  1826. ┌──────────────────────────────────────────────────────────────────────────────┐
  1827. │                              ONE        TWO                                  │
  1828. │──────────────────────────────────────────────────────────────────────────────│
  1829. │                              scott     │(memo)                               │
  1830. │                                        │                                     │
  1831. │                                        │                                     │
  1832. │                                        │                                     │
  1833. │                                        │                                     │
  1834. │                                        │                                     │
  1835. │                                        │                                     │
  1836. │                                        │                                     │
  1837. │                                        │                                     │
  1838. │                                        │                                     │
  1839. │                                        │                                     │
  1840. │                                        │                                     │
  1841. │                                        │                                     │
  1842. │                                        │                                     │
  1843. └──────────────────────────────────────────────────────────────────────────────┘
  1844. ┌──────────────────────────────────────────────────────────────────────────────┐
  1845. │ (Q)uit     (G)oto       (S)earch    (L)ock    (V)ertical View    (F)ields    │
  1846. │                                                                              │
  1847. └──────────────────────────────────────────────────────────────────────────────┘
  1848.  
  1849.                               ┌───────────────────┐
  1850.                               │CREATE/PRINT LABELS│
  1851.                               └───────────────────┘
  1852.  
  1853. This module allows you to extract information for a database file and print
  1854. varying sizes of labels on either dot-matrix or laser printer style labels.
  1855. It is entirely self-contained; just ensure that the database and an optional
  1856. index file are open before beginning. You may import dBase style *.Lbl files if
  1857. you desire; any labels that you create are stored into a database file that
  1858. contains all other necessary information (queries, label sizes, etc.) The main
  1859. menu appears as such; menu options are explained in sequential order:
  1860. ┌──────────────────────────────────────────────────────────────────────────────┐
  1861. │┌───[Mailing Labels]─────────────────────────────┐                            │
  1862. ││ Load Label from disk                           │                            │
  1863. ││ Save Label to disk                             │                            │
  1864. ││ Erase Label definition                         │                            │
  1865. ││ Import from .LBL format                        │                            │
  1866. ││ Dimensions of Label                            │                            │
  1867. ││ Contents of Label                              │                            │
  1868. ││ Output Test Pattern                            │                            │
  1869. ││ Print Mailing Labels                           │                            │
  1870. ││ Reset Printer Port. Now:LPT1                   │                            │
  1871. ││ Tag Records to Print                           │                            │
  1872. ││ Build or Modify Query                          │                            │
  1873. ││ About Using Laser Printers *                   │                            │
  1874. ││ Use Single Sheet Options                       │                            │
  1875. ││ Quit                                           │                            │
  1876. │└────────────────────────────────────────────────┘                            │
  1877. │                                                                              │
  1878. │                                                                              │
  1879. │                                                                              │
  1880. │┌────────────────────────────────────────────────────────────────────────────┐│
  1881. ││Label in use       :                                                        ││
  1882. ││Dbf file in use    : SAMPLE                                                 ││
  1883. │└────────────────────────────────────────────────────────────────────────────┘│
  1884. └──────────────────────────────────────────────────────────────────────────────┘
  1885.  
  1886.   * LOAD LABEL FROM DISK: If you have previously created any labels, they can
  1887.     be retrieved from the labels.dbf by scrolling down the list of saved
  1888.     labels, highlighting your choice and pressing the Enter key to activate it.
  1889.     If no labels are on file, you will get the following error message:
  1890.                   ┌─────────────────────────────────────────┐
  1891.                   │ No saved labels found in this directory │
  1892.                   │                                         │
  1893.                   │ Press a key...                          │
  1894.                   └─────────────────────────────────────────┘
  1895.  
  1896.   * SAVE LABEL TO DISK: After creating a new label, or making changes to an
  1897.     existing label, you can save the label and all of it's attributes to file
  1898.     for later use. If you have not created a file yet, you will get the
  1899.     following error message:
  1900.                            ┌──────────────────────┐
  1901.                            │ No contents defined! │
  1902.                            │                      │
  1903.                            │ Press a key...       │
  1904.                            └──────────────────────┘
  1905.  
  1906.   * ERASE LABEL DEFINITION: If a label is on file, you may purge unneeded
  1907.     labels by scrolling down your list of labels in the labels.dbf file, and
  1908.     delete one or more labels. NOTE: Once you have deleted a label, you cannot
  1909.     undelete it! If no labels are on file, you wil get this error message:
  1910.                   ┌─────────────────────────────────────────┐
  1911.                   │ No saved labels found in this directory │
  1912.                   │                                         │
  1913.                   │ Press a key...                          │
  1914.                   └─────────────────────────────────────────┘
  1915.  
  1916.     Otherwise you will be able to tag and delete stored labels from a
  1917.     scrollable picklist:
  1918.               ┌─────────────────────────────────────────────────┐
  1919.               │Tag Label descriptions to Delete                 │
  1920.               │─────────────────────────────────────────────────│
  1921.               │    √    │SAMPLE LABEL                           │
  1922.               │         │                                       │
  1923.               │         │                                       │
  1924.               │         │                                       │
  1925.               │         │                                       │
  1926.               │         │                                       │
  1927.               │         │                                       │
  1928.               │         │                                       │
  1929.               │         │                                       │
  1930.               │         │                                       │
  1931.               │─────────────────────────────────────────────────│
  1932.               │     space=TAG  C=CLEAR  F10=DONE            │
  1933.               └─────────────────────────────────────────────────┘
  1934.  
  1935.   * IMPORT FROM .LBL FORMAT: Allows you to import an existing .LBL label file
  1936.     created by dBase into this new format and edit the contents. If no .Lbl
  1937.     files are in the current directory, you will get this notice:
  1938.               ┌────────────────────────────────────────────────┐
  1939.               │ No label files (.LBL) found in this directory. │
  1940.               │                                                │
  1941.               │ Press a key...                                 │
  1942.               └────────────────────────────────────────────────┘
  1943.  
  1944.     Otherwise, you will be able to select an existing file from a scrolling
  1945.     picklist box:
  1946.                                ┌Label Files───┐
  1947.                                │SAMPLE.LBL    │
  1948.                                └──────────────┘
  1949.  
  1950.   * DIMENSIONS OF LABEL: Determine what size label you will be printing onto;
  1951.     you may use of the pre-defined label sizes, or manually enter dimensions
  1952.     required for output. The below illustration shows the manual editing
  1953.     mode:
  1954.          ┌──────────────────────────────────────────────────────────┐
  1955.          │                                                          │
  1956.          │    ---Label Dimensions---                                │
  1957.          │ Width                    35                              │
  1958.          │ Height                    5                              │
  1959.          │ Labels across            1                               │
  1960.          │ Lines between labels     1                               │
  1961.          │ Spaces between labels    0                               │
  1962.          │ Left Margin (indent)      0                              │
  1963.          │ Pre-setup code                                           │
  1964.          │                          (use ! for Escape)              │
  1965.          │ Post-setup code                                          │
  1966.          │                          (use ! for Escape)              │
  1967.          │                                                          │
  1968.          │ ---Individual Sheet Options---                           │
  1969.          │ Use individual sheets?   N                               │
  1970.          │ # Labels per sheet         0                             │
  1971.          │ Top margin (lines)        0                              │
  1972.          │ Pause between sheets?    N                               │
  1973.          │ Eject each sheet?        N                               │
  1974.          │──────────────────────────────────────────────────────────│
  1975.          │ Edit    Load Predefined Dimensions    Quit               │
  1976.          └──────────────────────────────────────────────────────────┘
  1977.  
  1978.     Choosing the 'Load Predefined Dimension' choice at the bottom will
  1979.     display choices that may be activated by highlighting your choice and
  1980.     pressing the Enter key:
  1981.    ┌───────────────────────────────────────────────────────────────────────┐
  1982.    │               Label Description - ENTER to Select                     │
  1983.    │───────────────────────────────────────────────────────────────────────│
  1984.    │               User Defined                                            │
  1985.    │               3(½)    x (15/16)   - 1 Across                          │
  1986.    │               3(½)    x (15/16)   - 2 Across                          │
  1987.    │               3(½)    x (15/16)   - 3 Across                          │
  1988.    │               3(2/10) x (11/12)   - 3 Across Cheshire                 │
  1989.    │               4       x 1(7/16)   - 1 Across                          │
  1990.    │               4       x 2(¼)      - (Rolodex)                         │
  1991.    │               3       x 5         - (Rolodex)                         │
  1992.    │               Avery 5160,5260,5660  (Laserjet)                        │
  1993.    │               Avery 5161,5261       (Laserjet)                        │
  1994.    │               Avery 5162,5262,5662  (Laserjet)                        │
  1995.    │               Avery 5163,5663       (Laserjet)                        │
  1996.    │               Avery 5164            (Laserjet)                        │
  1997.    │               Avery 5266            (Laserjet)                        │
  1998.    │               Avery 5196,5296       (Laserjet 3½ disk)                │
  1999.    │               Avery 5197,5297       (Laserjet 5¼ disk)                │
  2000.    │                                                                       │
  2001.    │                                                                       │
  2002.    │                                                                       │
  2003.    └───────────────────────────────────────────────────────────────────────┘
  2004.  
  2005.   * CONTENTS OF LABEL: The areas where you define what field and/or text will
  2006.     be displayed on each line of the outputted label. A new workarea will
  2007.     appear onscreen  with a highlight bar on the bottom. Choosing 'Field' will
  2008.     display a picklist of fields from the currently opened database (as is
  2009.     shown below); 'Text' will allow you to enter a string of text (a popup will
  2010.     appear for you to type in the text). You may also simply have blank spaces
  2011.     by pressing the 'Blank' choice at the bottom. The preview choice allows you
  2012.     to examine how the output will appear without printing an actual label.
  2013.  
  2014.  ┌─────────────────────────────────────┌Select Field────────────────────────┐
  2015.  │                                     │ONE                                 │
  2016.  │                                     │TWO                                 │
  2017.  │                                     └────────────────────────────────────┤
  2018.  │                                                                          │
  2019.  │                                                                          │
  2020.  │                                                                          │
  2021.  │                                                                          │
  2022.  │                                                                          │
  2023.  │                                                                          │
  2024.  │                                                                          │
  2025.  │                                                                          │
  2026.  │                                                                          │
  2027.  ├──────────────────────────────────────────────────────────────────────────┤
  2028.  │Quit         Clear  Field  Text  Blank  Preview                           │
  2029.  └──────────────────────────────────────────────────────────────────────────┘
  2030.        ┌──────────────────────────────────────────────────────────────┐
  2031.        │ Add text (do not use quotes)                                 │
  2032.        │                                                              │
  2033.        └──────────────────────────────────────────────────────────────┘
  2034.                              ┌──────────────────┐
  2035.                              │ Number of blanks │
  2036.                              │  1               │
  2037.                              └──────────────────┘
  2038.  
  2039.   * OUTPUT TEST PATTERN: Assists in properly aligning the label for
  2040.     final output by printing a series of 'XXXXXX' on the label on all lines
  2041.     filled with data. If the printer is not ready you will be informed:
  2042.                     ┌Printer (LPT1) apparently not ready─┐
  2043.                     │ Try again                          │
  2044.                     │ Abort                              │
  2045.                     │ Ignore                             │
  2046.                     │ Change Printer Port                │
  2047.                     └────────────────────────────────────┘
  2048.  
  2049.   * PRINT MAILING LABELS: If you have opened an existing label, or just
  2050.     finished defining a label, you may print labels. A popup window will appear
  2051.     asking you for information:
  2052.                 ┌────────────────────────────────────────────┐
  2053.                 │ Maximum labels to Print (ENTER for rest) : │
  2054.                 │         1                                  │
  2055.                 │ Number of EACH to print :                  │
  2056.                 │  1                                         │
  2057.                 │ Compress all but Single spaces:            │
  2058.                 │ Y                                          │
  2059.                 │ Remove blank lines:                        │
  2060.                 │ Y                                          │
  2061.                 └────────────────────────────────────────────┘
  2062.  
  2063.   * RESET PRINTER PORT: If the desired printer you wish to use is not located
  2064.     on LPT1, you may redirect the output by highlighting your choice and
  2065.     pressing the Enter key:
  2066.                                ┌─[Printer Port]┐
  2067.                                │   LPT1        │
  2068.                                │   LPT2        │
  2069.                                │   LPT3        │
  2070.                                └───────────────┘
  2071.  
  2072.   * Tag Records to Print: Individually select one or more records in the open
  2073.     database file by scrolling the file and pressing the Space Bar to select
  2074.     /unselect record(s):
  2075.     ┌─────────────────────────────────────────────────────────────────────┐
  2076.     │         SPACE = tag  C = clear  S = search  ESC = done          │
  2077.     │─────────────────────────────────────────────────────────────────────│
  2078.     │Tag                        ONE        TWO                            │
  2079.     │─────────────────────────────────────────────────────────────────────│
  2080.     │ √ │                       scott     │scott                          │
  2081.     │   │                                 │                               │
  2082.     │   │                                 │                               │
  2083.     │   │                                 │                               │
  2084.     │   │                                 │                               │
  2085.     │   │                                 │                               │
  2086.     │   │                                 │                               │
  2087.     │   │                                 │                               │
  2088.     │   │                                 │                               │
  2089.     │   │                                 │                               │
  2090.     │   │                                 │                               │
  2091.     │   │                                 │                               │
  2092.     │─────────────────────────────────────────────────────────────────────│
  2093.     │                          1 records tagged                           │
  2094.     └─────────────────────────────────────────────────────────────────────┘
  2095.  
  2096.   * BUILD OR MODIFY QUERY: Use only a subset of information for the output;
  2097.     reference the Edit Database section of this manual to examine how to set up
  2098.     a query (they use identical modules for defining queries).
  2099.  
  2100.   * About Using Laser Printers: Due to the nature of using laser printers for
  2101.     printing computerized labels, this option displays some helpful
  2102.     information:
  2103.           ┌─────────────────────────────────────────────────────────┐
  2104.           │   If you are using an HP Laser Printer or equivalent    │
  2105.           │ you should use Laser Labels (from Avery and others)     │
  2106.           │ and NOT regular Copy Machine labels. Laser labels have  │
  2107.           │ a ½ inch space at the top and bottom of the sheet to    │
  2108.           │ allow for the HP margins. If you are using regular Copy │
  2109.           │ Machine labels (not recommended), try the Single Sheet  │
  2110.           │ options.                                                │
  2111.           │                                                         │
  2112.           │ Press a key...                                          │
  2113.           └─────────────────────────────────────────────────────────┘
  2114.  
  2115.   * Use Single Sheet Options: Print single sheet-style labels. You will be
  2116.     prompted for required information:
  2117.                        ┌─────────────────────────────┐
  2118.                        │ Number of labels per sheet? │
  2119.                        │  0                          │
  2120.                        │ Top Margin (lines)          │
  2121.                        │  0                          │
  2122.                        │ Pause between Sheets        │
  2123.                        │ N                           │
  2124.                        │ Eject each sheet            │
  2125.                        │ N                           │
  2126.                        └─────────────────────────────┘
  2127.  
  2128. ╒════════════════════════════╕
  2129. │PRINT - CREATE/PRINT REPORTS│
  2130. ╘════════════════════════════╛
  2131.  
  2132. This option is a self-contained report writer that allows you to create,save,
  2133. edit and print customized tabular reports; it's only limitation is it cannot
  2134. support memo fields. Subsets of data can be extracted and printed; laser
  2135. printing is supported, and reports can be directed to a disk file. If no
  2136. database file is open, you will recieve an error message and will be returned
  2137. back to CED's main menu:
  2138. ┌──────────────────────────────────────────────────────────────────────────────┐
  2139. │ ┌──[Report Writer]─────┐                                                     │
  2140. │ │                      │                                                     │
  2141. │ │ Load REPORT          │                                                     │
  2142. │ │ Create REPORT        │                                                     │
  2143. │ │ Save REPORT          │                                                     │
  2144. │ │ Edit Report          │                                                     │
  2145. │ │ Delete Reports       │                                                     │
  2146. │ │ Headers/Footers      │                                                     │
  2147. │ │ Filtering            │                                                     │
  2148. │ │ Grouping Order       │                                                     │
  2149. │ │ Other Options        │                                                     │
  2150. │ │                      │                                                     │
  2151. │ │ Print Report         │                                                     │
  2152. │ │                      │                                                     │
  2153. │ │ Report Status        │                                                     │
  2154. │ │ Quit                 │                                                     │
  2155. │ └──────────────────────┘                                                     │
  2156. │                                                                              │
  2157. │                                                                              │
  2158. │┌────────────────────────────────────────────────────────────────────────────┐│
  2159. ││                                                                            ││
  2160. ││REPORT :None                                         USING  SAMPLE.DBF      ││
  2161. │└────────────────────────────────────────────────────────────────────────────┘│
  2162. └──────────────────────────────────────────────────────────────────────────────┘
  2163.  
  2164. Options are explained in sequential order:
  2165.  
  2166.     * LOAD REPORT: Retrieve a previously defined report. If no reports are on
  2167.       file (any reports that you create are stored in a database file in the
  2168.       current logged directory), an error message will appear onscreen and you
  2169.       will be returned to the report writer main menu; else, you will have a
  2170.       scrollable picklist of reports that are on file. Highlight your choice
  2171.       and press the Enter key.
  2172.  
  2173.     * CREATE REPORT: Enter the title for your report. You are not limited to 8
  2174.       characters, so give a meaningful description:
  2175.                    ┌─────────────────────────────────────┐
  2176.                    │ Report title                        │
  2177.                    │ sample report using Reporter_______ │
  2178.                    └─────────────────────────────────────┘
  2179.       After entering the title you will be placed in Edit mode; the workspace
  2180.       will appear like this onscreen:
  2181.  
  2182. ┌-= Editing Report: sample report using Reporter=-───────────────────────────┐
  2183. │                                                                            │
  2184. │ [KEYS]         #  Column Contents   Column Title        Width Pict  Total  │
  2185. │                ─────────────────────────────────────────────────────────── │
  2186. │ <   >       1│                 │                   │     │     │       │
  2187. │ to move          │                 │                   │     │     │       │
  2188. │ ─────────────    │                 │                   │     │     │       │
  2189. │ <ENTER> to       │                 │                   │     │     │       │
  2190. │ change column    │                 │                   │     │     │       │
  2191. │ ─────────────    │                 │                   │     │     │       │
  2192. │ <INSERT> to      │                 │                   │     │     │       │
  2193. │ add a column     │                 │                   │     │     │       │
  2194. │ ─────────────    │                 │                   │     │     │       │
  2195. │ <DELETE> to      │                 │                   │     │     │       │
  2196. │ delete column    │                 │                   │     │     │       │
  2197. │ ─────────────    │                 │                   │     │     │       │
  2198. │ <F10> when       │                 │                   │     │     │       │
  2199. │ done             │                 │                   │     │     │       │
  2200. └────────────────────────────────────────────────────────────────────────────┘
  2201.  
  2202.       This module defines fields and define column titles appearing on the final
  2203.       output. Pressing the insert key will add a column to the report; you
  2204.       may use either a database field or pad the column with blank spaces;
  2205.                    the bottom of the screen will prompt you:
  2206. ┌──────────────────────────────────────────────────────────────────────────────┐
  2207. │    Pick Database Field for this column                                       │
  2208. │    Use Spaces (for filler)                                                   │
  2209. └──────────────────────────────────────────────────────────────────────────────┘
  2210.  
  2211.       Pressing the Enter key adds a field. A popup box appears onscreen listing
  2212.       available fields insertable in the report:
  2213.                             ┌Select Field───────┐
  2214.                             │ONE                │
  2215.                             │TWO                │
  2216.                             └───────────────────┘
  2217.  
  2218.       Pressing the Enter key on a highlighted field chooses the field for that
  2219.       column of the report and edit screen is updated with the field info:
  2220. ┌-= Editing Report: sample report using Reporter=-───────────────────────────┐
  2221. │                                                                            │
  2222. │ [KEYS]         #  Column Contents   Column Title        Width Pict  Total  │
  2223. │                ─────────────────────────────────────────────────────────── │
  2224. │ <   >       1│ONE              │ONE                │ 10  │     │  N    │
  2225. │ to move          │                 │                   │     │     │       │
  2226. │ ─────────────    │                 │                   │     │     │       │
  2227. │ <ENTER> to       │                 │                   │     │     │       │
  2228. │ change column    │                 │                   │     │     │       │
  2229. │ ─────────────    │                 │                   │     │     │       │
  2230. │ <INSERT> to      │                 │                   │     │     │       │
  2231. │ add a column     │                 │                   │     │     │       │
  2232. │ ─────────────    │                 │                   │     │     │       │
  2233. │ <DELETE> to      │                 │                   │     │     │       │
  2234. │ delete column    │                 │                   │     │     │       │
  2235. │ ─────────────    │                 │                   │     │     │       │
  2236. │ <F10> when       │                 │                   │     │     │       │
  2237. │ done             │                 │                   │     │     │       │
  2238. └────────────────────────────────────────────────────────────────────────────┘
  2239.  
  2240.       The column title automatically defaults to the field name; you are not
  2241.       restricted to keeping the status quo; by moving the highlight bar to
  2242.       the column title contents, you may edit the title and change the length
  2243.       of the field for when it prints out. Pressing the Delete key will delete
  2244.       the column entry that is highlighted (there is no way to retrieve it once
  2245.       you delete it, so be careful). You can insert fields in-between defined
  2246.       field entries in case you need to make changes. Pressing the F10 key
  2247.       saves the changes and return you back to the report writer main menu.
  2248.  
  2249.     * SAVE REPORT: A popup box will appear to verify the filename to save the
  2250.       completed report to (just in case you want to name it something else):
  2251.                    ┌─────────────────────────────────────┐
  2252.                    │ Report Title                        │
  2253.                    │ sample report using reporter        │
  2254.                    └─────────────────────────────────────┘
  2255.  
  2256.     * EDIT REPORT: Allows you to edit a previously saved report; a popup
  2257.       window will appear onscreen with all the saved reports; highlight
  2258.       your choice and you will be placed into the same screen that you saw
  2259.       when creating the report:
  2260.              ┌Stored Reports───────────────────────────────────┐
  2261.              │sample report using reporter                     │
  2262.              └─────────────────────────────────────────────────┘
  2263.  
  2264.     * DELETE REPORTS: Delete reports saved in the reports database by
  2265.       highlighting a report that you wish to purge. It will be permanently
  2266.       removed with no way to retrieve it, so be careful:
  2267.    ┌[Tag Records to Delete]──────────────────────────────────────────────┐
  2268.    │         SPACE = tag  C = clear  S = search  ESC = done          │
  2269.    │─────────────────────────────────────────────────────────────────────│
  2270.    │Tag           SF_DBF   SF_TITLE                                      │
  2271.    │─────────────────────────────────────────────────────────────────────│
  2272.    │   │          SAMPLE  │sample report using reporter                  │
  2273.    │   │                  │                                              │
  2274.    │   │                  │                                              │
  2275.    │   │                  │                                              │
  2276.    │   │                  │                                              │
  2277.    │   │                  │                                              │
  2278.    │   │                  │                                              │
  2279.    │   │                  │                                              │
  2280.    │   │                  │                                              │
  2281.    │   │                  │                                              │
  2282.    │   │                  │                                              │
  2283.    │─────────────────────────────────────────────────────────────────────│
  2284.    │                          0 records tagged                           │
  2285.    └─────────────────────────────────────────────────────────────────────┘
  2286.  
  2287.     * HEADERS/FOOTERS: If you have opened a report form to modify, or are in
  2288.       the midst of creating a report, you can define headers and footers that
  2289.       will appear on the output. You are prompted for the number of
  2290.       header/footer lines you desire, the contents of the header/footer, and
  2291.       how you wish them to appear on the output (centered, left or right
  2292.       justified, etc.):
  2293.                      ┌─────────────────────────────────┐
  2294.                      │ Number of Header lines (1-9)    │
  2295.                      │ 2                               │
  2296.                      │ Number of Footer lines (1-9)    │
  2297.                      │ 0                               │
  2298.                      └─────────────────────────────────┘
  2299.  
  2300.  ┌[Headers and Footers]───────────────────────────────────────────────────┐
  2301.  │ Headers:                                                               │
  2302.  │ header 1                                                               │
  2303.  │ header 2                                                               │
  2304.  │ Footers:                                                               │
  2305.  │ footer 1                                                               │
  2306.  │ footer 2                                                               │
  2307.  │ Headers:   Leave as-is   Center   Left Justify   Right Justify         │
  2308.  │ Footers:   Leave as-is   Center   Left Justify   Right Justify         │
  2309.  └────────────────────────────────────────────────────────────────────────┘
  2310.  
  2311.     * FILTERING: You can print out every record in the database, or only a
  2312.       subset of the information. This can be a powerful method of extracting
  2313.       management data for "on-the-fly" reporting needs. You have already been
  2314.       introduced to this already in previous parts of the manual; the methods
  2315.       and screens are identical to those found in the Viewport and Formletter
  2316.       modules, so we will gloss lightly over these:
  2317.                         ┌──────────────────────────┐
  2318.                         │  No Filter               │
  2319.                         │  Tag Selected Records    │
  2320.                         │  Build New Query Filter  │
  2321.                         │                          │
  2322.                         └──────────────────────────┘
  2323.  
  2324.       The No Filter option means all records will be printed; Tag Selected
  2325.       Records has been seen before:
  2326.    ┌─────────────────────────────────────────────────────────────────────┐
  2327.    │         SPACE = tag  C = clear  S = search  ESC = done          │
  2328.    │─────────────────────────────────────────────────────────────────────│
  2329.    │Tag                        ONE        TWO                            │
  2330.    │─────────────────────────────────────────────────────────────────────│
  2331.    │   │                       scott     │scott                          │
  2332.    │   │                                 │                               │
  2333.    │   │                                 │                               │
  2334.    │   │                                 │                               │
  2335.    │   │                                 │                               │
  2336.    │   │                                 │                               │
  2337.    │   │                                 │                               │
  2338.    │   │                                 │                               │
  2339.    │   │                                 │                               │
  2340.    │   │                                 │                               │
  2341.    │   │                                 │                               │
  2342.    │   │                                 │                               │
  2343.    │─────────────────────────────────────────────────────────────────────│
  2344.    │                          0 records tagged                           │
  2345.    └─────────────────────────────────────────────────────────────────────┘
  2346.  
  2347.       Build New Query Filter: we've seen this a couple of times already:
  2348.                     ┌[Online Query Builder]────────────┐
  2349.                     │                                  │
  2350.                     │  Build a new Query               │
  2351.                     │  Add to current query            │
  2352.                     │  Count matching records          │
  2353.                     │  Zap (remove) existing Query     │
  2354.                     │  Save current Query to disk      │
  2355.                     │  Restore Query from disk         │
  2356.                     │  Delete stored queries           │
  2357.                     │  What is current Query           │
  2358.                     │  Edit current Query              │
  2359.                     │  View records matching Query     │
  2360.                     │  Quit To Reporter                │
  2361.                     │                                  │
  2362.                     │  No Query Active                 │
  2363.                     └──────────────────────────────────┘
  2364.  
  2365.     * GROUPING ORDER: This menu option is a little more complex to understand
  2366.       if you are unfamiliar with dBase; grouping is a means of producing
  2367.       output that will page eject based on information in an index file (an
  2368.       index must be opened before you can use this option, and it must be
  2369.       indexed on the field(s) that you wish to group on). A simple example of
  2370.       grouping would be: your client wants a report in City sequence that
  2371.       would print the name/address/amount owed fields. The report would be
  2372.       page broken by City; therefore, every time a new city is encountered in
  2373.       the database, a page break would occur to start the new city on a fresh
  2374.       page (even though you might not be at the end of the page). This is a
  2375.       good means of keeping large amounts of printed information in an
  2376.       orderly manner. You will first be prompted to choose an index that is
  2377.       open (you may have more than one index file open at one time):
  2378.                   ┌─[Select processing order]─────────────┐
  2379.                   │                                       │
  2380.                   │                                       │
  2381.                   │ Select an open index                  │
  2382.                   │ View current sort selection           │
  2383.                   │ Deactivate current order              │
  2384.                   │                                       │
  2385.                   │ Quit                                  │
  2386.                   │                                       │
  2387.                   │                                       │
  2388.                   └───────────────────────────────────────┘
  2389.  
  2390.       Select an open index will present a popup of all active indexes that
  2391.       you can choose from:
  2392.             ┌─[Select Index Key to Use]─────────────────────────┐
  2393.             │                       (ONE)                       │
  2394.             │                       (TWO)                       │
  2395.             │                       (THREE)                     │
  2396.             │                                                   │
  2397.             │                                                   │
  2398.             │                                                   │
  2399.             └───────────────────────────────────────────────────┘
  2400.  
  2401.       A popup will appear onscreen with some useful information:
  2402.    ┌─────────────────────────────────────────────────────────────────────┐
  2403.    │                                                                     │
  2404.    │                                                                     │
  2405.    │  You can now use GROUPS in your report.                             │
  2406.    │  A GROUP CHANGE is a point where a change takes place               │
  2407.    │  in one of the keys in an INDEXED database. Report SUBTOTALS        │
  2408.    │  will be printed at a GROUP change.                                 │
  2409.    │  This reportwriter supports a MAJOR group and a SECONDARY           │
  2410.    │  GROUP. You will now be asked to select GROUPS for this report      │
  2411.    │                                                                     │
  2412.    └──[Press a key ....]─────────────────────────────────────────────────┘
  2413.  
  2414.      You are given the option to choose your major grouping from the selected
  2415.      index file:
  2416.                    ┌─────────────────────────────────────┐
  2417.                    │Select Major Group from index key?   │
  2418.                    │              YES  NO                │
  2419.                    └─────────────────────────────────────┘
  2420.  
  2421.      We'll be adventurous and choose field 'ONE' for the major group:
  2422.              ┌Select MAJOR group───────────────────────────────┐
  2423.              │ONE                                              │
  2424.              └─────────────────────────────────────────────────┘
  2425.  
  2426.      If you needed to further break down the output, you could define a
  2427.      secondary group (like Last_Name)to provide another page break; you would
  2428.      repeat the above process of choosing a field that has been indexed on. An
  2429.      example of the result would be: the first page break would be set on City;
  2430.      a page break would also occur on the last name field (after you had set
  2431.      the secondary grouping).
  2432.  
  2433.     * VIEW CURRENT SORT SELECTION: Allows you to view the grouping setup:
  2434.                          ┌─────────────────────────┐
  2435.                          │ Database order is   :   │
  2436.                          │ (ONE)                   │
  2437.                          │ Major group is      :   │
  2438.                          │ ONE                     │
  2439.                          │ Secondary group is  :   │
  2440.                          │ None Selected           │
  2441.                          │ Press a key...          │
  2442.                          └─────────────────────────┘
  2443.  
  2444.     * OTHER OPTIONS: A popup screen appears to allow you to define printing
  2445.       parameters; once you have filled in the first screen, 2 more screens will
  2446.       appear of options for the final output:
  2447.        ┌─[Page Layout Options  1────────────────────────────────────┐
  2448.        │                                                            │
  2449.        │ Page Dimensions                                            │
  2450.        │ ----------------                                           │
  2451.        │ Page length.....................  66(lines per page)       │
  2452.        │ Page width......................  80(characters across)    │
  2453.        │ Top margin......................  0                        │
  2454.        │ Left Margin.....................  0                        │
  2455.        │                                                            │
  2456.        │ Group Headers and Totals                                   │
  2457.        │ ------------------------                                   │
  2458.        │ Text of Major group header...... Major Group :             │
  2459.        │ (enter NONE to suppress Major group header)                │
  2460.        │ Text of Minor group header...... Minor Group :             │
  2461.        │ (enter NONE to suppress Minor group header)                │
  2462.        │ Major underline character....... -  press F2 for options   │
  2463.        │ Minor underline character....... =  press F2 for options   │
  2464.        │ Underline totals................ N  (Y/N)                  │
  2465.        │                                                            │
  2466.        └────────────────────────────────────────────────────────────┘
  2467.  
  2468.        ┌─[Page Layout Options  2 ───────────────────────────────────┐
  2469.        │                                                            │
  2470.        │ Eject (new page) Options                                   │
  2471.        │ --------------------------                                 │
  2472.        │ Eject before report............. N  (Y/N)                  │
  2473.        │ Eject after report.............. Y  (Y/N)                  │
  2474.        │ Eject on Major change........... N  (Y/N)                  │
  2475.        │ Eject on Minor change........... N  (Y/N)                  │
  2476.        │ Eject before grand totals....... N  (Y/N)                  │
  2477.        │ Eject if # lines left........... 4  (after group change)   │
  2478.        │ Pause between pages ............ N  (Y/N)                  │
  2479.        │                                                            │
  2480.        │ Separator Characters                                       │
  2481.        │ ---------------------                                      │
  2482.        │ Number of title lines........... 1  (1 or 2)               │
  2483.        │ Detail line separator...........    press F2 for options   │
  2484.        │ # lines between detail lines.....0  (0 or 1)               │
  2485.        │ Column separator................ |  press F2 for options   │
  2486.        │ Column separator width.......... 1                         │
  2487.        │ Title/body/footer separator..... -  press F2 for options   │
  2488.        │                                                            │
  2489.        └────────────────────────────────────────────────────────────┘
  2490.        ┌─[Page Layout Options  3 ───────────────────────────────────┐
  2491.        │                                                            │
  2492.        │ Miscellaneous Options                                      │
  2493.        │ --------------------------                                 │
  2494.        │                                                            │
  2495.        │ Include standard 2-line header ? N                         │
  2496.        │ (page#, date, time)                                        │
  2497.        │                                                            │
  2498.        │ Full or summary report.......... F  (F/S)                  │
  2499.        │ Printer setup code..(decimal)...                           │
  2500.        │ Printer exit code..(decimal)...                            │
  2501.        │                                                            │
  2502.        │ PRINTER CODES NOTE:                                        │
  2503.        │ For printer codes, use either DECIMAL printer codes        │
  2504.        │ separated by commas, or type in the characters as they     │
  2505.        │ appear in your printer manual, using the @ charac-         │
  2506.        │ ter in place of ESCAPE. Example:                           │
  2507.        │ (using HP Laserjet codes to set the type to ITALIC)        │
  2508.        │    1.DECIMAL       27,40,115,49,83                         │
  2509.        │    1.CHARACTERS    @(s1S                                   │
  2510.        │                                                            │
  2511.        └────────────────────────────────────────────────────────────┘
  2512.  
  2513.     * PRINT REPORT: Print the report or save output to a disk file; the bottom
  2514.       of the screen will prompt you:
  2515. ┌──────────────────────────────────────────────────────────────────────────────┐
  2516. │                                                                              │
  2517. │    To:  Printer                                                              │
  2518. │         Disk File                                                            │
  2519. └──────────────────────────────────────────────────────────────────────────────┘
  2520.  
  2521.       If you choose 'Printer' the printer will default to LPT1 (standard
  2522.       configuration on 99% of all printers); the device will be checked if it
  2523.       is online and ready. If it is not, an error message will appear
  2524.       onscreen allowing you to change the printer port to either LPT1/LPT2/
  2525.       LPT3; retry or abort printing. If you chose 'Disk File', the bottom of
  2526.       the screen will prompt you for a filename+extension:
  2527. ┌──────────────────────────────────────────────────────────────────────────────┐
  2528. │                                                                              │
  2529. │    File name to print to                                                     │
  2530. │    MYREPORT.PRN____________________________________________________________  │
  2531. └──────────────────────────────────────────────────────────────────────────────┘
  2532.  
  2533.       While the file is printing, a popup window appears onscreen allowing you
  2534.       to view the output while printing. You can press Escape to abort printing,
  2535.       and the Space Bar to temporarily pause it. When printing has finished, the
  2536.       bottom of the screen will inform you to press a key to return to the
  2537.       report writer main menu again.
  2538.  
  2539.     * REPORT STATUS: Gives you a full screen 'snapshot' of the current
  2540.       loaded report's parameters that have been defined:
  2541. ┌──────────────────────────────────────────────────────────────────────────────┐
  2542. │ Report Title        sample report using reporter                             │
  2543. │ DBF Name            SAMPLE                                                   │
  2544. │ Index Key                                                                    │
  2545. │ Key of Major Group                                                           │
  2546. │ Key of Minor Group                                                           │
  2547. │ Major Group Text    Major Group :                                            │
  2548. │ Minor Group Text    Minor Group :                                            │
  2549. │ Last Used Query                                                              │
  2550. │ Before Print Code                                                            │
  2551. │ After Print Code                                                             │
  2552. ├──────────────────────────────────────────────────────────────────────────────┤
  2553. │ Page Width           80  Page Length      66                                 │
  2554. │ Left Margin           0  Top Margin        0        Line Spacing        0    │
  2555. │ # of Header Lines     2  # Footer Lines    2   Use standard header ?  N      │
  2556. │ Underline Totals ?  N   Major Underline  -          Minor Underline   =      │
  2557. │ Pause Between Pages N                                                        │
  2558. │ Full or Summary     F   # of Columns       1        # of title lines    1    │
  2559. │ Title Separator     -   Column Separator |       Width of Column Sep    1    │
  2560. │ Line Separator                                                               │
  2561. ├──────────────────────────────────────────────────────────────────────────────┤
  2562. │ Eject:Before Report N       After Report Y   If # line left on group  4      │
  2563. │       B4 Grand Ttls N    On Major change N            On Minor Change N      │
  2564. │                                                                              │
  2565. └──────────────────────────────────────────────────────────────────────────────┘
  2566.  
  2567.     * Quit: This option will ask you if you wish to save the currently loaded
  2568.       report before exiting as a precaution; if you choose yes and you are
  2569.       going to overwrite a report with the same name, you will be provided a
  2570.       popup box to make your appropriate choice:
  2571.        ┌────────────────────────────────────────────────────────────┐
  2572.        │Save Report:sample report using reporter before quitting?   │
  2573.        │                          YES  NO                           │
  2574.        └────────────────────────────────────────────────────────────┘
  2575.  
  2576.                        ┌─────────────────────────────┐
  2577.                        │Record Exists:               │
  2578.                        │ Don't Overwrite  Overwrite  │
  2579.                        └─────────────────────────────┘
  2580.  
  2581. ╒════════════════════════════════╕
  2582. │PRINT - View *.Mem File Contents│
  2583. ╘════════════════════════════════╛
  2584.  
  2585. This menu option lets you examine the contents of a dBase-type memory file
  2586. that has been saved onto the hard drive/floppy drive. This is primarily
  2587. useful for debugger purposes when you need to know if memory variables are
  2588. being updated and saved properly. If you try using a text editor or the
  2589. Ms-Dos Type command on this type of file you will see Ascii garbage onscreen;
  2590. a highly specialized method of opening this type of file for examination has
  2591. to be implemented in order for it to be understandable. You will get a
  2592. scrolling list of all files in the current directory to choose from:
  2593.                             ┌[Select: ]─────────┐
  2594.                             │   C5OVLMGR.OBJ    │
  2595.                             │   CLABELS.DBF     │
  2596.                             │   CLABELS.DBT     │
  2597.                             │   COLORS.DBF      │
  2598.                             │   DC.EXE          │
  2599.                             │   DC.LNK          │
  2600.                             │   DC.OBJ          │
  2601.                             │   DC.PRG          │
  2602.                             │   FORM.DBF        │
  2603.                             │   FORM.DBT        │
  2604.                             │   L               │
  2605.                             │   MYREPORT.PRN    │
  2606.                             │   OVLMGR.OBJ      │
  2607.                             │   READ.BAK        │
  2608.                             │   READ.ME         │
  2609.                             │   SAMPLE.DBF      │
  2610.                             │   SAMPLE.DBT      │
  2611.                             │   SAMPLE.LBL      │
  2612.                             │   SAMPLE.NTX      │
  2613.                             └───────────────────┘
  2614.  
  2615. If you choose a true memory file, you will see the following information
  2616. displayed onscreen (this example uses the Setup.Sys file used with CED to
  2617. store your system configuration):
  2618. ┌────────────────────────────────────────────────────────────────────────┐
  2619. │       MSETCOMP   TYPE C   "/A                                      "  │
  2620. │       MSETED     TYPE C   "me      "                                  │
  2621. │       MSETLIB    TYPE C   "SUPER30                                 "  │
  2622. │       MSETLIN    TYPE C   "/pll                                    "  │
  2623. │       MSETLINK   TYPE C   "BLINKER                       "            │
  2624. │       MSETLK     TYPE L   .T.                                          │
  2625. │       MSETLNK    TYPE C   "dc      "                                  │
  2626. │       MSETMAKE   TYPE C   "RMAKE   "                                  │
  2627. │       MSETOBJ    TYPE C   "ERRORSYS                                "  │
  2628. │       MSETT      TYPE L   .T.                                          │
  2629. │       Press Q to Quit, Return to continue.                             │
  2630. └────────────────────────────────────────────────────────────────────────┘
  2631.  
  2632. If the file was NOT a memory file, an error message will be displayed:
  2633.                ┌───────────────────────────────────────────────┐
  2634.                │ This is not a valid memory file. Press a key! │
  2635.                │                                               │
  2636.                │ Press a key...                                │
  2637.                └───────────────────────────────────────────────┘
  2638.  
  2639. ╒═══════════════════════════════╕
  2640. │UTILS - DATABASE FILE UTILITIES│
  2641. ╘═══════════════════════════════╛
  2642.  
  2643. Displays a popup menu of various database file utilities:
  2644.  
  2645. Append From    :  Import records from one *.Dbf to another.
  2646. Copy To New Dbf: Copy records from one *.Dbf to another.
  2647. Dbf Statistics : Perform math statistics on a *.Dbf.
  2648. Global Replace : Replace contents of a field throughout a *.Dbf.
  2649. Hunt Duplicates: Search and delete duplicate records.
  2650. Pack Database  : Pack a *.Dbf and *.Dbt file correctly.
  2651. Sconvdelim     : Convert a delimited file to a *.Dbf file.
  2652. Sexport        : Export *.Dbf to delimited or SDF format Ascii file.
  2653. Smailmerge     : Create mailmerge file for Ms-Word and Wordperfect.
  2654. Zap Database   : Delete all records in a *.Dbf.
  2655.  
  2656. ╒═════════════════════════════╕
  2657. │UTILS - DISPLAY INKEY/LASTKEY│
  2658. ╘═════════════════════════════╛
  2659.  
  2660. Allows you to retrieve the inkey/lastkey value for any keyboard character by
  2661. pressing a key and displaying it's values onscreen; to abort the process press
  2662. the Escape key twice:
  2663.                        ┌──┤[Inkey / Lastkey Value]├──┐
  2664.                        │                             │
  2665.                        │    Inkey Is: 102            │
  2666.                        │                             │
  2667.                        │  Lastkey Is: 102            │
  2668.                        │                             │
  2669.                        │  Press Any Key For Values   │
  2670.                        └─────────────────────────────┘
  2671.  
  2672. ╒═════════════════════════════╕
  2673. │UTILS - ASCII CHARACTER CHART│
  2674. ╘═════════════════════════════╛
  2675.  
  2676. Displays a handy ascii chart that displays both the actual character and it's
  2677. value onscreen:
  2678.       ┌───────────────────────────────────────────────────────────────┐
  2679.       │DEC CHR│DEC CHR│DEC CHR│DEC CHR│DEC CHR│DEC CHR│DEC CHR│DEC CHR│
  2680.       │--- ---│--- ---│--- ---│--- ---│--- ---│--- ---│--- ---│--- ---│
  2681.       │       │       │       │       │       │       │       │       │
  2682.       │  0 │ 16   │ 32    │ 48  0 │ 64  @ │ 80  P │ 96  ` │112  p │
  2683.       │  1   │ 17   │ 33  ! │ 49  1 │ 65  A │ 81  Q │ 97  a │113  q │
  2684.       │  2   │ 18   │ 34  " │ 50  2 │ 66  B │ 82  R │ 98  b │114  r │
  2685.       │  3   │ 19   │ 35  # │ 51  3 │ 67  C │ 83  S │ 99  c │115  s │
  2686.       │  4   │ 20   │ 36  $ │ 52  4 │ 68  D │ 84  T │100  d │116  t │
  2687.       │  5   │ 21   │ 37  % │ 53  5 │ 69  E │ 85  U │101  e │117  u │
  2688.       │  6   │ 22   │ 38  & │ 54  6 │ 70  F │ 86  V │102  f │118  v │
  2689.       │  7   │ 23   │ 39  ' │ 55  7 │ 71  G │ 87  W │103  g │119  w │
  2690.       │  8   │ 24   │ 40  ( │ 56  8 │ 72  H │ 88  X │104  h │120  x │
  2691.       │      PgUp PgDn Home End   ENTER=Select  ESC=ABORT         │
  2692.       └───────────────────────────────────────────────────────────────┘
  2693.  
  2694. ╒═══════════════════╕
  2695. │UTILS - DOS GATEWAY│
  2696. ╘═══════════════════╛
  2697.  
  2698. This option allows you to have access to a dos shell, and integrate
  2699. your own favorite utilities into a menu program that can be ran from within
  2700. the CED environment. A configurable menu appears onscreen:
  2701.     ┌──────────────────────────┤ Gateway Menu ├─────────────────────────┐
  2702.     │                                                                   │
  2703.     │ ┌──────────────────────────────┐ ┌──────────────────────────────┐ │
  2704.     │ │  A»                          │ │   F»                         │ │
  2705.     │ │                              │ │                              │ │
  2706.     │ │  B»                          │ │   G»                         │ │
  2707.     │ │                              │ │                              │ │
  2708.     │ │  C»                          │ │   I»                         │ │
  2709.     │ │                              │ │                              │ │
  2710.     │ │  E»                          │ │   J»                         │ │
  2711.     │ │                              │ │                              │ │
  2712.     │ │     Set Up         DOS       │ │      Quit           More     │ │
  2713.     │ └──────────────────────────────┘ └──────────────────────────────┘ │
  2714.     │ ┌───────────────────────────────────────────────────────────────┐ │
  2715.     │ │                                                               │ │
  2716.     │ └───────────────────────────────────────────────────────────────┘ │
  2717.     │                                                                   │
  2718.     └───────────────────────────────────────────────────────────────────┘
  2719.  
  2720. Pressing the Set Up key will allow you to configure the menu:
  2721.     ┌──────────────────────────┤ Gateway Menu ├─────────────────────────┐
  2722.     │                                                                   │
  2723.     │ ┌──────────────────────────────┐ ┌──────────────────────────────┐ │
  2724.     │ │  A»                          │ │   F»                         │ │
  2725.     │ │                              │ │                              │ │
  2726.     │ │  B»                          │ │   G»                         │ │
  2727.     │ │                              │ │                              │ │
  2728.     │ │  C»                          │ │   I»                         │ │
  2729.     │ │                              │ │                              │ │
  2730.     │ │  E»                          │ │   J»                         │ │
  2731.     │ │                              │ │                              │ │
  2732.     │ │     Set Up         DOS       │ │      Quit           More     │ │
  2733.     │ └──────────────────────────────┘ └──────────────────────────────┘ │
  2734.     │ ┌───────────────────────────────────────────────────────────────┐ │
  2735.     │ │                                                               │ │
  2736.    ┌─────────────────────────────────────────────────────────────────────┐
  2737.    │      Use the Up/Down arrow keys to select the menu item to          │
  2738.    │      change, then press the ENTER key.                              │
  2739.    │                                                                     │
  2740.    └─────────────────────────────────────────────────────────────────────┘
  2741.  
  2742. After highlighting the letter you wish to change/edit, you are prompted
  2743. for a title that will appear next to the letter:
  2744.     ┌──────────────────────────┤ Gateway Menu ├─────────────────────────┐
  2745.     │                                                                   │
  2746.     │ ┌──────────────────────────────┐ ┌──────────────────────────────┐ │
  2747.     │ │  A»Sample Utility Here       │ │   F»                         │ │
  2748.     │ │                              │ │                              │ │
  2749.     │ │  B»                          │ │   G»                         │ │
  2750.     │ │                              │ │                              │ │
  2751.     │ │  C»                          │ │   I»                         │ │
  2752.     │ │                              │ │                              │ │
  2753.     │ │  E»                          │ │   J»                         │ │
  2754.     │ │                              │ │                              │ │
  2755.     │ │     Set Up         DOS       │ │      Quit           More     │ │
  2756.     │ └──────────────────────────────┘ └──────────────────────────────┘ │
  2757.     │ ┌───────────────────────────────────────────────────────────────┐ │
  2758.     │ │                                                               │ │
  2759.    ┌─────────────────────────────────────────────────────────────────────┐
  2760.    │                                                                     │
  2761.    │  Enter the TITLE you want to appear in the menu for this item.      │
  2762.    │                                                                     │
  2763.    └─────────────────────────────────────────────────────────────────────┘
  2764.  
  2765. You are prompted for a description that will be displayed on the bottom of the
  2766. menu:
  2767.     ┌──────────────────────────┤ Gateway Menu ├─────────────────────────┐
  2768.     │                                                                   │
  2769.     │ ┌──────────────────────────────┐ ┌──────────────────────────────┐ │
  2770.     │ │  A»Sample Utility Here       │ │   F»                         │ │
  2771.     │ │                              │ │                              │ │
  2772.     │ │  B»                          │ │   G»                         │ │
  2773.     │ │                              │ │                              │ │
  2774.     │ │  C»                          │ │   I»                         │ │
  2775.     │ │                              │ │                              │ │
  2776.     │ │  E»                          │ │   J»                         │ │
  2777.     │ │                              │ │                              │ │
  2778.     │ │     Set Up         DOS       │ │      Quit           More     │ │
  2779.     │ └──────────────────────────────┘ └──────────────────────────────┘ │
  2780.     │ ┌───────────────────────────────────────────────────────────────┐ │
  2781.     │ │                                                               │ │
  2782.    ┌─────────────────────────────────────────────────────────────────────┐
  2783.    │  Enter the DESCRIPTION you want to appear in the bottom box         │
  2784.    │  of the display when you select this item.                          │
  2785.    │  Sample For The CED Documentation                                   │
  2786.    └─────────────────────────────────────────────────────────────────────┘
  2787.  
  2788. Enter the filename that will be executed :
  2789.     ┌──────────────────────────┤ Gateway Menu ├─────────────────────────┐
  2790.     │                                                                   │
  2791.     │ ┌──────────────────────────────┐ ┌──────────────────────────────┐ │
  2792.     │ │  A»Sample Utility Here       │ │   F»                         │ │
  2793.     │ │                              │ │                              │ │
  2794.     │ │  B»                          │ │   G»                         │ │
  2795.     │ │                              │ │                              │ │
  2796.     │ │  C»                          │ │   I»                         │ │
  2797.     │ │                              │ │                              │ │
  2798.     │ │  E»                          │ │   J»                         │ │
  2799.     │ │                              │ │                              │ │
  2800.     │ │     Set Up         DOS       │ │      Quit           More     │ │
  2801.     │ └──────────────────────────────┘ └──────────────────────────────┘ │
  2802.     │ ┌───────────────────────────────────────────────────────────────┐ │
  2803.     │ │                                                               │ │
  2804.    ┌─────────────────────────────────────────────────────────────────────┐
  2805.    │  Enter the COMMAND you want to run when you select this item.       │
  2806.    │  This is a program name.  Example: 123                              │
  2807.    │  sample                                                             │
  2808.    └─────────────────────────────────────────────────────────────────────┘
  2809.  
  2810. Tell CED how much memory to free up to run the program:
  2811.     ┌──────────────────────────┤ Gateway Menu ├─────────────────────────┐
  2812.     │                                                                   │
  2813.     │ ┌──────────────────────────────┐ ┌──────────────────────────────┐ │
  2814.     │ │  A»Sample Utility Here       │ │   F»                         │ │
  2815.     │ │                              │ │                              │ │
  2816.     │ │  B»                          │ │   G»                         │ │
  2817.     │ │                              │ │                              │ │
  2818.     │ │  C»                          │ │   I»                         │ │
  2819.     │ │                              │ │                              │ │
  2820.     │ │  E»                          │ │   J»                         │ │
  2821.     │ │                              │ │                              │ │
  2822.     │ │     Set Up         DOS       │ │      Quit           More     │ │
  2823.     │ └──────────────────────────────┘ └──────────────────────────────┘ │
  2824.     │ ┌───────────────────────────────────────────────────────────────┐ │
  2825.     │ │                                                               │ │
  2826.    ┌─────────────────────────────────────────────────────────────────────┐
  2827.    │  Enter the amount of MEMORY in Kbytes you need to run this          │
  2828.    │  program.  Enter 0 to use all available memory.                     │
  2829.    │    0                                                                │
  2830.    └─────────────────────────────────────────────────────────────────────┘
  2831.  
  2832. Enter the drive and directory that the program resides in:
  2833.     ┌──────────────────────────┤ Gateway Menu ├─────────────────────────┐
  2834.     │                                                                   │
  2835.     │ ┌──────────────────────────────┐ ┌──────────────────────────────┐ │
  2836.     │ │  A»Sample Utility Here       │ │   F»                         │ │
  2837.     │ │                              │ │                              │ │
  2838.     │ │  B»                          │ │   G»                         │ │
  2839.     │ │                              │ │                              │ │
  2840.     │ │  C»                          │ │   I»                         │ │
  2841.     │ │                              │ │                              │ │
  2842.     │ │  E»                          │ │   J»                         │ │
  2843.     │ │                              │ │                              │ │
  2844.     │ │     Set Up         DOS       │ │      Quit           More     │ │
  2845.     │ └──────────────────────────────┘ └──────────────────────────────┘ │
  2846.     │ ┌───────────────────────────────────────────────────────────────┐ │
  2847.     │ │                                                               │ │
  2848.    ┌─────────────────────────────────────────────────────────────────────┐
  2849.    │  Enter the DRIVE and DIRECTORY that the program resides in.         │
  2850.    │  Example: C:\LOTUS                                                  │
  2851.    │  c:\sample                                                          │
  2852.    └─────────────────────────────────────────────────────────────────────┘
  2853.  
  2854. This prompt allows you to determine where the temporary file created to swap
  2855. out CED and run your program will be located; if you have a ram drive set up
  2856. this would be the ideal use for it (at least 500k in size):
  2857.     ┌──────────────────────────┤ Gateway Menu ├─────────────────────────┐
  2858.     │                                                                   │
  2859.     │ ┌──────────────────────────────┐ ┌──────────────────────────────┐ │
  2860.     │ │  A»Sample Utility Here       │ │   F»                         │ │
  2861.     │ │                              │ │                              │ │
  2862.     │ │  B»                          │ │   G»                         │ │
  2863.     │ │                              │ │                              │ │
  2864.     │ │  C»                          │ │   I»                         │ │
  2865.     │ │                              │ │                              │ │
  2866.     │ │  E»                          │ │   J»                         │ │
  2867.     │ │                              │ │                              │ │
  2868.     │ │     Set Up         DOS       │ │      Quit           More     │ │
  2869.     │ └──────────────────────────────┘ └──────────────────────────────┘ │
  2870.     │ ┌───────────────────────────────────────────────────────────────┐ │
  2871.     │ │                                                               │ │
  2872.    ┌─────────────────────────────────────────────────────────────────────┐
  2873.    │  Enter the DRIVE number to create a temporary file for saving       │
  2874.    │  memory.  If left blank, file will go in current drive.             │
  2875.    │   :                                                                 │
  2876.    └─────────────────────────────────────────────────────────────────────┘
  2877.  
  2878. ╒════════════════════════╕
  2879. │UTILS - CHANGE DIRECTORY│
  2880. ╘════════════════════════╛
  2881.  
  2882. This option lets you change from the current directory to another by either
  2883. manually typing the directory in, or by using a picklist:
  2884.         ┌───────────────────────────────────────────────────────────┐
  2885.         │ Directory to change to : _____________________________    │
  2886.         │                                                           │
  2887.         │ (Enter for selection box  -   Escape to cancel request)   │
  2888.         └───────────────────────────────────────────────────────────┘
  2889.  
  2890. We chose to use the picklist (a much easier alternative):
  2891. ┌───────────────────────────────────────────────────────────────────────────┐
  2892. │             File                Size       Date     Time                  │
  2893. │───────────────────────────────────────────────────────────────────────────│
  2894. │             .             <DIR>            12/10/92 18:17:30              │
  2895. │             ..            <DIR>            12/10/92 18:17:30              │
  2896. │             SAVE.BAT                    60 01/04/93 21:46:04              │
  2897. │             DC.OBJ                   21170 01/15/93 19:41:42              │
  2898. │             DC.LNK                     204 01/02/93 14:00:00              │
  2899. │             DC.BIF                     688 01/15/93 19:42:04              │
  2900. │             MEM_FILE.ME               2475 01/11/93 21:57:16              │
  2901. │             REPORTER.ME              29289 01/11/93 21:48:00              │
  2902. │             READ.ME                 158430 01/15/93 20:02:54              │
  2903. │             SAFE.DOC                143833 01/11/93 21:58:00              │
  2904. │             SAMPLE.NTX                2048 01/11/93 21:26:46              │
  2905. │             COLORS.DBF                 569 01/06/93 22:41:48              │
  2906. │             DC.EXE                  804243 01/15/93 19:42:12              │
  2907. │             SETUP.SYS                  545 01/10/93 22:06:12              │
  2908. │             ASCII.BAK                20501 01/15/93 19:43:36              │
  2909. │───────────────────────────────────────────────────────────────────────────│
  2910. │                      DIRECTORY:\CLIPPER5\APPS\DCLIP\                      │
  2911. │ [Enter to select | F10 to accept | Escape to abort | Alt-V to view file]  │
  2912. └───────────────────────────────────────────────────────────────────────────┘
  2913.  
  2914. You are prompted if you want to change to the chosen directory (I had high-
  2915. lighted the DCLIP directory and pressed Enter):
  2916.                ┌────────────────────────────────────────────┐
  2917.                │Change directory to: \CLIPPER5\APPS\DCLIP   │
  2918.                │                  YES  NO                   │
  2919.                └────────────────────────────────────────────┘
  2920.  
  2921. ╒══════════════════════╕
  2922. │SETUP - DEFAULT LINKER│
  2923. ╘══════════════════════╛
  2924. Allows you to set up the linker that you will be using with CED:
  2925.                      ┌────────────────────────────────┐
  2926.                      │ Enter Desired Linker Name:     │
  2927.                      │ BLINKER                        │
  2928.                      └────────────────────────────────┘
  2929.  
  2930.         ┌[Linker Setup]─────────────────────────────────────────────┐
  2931.         │  Type The Drive+Path+Linker Name Above                    │
  2932.         │  EXAMPLE:   C:\Clipper5\Bin\Blinker                       │
  2933.         │                                                           │
  2934.         └───────────────────────────────────────────────────────────┘
  2935.  
  2936. If you do NOT set up a linker, you will not be able to link *.obj files from
  2937. within CED. The information is saved to Setup.Sys.
  2938.  
  2939. ╒════════════════════════════╕
  2940. │SETUP - DEFAULT MAKE UTILITY│
  2941. ╘════════════════════════════╛
  2942.  
  2943. Configure the make utility of your choice; if you do not set up a make utility,
  2944. you will not be able to execute the Make utility option from CED. The setup
  2945. information is saved to Setup.Sys.
  2946.             ┌──────────────────────────────────────────────────┐
  2947.             │ Enter Name Of The Make Utility You Plan On Using │
  2948.             │ RMAKE___________________________________________ │
  2949.             └──────────────────────────────────────────────────┘
  2950.  
  2951. ╒══════════════════════════╕
  2952. │SETUP - DEFAULT .OBJ FILES│
  2953. ╘══════════════════════════╛
  2954.  
  2955. Configure Ced to automatically link in *.Obj files with your linker (CED will
  2956. automatically determine if you have configured this or not, and use it
  2957. appropriately):
  2958.           ┌──────────────────────────────────────────────────────┐
  2959.           │ Enter Name Of Default .Obj Files That Will Be Linked │
  2960.           │ ERRORSYS____________________________________________ │
  2961.           └──────────────────────────────────────────────────────┘
  2962.  
  2963. Consult your linker manual for whether you need to seperate more than one
  2964. *.Obj file with a blank space or an addition sign (+). The information is
  2965. stored in Setup.Sys.
  2966.  
  2967. ╒══════════════════════════╕
  2968. │SETUP - DEFAULT .LIB FILES│
  2969. ╘══════════════════════════╛
  2970.  
  2971. Configure CED to automatically link in library files with your configured
  2972. linker; CED will link the libraries if so configured, or will bypass them
  2973. altogether. The information is stored to Setup.Sys. Consult your linker manual
  2974. for if you need to separate library names with either a blank space or an
  2975. addition sign (+):
  2976.           ┌──────────────────────────────────────────────────────┐
  2977.           │ Enter Name Of Default .Lib Files That Will Be Linked │
  2978.           │ SUPER30                                              │
  2979.           └──────────────────────────────────────────────────────┘
  2980.  
  2981. ╒═════════════════════════╕
  2982. │SETUP - COMPILER SWITCHES│
  2983. ╘═════════════════════════╛
  2984.  
  2985. Allows you to use one or more of the Clipper switches when compiling your
  2986. source code file(s). The information is saved to Setup.Sys. Separate each
  2987. switch with a blank space:
  2988.                 ┌──────────────────────────────────────────┐
  2989.                 │ Enter Default Clipper Compiler Switches  │
  2990.                 │ /A                                       │
  2991.                 └──────────────────────────────────────────┘
  2992.  
  2993. ╒══════════════════════╕
  2994. │SETUP - LINKER OPTIONS│
  2995. ╘══════════════════════╛
  2996.  
  2997. Configure your linker to use optional switches (if your linker supports them).
  2998. Information is stored in Setup.Sys:
  2999.                ┌─────────────────────────────────────────────┐
  3000.                │ Enter Default Linker Switches That Are Used │
  3001.                │ /pll                                        │
  3002.                └─────────────────────────────────────────────┘
  3003.  
  3004. ╒════════════════════════════╕
  3005. │SETUP - CHANGE SCREEN COLORS│
  3006. ╘════════════════════════════╛
  3007.  
  3008. Allows you to configure CED with personal screen colors to suit your
  3009. taste by either choosing pre-configured screen color setups, or manually
  3010. 'rolling your own'. A popup menu will appear for you to choose:
  3011.                  ┌─────────────────────────────────────────┐
  3012.                  │             CHOOSE METHOD               │
  3013.                  │ Predefined Colors  Define Custom Setup  │
  3014.                  └─────────────────────────────────────────┘
  3015.  
  3016. We'll explore Predefined Colors first. A popup picklist will appear for you
  3017. to pick a color palette. Highlight you rchoice, press Enter and see if it fits
  3018. your liking:
  3019.                             ┌Select color ─────┐
  3020.                             │ A-Establishment  │
  3021.                             │ B-Solace         │
  3022.                             │ C-Old Glory      │
  3023.                             │ D-Autumn         │
  3024.                             │ E-Three Alarm    │
  3025.                             │ F-Bruised        │
  3026.                             │ G-Northern Lights│
  3027.                             │ H-Twilight       │
  3028.                             │ I-Ole Yeller     │
  3029.                             │ J-Neon           │
  3030.                             │ K-Pleasant Valley│
  3031.                             │ L-HoHoHo         │
  3032.                             │ M-Ocean Hues     │
  3033.                             │ N-Green Thang    │
  3034.                             │ O-Real Red       │
  3035.                             └──────────────────┘
  3036.  
  3037. Now we'll explore the other route: Define Custom Setup. A workarea will
  3038. appear onscreen. You can modify the frame used on the boxes, shadow position
  3039. and color, if boxes will explode or not, colors for all type boxes, and save
  3040. the final configuration to a file for later retrieval:
  3041. ┌──────────────────────────────────────────────────────────────────────────────┐
  3042. │      Box Frame      Shadow Position      Explode      Colors      Quit       │
  3043. └──────┌────────────────────┐──────────────────────────────────────────────────┘
  3044.        │ 1.╔═╗ All Double   │
  3045.        │ 2.╒═╕ Top Double   │
  3046.        │ 3.╓─╖ Side Double  │
  3047.  ┌─────│ 4.┌─┐ All Single   │─────────────────────────────┐
  3048.  │     │ 5.    No Frame     │                             │
  3049.  │     └────────────────────┘                             │
  3050.  │                                                        │
  3051.  │       Normal Screen Unedited Field                     │
  3052.  │                                                        │
  3053.  │       Normal Screen Edited Field                       │
  3054.  │                                                        │
  3055.  │                                                        │
  3056.  │┌──[Popup Box]─────────────────────┐                    │
  3057.  ││                                  │                    │
  3058.  ││   Popup Screen Menu              │                    │
  3059.  ││                                  │                    │
  3060.  ││   Popup Screen Unedited Field    │                    │
  3061.  ││                                  │                    │
  3062.  ││   Popup Screen Edited Field      │                    │
  3063.  │└──────────────────────────────────┘                    │
  3064.  └────────────────────────────────────────────────────────┘
  3065.  
  3066. ╒═════════════════════╕
  3067. │SETUP EXTERNAL EDITOR│
  3068. ╘═════════════════════╛
  3069.  
  3070. Configure your own editor instead of the built-in editor supplied with CED.
  3071. The information is saved to Setup.Sys:
  3072.                      ┌─────────────────────────────────┐
  3073.                      │ Enter Default Editor To Be Used │
  3074.                      │ Me_____________________________ │
  3075.                      └─────────────────────────────────┘
  3076.  
  3077. ╒════════════════════════╕
  3078. │SETUP DEFAULT *.LNK FILE│
  3079. ╘════════════════════════╛
  3080.  
  3081. If you prefer to use a *.Lnk file with your linker, here's the option to do
  3082. it for you: type in the name of the file and it will be used when you link
  3083. the object file. Make sure that you don't forget to create the file (you can
  3084. use the built in editor for a quick create). The information is saved to
  3085. Setup.Sys:
  3086.        ┌────────────────────────────────────────────────────────────┐
  3087.        │ Enter Default *.Lnk File To Use With Your Linker  dc       │
  3088.        └────────────────────────────────────────────────────────────┘
  3089.  
  3090. ╒════════════════════╕
  3091. │FUTURE PLANS FOR CED│
  3092. ╘════════════════════╛
  3093.  
  3094. CED has been evolving for over two years in almost daily use on real world
  3095. projects in my workcenter. With that in mind, it will continue to grow in
  3096. power and features as the need arises. However, my needs are undeniably
  3097. different from yours; therefore, I need your inputs for what you would like
  3098. seen integrated into CED. With the advent of the Clipper 5.2 release (any day
  3099. now!), I foresee adding the RDD technology that is going to be implemented;
  3100. other possible additions might be relational browsing of database files, a
  3101. Clipper tutorial, a more powerful standard editor, and more. I am welcome to
  3102. your inputs, registered user or not. Write me direct, or leave a message on one
  3103. of the bulletin board numbers provided at the beginning (preferably on the CED
  3104. Support BBS) - I log onto it more often); I appreciate any comments you care to
  3105. leave.
  3106.  
  3107.                                HAPPY CLIPPING!!
  3108.