Added help menu item to copy bug report information to clipboard.

common/about_kicad.cpp

@@ -63,7 +63,16 @@ void InitKiCadAbout( wxAboutDialogInfo& info )
      * Check Operating System *
      **************************/
 #if defined __WINDOWS__
-    description << ( wxT( "on Windows" ) );
+
+    description << wxT( "on " );
+
+#if defined _WIN64
+    description << wxT( "64 bit" );
+#else
+    description << wxT( "32 bit" );
+#endif
+
+    description << wxT( " Windows" );
 
     /* Check for wxMAC */
 #	elif defined __WXMAC__
@@ -71,11 +80,11 @@ void InitKiCadAbout( wxAboutDialogInfo& info )
 
     /* Linux 64 bits */
 #	elif defined _LP64 && __LINUX__
-    description << ( wxT( "on 64 Bits GNU/Linux" ) );
+    description << ( wxT( "on 64 bit GNU/Linux" ) );
 
     /* Linux 32 bits */
 #	elif defined __LINUX__
-    description << ( wxT( "on 32 Bits GNU/Linux" ) );
+    description << ( wxT( "on 32 bit GNU/Linux" ) );
 
     /* OpenBSD */
 #	elif defined __OpenBSD__

common/basicframe.cpp

@@ -5,10 +5,12 @@
 
 #include <wx/aboutdlg.h>
 #include <wx/fontdlg.h>
+#include <wx/clipbrd.h>
+#include <wx/statline.h>
+#include <wx/aboutdlg.h>
+#include <wx/platinfo.h>
 
-#include "wx/statline.h"
-#include "wx/generic/aboutdlgg.h"
-
+#include "build_version.h"
 #include "fctsys.h"
 #include "appl_wxstruct.h"
 #include "common.h"
@@ -18,6 +20,8 @@
 #include "eda_doc.h"
 #include "wxstruct.h"
 #include "macros.h"
+#include "bitmaps.h"
+
 
 /*
  * Class constructor for WinEDA_BasicFrame general options
@@ -32,7 +36,7 @@ WinEDA_BasicFrame::WinEDA_BasicFrame( wxWindow* father,
 {
     wxSize minsize;
 
-    m_Ident  = idtype;
+    m_Ident          = idtype;
     m_HToolBar       = NULL;
     m_FrameIsActive  = TRUE;
 
@@ -53,6 +57,9 @@ WinEDA_BasicFrame::WinEDA_BasicFrame( wxWindow* father,
     m_FramePos.x   = m_FramePos.y = 0;
     m_FrameSize.y -= m_MsgFrameHeight;
 
+    Connect( ID_HELP_COPY_VERSION_STRING,
+             wxEVT_COMMAND_MENU_SELECTED,
+             wxCommandEventHandler( WinEDA_BasicFrame::CopyVersionInfoToClipboard ) );
 }
 
 
@@ -62,10 +69,10 @@ WinEDA_BasicFrame::~WinEDA_BasicFrame()
         delete wxGetApp().m_HtmlCtrl;
     wxGetApp().m_HtmlCtrl = NULL;
 
-    /* This needed for OSX: avoids furter OnDraw processing after this
+    /* This needed for OSX: avoids further OnDraw processing after this
      * destructor and before the native window is destroyed
      */
-    this->Freeze( );
+    this->Freeze();
 }
 
 
@@ -77,7 +84,7 @@ void WinEDA_BasicFrame::ReCreateMenuBar()
 
 }
 
-/** Vitual function SetLanguage
+/** Virtual function SetLanguage
  * called on a language menu selection
  * when using a derived function, do not forget to call this one
  */
@@ -124,7 +131,7 @@ void WinEDA_BasicFrame::LoadSettings()
     // Ensure Window title bar is visible
 #if defined( __WXMAC__ )
     // for macOSX, the window must be below system (macOSX) toolbar
-//    Ypos_min = GetMBarHeight(); seems no more exist in ne API (subject to change)
+//    Ypos_min = GetMBarHeight(); seems no more exist in new API (subject to change)
     Ypos_min = 20;
 #else
     Ypos_min = 0;
@@ -203,8 +210,7 @@ void WinEDA_BasicFrame::SetLastProject( const wxString& FullFileName )
 /*
  * Fetch the file name from the file history list.
  */
