home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / database / ap11.zip / AP.DOC < prev    next >
Text File  |  1990-04-06  |  23KB  |  523 lines
  1.                                    WELCOME TO THE
  2.                               █████     ______   ██████
  3.                              ██   ██   /_____/|   ██  ██
  4.                              ██   ██     /_\  !   ██  ██
  5.                              ███████   @`@-@'@    █████
  6.                              ██   ██    (_=_)     ██
  7.                              ██   ██   ___V___    ██
  8.                              ██   ██ R M S       ████ L U S
  9.                     Academic Reference Management System Plus
  10.                       Version 1.1                  3/29/90
  11.                     Author and copyright (c) by Ping-Sing Kuo
  12.  
  13.            In honor of my home country--Taiwan, The Republic of China
  14.  
  15.            You are authorized to copy this program to your friends, in
  16.            case no charge and no change to it. To cover my cost, a $10
  17.            of contribution is welcome, but not required. I do hope you
  18.            drop me a postcard or E-mail to let me know the circulation
  19.            of this program, and your comments and suggestions are also
  20.            important feedbacks for the improvement of this program.
  21.  
  22.  
  23.            To contact me:
  24.  
  25.             Address:D-008, UCSD, La Jolla, CA 92093, U.S.A.
  26.             Bitnet:pkuo@ucsd.bitnet
  27.  
  28.            After 9/1/90:
  29.             Address:Inst. of Economics, Academia Sinica,
  30.                     Taipei, Taiwan, R.O.C.
  31.             Bitnet:wb6a1001@twnmoe10.bitnet
  32.  
  33. Table of Content
  34. ================
  35. What's AP?
  36. The history of AP.
  37. Who should use it ?
  38. What facilities do you need?
  39. How many files AP has?
  40. Do you need a manual for AP?
  41. How to start?
  42. How to stop?
  43. How to deal with password?
  44. How to create new data banks?
  45. How to switch to other data bank?
  46. How to input new record into data bank?
  47. How to keyin?
  48. What are standard names?
  49. How to setup standard names?
  50. How to Change standard names?
  51. What's the difference between retrieve and copy?
  52. How to retrieve?
  53. How to copy?
  54. What are the differences among main menu choices?
  55. How to choose records for action?
  56. How to choose records by search?
  57. How to choose record by Browse/Tag?
  58. What can you do to the chosen record?
  59. Actions that need not choose records first.
  60. What is about setup menu?
  61. How to change list format?
  62. Acknowledgments
  63. =====
  64.  
  65. ===========
  66. What's AP?
  67. -----------
  68.  
  69.    It's a data base program specific for papers. You can create, store, cross
  70. search, retrieve and send out formatted reference list to printer, screen or
  71. disk file for word processing.
  72.  
  73.    *you can change reference format easily befor you submit the paper to
  74.     journal. Even though the chance for it to be accepted is the same.
  75.    *you can ask librarian or RA to keyin the name of all relevant papers,
  76.     whenever you need to start a new project, you can find relevant reference
  77.     easily. The catch is that, you should pay more to your RA.
  78.    *you can check a paper whether you have or not quickly. That is, before
  79.     you spend your money to make zerox.
  80.    *you can put all papers in stack, AP can help you to access the paper you
  81.     need quickly. The chance for you to have cleaner desk top is larger.
  82.    *you can write down the abstract or reading notes in AP for future review,
  83.     never lost the card again. And never stop changing a more powerful glasses
  84.     again.
  85.    *etc.
  86.  
  87. The history of AP
  88. -----------------
  89.  
  90. It was started when I found that I had made a double zerox, the year was around
  91. 1984. It evolves a lot during these years, so is the name for it. In the
  92. beginning, its name was RMS, reference management system, as the program
  93. progress, the version came to a large number, something like ver. 10.2, a new
  94. name was a natural solution to it, it became to ARMS, academic reference
  95. management system. Well, as time pass, it grew again, new features changed the
  96. version number again, it's going on utill last year, a Plus was added to its
  97. name, so it's called ARMS Plus now, or AP in short.
  98.  
  99. Who should use it?
  100. -------------------
  101.  
  102.    If you are professor, graduate student, librarian, or any kind of researcher
  103. who need to read a lot of papers, but find that you can never keep track of
  104. them.
  105.  
  106. What facilities do you need?
  107. ----------------------------
  108.  
  109.    IBM PC with 512K RAM and DOS 3.xx. It is suggested that you had better have
  110. a hard disk, it's not required, but you will find floppy disk make the speed
  111. intolerable.
  112.  
  113. How many files AP has?
  114. ----------------------
  115.  
  116.    AP should come with six files:
  117. AP.EXE   main file.
  118. AP.DBF   sample file to put reference data.
  119. AP.DBT   sample file to put notes.
  120. AP.NTX   sample file to put sort key.
  121. AP.MEM   sample file to put standard names and other import variables.
  122. AP.DOC   this file.
  123.  
  124. Only AP.EXE is required, you can delete all other sample files, AP will create
  125. data bank file of your own.
  126.  
  127. Do you need a manual for AP?
  128. ----------------------------
  129.  
  130.    Not quite, since AP use pulldown menu, and every choice item has a short
  131. explanation, user can learn it soon after he goes over the program with the
  132. sample data bank. There do have some tricks and rules which I will mention
  133. them in the subsequent. Anyway, what you are looking is the only manual for
  134. it.
  135.  
  136. How to start?
  137. -------------
  138.  
  139.    Just type AP, it runs. In the first time, put all files in a directory,
  140. press RETURN key until you see the main menu.
  141.  
  142. How to stop?
  143. ------------
  144.  
  145.    Press ESC key until you leave AP.
  146.  
  147.    If you want to interrupt AP, ALT-C can do this, that is, keep ALT key down
  148. and press C key, AP will ask to continue, answer N or just press return will
  149. stop the job. It's abnormal to interrupt a program, you will take the risk of
  150. data loss, so it's not suggested.
  151.  
  152.  
  153. TIPS
  154. ====
  155. Before going on, let me explain some usage for keys:
  156.  
  157. To choose an item in pulldown menu or other choice menu, you can move cursor to
  158. the item and press return key, or press the first character of the item.
  159.  
  160. To type file name or data, if the keyin word is longer than given width, it
  161. will be entered automatically with the given width, if is less than the width,
  162. you must press enter to complete it. Press ESC can stop the current data entry
  163. and continue the job, but the data you type after last enter key will be lost.
  164.  
  165. Function key F1 is reserved for special usage, such as to popup choice menu.
  166. All other function keys can be defined in SETUP as a string, you can use them
  167. to save typing work.
  168. =====
  169.  
  170. How to deal with password?
  171. --------------------------
  172.  
  173.    The password for sample bank is none, just press ENTER key to pass it.
  174. When AP create new data bank, it will as you password for that bank, you can
  175. change it in setup menu.
  176.  
  177. How to create new data banks?
  178. -----------------------------
  179.  
  180.    When you are asked for reference bank, give a new name will create it
  181. automatically. Three chance to do it, in the beginning, in the copy menu and
  182. in the change base menu.
  183.  
  184. How to switch to other data bank?
  185. ---------------------------------
  186.  
  187.    In main menu, type G for Global, B for Base change, then AP prompt you to
  188. give the target bank name, either type in the target bank name, or press F1 to
  189. pop up data bank name menu for you to choose. To stop changing bank, choose the
  190. original bank name. If you give a new bank name, AP will create it for you.
  191.  
  192. How to input new record into data bank?
  193. ---------------------------------------
  194.  
  195.    There are four ways to input data, 1. keyin, 2. retrieve from other data
  196. bank, 3. copy to other data bank, 4. import from ascii files of which fields
  197. are delimited with " and seperated with ,.
  198.  
  199. How to keyin?
  200. -------------
  201.    Main menu has a 'Global', below it you can choose submenu 'Keyin'.
  202.  
  203.  
  204.  Rec#:601                       UP/DOWN keys to change fields      F1:Menu
  205. ┌────────┬────────────┬─────┬───────────┬──────┬─────────────┐     F2:201C/88S
  206. │Subject:│co-int      │Year:│           │Month:│             │     F3:Location
  207. │ Author:│                                                   │
  208. │  Title:│                                                   │
  209. │        │                                                   │
  210. │Journal:│UCSD    │Vol:     │No:    │pp:     -     │Mark:    │
  211. │Keyword:│                                                   │
  212. │        │                                                   │
  213. └────────┴───────────────────────────────────────────────────┘
  214. edit comment now?(Y or N) N                   ESC key to quit
  215. --------Comment--------
  216.  
  217. TIPS:
  218. =====
  219.    Subject is used to classify papers, F1 key show all standard subjects
  220. for you to choose, if you type in new subject, it will add into stardard
  221. subjects.  You can change them in setup.
  222.  
  223.    Data won't be changed before return key is pressed. ESC key can skip
  224. the fields after cursor.
  225. =====
  226.  
  227. What are standard names?
  228. ------------------------
  229.  
  230.    Two kind of information are quite common for different papers, one is
  231. subject, which is the category of paper, such as micoreconomics, game theory,
  232. information economics, etc. The other is the journal name of which the paper
  233. in on, such as Econometrica, the American Economic Review. AP keep a short
  234. name and a long name for each subject and journal. You need only keyin short
  235. name, AP will automatically convert short name into full name while list out.
  236.  
  237. The advantages are:1. save keyin time and disk space, 2, AP can keep standard
  238. journal and subject, pop up choice menu for you to choose while in keyin data.
  239.  
  240. How to setup standard names?
  241. ----------------------------
  242.  
  243.    While in keyin, you need only enter short name for subject or jouranl,
  244. in the end of each record AP will check these two names to see whether they
  245. are new, if they are new, AP will prompt you to give the full name for them.
  246.    If you retrieve data from other bank, the standard name will transfer too.
  247.    If you copy data to other bank, the standard name won't be transfered, you
  248. need to use setup to build it,
  249.    In setup menu, you can set up standard name for journal or subject, two way
  250. to do it, Automatic and Manual. Automatic means AP will search data bank to
  251. find new names, but since only short name are saved in data bank, the long
  252. name is equal to short name, you need to change it manually. Manual means you
  253. will keyin the names yourself, you can also edit existing names, after entry
  254. you can decide whether to sort the name or not.
  255.  
  256. How to Change standard names?
  257. -----------------------------
  258.  
  259.    To revise or delete a standard name, choose journal or subject in setup
  260. menu, choose Manual and move cursor to the name you want to change, press
  261. RETURN key to start editing, or SPACE key to nullify the name, then sort the
  262. names will kill the null name.
  263.  
  264. What's the difference between retrieve and copy?
  265. ------------------------------------------------
  266.  
  267.    Retrieve  copy all records and standard names from other data bank to
  268. current using bank.
  269.  
  270.    Copy used for copy part of records in current using bank to a target
  271. data bank, but exclude the standard names. You must use lookup to choose
  272. the records for copy first.
  273.  
  274. How to retrieve?
  275. ----------------
  276.  
  277.    Retrieve is Global action, in main menu, press G for Global, R for Retrieve,
  278. then give the source data bank name, all records and the names of standard
  279. journals and subjects in source will be copied to current used data bank.
  280.  
  281. How to copy?
  282. ------------
  283.  
  284.    Use Lookup menu to choose the records you want to copy, then use right
  285. cursor to move to Action menu to press C for copy.
  286.  
  287.  
  288. What are the differences among main menu choices?
  289. -------------------------------------------------
  290.  
  291.    'Global' means global action that you need not search record first,
  292.    'Actions' means you can act over the records you searched through
  293. 'Lookup', so you must choose records in lookup menu for actions.
  294.  
  295.  
  296. How to choose records for action?
  297. ---------------------------------
  298.  
  299.    You can use search or browse/tag to choose records.  Following is
  300.                                lookup menu, Terms and Go! are used
  301.         Lookup                 for search, Browse/Tag is used for
  302. Search for references          browse and tag.
  303.         ╔══════════════╗
  304.         ║Terms         ║       Range is used for limit the working range,
  305.         ║Range         ║       if data bank is too big, to limit the range
  306.         ║Go!           ║       can save time.
  307.         ║Piles OFF     ║
  308.         ║Sort Key OFF  ║       Piles Off means each GO! will clear the previous
  309.         ║Browse/Tag    ║       chosen records, and start new search.
  310.         ╚══════════════╝
  311.                                Sort Key Off means the chosen data is not sorted.
  312.  
  313.  
  314. Piles and Sorts are toggles, to press P will switch Piles On, press again
  315. will return to Piles Off, so is for the Sort.
  316.  
  317. How to choose records by search?
  318. --------------------------------
  319.  
  320.    In lookup menu, set search terms first, then GO! to begin searching, the
  321. records fulfill the terms will be chosen.
  322.  
  323.    To set search terms, you are given the terms menu as follow,
  324.  
  325.  
  326.           UP/DOWN keys to change fields, F1 to choice menu, ESC to quit
  327.                   ▐▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▌
  328.                   ▐ Search Keys for Reference Base: KUO       ▌
  329.                   ▐▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▌
  330.                   ▐        Search    Type (And/Or): A         ▌
  331.                   ▐▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▌
  332.                   ▐       Subject       │   Year    │  Mark   ▌
  333.                   ▐─────────────────────┼───────────┼─────────▌
  334.                   ▐                     │           │         ▌
  335.                   ▐─────────────────────┴─┬─────────┴─────────▌
  336.                   ▐         Author        │     Journal       ▌
  337.                   ▐───────────────────────┴───────────────────▌
  338.                   ▐                                           ▌
  339.                   ▐───────────────────────────────────────────▌
  340.                   ▐                  Title                    ▌
  341.                   ▐───────────────────────────────────────────▌
  342.                   ▐                                           ▌
  343.                   ▐───────────────────────────────────────────▌
  344.                   ▐                Key Words                  ▌
  345.                   ▐───────────────────────────────────────────▌
  346.                   ▐                                           ▌
  347.                   ▐▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▌
  348.  
  349.  
  350. Rules for search:
  351.  
  352.    If you don't give any terms, all records are chosen.
  353.    If you give more than one term, search type 'A' means all terms must be
  354. fulfilled for the record to be chosen, 'O' means the record is chosen if one
  355. of the terms is fulfilled.
  356.    A term is fulfilled if the given string is found in the record, AP doesn't
  357. need exact name, so if you give 'baysian' as the term for title, any record
  358. with 'baysian' in its title is fulfilled,
  359.    Upper or lower case doesn't matter, but sequence does, if you give author
  360. term 'Smith, Adam', the record with 'Adam, Smith' can't be fulfilled, so it's
  361. better only use one string for each terms.
  362.  
  363. How to choose record by Browse/Tag?
  364. -----------------------------------
  365.  
  366. Browse can see all records in data bank sequentially or by random access,
  367. tag means make a mark for the record you are looking at, which is chosen
  368. for later action.
  369.  
  370. Following is the browse menu, Rec# is the current record number, type in
  371. a new record number and press return key will jump to that new record.
  372. Right hand side is the keys used for sequential search, step means the
  373. interval between records.
  374. Press SPACE key to tag current record, a mark '√' will appear on Tag.
  375.  
  376. ┌────────┬────────────┬───────────────────────────────┬───┬──┐  KEY│FUNCTION
  377. │   Rec#:│123         │                               │Tag│  │ ────┼────────
  378. │Subject:│Game        │Year:│ 1987      │Month:│             │  ESC│quit
  379. │ Author:│Ramey, Garey                                       │ HOME│top
  380. │  Title:│Limit Pricing and Sequential Capacity Choice       │  END│bottom
  381. │        │                                                   │   UP│previous
  382. │Journal:│UCSD    │Vol:     │No:    │pp:     -     │Mark:    │ DOWN│next
  383. │Keyword:│                                                   │ PGUP│up 50
  384. │        │                                                   │ PGDN│down 50
  385. └────────┴───────────────────────────────────────────────────┘    +│2*step
  386. "--------Comment--------"                                         -│step/2
  387.                                                                 SPC│tag/untag
  388.  
  389.  
  390. What can you do to the chosen record?
  391. -------------------------------------
  392.  
  393.                     Actions              Left hand side is the actions menu.
  394. Actions for searched references
  395.                     ╔══════════════╗     Scan is a quick display for chosen
  396.                     ║Scan          ║     records.
  397.                     ║List          ║
  398.                     ║Copy          ║     List is used for formatted display
  399.                     ║Edit          ║     which can send to screen, printer,
  400.                     ║Delete        ║     or disk file for later use.
  401.                     ║Mark          ║
  402.                     ║Notes         ║     Copy can copy the chosen records to
  403.                     ║Export        ║     other data bank.
  404.                     ╚══════════════╝
  405.                                          Edit used for revise the chosen
  406.                                          records.
  407.  
  408. Delete to erase the records you chosen. There are two type of delete, one is
  409. to blank the record but keep it for later use, which can keep the record number
  410. intact, the other is to delete it from data bank, then all records follow it
  411. will change their record number. This difference is important, since I assign
  412. the record number to each of my paper as the serial number, save the papers
  413. physically in serial number, and to access the paper by lookup its serial
  414. number in AP.
  415.  
  416. Mark is used to classified papers that can't be classified by subject.
  417.  
  418. Notes is used to take notes, memorandum or abstract.
  419.  
  420. Export can save the records to an ascii file, each record is seperated by
  421. comma, every field is delimited by ". This kind of format can be read by
  422. many different programs.
  423.  
  424. Actions that need not choose records first.
  425. -------------------------------------------
  426.  
  427. Global menu give the actions that act over data bank, KEYIN for input new
  428. record, RETRIEVE for copy whole records from other data bank, IMPORT read
  429. ascii file with " delimited, Check Repeats is for check duplicate records,
  430. Base Change to change data bank in use.
  431.  
  432.                                 Global
  433. Some global functions
  434.                                 ╔══════════════╗
  435.                                 ║Keyin         ║
  436.                                 ║Retrieve      ║
  437.                                 ║Import        ║
  438.                                 ║Check Repeats ║
  439.                                 ║Base Change   ║
  440.                                 ╚══════════════╝
  441.  
  442.  
  443. What is about setup menu?
  444. -------------------------
  445.  
  446.                                             Setup
  447. Setup environments
  448.                                             ╔══════════════╗
  449.                                             ║List Setting  ║
  450.                                             ║Subjects      ║
  451.                                             ║Journals      ║
  452.                                             ║Function Keys ║
  453.                                             ║Password      ║
  454.                                             ║Output Device ║
  455.                                             ╚══════════════╝
  456.  
  457.  
  458. List Setting can do three things, decide whether to include record number
  459. in record listing, list by page or continuously, and choose the list format
  460. for different journals.
  461.  
  462. Subjects and Journals change the standard names, Function Keys define the
  463. strings for function keys F2 to F20.
  464.  
  465. Password change password for current database.
  466.  
  467. Output device turn on or off the display device: screen, printer or disk file,
  468. if turn on disk file, AP prompt for the disk file name.
  469.  
  470. How to change list format?
  471. --------------------------
  472.  
  473.    Setup, Listing setting, List format.
  474.  
  475.    Currently there are following predefined formats can be chosen, I plan to
  476. change it into user defined formats, but don't have time to do it now. Anyway,
  477. it's enough for most of the case, at most need some small adjustment in your
  478. word processing, you can live with it.
  479.  
  480.  
  481.     ╔═══════╦═════════════════════════════════════════════════════════╗
  482.     ║Options║               Reference Format Selection                ║
  483.     ╠═╦═════╬═════════════════════════════════════════════════════════╣
  484.     ║A║EMT  ║Riley,J.G.and W.F.Samuelson(1981): "Optimal Auction,"    ║
  485.     ║ ║     ║  American Economic Review, 71, 381-392.                 ║
  486.     ║B║JET  ║1. J.G.Riley and W.F.Samuelson, Optimal Auction, American║
  487.     ║ ║     ║      Economic Review 71 (1981), 381-392.                ║
  488.     ║C║REStu║RILEY, J. and SAMUELSON W.(1981), "Optimal Auction",     ║
  489.     ║ ║     ║    American Economic Review, 71, 381-393.               ║
  490.     ║D║RAND ║RILEY, J. AND SAMUELSON,W. "Optimal Auction," American   ║
  491.     ║ ║     ║   Economic Review, Vol.71,No.3 (June 1981),pp.381-393.  ║
  492.     ║E║JPolE║Riley,J. and W.Samuelson. "Optimal Auction."A.E.R.71(June║
  493.     ║ ║     ║  1981): 381-393.                                        ║
  494.     ║F║JPubE║Riley,J. and W.Samuelson. 1981, Optimal Auction, American║
  495.     ║ ║     ║   Economic Review 71, 381-393.                          ║
  496.     ║G║AER  ║J.Riley and W.Samuelson,"Optimal Auction," Amer. Econ.   ║
  497.     ║ ║     ║  Rev. June 1981, 71, 381-393.                           ║
  498.     ║H║JEL  ║RILEY,J AND W.SAMUELSON. "Optimal Auction," Amer. Econ.  ║
  499.     ║ ║     ║  Rev. June 1981, 71(3), pp. 381-393.                    ║
  500.     ║I║EI   ║Riley,J. and Samuelson,W., "Optimal Auction," American   ║
  501.     ║ ║     ║    Economic Review 71,June, 1981:381-393.               ║
  502.     ╠═╩═════╬════════════════════════════╦════════════════════════════╣
  503.     ║       ║ Format Option==> A         ║ Display Width==> 66        ║
  504.     ╚═══════╩════════════════════════════╩════════════════════════════╝
  505. =====
  506.  
  507. Acknowledgments
  508. ---------------
  509. Thanks to following friends to help the development of AP:
  510.  
  511. Tung Liu in UCSD
  512. Jinlung Lin in UCSD
  513. Weiguang Tsaur in NYU
  514.  
  515. Thanks to heaven for that:
  516. Lin Tsai (one of the student leaders in TAM square of Beijing) just escaped
  517. from mainland China after ten months of fugitive life.
  518.  
  519. =====
  520. Author and copyright (c) by Ping-Sing Kuo 4/6/1990
  521. ------------------
  522. That's all, folks.
  523.