*) Add KIFACE_I::StartFlags() and IsSingle() so a KIFACE implementation can know

if it is running under single_top.cpp or under a project manager. *) Test Kiface().IsSingle() when adding menus, some operations are not permitted when running under a project manager and the KIWAY_PLAYER is pegged to a specific project. *) Implemented KIWAY::KiFACE() so it loads *.kiface files. They still have to be in the same directory as the main *.exe launcher, so this presents some difficulty when the binaries are not yet installed but rather the *.kiface files are still in their original build directories. For today, I simply copied _pcbnew.kiface to build/kicad/. *) Add a test case to kicad/mainframe.cpp just to get an early peek at loading _pcbnew.kiface under the C++ project manager. Got that working for one specific invocation just for proof of concept. Surprise, it works.

*) Add KIFACE_I::StartFlags() and IsSingle() so a KIFACE implementation can know
if it is running under single_top.cpp or under a project manager. *) Test Kiface().IsSingle() when adding menus, some operations are not permitted when running under a project manager and the KIWAY_PLAYER is pegged to a specific project. *) Implemented KIWAY::KiFACE() so it loads *.kiface files. They still have to be in the same directory as the main *.exe launcher, so this presents some difficulty when the binaries are not yet installed but rather the *.kiface files are still in their original build directories. For today, I simply copied _pcbnew.kiface to build/kicad/. *) Add a test case to kicad/mainframe.cpp just to get an early peek at loading _pcbnew.kiface under the C++ project manager. Got that working for one specific invocation just for proof of concept. Surprise, it works.
5f65d0da · Dick Hollenbeck · e52d9342 · 5f65d0da · 5f65d0da · 5f65d0da
Commit 5f65d0da authored Apr 18, 2014 by Dick Hollenbeck
30 changed files
--- a/bitmap2component/bitmap2cmp_gui.cpp
+++ b/bitmap2component/bitmap2cmp_gui.cpp
@@ -639,7 +639,7 @@ namespace BMP2CMP {
 static struct IFACE : public KIFACE_I
 {
-    bool OnKifaceStart( PGM_BASE* aProgram );
+    bool OnKifaceStart( PGM_BASE* aProgram, int aCtlBits );
    wxWindow* CreateWindow( wxWindow* aParent, int aClassId, KIWAY* aKiway, int aCtlBits = 0 )
    {
@@ -706,8 +706,8 @@ PGM_BASE& Pgm()
 #endif
-bool IFACE::OnKifaceStart( PGM_BASE* aProgram )
+bool IFACE::OnKifaceStart( PGM_BASE* aProgram, int aCtlBits )
 {
-    return start_common();
+    return start_common( aCtlBits );
 }
--- a/common/CMakeLists.txt
+++ b/common/CMakeLists.txt
@@ -186,6 +186,7 @@ set( COMMON_SRCS
    msgpanel.cpp
    netlist_keywords.cpp
    newstroke_font.cpp
+    prependpath.cpp
    project.cpp
    ptree.cpp
    reporter.cpp

--- a/common/kiface_i.cpp
+++ b/common/kiface_i.cpp
@@ -94,8 +94,10 @@ static void setSearchPaths( SEARCH_STACK* aDst, KIWAY::FACE_T aId )
 }
-bool KIFACE_I::start_common()
+bool KIFACE_I::start_common( int aCtlBits )
 {
+    m_start_flags = aCtlBits;
    m_bm.Init();
    m_bm.m_config->Read( showPageLimitsKey, &g_ShowPageLimits );

--- a/common/kiway.cpp
+++ b/common/kiway.cpp
@@ -22,15 +22,12 @@
 * 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA
 */
+#include <string.h>
 #include <kiway.h>
 #include <config.h>
 #include <wx/debug.h>
-#include <string.h>
+#include <wx/stdpaths.h>
-// one for each FACE_T
-wxDynamicLibrary KIWAY::s_sch_dso;
-wxDynamicLibrary KIWAY::s_pcb_dso;
 KIWAY::KIWAY()
@@ -39,20 +36,30 @@ KIWAY::KIWAY()
 }
-/*
+const wxString KIWAY::dso_full_path( FACE_T aFaceId )
-const wxString KIWAY::dso_name( FACE_T aFaceId )
 {
+    const wxChar*   name = wxT("");
    switch( aFaceId )
    {
-    case FACE_SCH:  return KIFACE_PREFIX wxT( "eeschema" ) KIFACE_SUFFIX;
+    case FACE_SCH:  name = KIFACE_PREFIX wxT( "eeschema" );     break;
-    case FACE_PCB:  return KIFACE_PREFIX wxT( "pcbnew"   ) KIFACE_SUFFIX;
+    case FACE_PCB:  name = KIFACE_PREFIX wxT( "pcbnew"   );     break;
    default:
        wxASSERT_MSG( 0, wxT( "caller has a bug, passed a bad aFaceId" ) );
        return wxEmptyString;
    }
+    wxFileName fn = wxStandardPaths::Get().GetExecutablePath();
+    fn.SetName( name );
+    // Here a "suffix" == an extension with a preceding '.',
+    // so skip the preceding '.' to get an extension
+    fn.SetExt( KIFACE_SUFFIX + 1 );         // + 1 => &KIFACE_SUFFIX[1]
+    return fn.GetFullPath();
 }
-*/
 PROJECT& KIWAY::Prj() const
@@ -61,14 +68,15 @@ PROJECT& KIWAY::Prj() const
 }
-KIFACE*  KIWAY::KiFACE( FACE_T aFaceId, bool doLoad )
+KIFACE*  KIWAY::KiFACE( PGM_BASE* aProgram, FACE_T aFaceId, bool doLoad )
 {
    switch( aFaceId )
    {
-    case FACE_SCH:
+    // case FACE_SCH:
    case FACE_PCB:
        if( m_kiface[aFaceId] )
            return m_kiface[aFaceId];
+        break;
    default:
        wxASSERT_MSG( 0, wxT( "caller has a bug, passed a bad aFaceId" ) );
@@ -78,17 +86,47 @@ KIFACE*  KIWAY::KiFACE( FACE_T aFaceId, bool doLoad )
    // DSO with KIFACE has not been loaded yet, does user want to load it?
    if( doLoad  )
    {
-        switch( aFaceId )
+        wxString dname = dso_full_path( aFaceId );
+        wxDynamicLibrary dso;
+        void*   addr = NULL;
+        if( !dso.Load( dname, wxDL_VERBATIM | wxDL_NOW ) )
        {
-        case FACE_SCH:
+            // Failure: error reporting UI was done via wxLogSysError().
-            break;
+            // No further reporting required here.
+        }
-        case FACE_PCB:
+        else if( ( addr = dso.GetSymbol( wxT( KIFACE_INSTANCE_NAME_AND_VERSION ) ) ) == NULL )
-            break;
+        {
+            // Failure: error reporting UI was done via wxLogSysError().
+            // No further reporting required here.
+        }
-        default:
+        else
-            ;
+        {
+            KIFACE_GETTER_FUNC* getter = (KIFACE_GETTER_FUNC*) addr;
+            KIFACE* kiface = getter( &m_kiface_version[aFaceId], KIFACE_VERSION, aProgram );
+            // KIFACE_GETTER_FUNC function comment (API) says the non-NULL is unconditional.
+            wxASSERT_MSG( kiface,
+                wxT( "attempted DSO has a bug, failed to return a KIFACE*" ) );
+            // Give the DSO a single chance to do its "process level" initialization.
+            // "Process level" specifically means stay away from any projects in there.
+            if( kiface->OnKifaceStart( aProgram, KFCTL_PROJECT_SUITE ) )
+            {
+                // Tell dso's wxDynamicLibrary destructor not to Unload() the program image.
+                (void) dso.Detach();
+                return m_kiface[aFaceId] = kiface;
+            }
        }
+        // In any of the failure cases above, dso.Unload() should be called here
+        // by dso destructor.
    }
    return NULL;

--- a/common/prependpath.cpp
+++ b/common/prependpath.cpp
+#include <macros.h>
+#include <fctsys.h>
+#include <wx/filename.h>
+#if !wxCHECK_VERSION( 3, 0, 0 )
+// implement missing wx2.8 function until >= wx3.0 pervades.
+static wxString wxJoin(const wxArrayString& arr, const wxChar sep,
+                const wxChar escape = '\\')
+{
+    size_t count = arr.size();
+    if ( count == 0 )
+        return wxEmptyString;
+    wxString str;
+    // pre-allocate memory using the estimation of the average length of the
+    // strings in the given array: this is very imprecise, of course, but
+    // better than nothing
+    str.reserve(count*(arr[0].length() + arr[count-1].length()) / 2);
+    if ( escape == wxT('\0') )
+    {
+        // escaping is disabled:
+        for ( size_t i = 0; i < count; i++ )
+        {
+            if ( i )
+                str += sep;
+            str += arr[i];
+        }
+    }
+    else // use escape character
+    {
+        for ( size_t n = 0; n < count; n++ )
+        {
+            if ( n )
+                str += sep;
+            for ( wxString::const_iterator i = arr[n].begin(),
+                                         end = arr[n].end();
+                  i != end;
+                  ++i )
+            {
+                const wxChar ch = *i;
+                if ( ch == sep )
+                    str += escape;      // escape this separator
+                str += ch;
+            }
+        }
+    }
+    str.Shrink(); // release extra memory if we allocated too much
+    return str;
+}
+#endif
+/// Put aPriorityPath in front of all paths in the value of aEnvVar.
+const wxString PrePendPath( const wxString& aEnvVar, const wxString& aPriorityPath )
+{
+    wxPathList  paths;
+    paths.AddEnvList( aEnvVar );
+    paths.Insert( aPriorityPath, 0 );
+    return wxJoin( paths, wxPATH_SEP[0] );
+}
--- a/common/project.cpp
+++ b/common/project.cpp
@@ -43,14 +43,13 @@ PROJECT::PROJECT()
 PROJECT::~PROJECT()
 {
-    /* @todo
+#if 1
-        careful here, this may work, but the virtual destructor may not
+    // careful here, this may work, but the virtual destructor may not
-        be in the same link image as PROJECT.  Won't enable this until
+    // be in the same link image as PROJECT.
-        we're more stable and destructor is assuredly in same image, i.e.
-        libki.so
    for( unsigned i = 0;  i<DIM(m_elems);  ++i )
        delete m_elems[i];
-    */
+#endif
 }
@@ -305,7 +304,7 @@ wxConfigBase* PROJECT::configCreate( const SEARCH_STACK& aSList, const wxString&
 void PROJECT::ConfigSave( const SEARCH_STACK& aSList, const wxString&  aFileName,
        const wxString& aGroupName, const PARAM_CFG_ARRAY& aParams )
 {
-    std::auto_ptr<wxConfigBase> cfg( configCreate( aSList, aFileName, aGroupName, FORCE_LOCAL_CONFIG ) );
+    std::auto_ptr<wxConfigBase> cfg( configCreate( aSList, aFileName, aGroupName, true ) );
    if( !cfg.get() )
    {
@@ -353,8 +352,7 @@ bool PROJECT::ConfigLoad( const SEARCH_STACK& aSList, const wxString& aFileName,
    wxString timestamp = cfg->Read( wxT( "update" ) );
-    if( doLoadOnlyIfNew && timestamp.size() &&
+    if( doLoadOnlyIfNew && timestamp.size() && timestamp == m_pro_date_and_time )
-        timestamp == m_pro_date_and_time )
    {
        return false;
    }

--- a/common/single_top.cpp
+++ b/common/single_top.cpp
@@ -51,74 +51,8 @@
 // The functions we use will cause the program launcher to pull stuff in
 // during linkage, keep the map file in mind to see what's going into it.
-#if !wxCHECK_VERSION( 3, 0, 0 )
-// implement missing wx2.8 function until >= wx3.0 pervades.
-static wxString wxJoin(const wxArrayString& arr, const wxChar sep,
-                const wxChar escape = '\\')
-{
-    size_t count = arr.size();
-    if ( count == 0 )
-        return wxEmptyString;
-    wxString str;
-    // pre-allocate memory using the estimation of the average length of the
-    // strings in the given array: this is very imprecise, of course, but
-    // better than nothing
-    str.reserve(count*(arr[0].length() + arr[count-1].length()) / 2);
-    if ( escape == wxT('\0') )
-    {
-        // escaping is disabled:
-        for ( size_t i = 0; i < count; i++ )
-        {
-            if ( i )
-                str += sep;
-            str += arr[i];
-        }
-    }
-    else // use escape character
-    {
-        for ( size_t n = 0; n < count; n++ )
-        {
-            if ( n )
-                str += sep;
-            for ( wxString::const_iterator i = arr[n].begin(),
-                                         end = arr[n].end();
-                  i != end;
-                  ++i )
-            {
-                const wxChar ch = *i;
-                if ( ch == sep )
-                    str += escape;      // escape this separator
-                str += ch;
-            }
-        }
-    }
-    str.Shrink(); // release extra memory if we allocated too much
-    return str;
-}
-#endif
-/// Put aPriorityPath in front of all paths in the value of aEnvVar.
-const wxString PrePendPath( const wxString& aEnvVar, const wxString& aPriorityPath )
-{
-    wxPathList  paths;
-    paths.AddEnvList( aEnvVar );
-    paths.Insert( aPriorityPath, 0 );
-    return wxJoin( paths, wxPATH_SEP[0] );
-}
 /// Extend LIB_ENV_VAR list with the directory from which I came, prepending it.
-void SetLibEnvVar( const wxString& aAbsoluteArgv0 )
+static void set_lib_env_var( const wxString& aAbsoluteArgv0 )
 {
    // POLICY CHOICE 2: Keep same path, so that installer MAY put the
    // "subsidiary DSOs" in the same directory as the kiway top process modules.
@@ -149,6 +83,7 @@ void SetLibEnvVar( const wxString& aAbsoluteArgv0 )
 #endif
 }
 // POLICY CHOICE 1: return the full path of the DSO to load from single_top.
 static const wxString dso_full_path( const wxString& aAbsoluteArgv0 )
 {
@@ -339,7 +274,7 @@ bool PGM_SINGLE_TOP::OnPgmInit( wxApp* aWxApp )
    // Set LIB_ENV_VAR *before* loading the DSO, in case the top-level DSO holding the
    // KIFACE has hard dependencies on subsidiary DSOs below it.
-    SetLibEnvVar( absoluteArgv0 );
+    set_lib_env_var( absoluteArgv0 );
    if( !initPgm() )
        return false;
@@ -364,7 +299,7 @@ bool PGM_SINGLE_TOP::OnPgmInit( wxApp* aWxApp )
    // Give the DSO a single chance to do its "process level" initialization.
    // "Process level" specifically means stay away from any projects in there.
-    if( !kiface->OnKifaceStart( this ) )
+    if( !kiface->OnKifaceStart( this, KFCTL_STANDALONE ) )
        return false;
    // Use KIFACE to create a top window that the KIFACE knows about.
@@ -418,8 +353,11 @@ bool PGM_SINGLE_TOP::OnPgmInit( wxApp* aWxApp )
            if( !argv1.GetExt() )
                argv1.SetExt( wxT( PGM_DATA_FILE_EXT ) );
-            argSet[0] = argv1.GetFullPath();
 #endif
+            argv1.MakeAbsolute();
+            argSet[0] = argv1.GetFullPath();
            if( !Pgm().LockFile( argSet[0] ) )
            {
                wxLogSysError( _( "This file is already open." ) );

--- a/cvpcb/cvpcb.cpp
+++ b/cvpcb/cvpcb.cpp
@@ -100,7 +100,7 @@ static struct IFACE : public KIFACE_I
        KIFACE_I( aName, aType )
    {}
-    bool OnKifaceStart( PGM_BASE* aProgram );
+    bool OnKifaceStart( PGM_BASE* aProgram, int aCtlBits );
    void OnKifaceEnd();
@@ -276,13 +276,13 @@ FP_LIB_TABLE GFootprintTable;
 // we skip setting KISYSMOD here for now.  User should set the environment
 // variable.
-bool IFACE::OnKifaceStart( PGM_BASE* aProgram )
+bool IFACE::OnKifaceStart( PGM_BASE* aProgram, int aCtlBits )
 {
    // This is process level, not project level, initialization of the DSO.
    // Do nothing in here pertinent to a project!
-    start_common();
+    start_common( aCtlBits );
    // Set 3D shape path from environment variable KISYS3DMOD
    set3DShapesPath( wxT("KISYS3DMOD") );

--- a/cvpcb/readwrite_dlgs.cpp
+++ b/cvpcb/readwrite_dlgs.cpp
@@ -720,8 +720,7 @@ int CVPCB_MAINFRAME::SaveCmpLinkFile( const wxString& aFullFileName )
        return 0;
    }
-    wxString msg;
+    wxString msg = wxString::Format( _("File %s saved"), GetChars( fn.GetFullPath() ) );
-    msg.Printf( _("File %s saved"), GetChars( fn.GetFullPath() ) );
    SetStatusText( msg );
    return 1;
 }
--- a/eeschema/eeschema.cpp
+++ b/eeschema/eeschema.cpp
@@ -68,7 +68,7 @@ static struct IFACE : public KIFACE_I
        KIFACE_I( aName, aType )
    {}
-    bool OnKifaceStart( PGM_BASE* aProgram );
+    bool OnKifaceStart( PGM_BASE* aProgram, int aCtlBits );
    void OnKifaceEnd( PGM_BASE* aProgram )
    {
@@ -79,14 +79,6 @@ static struct IFACE : public KIFACE_I
    {
        switch( aClassId )
        {
-        case LIBEDITOR_FRAME_TYPE:
-            {
-                LIB_EDIT_FRAME* frame = new LIB_EDIT_FRAME( aKiway,
-                                            dynamic_cast<SCH_EDIT_FRAME*>( aParent ) );
-                return frame;
-            }
-            break;
        case SCHEMATIC_FRAME_TYPE:
            {
                SCH_EDIT_FRAME* frame = new SCH_EDIT_FRAME( aKiway, aParent );
@@ -96,9 +88,19 @@ static struct IFACE : public KIFACE_I
                // Read a default config file in case no project given on command line.
                frame->LoadProjectFile( wxEmptyString, true );
-                // @todo temporary
+                if( Kiface().IsSingle() )
+                {
+                    // only run this under single_top, not under a project manager.
                    CreateServer( frame, KICAD_SCH_PORT_SERVICE_NUMBER );
+                }
+                return frame;
+            }
+            break;
+        case LIBEDITOR_FRAME_TYPE:
+            {
+                LIB_EDIT_FRAME* frame = new LIB_EDIT_FRAME( aKiway,
+                                            dynamic_cast<SCH_EDIT_FRAME*>( aParent ) );
                return frame;
            }
            break;
@@ -152,13 +154,13 @@ PGM_BASE& Pgm()
 }
-bool IFACE::OnKifaceStart( PGM_BASE* aProgram )
+bool IFACE::OnKifaceStart( PGM_BASE* aProgram, int aCtlBits )
 {
    // This is process level, not project level, initialization of the DSO.
    // Do nothing in here pertinent to a project!
-    start_common();
+    start_common( aCtlBits );
    // Give a default colour for all layers
    // (actual color will be initialized by config)

--- a/eeschema/schframe.cpp
+++ b/eeschema/schframe.cpp
@@ -819,7 +819,9 @@ void SCH_EDIT_FRAME::OnOpenLibraryEditor( wxCommandEvent& event )
    }
    else
    {
-        wxWindow* w = Kiface().CreateWindow( this, LIBEDITOR_FRAME_TYPE, &Kiway() );
+        KIFACE_I&   kf = Kiface();
+        wxWindow* w = kf.CreateWindow( this, LIBEDITOR_FRAME_TYPE, &Kiway(), kf.StartFlags() );
        libeditFrame = dynamic_cast<LIB_EDIT_FRAME*>( w );
    }

--- a/gerbview/gerbview.cpp
+++ b/gerbview/gerbview.cpp
@@ -73,7 +73,7 @@ static struct IFACE : public KIFACE_I
        KIFACE_I( aName, aType )
    {}
-    bool OnKifaceStart( PGM_BASE* aProgram );
+    bool OnKifaceStart( PGM_BASE* aProgram, int aCtlBits );
    void OnKifaceEnd();
@@ -145,9 +145,9 @@ PGM_BASE& Pgm()
 }
-bool IFACE::OnKifaceStart( PGM_BASE* aProgram )
+bool IFACE::OnKifaceStart( PGM_BASE* aProgram, int aCtlBits )
 {
-    start_common();
+    start_common( aCtlBits );
    // Must be called before creating the main frame in order to
    // display the real hotkeys in menus or tool tips

--- a/include/common.h
+++ b/include/common.h
@@ -610,4 +610,8 @@ void SystemDirsAppend( SEARCH_STACK* aSearchStack );
 wxString SearchHelpFileFullPath( const SEARCH_STACK& aSearchStack, const wxString& aBaseName );
+/// Put aPriorityPath in front of all paths in the value of aEnvVar.
+const wxString PrePendPath( const wxString& aEnvVar, const wxString& aPriorityPath );
 #endif  // INCLUDE__COMMON_H_
--- a/include/config_params.h
+++ b/include/config_params.h
@@ -49,7 +49,6 @@
 #define CONFIG_VERSION      1
-#define FORCE_LOCAL_CONFIG  true
 /**

--- a/include/kiface_i.h
+++ b/include/kiface_i.h
@@ -43,7 +43,7 @@ public:
        // see base class KIFACE in kiway.h for doxygen docs
-    VTBL_ENTRY bool OnKifaceStart( PGM_BASE* aProgram ) = 0;
+    VTBL_ENTRY bool OnKifaceStart( PGM_BASE* aProgram, int aCtlBits ) = 0;
    /*
    {
        typically call start_common() in your overload
@@ -58,7 +58,7 @@ public:
    }
    VTBL_ENTRY  wxWindow* CreateWindow( wxWindow* aParent,
-            int aClassId, KIWAY* aKIWAY, int aCtlBits = 0 ) = 0;
+            int aClassId, KIWAY* aKIWAY, int aCtlBits ) = 0;
    VTBL_ENTRY void* IfaceOrAddress( int aDataId ) = 0;
@@ -76,7 +76,8 @@ public:
     */
    KIFACE_I( const char* aKifaceName, KIWAY::FACE_T aId ) :
        m_id( aId ),
-        m_bm( aKifaceName )
+        m_bm( aKifaceName ),
+        m_start_flags( 0 )
    {
    }
@@ -85,7 +86,7 @@ public:
 protected:
    /// Common things to do for a top program module, during OnKifaceStart().
-    bool start_common();
+    bool start_common( int aCtlBits );
    /// Common things to do for a top program module, during OnKifaceEnd();
    void end_common();
@@ -100,6 +101,18 @@ public:
    wxConfigBase* KifaceSettings() const                { return m_bm.m_config; }
+    /**
+     * Function StartFlags
+     * returns whatever was passed as @a aCtlBits to OnKifaceStart()
+     */
+    int StartFlags() const                              { return m_start_flags; }
+    /**
+     * Function IsSingle
+     * is this KIFACE_I running under single_top?
+     */
+    bool IsSingle() const                               { return m_start_flags & KFCTL_STANDALONE; }
    /**
     * Function GetHelpFileName
     * returns just the basename portion of the current help file.
@@ -116,6 +129,8 @@ private:
    KIWAY::FACE_T       m_id;
    BIN_MOD             m_bm;
+    int                 m_start_flags;      ///< flags provided in OnKifaceStart()
 };

--- a/include/kiway.h
+++ b/include/kiway.h
@@ -112,25 +112,20 @@ as such!  As such, it is OK to use UTF8 characters:
 // be mangled.
 #define KIFACE_INSTANCE_NAME_AND_VERSION   "KIFACE_1"
 #if defined(__linux__)
 #define LIB_ENV_VAR    wxT( "LD_LIBRARY_PATH" )
 #elif defined(__WXMAC__)
 #define LIB_ENV_VAR    wxT( "DYLD_LIBRARY_PATH" )
 #elif defined(__MINGW32__)
 #define LIB_ENV_VAR    wxT( "PATH" )
 #endif
 class wxConfigBase;
-class KIWAY;
 class wxWindow;
-class PGM_BASE;
 class wxConfigBase;
+class PGM_BASE;
+class KIWAY;
 /**
@@ -151,6 +146,10 @@ struct KIFACE
    // order of functions in this listing unless you recompile all clients of
    // this interface.
+#define KFCTL_STANDALONE        (1<<0)  ///< Am running as a standalone Top.
+#define KFCTL_PROJECT_SUITE     (1<<1)  ///< Am running under a project mgr, possibly with others
    /**
     * Function OnKifaceStart
     * is called just once shortly after the DSO is loaded.  It is the second
@@ -161,13 +160,15 @@ struct KIFACE
     *
     * @param aProgram is the process block: PGM_BASE*
     *
+     * @param aCtlBits consists of bit flags from the set of KFCTL_* \#defines above.
+     *
     * @return bool - true if DSO initialized OK, false if not.  When returning
     *  false, the loader may optionally decide to terminate the process or not,
     *  but will not put out any UI because that is the duty of this function to say
     *  why it is returning false.  Never return false without having reported
     *  to the UI why.
     */
-    VTBL_ENTRY bool OnKifaceStart( PGM_BASE* aProgram ) = 0;
+    VTBL_ENTRY bool OnKifaceStart( PGM_BASE* aProgram, int aCtlBits ) = 0;
    /**
     * Function OnKifaceEnd
@@ -176,8 +177,6 @@ struct KIFACE
     */
    VTBL_ENTRY void OnKifaceEnd() = 0;
-#define KFCTL_STANDALONE    (1<<0)      ///< Am running as a standalone Top.
    /**
     * Function CreateWindow
     * creates a wxWindow for the current project.  The caller
@@ -199,7 +198,7 @@ struct KIFACE
     *  not contained in the caller's link image.
     */
    VTBL_ENTRY  wxWindow* CreateWindow( wxWindow* aParent, int aClassId,
-            KIWAY* aKIWAY, int aCtlBits = 0 ) = 0;
+            KIWAY* aKIWAY, int aCtlBits ) = 0;
    /**
     * Function IfaceOrAddress
@@ -249,7 +248,7 @@ class KIWAY : public wxEvtHandler
 {
 public:
-    /// DSO players on *this* KIWAY
+    /// Possible KIFACEs on *this* KIWAY
    enum FACE_T
    {
        FACE_SCH,           ///< eeschema DSO
@@ -257,6 +256,7 @@ public:
        FACE_PCB,           ///< pcbnew DSO
    //  FACE_MOD,
        FACE_CVPCB,
        FACE_BMP2CMP,
        FACE_GERBVIEW,
        FACE_PL_EDITOR,
@@ -265,41 +265,28 @@ public:
        FACE_COUNT,         ///< how many KIWAY player types
    };
-    /* from edaappl.h, now pgm_base.h, obsoleted by above FACE_T enum.
+    // If you change the vtable, recompile all of KiCad.
-    enum PGM_BASE_T
-    {
-        APP_UNKNOWN,
-        APP_EESCHEMA,
-        APP_PCBNEW,
-        APP_CVPCB,
-        APP_GERBVIEW,
-        APP_KICAD,
-        APP_PL_EDITOR,
-        APP_BM2CMP,
-    };
-    */
-    // Don't change the order of these VTBL_ENTRYs, add new ones at the end,
+    /**
-    // unless you recompile all of KiCad.
+     * Function KiFACE
+     * returns the KIFACE* given a FACE_T.  If it is not already loaded, the
+     * KIFACE is loaded and initialized with a call to KIFACE::OnKifaceStart()
+     */
+    VTBL_ENTRY      KIFACE*     KiFACE( PGM_BASE* aProgram,
+                                    FACE_T aFaceId, bool doLoad = true );
-    VTBL_ENTRY      KIFACE*     KiFACE( FACE_T aFaceId, bool doLoad );
    VTBL_ENTRY      PROJECT&    Prj()  const;
    KIWAY();
 private:
-    /*
+    /// Get the full path & name of the DSO holding the requested FACE_T.
-    /// Get the name of the DSO holding the requested FACE_T.
+    static const wxString dso_full_path( FACE_T aFaceId );
-    static const wxString dso_name( FACE_T aFaceId );
-    */
-    // one for each FACE_T
-    static wxDynamicLibrary    s_sch_dso;
-    static wxDynamicLibrary    s_pcb_dso;
-    //static wxDynamicLibrary    s_cvpcb_dso;   // will get merged into pcbnew
    KIFACE*     m_kiface[FACE_COUNT];
+    int         m_kiface_version[FACE_COUNT];
    PROJECT     m_project;          // do not assume this is here, use Prj().
 };

--- a/include/kiway_mgr.h
+++ b/include/kiway_mgr.h
+#ifndef KIWAY_MGR_H_
+#define KIWAY_MGR_H_
+/*
+ * This program source code file is part of KiCad, a free EDA CAD application.
+ *
+ * Copyright (C) 2014 SoftPLC Corporation, Dick Hollenbeck <dick@softplc.com>
+ * Copyright (C) 2014 KiCad Developers, see CHANGELOG.TXT for contributors.
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License
+ * as published by the Free Software Foundation; either version 2
+ * of the License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, you may find one here:
+ * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
+ * or you may search the http://www.gnu.org website for the version 2 license,
+ * or you may write to the Free Software Foundation, Inc.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA
+ */
+#include <kiway.h>
+#include <boost/ptr_container/ptr_vector.hpp>
+/**
+ * Class KIWAY_MGR
+ * is a container for all KIWAYS [and PROJECTS].  This class needs to work both
+ * for a C++ project manager and an a wxPython one (after being moved into a
+ * header later).
+ */
+class KIWAY_MGR
+{
+public:
+    //KIWAY_MGR();
+    // ~KIWAY_MGR();
+    bool OnStart( wxApp* aProcess );
+    void OnEnd();
+    KIWAY& operator[]( int aIndex )
+    {
+        wxASSERT( m_kiways.size() );    // stuffed in OnStart()
+        return m_kiways[aIndex];
+    }
+private:
+    // KIWAYs may not be moved once doled out, since window DNA depends on the
+    // pointer being good forever.
+    // boost_ptr::vector however never moves the object pointed to.
+    typedef boost::ptr_vector<KIWAY>    KIWAYS;
+    KIWAYS  m_kiways;
+};
+extern KIWAY_MGR Kiways;
+#endif  // KIWAY_MGR_H_
--- a/include/kiway_player.h
+++ b/include/kiway_player.h
@@ -130,7 +130,7 @@ public:
     * <p>
     * Each derived class should handle this in a way specific to its needs.
     * No prompting is done inside here for any file or project.  There should be
-     * need to call this with aFileList which is empty.  However, calling it with
+     * no need to call this with aFileList which is empty.  However, calling it with
     * a single filename which does not exist should indicate to the implementor
     * that a new session is being started and that the given name is the desired
     * name for the data file at time of save.
@@ -166,4 +166,51 @@ public:
    }
 };
+// psuedo code for OpenProjectFiles
+#if 0
+bool OpenProjectFiles( const std::vector<wxString>& aFileList, int aCtl = 0 )
+{
+    if( aFileList.size() != 1 )
+    {
+        complain via UI.
+        return false
+    }
+    assert( aFileList[0] is absolute )      // bug in single_top.cpp or project manager.
+    if (window does not support appending) || !(aCtl & KICTL_OPEN_APPEND)
+    {
+        close any currently open project files.
+    }
+    if( aFileList[0] does not exist )
+    {
+        notify user file does not exist.
+        create an empty project file
+        mark file as modified.
+        use the default project config file.
+    }
+    else
+    {
+        load aFileList[0]
+        use the project config file for project given by aFileList[0]s full path.
+    }
+    UpdateTitle();
+    show contents.
+}
+#endif
 #endif // KIWAY_PLAYER_H_
--- a/kicad/commandframe.cpp
+++ b/kicad/commandframe.cpp
@@ -59,7 +59,7 @@ int LAUNCHER_PANEL::GetPanelHeight() const
 * Function CreateCommandToolbar
 * create the buttons to call Eeschema CvPcb, Pcbnew and GerbView
 */
-void LAUNCHER_PANEL::CreateCommandToolbar( void )
+void LAUNCHER_PANEL::CreateCommandToolbar()
 {
    wxBitmapButton* btn;

--- a/kicad/kicad.cpp
+++ b/kicad/kicad.cpp
@@ -28,10 +28,11 @@
 */
+#include <macros.h>
 #include <fctsys.h>
+#include <wx/stdpaths.h>
 #include <kicad.h>
-#include <kiway.h>
+#include <kiway_mgr.h>
 #include <pgm_kicad.h>
 #include <tree_project_frame.h>
 #include <online_help.h>
@@ -40,6 +41,40 @@
 #include <build_version.h>
+/// Extend LIB_ENV_VAR list with the directory from which I came, prepending it.
+static void set_lib_env_var( const wxString& aAbsoluteArgv0 )
+{
+    // POLICY CHOICE 2: Keep same path, so that installer MAY put the
+    // "subsidiary DSOs" in the same directory as the kiway top process modules.
+    // A subsidiary shared library is one that is not a top level DSO, but rather
+    // some shared library that a top level DSO needs to even be loaded.  It is
+    // a static link to a shared object from a top level DSO.
+    // This directory POLICY CHOICE 2 is not the only dir in play, since LIB_ENV_VAR
+    // has numerous path options in it, as does DSO searching on linux, windows, and OSX.
+    // See "man ldconfig" on linux. What's being done here is for quick installs
+    // into a non-standard place, and especially for Windows users who may not
+    // know what the PATH environment variable is or how to set it.
+    wxFileName  fn( aAbsoluteArgv0 );
+    wxString    ld_path( LIB_ENV_VAR );
+    wxString    my_path   = fn.GetPath();
+    wxString    new_paths = PrePendPath( ld_path, my_path );
+    wxSetEnv( ld_path, new_paths );
+#if defined(DEBUG)
+    {
+        wxString    test;
+        wxGetEnv( ld_path, &test );
+        printf( "LIB_ENV_VAR:'%s'\n", TO_UTF8( test ) );
+    }
+#endif
+}
 // a dummy to quiet linking with EDA_BASE_FRAME::config();
 #include <kiface_i.h>
 KIFACE_I& Kiface()
@@ -62,7 +97,6 @@ bool PGM_KICAD::OnPgmInit( wxApp* aWxApp )
    m_bm.Init();
-#if 0   // copied from single_top.c, possibly for milestone B)
    wxString absoluteArgv0 = wxStandardPaths::Get().GetExecutablePath();
    if( !wxIsAbsolutePath( absoluteArgv0 ) )
@@ -71,10 +105,9 @@ bool PGM_KICAD::OnPgmInit( wxApp* aWxApp )
        return false;
    }
-    // Set LIB_ENV_VAR *before* loading the DSO, in case the top-level DSO holding the
+    // Set LIB_ENV_VAR *before* loading the KIFACE DSOs, in case they have hard
-    // KIFACE has hard dependencies on subsidiary DSOs below it.
+    // dependencies on subsidiary DSOs below it.
-    SetLibEnvVar( absoluteArgv0 );
+    set_lib_env_var( absoluteArgv0 );
-#endif
    if( !initPgm() )
        return false;
@@ -218,39 +251,7 @@ void PGM_KICAD::destroy()
 }
-/**
+KIWAY_MGR  Kiways;
- * Class KIWAY_MGR
- * is a container for all KIWAYS [and PROJECTS].  This class needs to work both
- * for a C++ project manager and an a wxPython one (after being moved into a
- * header later).
- */
-class KIWAY_MGR
-{
-public:
-    //KIWAY_MGR();
-    // ~KIWAY_MGR();
-    bool OnStart( wxApp* aProcess );
-    void OnEnd();
-    KIWAY& operator[]( int aIndex )
-    {
-        wxASSERT( m_kiways.size() );    // stuffed in OnStart()
-        return m_kiways[aIndex];
-    }
-private:
-    // KIWAYs may not be moved once doled out, since window DNA depends on the
-    // pointer being good forever.
-    // boost_ptr::vector however never moves the object pointed to.
-    typedef boost::ptr_vector<KIWAY>    KIWAYS;
-    KIWAYS  m_kiways;
-};
-static KIWAY_MGR   kiways;
 /**
@@ -261,7 +262,7 @@ struct APP_KICAD : public wxApp
 {
    bool OnInit()           // overload wxApp virtual
    {
-        if( kiways.OnStart( this ) )
+        if( Kiways.OnStart( this ) )
        {
            return Pgm().OnPgmInit( this );
        }
@@ -270,7 +271,7 @@ struct APP_KICAD : public wxApp
    int  OnExit()           // overload wxApp virtual
    {
-        kiways.OnEnd();
+        Kiways.OnEnd();
        Pgm().OnPgmExit();
@@ -296,7 +297,7 @@ IMPLEMENT_APP( APP_KICAD );
 // this link image need this function.
 PROJECT& Prj()
 {
-    return kiways[0].Prj();
+    return Kiways[0].Prj();
 }

--- a/kicad/mainframe.cpp
+++ b/kicad/mainframe.cpp
@@ -30,6 +30,8 @@
 #include <fctsys.h>
 #include <pgm_kicad.h>
+#include <kiway_mgr.h>
+#include <kiway_player.h>
 #include <confirm.h>
 #include <gestfich.h>
 #include <macros.h>
@@ -238,10 +240,23 @@ void KICAD_MANAGER_FRAME::OnRunPcbNew( wxCommandEvent& event )
    legacy_board.SetExt( LegacyPcbFileExtension );
    kicad_board.SetExt( KiCadPcbFileExtension );
-    if( !legacy_board.FileExists() || kicad_board.FileExists() )
+    wxFileName& board = ( !legacy_board.FileExists() || kicad_board.FileExists() ) ?
-        Execute( this, PCBNEW_EXE, QuoteFullPath( kicad_board ) );
+                            kicad_board : legacy_board;
-    else
-        Execute( this, PCBNEW_EXE, QuoteFullPath( legacy_board ) );
+#if 0   // it works!
+    KIFACE* kiface = Kiways[0].KiFACE( &Pgm(), KIWAY::FACE_PCB );
+    KIWAY_PLAYER* frame = (KIWAY_PLAYER*) kiface->CreateWindow( this, PCB_FRAME_TYPE, &Kiways[0], KFCTL_PROJECT_SUITE );
+    frame->OpenProjectFiles( std::vector<wxString>( 1, board.GetFullPath() ) );
+    frame->Show( true );
+    frame->Raise();
+#else
+    Execute( this, PCBNEW_EXE, QuoteFullPath( board ) );
+#endif
 }

--- a/pagelayout_editor/pl_editor.cpp
+++ b/pagelayout_editor/pl_editor.cpp
@@ -54,7 +54,7 @@ static struct IFACE : public KIFACE_I
        KIFACE_I( aName, aType )
    {}
-    bool OnKifaceStart( PGM_BASE* aProgram );
+    bool OnKifaceStart( PGM_BASE* aProgram, int aCtlBits );
    void OnKifaceEnd();
@@ -126,9 +126,9 @@ PGM_BASE& Pgm()
 }
-bool IFACE::OnKifaceStart( PGM_BASE* aProgram )
+bool IFACE::OnKifaceStart( PGM_BASE* aProgram, int aCtlBits )
 {
-    start_common();
+    start_common( aCtlBits );
    // Must be called before creating the main frame in order to
    // display the real hotkeys in menus or tool tips

--- a/pcb_calculator/pcb_calculator.cpp
+++ b/pcb_calculator/pcb_calculator.cpp
@@ -55,7 +55,7 @@ static struct IFACE : public KIFACE_I
        KIFACE_I( aName, aType )
    {}
-    bool OnKifaceStart( PGM_BASE* aProgram );
+    bool OnKifaceStart( PGM_BASE* aProgram, int aCtlBits );
    void OnKifaceEnd();
@@ -117,9 +117,9 @@ PGM_BASE& Pgm()
 }
-bool IFACE::OnKifaceStart( PGM_BASE* aProgram )
+bool IFACE::OnKifaceStart( PGM_BASE* aProgram, int aCtlBits )
 {
-    start_common();
+    start_common( aCtlBits );
    return true;
 }

--- a/pcbnew/edit.cpp
+++ b/pcbnew/edit.cpp
@@ -194,7 +194,9 @@ void PCB_EDIT_FRAME::Process_Special_Functions( wxCommandEvent& event )
            if( !editor )
            {
-                editor = (FOOTPRINT_EDIT_FRAME*) Kiface().CreateWindow( this, MODULE_EDITOR_FRAME_TYPE, &Kiway() );
+                KIFACE_I&   kf = Kiface();
+                editor = (FOOTPRINT_EDIT_FRAME*) kf.CreateWindow( this, MODULE_EDITOR_FRAME_TYPE, &Kiway(), kf.StartFlags() );
                editor->Show( true );
                editor->Zoom_Automatique( false );
@@ -220,7 +222,9 @@ void PCB_EDIT_FRAME::Process_Special_Functions( wxCommandEvent& event )
            if( !viewer )
            {
-                viewer = (FOOTPRINT_VIEWER_FRAME*) Kiface().CreateWindow( this, MODULE_VIEWER_FRAME_TYPE, &Kiway() );
+                KIFACE_I&   kf = Kiface();
+                viewer = (FOOTPRINT_VIEWER_FRAME*) kf.CreateWindow( this, MODULE_VIEWER_FRAME_TYPE, &Kiway(), kf.StartFlags() );
                viewer->Show( true );
                viewer->Zoom_Automatique( false );
@@ -839,7 +843,9 @@ void PCB_EDIT_FRAME::Process_Special_Functions( wxCommandEvent& event )
            if( !editor )
            {
-                editor = (FOOTPRINT_EDIT_FRAME*) Kiface().CreateWindow( this, MODULE_EDITOR_FRAME_TYPE, &Kiway() );
+                KIFACE_I&   kf = Kiface();
+                editor = (FOOTPRINT_EDIT_FRAME*) kf.CreateWindow( this, MODULE_EDITOR_FRAME_TYPE, &Kiway(), kf.StartFlags() );
            }
            editor->Load_Module_From_BOARD( (MODULE*)GetCurItem() );

--- a/pcbnew/editmod.cpp
+++ b/pcbnew/editmod.cpp
@@ -78,7 +78,9 @@ void PCB_EDIT_FRAME::InstallModuleOptionsFrame( MODULE* Module, wxDC* DC )
        if( !editor )
        {
-            editor = (FOOTPRINT_EDIT_FRAME*) Kiface().CreateWindow( this, MODULE_EDITOR_FRAME_TYPE, &Kiway() );
+            KIFACE_I&   kf = Kiface();
+            editor = (FOOTPRINT_EDIT_FRAME*) kf.CreateWindow( this, MODULE_EDITOR_FRAME_TYPE, &Kiway(), kf.StartFlags() );
        }
        editor->Load_Module_From_BOARD( Module );

--- a/pcbnew/menubar_pcbframe.cpp
+++ b/pcbnew/menubar_pcbframe.cpp
@@ -39,9 +39,6 @@
 #include <help_common_strings.h>
 #include <menus_helpers.h>
-/**
- * Pcbnew mainframe menubar
- */
 void PCB_EDIT_FRAME::ReCreateMenuBar()
 {
    wxString    text;
@@ -49,7 +46,7 @@ void PCB_EDIT_FRAME::ReCreateMenuBar()
    wxFileHistory&  fhist = Kiface().GetFileHistory();
-    if( ! menuBar )
+    if( !menuBar )
        menuBar = new wxMenuBar();
    // Delete all existing menus so they can be rebuilt.
@@ -64,7 +61,8 @@ void PCB_EDIT_FRAME::ReCreateMenuBar()
    // Create File Menu
    wxMenu* filesMenu = new wxMenu;
-    // New
+    if( Kiface().IsSingle() )   // not when under a project mgr
+    {
        AddMenuItem( filesMenu, ID_NEW_BOARD,
                _( "&New" ),
                _( "Clear current board and initialize a new one" ),
@@ -75,6 +73,7 @@ void PCB_EDIT_FRAME::ReCreateMenuBar()
        AddMenuItem( filesMenu, ID_LOAD_FILE, text,
                _( "Delete current board and load new board" ),
                KiBitmap( open_brd_file_xpm ) );
+    }
    // Load Recent submenu
    static wxMenu* openRecentMenu;
@@ -89,44 +88,46 @@ void PCB_EDIT_FRAME::ReCreateMenuBar()
    fhist.UseMenu( openRecentMenu );
    fhist.AddFilesToMenu();
+    if( Kiface().IsSingle() )      // not when under a project mgr
+    {
        AddMenuItem( filesMenu, openRecentMenu,
                     -1, _( "Open &Recent" ),
                     _( "Open a recent opened board" ),
                     KiBitmap( open_project_xpm ) );
+    }
-    // Pcbnew Board
    AddMenuItem( filesMenu, ID_APPEND_FILE,
                 _( "&Append Board" ),
                 _( "Append another Pcbnew board to the current loaded board" ),
                 KiBitmap( import_xpm ) );
    filesMenu->AppendSeparator();
-    // Save
    text = AddHotkeyName( _( "&Save" ), g_Board_Editor_Hokeys_Descr, HK_SAVE_BOARD );
    AddMenuItem( filesMenu, ID_SAVE_BOARD, text,
                 _( "Save current board" ),
                 KiBitmap( save_xpm ) );
-    // Save As
+    if( Kiface().IsSingle() )      // not when under a project mgr
+    {
        text = AddHotkeyName( _( "Sa&ve As..." ), g_Board_Editor_Hokeys_Descr, HK_SAVE_BOARD_AS );
        AddMenuItem( filesMenu, ID_SAVE_BOARD_AS, text,
                     _( "Save the current board as..." ),
                     KiBitmap( save_as_xpm ) );
        filesMenu->AppendSeparator();
+    }
-    // Revert
    AddMenuItem( filesMenu, ID_MENU_READ_BOARD_BACKUP_FILE,
                 _( "Revert to Last" ),
                 _( "Clear board and get previous backup version of board" ),
                 KiBitmap( help_xpm ) );
-    // Rescue
+    AddMenuItem( filesMenu, ID_MENU_RECOVER_BOARD_AUTOSAVE,
-    AddMenuItem( filesMenu, ID_MENU_RECOVER_BOARD_AUTOSAVE, _( "Rescue" ),
+            _( "Rescue" ),
            _( "Clear board and get last rescue file automatically saved by Pcbnew" ),
            KiBitmap( help_xpm ) );
    filesMenu->AppendSeparator();
-    /* Fabrication Outputs submenu */
+    //----- Fabrication Outputs submenu -----------------------------------------
    wxMenu* fabricationOutputsMenu = new wxMenu;
    AddMenuItem( fabricationOutputsMenu, ID_PCB_GEN_POS_MODULES_FILE,
                 _( "&Modules Position (.pos) File" ),
@@ -138,7 +139,6 @@ void PCB_EDIT_FRAME::ReCreateMenuBar()
                 _( "Generate excellon2 drill file" ),
                 KiBitmap( post_drill_xpm ) );
-    // Module Report
    AddMenuItem( fabricationOutputsMenu, ID_GEN_EXPORT_FILE_MODULE_REPORT,
                 _( "&Module (.rpt) Report" ),
                 _( "Create a report of all modules on the current board" ),
@@ -149,29 +149,24 @@ void PCB_EDIT_FRAME::ReCreateMenuBar()
            _( "Generate IPC-D-356 netlist file" ),
            KiBitmap( netlist_xpm ) );
-    // Component File
    AddMenuItem( fabricationOutputsMenu, ID_PCB_GEN_CMP_FILE,
                 _( "&Component (.cmp) File" ),
                 _( "(Re)create components file (*.cmp) for CvPcb" ),
                 KiBitmap( create_cmp_file_xpm ) );
-    // BOM File
    AddMenuItem( fabricationOutputsMenu, ID_PCB_GEN_BOM_FILE_FROM_BOARD,
                 _( "&BOM File" ),
                 _( "Create a bill of materials from schematic" ),
                 KiBitmap( bom_xpm ) );
-    // Fabrications Outputs submenu append
    AddMenuItem( filesMenu, fabricationOutputsMenu,
                 -1, _( "&Fabrication Outputs" ),
                 _( "Generate files for fabrication" ),
                 KiBitmap( fabrication_xpm ) );
+    //----- Import submenu ------------------------------------------------------
-    /** Import submenu **/
    wxMenu* submenuImport = new wxMenu();
-    // Specctra Session
    AddMenuItem( submenuImport, ID_GEN_IMPORT_SPECCTRA_SESSION,
                 _( "&Specctra Session" ),
                 _( "Import a routed \"Specctra Session\" (*.ses) file" ),
@@ -187,27 +182,23 @@ void PCB_EDIT_FRAME::ReCreateMenuBar()
                 _( "Import files" ), KiBitmap( import_xpm ) );
-    /** Export submenu **/
+    //----- Export submenu ------------------------------------------------------
    wxMenu* submenuexport = new wxMenu();
-    // Specctra DSN
    AddMenuItem( submenuexport, ID_GEN_EXPORT_SPECCTRA,
                 _( "&Specctra DSN" ),
                 _( "Export the current board to a \"Specctra DSN\" file" ),
                 KiBitmap( export_dsn_xpm ) );
-    // GenCAD
    AddMenuItem( submenuexport, ID_GEN_EXPORT_FILE_GENCADFORMAT,
                 _( "&GenCAD" ), _( "Export GenCAD format" ),
                 KiBitmap( export_xpm ) );
-    // VRML
    AddMenuItem( submenuexport, ID_GEN_EXPORT_FILE_VRML,
                 _( "&VRML" ),
                 _( "Export a VRML board representation" ),
                 KiBitmap( three_d_xpm ) );
-    // IDF3
    AddMenuItem( submenuexport, ID_GEN_EXPORT_FILE_IDF3,
                 _( "I&DFv3 Export" ), _( "IDFv3 board and component export" ),
                 KiBitmap( export_idf_xpm ) );
@@ -218,24 +209,20 @@ void PCB_EDIT_FRAME::ReCreateMenuBar()
    filesMenu->AppendSeparator();
-    // Page settings
    AddMenuItem( filesMenu, ID_SHEET_SET,
                 _( "Page s&ettings" ),
                 _( "Page settings for paper size and texts" ),
                 KiBitmap( sheetset_xpm ) );
-    // Print
    AddMenuItem( filesMenu, wxID_PRINT,
                 _( "&Print" ), _( "Print board" ),
                 KiBitmap( print_button_xpm ) );
-    // Create SVG file
    AddMenuItem( filesMenu, ID_GEN_PLOT_SVG,
                 _( "Export SV&G" ),
                 _( "Export a board file in Scalable Vector Graphics format" ),
                 KiBitmap( plot_svg_xpm ) );
-    // Plot
    AddMenuItem( filesMenu, ID_GEN_PLOT,
                 _( "P&lot" ),
                 _( "Plot board in HPGL, PostScript or Gerber RS-274X format)" ),
@@ -243,15 +230,14 @@ void PCB_EDIT_FRAME::ReCreateMenuBar()
    filesMenu->AppendSeparator();
+    //----- archive submenu -----------------------------------------------------
    wxMenu* submenuarchive = new wxMenu();
-    // Archive New Footprints
    AddMenuItem( submenuarchive, ID_MENU_ARCHIVE_NEW_MODULES,
                 _( "&Archive New Footprints" ),
                 _( "Archive new footprints only in a library (keep other footprints in this lib)" ),
                 KiBitmap( library_update_xpm ) );
-    // Create FootPrint Archive
    AddMenuItem( submenuarchive, ID_MENU_ARCHIVE_ALL_MODULES,
                 _( "&Create Footprint Archive" ),
                 _( "Archive all footprints in a library (old library will be deleted)" ),
@@ -263,54 +249,45 @@ void PCB_EDIT_FRAME::ReCreateMenuBar()
                 _( "Archive or add footprints in a library file" ),
                 KiBitmap( library_xpm ) );
-    // Quit
    filesMenu->AppendSeparator();
    AddMenuItem( filesMenu, wxID_EXIT, _( "&Quit" ), _( "Quit Pcbnew" ),
                 KiBitmap( exit_xpm ) );
-    /** Create Edit menu **/
+    //----- Edit menu -----------------------------------------------------------
    wxMenu* editMenu = new wxMenu;
-    // Undo
    text  = AddHotkeyName( _( "&Undo" ), g_Pcbnew_Editor_Hokeys_Descr, HK_UNDO );
    AddMenuItem( editMenu, wxID_UNDO, text, HELP_UNDO, KiBitmap( undo_xpm ) );
-    // Redo
    text  = AddHotkeyName( _( "&Redo" ), g_Pcbnew_Editor_Hokeys_Descr, HK_REDO );
    AddMenuItem( editMenu, wxID_REDO, text, HELP_REDO, KiBitmap( redo_xpm ) );
-    // Delete
    AddMenuItem( editMenu, ID_PCB_DELETE_ITEM_BUTT,
                 _( "&Delete" ), _( "Delete items" ),
                 KiBitmap( delete_xpm ) );
    editMenu->AppendSeparator();
-    // Find
    text = AddHotkeyName( _( "&Find" ), g_Pcbnew_Editor_Hokeys_Descr, HK_FIND_ITEM );
    AddMenuItem( editMenu, ID_FIND_ITEMS, text, HELP_FIND , KiBitmap( find_xpm ) );
    editMenu->AppendSeparator();
-    // Global Deletions
    AddMenuItem( editMenu, ID_PCB_GLOBAL_DELETE,
                 _( "&Global Deletions" ),
                 _( "Delete tracks, modules, texts... on board" ),
                 KiBitmap( general_deletions_xpm ) );
-    // Cleanup Tracks and Vias
    AddMenuItem( editMenu, ID_MENU_PCB_CLEAN,
                 _( "&Cleanup Tracks and Vias" ),
                 _( "Clean stubs, vias, delete break points, or connect dangling tracks to pads and vias" ),
                 KiBitmap( delete_xpm ) );
-    // Swap Layers
    AddMenuItem( editMenu, ID_MENU_PCB_SWAP_LAYERS,
                 _( "&Swap Layers" ),
                 _( "Swap tracks on copper layers or drawings on other layers" ),
                 KiBitmap( swap_layer_xpm ) );
-    // Reset module reference sizes
    AddMenuItem( editMenu, ID_MENU_PCB_RESET_TEXTMODULE_FIELDS_SIZES,
                 _( "&Reset Module Field Sizes" ),
                 _( "Reset text size and width of all module fields to current defaults" ),
@@ -323,7 +300,7 @@ void PCB_EDIT_FRAME::ReCreateMenuBar()
                 _( "Interactive router push&shove tool." ),
                 KiBitmap( ps_router_xpm ) );
-    /** Create View menu **/
+    //----- View menu -----------------------------------------------------------
    wxMenu* viewMenu = new wxMenu;
    /* Important Note for ZOOM IN and ZOOM OUT commands from menubar:
@@ -337,104 +314,84 @@ void PCB_EDIT_FRAME::ReCreateMenuBar()
     * in other words HK_ZOOM_IN and HK_ZOOM_OUT *are NOT* accelerators
     * for Zoom in and Zoom out sub menus
     */
-    // Zoom In
    text = AddHotkeyName( _( "Zoom &In" ), g_Pcbnew_Editor_Hokeys_Descr,
                          HK_ZOOM_IN, IS_ACCELERATOR );
    AddMenuItem( viewMenu, ID_ZOOM_IN, text, HELP_ZOOM_IN, KiBitmap( zoom_in_xpm ) );
-    // Zoom Out
    text = AddHotkeyName( _( "Zoom &Out" ), g_Pcbnew_Editor_Hokeys_Descr,
                          HK_ZOOM_OUT, IS_ACCELERATOR );
    AddMenuItem( viewMenu, ID_ZOOM_OUT, text, HELP_ZOOM_OUT, KiBitmap( zoom_out_xpm ) );
-    // Fit on Screen
    text = AddHotkeyName( _( "&Fit on Screen" ), g_Pcbnew_Editor_Hokeys_Descr,
                          HK_ZOOM_AUTO );
    AddMenuItem( viewMenu, ID_ZOOM_PAGE, text, HELP_ZOOM_FIT,
                 KiBitmap( zoom_fit_in_page_xpm ) );
    viewMenu->AppendSeparator();
-    // Redraw
    text = AddHotkeyName( _( "&Redraw" ), g_Pcbnew_Editor_Hokeys_Descr, HK_ZOOM_REDRAW );
    AddMenuItem( viewMenu, ID_ZOOM_REDRAW, text,
                 HELP_ZOOM_REDRAW, KiBitmap( zoom_redraw_xpm ) );
    viewMenu->AppendSeparator();
-    // 3D Display
    AddMenuItem( viewMenu, ID_MENU_PCB_SHOW_3D_FRAME,
                 _( "&3D Display" ),_( "Show board in 3D viewer" ),
                 KiBitmap( three_d_xpm ) );
-    // List Nets
    AddMenuItem( viewMenu, ID_MENU_LIST_NETS,
                 _( "&List Nets" ), _( "View a list of nets with names and id's" ),
                 KiBitmap( tools_xpm ) );
-    // Switching GAL-based canvas on/off
    viewMenu->AppendSeparator();
    text = AddHotkeyName( _( "&Switch canvas to default" ), g_Pcbnew_Editor_Hokeys_Descr,
            HK_CANVAS_DEFAULT, IS_ACCELERATOR );
    AddMenuItem( viewMenu, ID_MENU_CANVAS_DEFAULT,
                 text, _( "Switch the canvas implementation to default" ),
                KiBitmap( tools_xpm ) );
    text = AddHotkeyName( _( "&Switch canvas to OpenGL" ), g_Pcbnew_Editor_Hokeys_Descr,
            HK_CANVAS_OPENGL, IS_ACCELERATOR );
    AddMenuItem( viewMenu, ID_MENU_CANVAS_OPENGL,
                 text, _( "Switch the canvas implementation to OpenGL" ),
                KiBitmap( tools_xpm ) );
    text = AddHotkeyName( _( "&Switch canvas to Cairo" ), g_Pcbnew_Editor_Hokeys_Descr,
            HK_CANVAS_CAIRO, IS_ACCELERATOR );
    AddMenuItem( viewMenu, ID_MENU_CANVAS_CAIRO,
                 text, _( "Switch the canvas implementation to Cairo" ),
                KiBitmap( tools_xpm ) );
-    /** Create Place Menu **/
+    //----- Place Menu ----------------------------------------------------------
    wxMenu* placeMenu = new wxMenu;
-    // Module
    text = AddHotkeyName( _( "&Module" ), g_Pcbnew_Editor_Hokeys_Descr,
                          HK_ADD_MODULE, IS_ACCELERATOR );
    AddMenuItem( placeMenu, ID_PCB_MODULE_BUTT, text,
                 _( "Add modules" ), KiBitmap( module_xpm ) );
-    // Track
    text = AddHotkeyName( _( "&Track" ), g_Pcbnew_Editor_Hokeys_Descr,
                          HK_ADD_NEW_TRACK, IS_ACCELERATOR );
    AddMenuItem( placeMenu, ID_TRACK_BUTT, text,
                 _( "Add tracks and vias" ), KiBitmap( add_tracks_xpm ) );
-    // Zone
    AddMenuItem( placeMenu, ID_PCB_ZONES_BUTT,
                 _( "&Zone" ), _( "Add filled zones" ), KiBitmap( add_zone_xpm ) );
-    // Keepout areas
    AddMenuItem( placeMenu, ID_PCB_KEEPOUT_AREA_BUTT,
                 _( "&Keepout Area" ), _( "Add keepout areas" ), KiBitmap( add_keepout_area_xpm ) );
-    // Text
    AddMenuItem( placeMenu, ID_PCB_ADD_TEXT_BUTT,
                  _( "Te&xt" ), _( "Add text on copper layers or graphic text" ),
                  KiBitmap( add_text_xpm ) );
-    // Graphic Arc
    AddMenuItem( placeMenu, ID_PCB_ARC_BUTT,
                 _( "&Arc" ), _( "Add graphic arc" ),KiBitmap( add_arc_xpm ) );
-    // Graphic Circle
    AddMenuItem( placeMenu, ID_PCB_CIRCLE_BUTT,
                 _( "&Circle" ), _( "Add graphic circle" ),
                 KiBitmap( add_circle_xpm ) );
-    // Line or Polygon
    AddMenuItem( placeMenu, ID_PCB_ADD_LINE_BUTT,
                 _( "&Line or Polygon" ),
                 _( "Add graphic line or polygon" ),
@@ -442,34 +399,29 @@ void PCB_EDIT_FRAME::ReCreateMenuBar()
    placeMenu->AppendSeparator();
-    // Dimension
    AddMenuItem( placeMenu, ID_PCB_DIMENSION_BUTT,
                 _( "&Dimension" ), _( "Add dimension" ),
                 KiBitmap( add_dimension_xpm ) );
-    // Layer alignment target
    AddMenuItem( placeMenu, ID_PCB_MIRE_BUTT,
                 _( "La&yer alignment target" ), _( "Add layer alignment target" ),
                 KiBitmap( add_mires_xpm ) );
    placeMenu->AppendSeparator();
-    // Drill & Place Offset
    AddMenuItem( placeMenu, ID_PCB_PLACE_OFFSET_COORD_BUTT,
                 _( "Drill and Place O&ffset" ),
                 _( "Place the origin point for drill and place files" ),
                 KiBitmap( pcb_offset_xpm ) );
-    // Grid Origin
    AddMenuItem( placeMenu, ID_PCB_PLACE_GRID_COORD_BUTT,
                 _( "&Grid Origin" ),
                 _( "Set the origin point for the grid" ),
                 KiBitmap( grid_select_axis_xpm ) );
-    /* Create Preferences and configuration menu */
+    //----- Preferences and configuration menu------------------------------------
    wxMenu* configmenu = new wxMenu;
-    // Library
    AddMenuItem( configmenu, ID_PCB_LIB_TABLE_EDIT,
                _( "Li&brary Tables" ), _( "Setup footprint libraries" ),
                KiBitmap( library_table_xpm ) );
@@ -487,7 +439,6 @@ void PCB_EDIT_FRAME::ReCreateMenuBar()
                 HELP_SHOW_HIDE_MICROWAVE_TOOLS,
                 KiBitmap( mw_toolbar_xpm ) );
    // General
 #ifdef __WXMAC__
    configmenu->Append(wxID_PREFERENCES);
@@ -497,52 +448,44 @@ void PCB_EDIT_FRAME::ReCreateMenuBar()
                 KiBitmap( preference_xpm ) );
 #endif
-    // Display
    AddMenuItem( configmenu, ID_PCB_DISPLAY_OPTIONS_SETUP,
                 _( "&Display" ),
                 _( "Select how items (pads, tracks texts ... ) are displayed" ),
                 KiBitmap( display_options_xpm ) );
-    // Create sizes and dimensions submenu
+    //--- dimensions submenu ------------------------------------------------------
    wxMenu* dimensionsMenu = new wxMenu;
-    // Grid
    AddMenuItem( dimensionsMenu, ID_PCB_USER_GRID_SETUP,
                 _( "G&rid" ),_( "Adjust user grid dimensions" ),
                 KiBitmap( grid_xpm ) );
-    // Text and Drawings
    AddMenuItem( dimensionsMenu, ID_PCB_DRAWINGS_WIDTHS_SETUP,
                 _( "Te&xts and Drawings" ),
                 _( "Adjust dimensions for texts and drawings" ),
                 KiBitmap( options_text_xpm ) );
-    // Pads
    AddMenuItem( dimensionsMenu, ID_PCB_PAD_SETUP,
                 _( "&Pads" ),  _( "Adjust default pad characteristics" ),
                 KiBitmap( pad_dimensions_xpm ) );
-    // Pads Mask Clearance
    AddMenuItem( dimensionsMenu, ID_PCB_MASK_CLEARANCE,
                 _( "Pads &Mask Clearance" ),
                 _( "Adjust the global clearance between pads and the solder resist mask" ),
                 KiBitmap( pads_mask_layers_xpm ) );
-    // Save dimension preferences
    dimensionsMenu->AppendSeparator();
    AddMenuItem( dimensionsMenu, ID_CONFIG_SAVE,
                 _( "&Save" ), _( "Save dimension preferences" ),
                 KiBitmap( save_xpm ) );
    // Language submenu
    Pgm().AddMenuLanguageList( configmenu );
    // Hotkey submenu
    AddHotkeyConfigMenu( configmenu );
+    //--- Macros submenu --------------------------------------------------------
-    // Macros submenu
    wxMenu* macrosMenu = new wxMenu;
    AddMenuItem( macrosMenu, ID_PREFRENCES_MACROS_SAVE,
@@ -555,7 +498,6 @@ void PCB_EDIT_FRAME::ReCreateMenuBar()
                 _( "Read macros from file" ),
                 KiBitmap( read_setup_xpm ) );
-    // Append macros menu to config menu
    AddMenuItem( configmenu, macrosMenu,
                 -1, _( "Ma&cros" ),
                 _( "Macros save/read operations" ),
@@ -563,75 +505,58 @@ void PCB_EDIT_FRAME::ReCreateMenuBar()
    configmenu->AppendSeparator();
-    // Save Preferences
    AddMenuItem( configmenu, ID_CONFIG_SAVE,
                 _( "&Save Preferences" ),
                 _( "Save application preferences" ),
                 KiBitmap( save_setup_xpm ) );
-    // Read Preferences
    AddMenuItem( configmenu, ID_CONFIG_READ,
                 _( "&Read Preferences" ),
                 _( "Read application preferences" ),
                 KiBitmap( read_setup_xpm ) );
-    /**
+    //----- Tools menu ----------------------------------------------------------
-     * Tools menu
-     */
    wxMenu* toolsMenu = new wxMenu;
-    /* Netlist */
    AddMenuItem( toolsMenu, ID_GET_NETLIST,
                 _( "&Netlist" ),
                 _( "Read the netlist and update board connectivity" ),
                 KiBitmap( netlist_xpm ) );
-    /* Layer pair */
    AddMenuItem( toolsMenu, ID_AUX_TOOLBAR_PCB_SELECT_LAYER_PAIR,
                 _( "&Layer Pair" ), _( "Change the active layer pair" ),
                 KiBitmap( select_layer_pair_xpm ) );
-    /* DRC */
    AddMenuItem( toolsMenu, ID_DRC_CONTROL,
                 _( "&DRC" ),
                 _( "Perform design rules check" ), KiBitmap( erc_xpm ) );
-    /* FreeRoute */
    AddMenuItem( toolsMenu, ID_TOOLBARH_PCB_FREEROUTE_ACCESS,
                 _( "&FreeRoute" ),
                 _( "Fast access to the Web Based FreeROUTE advanced router" ),
                 KiBitmap( web_support_xpm ) );
-#ifdef KICAD_SCRIPTING_WXPYTHON
+#if defined(KICAD_SCRIPTING_WXPYTHON)
-    /* Scripting */
    AddMenuItem( toolsMenu, ID_TOOLBARH_PCB_SCRIPTING_CONSOLE,
                 _( "&Scripting Console" ),
                 _( "Show/Hide the Scripting console" ),
                 KiBitmap( book_xpm ) );
 #endif
-    /* Design Rules menu
-     */
    wxMenu* designRulesMenu = new wxMenu;
-    // Design Rules
    AddMenuItem( designRulesMenu, ID_MENU_PCB_SHOW_DESIGN_RULES_DIALOG,
                 _( "Design Rules" ),
                 _( "Open the design rules editor" ), KiBitmap( hammer_xpm ) );
-    // Layers Setup
    AddMenuItem( designRulesMenu, ID_PCB_LAYERS_SETUP,
                 _( "&Layers Setup" ),  _( "Enable and set layer properties" ),
                 KiBitmap( copper_layers_setup_xpm ) );
-    /**
-     * Help menu
-     */
    wxMenu* helpMenu = new wxMenu;
    AddHelpVersionInfoMenuEntry( helpMenu );
-    // Contents
    AddMenuItem( helpMenu, wxID_HELP,
                 _( "&Contents" ),
                 _( "Open the Pcbnew handbook" ),
@@ -642,16 +567,13 @@ void PCB_EDIT_FRAME::ReCreateMenuBar()
                 _( "Open the \"Getting Started in KiCad\" guide for beginners" ),
                 KiBitmap( help_xpm ) );
-    // About
    helpMenu->AppendSeparator();
    AddMenuItem( helpMenu, wxID_ABOUT,
                 _( "&About Pcbnew" ),
                 _( "About Pcbnew printed circuit board designer" ),
                 KiBitmap( info_xpm ) );
-    /**
+    // Append all menus to the menuBar
-     * Append all menus to the menuBar
-     */
    menuBar->Append( filesMenu, _( "&File" ) );
    menuBar->Append( editMenu, _( "&Edit" ) );
    menuBar->Append( viewMenu, _( "&View" ) );

--- a/pcbnew/modedit.cpp
+++ b/pcbnew/modedit.cpp
@@ -271,7 +271,9 @@ void FOOTPRINT_EDIT_FRAME::Process_Special_Functions( wxCommandEvent& event )
            FOOTPRINT_VIEWER_FRAME* viewer = FOOTPRINT_VIEWER_FRAME::GetActiveFootprintViewer( top_project );
            if( !viewer )
            {
-                viewer = (FOOTPRINT_VIEWER_FRAME*) Kiface().CreateWindow( this, MODULE_VIEWER_FRAME_TYPE, &Kiway() );
+                KIFACE_I&   kf = Kiface();
+                viewer = (FOOTPRINT_VIEWER_FRAME*) kf.CreateWindow( this, MODULE_VIEWER_FRAME_TYPE, &Kiway(), kf.StartFlags() );
                viewer->Show( true );
                viewer->Zoom_Automatique( false );
            }

--- a/pcbnew/pcbframe.cpp
+++ b/pcbnew/pcbframe.cpp
@@ -85,9 +85,6 @@
 BEGIN_EVENT_TABLE( PCB_EDIT_FRAME, PCB_BASE_FRAME )
-    EVT_SOCKET( ID_EDA_SOCKET_EVENT_SERV, PCB_EDIT_FRAME::OnSockRequestServer )
-    EVT_SOCKET( ID_EDA_SOCKET_EVENT, PCB_EDIT_FRAME::OnSockRequest )
    EVT_COMBOBOX( ID_ON_ZOOM_SELECT, PCB_EDIT_FRAME::OnSelectZoom )
    EVT_COMBOBOX( ID_ON_GRID_SELECT, PCB_EDIT_FRAME::OnSelectGrid )
@@ -450,7 +447,7 @@ PCB_EDIT_FRAME::PCB_EDIT_FRAME( KIWAY* aKiway, wxWindow* aParent ) :
                          wxAuiPaneInfo( mesg ).Name( wxT( "MsgPanel" ) ).Bottom().Layer(10) );
-#ifdef KICAD_SCRIPTING_WXPYTHON
+#if defined(KICAD_SCRIPTING_WXPYTHON)
    // Add the scripting panel
    EDA_PANEINFO  pythonAuiInfo;
    pythonAuiInfo.ScriptingToolbarPane();
@@ -831,7 +828,7 @@ void PCB_EDIT_FRAME::SetGridColor(EDA_COLOR_T aColor)
 }
-bool PCB_EDIT_FRAME::IsMicroViaAcceptable( void )
+bool PCB_EDIT_FRAME::IsMicroViaAcceptable()
 {
    int copperlayercnt = GetBoard()->GetCopperLayerCount( );
    LAYER_NUM currLayer = getActiveLayer();
@@ -1106,7 +1103,7 @@ void PCB_EDIT_FRAME::UpdateTitle()
    SetTitle( title );
 }
-#ifdef KICAD_SCRIPTING_WXPYTHON
+#if defined(KICAD_SCRIPTING_WXPYTHON)
 void PCB_EDIT_FRAME::ScriptingConsoleEnableDisable( wxCommandEvent& aEvent )
 {
    if ( m_pythonPanelHidden )
@@ -1171,4 +1168,3 @@ void PCB_EDIT_FRAME::SetRotationAngle( int aRotationAngle )
    m_rotationAngle = aRotationAngle;
 }
--- a/pcbnew/pcbnew.cpp
+++ b/pcbnew/pcbnew.cpp
@@ -101,7 +101,7 @@ static struct IFACE : public KIFACE_I
        KIFACE_I( aName, aType )
    {}
-    bool OnKifaceStart( PGM_BASE* aProgram );
+    bool OnKifaceStart( PGM_BASE* aProgram, int aCtlBits );
    void OnKifaceEnd();
@@ -116,14 +116,16 @@ static struct IFACE : public KIFACE_I
                frame->Zoom_Automatique( true );
-#ifdef KICAD_SCRIPTING
+#if defined(KICAD_SCRIPTING)
                // give the scripting helpers access to our frame
                ScriptingSetPcbEditFrame( frame );
 #endif
-                // @todo temporarily here
+                if( Kiface().IsSingle() )
+                {
+                    // only run this under single_top, not under a project manager.
                    CreateServer( frame, KICAD_PCB_PORT_SERVICE_NUMBER );
+                }
                return frame;
            }
            break;
@@ -141,7 +143,6 @@ static struct IFACE : public KIFACE_I
                /* Read a default config file in case no project given on command line.
                frame->LoadProjectFile( wxEmptyString, true );
                */
                return frame;
            }
            break;
@@ -159,7 +160,6 @@ static struct IFACE : public KIFACE_I
                /* Read a default config file in case no project given on command line.
                frame->LoadProjectFile( wxEmptyString, true );
                */
                return frame;
            }
            break;
@@ -411,13 +411,13 @@ static bool scriptingSetup()
 FP_LIB_TABLE    GFootprintTable;
-bool IFACE::OnKifaceStart( PGM_BASE* aProgram )
+bool IFACE::OnKifaceStart( PGM_BASE* aProgram, int aCtlBits )
 {
    // This is process level, not project level, initialization of the DSO.
    // Do nothing in here pertinent to a project!
-    start_common();
+    start_common( aCtlBits );
    // Must be called before creating the main frame in order to
    // display the real hotkeys in menus or tool tips

--- a/pcbnew/ratsnest.cpp
+++ b/pcbnew/ratsnest.cpp
@@ -234,9 +234,10 @@ void PCB_BASE_FRAME::Build_Board_Ratsnest()
    {
        NETINFO_ITEM* net = m_Pcb->FindNet( current_net_code );
-        if( net == NULL )       //Should not occur
+        if( !net )       // Should not occur
        {
-            wxMessageBox( wxT( "Build_Board_Ratsnest() error: net not found" ) );
+            UTF8 msg = StrPrintf( "%s: error, net %d not found", __func__, current_net_code );
+            wxMessageBox( msg );   // BTW, it does happen.
            return;
        }