Merge pull request #5714 from alexischr/update_bockbuild

[mono.git] / man / gacutil.1

diff --git a/man/gacutil.1 b/man/gacutil.1
index 853d0fbfc1d134dc32583ed423cbddd90b0279c1..6b9ffd5c2b06f3a6926412396b477fe44c951bec 100644 (file)
--- a/man/gacutil.1
+++ b/man/gacutil.1
@@ -8,9 +8,9 @@
 .if t .sp .5v
 .if n .sp
 ..
 .if t .sp .5v
 .if n .sp
 ..

-.TH gacutil "Mono 1.0"
+.TH Mono "gacutil"

 .SH NAME
 .SH NAME

-gacutil \- Global Asssembly Cache management utility.
+gacutil \- Global Assembly Cache management utility.

 .SH SYNOPSIS
 .PP
 .B gacutil [-user] [command] [options] 
 .SH SYNOPSIS
 .PP
 .B gacutil [-user] [command] [options] 


@@ -19,9 +19,9 @@ gacutil \- Global Asssembly Cache management utility.
 assemblies into the system Global Assembly Cache (GAC) to become part
 of the assemblies that are available for all applications at runtime.
 .PP
 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
 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
 -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
 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
 .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_PREFIX
-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
 .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
        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
 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]
 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
 <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