Merge pull request #5714 from alexischr/update_bockbuild

[mono.git] / man / gacutil.1

diff --git a/man/gacutil.1 b/man/gacutil.1
index 704c263486ffe3db63386d9d5f761fa61e0bea90..6b9ffd5c2b06f3a6926412396b477fe44c951bec 100644 (file)
--- a/man/gacutil.1
+++ b/man/gacutil.1
@@ -8,20 +8,20 @@
 .if t .sp .5v
 .if n .sp
 ..
-.TH gacutil "Mono 1.0"
+.TH Mono "gacutil"
 .SH NAME
-gacutil \- Global Asssembly Cache management utility.
+gacutil \- Global Assembly Cache management utility.
 .SH SYNOPSIS
 .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
+Notice that they are not directly available to the compiler. The
 convention is that assemblies must also be placed in a separate
-directory for being accessed to the compiler.  This is done with the
+directory to be accessed by the compiler.  This is done with the
 -package directive to gacutil.
 .PP
 The tool allows for installation, removal, and listing of the
@@ -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)$(prefix)/lib".
+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
@@ -74,15 +74,15 @@ this takes as an argument the assembly name, which looks like this:
        MyLibrary.Something, version=1.0.0.0, publicKeyToken=xxxx,culture=neutral
 .fi
 .Sp
-Notice that you can have spaces in the command line, there is no need
+Notice that you can have spaces in the command line. There is no need
 to quote them.
 .Sp
-The removal performs a greedy removal, if you only specifiy one
+Performs a greedy removal. If you only specify one
 component like, "MyLibrary.Something", it will remove all versions of
 the library.
 .Sp
 .I "-us" <assembly_path> [-package NAME] [-root ROOTDIR] [-gacdir GACDIR]
-Uninstalls an assembly using the specifed assemblies full name.
+Uninstalls an assembly using the specified assembly's full name.
 <assembly path> is the path to an assembly. The full assembly name
 is retrieved from the specified assembly if there is an assembly in
 the GAC with a matching name, it is removed. Unlike the -u option this