[phc-general] How to make a distribution

[Edsko de Vries]

On Fri, Aug 11, 2006 at 07:43:09PM +0200, Satyam wrote:
> I was about to list the files I got with the files in the regular 
> distribution to figure out which ones go into the distribution and which 
> don't, to build the download of my version.   I was wondering  if there was 
> any easier way, some 'make something' that would clean it all up.

Hmmm. "make dist" _ought to_ sort that out, but in fact doesn't. The
reason is that our Makefile.am is not careful enough to list each and
every file that is needed for a distribution. Instead, we use a
shellscript that creates releases for us. However, this shellscript is
not distributed with phc, because it needs information that is not
available from within the phc source tree. 

I think the easiest way would be to make a small scriptscript that
copies all the files you need into a new folder, and then tar up that
folder. A bit of work, but a once-off investment.

> Also, where would I change the name of the final executable?  It wouldn't 
> be Ok to let it have the same name since it doesn't have the same 
> functionality. Since many of the files depend on each other, if I touch one 
> of the productions instead of the root, I'll mess it all up.

To change the name of the executable to "phcst" (say), you must modifiy
Makefile.am. You will find a line

bin_PROGRAMS = phc

change that to

bin_PROGRAMS = phcst

then you will find another line

phc_SOURCES = \

and change that to

phcst_SOURCES = \

(be careful not to insert a space after that final backslash).

I think that should do it.

Edsko