home *** CD-ROM | disk | FTP | other *** search
/ Adventures in Heaven 2 / adventuresinheaven2powergamesfordosandwindows.iso / dos / word / cck13 / cck.doc next >
Text File  |  1993-07-03  |  22KB  |  736 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                                                         The
  9.  
  10.                                                                   Crossword
  11.  
  12.                                                                Construction
  13.  
  14.                                                                         Kit
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                                                                 Version 1.3
  23.  
  24.                                                                   Shareware
  25.  
  26.                                                               Documentation
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.                                                          Copyright (C) 1993
  50.  
  51.                                                                  Kijin Jung
  52.  
  53.                                                         All Rights Reserved
  54.  
  55.  
  56.  
  57.      CCK 1.3                      page 2                    Version 1.3
  58.  
  59.  
  60.  
  61.  
  62.      The  Crossword  Construction  Kit  (CCK)  and  its  accompanying
  63.      documentation  is  provided AS IS without any  warranty  of  any
  64.      kind,  expressed  or  implied,  including  but  not  limited  to
  65.      warranties of merchantability, fitness for a particular purpose,
  66.      or functionality. In no event shall the author be liable for any
  67.      damages,  including  lost profits, lost  savings  or  any  other
  68.      incidental  or consequential damages arising out of the  use  or
  69.      the inability to use this program.
  70.  
  71.  
  72.      This program is copyrighted and may only be distributed with all
  73.      accompanying  files, without any modifications,  including  this
  74.      DOC file.
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.      Postscript  and Adobe Illustrator are registered  trademarks  of
  106.      Adobe Systems Incroporated.
  107.  
  108.      CorelDRAW! is a registered trademark of Corel Corporation.
  109.  
  110.      Microsoft is a registered trademark of Microsoft Corporation.
  111.  
  112.  
  113.  
  114.      CCK 1.3                         page 3                 Version 1.3
  115.  
  116.  
  117.                                 Table of Contents
  118.  
  119.  
  120.  
  121.  
  122.      Introduction                                        4
  123.      
  124.      What's New                                          5
  125.      
  126.      Benefits of Registration                            7
  127.      
  128.      Installation                                        8
  129.      
  130.      Convert                                             9
  131.      
  132.      Template Menu                                       10
  133.      
  134.      Game Menu                                           12
  135.      
  136.      Printing to Files                                   14
  137.      
  138.      Registration Form                                   16
  139.      
  140.      Future Versions                                     17
  141.      
  142.  
  143.  
  144.      CCK 1.3                         page 4                 Version 1.3
  145.  
  146.  
  147.                                         
  148.                                   Introduction
  149.  
  150.  
  151.  
  152.  
  153.      Welcome  to  The  Crossword Construction Kit, version  1.3!  CCK
  154.      allows  you  to create square, diagonally symmetrical  crossword
  155.      puzzles  -  the  kind  you  see in your local  newspaper.  After
  156.      constructing and filling in the grid, CCK gives you  the  option
  157.      of  saving  the  grid  and the solutions  as  EPS  files  for  a
  158.      professional appearance, or as ASCII representations for a fast,
  159.      convenient  way  to  view  your  puzzles.  Clues  can  be  saved
  160.      separately as text files, which you may format as you desire.
  161.  
  162.  
  163.      Reasons
  164.  
  165.      Well,  two  reasons. One, I like solving and creating  crossword
  166.      puzzles.  I  couldn't find a program which  would  allow  me  to
  167.      easily  create them. Two, I wanted to learn C. Yup, one  day,  I
  168.      was  overcome with an overpowering, uncontrollable urge to learn
  169.      C,  and  I thought to myself, as I was in the process of writing
  170.      my master's thesis, at about six o' clock on a Thursday evening,
  171.      hmmm,  I'll learn C! Then I made a ham sandwich for dinner.  And
  172.      thus, CCK was begat...
  173.  
  174.  
  175.      List of Files
  176.  
  177.      CCK13.ZIP:
  178.  
  179.      Filename        Description
  180.      =========================================================
  181.      
  182.      CCK.DOC         this file
  183.      CCK.EXE         the executable file
  184.      CCK.ICO         what the heck, everyone else is doing it
  185.      CCK.PIF         ditto
  186.      README.1ST      release notes
  187.      CCK1.*          sample template and game
  188.      CCK2.*          sample template and game
  189.      CONVERT.EXE     updates previous CCK files to version 1.3
  190.      FILES.LST       just this same list again
  191.      ORDER.FRM       order form
  192.      WHATSNEW.TXT    changes from version 1.2
  193.  
  194.  
  195.  
  196.      CCK 1.3                         page 5                 Version 1.3
  197.  
  198.  
  199.                                         
  200.                                    What's New
  201.  
  202.  
  203.  
  204.  
  205.         Changes in CCK 1.3 (July 4, 1993)
  206.  
  207.         - Changed the format of and greatly reduced the size of CCK
  208.           game files.
  209.         - Changed clue entry field from 54 spaces to 74 spaces.
  210.         - Changed minimum grid size to 9 for the registered version,
  211.           as requested by some users.
  212.         - Changed spacing in clue text such that all clues are
  213.           indented equivalently. This makes it easier to align tabs
  214.           when importing into a text-formatting program.
  215.         - Removed Microsoft mouse support due to numerous bugs
  216.           specifically caused by the int86 function (for example, CCK
  217.           would crash miserably in a DOS box under Windows).
  218.         - Fixed the 'no-clue' bug. The template now requires enough
  219.           space for at least one clue in each direction.
  220.         - Fixed Caps Lock bug.
  221.         - Added CONVERT.EXE utility to update previously created CCK
  222.           files to version 1.3.
  223.         - Added ASCII Draft option under the printing menu to allow
  224.           for a fast, convenient way to view puzzles.
  225.         - Added 'memory' to filename entry, which now recalls the
  226.           last typed filename.
  227.         - Added creation of *.bak files for CCK game files.
  228.         - Added arrow marker to indicate whether the word is longer
  229.           than word window.
  230.         - Added "Press Any Key" clarifications to error messages.
  231.         - Added yes/no prompt when quitting.
  232.         - Added miscellaneous changes in appearance.
  233.  
  234.  
  235.  
  236.         Changes in CCK 1.2 (June 20, 1993)
  237.  
  238.         - Added Microsoft mouse support.
  239.         - Added prolog to EPS files to make them printable to
  240.           PostScript printers.
  241.  
  242.  
  243.  
  244.      CCK 1.3                         page 6                 Version 1.3
  245.  
  246.  
  247.                              What's New (continued)
  248.  
  249.  
  250.  
  251.  
  252.         Changes in CCK 1.1 (June 12, 1993)
  253.  
  254.         - Removed the across and down numbers when printing the
  255.           grid solution to an EPS file.
  256.         - Added a context-sensitive color-coded help engine.
  257.         - Added a 15-space clue window when entering clues.
  258.         - Added arrow marker to indicate whether the clue is longer
  259.           than clue window.
  260.         - Changed the behavior of backspace while entering letters
  261.           on the grid (word entry). Backspace now erases letters.
  262.         - Fixed the behavior of backspace in the clue and filename
  263.           entry windows (backspace now erases the first letter).
  264.         - Fixed keyboard buffer when exiting.
  265.  
  266.  
  267.  
  268.         Changes in CCK 1.0 (June 5, 1993)
  269.  
  270.         - First public shareware release.
  271.  
  272.  
  273.  
  274.      CCK 1.3                         page 7                 Version 1.3
  275.  
  276.  
  277.                                         
  278.                             Benefits of Registration
  279.  
  280.  
  281.  
  282.  
  283.      Registering CCK will give you the ability to create from a small
  284.      9x9  grid  puzzle  up to a whopping 23x23 grid crossword  puzzle
  285.      (CCK  shareware  is  limited to a 15x15 grid ONLY).  Registering
  286.      also  eliminates  the  three second delay  at  the  introduction
  287.      screen. The two versions are otherwise identical.
  288.  
  289.  
  290.      If  you  have  the irresistible urge to register this  software,
  291.      send  $15 to me at the address listed in the order form  and  on
  292.      the   introduction   screen.  Purchasers  will   receive   their
  293.      registered  version of CCK by mail in your  choice  of  3.5"  or
  294.      5.25" low density disks. SHIPPING IS INCLUDED if you live in the
  295.      U.S.A.
  296.  
  297.  
  298.      If  you are already registered (from a previous version of  CCK)
  299.      in  the  registered  users database, you are  entitled  to  free
  300.      updates  (excluding $4.00 for shipping, handling, and  packaging
  301.      costs).  Send $4.00 for your choice of 3.5" or 5.25" low density
  302.      disks.
  303.  
  304.  
  305.  
  306.      CCK 1.3                         page 8                 Version 1.3
  307.  
  308.  
  309.                                         
  310.                                   Installation
  311.  
  312.  
  313.  
  314.  
  315.      If you're reading this, then you know how to unzip files.
  316.  
  317.  
  318.      Just  place all the files in any subdirectory. Since CCK.EXE  is
  319.      the  only file that is absolutely required to run CCK,  you  may
  320.      delete the optional sample files CCK1.* and CCK2.* if you  wish,
  321.      and make your own templates/games.
  322.  
  323.  
  324.      Then  type  CCK,  hit the ENTER key, and the intro  screen  will
  325.      appear. After three seconds, type the ANY key. That's right, the
  326.      ANY key.
  327.  
  328.  
  329.      Press F1 at any time after the introduction screen (except  when
  330.      loading  and saving files) to invoke the context sensitive  help
  331.      windows. Help screens are coded by color as well: white for menu
  332.      help,  red for template help, blue for word help, and green  for
  333.      clue help.
  334.  
  335.  
  336.  
  337.      CCK 1.3                         page 9                 Version 1.3
  338.  
  339.  
  340.                                         
  341.                                      Convert
  342.  
  343.  
  344.  
  345.  
  346.      The  CONVERT utility is provided for updating older *.CCK  files
  347.      (from versions 1.0 to 1.2). The format of the CCK game files has
  348.      changed  drastically; CCK version 1.3 is unable  to  read  older
  349.      *.CCK  files,  and vice versa. PLEASE MAKE SURE TO  CONVERT  ANY
  350.      EXISTING *.CCK FILES YOU MAY HAVE CREATED WITH OLDER VERSIONS OF
  351.      CCK.
  352.  
  353.  
  354.      The syntax of convert is as follows:
  355.  
  356.           convert file1 file2
  357.  
  358.      which reads in file1 and creates file2.
  359.  
  360.  
  361.      For  example,  "convert oldcck.cck newcck.cck" will  create  the
  362.      version 1.3 file newcck.cck, leaving oldcck.cck intact; "convert
  363.      oldcck.cck  oldcck.cck"  will  create  the  version   1.3   file
  364.      oldcck.cck, overwriting the older one.
  365.  
  366.  
  367.      The  new file format is a compressed version of the old one, and
  368.      as  such, there is a time penalty when saving files from  within
  369.      the  cck.exe program. However, the resulting files  can  have  a
  370.      reduction in size of up to 500% compared to the older format.
  371.  
  372.  
  373.  
  374.      CCK 1.3                         page 10                 Version 1.3
  375.  
  376.  
  377.                                         
  378.                                   Template Menu
  379.  
  380.  
  381.  
  382.  
  383.      First, a definition of the term "template". The template is  the
  384.      array  of  (white or black) boxes on which you will  enter  your
  385.      letters; think of it simply as an empty crossword grid -- except
  386.      that  you  get  to  fill  in the black  boxes.  Files  with  the
  387.      extension "CCT" are template files.
  388.  
  389.      The  first screen to greet you after the introduction screen  is
  390.      the template screen. An empty 15x15 grid will appear at left  in
  391.      the workspace, while at the bottom right is the Template Menu.
  392.  
  393.  
  394.      The menu choices are:
  395.  
  396.      Fill Squares
  397.      Load Template
  398.      Save Template
  399.      Game Menu
  400.      Quit
  401.  
  402.  
  403.      Fill Squares
  404.  
  405.      This  is where you construct your template. While the cursor  is
  406.      on the grid, hit the ENTER key to make a white box black, or hit
  407.      ENTER  again to make a black box white. The up, down,  left  and
  408.      right arrow keys move the cursor in the corresponding direction.
  409.      Notice  that  as  you fill (or empty) a box, the box  diagonally
  410.      symmetrical to the current one will also change. Hitting  Escape
  411.      takes you back to the Template Menu.
  412.  
  413.  
  414.      Load Template
  415.  
  416.      This  option  loads  a template which you  or  anyone  else  has
  417.      previously created (such as the ones included in this  package).
  418.      Hitting  Enter  will prompt you for an eight space  filename  to
  419.      which  the  extension CCT will be automagically appended.  Note:
  420.      the  shareware version does not load grids other than the  15x15
  421.      size, though it is still quite a respectable size.
  422.  
  423.  
  424.  
  425.      CCK 1.3                         page 11                Version 1.3
  426.  
  427.  
  428.                             Template Menu (continued)
  429.  
  430.  
  431.  
  432.  
  433.      Save Template
  434.  
  435.      Save  Template will prompt you for an eight space filename  with
  436.      the  extension  CCT. This option will save your new  or  altered
  437.      template  file, which you may use and reuse for building  future
  438.      crossword puzzles.
  439.  
  440.  
  441.      Game Menu
  442.  
  443.      This option takes you to the game menu (explained in full detail
  444.      in  the  following section). If there are too many black squares
  445.      so  as  to prevent the creation of any ACROSS or DOWN words,  an
  446.      error  message will be displayed stating "Invalid  Grid";  there
  447.      must  be  room for at least one ACROSS word and one  DOWN  word.
  448.      Remember, you cannot return to the template menu once you  enter
  449.      the  game  menu, so make sure you save your template masterpiece
  450.      before  you proceed (that is, if you want to reuse the  template
  451.      for future use).
  452.  
  453.  
  454.      Quit
  455.  
  456.      Prompts  you  to  end the program. Hit 'y' to exit  and  'n'  or
  457.      Escape to continue.
  458.  
  459.  
  460.  
  461.      CCK 1.3                         page 12                Version 1.3
  462.  
  463.  
  464.                                         
  465.                                     Game Menu
  466.  
  467.  
  468.  
  469.  
  470.      "Game"  is  somewhat of a misnomer, since you aren't  playing  a
  471.      game per se. The game screen is where you enter all the letters,
  472.      i.e.  solutions,  in  the grid, as well as all  the  clues  that
  473.      correspond to those letters. Files with the extension "CCK"  are
  474.      game  files,  and  include information concerning  the  template
  475.      (grid), the words (solution), and the clues.
  476.  
  477.  
  478.      The menu choices are:
  479.  
  480.      Enter Words
  481.      Enter Clues
  482.      Load Game
  483.      Save Game
  484.      Print to File
  485.      Quit
  486.  
  487.  
  488.      Enter Words
  489.  
  490.      Form  words  on the grid by entering your solutions,  letter  by
  491.      letter (as well as numbers). You can control the cursor with the
  492.      arrow  keys once you are on the grid, and as you type the words,
  493.      the  cursor  will automatically move to the right or  downwards.
  494.      Press the TAB key if you want to alternate between ACROSS cursor
  495.      movement  and  DOWN cursor movement. Spacebar  erases  a  single
  496.      letter while the cursor does not move, backspace erases a letter
  497.      as  the  cursor moves, and ESC takes you back to the  main  Game
  498.      Menu.
  499.  
  500.  
  501.      Enter Clues
  502.  
  503.      Enter the clues for each corresponding across or down word. Once
  504.      on the grid, the arrow keys will again move the cursor around on
  505.      the grid, except now the movement is limited to the first letter
  506.      of each ACROSS or DOWN word (you'll see what I mean). Again, hit
  507.      the  TAB  key to alternate between ACROSS clues and DOWN  clues.
  508.      Then type ENTER to enter your clue (up to 74 spaces) in the pop-
  509.      up  window.  74 spaces is certainly sufficient for normal  clues
  510.      (such  as  those  found in American crossword puzzles),  but  it
  511.      accomodates  the  lengthy,  cryptic  clues  common  in   British
  512.      crossword  puzzles as well. ESC takes you back to the main  Game
  513.      Menu.
  514.  
  515.  
  516.  
  517.      CCK 1.3                         page 13                Version 1.3
  518.  
  519.  
  520.                               Game Menu (continued)
  521.  
  522.  
  523.  
  524.  
  525.      Load Game
  526.  
  527.      This  option will prompt you for an eight space "game"  filename
  528.      with the extension CCK. It loads a game which you or anyone else
  529.      has  previously created, including the sample games included  in
  530.      this  package. Note: the shareware version does not  load  grids
  531.      other  than the 15x15 size. MAKE SURE TO UPDATE PREVIOUSLY SAVED
  532.      CCK  FILES  (versions  1.0  to 1.2)  WITH  "CONVERT.EXE"  BEFORE
  533.      LOADING CCK FILES WITH VERSION 1.3.
  534.  
  535.  
  536.      Save Game
  537.  
  538.      Save  Game will prompt you for an eight space filename with  the
  539.      extension  CCK.  This will save your new or altered  game  file,
  540.      which you may then recall at a later time to finish constructing
  541.      the  crossword puzzle, or send it electronically to your friends
  542.      and  be the life of the party. Note that saving the game in this
  543.      version  takes quite a bit longer than in previous versions,  as
  544.      the   file   is  internally  compressed.  This  results   in   a
  545.      significantly  smaller file size, with space savings  of  up  to
  546.      500%.
  547.  
  548.  
  549.      Print to File
  550.  
  551.      Takes you to the Print menu, explained in next section.
  552.  
  553.  
  554.      Quit
  555.  
  556.      Prompts  you  to  end the program. Hit 'y' to exit  and  'n'  or
  557.      Escape to continue.
  558.  
  559.  
  560.  
  561.      CCK 1.3                         page 14                Version 1.3
  562.  
  563.  
  564.                                         
  565.                                 Printing to Files
  566.  
  567.  
  568.  
  569.  
  570.      Again,  "print"  is somewhat of a misnomer, since  all  you  are
  571.      doing  is  printing to a file. I've found that drawing  programs
  572.      such as CorelDRAW!(TM) (tested with versions 2.0 and 3.0) import
  573.      the  resulting files very nicely and in fact, any program  which
  574.      imports Adobe Illustrator(TM) type EPS files will work. It  will
  575.      also print on PostScript(TM) printers and interpreters.
  576.  
  577.  
  578.      The menu choices are:
  579.  
  580.      Print Grid
  581.      Print Solution
  582.      Print Clues
  583.      ASCII Draft
  584.      Return
  585.  
  586.  
  587.      Print Grid
  588.  
  589.      Print Grid will prompt you for an eight space filename with  the
  590.      extension  EPS.  This option prints the grid  (template)  to  an
  591.      Encapsulated  Postscript file, which, when printed  to  a  laser
  592.      printer, looks professionally typeset.
  593.  
  594.  
  595.      Print Solution
  596.  
  597.      This  option  will again prompt you for an eight space  filename
  598.      with  the  extension EPS, except that it will print the solution
  599.      as  well  as  the  template. Think of this as  the  upside  down
  600.      "Answer   on  page  27"  solutions.  This  is  also   saved   as
  601.      Encapsulated  Postscript,  so you may  want  to  save  it  as  a
  602.      different name from the Grid EPS file (such as cck1sol.eps).
  603.  
  604.  
  605.  
  606.      CCK 1.3                         page 15                Version 1.3
  607.  
  608.  
  609.                                         
  610.                           Printing to Files (continued)
  611.  
  612.  
  613.  
  614.  
  615.      Print Clues
  616.  
  617.      The  clues are saved as an ordinary text file, as opposed to the
  618.      previous  two choices, which allows for easier text  and  format
  619.      manipulation. For example, you can import both the Template  EPS
  620.      file and the Clues text file and format them as you wish in  any
  621.      illustration or typesetting program.
  622.  
  623.  
  624.      ASCII Draft
  625.      
  626.      ASCII  Draft makes it possible to quickly inspect your crossword
  627.      puzzles, as it outputs to a text file (*.ASC). All three aspects
  628.      of  your  puzzle (the numbered grid, the clues, and the solution
  629.      grid) are output to this file.
  630.  
  631.  
  632.      Return
  633.  
  634.      Takes you back to the Game Menu.
  635.  
  636.  
  637.  
  638.      CCK 1.3                         page 16                Version 1.3
  639.  
  640.  
  641.                                         
  642.                                 Registration Form
  643.  
  644.  
  645.  
  646.  
  647.      Registration form for The Crossword Construction Kit 1.3.
  648.  
  649.  
  650.      Name: ________________________________________________________
  651.  
  652.  
  653.      Address: _____________________________________________________
  654.  
  655.  
  656.      City/State ____________________________________ Zip __________
  657.  
  658.  
  659.  
  660.      _____   CCK 1.3 on 5.25" DD disk                $15.00
  661.  
  662.      _____   CCK 1.3 on 3.5" DD disk                 $15.00
  663.  
  664.  
  665.  
  666.      If  you  have registered for a previous version of CCK, you  are
  667.      entitled  to  free  updates, excluding  shipping,  handling  and
  668.      packaging charges ($4.00 for either 5.25" or 3.5" DD disks).
  669.  
  670.  
  671.      _____   Shipping and handling for CCK 1.3       $ 4.00
  672.              as update on 5.25" DD disk
  673.  
  674.      _____   Shipping and handling for CCK 1.3       $ 4.00
  675.              as update on 3.5" DD disk
  676.  
  677.  
  678.  
  679.      Please remit by check or money order (U.S bank or branch) to:
  680.  
  681.      Kijin Jung
  682.      32633 Surrey Lane
  683.      Avon Lake, OH 44012
  684.  
  685.  
  686.      "Thank you for your support."
  687.      _______________________________________________________________
  688.  
  689.  
  690.  
  691.      CCK 1.3                         page 17                Version 1.3
  692.  
  693.  
  694.                                         
  695.                                  Future Versions
  696.  
  697.  
  698.  
  699.  
  700.      Hopefully, if I get enough response, I will be able to release a
  701.      significant upgrade to CCK, master's thesis willing.  There  are
  702.      many  features  yet to be added, such as the Crossword  _Player_
  703.      Kit  (solve  puzzles  created by CCK  on  screen),  asymmetrical
  704.      crossword puzzle support, a personal dictionary to which you can
  705.      save  your  favorite clues to words, a word search engine  which
  706.      can  find a word for you based on empty letter fields, _working_
  707.      mouse  support,  an actual DOS printer driver, and  perhaps  VGA
  708.      graphics mode (much) later on.
  709.  
  710.  
  711.      If  you have any suggestions, bug reports, or comments, you  can
  712.      write  me  at the address below, or if you're on the  net,  feel
  713.      free to e-mail me.
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.      Kijin Jung
  732.      32633 Surrey Lane
  733.      Avon Lake, OH 44012
  734.  
  735.      Internet: kxj6@po.cwru.edu
  736.