Commit 141f3fed authored by Dick Hollenbeck's avatar Dick Hollenbeck

some doxygen fixes, comment fixes

parent 95aa1919
...@@ -54,7 +54,7 @@ struct BIN_MOD ...@@ -54,7 +54,7 @@ struct BIN_MOD
const char* m_name; ///< name of this binary module, static C string. const char* m_name; ///< name of this binary module, static C string.
wxConfigBase* m_config; ///< maybe from $HOME/.<m_name> wxConfigBase* m_config; ///< maybe from $HOME/.${m_name}
wxFileHistory m_history; wxFileHistory m_history;
wxString m_help_file; wxString m_help_file;
......
...@@ -71,7 +71,7 @@ public: ...@@ -71,7 +71,7 @@ public:
* *
* @param aKifaceName should point to a C string in permanent storage, * @param aKifaceName should point to a C string in permanent storage,
* which contains the name of the DSO. Examples: "eeschema", "pcbnew", etc. * which contains the name of the DSO. Examples: "eeschema", "pcbnew", etc.
* This controls the name of the wxConfigBase established in m_kiway_settings, * This controls the name of the wxConfigBase established in m_bm,
* so it should be lowercase. * so it should be lowercase.
*/ */
KIFACE_I( const char* aKifaceName, KIWAY::FACE_T aId ) : KIFACE_I( const char* aKifaceName, KIWAY::FACE_T aId ) :
......
...@@ -194,7 +194,7 @@ struct KIFACE ...@@ -194,7 +194,7 @@ struct KIFACE
* *
* @param aKIWAY tells the window which KIWAY (and PROJECT) it is a participant in. * @param aKIWAY tells the window which KIWAY (and PROJECT) it is a participant in.
* *
* @param aCtlBits consists of bit flags from the set of KFCTL_* #defines above. * @param aCtlBits consists of bit flags from the set of KFCTL_* \#defines above.
* *
* @return wxWindow* - and if not NULL, should be cast into the known type using * @return wxWindow* - and if not NULL, should be cast into the known type using
* dynamic_cast&lt;&gt;(). * dynamic_cast&lt;&gt;().
......
...@@ -65,7 +65,7 @@ public: ...@@ -65,7 +65,7 @@ public:
* Function Prj * Function Prj
* returns a reference to the PROJECT "associated with" this KIWAY. * returns a reference to the PROJECT "associated with" this KIWAY.
*/ */
PROJECT& Prj() const; // coded in kiface_i.cpp for now PROJECT& Prj() const;
/** /**
* Function SetKiway * Function SetKiway
...@@ -76,7 +76,7 @@ public: ...@@ -76,7 +76,7 @@ public:
* *
* @param aKiway is often from a parent window, or from KIFACE::CreateWindow(). * @param aKiway is often from a parent window, or from KIFACE::CreateWindow().
*/ */
void SetKiway( wxWindow* aDest, KIWAY* aKiway ); // in kiface_i.cpp for now void SetKiway( wxWindow* aDest, KIWAY* aKiway );
private: private:
// private, all setting is done through SetKiway(). // private, all setting is done through SetKiway().
...@@ -142,6 +142,8 @@ public: ...@@ -142,6 +142,8 @@ public:
* according to the knowledge in the derived wxFrame. In almost every case, * according to the knowledge in the derived wxFrame. In almost every case,
* the list will have only a single file in it. * the list will have only a single file in it.
* *
* @param aCtl is a set of bit flags ORed together from the set of KICTL_* \#defined above.
*
* @return bool - true if all requested files were opened OK, else false. * @return bool - true if all requested files were opened OK, else false.
*/ */
virtual bool OpenProjectFiles( const std::vector<wxString>& aFileList, int aCtl = 0 ) virtual bool OpenProjectFiles( const std::vector<wxString>& aFileList, int aCtl = 0 )
......
...@@ -199,8 +199,9 @@ void PGM_KICAD::destroy() ...@@ -199,8 +199,9 @@ void PGM_KICAD::destroy()
/** /**
* Class KIWAY_MGR * Class KIWAY_MGR
* is container for all (KIWAYS and PROJECTS). This class needs to work both for a C++ * is a container for all KIWAYS [and PROJECTS]. This class needs to work both
* project manager and an a wxPython one (after being moved into a header later). * for a C++ project manager and an a wxPython one (after being moved into a
* header later).
*/ */
class KIWAY_MGR class KIWAY_MGR
{ {
...@@ -220,7 +221,8 @@ public: ...@@ -220,7 +221,8 @@ public:
private: private:
// KIWAYs may not be moved once doled out. // 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. // boost_ptr::vector however never moves the object pointed to.
typedef boost::ptr_vector<KIWAY> KIWAYS; typedef boost::ptr_vector<KIWAY> KIWAYS;
...@@ -280,6 +282,7 @@ PROJECT& Prj() ...@@ -280,6 +282,7 @@ PROJECT& Prj()
bool KIWAY_MGR::OnStart( wxApp* aProcess ) bool KIWAY_MGR::OnStart( wxApp* aProcess )
{ {
// The C++ project manager supports only one open PROJECT // The C++ project manager supports only one open PROJECT
// We should need no copy constructor for KIWAY to push a pointer.
m_kiways.push_back( new KIWAY() ); m_kiways.push_back( new KIWAY() );
return true; return true;
...@@ -289,85 +292,3 @@ bool KIWAY_MGR::OnStart( wxApp* aProcess ) ...@@ -289,85 +292,3 @@ bool KIWAY_MGR::OnStart( wxApp* aProcess )
void KIWAY_MGR::OnEnd() void KIWAY_MGR::OnEnd()
{ {
} }
/*
static bool init( KICAD_PGM* aProcess, const wxString& aName )
{
m_Id = aId;
m_Checker = new wxSingleInstanceChecker( aName.Lower() + wxT( "-" ) + wxGetUserId() );
// Init KiCad environment
// the environment variable KICAD (if exists) gives the kicad path:
// something like set KICAD=d:\kicad
bool isDefined = wxGetEnv( wxT( "KICAD" ), &m_KicadEnv );
if( isDefined ) // ensure m_KicadEnv ends by "/"
{
m_KicadEnv.Replace( WIN_STRING_DIR_SEP, UNIX_STRING_DIR_SEP );
if( !m_KicadEnv.IsEmpty() && m_KicadEnv.Last() != '/' )
m_KicadEnv += UNIX_STRING_DIR_SEP;
}
// Prepare On Line Help. Use only lower case for help file names, in order to
// avoid problems with upper/lower case file names under windows and unix.
#if defined ONLINE_HELP_FILES_FORMAT_IS_HTML
m_HelpFileName = aName.Lower() + wxT( ".html" );
#elif defined ONLINE_HELP_FILES_FORMAT_IS_PDF
m_HelpFileName = aName.Lower() + wxT( ".pdf" );
#else
#error Help files format not defined
#endif
// Init parameters for configuration
SetVendorName( wxT( "KiCad" ) );
SetAppName( aName.Lower() );
SetTitle( aName );
m_settings = new wxConfig();
wxASSERT( m_settings != NULL );
m_commonSettings = new wxConfig( CommonConfigPath );
wxASSERT( m_commonSettings != NULL );
// Install some image handlers, mainly for help
wxImage::AddHandler( new wxPNGHandler );
wxImage::AddHandler( new wxGIFHandler );
wxImage::AddHandler( new wxJPEGHandler );
wxFileSystem::AddHandler( new wxZipFSHandler );
// Analyze the command line & init binary path
SetBinDir();
SetDefaultSearchPaths();
SetLanguagePath();
ReadPdfBrowserInfos();
// Internationalization: loading the kicad suitable Dictionary
wxString languageSel;
m_commonSettings->Read( languageCfgKey, &languageSel);
setLanguageId( wxLANGUAGE_DEFAULT );
// Search for the current selection
for( unsigned ii = 0; ii < DIM( s_Languages ); ii++ )
{
if( s_Languages[ii].m_Lang_Label == languageSel )
{
setLanguageId( s_Languages[ii].m_WX_Lang_Identifier );
break;
}
}
bool succes = SetLanguage( true );
if( !succes )
{
}
// Set locale option for separator used in float numbers
SetLocaleTo_Default();
}
*/
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment