#73 Document use of --merge with ranlib and lorder

[Anonymous]

I observed this with CIL 1.3.6.

When cilly is used in a large project that will build .a libraries, and if one wants to apply whole-program analysis, one must redefine:

CC = cilly --merge
LD = cilly --merge
AR = cilly --merge --mode=AR

This is not sufficient. One needs to also define:

RANLIB = echo
LORDER = echo

That's because the ranlib and lorder tools are usually used in building static .a libraries. ranlib is used to create and add an index in the library file, and lorder is used to determine the dependencies between .o files. ranlib fails because the .a file is not object code, but instead source code. lorder fails because the list of files supplied to it are not object code, but instead source code.

Please update the documentation to reflect this information.

Thanks.

[David Gay]

Documentation updated where mode=AR is explained.