-wxString WinEDA_BasicFrame::GetFileFromHistory( int cmdId,
-                                                const wxString& type )
+wxString WinEDA_BasicFrame::GetFileFromHistory( int cmdId, const wxString& type )
 {
     wxString fn, msg;
     size_t   i;
@@ -254,8 +260,7 @@ void WinEDA_BasicFrame::GetKicadHelp( wxCommandEvent& event )
     }
     else
     {
-        msg.Printf( _( "Help file %s not found" ),
-                    GetChars( wxGetApp().m_HelpFileName ) );
+        msg.Printf( _( "Help file %s not found" ), GetChars( wxGetApp().m_HelpFileName ) );
         DisplayError( this, msg );
     }
 
@@ -285,3 +290,85 @@ void WinEDA_BasicFrame::GetKicadAbout( wxCommandEvent& WXUNUSED(event) )
     InitKiCadAbout(info);
     wxAboutBox(info);
 }
+
+
+void WinEDA_BasicFrame::AddHelpVersionInfoMenuEntry( wxMenu* aMenu )
+{
+    wxASSERT( aMenu != NULL );
+
+    wxMenuItem* item = NULL;
+
+    // Copy version string to clipboard for bug report purposes.
+    item = new wxMenuItem( aMenu, ID_HELP_COPY_VERSION_STRING,
+                           _( "Copy &Version Information" ),
+                           _( "Copy the version string to clipboard to send with bug reports" ) );
+
+    // For some reason images are not always added to the OSX menu items.  Anyone want
+    // to clarify as to why this is the case?  Putting this information in some formal
+    // developer notes would be helpful.  A good place to put this information would be
+    // ./documentation/guidelines/UIpolicies.txt.
+#if !defined( __WXMAC__ )
+    item->SetBitmap( copy_button );
+#endif
+
+    aMenu->Append( item );
+}
+
+
+void WinEDA_BasicFrame::CopyVersionInfoToClipboard( wxCommandEvent& WXUNUSED( event ) )
+{
+    if( !wxTheClipboard->Open() )
+    {
+        wxMessageBox( _( "Could not open clipboard to write version information." ),
+                      _( "Clipboard Error" ), wxOK | wxICON_EXCLAMATION, this );
+        return;
+    }
+
+    wxString tmp;
+    wxPlatformInfo info;
+
+    // This is an enhanced version of the compiler build macro provided by wxWidgets
+    // in <wx/build.h>. Please do not make any of these strings translatable.  They
+    // are used for conveying troubleshooting information to developers.
+#if defined(__GXX_ABI_VERSION)
+    #define __ABI_VERSION  ",compiler with C++ ABI " __WX_BO_STRINGIZE(__GXX_ABI_VERSION)
+#else
+    #define __ABI_VERSION  ",compiler without C++ ABI "
+#endif
+
+#if defined(__INTEL_COMPILER)
+    #define __BO_COMPILER ",Intel C++"
+#elif defined(__GNUG__)
+    #define __BO_COMPILER ",GCC " \
+            __WX_BO_STRINGIZE(__GNUC__) "." \
+            __WX_BO_STRINGIZE(__GNUC_MINOR__) "." \
+            __WX_BO_STRINGIZE(__GNUC_PATCHLEVEL__)
+#elif defined(__VISUALC__)
+    #define __BO_COMPILER ",Visual C++"
+#elif defined(__BORLANDC__)
+    #define __BO_COMPILER ",Borland C++"
+#elif defined(__DIGITALMARS__)
+    #define __BO_COMPILER ",DigitalMars"
+#elif defined(__WATCOMC__)
+    #define __BO_COMPILER ",Watcom C++"
+#else
+    #define __BO_COMPILER ",unknown"
+#endif
+
+#define KICAD_BUILD_OPTIONS_SIGNATURE \
+    " (" __WX_BO_DEBUG "," __WX_BO_UNICODE \
+     __ABI_VERSION __BO_COMPILER \
+     __WX_BO_STL \
+     __WX_BO_WXWIN_COMPAT_2_4 __WX_BO_WXWIN_COMPAT_2_6 \
+     ")"
+
+    tmp = wxT( "Application: " ) + wxGetApp().GetTitle() + wxT( "\n" );
+    tmp += wxT( "Version: " ) + GetBuildVersion() + wxT( "\n" );
+    tmp << wxT( "Build: " ) << wxVERSION_STRING
+        << wxT( KICAD_BUILD_OPTIONS_SIGNATURE ) << wxT( "\n" )
+        << wxT( "Platform: " ) << wxGetOsDescription() << wxT( ", " )
+        << info.GetArchName() << wxT( ", " ) << info.GetEndiannessName() << wxT( ", " )
+        << info.GetPortIdName();
+    wxTheClipboard->SetData( new wxTextDataObject( tmp ) );
+    wxTheClipboard->Close();
+}

