diff -urN a/package-upload.html b/package-upload.html --- a/package-upload.html 2014-09-30 17:24:48.000000000 -0400 +++ b/package-upload.html 2015-05-31 17:04:19.000000000 -0400 @@ -21,7 +21,10 @@

Requesting upload privileges

-Send your public ssh key to the cygwin-apps using this format:
    Subject: SSH key for upload access
+
+

Send your public ssh key to the cygwin-apps using this format:

+ +
    Subject: SSH key for upload access
 
     Name: Your Name
     Package: The name of one (and only one) of the packages that you are responsible for
@@ -30,26 +33,56 @@
     ---- END SSH2 PUBLIC KEY ----
 
-When specifying your name, use your exact name as shown at http://cygwin.com/cygwin-pkg-maint.
+

When specifying your name, use your exact name as shown at http://cygwin.com/cygwin-pkg-maint.
Specifying one package provides you with the ability to upload -any of your packages from http://cygwin.com/cygwin-pkg-maint. +any of your packages from http://cygwin.com/cygwin-pkg-maint.

The SSH key above should be generated from one of your public keys, e.g.:

    ssh-keygen -e -f ~/.ssh/id_rsa.pub

-The format of this email is not optional. It is read by a program so please +

The format of this email is not optional. It is read by a program so please do not deviate from the above. In particular, don't indent, don't add multiple packages, and do use your name as -recorded in http://cygwin.com/cygwin-pkg-maint. +recorded in http://cygwin.com/cygwin-pkg-maint.

Note: Send email in this format if you need to update your ssh key.

Requests are handled manually and are acknowledged publicly in response to email to the cygwin-apps mailing list.

-

Uploading Files to cygwin.com

-Once the ssh key has been installed you'll have limited + +

Connecting to cygwin.com

+ +

Once the ssh key has been installed you'll have limited sftp -access to cygwin.com where you will be able to upload packages. An -upload directory on cygwin.com will look like this: +access to cygwin.com, where you will be able to upload packages. You may connect for example by +sftp cygwin@cygwin.com, or using lftp as in the example below. When connecting, +make sure that you use the user cygwin with no password, and that you are using the +same ssh key as the one that you specified previously.

+ +

The first time you connect, you should verify that the host key fingerprint matches one of +the following hashes:

+ + + +

Uploading Files

+ +There are two ways to upload finished packages to cygwin.com. + +

Using cygport

+ +

If you have a cygport build script for your +packages, the easiest way to upload your finished packages is just to run:

+ +

    cygport pkg.cygport up
+ +

That will upload your finished packages, taking care of all of the details described in the manual method below.

+ +

Manually

+ +

You may also upload files directly, using an sftp client such as sftp or lftp. An upload +directory on cygwin.com will look like this:

     Your Name                   # Directory is currently your full name (you won't actually see this)
@@ -60,11 +93,7 @@
            pkg-debuginfo        # package subdirectories
 
-

When connecting, make sure that you use the user cygwin with -no password and that you are using the same ssh key as the one that you -specified previously.

- -

Example using lftp to upload packages: +

Example using lftp to upload packages:

     % lftp sftp://cygwin@cygwin.com
@@ -140,7 +169,9 @@
 uploaded packages.  It doesn't matter where you create this file but
 it makes sense to put it at the root of your upload directory.

-

Example lftp upload command line

    From: Christopher Faylor
+

Example lftp upload command line

+ +
    From: Christopher Faylor
     To: cygwin-apps
     Subject: Re: The upload system is live (Re: Major changes coming to
             procedure for uploading to sourceware)
@@ -155,6 +186,7 @@
     
     cgf
 
+

Removing files from the Cygwin distribution

To cause files to be removed from the distribution, upload an empty file with the name of the file that you want deleted, prefixed with a "-".