New test.

[mono.git] / man / sn.1

diff --git a/man/sn.1 b/man/sn.1
old mode 100755 (executable)
new mode 100644 (file)
index b26ed9b..7ab6190
--- a/man/sn.1
+++ b/man/sn.1
@@ -1,7 +1,7 @@
 .\" 
 .\" sn manual page.
 .\" Copyright 2003 Motus Technologies
-.\" Copyright 2004 Novell
+.\" Copyright (C) 2004-2005 Novell, Inc (http://www.novell.com)
 .\" Author:
 .\"   Sebastien Pouliot <sebastien@ximian.com>
 .\"
@@ -57,8 +57,8 @@ Export the public key from the specified CSP container to the specified file.
 Export the assembly public key to the specified output file.
 .TP
 .I "-p keypair.snk output.pub"
-Export the public key from the specified strongname key file (SNK) to the 
-specified output file.
+Export the public key from the specified strongname key file (SNK) or from
+a PKCS#12/PFX password protected file to the specified output file.
 .TP
 .I "-o input output.txt"
 Convert the input file to a CSV file (using decimal).
@@ -71,15 +71,19 @@ Convert the input file to a CSV file (using hexadecimal).
 Compare if assembly1 and assembly are the same exception for their signature.
 This is done by comparing the hash of the metadata of both assembly.
 .TP
-.I "-k keypair.snk"
-Create a new strongname keypair (a 1024 bits RSA keypair) in the specified 
-file.
+.I "-k [size] keypair.snk"
+Create a new strongname keypair in the specified file. The default key 
+length is 1024 bits and MUST ALWAYS be used when signing 1.x assemblies. 
+Any value from 384 to 16384 bits (in increments of 8 bits) is a valid key 
+length to sign 2.x assemblies. To ensure maximum compatibility you may 
+want to continue using 1024 bits keys. Note that there's no good reason, 
+even if it's possible, to use length lesser than 1024 bits.
 .TP
 .I "-R assembly keypair.snk"
 Resign the specified assembly using the specified strongname keypair file 
-(SNK). You can only sign an assembly with the private key (SNK) that match 
-the public key inside the assembly (unless it's public key token has been
-remapped in machine.config).
+(SNK) or a PKCS#12/PFX password protected file. You can only sign an 
+assembly with the private key that match the public key inside the assembly
+(unless it's public key token has been remapped in machine.config).
 .TP
 .I "-Rc assembly container"
 Resign the specified assembly using the specified strongname container.