cvpcb/menucfg.cpp

@@ -31,10 +31,9 @@ void WinEDA_CvpcbFrame::ReCreateMenuBar()
    /* Open Recent submenu */
     wxMenu* openRecentMenu = new wxMenu();
     wxGetApp().m_fileHistory.AddFilesToMenu( openRecentMenu );
-    ADD_MENUITEM_WITH_HELP_AND_SUBMENU( filesMenu, openRecentMenu,
-                                          -1, _( "Open &Recent" ),
-                     _("Open a recent opened netlist document" ),
-                                               open_project_xpm );
+    ADD_MENUITEM_WITH_HELP_AND_SUBMENU( filesMenu, openRecentMenu, -1, _( "Open &Recent" ),
+                                        _("Open a recent opened netlist document" ),
+                                        open_project_xpm );
 
 
 
@@ -49,8 +48,7 @@ void WinEDA_CvpcbFrame::ReCreateMenuBar()
 #if !defined(__WXMAC__)
 
     filesMenu->AppendSeparator();
-    item = new wxMenuItem( filesMenu, wxID_EXIT, _( "&Quit" ),
-                           _( "Quit CvPCB" ) );
+    item = new wxMenuItem( filesMenu, wxID_EXIT, _( "&Quit" ), _( "Quit CvPCB" ) );
     filesMenu->Append( item );
 
 #endif /* !defined( __WXMAC__) */
@@ -78,6 +76,9 @@ void WinEDA_CvpcbFrame::ReCreateMenuBar()
 
     // Menu Help:
     wxMenu* helpMenu = new wxMenu;
+
+    AddHelpVersionInfoMenuEntry( helpMenu );
+
     item = new wxMenuItem( helpMenu, ID_GENERAL_HELP, _( "&Contents" ),
                            _( "Open the cvpcb manual" ) );
     item->SetBitmap( online_help_xpm );
@@ -105,4 +106,3 @@ void WinEDA_CvpcbFrame::ReCreateMenuBar()
      * rebuilt.  This allows language changes of the menu text on the fly. */
     SetMenuBar( menuBar );
 }
-

eeschema/menubar_libedit.cpp

@@ -119,9 +119,9 @@ void WinEDA_LibeditFrame::ReCreateMenuBar()
      * we cannot add hotkey info here, because the hotkey HK_ZOOM_IN and HK_ZOOM_OUT
      * events(default = WXK_F1 and WXK_F2) are *NOT* equivalent to this menu command:
      * zoom in and out from hotkeys are equivalent to the pop up menu zoom
-     * From here, zoomming is made around the screen center
-     * From hotkeys, zoomming is made around the mouse cursor position
-     * (obvioulsy not possible from the toolbat or menubar command)
+     * From here, zooming is made around the screen center
+     * From hotkeys, zooming is made around the mouse cursor position
+     * (obviously not possible from the toolbar or menubar command)
      *
      * in others words HK_ZOOM_IN and HK_ZOOM_OUT *are NOT* accelerators
      * for Zoom in and Zoom out sub menus
@@ -228,7 +228,7 @@ void WinEDA_LibeditFrame::ReCreateMenuBar()
 #if 0   // work in progress. activated when finished
 /* Dimension */
     item = new wxMenuItem( configmenu, ID_LIBEDIT_DIMENSIONS, _( "&Dimensions" ),
-                           _( "Tickness of graphic lines, texts sizes and others" ) );
+                           _( "Thickness of graphic lines, texts sizes and others" ) );
     item->SetBitmap( add_dimension_xpm );
     configmenu->Append( item );
 #endif
