itcl/README

   1                    - Sourceware.org Incr Tcl Overview -
   2                         Written by Keith Seitz
   3
   4 This module is an import of the ITcl/Itk/Iwidgets modules for Tcl/Tk
   5 into the sourceware.org repository. The net sources have been
   6 imported into the NET branch and subsequently merged into the
   7 main repository branch (HEAD or tip or what have you).
   8
   9 All three modules are distributed separately, and have been committed
  10 to the vendor branch using the following layout:
  11
  12 itcl/
  13   itcl/  itk/  iwidgets/
  14
  15 The itcl, itk, and iwidgets subfolders contain the virgin upstream
  16 sources from sf.net. Configury has been added in the toplevel itcl/
  17 folder to set facilitate building Itcl et al as part of a sourceware.org
  18 build.
  19
  20 To import a new version of Incr Tcl, follow this procedure:
  21
  22 1. Download the itcl, itk, and iwidgets source tarballs. And
  23    layout the sources in the following hierarchy: itcl/, itcl/itcl, itcl/itk,
  24    and itcl/iwidgets. The toplevel itcl folder should only contain three
  25    subfolders -- no regular files.
  26 2. Checkout the itcl module:
  27   $ cvs co naked-itcl
  28 3. Force a commit for every file:
  29   $ cd src/itcl
  30   $ cvs commit -f -R -m "touch all sources to ease next import"
  31 4. Import the new sources:
  32   $ cd /my/local/itcl
  33   $ cvs import -ko -I\! -m 'imported Itcl 3.3' src/itcl NET ITCL_3_3
  34 5. Merge local changes with the newly imported sources:
  35   $ cd /some/empty/directory
  36   $ cvs co -jNET:yesterday -jNET src/itcl
  37   ... look at merges; resolve any conflicts ...
  38   $ cvs commit
  39 6. Update working directory. This step is often done in parallel
  40    with merging and conflict resolution.
  41 7. I also go back and remove obsolete files from the NET branch
  42    (files which no longer exist).
  43
  44 While I have attempted to add only toplevel configury for Itcl,
  45 it has been necessary to directly fiddle with the sources, particularly
  46 for iwidgets, whose build configury I have updated to mimmick that
  47 of itcl and itk. I have also regenerated autotools files. Check the toplevel
  48 ChangeLog for specifics when merging. I have only added *local* differences
  49 between the NET branch and the HEAD/tip version into the ChangeLog.
  50
  51 I have opted not to add "SOURCEWARE LOCAL" around everything. They never
  52 really seem to help me anyway. It is much easier to inspect diffs of
  53 the vendor branch and the main repository copy.