This is the mail archive of the cygwin-apps@cygwin.com mailing list for the Cygwin project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

ANNOUNCE: cygbug - generic bug reporting tool (like Debianreportbug)


This is 2nd version of the cygbug/reportbug utility for Cygwin.  It
has been modeled after Debian reportbug(1) and includes almost all its
features including A WNPP pseudo bug reports. See further below what
WNPPs are.

The program includes two bug interfaces. The basic one runs with:

    bash
    awk
    ssmtp       (i.e. you need working mail)
    + Your choice of editor: $VISUAL or $EDITOR

If emacs is installed, it uses:

    bash
    awk
    emacs       - $SMTPSERVER must point to outgoing mail server

AVAILABILITY 

wget --non-verbose  \
  http://tierra.dyndns.org:81/cygwin/cygbug/cygbug-20040422-1.tar.bz2 \
  http://tierra.dyndns.org:81/cygwin/cygbug/cygbug-20040422-1.tar.bz2.sig \
  http://tierra.dyndns.org:81/cygwin/cygbug/cygbug.txt \
  http://tierra.dyndns.org:81/cygwin/cygbug/setup.hint

Or use this:

mkdir cygbug ; cd cygbug
wget -q -O - http://tierra.dyndns.org:81/cygwin/cygbug/get.sh | sh
wget -q -O - http://tierra.dyndns.org:81/cygwin/gpgkey.txt | gpg --import


Please send comments and improvements by filing bug to cygbug itself :-/

    cygbug cygbug

See athe abve *.txt link for manual page. Snippets below.

Jari

-----------------------------------------------------------------------

[from README]

    A "bug" means several things, and it can be one of the following
    severity levels (you're are asked to select a value).

            critical, grave, serious, important, normal, minor, wishlist

        Get quick help:

            cygbug -h

        To list names of the packages where bugs can be reported to:

            cygbug -P

        To report 'normal' bug to Cygwin package maintainer:

            cygbug package

        To request and 'update' for a package when Cygwin includes older
        version than what is available upstream:

            cygbug -t update package
                   =========

        To attach files to bug report (include patches with .diff
        or .patch extension):

            cygbug -i INCLUDE-FILE-TO-BUG-REPORT [-i ...] package


-----------------------------------------------------------------------

[Part of the manual page]

  GENERIC NON-PACKAGE BUG REPORTS

    You can also compose standardized bug reports which can be sent to
    anyone. Suppose you're porting a new software to Cygwin, but you have
    troubles getting all the details working (compile fails, missing include
    files, system settings etc.) and you want to talk to the original author
    to present your problem. The author may not know Cygwin environment well
    and you normally need to include details of your environment. Like
    gcc(1) version, make(1) version, LC_ALL and other possible settings that
    may be important.

    There exists a pseudo package called "bug-generic" which you can use as
    a bug target. It behaves just like a regular package, but leaves many
    field open for you to fill. The bug id helps in tracking this case as
    well.

      $ cygbug [-i FILE ...] bug-generic


  WNPP REQUESTS
    These messages are only for subscribers of cygwin-app@ mailing
    list. A non-subscriber cannot send messages to cygwin-apps@ where these
    requests are directed.

    Work-Needing and Prospective Packages, WNPP for short, is a list of
    packages in need of new maintainers and prospective packages. In order
    to closely track the real status of such things a bug request against
    pseudo package WNPP is requested. (This is similar to Debian).

      $ cygbug wnpp
      WNPP type (itp, orphan, rfa, rfp, ?):

    The asked type of a WNPP request can be one of the following.

    itp This is 'Intent To Package'. You want to be maintainer of this
        package and you have possibly already made a package. Please submit
        a package description (setup.hint) along with copyright and
        package's URL and your source and binary package download URLs in
        such a report.

    orphan
        The package has been orphaned. Nobody is maintaining it. It needs a
        new maintainer as soon as possible.

    rfa This is a 'Request for Adoption'. Due to lack of time, resources,
        interest or something similar, the current maintainer is asking for
        someone else to maintain this package. He/she will maintain it in
        the meantime, but perhaps not in the best possible way. In short:
        the package needs a new maintainer.

    rfp This is a 'Request For Package'. You have found an interesting of
        software and would like SOMEONE ELSE to package and maintain it.
        Please submit a package description along with copyright and URL in
        such a report.

REPORT EXAMPLES

  MESSAGE TRACKING ID
    The template uses time based tracking id when typically includes package
    name and a colon. The time is in ISO 8601 format YYYYMMDD + "T" + HHMM
    (UTC).

        Subject: Cygwin-bug#20040313T1539 foo:

    At this time, Cygwin mailing list servers do not use the tracking id for
    anything. But for for you and for developers, the id help setting up
    possible mail filters to receive and track the message in question. In
    addition if you forward the messages to cygwin*@ lists, it will be easy
    to search them from the archived mail messages. The WNPP messages
    include slightly different subject including the TYPE code of the WNPP
    request.

        Subject: Cygwin-wnpp#20040313T1539 <TYPE>:

    Like if there is a request to hand the package to someone else:

        Subject: Cygwin-wnpp#20040313T1539 ORPHAN: foo -- don't have time

  STANDARD BUG REPORT
    The result of composed bug report in mail buffer look like this. The bug
    id's time string HHMM part after 'T' is in UTC.

        To: Cygwin port maintainer cvs - (Mr. Foo <foo <AT> example.net>)
        Cc: user list <cygwin <AT> cygwin.com>
        Subject: Cygwin-bug#20040313T1539 foo: Starting binary foo.exe gives error...
        --text follows this line--
        Package: foo
        Version: 1.11.6-3
        Status: installed
        Severity: normal

        I've just installed this package, but when I try to start
        it, it displays an error dialog where it read: "Cannot
        find xyz.dll in PATH". I'm sure I have set my PATH
        correctly and it's values it:

            ....

        Please advice,
        Martin

        -- System Information
        Release: 1.5.7 api 0.109 cvs cr-0x9e
        Kernel: Windows 2000 Professional Ver 5.0 Build 2195 Sp4
        Locale: LC_ALL=en_US

        -- Other package information
        Info-Pkg-devel-tools: gcc 3.3.1-3, make 3.80-1, libtool 1.5b-1
        Info-Pkg-lang: perl 5.8.2-1, python 2.3.3-1, ruby 1.8.1-1

        -- Environment information
        CYGWIN: tty ntsec binmode smbntsec

        <part filename=example.sh.gz disposition=attachment>
        <part>

        [ATTACHED FILE: Makefile.patch]
        ...

        [ATTACHED FILE: INSTALL.patch]
        ...

-- 
http://tiny-tools.sourceforge.net/
Swatch @time   http://www.mir.com.my/iTime/itime.htm
               http://www.ryanthiessen.com/swatch/resources.htm
Use Licenses!  http://www.linuxjournal.com/article.php?sid=6225
Which Licence? http://www.linuxjournal.com/article.php?sid=4825
OSI Licences   http://www.opensource.org/licenses/


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]