Fixes to the gacutil.1 man page Author: Bjarni Ingi Gislason --- --- a/man/gacutil.1 2024-05-20 02:55:02.033501074 +0000 +++ b/man/gacutil.1 2024-05-20 04:09:36.594636792 +0000 @@ -1,102 +1,146 @@ -..\" +.\" .\" gacutil manual page. .\" (C) 2004 Novell, Inc. .\" Author: .\" Miguel de Icaza (miguel@gnu.org) .\" .de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v +.if t .sp 0.5v .if n .sp .. .TH Mono "gacutil" .SH NAME gacutil \- Global Assembly Cache management utility. .SH SYNOPSIS -.PP -.B gacutil [-user] [command] [options] +.B gacutil +.RI [ \-user "] [" command "] [" options ] .SH DESCRIPTION \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 +Notice that they are not directly available to the compiler. +The convention is that assemblies must also be placed in a separate directory to be accessed by the compiler. This is done with the --package directive to gacutil. +\-package directive to gacutil. .PP The tool allows for installation, removal, and listing of the contents of the assembly cache. .PP The GAC is relative to the Mono installation prefix: mono_prefix/lib/mono. -.PP .SH COMMANDS -.I -i [-check_refs] [-package NAME] [-root ROOTDIR] [-gacdir GACDIR] +.\".I \-i [\-check_refs] [\-package NAME] [\-root ROOTDIR] [\-gacdir GACDIR] +.B \-i +.I +.RB [ \-check_refs "] [" \-package +.IR NAME ] +.RB [ \-root +.IR ROOTDIR ] +.RB [ \-gacdir +.IR GACDIR ] .Sp - Installs an assembly into the global assembly cache. -is the name of the file that contains the assembly manifest +Installs an assembly into the global assembly cache. + is the name of the file that contains the assembly manifest .Sp -The -package option can be used to also create a directory in in +The \-package option can be used to also create a directory in 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 to specify the "libdir" value of an installation +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, +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 included for backward compatibility but is not -recommended for new code. Use the -root option instead. +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 +The \-check_refs option is used to ensure that the assembly being installed into the GAC does not reference any non strong named -assemblies. Assemblies being installed to the GAC should not reference +assemblies. +Assemblies being installed to the GAC should not reference non strong named assemblies, however the is an optional check. -.fi .PP -.I "-l" [assembly_name] [-root ROOTDIR] [-gacdir GACDIR] +.\".I "\-l" [assembly_name] [\-root ROOTDIR] [\-gacdir GACDIR] +.br +.B \-l +.RI [ assembly_name ] +.RB [ \-root +.IR ROOTDIR ] +.RB [ \-gacdir +.IR GACDIR ] .Sp -Lists the contents of the global assembly cache. When the - parameter is specified only matching assemblies are +Lists the contents of the global assembly cache. +When the parameter is specified only matching assemblies are listed. .PP -.I "-u" [-package NAME] [-root ROOTDIR] [-gacdir GACDIR] +.\".I "\-u" [\-package NAME] [\-root ROOTDIR] [\-gacdir GACDIR] +.B \-u +.I +.RB [ \-package +.IR NAME ] +.RB [ \-root +.IR ROOTDIR ] +.RB [ \-gacdir +.IR GACDIR ] .Sp Uninstalls an assembly from the global assembly cache. is the name of the assembly (partial or -fully qualified) to remove from the global assembly cache. If a -partial name is specified all matching assemblies will be -uninstalled. As opposed to the install option that takes a filename, +fully qualified) to remove from the global assembly cache. +If a partial name is specified all matching assemblies will be +uninstalled. +As opposed to the install option that takes a filename, this takes as an argument the assembly name, which looks like this: .nf 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 -to quote them. +Notice that you can have spaces in the command line. +There is no need to quote them. .Sp -Performs a greedy removal. If you only specify one -component like, "MyLibrary.Something", it will remove all versions of -the library. +Performs a greedy removal. +If you only specify one component like, +"MyLibrary.Something", +it will remove all versions of the library. +.Sp +.\".I "\-us" [\-package NAME] [\-root ROOTDIR] [\-gacdir GACDIR] +.B \-us +.I +.RB [ \-package +.IR NAME ] +.RB [ \-root +.IR ROOTDIR ] +.RB [ \-gacdir +.IR GACDIR ] .Sp -.I "-us" [-package NAME] [-root ROOTDIR] [-gacdir GACDIR] Uninstalls an assembly using the specified assembly's full name. - is the path to an assembly. The full assembly name + 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 -option takes a file name, like this: +the GAC with a matching name, it is removed. +Unlike the \-u option this option takes a file name, like this: .nf - Example: -us myDll.dll + Example: \-us myDll.dll .fi .Sp -.I "-ul" [-package NAME] [-root ROOTDIR] [-gacdir GACDIR] +.\".I "\-ul" [\-package NAME] [\-root ROOTDIR] [\-gacdir GACDIR] +.B \-ul +.I +.RB [ \-package +.IR NAME ] +.RB [ \-root +.IR ROOTDIR ] +.RB [ \-gacdir +.IR GACDIR ] +.Sp Uninstalls one or more assemblies from the global assembly cache. is the path to a test file containing a list of assembly names on separate lines. .nf -Example -ul assembly_list.txt +Example \-ul assembly_list.txt .fi .nf assembly_list.txt contents: @@ -111,11 +155,10 @@ mint live. .PP /etc/mono/config, ~/.mono/config .PP -Mono runtime configuration file. See the mono-config(5) manual page -for more information. +Mono runtime configuration file. See the +.BR mono-config (5) +manual page for more information. .SH WEB SITE Visit: http://www.go-mono.com for details .SH SEE ALSO -.BR mcs(1), mono(1) - - +.BR mcs "(1), " mono(1)