Re: Response Files

From: David Abrahams (dave_at_[hidden])
Date: 2005-01-02 12:28:27

Alan Gutierrez wrote:
> 
> common.jam
> 
> What is the response-file? How is it used?

It's basically a windows-ism. A response-file (badly named) contains a
fragment of a command-line and its contents are substituted when the
command is run, e.g. if foo.rsp contains:

belly up to the

and I invoke

cl @foo.rsp bar

it is equivalent to

cl belly up to the bar

We need to use these because Windows command shells have a low maximum
command-line length.

> I'm looking for examples of:
> 
> generators.register-composing
> 
> I've found the archive targets for the msvc, como-win, cw,
> compilers. 
> 
> I'm wondering what a common.response-file is. Is this something
> that is only relevent to the C/C++ compiler targets.
> 
> Also, the examples discuss.
> 
> generators.register-standard
> 
> They do so, exclusively. I can see that if you put 
> 
> exe hello : usage.verbatim hello.cpp ;
> 
> That you can transform hello.verbatim to usage.cpp, how that
> would hook.
> 
> But what if you have a type BAG that takes three files ?

You might want to peruse recent edits to
tools/build/v2/doc/src/tutorial.xml and
tools/build/v2/doc/src/advanced.xml. I've been editing these for
clarity and missing information. There are lots of comments in there
that I've left for Volodya; he'll be addressing those after he gets back
on January 10th.

-- 
Dave Abrahams
Boost Consulting
http://www.boost-consulting.com