Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "RAP Bug Reporting Howto"

Line 4: Line 4:
  
 
=== Check whether it's working with SWT / RCP ===
 
=== Check whether it's working with SWT / RCP ===
 +
 +
We provide strict subsets of SWT, JFace and Workbench bundles. Thus, things should work just as they do in SWT and RCP.
 +
If you find that RAP does not work as you expect in some point, please make sure that the same code works with SWT / RCP.
 +
If you see the same problem in the original, then it is not a RAP bug.
  
 
== Where to submit ==
 
== Where to submit ==
 +
 +
Start here: [http://www.eclipse.org/rap/bugs.php]
  
 
== What to Include in the Bug Report ==
 
== What to Include in the Bug Report ==
Line 40: Line 46:
 
     button.addSelectionListener( new SelectionAdapter() {
 
     button.addSelectionListener( new SelectionAdapter() {
 
   
 
   
      public void widgetSelected( SelectionEvent e ) {
+
      public void widgetSelected( SelectionEvent e ) {
          label.setText( "Button pressed" );
+
        label.setText( "Button pressed" );
 
       }
 
       }
 
     } );
 
     } );
Line 48: Line 54:
 
       if( !display.readAndDispatch() ) {
 
       if( !display.readAndDispatch() ) {
 
         display.sleep();
 
         display.sleep();
      }
+
      }
      }
+
    }
 
     return 0;
 
     return 0;
 
   }
 
   }

Revision as of 06:31, 31 August 2008

This page explains how to write useful bug reports for RAP

Before you submit a bug

Check whether it's working with SWT / RCP

We provide strict subsets of SWT, JFace and Workbench bundles. Thus, things should work just as they do in SWT and RCP. If you find that RAP does not work as you expect in some point, please make sure that the same code works with SWT / RCP. If you see the same problem in the original, then it is not a RAP bug.

Where to submit

Start here: [1]

What to Include in the Bug Report

Bug Description

The bug description should be as short and exact as possible. It should contain:

  • Your environment (operating system, browser type and version, RAP version)
  • The steps to reproduce the behavior described
  • The expected outcome / solution

Provide a Code Snippet

If the bug only occurs under certain circumstances, it's helpful if you can provide a snippet to reproduce.

  • The snippet should be as simple as possible.
  • The snippet should be self-contained (i.e. not rely on third-party code) and fit into one single class.
  • The snippet should be runnable without hacking, i.e. it should implement IEntryPoint.

Example:

public class ExampleSnippet implements IEntryPoint {

  public int createUI() {
    Display display = new Display();
    Shell shell = new Shell( display );
    shell.setLayout( new GridLayout() );
    
    final Label label = new Label( shell, SWT.PUSH );
    label.setText( "Label" );
    label.setLayoutData( new GridData( SWT.FILL, SWT.TOP, true, false ) );

    Button button = new Button( shell, SWT.PUSH );
    button.setText( "Test" );
    button.addSelectionListener( new SelectionAdapter() {

      public void widgetSelected( SelectionEvent e ) {
        label.setText( "Button pressed" );
      }
    } );

    while( !shell.isDisposed() ) {
      if( !display.readAndDispatch() ) {
        display.sleep();
      }
    }
    return 0;
  }
}

Provide a screenshot

Remember that we don't have your exact desktop environment and browser. If you describe some visual misbehavior, a screenshot helps us understand your problem.

The best image formats for screenshots is PNG or GIF. JPG is for photographs (is has lossy compression), uncompressed image formats like BMP, TIFF, etc. are just too big and take too long to download.

Back to the top