How to Merge XPL Programming Frames Into A Preexisting U2 File
=== == ===== === =========== ====== ==== = =========== == ====

  The procedures described below *require* the XyWWWeb Jumbo
  U2 file.  If you have not already installed the Jumbo U2,
  PLEASE DO SO NOW!  It only takes a minute.  Download the
  latest Jumbo U2 release from XyWWWeb, <http://www.serve.com/xywwweb/>,
  and follow the steps in README.HTM, in the section
  entitled “Installation”.  There are instructions
  for first-time U2 users and for users with existing (non-
  XyWWWeb) U2 files.  README.HTM is included in the
  installation ZIP file.

  Formatting Programs for U2:
  --------------------------
  To operate in U2, almost all XPL programs must be formatted
  as Type 5 Help “frames”.  (Frame = program formatted for a
  “Help file” such as U2.)  Here is a template for a frame;
  the double curly braces in the first line are
  <U>mandatory</U>; “{2}” represents the Ascii-2 smiley-face
  character:

{{5framename}} [optional program description]
{2}[XPL code]{2}

  XyWWWeb.U2 is replete with actual examples; use the same
  format for your own programming.

  Command-line (CMline) arguments are passed to U2 frames via
  Save/Get 50, not the Save/Get 00 used in traditional
  freestanding programs.  For example, if your original code
  handles an argument with «SX01,«IS00»», change it to
  «SX01,«IS50»».

  Adding New Frames to U2:
  -----------------------
  To avoid conflict with XyWWWeb routines, we recommend that
  you add your personal frames at the BOTTOM of the U2 file.

  Easy Procedure (for all users):
  ^^^^ ^^^^^^^^^
  To add new frame(s) at the bottom of the file, DeFine the
  frame(s) to be added — make sure the DeFined block
  encompasses the entire {{5framename}} line and all
  associated XPL code, up to and including the final Ascii-2 —
  then, from the CMline, command:

ADD2U2/BF<Helpkey>

  To add new frame(s) at the top of the U2 file, omit the /BF
  switch:

ADD2U2<Helpkey>

  You're done!

  Manual Procedure (for experienced users):
  ^^^^^^ ^^^^^^^^^
  CoPy the new frame(s) to the desired location in your U2
  file.  Do NOT SAve or STore the U2 file.  Instead, issue:

LOADHELP<Helpkey>
  or (synonym)
LH<Helpkey>

  Then ABort U2.


CLD|RJH Rev.1/2/06