are emacs/Makefile docs correct?

[Robert J. Chassell]

Are the comments for    emacs/Makefile 
from today's CVS of 2004 Nov 10 12:51 UTC correct?

Currently, the comments say:

    # make bootstrap-build
    #      Recompiles changed Emacs Lisp files using the latest C source,
    #      then rebuilds Emacs.  This is faster than `make bootstrap'
    #      but once in a while an old .elc file can cause trouble.
    #
    # make bootfast
    #      Recompiles all the Emacs Lisp files using the latest source,
    #      then rebuilds Emacs.

but bootstrap-build is used by both bootstrap and bootfast

Should not the comments read like this:

    # make bootstrap
    #      Recompile all Emacs Lisp files after first removing old .elc files,
    #      then rebuild Emacs.  

    # make bootfast
    #      Recompile new Emacs Lisp files using the latest source,
    #      then rebuild Emacs.
    #      This is faster than `make bootstrap' 
    #      but once in a while an old .elc file can cause trouble.

    # make -C lisp autoloads && cd lisp && make recompile EMACS=../src/emacs
    #     Recompile new Emacs Lisp files.  
    #     Do not rebuild the Emacs C sources.
    #     Occasionally, an old .elc file causes trouble 
    #     because it is used in the compilation of a new file.
    #     This is the quickest but least useful action.

    # make maintainer-clean && make bootstrap
    #      Delete everything from the current directory that can be
    #      reconstructed with this Makefile 
    #       except `configure' and anything needed to run `configure'.
    #      Then recompile Emacs Lisp files and rebuild Emacs.  
    #      This is slower than `make bootstrap' alone.

    # make distclean && ./configure && make bootstrap
    #      Delete all files from the current directory that are created by
    #      configuring or building the program.  
    #      Configure.  (Add options as desired; to discover the options, run
    #       `./configure --help' first.)
    #      Recompile Emacs Lisp files and build Emacs.
    #      This is slower than `make maintainer-clean && make bootstrap'

-- 
    Robert J. Chassell                         
    address@hidden                         GnuPG Key ID: 004B4AC8
    http://www.rattlesnake.com                  http://www.teak.cc