home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / CPM / PROGRAMS / WSTAR / REFLIST.ARK / REFLIST.DOC < prev    next >
Text File  |  1985-08-31  |  8KB  |  166 lines
  1.                         *** REFLIST ***
  2.  
  3.      Welcome to REFLIST, a simple WordStar and MailMerge command file 
  4. to assist in the creation of a bibliography or reference list for 
  5. research work.  It is designed to follow the format required by the 
  6. American Psychological Association (3rd Edition).  However, it can 
  7. easily be modified to follow other formats.  
  8.  
  9.      The development of this command file was inspired by a chapter in 
  10. M. David Stone's book, "GETTING THE MOST FROM WORDSTAR AND MAILMERGE".  
  11. The file from that chapter was not what we wanted and did not apply to 
  12. the APA format so we altered it to match the APA format and work as we 
  13. prefered.  With that as a background, the following will explain how it 
  14. works and how to use it.
  15.  
  16. Program Design
  17.      REFLIST is a menu driven command file to be used through 
  18. MailMerge.  It is divided into several small command files that are 
  19. designed to help lay out reference list information from different 
  20. types of sources.  The menu file is named REFLIST and you run it 
  21. through MailMerge.  The various options from this menu each have a 
  22. small command file of their own.  Each of these files (when use is 
  23. complete) then recalls the menu file so the next reference can be 
  24. entered.
  25.  
  26. Directions for Use
  27.      After entering WordStar, the user should MailMerge the file named 
  28. REFLIST (the screen will look better if you turn off the file display).  
  29. At this point there are two choices: you can create a disk file (by 
  30. answering yes to the appropriate question) or you can create a hard 
  31. copy.  You should be aware that if you create a printed copy of the 
  32. input information, the APA format will not be strictly followed.  APA 
  33. calls for the second and following lines of each reference to be 
  34. indented 3 spaces.  If you create a printed copy at input, this will 
  35. not be done.  If you create a disk file first, you can then edit it to 
  36. follow the indented format.  We suggest the creation of a disk file so 
  37. that you will have a saved, retrievable, and editable file.
  38.  
  39.      Ideally, you should have all of your references sorted before you 
  40. begin.  If not, you will have to use the editing functions of WordStar 
  41. to sort your reference list file.  If you enter references at two 
  42. different work sessions, be careful not to overwrite a disk file.  You 
  43. will have to write two reference files and combine them for your final 
  44. reference list.  (May, 1985)
  45.  
  46.      REFLIST is copyright 1985 by Bill and Jim Rigel.  REFLIST may be 
  47. used freely, given away, or adapted, but may not be sold without 
  48. written permission from one of the authors.  If you update it, 
  49. change it, or adapt it to another format please let one of us 
  50. know or better still, send one of us a copy.
  51.  
  52. Bill Rigel                        Jim Rigel 
  53. 242 S. Lakeshore Drive            1636 Reed Road
  54. Lake Wales, FL 33853              West Trenton, NJ  08628
  55.  
  56. REFLIST, VERSION 1.1.  Edited by Gerald Grow.  August, 1985.
  57.  
  58.      REFLIST 1.1 contains the following files:
  59.          REFLIST, REFLIST.DOC, FORMAT.REF, 1, 2, 3, 4, 5, 6, 7, 8, R, X
  60.          Do not rename the single-character filenames unless you also
  61.          modify the menu in REFLIST to correspond.
  62.  
  63.      Being Associate Managing Editor of the Journal of Instructional 
  64. Development for 4 years made me more of an expert on the APA reference 
  65. list than I wanted to be.  I had hoped for years that someone would 
  66. write this program.  Thanks, Bill and Jim Rigel!  
  67.  
  68.      REFLIST will correctly enter the MOST common types of references.  
  69. Unfortunately, the APA format contains so many exceptions and artibrary 
  70. conventions (they take 16 pages to explain it) that some kinds of 
  71. references will come out strange.  
  72.      
  73.      This version does not, for example, distinguish between an 
  74. unpublished paper presented at a meeting (title underlined) and the 
  75. same paper presented at a symposium (title not underlined).  In a 
  76. similar case, a dissertation appearing in Abstracts should not have its 
  77. title underlined; an unpublished dissertation should.  (Sigh.)  Rules 
  78. like that create errors. 
  79.  
  80.      Even if you use REFLIST, be sure to proofread your reference list 
  81. carefully before submitting it.  
  82.  
  83. Version 1.1 of REFLIST has these changes:
  84.  
  85.      - several corrections to conform to APA requirements
  86.      - more extensive on-screen directions for writing references
  87.      - selection (8) for Technical Reports
  88.      - extra lines for long titles and multiple authors
  89.      - Justification set to ragged right (as APA requires)
  90.      - Error Check added at end of each entry
  91.      - automated method of formating reference list in WordStar
  92.  
  93.      In case you are interested, I made a study and critique of the 
  94. difficulties of the APA reference list, which appear in the COMMENT 
  95. section of the the American Psychologist near the end of 1985. The APA, 
  96. however, says they don't plan to change it for another 4 or 5 years.
  97.  
  98.      NOTES:
  99.  
  100.      FINAL FORMATTING.  To create APA style ("undented") references, 
  101. you must enter them with REFLIST, write them to a disk file, then 
  102. reformat the disk file into reference format.
  103.  
  104.      The references are all written to the disk file with three leading 
  105. blanks in the left margin, like this:
  106.  
  107.    Jones, J., Smith, K., & Hobbit, F. (1985). Technocratic assimilation 
  108.    of altruistic algorithms: An investigation of public domain 
  109.    programmers (5th ed.). Orlando, FL: Donkey Tail Press.
  110.  
  111. Following the simple directions in FORMAT.REF, you can quickly change 
  112. this into APA reference format by removing the leading blanks on the 
  113. first line of each reference, so the reference looks like this:
  114.  
  115. Jones, J., Smith, K., & Hobbit, F. (1985). Technocratic assimilation 
  116.    of altruistic algorithms: An investigation of public domain 
  117.    programmers (5th ed.). Orlando, FL: Donkey Tail Press.
  118.  
  119.      On rare occasions, the first line of the reference may look short, 
  120. but it should pass muster.
  121.  
  122.      UNWANTED SPACES.  Watch out for extra spaces in your reference 
  123. list, especially before periods and in the middle of two-line titles 
  124. and authors.  
  125.  
  126.      JOURNAL WITHOUT VOLUME NUMBER.  If you cite a journal without a 
  127. volume number, you will get an extra comma in the reference where the 
  128. volume would normally be, which you will have to remove when you format 
  129. the references.  Suggestion: If you cite, say, a Reader's Digest 
  130. article (which has no volume and number), use an error marker, such as 
  131. @@, in place of the volume number, so you can locate and remove that 
  132. comma.
  133.  
  134.      Where there is no Volume number, You will also need to add "p." or 
  135. "pp." before the page numbers.
  136.  
  137.      ARTICLE WITHOUT AUTHOR.  Enter title in author position.  There 
  138. wil be an extra period in the reference where it expected the title to 
  139. be.  Delete this at format time.
  140.  
  141.      CORPORATE AUTHOR.  You will have to ENTER A PERIOD at the end of 
  142. the name of a corporate author (such as "General Dynamics Corporation" 
  143. or "Harvard University"), because the program expects the period 
  144. normally found after the initials of an author's name.  Incidentally, 
  145. do not use abbreviations in the name of a corporate author.
  146.  
  147.      CUSTOMIZATION.  If you get tired of seeing the numerous on-screen 
  148. prompts, edit the mailmerge file using WordStar, locate the ".dm" 
  149. command on the line containing the offending prompt, and add another 
  150. dot to turn it into "..dm" which will cause that line not to appear on 
  151. the screen.
  152.  
  153.      After you are familiar with the APA style, you may want to replace 
  154. the longer directions with one or two short examples to serve as 
  155. models.
  156.      If you make corrections or updates, please send them to me on any 
  157. 5" format, CP/M or IBM (identify the disk format, please!)
  158.      IMPROVEMENTS NEEDED:  How would somebody like to write a program 
  159. to sort a variable-length, undented reference list in which the entries 
  160. are separated by two returns?  That way, we could use REFLIST to add 
  161. new entries, then realphabetize the list automatically. 
  162.  
  163.                               Gerald Grow
  164.                               P. O. Box 4282
  165.                               Tallahassee, FL 32303
  166.