@@ -257,6 +257,9 @@ void WinEDA_LibeditFrame::ReCreateMenuBar()
      * Help Menu
      */
     wxMenu* helpMenu = new wxMenu;
+
+    AddHelpVersionInfoMenuEntry( helpMenu );
+
     item = new wxMenuItem( helpMenu, ID_GENERAL_HELP, _( "&Contents" ),
                            _( "Open the eeschema manual" ) );
     item->SetBitmap( online_help_xpm );

gerbview/tool_gerber.cpp

@@ -118,6 +118,7 @@ void WinEDA_GerberFrame::ReCreateMenuBar( void )
 
     // Menu Help:
     wxMenu* helpMenu = new wxMenu;
+    AddHelpVersionInfoMenuEntry( helpMenu );
     ADD_MENUITEM_WITH_HELP( helpMenu, ID_GENERAL_HELP, _( "&Contents" ),
                             _( "Open the gerbview manual" ), help_xpm );
     ADD_MENUITEM_WITH_HELP( helpMenu, ID_KICAD_ABOUT, _( "&About Gerbview" ),
@@ -161,7 +162,7 @@ void WinEDA_GerberFrame::ReCreateHToolbar( void )
 
     // Set up toolbar
     m_HToolBar->AddTool( ID_NEW_BOARD, wxEmptyString,
-                          wxBitmap( new_xpm ),
+                         wxBitmap( new_xpm ),
                          _( "New world" ) );
 
     m_HToolBar->AddTool( wxID_FILE, wxEmptyString,
@@ -262,8 +263,7 @@ void WinEDA_GerberFrame::ReCreateVToolbar( void )
     m_VToolBar = new WinEDA_Toolbar( TOOLBAR_TOOL, this, ID_V_TOOLBAR, FALSE );
 
     // Set up toolbar
-    m_VToolBar->AddTool( ID_NO_SELECT_BUTT, wxEmptyString,
-                         wxBitmap( cursor_xpm ) );
+    m_VToolBar->AddTool( ID_NO_SELECT_BUTT, wxEmptyString, wxBitmap( cursor_xpm ) );
     m_VToolBar->ToggleTool( ID_NO_SELECT_BUTT, TRUE );
     m_VToolBar->AddSeparator();
     m_VToolBar->AddTool( ID_GERBVIEW_DELETE_ITEM_BUTT, wxEmptyString,
@@ -285,11 +285,10 @@ void WinEDA_GerberFrame::ReCreateOptToolbar( void )
     wxWindowUpdateLocker dummy(this);
 
     // creation of tool bar options
-    m_OptionsToolBar = new WinEDA_Toolbar( TOOLBAR_OPTION, this,
-                                           ID_OPT_TOOLBAR, FALSE );
+    m_OptionsToolBar = new WinEDA_Toolbar( TOOLBAR_OPTION, this, ID_OPT_TOOLBAR, FALSE );
 
     m_OptionsToolBar->AddTool( ID_TB_OPTIONS_SHOW_GRID, wxEmptyString,
-                                wxBitmap( grid_xpm ),
+                               wxBitmap( grid_xpm ),
                                _( "Turn grid off" ), wxITEM_CHECK );
 
     m_OptionsToolBar->AddTool( ID_TB_OPTIONS_SHOW_POLAR_COORD, wxEmptyString,
@@ -329,11 +328,10 @@ void WinEDA_GerberFrame::ReCreateOptToolbar( void )
     // Tools to show/hide toolbars:
     m_OptionsToolBar->AddSeparator();
     m_OptionsToolBar->AddTool( ID_TB_OPTIONS_SHOW_LAYERS_MANAGER_VERTICAL_TOOLBAR,
-                                    wxEmptyString,
-                                    wxBitmap( layers_manager_xpm ),
-                                    _(
-                                    "Show/hide the layers manager toolbar" ),
-                                    wxITEM_CHECK );
+                               wxEmptyString,
+                               wxBitmap( layers_manager_xpm ),
+                               _( "Show/hide the layers manager toolbar" ),
+                               wxITEM_CHECK );
 
 
     m_OptionsToolBar->Realize();

include/id.h

@@ -71,6 +71,7 @@ enum main_id
     ID_AUX_TOOLBAR,
 
     ID_GENERAL_HELP,
+    ID_HELP_COPY_VERSION_STRING,
     ID_LOCAL_HELP,
     ID_KICAD_ABOUT,
 
@@ -218,10 +219,10 @@ enum main_id
     ID_TB_OPTIONS_SHOW_ZONES_DISABLE,
     ID_TB_OPTIONS_SHOW_ZONES_OUTLINES_ONLY,
 
-	ID_TB_OPTIONS_HIDDEN_PINS,
+    ID_TB_OPTIONS_HIDDEN_PINS,
     ID_TB_OPTIONS_BUS_WIRES_ORIENT,
     ID_TB_OPTIONS_SHOW_PADS_SKETCH,
-	ID_TB_OPTIONS_SHOW_VIAS_SKETCH,
+    ID_TB_OPTIONS_SHOW_VIAS_SKETCH,
     ID_TB_OPTIONS_SHOW_TRACKS_SKETCH,
     ID_TB_OPTIONS_SHOW_MODULE_TEXT_SKETCH,
     ID_TB_OPTIONS_SHOW_MODULE_EDGE_SKETCH,

include/wxstruct.h

@@ -110,8 +110,20 @@ public:
 
     void         GetKicadHelp( wxCommandEvent& event );
     void         GetKicadAbout( wxCommandEvent& event );
+
+    /**
+     * Copy the version information to the clipboard for bug reporting purposes.
+     */
+    void         CopyVersionInfoToClipboard( wxCommandEvent& event );
     void         PrintMsg( const wxString& text );
 
+    /**
+     * Append the copy version information to clipboard help menu entry to \a aMenu.
+     *
+     * @param aMenu - The menu to append.
+     */
+    void         AddHelpVersionInfoMenuEntry( wxMenu* aMenu );
+
     virtual void LoadSettings();
     virtual void SaveSettings();
 
@@ -148,7 +160,7 @@ public:
     WinEDA_Toolbar*   m_AuxVToolBar;        // Auxiliary Vertical (right side)
                                             // Toolbar
     WinEDA_Toolbar*   m_OptionsToolBar;     // Options Toolbar (left side)
-    WinEDA_Toolbar*   m_AuxiliaryToolBar;   // Auxiliay Toolbar used in pcbnew
+    WinEDA_Toolbar*   m_AuxiliaryToolBar;   // Auxiliary Toolbar used in pcbnew
 
     WinEDAChoiceBox*  m_SelGridBox;         // Choice box to choose the grid
                                             // size
@@ -254,9 +266,9 @@ public:
      */
     virtual void     SetToolID( int aId, int aCursor, const wxString& aToolMsg );
 
-    /* Thes 4 functions provide a basic way to sho/hide grid
+    /* These 4 functions provide a basic way to show/hide grid
      * and /get/set grid color.
-     * thes parameters are saved in kicad config for each main frame
+     * These parameters are saved in kicad config for each main frame
      */
     /** Function IsGridVisible() , virtual
      * @return true if the grid must be shown
@@ -425,8 +437,8 @@ public:
      * @param aData = a pointer on an auxiliary data (not always used, NULL if not used)
      */
     virtual void PrintPage( wxDC* aDC, bool aPrint_Sheet_Ref,
-                    int aPrintMask, bool aPrintMirrorMode,
-                    void * aData = NULL);
+                            int aPrintMask, bool aPrintMirrorMode,
+                            void * aData = NULL);
 
     DECLARE_EVENT_TABLE();
 };
@@ -520,7 +532,7 @@ public:
      * Append a message to the message panel.
      *
      * This method automatically adjusts for the width of the text string.
-     * Making consectutive calls to AppendMessage will append each message
+     * Making consecutive calls to AppendMessage will append each message
      * to the right of the last message.  This message is not compatible
      * with Affiche_1_Parametre.
      *
@@ -730,7 +742,7 @@ class WinEDA_Toolbar : public wxAuiToolBar
 public:
     wxWindow*       m_Parent;
     id_toolbar      m_Ident;
-    bool            m_Horizontal;       // some auxilary TB are horizontal, others vertical
+    bool            m_Horizontal;       // some auxiliary TB are horizontal, others vertical
 
 public:
     WinEDA_Toolbar( id_toolbar type, wxWindow* parent,

kicad/menubar.cpp

@@ -167,7 +167,7 @@ void WinEDA_MainFrame::ReCreateMenuBar()
 
     /* Text editor */
     item = new wxMenuItem( browseMenu, ID_TO_EDITOR, _( "Text E&ditor" ),
-                           _( "Open prefered text editor" ) );
+                           _( "Open preferred text editor" ) );
 #if !defined( __WXMAC__ )
     item->SetBitmap( editor_xpm );
 #endif /* !defined( __WXMAC__ ) */
@@ -194,7 +194,7 @@ void WinEDA_MainFrame::ReCreateMenuBar()
     /* Text editor */
     item = new wxMenuItem( PreferencesMenu, ID_SELECT_PREFERED_EDITOR,
                            _( "&Text Editor" ),
-                           _( "Select your prefered text editor" ) );
+                           _( "Select your preferred text editor" ) );
 #if !defined( __WXMAC__ )
     item->SetBitmap( editor_xpm );
 #endif /* !defined( __WXMAC__ ) */
