home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / misc / volume36 / formes / part01 / README < prev    next >
Encoding:
Text File  |  1993-04-01  |  8.1 KB  |  215 lines
  1.  
  2. Subject: FORMES 1.5 - French verb drill
  3. Environment: DOS, SUNOS, ULTRIX
  4. Archive-name: FORMES15
  5.  
  6.  
  7. BLURB
  8. -----
  9.  
  10. Formes 1.5 is simple French verb drill program.  It presents a student
  11. with a series of fill-in-the-blank phrases constructed by the program by
  12. expanding templates with verbs and subject pronouns selected at random.
  13. This random selection is weighted by previous performance--groups of
  14. similarly conjugated verbs and tenses that elicit incorrect responses
  15. are emphasized in subsequent questioning.  The pool of verbs, subject
  16. pronouns and phrase templates can be changed or extended (or abridged)
  17. by the user.
  18.  
  19. Version 1.5 contains 111 verbs grouped into 46 conjugation classes; 12
  20. subject pronouns; and seven phrase templates that offer the present
  21. indicative, future, compound past, imperfect indicative, conditional,
  22. present subjunctive and pluperfect tenses.  (The infinitive, imperative
  23. and past subjunctive tenses are also available to template writers.)
  24.  
  25.  
  26. COMPILING (source code distribution only)
  27. ---------  ------ ---- ------------ ----
  28.  
  29. The source comes with two makefiles: one called ``makefile'' that works
  30. on UNIX and with MicroSoft's new nmake, and a second one called ``dos''
  31. that I have used with with my old MSC3.0 make utility.  The DOS version
  32. invokes the system linker with a response file called ``formes.rsp''.
  33.  
  34. The program uses few features likely to be system-dependent.  I've seen
  35. it work compiled with an old K&R compiler with 16-bit pointers on an
  36. IBM PC and with Sun's ANSI-C compiler on a SPARC.  If you transfer the
  37. ``xobjects'' text file from DOS to UNIX be sure to remove the ASCII CR
  38. characters.
  39.  
  40.  
  41. CUSTOMIZING
  42. -----------
  43.  
  44. Many customizations can be made to Formes 1.5 by editing the ``xobjects''
  45. file.  Subject pronouns, verbs and phrase templates can be added, changed
  46. or deleted from the file to suit the student's individual requirements.
  47. In general, additions to the file are most easily made by duplicating and
  48. then modifying existing entries.  Unwanted entries can be removed outright
  49. or commented-out by prefixing them with a pound sign.
  50.  
  51. The following accent notation is used throughout the xobjects file:
  52.  
  53.     Accent        Combination
  54.     ----------    --------------------------
  55.     Acute         A, e, i or o followed by '
  56.     Cedilla       C followed by ,
  57.     Circumflex    A, e, i or o followed by ^
  58.     Grave         A, e, i or o followed by `
  59.     Umlaut        I followed by ~
  60.  
  61. Subject pronoun entries begin with ``SUBJECT:'' and take one line each.
  62. Next on the line is a three character group that indicates if the word
  63. or phrase represents the first, second or third person (1, 2 or 3); if
  64. it is singular or plural (S or P); and if it is masculine or feminine (M
  65. or F).  The remainder of the line contains the text of the subject word
  66. or phrase.  Here are some examples from the xobjects file:
  67.  
  68.     SUBJECT: 1SM je
  69.     SUBJECT: 2SM tu
  70.     SUBJECT: 2PM vous
  71.     SUBJECT: 3SF Annick
  72.     SUBJECT: 3PF elles
  73.  
  74. A simple change you might want to make to the subject entries would be to
  75. adjust the gender of ``je'' and ``Annick et moi'' to conform to your own.
  76. (And of ``tu'', ``vous'', if you want.)
  77.  
  78. Verb entries make up the bulk of the xobjects file.  Each one begins with
  79. ``VERB:'', followed by the infinitive form of the verb and a number that
  80. indicates its conjugation class.  (These numbers follow those used in the
  81. Larousse Dictionnaire Francais Anglais Saturn, 1981.)  Subsequent lines
  82. provide the stems and (for the present indicative, present subjunctive
  83. and imperative tenses) endings of the verb's forms.  Other lines provide
  84. the present and past participles and verb's auxiliary.  An example verb
  85. entry is:
  86.  
  87.     VERB: e^tre (48)
  88.     {
  89.     PRES-IND: - suis es est sommes e^tes sont 
  90.     PRES-SUB: so- is is it yons yez ient
  91.     IMPERATIVE: so- is yons yez
  92.     IMPERFECT: e't-
  93.     FUTURE: ser-
  94.     PRES-PART: e'tant
  95.     PAST-PART: e'te'
  96.     AUXILIARY: avoir
  97.     }
  98.  
  99. Note the use of an empty stem for the highly irregular present indicative
  100. tense of this verb.  Empty endings are not allowed so sometimes part of a
  101. stem is removed to each of its endings:
  102.  
  103.     IMPERATIVE: connai- s ssons ssez 
  104.  
  105. not
  106.  
  107.     IMPERATIVE: connais-  sons sez
  108.  
  109. IMPORTANT NOTE:  If you remove all of the verbs of a particular conjugation
  110. class from the xobjects file, either by commenting them out or by outright
  111. deletion, be sure there are no references to that conjugation class in your
  112. xscores file (as would happen if you had run FORMES to completion sometime
  113. before with the old, larger xobjects file).  One easy way to make sure of
  114. this is to simply delete the xscores file--a new one will be created the
  115. next time you run the program.
  116.  
  117. Finally, the xobjects file contains phrase (called quiz) templates.  These
  118. are small programs that control the generation of the phrases presented to
  119. the student.  Each one begins with ``QUIZ:'' followed by a title (used to
  120. introduce a set of phrases) and a scoring group number.  After this, lines
  121. that control the selection of subjects and verbs; the conjugation of verbs;
  122. and the construction of the actual quiz phrase follow.  One of the more
  123. complex phrase templates is:
  124.  
  125.     QUIZ: <Passe' compose'> (3)
  126.     {
  127.     PERSON p1 <random>
  128.     TEXT-OF Je p1
  129.     VERB aller aller
  130.     CONJUGATE Vais aller PRESENT p1
  131.     VERB boire <random>
  132.     CONJUGATE Boire boire INFINITIVE
  133.     PERSON p2 <random> p1
  134.     TEXT-OF Il p2
  135.     CONJUGATE A_bu boire PAST p2
  136.     QUIZ Je< >Vais< >Boire< mais >Il< >{A_bu}<.>
  137.     SCORE boire
  138.     }
  139.  
  140. Six kinds of control statments can appear in the body of a phrase template: 
  141. PERSON, TEXT-OF, VERB, CONJUGATE, QUIZ and SCORE.  Their order is not always
  142. the same but some statements depend on the results of others.  The syntax
  143. and behavior of these six statements are described below.  
  144.  
  145. 1.  PERSON result <random> [ exclusion ]
  146.  
  147.     This statement causes a subject pronoun to be selected at random.
  148.     An optional exclusion symbol--the result of a previous PERSON
  149.     statement--can be provided and removes that previous subject from
  150.     consideration.  
  151.  
  152. 2.  TEXT-OF result subject-symbol
  153.  
  154.     This looks up the display text associated with a subject pronoun
  155.     symbol.  The result is another symbol that can be used in a QUIZ
  156.     statment to follow.
  157.  
  158. 3.  VERB result { <random> | infinitive }
  159.  
  160.     This statement causes a verb to be selected either at random (but
  161.     weighted by previous performance) or by particular infinitive.
  162.  
  163. 4.  CONJUGATE result verb-symbol tense subject-symbol
  164.  
  165.     This statement conjugates a verb (the result of a previous VERB
  166.     statement) in the specified tense and in agreement with the
  167.     specified subject (the result of a previous PERSON statement).
  168.  
  169.     For ``tense'' substitute one of:  INFINITIVE, PRESENT, IMPERFECT,
  170.     FUTURE, CONDITIONAL, SUBJUNCTIVE, PAST, PLUPERFECT, PAST-SUBJUNCTIVE
  171.     or IMPERATIVE.  (I know, some of these are moods and not tenses.)
  172.  
  173.     The result is another symbol that can be used in a QUIZ statment
  174.     to follow.
  175.  
  176. 5.  QUIZ symbols-and-literals
  177.  
  178.     This statement builds a phrase and presents it to the student.
  179.     The string following ``QUIZ'' must contain only
  180.  
  181.     Literals--strings of characters surrounded by ``<'' and
  182.     ``>''--which will appear unchanged in the final phrase;
  183.  
  184.     Symbols that were the result of previous TEXT-OF and
  185.     CONJUGATE statements; and
  186.  
  187.     One pair of braces (``{'' and ``}'') to indicated that
  188.     part of the phrase that will be changed into the blank for
  189.     the student to fill in.
  190.  
  191. 6.  SCORE verb-symbol
  192.  
  193.     This causes the outcome of the last QUIZ statement (did the student
  194.     fill in the blank correctly on the first attempt) to be applied to
  195.     the specified verb's scoring record.
  196.  
  197. As with verbs, if you delete all of the QUIZ entries for a quiz scoring
  198. group (and currently there is only one entry per scoring group), you
  199. must delete that groups line from your xscores file (or delete the whole
  200. xscores file).
  201.  
  202. COPYING
  203. -------
  204.  
  205. Permission is granted to anyone to make or distribute copies of
  206. the program, in any medium, provided that the copyright notice
  207. and permission notice are preserved, and that the distributor
  208. grants the recipient permission for further redistribution as
  209. permitted by this notice.
  210.  
  211. Copyright (C) 1992-1993 Jeffrey Chilton
  212.  
  213. Author's E-mail address:  172-9221@mcimail.com
  214.  
  215.