home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / windows / winmenu.zip / CMDPOST.TXT < prev   
Text File  |  1988-05-02  |  44KB  |  1,598 lines

  1.  
  2.             
  3.  
  4.             
  5.  
  6.             
  7.  
  8.                    Command Post 3.3 -- A Windows Menu Application
  9.  
  10.                            Copyright 1988, Morrie Wilson
  11.  
  12.             
  13.  
  14.             
  15.  
  16.             
  17.  
  18.             
  19.  
  20.             
  21.  
  22.             
  23.  
  24.             
  25.  
  26.             Command Post is a MS Windows application designed to allow
  27.             users to easily personalize the MS-DOS Executive control
  28.             window.  Command Post allows users to easily add Menu and
  29.             Submenu items to the main MS-DOS Executive menu bar, and to
  30.             execute desired applications when a menu item is selected.
  31.  
  32.                          
  33.  
  34.                                  Table of Contents
  35.  
  36.             
  37.  
  38.  
  39.  
  40.                        Licensing and Duplication Information
  41.  
  42.                    Duplication Restrictions....................... 4
  43.  
  44.                    General Licensing Information.................. 5
  45.  
  46.                    Shareware Licensing Information................ 6
  47.  
  48.                    Shareware Update Information................... 7
  49.  
  50.                    Commercial Licensing Information............... 8
  51.  
  52.  
  53.  
  54.                                     Command Post
  55.  
  56.                    An Introduction................................ 9
  57.  
  58.                    Installing Command Post....................... 10
  59.  
  60.  
  61.  
  62.                                  Using Command Post
  63.  
  64.                    Getting Started with Command Post............. 11
  65.  
  66.                    Command Post Commands......................... 12
  67.                       The Windows directory menuitem............. 12
  68.                       The CmdPost menuitem....................... 13
  69.                       The Option Selection Dialog Box............ 14
  70.  
  71.                    System Menu Extensions........................ 15
  72.  
  73.                    Command Post HotKey........................... 15
  74.  
  75.  
  76.  
  77.                                  Command Post Menus
  78.  
  79.                    Making Your Own Menus......................... 16
  80.  
  81.                    A Simple Sample Menu.......................... 18
  82.  
  83.                    Command Post Keyboard Interface............... 20
  84.  
  85.  
  86.  
  87.  
  88.  
  89.                                   Command Post 3.3
  90.                                           2                    
  91.  
  92.  
  93.  
  94.                                        Notes
  95.  
  96.                    Notes - Program Not in Path................... 22
  97.  
  98.                    Notes - Reloading Menus....................... 23
  99.  
  100.                    Notes - Automagic Directory Updates........... 24
  101.  
  102.                    Notes - MS-DOS View Menu selections........... 25
  103.  
  104.  
  105.  
  106.                                      Appendices
  107.  
  108.                    Appendix A - Special Thanks................... 26
  109.  
  110.                    Appendix B - Command Post Version Information. 27
  111.  
  112.                    Appendix C - Other Window Applications........ 28
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.                                   Command Post 3.3
  148.                                           3                                           
  149.  
  150.                                           
  151.  
  152.                        Licensing and Duplication Information
  153.  
  154.             
  155.  
  156.                               Duplication Restrictions
  157.  
  158.             
  159.  
  160.             Command Post is a shareware product.  It may be freely
  161.             copied and distributed for evaluation as long as four basic
  162.             rules are followed.  These rules are:
  163.  
  164.             
  165.  
  166.                    1) The program and this documentation may not be
  167.                       modified in any way.
  168.  
  169.                    2) A copy of this documentation is provided with the
  170.                       program.
  171.  
  172.                    3) No charge, other than a media and handling charge,
  173.                       (not to exceed $5.00) is made.
  174.  
  175.                    4) Users of the program are encouraged to purchase a
  176.                       license for its use.
  177.  
  178.             
  179.  
  180.             If a copy of this program is retained, an obligation to
  181.             purchase a license for its use is incurred.  A license for
  182.             use of this program costs only $15.00.
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.                                   Command Post 3.3
  206.                                           4                                           
  207.  
  208.                            General Licensing Information
  209.  
  210.             
  211.  
  212.             Command Post may be either licensed as a shareware or as a
  213.             commercial program.  The shareware option is for general use
  214.             by private individuals and most businesses.  The commercial
  215.             option is available to businesses whose accounting systems
  216.             cannot adapt to the shareware software distribution method.
  217.  
  218.             A purchase of a shareware license assumes that a copy of the
  219.             software has already been obtained, and that the user wishes
  220.             to retain the copy for future use.
  221.  
  222.             Licensed shareware users may purchase an update at any time
  223.             for a $5.00 handling fee.  If you wish to purchase a share-
  224.             ware license and do not have a copy of this program, be sure
  225.             to purchase an update at the same time.
  226.  
  227.             With the purchase of each commercial license, a copy of the
  228.             software and documentation will be shipped to any U.S
  229.             destination.
  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.  
  263.                                   Command Post 3.3
  264.                                           5             
  265.  
  266.                           Shareware Licensing Information
  267.  
  268.                                           
  269.  
  270.             In order to purchase a shareware license, enclose the
  271.             following items in an envelope and mail to the address given
  272.             below:
  273.  
  274.             Enclose: 1) A check for $15.00
  275.  
  276.                      2) The serial number of the copy of Command Post
  277.                         being used  (See the About... display from the
  278.                         CmdPost menuitem for this information)
  279.  
  280.                      3) Name and address
  281.  
  282.             Mail to:    Wilson WindowWare
  283.                         3377 59th SW
  284.                         Seattle WA  98116
  285.  
  286.             
  287.  
  288.             One license per usable copy of Command Post is required.
  289.             Archive and backup copies do not count.
  290.  
  291.             Please note that no copy of the software will be sent to
  292.             you.  If you want or need the latest copy of Command Post,
  293.             be sure to also purchase an update as explained later on.
  294.  
  295.             Please note that if you purchased a disk containing this
  296.             software from a public domain/shareware software distributor
  297.             you have paid the media and handling charges as permitted in
  298.             the "Duplication Restriction" section. You have not
  299.             purchased a license.  A canceled check made out to Wilson
  300.             WindowWare is the standard proof of a paid license.
  301.  
  302.             The accuracy of the information supplied here and the
  303.             fitness of the Command Post program for any purpose may
  304.             change without notice, and should not be construed as any
  305.             kind of a commitment.  No responsibility is assumed for any
  306.             errors or problems that may be encountered with use of this
  307.             product.
  308.  
  309.             There are no warranties whatsoever associated with this
  310.             product.
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.                                   Command Post 3.3
  322.                                           6             
  323.  
  324.                             Shareware Update Information
  325.  
  326.                                           
  327.  
  328.             In order to purchase an update to Command Post, (assuming
  329.             you have a shareware license) enclose the following items in
  330.             an envelope and mail to the address given below:
  331.  
  332.             
  333.  
  334.             Enclose: 1) A check for $5.00
  335.  
  336.                      2) The serial number of the copy of Command Post
  337.                         being used  (See the About... display from the
  338.                         CmdPost menuitem for this information)
  339.  
  340.                      3) Name and address
  341.  
  342.             
  343.  
  344.             Mail to:    Wilson WindowWare
  345.                         3377 59th SW
  346.                         Seattle WA  98116
  347.  
  348.             
  349.  
  350.             The following materials will be shipped within 15 days:
  351.  
  352.                    1) The Command Post software on a 5 1/4" DD diskette.
  353.                       (3 1/2" versions are not yet available, however
  354.                       you may copy the program to 3 1/2" diskettes if
  355.                       desired.)
  356.  
  357.             
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.                                   Command Post 3.3
  380.                                           7             
  381.  
  382.                           Commercial Licensing Information
  383.  
  384.             
  385.  
  386.             In order to purchase the commercial versions of this
  387.             package, enclose the following items in an envelope and mail
  388.             the the address given below:
  389.  
  390.             
  391.  
  392.             Enclose: 1) A check for $40.00
  393.  
  394.                      2) Company name and shipping address
  395.  
  396.             
  397.  
  398.             Mail to:    Wilson WindowWare
  399.                         3377 59th SW
  400.                         Seattle WA  98116
  401.  
  402.             
  403.  
  404.             The following materials will be shipped within 15 days:
  405.  
  406.                    1) The Command Post software on a 5 1/4" DD diskette.
  407.                       (3 1/2" versions are not yet available, however
  408.                       you may copy the program to 3 1/2" diskettes if
  409.                       desired.)
  410.  
  411.                    2) Printed copy of applicable documentation, with
  412.                       softcover binder.
  413.  
  414.                    3) Shipping paperwork identifying contents of
  415.                       package.
  416.  
  417.             
  418.  
  419.             One license per usable copy of Command Post is required.
  420.             Archive and backup copies do not count.
  421.  
  422.             The accuracy of the information supplied here and the
  423.             fitness of the Command Post program for any purpose may
  424.             change without notice, and should not be construed as any
  425.             kind of a commitment.  No responsibility is assumed for any
  426.             errors or problems that may be encountered with use of this
  427.             product.
  428.  
  429.             There are no warranties whatsoever associated with this
  430.             product.
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.                                   Command Post 3.3
  438.                                           8             
  439.  
  440.                                     Command Post
  441.  
  442.             
  443.  
  444.             
  445.  
  446.                                   An Introduction
  447.  
  448.                                           
  449.  
  450.             Command Post is a Microsoft Windows application designed to
  451.             allow users to easily personalize the MS-DOS Executive
  452.             control window.
  453.  
  454.             Command Post allows users to easily add Menu and Submenu
  455.             items to the main MS-DOS Executive menu bar, and to execute
  456.             desired applications when the added menuitems are selected.
  457.             The MS-DOS Executive window may continue to be used as
  458.             always, it just has a few new menuitems on it now.
  459.  
  460.             With Command Post you may add any number of new menuitems,
  461.             and each of these menuitems are only a single mouse click
  462.             away!  Command Post Menuitems are also accessible via
  463.             keyboard commands just like any other menuitem in Microsoft
  464.             Windows.
  465.  
  466.             Command Post can be instructed to prompt you for parameters
  467.             for your applications.  You can supply the prompting
  468.             question, and even a default answer if you choose.
  469.  
  470.             Command Post menus are created using the Notepad Editor, or
  471.             with any other text editor that can save a plain ASCII file.
  472.             Special menu editors are not required.
  473.  
  474.             The Command Post menu file has an easy and straightforward
  475.             syntax, and can be re-loaded into Command Post after
  476.             modification.
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.                                   Command Post 3.3
  496.                                           9             
  497.  
  498.                               Installing Command Post
  499.  
  500.                                           
  501.  
  502.             Command post is easily installed.  Simply copy the three
  503.             files, CMDPOST.EXE, CMDLIB.EXE and CMDPOST.MNU, to your
  504.             windows directory.
  505.  
  506.             CMDPOST.EXE is the Command Post application file.  When it
  507.             is invoked, as discussed in a following section, it attempts
  508.             to locate and load the Command Post menu file, CMDPOST.MNU.
  509.  
  510.             CMDLIB.EXE is not meant to be executed by the user.  It
  511.             contains window library routines that are invoked by
  512.             CMDPOST.EXE.
  513.  
  514.             The sample CMDPOST.MNU file supplied with Command Post will
  515.             get you started defining you very own Command Post menus.
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.                                   Command Post 3.3
  554.                                          10             
  555.  
  556.                                  Using Command Post
  557.  
  558.             
  559.  
  560.                                           
  561.  
  562.                          Getting Started with Command Post
  563.  
  564.             
  565.  
  566.             Command Post may be invoked with any of the methods that
  567.             follow:
  568.  
  569.                    1) Via the MS-DOS menu in Windows.  If Command Post
  570.                       is invoked this way, it will take over the MS-DOS
  571.                       Executive window, modify the menu bar, installing
  572.                       your personalized menuitems, and then allow you to
  573.                       proceed.
  574.  
  575.                    2) You may modify your WIN.INI file, adding
  576.                       CMDPOST.EXE to either the RUN= or the LOAD=
  577.                       sections.  This will automatically start Command
  578.                       Post whenever you start Windows.
  579.  
  580.                       Special Note:  When started this way, the sense of
  581.                       the LOAD= and RUN= selections are reversed.  If
  582.                       CMDPOST.EXE is specified on the RUN= line, then it
  583.                       will be loaded as an icon, whileas if it is
  584.                       specified on the LOAD= line, it will be loaded as
  585.                       a window.
  586.  
  587.                    3) You may also type WIN CMDPOST at the MS-DOS
  588.                       prompt.  Command Post will be started as an icon.
  589.  
  590.             Initially, when you start Command Post you will see a simple
  591.             extension to the MS-DOS Executive window, as defined by the
  592.             CMDPOST.MNU file that is shipped with Command Post.  This
  593.             simple menu allows you access to the desktop accessories and
  594.             other applications shipped with the standard version of
  595.             MIcrosoft Windows.
  596.  
  597.             After reading the section on defining your own menus, you
  598.             can edit CMDPOST.MNU to add you own menuitems.
  599.  
  600.             You may have up to four Command Post windows at one time,
  601.             (although I can't see any reason for more than two). Each
  602.             Command Post Window will have its number in the window title
  603.             bar (e.g.  <#1 Command Post>  ).
  604.  
  605.                    
  606.  
  607.  
  608.  
  609.  
  610.  
  611.                                   Command Post 3.3
  612.                                          11                                           
  613.  
  614.                                           
  615.  
  616.                                Command Post Commands
  617.  
  618.             
  619.  
  620.             Command Post installs two of its own menu items onto the
  621.             normal set of MS-DOS menuitems.  These menuitems are Windows
  622.             and CmdPost.
  623.  
  624.             
  625.  
  626.             
  627.  
  628.             
  629.  
  630.                                           
  631.  
  632.                            The Windows directory menuitem
  633.  
  634.             
  635.  
  636.             The Windows directory menuitem, when selected, will popup a
  637.             submenu filled with the windows names of the various
  638.             applications that are currently running.  By merely
  639.             selecting one of the window names, Command Post will
  640.             immediately transfer you to that window.
  641.  
  642.             
  643.  
  644.             This command is particularly handy for handling overlapped
  645.             windows because a small window can easily get lost beneath a
  646.             multitude of other windows and become difficult to find.
  647.  
  648.             
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.                                   Command Post 3.3
  670.                                          12             
  671.  
  672.                                 The CmdPost menuitem
  673.  
  674.             
  675.  
  676.             The CmdPost menuitem has four submenu items, as discussed
  677.             below:
  678.  
  679.             
  680.  
  681.                   Confirm Command Post Selections  -  This item is a
  682.                                 toggle. If it is checked, then any
  683.                                 selection from your personalized menu
  684.                                 will appear in a dialog box prior to
  685.                                 execution.  You may modify any of the
  686.                                 fields and then run it.  An option to
  687.                                 cancel is also present.  If confirm is
  688.                                 on, the window title bar will so
  689.                                 indicate.
  690.  
  691.                   Option Selections... - Selection of this menuitem will
  692.                                 cause an option selection dialog box to
  693.                                 be displayed.  See the section on the
  694.                                 Option Selection Dialog box below.
  695.  
  696.                   Reload Command Post Menus -  Selection of this item
  697.                                 will cause the Command Post menu to be
  698.                                 rebuilt from the current contents of the
  699.                                 CMDPOST.MNU file.  This command is used
  700.                                 to reload the Command Post menu after
  701.                                 you make modifications to the menu file
  702.                                 with an editor.  If you use more than
  703.                                 one Command Post window, please see the
  704.                                 Notes section below.
  705.  
  706.                   About Command Post... - Selection of this item will
  707.                                 cause a display of the Command Post
  708.                                 copyright notice and additional
  709.                                 information.
  710.  
  711.             
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.                                   Command Post 3.3
  728.                                          13             
  729.  
  730.             
  731.  
  732.                           The Option Selection Dialog Box
  733.  
  734.             
  735.  
  736.             The Option Selection Dialog box allows you to specify the
  737.             three Command Post options.  These are:
  738.  
  739.             
  740.  
  741.                    1) The automatic directory display update.  When this
  742.                       menu box is checked, the MS-DOS directory display
  743.                       will be updated as soon as a selected Command Post
  744.                       window becomes active.  If this box is not
  745.                       checked, the user must select one of the Disk
  746.                       Drive icons on the display in order to update the
  747.                       directory display.
  748.  
  749.                    
  750.  
  751.                    2) The Start User Menu on New Line.  When this box is
  752.                       checked, the user definable menu items will be
  753.                       displayed on a new menu line.  If this box is not
  754.                       checked, the user menu items will simply be a
  755.                       continuation of the main MS-DOS and Command Post
  756.                       menu line.  Users with only a few menu items may
  757.                       prefer to have a single menu line.
  758.  
  759.                    
  760.  
  761.                    3) Return to original directory.  When this box is
  762.                       checked, changing directories and starting up an
  763.                       application will not change the current directory
  764.                       displayed in the MS-DOS/Command Post window.  If
  765.                       this box is not checked, the directory display
  766.                       will be the same as the directory specified in the
  767.                       Command Post menu, as long as it is on the current
  768.                       drive (as highlighted at the top of the window).
  769.  
  770.                    
  771.  
  772.             All the Command Post options are Global.  This means that
  773.             the option selections apply to all Command Post windows, not
  774.             just the current window. If an option is enabled or disabled
  775.             for one Command Post window, it is also enabled or disabled
  776.             for ALL of them.
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.                                   Command Post 3.3
  786.                                          14             
  787.  
  788.                                           
  789.  
  790.                                           
  791.  
  792.                                System Menu Extensions
  793.  
  794.                                           
  795.  
  796.             One item has been added to the system (ALT-SPACEBAR) menu.
  797.             It is the "End Windows Session" command.
  798.  
  799.             The "End Windows Session" menuitem is identical the the END
  800.             SESSION menuitem in the MS-DOS Executive SPECIAL menu.  They
  801.             both first ask you to confirm that you really want to exit
  802.             windows, and if you do, then all running applications are
  803.             queried as to whether or not this is a good idea.  E.G.
  804.             Editors with unsaved data may ask you whether or not you
  805.             wish to save your data, discard it, or perhaps even cancel
  806.             the END SESSION process.
  807.  
  808.             
  809.  
  810.             
  811.  
  812.             
  813.  
  814.                                           
  815.  
  816.                                           
  817.  
  818.                                 Command Post HotKey
  819.  
  820.                                           
  821.  
  822.             
  823.  
  824.             The Command Post HotKey, CONTROL-SHIFT-ESCAPE, will transfer
  825.             control to Command Post from any other application window.
  826.  
  827.             If you are running multiple Command Post windows, control
  828.             will be transferred to the lowest numbered Command Post
  829.             available.
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.                                   Command Post 3.3
  844.                                          15             
  845.  
  846.                                  Command Post Menus
  847.  
  848.             
  849.  
  850.                                Making Your Own Menus
  851.  
  852.                                           
  853.  
  854.             Command Post uses a file called CMDPOST.MNU to build your
  855.             personalized menus.  The CMDPOST.MNU file normally resides
  856.             in your \WINDOWS directory next to the CMDPOST.EXE file.  In
  857.             order to add to the default menu shipped with Command Post,
  858.             or to modify your menu as your needs change, simply edit the
  859.             CMDPOST.MNU file with the Notepad editor (or any other plain
  860.             ASCII editor).
  861.  
  862.             Take a moment to examine the contents of CMDPOST.MNU.  Its
  863.             structure is actually very simple.  There are only 4 types
  864.             of entries.  These types are:
  865.  
  866.             
  867.  
  868.                    1) Comments.  Blank lines and any line with a single
  869.                       quote mark in the first column (column 1) is
  870.                       considered a comment and is ignored by Command
  871.                       Post.
  872.  
  873.                    
  874.  
  875.                    2) The Main Menu Titles.  Main menu titles are the
  876.                       menu headings displayed on the menu bar.  These
  877.                       main menu titles MUST start in the first column
  878.                       (column 1).  Although Command Post allows these
  879.                       main menu titles to be rather long, you are
  880.                       advised, for aesthetic reasons, to keep the main
  881.                       menu titles short.  One or two words should be
  882.                       sufficient.
  883.  
  884.                    
  885.  
  886.                    3) The Popup Menu Titles.  Popup menu titles comprise
  887.                       the menus that popup every time a main menu title
  888.                       is selected.  The popup menu titles MUST start in
  889.                       the second column (column 2) and may be long,
  890.                       although, for aesthetic reasons again, should be
  891.                       limited to about 30 characters or less. Please
  892.                       note that for popup menu titles, the first
  893.                       character of the line MUST be a space, with the
  894.                       first letter of the popup menu title starting in
  895.                       column 2.
  896.  
  897.  
  898.  
  899.  
  900.  
  901.                                   Command Post 3.3
  902.                                          16                    
  903.  
  904.                    4) The menu action lines.  For each popup menu title,
  905.                       there are a pair of menu action lines.  The first
  906.                       line of the pair specifies the initial directory
  907.                       (or path), and the second line specifies the
  908.                       application and any parameters that may be
  909.                       required.  These two lines MUST BE PRECEDED BY AT
  910.                       LEAST TWO SPACES, or a TAB character. (All these
  911.                       spaces, or lack of them, are used by Command Post
  912.                       to tell these various kinds of lines apart.)
  913.  
  914.                            
  915.  
  916.                            Initial Directory Specification:  The first
  917.                            line of the pair specifies the initial
  918.                            directory, and may be preceded by a disk
  919.                            drive identifier.  If you desire to use the
  920.                            currently logged directory, use a period "."
  921.                            for the directory specification.
  922.  
  923.                            Application Specification:  The second line
  924.                            of the pair is used to specify the desired
  925.                            application, and any parameters that may be
  926.                            desired.  This line can get pretty fancy, but
  927.                            we will keep it simple for a bit more.  One
  928.                            thing to remember though, is that your
  929.                            applications name MUST include the three
  930.                            letter suffix (.EXE, .COM, or .BAT).
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.                                   Command Post 3.3
  960.                                          17             
  961.  
  962.                                 A Simple Sample Menu
  963.  
  964.             Now that we got the basic menu formats defined, lets look at
  965.             a sample menu to see what all these specifications really
  966.             mean.  Examine the simple menu below:
  967.  
  968.             
  969.  
  970.             Desktop
  971.              Get Windows Clock
  972.                  .
  973.                  clock.exe
  974.              Get Calendar
  975.                  .
  976.                  calendar.exe
  977.             
  978.             Word Processing
  979.              Get Notepad Editor
  980.                  .
  981.                  notepad.exe
  982.              Get Windows Write
  983.                  .
  984.                  write.exe
  985.  
  986.             
  987.  
  988.             This simple menu has two main menu headings, "Desktop" and
  989.             "Word Processing".
  990.  
  991.             If the user selects the "Desktop" menu heading, a popup menu
  992.             containing two items "Get Windows Clock" and "Get Calendar"
  993.             will appear.
  994.  
  995.             On the other hand, if the user selects "Word Processing"
  996.             instead, a different popup menu containing "Get Notepad
  997.             Editor" and "Get Windows Write" appears instead.
  998.  
  999.             If the user were to select the "Get Notepad Editor" entry,
  1000.             Command Post would go to work.  Since the subdirectory line
  1001.             consists solely of a period, this indicates to Command Post
  1002.             that the current subdirectory is to be used and no change of
  1003.             subdirectories is to occur.  The application line has the
  1004.             filename of the Notepad Editor application, NOTEPAD.EXE,
  1005.             with no parameters.  Command Post will issue the commands to
  1006.             load and execute the NOTEPAD.EXE file.  In a few seconds,
  1007.             the Notepad Editor appears on the screen.
  1008.  
  1009.             
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.                                   Command Post 3.3
  1018.                                          18                                           
  1019.  
  1020.                                 An Ample Sample Menu
  1021.  
  1022.             Now that we have seen the basic structure of a Command Post
  1023.             menu, let's explore them some more.  In this example we will
  1024.             just use a single main menu heading, but fully flesh out the
  1025.             subdirectory and parameter possibilities
  1026.  
  1027.             
  1028.  
  1029.             Edit Various Things
  1030.             
  1031.              Edit Command Post Menu
  1032.                  c:\windows
  1033.                  notepad.exe cmdpost.mnu
  1034.             
  1035.              Write a letter to Home
  1036.                  c:\letters
  1037.                  write.exe ?Who the letter is for?Mom
  1038.  
  1039.             
  1040.  
  1041.             The first of the popup menu options above shows a simple way
  1042.             to add in a command to allow easy editing of the Command
  1043.             Post menu file.  First of all, the initial directory is set
  1044.             to C:\WINDOWS, which is the suggested  home for the
  1045.             CMDPOST.MNU file, and then the Notepad Editor is invoked to
  1046.             edit the menu file.
  1047.  
  1048.             The second example shows an example of a Command Post
  1049.             Prompter.  You will be prompted with a dialog box which
  1050.             states:
  1051.  
  1052.                     Please Enter:
  1053.                     Who the letter is for
  1054.  
  1055.             And is followed by an input box with the suggested default
  1056.             answer already set to "Mom".
  1057.  
  1058.             
  1059.  
  1060.             
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.                                   Command Post 3.3
  1076.                                          19             
  1077.  
  1078.                           Command Post Keyboard Interface
  1079.  
  1080.             
  1081.  
  1082.             If a keyboard interface (i.e. the underlined characters
  1083.             Windows uses to assist those without mice)  to the menus is
  1084.             desired, it is quite simple to add.  Just put an ampersand
  1085.             (&) in front of the letter in your menu name that you would
  1086.             like to use for your keyboard interfaces. These letters will
  1087.             appear in the menus as underlined characters, and thus you
  1088.             may use ALT key combinations to access your menuitems.
  1089.  
  1090.             In order to keep things simple, try (very hard) not to have
  1091.             duplicate underlined letters in your main Bar Menu.  In
  1092.             addition, also try not to have duplicate underlined letters
  1093.             within a Submenu. (If you have duplicate letters identifying
  1094.             menuitems, then Windows will toggle between them, and Enter
  1095.             must be hit in order to select the desired one)
  1096.  
  1097.             P.S. In your Bar Menu, do not use F, V, S, W, or C as your
  1098.             keyboard interface characters, as those letters are used
  1099.             either by the MS-DOS executive or by Command Post itself.
  1100.  
  1101.             Below is a sample menu with the keyboard interface defined:
  1102.  
  1103.             
  1104.  
  1105.             &Desktop
  1106.              Get Windows Cloc&k
  1107.                  .
  1108.                  clock.exe
  1109.              Get &Calendar
  1110.                  .
  1111.                  calendar.exe
  1112.             
  1113.             &Word Processing
  1114.              Get &Notepad Editor
  1115.                  .
  1116.                  notepad.exe
  1117.              Get Windows &Write
  1118.                  .
  1119.                  write.exe
  1120.  
  1121.             
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.                                   Command Post 3.3
  1134.                                          20                                           
  1135.  
  1136.                            Command Post Prompter Details
  1137.  
  1138.                                           
  1139.  
  1140.             The Command Post Prompter becomes activated if the first
  1141.             character of the parameter string is a question mark "?".
  1142.             Everything following the question mark, up to the next
  1143.             question mark, if any, is assumed to be part of the
  1144.             question.  If a second question mark is found, everything
  1145.             after the second question mark is used for the default
  1146.             answer.
  1147.  
  1148.             If there is nothing after the first question mark, a stock
  1149.             question is used.  See below for examples of all the
  1150.             possibilities and the results they provide.
  1151.  
  1152.             
  1153.  
  1154.             Prompt String :   ?
  1155.                Question   :   Please Enter:
  1156.                           :   Parameters for selected application
  1157.                Default    :   <blank>
  1158.             
  1159.             Prompt String :   ??
  1160.                Question   :   Please Enter:
  1161.                           :   Parameters for selected application
  1162.                Default    :   <blank>
  1163.             
  1164.             Prompt String :   ?Info for this application
  1165.                Question   :   Please Enter:
  1166.                           :   Info for this application
  1167.                Default    :   <blank>
  1168.             
  1169.             Prompt String :   ?Data for the other application?1 2 3 4 5
  1170.                Question   :   Please Enter:
  1171.                           :   Data for the other application
  1172.                Default    :   1 2 3 4 5
  1173.             
  1174.             Prompt String :   ??Jack and Jill
  1175.                Question   :   Please Enter:
  1176.                           :   Parameters for selected application
  1177.                Default    :   Jack and Jill
  1178.             
  1179.             
  1180.  
  1181.             
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.                                   Command Post 3.3
  1192.                                          21             
  1193.  
  1194.                                        Notes
  1195.  
  1196.             
  1197.  
  1198.             
  1199.  
  1200.                             Notes - Program Not in Path.
  1201.  
  1202.                                           
  1203.  
  1204.                                           
  1205.  
  1206.             The examples so far have assumed that the selected
  1207.             application can be found either in the initially selected
  1208.             subdirectory, or someplace defined in the MS-DOS PATH
  1209.             statement.  Although this does tend to make things easier,
  1210.             it is not required.  The application may be preceded with
  1211.             the complete path specification to it if desired.
  1212.  
  1213.              E.G.
  1214.  
  1215.             &Run Various Things
  1216.              Run &Obscure Program Not In Path
  1217.                  \set\desired\path
  1218.                  c:\obscure\subdir\obscure.exe assorted parameters
  1219.  
  1220.             
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.                                   Command Post 3.3
  1250.                                          22             
  1251.  
  1252.             
  1253.  
  1254.             
  1255.  
  1256.                               Notes - Reloading Menus.
  1257.  
  1258.             
  1259.  
  1260.             A modified CMDPOST.MNU may be reloaded by simply selecting
  1261.             the Reload menuitem in the Command Post submenu.
  1262.  
  1263.             All Command Post windows use the same menu.  If you have
  1264.             several Command Post windows active, and you select the
  1265.             Reload menuitem on one of them to reload the menu, the menu
  1266.             on the current Command Post window will change immediately.
  1267.  
  1268.             The menus on the other Command Post windows will not change
  1269.             immediately, but will update when you activate the window
  1270.             (e.g. mouse click).
  1271.  
  1272.             This may be disconcerting at first, but really is not too
  1273.             bad because:
  1274.  
  1275.                    1) Your menus will stabilize after a while and you
  1276.                       will not need to reload them very often
  1277.  
  1278.                    2) You can just Click (or Alt-Tab) each Command Post
  1279.                       window after reloading the menu.
  1280.  
  1281.                    
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.                                   Command Post 3.3
  1308.                                          23             
  1309.  
  1310.             
  1311.  
  1312.                         Notes - Automagic Directory Updates.
  1313.  
  1314.             
  1315.  
  1316.             Command Post has an automatic directory display update
  1317.             feature that allows the directory display to be updated
  1318.             anytime the Command Post menu is selected.
  1319.  
  1320.             The standard MS-DOS Executive window directory display does
  1321.             not update until you select one of the disk drive icons in
  1322.             the upper left of the window.  If a file is added or deleted
  1323.             outside of the MS-DOS window (e.g. Notepad adds a file),
  1324.             this fact is not displayed on the MS-DOS window until the
  1325.             disk drive icon is selected.
  1326.  
  1327.             Command Post will, if the Automatic Update Directory Display
  1328.             option has been selected, update the directory display any
  1329.             time the Command Post window is selected.  This causes a
  1330.             "blink" after the selection of the Command Post window.
  1331.  
  1332.             If this is overfly disconcerting, the feature may be turned
  1333.             off.
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.                                   Command Post 3.3
  1366.                                          24             
  1367.  
  1368.             
  1369.  
  1370.                         Notes - MS-DOS View Menu selections.
  1371.  
  1372.             
  1373.  
  1374.             Command Post will will notice and save any selections made
  1375.             to the MS-DOS View submenu.
  1376.  
  1377.             If, for example, you prefer that the directory display only
  1378.             display executable files (i.e .EXE, .COM, .BAT, and maybe
  1379.             .PIF) you would select the "Programs" View menu subitem.
  1380.  
  1381.             However, you previously had to perform this operation every
  1382.             time that you started MS-DOS.
  1383.  
  1384.             With Command Post, you do not have to be concerned about it.
  1385.             Command Post will reset the MS-DOS submenu items to the
  1386.             previous state  whenever you start Command Post.
  1387.  
  1388.             
  1389.  
  1390.             
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.                                   Command Post 3.3
  1424.                                          25             
  1425.  
  1426.             
  1427.  
  1428.                                      Appendices
  1429.  
  1430.                    
  1431.  
  1432.                             Appendix A - Special Thanks
  1433.  
  1434.                                           
  1435.  
  1436.             The home base of Command Post, and all Wilson WindowWare
  1437.             software, is the Compuserve Microsoft MSSYS forum.  A
  1438.             multitude of individuals on the forum have given hints,
  1439.             comments and suggestions that have helped make Command Post
  1440.             the powerful and unique Windows application that it is.
  1441.  
  1442.             The SYSOPS of the MSSYS forum have, as a group, been
  1443.             extremely helpful in pointing out possible approaches to
  1444.             solving a number of problems that were encountered in the
  1445.             development of this program.
  1446.  
  1447.             I am especially grateful for the assistance given by Noel
  1448.             Bergman, who has patiently pointed out various bugs,
  1449.             particularly in the LIM 4.0 environment, and has detailed
  1450.             fixes required to make Command Post a fully functional
  1451.             Windows 2.0 application.
  1452.  
  1453.             Special thanks go to the licensees of Wilson WindowWare
  1454.             software, as they are the people who are footing the bill
  1455.             for the continuing development of new and existing
  1456.             WindowWare applications.  If you have not yet send in your
  1457.             money, please, please do so now, and help make Windows
  1458.             shareware a reality.
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.                                   Command Post 3.3
  1482.                                          26             
  1483.  
  1484.                    
  1485.  
  1486.                    
  1487.  
  1488.                    Appendix B - Command Post Version Information
  1489.  
  1490.                       Version Information for Command Post 3.3
  1491.  
  1492.             
  1493.  
  1494.             Immediately below is a list of differences that this version
  1495.             of Command Post has when compared to major previous releases
  1496.             of Command Post.  This is generally only of interest when
  1497.             updating to a new version of Command Post from a previous
  1498.             release.
  1499.  
  1500.                   Version 3.3 - Added several new features
  1501.                                 1) CmdPost HotKey. Pulls up Command Post
  1502.                                    from almost anywhere (CTRL-SHIFT-ESC)
  1503.                                 2) Windows menuitem, allowing immediate
  1504.                                    access to any window.
  1505.                                 3) User menubar newline/sameline option
  1506.                                 4) Automatic directory update switch.
  1507.                                 5) Return to original directory switch.
  1508.                                 6) MS-DOS View menuitem state restore.
  1509.                                    CmdPost will remember the MS-DOS View
  1510.                                    setting, and restore them when you
  1511.                                    start Command Post.
  1512.  
  1513.                   Version 2.2 - Fixed a keyboard interface problem with
  1514.                                 the More Info dialog box.
  1515.  
  1516.                   Version 2.1 - Windows/386 and LIM 4.0 compatible
  1517.                                 release. Added ability to switch
  1518.                                 automatic directory display update on
  1519.                                 and off.
  1520.  
  1521.                   Version 2.0 - Windows 2.0 compatible release
  1522.  
  1523.                    
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.                                   Command Post 3.3
  1540.                                          27             
  1541.  
  1542.                        Appendix C - Other Window Applications
  1543.  
  1544.             
  1545.  
  1546.             Currently (4/24/88) Wilson WindowWare has two shareware
  1547.             applications as listed below. For more information on these
  1548.             applications send a SASE to:
  1549.  
  1550.             Wilson WindowWare
  1551.             3377 59th SW
  1552.             Seattle WA 98116
  1553.  
  1554.             
  1555.  
  1556.             
  1557.  
  1558.             Browser 2.1
  1559.  
  1560.             Browser is a MS Windows application designed to allow users
  1561.             to browse files in a MS Windows environment.  In addition to
  1562.             the browse capability, it supports printing, clipboarding,
  1563.             and a hex dump display.  Browser also features the new and
  1564.             unusual Hide & Seek information extraction technique.
  1565.  
  1566.             
  1567.  
  1568.             Command Post 3.3
  1569.  
  1570.             Command Post is a MS Windows application designed to allow
  1571.             users to easily personalize the MS-DOS Executive control
  1572.             window.  Command Post allows users to easily add Menu and
  1573.             Submenu items to the main MS-DOS Executive menu bar, and to
  1574.             execute desired applications when a menu item is selected.
  1575.  
  1576.             
  1577.  
  1578.             
  1579.  
  1580.             
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593.  
  1594.  
  1595.  
  1596.  
  1597.                                   Command Post 3.3
  1598.                                          28