Mailing-List: contact cygwin-apps-help AT sourceware DOT cygnus DOT com; run by ezmlm
Sender: cygwin-apps-owner AT sourceware DOT cygnus DOT com
List-Subscribe: <mailto:cygwin-apps-subscribe AT sources DOT redhat DOT com>
List-Archive: <http://sources.redhat.com/ml/cygwin-apps/>
List-Post: <mailto:cygwin-apps AT sources DOT redhat DOT com>
List-Help: <mailto:cygwin-apps-help AT sources DOT redhat DOT com>, <http://sources.redhat.com/lists.html#faqs>
Delivered-To: mailing list cygwin-apps AT sources DOT redhat DOT com
Message-ID: <3A1C78F5.5F567AF4@ece.gatech.edu>
Date: Wed, 22 Nov 2000 20:55:01 -0500
From: Charles Wilson <cwilson AT ece DOT gatech DOT edu>
X-Mailer: Mozilla 4.75 [en] (Windows NT 5.0; U)
X-Accept-Language: en
MIME-Version: 1.0
To: Carlos Puig <cpuig AT home DOT com>
CC: cygwin-apps AT cygwin DOT com
Subject: Re: Texinfo-4.0
References: <Pine DOT LNX DOT 4 DOT 30 DOT 0011221627240 DOT 10273-100000 AT c445745-a DOT stcla1 DOT sfba DOT home DOT com>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit


> I'm looking for some guidance on how texinfo-4.0 (suitably patched)
> could be included in cygwin releases to replace texinfo-3.12.  Is there
> someone who normally handles packages like texinfo?  Are there formal
> procedures I should follow?  (I'm new to this list.)

Principles:
  A. source tarballs are "shipped" already patched to build cleanly on
cygwin
  B. source tarballs contain a "CYGWIN-PATCHES" directory that contains
      (a) cygwin-specific README
      (b) cygwin-specific patches (ALREADY applied to the source
archive)
      (c) other cygiwn-specific stuff
  C. binary packages should install into /usr/*, not /usr/local/*

Step 1.  download tex-3.12-X-src.tar.gz from the cygwin servers.  Look
inside for any indication of who maintains it.  If someone is listed --
contact them.  Otherwise, continue below.

Step 2.  Unpack source:
   download the clean tex-4.0.tar.gz source code and unpack
   rename the source directory "mv tex-4.0/ tex-4.0-orig/"
   unpack the code again.  Now you have "tex-4.0" (<tex-src>)
   and "tex-4.0-orig"

Step 3.  apply your patches
Step 4.  cd <tex-src>
Step 5.  create a CYGWIN-PATCHES directore
Step 6.  create a CYGWIN-PATCHES/tex-4.0.README file which describes the
package, gives any necessary notes for how it should be built and how it
is to be used.

Step 7.  modify the top level makefile to install
CYGWIN-PATCHES/tex-4.0.README into /usr/doc/Cygwin/

Step 8.  <optional> modify the top level makefile to install any other
documentation into /usr/doc/tex-4.0/*   (FAQs, README's, etc.  --not--
manpages or info files; those are usually installed into the right
directories by default.

Step 9.  clean up any stray editor or backup files (foo.c~ for
instance).

Step 10. Create a patch file:
   cd <tex-src>/..
   diff -urN tex-4.0-orig/ tex-4.0/ > tex-4.0-1.patch
   mv tex-4.0-1.patch <tex-src>/CYGWIN-PATCHES/

Step 11. Create the src tarball for cygwin:
   cd <tex-src>/..
   tar cvzf tex-4.0-1-src.tar.gz tex-4.0

Step 12. Build
   A. ./configure --prefix=/usr  (+ whatever flags are necessary)
   B. make
   C. make install prefix=/tmp/usr
   D. make test, make check, whatever..
This will build the package so that it installs in /usr and expects to
'live' in /usr, but will actually install it into /tmp/usr so we can do
step 13.

Step 13. Create binary tarball for cygwin
   A. cd /tmp
   B. tar cvzf tex-4.0-1.tar.gz usr

Now, you've got 
  tex-4.0-1-src.tar.gz  
    the pre-patched, cygwin-specific source 
    code for the package
  tex-4.0.tar.gz
    the compiled binary.  Should also include 
    the stuff in usr/doc/Cygwin/ and usr/doc/tex-4.0

Once you get that far, then we'll talk again.

--Chuck