Confusion in INSTALL.CVS instructions

Confusion in INSTALL.CVS instructions

[Harry Putnam]

Developers:

I found the `INSTALL.CVS' file that accompanies a cvs check out of
emacs sources to be confusing on what the progression of commands is
supposed to be.

Here is the section that I find confusing:

>          Building and Installing Emacs from CVS

> Some of the files that are included in the Emacs tarball, such as
> byte-compiled Lisp files, are not stored in the CVS repository.
> Therefore, to build from CVS you must run "make bootstrap" instead
> of just "make":

>   $ cvs update -dP
>   $ make bootstrap

> Of course, if this is the first time you go through it, you'll need
> to do ./configure before the "make bootstrap".

> Normally, it is not necessary to use "make bootstrap" after every
> CVS update.  "make" should work in 90% of the cases and be much
> quicker.

>   $ make

> (If you want to install the Emacs binary, type "make install"
> instead of "make" in the last command.)

It's not clear if on a fresh checkout one is supposed to run both 
`make bootstrap'  and `make'  or  if  `make bootstrap'  takes  the 
place  of `make'.

It may not have confused anyone else but I suspect it does.

I'm currently waiting for make bootstrap to finish.  

Re: Confusion in INSTALL.CVS instructions

[Eric Hanchrow]

>>>>> "Harry" == Harry Putnam <reader@newsguy.com> writes:

    Harry> It's not clear if on a fresh checkout one is supposed to run
    Harry> both `make bootstrap' and `make' or if `make bootstrap' takes
    Harry> the place of `make'.

`make bootstrap' indeed takes the place of `make'.

-- 
[F]reedom is kind of a hobby with me, and I have disposable
income that I'll spend to find out how to get people more of it.
        -- Penn Jillette

Re: Confusion in INSTALL.CVS instructions

[Jay Belanger]

Eric Hanchrow <offby1@blarg.net> writes:
...
>>>>>> "Harry" == Harry Putnam <reader@newsguy.com> writes:
>
>     Harry> It's not clear if on a fresh checkout one is supposed to run
>     Harry> both `make bootstrap' and `make' or if `make bootstrap' takes
>     Harry> the place of `make'.
>
> `make bootstrap' indeed takes the place of `make'.

I thought that `make' by itself would call bootstrap if necessary, so
only `make' is necessary.

Re: Confusion in INSTALL.CVS instructions

[Stefan Monnier]

Harry> It's not clear if on a fresh checkout one is supposed to run
Harry> both `make bootstrap' and `make' or if `make bootstrap' takes
Harry> the place of `make'.
>> 
>> `make bootstrap' indeed takes the place of `make'.

> I thought that `make' by itself would call bootstrap if necessary, so
> only `make' is necessary.

Indeed.  "make bootstrap" is only needed when after "cvs update" you
encounter some odd situation.  After a fresh checkout, both "make" and
"make bootstrap" should be completely equivalent.


        Stefan