sf-upload

Man page

NAME
    sf-upload - batch release of SourceForge projects.

SYNOPSIS
        sf-upload -pr projectname -p packagename -r releasename -f file
              [-type type] [-processor processor] [-user user] [-password password]
              [-d releasedate]
              [-n notes | -nf notesfile] [-c changes | -cf changesfile]
              [-[no]ftp] [-[no]rc] [-[no]v] [-version]

DESCRIPTION
    sf-upload is a script which automates the process of uploading and
    releasing a file to SourceForge.

  ARGUMENTS
    -pr|-project projectname
        short (unix) name of the project

    -p|-package packagename
        (existing) package name

    -r|-release releasename
        name of new release (usually version number)

    -f|-file filename
        filename of uploaded package

    -type type
        type of uploaded filename (default: guess)

    -processor processor
        processor type (default: Any)

    -user user
        SourceForge user name

    -password password
        SourceForge password

    -n|notes notes
        release notes

    -nf|notesfile notesfile
        get release notes from named file

    -c|changes changes
        release changes

    -cf|changesfile changesfile
        get release changes from named file

    -[no]ftp
        upload/do not upload file (default: -ftp)

    -[no]rc
        read/do not read rc file (usually ~/.sfuploadrc) (default: -rc)

    -[no]v
        be/do not be verbose (default: -v)

    -version
        show version and exit

FILES
    ~/.sfuploadrc
        You can put configuration options to this file. The format is

            key = value

        Allowed keys are: "user", "password", and "debug".

PREREQUISITES
    "LWP::UserAgent", "HTML::Parser", "Crypt::SSLeay"

OSNAMES
    only tested on Unix

SCRIPT CATEGORIES
    ???

EXAMPLE
    You can put the following rule to a perl-styled "Makefile.PL":

      sub MY::postamble {
        <<'EOF';
      release:
              sf-upload -pr unix_name_of_project -p name_of_package -f $(DISTVNAME).tar$(SUFFIX)
      EOF
      }

    For a project using "configure" and "Makefile.in", put the following
    rule to "Makefile.in":

      release:
              sf-upload -pr unix_name_of_project -p name_of_package -f $(DISTROOT)/$(DISTNAME).tar.gz

    Then, releasing a distribution would just be

      make dist
      make release

AVAILABILITY
    "sf-upload" is available from
    .

AUTHOR
    Slaven Rezic 

SEE ALSO
    cpan-upload(1).

README

sf-upload
---------

DESCRIPTION

Batch release of SourceForge projects.

INSTALLATION

    perl Makefile.PL
    make all test install

You need some perl module prerequisites, namely libwww, Crypt::SSLeay
and HTML::Parser. You can get the modules from http://www.cpan.org or,
better, fetch and install the modules automatically with

    perl prereqinst

If you're on Windows and you have ActivePerl installed, then you
should try instead

    perl prereqinst -ppm

Note that all installing actions ("make install" and "perl
prereqinst") should be executed as superuser.

USAGE

Create a configuration file named .sfuploadrc in your home directory.
Put your SourceForge user name and password to the file:

user = myusername
password = mypassword

If you do not put the password into the configuration file, then you
can specify the -password option in the command line, or you will
be prompted interactively.

To upload a file and start the release process, just type:

    sf-upload -pr projectname -p packagename -r releasename -f file    

To see the complete list of options, type

    sf-upload -\?

The most common (source) file type are guessed by extension, otherwise
you have to set the -type option. Also, the processor type is by
default "Any" but can be changed with the -processor option.

For more information, refer to the man page (after installation) or by
using

    perldoc sf-upload

AUTHOR

    Slaven Rezic