home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / UT / UT095.ZIP / M2G101.EXE / MED2GO.DOC next >
Text File  |  1991-01-21  |  16KB  |  397 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                                Med2Go Documentation, page 1
  8.  
  9.  
  10.                                       Med2Go(TM)
  11.                           A Medline File Conversion Utility
  12.  
  13.  
  14.  
  15.  
  16.                          ####################################
  17.  
  18.                                         Med2Go
  19.                                      Version 1.01
  20.                            Copyright 1990 Louis M. Miranda
  21.                           6033 East Northwest Highway, #1106
  22.                                 Dallas, TX  75231-7463
  23.                                (CompuServe: 73567,471)
  24.                       Med2Go is a trademark of Louis M. Miranda
  25.  
  26.                Med2Go may be used for free, and may be distributed for
  27.           free, as long as all of the associated files are distributed
  28.           along with it. Med2Go is not public domain software; it is
  29.           copyrighted but currently offered for free.
  30.  
  31.                         #####################################
  32.  
  33.  
  34.                                     **************
  35.                                    What Is Med2Go?
  36.                                       **********
  37.                Med2Go is a file translation utility. It is useful for
  38.           clinicians and biomedical researchers who routinely use reference
  39.           citations in any of the following formats:
  40.  
  41.                MedLine (including PaperChase, Current Contents On Diskette
  42.                     MedLine/NLM [CCOD], and Grateful Med)
  43.                BRS/Colleague
  44.                PsycLit
  45.                ERIC
  46.                Comma-Delimited
  47.  
  48.                Most reasonable bibliographic database programs include the
  49.           ability to read and write MedLine-type files. However, there is a
  50.           plethora of output types that look a lot like MedLine, but are
  51.           quite distinct; these include BRS/Colleague, PsycLit, and ERIC
  52.           formats. In addition, generic database programs, such as dBase
  53.           III, Excel, and Paradox, can import comma-delimited (also called
  54.           `DIF') files.
  55.  
  56.                Because most bibliographic database management programs can
  57.           import MedLine, but not necessarily the other types, I created
  58.           Med2Go as a free utility. Med2Go will convert any of these
  59.           datafiles into a MedLine or comma-delimited file automatically.
  60.           The resultant output file can then be imported to most programs,
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.           page 2, Med2Go Documentation
  74.  
  75.           including JEPRS(TM), the Journal & Editorial Personal Reference
  76.           System, an inexpensive shareware program.
  77.  
  78.  
  79.  
  80.           >>>>>   How Much Does Med2Go Cost?   <<<<<
  81.                I am making Med2Go available free of charge, as long as all
  82.           associated files are distributed along with it. Please note that
  83.           even though it is free, it is nonetheless copyrighted by me, and
  84.           so cannot be legally distributed unless you follow the
  85.           requirements in this paragraph. I make no guarantee as to the
  86.           functionality of Med2Go. That is, if you find it useful, go ahead
  87.           and use it. If you don't find it useful, drop me line by US Mail
  88.           or CompuServe and tell me why-I'll see if I can implement your
  89.           suggestions.
  90.  
  91.                Why am I distributing Med2Go for free? For 2 reasons. The
  92.           first is that I find it ridiculous that programs with similar
  93.           functions cost large amounts of money when purchased with
  94.           commercial bibliographic database systems. This is an inexpensive
  95.           (actually, free!) alternative to commercial and shareware
  96.           programs.
  97.  
  98.                The second reason for distributing Med2Go at no charge is
  99.           somewhat selfish: I want you to try JEPRSTM, the Journal &
  100.           Editorial Personal Reference System. JEPRS (pronounced
  101.           ``Jeepers!'') is a shareware program that you can use to keep
  102.           track of a bibliographic database library. Chances are, if you
  103.           like Med2Go, you'll like JEPRS, too. That's because JEPRS shares
  104.           the same user-interface as Med2Go, including: Pull-down menus,
  105.           pop-up dialog boxes, mouse capability, on-line help, and pre-
  106.           defined defaults. (And both JEPRS and Med2Go will run in a DOS
  107.           window in Microsoft Windows 3.0 without using a special *.Pif
  108.           file, but they do not require Windows to run.)  Currently, JEPRS
  109.           is only $39.95 to register, which includes the latest version of
  110.           the software, 6 months of customer support, and a laser-printed,
  111.           ring-bound manual.
  112.  
  113.                ``So, what exactly is shareware?'', you ask. Shareware is
  114.           not any particular type of program; it is simply a method of
  115.           distributing software. It allows you to try the software before
  116.           you buy it. ``But isn't shareware buggy and virus-ridden?'' No!
  117.           Unfortunately, people sometimes come across a bad shareware
  118.           program or two, and generalize their experiences to all shareware
  119.           programs. But the truth of the matter is, shareware can be as
  120.           high (or higher) quality as commercially available software.
  121.           Shareware wins awards in the personal computer magazines. For
  122.           some examples of outstanding shareware programs, see the October
  123.           1990 issues of PC/Computing Magazine and PC World Magazine.
  124.  
  125.                ``So how can I tell a good shareware program from a bad
  126.           one?'' Good question! One very easy way to tell is to look for
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.                                                Med2Go Documentation, page 3
  140.  
  141.           the ASP logo. ASP stands for the Association of Shareware
  142.           Professionals, a group of shareware authors who have banded
  143.           together to promote the shareware concept. In order to be a
  144.           member of ASP, an author has to live up to professional standards
  145.           in the workings and customer support of his or her program.
  146.           JEPRS' author is proud to be a member of the ASP. For more
  147.           information on the ASP, and shareware in general, enter "GO
  148.           SHAREWARE" at any CompuServe ! prompt.
  149.  
  150.                ``OK, so now I'm excited about shareware in general, and
  151.           JEPRS in particular-so where can I get a copy of JEPRS to
  152.           evaluate?''  You can download JEPRS from CompuServe's IBMApp
  153.           forum (library 7) by searching for the file names by:
  154.           "Browse/key=JEPRS" or "Browse/key=Jeepers". (JEPRS is currently
  155.           in 3 files; however, newer versions will have different file
  156.           names, so it's safer to look for the files by Browsing.) If you
  157.           don't have access to CompuServe, you can get JEPRS from any
  158.           Vendor Member of the ASP, including:
  159.  
  160.                                Public Software Library
  161.                                     P.O. Box 35705
  162.                                Houston, TX  77235-5705
  163.                                     1-800-2424-PSL
  164.                               Request Disk #1782: JEPRS
  165.                      Price is $5 ($6 for 3.5" disk) + $4 postage
  166.  
  167.  
  168.                                 Public Brand Software
  169.                                     P.O. Box 51315
  170.                                Indianapolis, IN  46251
  171.                                     1-800-426-DISK
  172.                        Request Disk #CR5.0: MedLine/BRS Systems
  173.                                Price is $5 + $5 postage
  174.  
  175.  
  176.  
  177.                                     **************
  178.                                  How to Start Med2Go
  179.                                       **********
  180.                You `install' Med2Go simply by copying the Med2Go.Exe and
  181.           Med2Go.Hlp files to a single floppy disk or subdirectory on your
  182.           hard disk. In order for Med2Go to find the help file, it must be
  183.           in the current drive and directory when you enter Med2Go at the
  184.           DOS command line.
  185.  
  186.                Med2Go is started at the DOS command line by simply entering
  187.           Med2Go at the DOS prompt. Med2Go automatically defaults to
  188.           ``color'' mode. If you have a monochrome adaptor or are using a
  189.           laptop computer, you can start Med2Go in ``black and white'' mode
  190.           by using the `/a' command switch. That is, start the program by
  191.           entering Med2Go /a at the DOS command line.
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.           page 4, Med2Go Documentation
  206.  
  207.                You will first see Med2Go's opening screen, which contains
  208.           copyright and distribution information for the program. Press any
  209.           key (or the left mouse button) to go to the >Main Menu<.
  210.  
  211.                If you have a Microsoft-compatible mouse and a mouse driver
  212.           (Mouse.Com) installed, you can use a mouse with Med2Go. Move the
  213.           mouse pointer to the menu item to select, and then use the
  214.           buttons as follows:
  215.                              LEFT mouse button = [Enter]
  216.                               RIGHT mouse button = [Esc]
  217.                              BOTH mouse buttons = [Help]
  218.  
  219.                While you are at the >Main Menu<, or in one of the pull-down
  220.           menus, you can press [F1] to get context-sensitive help.
  221.  
  222.  
  223.  
  224.           >>>>>   Specifying Input and Output File Types   <<<<<
  225.                To select the file type that you wish to convert, press
  226.           [C]onversion type at the >Main Menu<. For the conversion, you
  227.           will have an input (source) file that you want to convert, and an
  228.           output (destination) file that will contain the converted
  229.           references.
  230.  
  231.                Now select [I]nput to tell Med2Go that you want to specify
  232.           the Input file type. A pop-up menu appears; just press the
  233.           boldfaced letter for the input file type you want to convert. For
  234.           example, if you want to convert a BRS/Colleague input file to a
  235.           MedLine output file, press `[B]' for BRS/Colleague. If you
  236.           specify Comma-delimited as input, Med2Go asks you 2 more
  237.           questions: What characters will separate the authors and what
  238.           characters will separate the keywords. For example, a comma-
  239.           delimited record may look like this:
  240.           "Miranda LM; Wright WE","Myogenesis and you","J Irrep
  241.           Res","1991","1","23","456-78","","","DNA; Myogenesis, vertebrate;
  242.           protein; myogenin; myo d; herculin"
  243.  
  244.           You'll notice that in the authors field, the authors are
  245.           separated by `; ' (a semi-colon and a space); likewise the
  246.           keywords are separated by `; '. If the authors looked like this:
  247.           "Miranda LM//Wright WE"
  248.  
  249.           then you would enter `//' as the characters separating the
  250.           authors.
  251.  
  252.                Now press [O]utput to tell Med2Go that you want to specify
  253.           the Output file type. You can choose either [M]edLine or [C]omma-
  254.           delimited output. Just like Input (above), if you choose [C]omma-
  255.           delimited, you'll have to enter the 2 characters you want to
  256.           separate the authors and the keywords.
  257.  
  258.                Now press [Esc] to return to the >Main Menu<.
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.                                                Med2Go Documentation, page 5
  272.  
  273.  
  274.  
  275.  
  276.           >>>>>   Specifying Input and Output File Names   <<<<<
  277.                While at the Main Menu, press [F]iles to select the Input
  278.           and Output file names. Then press [I]nput to select the Input
  279.           filename, and enter any valid DOS filename (including a path
  280.           (drive & directory) if necessary). You can use the left & right
  281.           arrow keys to move around the filename that you entered; you can
  282.           also use [Ctrl-RightArrow] and [Ctrl-LeftArrow] to move a word at
  283.           a time; pressing [Home] will put you at the beginning of the
  284.           line; pressing [End] will put you at the end of the line; and
  285.           pressing [Ctrl-End] will delete from the cursor position to the
  286.           right. You can also use the [Insert], [Delete], and [BackSpace]
  287.           keys as you can in any word processor. Press [Enter] when
  288.           finished entering the Input filename.
  289.  
  290.                Now press [O]utput to specify the Output filename, including
  291.           a path if necessary, and press [Enter] when finished.
  292.  
  293.                Press [Esc] to return to the >Main Menu<.
  294.  
  295.  
  296.  
  297.           >>>>>   Defaults   <<<<<
  298.                Press [D]efaults while at the >Main Menu< to go to the
  299.           >Defaults Menu<. You will see a pop-up menu of 3 choices: [B]eep
  300.           on/off; [C]olor mode; and [G]oToDOS.
  301.  
  302.                Beep on/off: Choose this option if you want to turn off the
  303.           beeping that Med2Go does if it encounters any errors.
  304.  
  305.                Color mode: Choose this option if you want to change between
  306.           [C]olor and [B]lack-and-White mode while within Med2Go (you can
  307.           also use a command line option; see How to Start Med2Go, above).
  308.  
  309.                Go To DOS: Choose this option to temporarily return to DOS
  310.           (to check on a filename, for example). You must remember to enter
  311.           ``EXIT'' and press [Enter] when you are through, to return to
  312.           Med2Go.
  313.  
  314.                Press [Esc] to return to the >Main Menu<.
  315.  
  316.  
  317.                                     **************
  318.                                Starting the Conversion
  319.                                       **********
  320.                Once you have specified the Input file type, the Output file
  321.           type, the Input filename, and the Output filename, just press
  322.           [G]o at the >Main Menu< to start the conversion process.
  323.  
  324.                If Med2Go encounters errors opening the files you have
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.           page 6, Med2Go Documentation
  338.  
  339.           specified, it will present you with a pop-up menu from which you
  340.           can choose what to do.
  341.  
  342.                If you specified Comma-delimited as Input (under Conversion
  343.           type, above), then Med2Go will ask ``Are the references separated
  344.           by one or more blank lines?'' If the references are each on one
  345.           line, and the next references are on the immediately adjacent
  346.           lines, then answer `[N]' (the default). If reference are
  347.           separated from each other by a completely blank line, then answer
  348.           `[Y]'.
  349.  
  350.                When Med2Go finishes converting your file, it displays a
  351.           message in the lower left corner of the screen, telling you how
  352.           many references (records) have been converted.
  353.  
  354.                Press any key to return to the >Main Menu<.
  355.  
  356.  
  357.                                     **************
  358.                                     Exiting Med2Go
  359.                                       **********
  360.                To exit Med2Go, return to the >Main Menu<, and then press
  361.           [E]xit or press the [Esc] key. A pop-up dialog box asks you if
  362.           you want to exit. Press `[Y]' (or point the mouse cursor to the
  363.           `y' and press the left mouse button) to exit, or any other key
  364.           (or the right mouse button) to return to the >Main Menu<. Your
  365.           screen colors will be returned to the same colors they were when
  366.           you started Med2Go.
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.