@@ -264,9 +264,12 @@ void WinEDA_MainFrame::ReCreateMenuBar()
      */
     wxMenu* helpMenu = new wxMenu;
 
+    AddHelpVersionInfoMenuEntry( helpMenu );
+
     /* Contents */
     item = new wxMenuItem( helpMenu, ID_GENERAL_HELP, _( "&Contents" ),
                            _( "Open the kicad manual" ) );
+
 #if !defined( __WXMAC__ )
     item->SetBitmap( online_help_xpm );
 #endif /* !defined( __WXMAC__ ) */
@@ -343,4 +346,3 @@ void WinEDA_MainFrame::RecreateBaseHToolbar()
     /* Create m_HToolBar */
     m_HToolBar->Realize();
 }
-

pcbnew/menubar_pcbframe.cpp

@@ -196,7 +196,7 @@ void WinEDA_PcbFrame::ReCreateMenuBar()
 
     /* Print */
     item = new wxMenuItem( filesMenu, wxID_PRINT, _( "&Print" ),
-                           _( "Print pcb board" ) );
+                           _( "Print board" ) );
     item->SetBitmap( print_button );
     filesMenu->Append( item );
 
@@ -235,8 +235,7 @@ void WinEDA_PcbFrame::ReCreateMenuBar()
 #if !defined( __WXMAC__ )
 
     filesMenu->AppendSeparator();
