This is the mail archive of the gcc-patches@gcc.gnu.org mailing list for the GCC project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: RFA: Build doc files in build directory not source directory


On 31 May 2002, Nick Clifton wrote:

>   The patch below changes gcc's makefile so that info files and man
>   pages are created in the build tree and not the source tree.  This
>   allows these files to be created even if the sources are mounted on
>   a read-only partition.  It also updates the install-info target to
>   handle an arbitrary set of info files, making it simpler to add new
>   files in the future.

You can't do this without at the same time changing the release script to
move the files from the build tree to the source tree (as it does with
compiled message catalogs).  Support for installing from the source tree
(or copying from source tree to build tree if tool versions are too old)
needs to stay so that users of release tarballs get the docs installed if 
they don't have the right versions of the tools installed.

The generated files should be removed from .cvsignore if you stop them 
being built in the source directory.

If you want to do this, do it completely, including all languages.  You
also need to update the documentation in sourcebuild.texi, "Building
Documentation" and the description in "Front End Directory" of what the 
front end doc building targets do.

-- 
Joseph S. Myers
jsm28@cam.ac.uk


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]