X-Git-Url: http://wien.tomnetworks.com/gitweb/?a=blobdiff_plain;f=man%2Fgacutil.1;h=05d9ff2b1e2ca9c771a7731f4167ff4c077b2594;hb=56e09faf10f30a0f4f9b1edd90b8a921f941e030;hp=704c263486ffe3db63386d9d5f761fa61e0bea90;hpb=7ff8f29ff29fa3f08ef305ac43ef079097323286;p=mono.git diff --git a/man/gacutil.1 b/man/gacutil.1 index 704c263486f..05d9ff2b1e2 100644 --- a/man/gacutil.1 +++ b/man/gacutil.1 @@ -15,9 +15,9 @@ gacutil \- Global Asssembly Cache management utility. .PP .B gacutil [-user] [command] [options] .SH DESCRIPTION -\fIgacutil\fP is a tool used by developers to install assemblies into -the system Global Assembly Cache (GAC) to become part of the -assemblies that are available for all applications at runtime. +\fIgacutil\fP is a tool used by developers to install versioned +assemblies into the system Global Assembly Cache (GAC) to become part +of the assemblies that are available for all applications at runtime. .PP Notice that they are not directly available to the compiler, the convention is that assemblies must also be placed in a separate @@ -41,14 +41,14 @@ prefix/lib/mono with the name NAME, and a symlink is created from NAME/assembly_name to the assembly on the GAC. This is used so developers can reference a set of libraries at once. .Sp -The -root option is used by developers integrating this with automake -tools or packaging tools that require a prefix directory to be -specified. The root represents the "libdir" component of a prefix -(typically prefix/lib). +The -root option is used to specify the "libdir" value of an installation +prefix which differs from the prefix of the system GAC. +Typical automake usage is "-root $(DESTDIR)$(libdir)". +To access assemblies installed to a prefix other than the mono prefix, +it is necessary to set the MONO_GAC_PREFIX environment variable. .Sp -The -gacdir option is used to specify the GACs base directory. Once an -assembly has been installed to a non standard gacdir the MONO_GAC_PATH -environment variable must be used to access the assembly. +The -gacdir option is included for backward compatibility but is not +recommended for new code. Use the -root option instead. .Sp The -check_refs option is used to ensure that the assembly being installed into the GAC does not reference any non strong named