home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / open / crosswd1.lzh / CWC360AD.DOC < prev    next >
Text File  |  1988-10-20  |  20KB  |  727 lines
  1.  
  2.  
  3.  
  4.  
  5.                            PC HELP-LINE's Professional
  6.  
  7.                                 CROSSWORD CREATOR
  8.  
  9.                                    Version 3.60
  10.  
  11.                                          
  12.  
  13.                        -----------------------------------
  14.  
  15.                        Addendum to the Version 3.30 manual
  16.  
  17.                        -----------------------------------
  18.  
  19.                                          
  20.  
  21.                                 TABLE OF CONTENTS
  22.  
  23.                   I. Distribution Disks ......................  1
  24.  
  25.                  II. The New LANGUAGE Files (*.CWL) ..........  2
  26.  
  27.                 III. HELP File Changes .......................  3
  28.  
  29.                  IV. Starting Crossword Creator ..............  4
  30.  
  31.                   V. New Printer Definition Keyword ..........  5
  32.  
  33.                  VI. CLUE File Format Changes ................  6
  34.  
  35.                 VII. Other Enhancements ......................  7
  36.  
  37.                
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.             I. Distribution Disks
  74.             
  75.             
  76.             Crossword Creator is now distributed on two 5.25", 360K
  77.             floppy disks or one 3.5", 720K micro-floppy disk.  In the
  78.             latter format, "Disk #1" and "Disk #2" are the same physical
  79.             disk.
  80.             
  81.                  Disk #1 - Crossword Creator program files
  82.                  -----------------------------------------
  83.                  
  84.                  . CWC.EXE      - the Crossword Creator program
  85.                  
  86.                  . CONFIG.CWC   - a sample configuration file
  87.                  
  88.                  . REGISTER.CWC - registration/upgrade instructions
  89.                  
  90.                  . README.CWC   - miscellaneous notes (please read!)
  91.                  
  92.                  . CWC330.DOC   - disk-based documentation
  93.                  
  94.                  . CWC360AD.DOC - addendum to the Version 3.30 manual
  95.                  
  96.                  . *.PUZ        - sample puzzle design files
  97.                  
  98.                  . *.CLU        - sample clue files; paired with *.PUZ
  99.                  
  100.                  . *.SOL        - sample puzzle solution files
  101.                  
  102.                  . ENGL.CWH     - English version help file
  103.                  
  104.                  . ENGL.CWL     - English version language file
  105.                  
  106.                  . IBMGRAPH.CWP - IBM Graphics printer definition file
  107.                  
  108.                  
  109.                  Disk #2 - Crossword Creator support files
  110.                  -----------------------------------------
  111.                  
  112.                  . CWINSTAL.EXE - the installation program
  113.                  
  114.                  . *.CWH        - HELP files
  115.                  
  116.                  . *.CWL        - LANGUAGE files
  117.                  
  118.                  . *.CWP        - printer definition files
  119.                  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                                           1
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.             II. The New LANGUAGE Files (*.CWL)
  140.             
  141.             Crossword Creator now supports foreign languages.  All the
  142.             on-screen text has been externalized into files that are
  143.             read when the program first starts.  LANGUAGE files have a
  144.             primary file name that identifies the particular language.
  145.             The extension name for a LANGUAGE file is ".CWL".
  146.             
  147.             The default language is "English", but you can instruct
  148.             Crossword Creator to load other language files if they are
  149.             available.  To specify a different language file, use the
  150.             command line switch, "/L=".  After the equal sign, supply
  151.             the primary part of the language file name; "SPAN", for
  152.             example (do not use the ".CWL" extension).  Crossword
  153.             Creator will read the corresponding language file when the
  154.             program starts.  After that, all the text you see on the
  155.             screen will be in that language.
  156.             
  157.             You CANNOT run the program without at least one language
  158.             file.  If you do not supply a language name with the "/L="
  159.             switch, the program will assume you want the English
  160.             language version (ENGL.CWL).
  161.             
  162.             The format for a language file is relatively complex and
  163.             modifications should probably only be attempted with the aid
  164.             and/or supervision of PCHL.  Technical support will NOT be
  165.             extended to problems related to language files that have not
  166.             been tested and approved by PCHL.
  167.             
  168.             If you have a need for a language that is not currently
  169.             supported, and are willing to provide the translation skills
  170.             necessary to do the job, contact PCHL for assistance in
  171.             getting started.  It is important that the language file
  172.             specifications be adhered to exactly, but they are easy to
  173.             follow and available for the asking.
  174.             
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                                           2
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.             III. HELP File Changes
  206.             
  207.             The naming conventions for HELP files have changed, since
  208.             now there must be a different HELP file for each supported
  209.             language.  HELP files now have the same primary file name as
  210.             their corresponding LANGUAGE files.  The extension name for
  211.             a HELP file is ".CWH".
  212.             
  213.             The HELP pointer codes in the file have been changed to:
  214.             
  215.                  100 - MAIN MENU
  216.                  200 - DESIGN PUZZLE
  217.                  300 - SOLVE PUZZLE
  218.                  400 - LOAD/SAVE PUZZLE
  219.                  500 - PRINT PUZZLE
  220.             
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.                                           3
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.             IV. Starting Crossword Creator
  272.             
  273.             To start CWC, type "CWC" at the DOS prompt and press ENTER.
  274.             CWC.EXE must be in the default directory unless you have a
  275.             PATH command that allows DOS to find it.  CONFIG.CWC and a
  276.             language file must also be in the default directory unless
  277.             you use the DOS environment variable to indicate a specific
  278.             directory (refer to "The "CWC=" DOS Environment Variable"
  279.             section in the manual for a detailed discussion).
  280.             
  281.             
  282.             CWC [design name] [solution name] [/L=language name]
  283.             
  284.             
  285.             examples:
  286.             
  287.             CWC sports mysol#1 (loads SPORTS.PUZ, MYSOL#1.SOL; English)
  288.             CWC cat            (loads only CAT.PUZ; English)
  289.             CWC demo /l=span   (loads DEMO.PUZ; Spanish)
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.                                           4
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.             V. New Printer Definition Keyword
  338.             
  339.             "MaxPrintCols=" is a new keyword that can be included in
  340.             printer definition files.  It is used to define the number
  341.             of characters that a particular printer can print on one
  342.             line.  This is not always a physical attribute of the
  343.             printer's carriage width since many printers have a
  344.             "condensed" print mode that allows more characters than the
  345.             "normal" print mode.
  346.             
  347.             When you print a puzzle, Crossword Creator calculates the
  348.             number of print columns that are required and compares that
  349.             to the number of available columns specified by
  350.             "MaxPrintCols=".  If the number required is less than the
  351.             number available, you are presented with three choices: 1)
  352.             cancel the print routine;  2) truncate the puzzle to fit and
  353.             continue printing;  3) disregard the warning and print the
  354.             puzzle anyway.
  355.             
  356.             Depending on your printer, trying to print a too-wide puzzle
  357.             will probably result in garbled output.  Most printers will
  358.             perform an automatic carriage-return if a print line is too
  359.             long, throwing off CWC's line spacing and "wrapping" the
  360.             extra characters to the next print line.
  361.             
  362.             If you get a "Puzzle is too wide..." warning and your
  363.             printer has a condensed-print mode, try using a different
  364.             printer definition file; Crossword Creator supplies both
  365.             "normal" and "condensed" drivers for all printers that
  366.             support condensed printing.
  367.             
  368.             MaxPrintCols=       This keyword specifies the maximum
  369.                                 number of characters that may be printed
  370.                                 on a single line.  A warning is given
  371.                                 before printing if a puzzle requires
  372.                                 more than this many columns.
  373.             
  374.                                 - OPTIONAL -
  375.             
  376.                                 Valid values are 1 to 145.
  377.             
  378.                                 example: MAXPRINTCOLS=/137
  379.             
  380.                                 default: 80
  381.             
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.                                           5
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.             VI. CLUE File Format Changes
  404.             
  405.             Crossword Creator puzzle clues may now be up to three lines
  406.             long, with each line containing up to 33 characters.  Each
  407.             clue is still defined by a single record in the CLUE file,
  408.             but a vertical bar is used to indicate a logical break where
  409.             the clue extends onto another line.
  410.             
  411.             
  412.             ex.  "DOG","cat's worst enemy or|man's best friend"
  413.             
  414.             
  415.             Also, imbedded quotes in the CLUE file are no longer stored
  416.             as UNDERSCORES; they are now stored as TILDES (~).  You may
  417.             have noticed in earlier versions of CWC that the UNDERSCORE
  418.             character could not be typed into a puzzle clue; it was a
  419.             reserved character that was used "behind the scenes" when
  420.             the CLUE file was loaded or saved.
  421.             
  422.             However, several professional puzzle designers commented
  423.             that the lack of the UNDERSCORE was limiting because this
  424.             character is often used when a common phrase is part of a
  425.             puzzle clue.
  426.             
  427.             
  428.             ex.  "RAIN","The ____ in Spain"
  429.             
  430.             
  431.             Since the TILDE character is used much less often, it has
  432.             now replaced the UNDERSCORE as the reserved character for
  433.             imbedded quotes.
  434.             
  435.             If you have existing puzzles that contain quotes in the CLUE
  436.             file, you need to do one of two things.  The first
  437.             alternative is to load your puzzle into CWC Version 3.60 and
  438.             edit each clue that contains quotes; they'll show up as
  439.             UNDERSCORES on the screen because CWC will not have
  440.             translated them as it did before.  When you save the puzzle,
  441.             everything will work fine.
  442.             
  443.             The second, easier alternative is to load your CLUE file
  444.             into a word processor and perform a global
  445.             search-and-replace, changing all UNDERSCORES to TILDES.
  446.             When you're done, remember to save the file in NON-DOCUMENT
  447.             mode to eliminate any formatting characters.  Your modified
  448.             CLUE file will now be translated correctly by CWC 3.60.
  449.             
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.                                           6
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.             VII. Other Enhancements
  470.             
  471.             1. New PRINT PUZZLE menu: PUZZLE DESIGN/CLUES, ANSWER SHEET,
  472.                DESIGN ONLY, CLUES ONLY
  473.             
  474.             2. New LOAD/SAVE menu: OPEN DESIGN, DESIGN SAVE,
  475.                LOAD SOLUTION, SAVE SOLUTION (these are cosmetic name
  476.                changes; the functions are no different from earlier
  477.                versions).
  478.             
  479.             3. Extended puzzle clues: Type up to four lines, 33
  480.                characters per line.
  481.             
  482.             4. Change printers without exiting the program: Each PRINT
  483.                function now prompts for a printer name; type in a new
  484.                one, or select from the available list.
  485.             
  486.             5. Additional edit capabilities in DESIGN PUZZLE: Tab and
  487.                BackTab keys move the cursor 6 times as fast as the ARROW
  488.                KEYS.  INSERT MODE and DELETE are now supported in the
  489.                puzzle area; entire rows (or columns, depending on the
  490.                typing direction) are pushed or pulled, just like a word
  491.                processor.  MINUS (-) erases all letters from the cursor
  492.                position to the end of the row (or column, depending on
  493.                the typing direction).
  494.             
  495.             6. New printer definition files for the Panasonic KXP-series
  496.                printers:
  497.             
  498.             
  499.                KXP1080 - These printers can emulate the IBM Graphics
  500.                KXPCOND   Printer, but they must be switched into that
  501.                          mode via software commands (already provided in
  502.                          the printer definition files) or by setting DIP
  503.                          switches inside.  All IBM-style printer
  504.                          commands are supported, as well as the full IBM
  505.                          character set.
  506.             
  507.                Additional drivers for the Epson LX-series printers were
  508.                added.
  509.             
  510.                Some of the printer definition files were renamed,
  511.                slightly, in order to achieve some consistent naming
  512.                conventions.  If you are upgrading from a previous
  513.                version, make sure you use the new driver.
  514.               
  515.                IMPORTANT: All printer definition files included with
  516.                           Crossword Creator Version 3.60 use the new
  517.                           keyword "MaxPrintCols=" (see section "V. New
  518.                           Printer Definition Keyword", above).  If you
  519.                           are upgrading from a previous version, make
  520.                           sure that you install the new drivers so you
  521.                           can take advantage of this feature.
  522.             
  523.  
  524.  
  525.  
  526.                                           7
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.             7. A picture of a clock is now displayed while Crossword
  536.                Creator reads in the language file; the unidentified
  537.                "marching dots" were dismaying to a number of people.
  538.             
  539.                This situation is a bit of a Catch-22 for me.  Since
  540.                reading the language file takes a little time, I want to
  541.                display an informative message to the user about what is
  542.                happening.  But I can't do this with words because the
  543.                program hasn't read the language file yet.  You see?  I
  544.                have to read the language file before I can use words to
  545.                tell you that I'm going to read the language file.
  546.             
  547.                That's why I chose to use the marching dots; at least it
  548.                was apparent that something was going on.  I added the
  549.                clock symbol because it is used more universally to
  550.                indicate that a function is executing and that the user
  551.                should wait patiently until it completes.
  552.             
  553.             8. "Available memory" indicators have been added to the
  554.                lower boundary of the WORK AREA window.  Two values are
  555.                displayed showing the number of bytes (characters) of
  556.                memory that are available for Crossword Creator to use.
  557.                The first indicator, "MEM=" shows the total amount of
  558.                memory available in the computer.  The second indicator,
  559.                "STR=", shows the amount of available "string space".
  560.             
  561.                The "total memory" value should be self-explanatory.  It
  562.                merely shows how much of your computer's main memory is
  563.                currently unallocated by any program.  The "string space"
  564.                value, however, is quite important because it is directly
  565.                related to the size of the puzzle you are working with.
  566.             
  567.                Without getting into a technical discussion on BASIC
  568.                programming, "string space" is a dedicated area of memory
  569.                where all "character data" is stored.  This includes all
  570.                of the on-screen text, help messages, internal variables,
  571.                and, most importantly, the letters in your puzzle and its
  572.                accompanying clues.
  573.             
  574.                String space is limited to about 64,000 characters and
  575.                since CWC is a large program by BASIC standards, only
  576.                about 16,000 characters are left for you to build puzzles
  577.                in.  Watch this number CAREFULLY.  If it drops below
  578.                about 7000, you are close to the maximum puzzle size.  If
  579.                it drops below about 4000, you will probably not be able
  580.                to print your puzzle or use the REVIEW CLUES function.
  581.             
  582.                If string space drops below 1000, the program will
  583.                probably crash.  An "Out of string space" error is,
  584.                unfortunately, often impossible to handle gracefully in
  585.                BASIC because trapping errors requires more program code
  586.                and more code requires more string space; another
  587.                Catch-22.
  588.             
  589.  
  590.  
  591.  
  592.                                           8
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.             9. The maximum value of the "MaxPuzClues=" keyword has been
  602.                reduced from 999 to 300 to conserve string space.  This
  603.                should be of little consequence since I do not believe it
  604.                is actually possible to squeeze more than 300
  605.                at-least-two-letter words into a 36 by 22 matrix.
  606.             
  607.             10.The format of the printed puzzle clues has been modified
  608.                to conform to AP/UPI newsservice standards.  Basically,
  609.                this amounts to right-aligning the clue numbers and
  610.                printing a period after each number.
  611.             
  612.             11.The DESIGN SAVE function now prompts for an optional
  613.                "Puzzle Title" that can be up to 33 characters long.
  614.                This title is centered above the puzzle when the
  615.                crossword is printed.
  616.             
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.                                           9
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.             I. Distribution Disks                                      1
  668.             II. The New LANGUAGE Files (*.CWL)                         2
  669.             III. HELP File Changes                                     3
  670.             IV. Starting Crossword Creator                             4
  671.             V. New Printer Definition Keyword                          5
  672.             VI. CLUE File Format Changes                               6
  673.             VII. Other Enhancements                                    7
  674.             
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.