minimal effort implementation of:

[lyx.git] / src / lyx_main.h

diff --git a/src/lyx_main.h b/src/lyx_main.h
index aa4e1120c8f8b749b7015c286a0c5a29b4c05deb..55fdd631b6e63258da3d4d1a11092d09b6b987f9 100644 (file)
--- a/src/lyx_main.h
+++ b/src/lyx_main.h
@@ -1,79 +1,116 @@
 // -*- C++ -*-
 /**
  * \file lyx_main.h
- * Copyright 2002 the LyX Team
- * Read the file COPYING
+ * This file is part of LyX, the document processor.
+ * Licence details can be found in the file COPYING.
  *
- * \author unknown
+ * \author Lars Gullik Bjønnes
+ * \author Jean-Marc Lasgouttes
+ * \author John Levon
+ *
+ * Full author contact details are available in file CREDITS.
  */
 
 #ifndef LYX_MAIN_H
 #define LYX_MAIN_H
 
-#ifdef __GNUG__
-#pragma interface
-#endif
-
-#include "LString.h"
-
 #include <boost/scoped_ptr.hpp>
+#include <boost/shared_ptr.hpp>
 #include <boost/utility.hpp>
 
-#include <csignal>
+#include <list>
+#include <string>
 
-class LyXGUI;
-class LyXRC;
-class LastFiles;
 class Buffer;
+class ErrorItem;
+class InsetBase;
+class LyXView;
 class kb_keymap;
+namespace lyx {
+       class Session;
+}
 
 
-///
-extern string user_lyxdir;
-///
-extern string system_lyxdir;
-///
-extern string system_tempdir;
-///
-extern boost::scoped_ptr<LastFiles> lastfiles;
-
-
+/// initial startup
 class LyX : boost::noncopyable {
 public:
-       LyX(int * argc, char * argv[]);
+       /**
+        * Execute LyX. The startup sequence is as follows:
+        * -# LyX::exec()
+        * -# LyX::priv_exec()
+        * -# lyx_gui::exec()
+        * -# LyX::exec2()
+        * Step 3 is omitted if no gui is wanted. We need lyx_gui::exec()
+        * only to create the QApplication object in the qt frontend. All
+        * attempts with static and dynamically allocated QApplication
+        * objects lead either to harmless error messages on exit
+        * ("Mutex destroy failure") or crashes (OS X).
+        */
+       static int exec(int & argc, char * argv[]);
+       /// Execute LyX (inner execution loop, \sa exec)
+       int exec2(int & argc, char * argv[]);
+       static LyX & ref();
+       static LyX const & cref();
 
        /// in the case of failure
-       static void emergencyCleanup();
+       void emergencyCleanup() const;
+
+       lyx::Session & session();
+       lyx::Session const & session() const;
+
+       void addLyXView(LyXView * lyxview);
+
+       /** redraw \c inset in all the BufferViews in which it is currently
+        *  visible. If successful return a pointer to the owning Buffer.
+        */
+       Buffer const * const updateInset(InsetBase const *) const;
 
 private:
-       /// Should be a maximum of 1 LyXGUI.
-       boost::scoped_ptr<LyXGUI> lyxGUI;
-       /// does this user start lyx for the first time?
-       bool first_start;
-       ///
-       string batch_command;
-       ///
-       void runtime();
-       ///
-       void init(bool);
-       ///
+       static boost::scoped_ptr<LyX> singleton_;
+
+       LyX();
+       int priv_exec(int & argc, char * argv[]);
+
+       /// initial LyX set up
+       bool init();
+       /// set up the default key bindings
        void defaultKeyBindings(kb_keymap * kbmap);
-       ///
+       /// set up the default dead key bindings if requested
        void deadKeyBindings(kb_keymap * kbmap);
+       /** Check for the existence of the user's support directory and,
+        *  if not present, create it. Exits the program if the directory
+        *  cannot be created.
+        *  \returns true if the user-side configuration script
+        *  (lib/configure) should be re-run in this directory.
+        */
+       bool queryUserLyXDir(bool explicit_userdir);
+       /// read lyxrc/preferences
+       bool readRcFile(std::string const & name);
+       /// read the given ui (menu/toolbar) file
+       bool readUIFile(std::string const & name);
+       /// read the given languages file
+       bool readLanguagesFile(std::string const & name);
+       /// read the given encodings file
+       bool readEncodingsFile(std::string const & name);
+       /// parsing of non-gui LyX options. Returns true if gui
+       bool easyParse(int & argc, char * argv[]);
+       /// shows up a parsing error on screen
+       void printError(ErrorItem const &);
+
+       /// has this user started lyx for the first time?
+       bool first_start;
+       /// the parsed command line batch command if any
+       std::string batch_command;
+
+       /// lyx session, containing lastfiles, lastfilepos, and lastopened
+       boost::scoped_ptr<lyx::Session> session_;
        ///
-       void queryUserLyXDir(bool explicit_userdir);
-       /** Search for and read the LyXRC file name, return
-           true if successfull.
-       */
-       bool readRcFile(string const & name);
-       /// Read the ui file `name'
-       void readUIFile(string const & name);
-       /// Read the languages file `name'
-       void readLanguagesFile(string const & name);
-       /// Read the encodings file `name'
-       void readEncodingsFile(string const & name);
+       typedef std::list<LyXView *> ViewList;
+       ViewList views_;
+
        ///
-       bool easyParse(int * argc, char * argv[]);
+       bool geometryOption_;
+
 };
 
-#endif
+#endif // LYX_MAIN_H