-    item = new wxMenuItem( filesMenu, wxID_EXIT, _( "&Quit" ),
-                           _( "Quit PCBNew" ) );
+    item = new wxMenuItem( filesMenu, wxID_EXIT, _( "&Quit" ), _( "Quit PCBNew" ) );
     item->SetBitmap( exit_xpm );
     filesMenu->Append( item );
 
@@ -306,9 +305,9 @@ void WinEDA_PcbFrame::ReCreateMenuBar()
      * we cannot add hotkey info here, because the hotkey HK_ZOOM_IN and HK_ZOOM_OUT
      * events(default = WXK_F1 and WXK_F2) are *NOT* equivalent to this menu command:
      * zoom in and out from hotkeys are equivalent to the pop up menu zoom
-     * From here, zoomming is made around the screen center
-     * From hotkeys, zoomming is made around the mouse cursor position
-     * (obvioulsy not possible from the toolbat or menubar command)
+     * From here, zooming is made around the screen center
+     * From hotkeys, zooming is made around the mouse cursor position
+     * (obviously not possible from the toolbar or menubar command)
      *
      * in others words HK_ZOOM_IN and HK_ZOOM_OUT *are NOT* accelerators
      * for Zoom in and Zoom out sub menus
@@ -487,6 +486,9 @@ void WinEDA_PcbFrame::ReCreateMenuBar()
      * Help menu
      */
     wxMenu* helpMenu = new wxMenu;
+
+    AddHelpVersionInfoMenuEntry( helpMenu );
+
     item = new wxMenuItem( helpMenu, ID_GENERAL_HELP, _( "&Contents" ),
                            _( "Open the PCBnew manual" ) );
     item->SetBitmap( online_help_xpm );