home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d1xx / d191 / ispell.lha / ISpell / ispell.hlp.4 < prev    next >
Text File  |  1989-03-14  |  8KB  |  265 lines
  1.  
  2.  
  3.  
  4. ISPELL(4)         DOMAIN/IX Reference Manual ()         ISPELL(4)
  5.  
  6.  
  7.  
  8. NAME
  9.      ispell - format of ispell dictionaries
  10.  
  11. DESCRIPTION
  12.      Dictionaries for i_s_p_e_l_l_(1) come in two formats: raw, and
  13.      unhashed.  The hashed dictionary is generated by b_u_i_l_d_h_a_s_h_
  14.      (see i_s_p_e_l_l_(1)) from the raw dictionary, and is not
  15.      described here.
  16.  
  17.      A raw i_s_p_e_l_l_ dictionary (either the main dictionary or your
  18.      own personal dictionary) contains a list of words, one per
  19.      line.  Each word may optionally be followed by a slash ("/")
  20.      and one or more flags, which modify the root word as
  21.      explained below.  Case is significant in the root word, but
  22.      ignored in the flags.  The dictionary does not need to be
  23.      sorted.
  24.  
  25.      The case of the root word controls the case of words
  26.      accepted by i_s_p_e_l_l_, as follows:
  27.  
  28.      (1)  If the root word appears only in lower case (e.g.,
  29.           "bob"), it will be accepted in lower case, capitalized,
  30.           or all capitals.
  31.  
  32.      (2)  If the root word appears capitalized (e.g., "Robert"),
  33.           it will be not be accepted in all-lower case, but will
  34.           be accepted capitalized or all in capitals.
  35.  
  36.      (3)  If the root word appears all in capitals (e.g.,
  37.           "UNIX"), it will only be accepted all in capitals.
  38.  
  39.      (4)  If the root word appears with a "funny" capitalization
  40.           (e.g., "ITCorp"), a word will be accepted only if it
  41.           follows that capitalization, or if it appears all in
  42.           capitals.
  43.  
  44.      (5)  More than one capitalization of a root word may appear
  45.           in the dictionary.  Flags from different capitaliza-
  46.           tions are combined by OR-ing them together.
  47.  
  48.      Redundant capitalizations (e.g., "bob" and "Bob") will be
  49.      combined by b_u_i_l_d_h_a_s_h_ and by i_s_p_e_l_l_ (for personal dic-
  50.      tionaries), and can be removed from a raw dictionary by m_u_n_-_
  51.      c_h_l_i_s_t_.
  52.  
  53.      For example, the dictionary:
  54.  
  55.           bob
  56.           Robert
  57.           UNIX
  58.           ITcorp
  59.           ITCorp
  60.  
  61.  
  62.  
  63. Printed 7/7/87                                           ISPELL-1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ISPELL(4)         DOMAIN/IX Reference Manual ()         ISPELL(4)
  71.  
  72.  
  73.  
  74.      will accept "bob," "Bob," "BOB," "Robert," "ROBERT," "UNIX,"
  75.      "ITcorp," "ITCorp," and "ITCORP," and will reject all oth-
  76.      ers.  Some of the unacceptable forms are "bOb," "robert,"
  77.      "Unix," and "ItCorp."
  78.  
  79.      As mentioned above, root words in any dictionary may be
  80.      extended by flags.  Each flag is a single alphabetic charac-
  81.      ter, which represents a suffix that may be added to the root
  82.      to form a new word.  For example, the "D" flag can be added
  83.      to "bathe" to make "bathed".  Since flags are represented as
  84.      a single bit in the hashed dictionary, this results in sig-
  85.      nificant space savings.  The m_u_n_c_h_l_i_s_t_ script will reduce an
  86.      existing raw dictionary by adding flags when possible.
  87.  
  88.      When a word is extended with a suffix, the suffix will be
  89.      accepted only if it appears in the same case as the final
  90.      letter of the word.  Thus, for example, the entry "UNIX/M"
  91.      in the main dictionary ("M" means add an apostrophe and an
  92.      "s" to make a possessive) would accept "UNIX'S" but would
  93.      reject "UNIX's".  If "UNIX's" is legal, it must appear as a
  94.      separate dictionary entry, and it will not be combined by
  95.      m_u_n_c_h_l_i_s_t_.
  96.  
  97.      In the following discussion of the flags, let # and @ be
  98.      "variables" that can stand for any letter.  Upper case
  99.      letters are constants.  "..." stands for any string of zero
  100.      or more letters, but note that no word may exist in the dic-
  101.      tionary which is not at least 2 letters long, so, for exam-
  102.      ple, "fly" may not be produced by placing the "Y" flag on
  103.      "f".  Also, no flag is effective unless the word that it
  104.      creates is at least 4 letters long, so, for example, "wed"
  105.      may not be produced by placing the "D" flag on "we".
  106.  
  107.      The meaning of the flags is as follows:
  108.  
  109.      V
  110.           ...e --> ...ive  as in create --> creative
  111.           if # .ne. e, ...# --> ...#ive  as in prevent -->
  112.                preventive
  113.  
  114.      N
  115.           ...e --> ...ion  as in create --> creation
  116.           ...y --> ...ication  as in multiply --> multiplication
  117.           if # .ne. e or y, ...# --> ...#en  as in fall --> fal-
  118.                len
  119.  
  120.      X
  121.           ...e --> ...ions  as in create --> creations
  122.           ...y --> ...ications  as in multiply --> multiplica-
  123.                tions
  124.           if # .ne. e or y, ...# --> ...#ens  as in weak -->
  125.                weakens
  126.  
  127.  
  128.  
  129. ISPELL-2                                           Printed 7/7/87
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ISPELL(4)         DOMAIN/IX Reference Manual ()         ISPELL(4)
  137.  
  138.  
  139.  
  140.      H
  141.           ...y --> ...ieth  as in twenty --> twentieth
  142.           if # .ne. y, ...# --> ...#th  as in hundred --> hun-
  143.                dredth
  144.  
  145.      Y
  146.           ... --> ...ly  as in quick --> quickly
  147.  
  148.      G
  149.           ...e --> ...ing  as in file --> filing
  150.           if # .ne. e, ...# --> ...#ing  as in cross --> crossing
  151.  
  152.      J
  153.           ...e --> ...ings  as in file --> filings
  154.           if # .ne. e, ...# --> ...#ings  as in cross --> cross-
  155.                ings
  156.  
  157.      D
  158.           ...e --> ...ed  as in create --> created
  159.           if @ .ne. a, e, i, o, or u, ...@y --> ...@ied  as in
  160.                imply --> implied
  161.           if # .ne. e or y, or (# = y and @ = a, e, i, o, or u)
  162.                ...@# --> ...@#ed  as in cross --> crossed or con-
  163.                vey --> conveyed
  164.  
  165.      T
  166.           ...e --> ...est  as in late --> latest
  167.           if @ .ne. a, e, i, o, or u, ...@y --> ...@iest  as in
  168.                dirty --> dirtiest
  169.           if # .ne. e or y, or (# = y and @ = a, e, i, o, or u)
  170.                ...@# --> ...@#est  as in small --> smallest or
  171.                gray --> grayest
  172.  
  173.      R
  174.           ...e --> ...er  as in skate --> skater
  175.           if @ .ne. a, e, i, o, or u, ...@y --> ...@ier  as in
  176.                multiply --> multiplier
  177.           if # .ne. e or y, or (# = y and @ = a, e, i, o, or u)
  178.                ...@# --> ...@#er  as in build --> builder or con-
  179.                vey --> conveyer
  180.  
  181.      Z
  182.           ...e --> ...ers  as in skate --> skaters
  183.           if @ .ne. a, e, i, o, or u, ...@y --> ...@iers  as in
  184.                multiply --> multipliers
  185.           if # .ne. e or y, or (# = y and @ = a, e, i, o, or u)
  186.                ...@# --> ...@#ers  as in build --> builders or
  187.                slay --> slayers
  188.  
  189.      S
  190.           if @ .ne. a, e, i, o, or u, ...@y --> ...@ies  as in
  191.                imply --> implies
  192.  
  193.  
  194.  
  195. Printed 7/7/87                                           ISPELL-3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. ISPELL(4)         DOMAIN/IX Reference Manual ()         ISPELL(4)
  203.  
  204.  
  205.  
  206.           if # .eq. s, x, z, or h, ...# --> ...#es  as in fix -->
  207.                fixes
  208.           if # .ne. s, x, z, h, or y, or (# = y and @ = a, e, i,
  209.                o, or u) ...@# --> ...@#s  as in bat --> bats or
  210.                convey --> conveys
  211.  
  212.      P
  213.           if @ .ne. a, e, i, o, or u, ...@y --> ...@iness  as in
  214.                cloudy --> cloudiness
  215.           if # .ne. y, or @ = a, e, i, o, or u, ...@# -->
  216.                ...@#ness  as in late --> lateness or gray -->
  217.                grayness
  218.  
  219.      M
  220.           ... --> ...'s  as in dog --> dog's
  221.  
  222.      To summarize more briefly:
  223.  
  224.           V - ive
  225.           N - ion, tion, en
  226.           X - ions, ications, ens
  227.           H - th, ieth
  228.           Y - ly
  229.           G - ing
  230.           J - ings
  231.           D - ed
  232.           T - est
  233.           R - er
  234.           Z - ers
  235.           S - s, es, ies
  236.           P - ness, iness
  237.           M - 's
  238.  
  239. SEE ALSO
  240.      ispell(1)
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261. ISPELL-4                                           Printed 7/7/87
  262.  
  263.  
  264.  
  265.