// -*- C++ -*-
-/* This file is part of
-* ======================================================
-*
-* LyX, The Document Processor
-*
-* Copyright (C) 1995 1996 Matthias Ettrich
-* and the LyX Team.
-*
-* ====================================================== */
-
-/* This is the declaration of the LyX class, there should only
- * exist _one_ instance of this in the application. */
+/**
+ * \file lyx_main.h
+ * This file is part of LyX, the document processor.
+ * Licence details can be found in the file COPYING.
+ *
+ * \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
-#include <csignal>
+#include <boost/scoped_ptr.hpp>
+#include <boost/shared_ptr.hpp>
+#include <boost/utility.hpp>
-#include "LString.h"
+#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 system_lyxdir;
-extern string user_lyxdir;
-extern string system_tempdir;
-
-extern LastFiles *lastfiles; /* we should hopefully be able to move this
- * inside the LyX class */
-
-extern LyXRC *lyxrc;
-
-
-/**
- This is the main LyX object it encapsulates most of the other objects.
-*/
-class LyX
-{
+/// initial startup
+class LyX : boost::noncopyable {
public:
- /**@name Constructors and Deconstructors */
- //@{
- /// the only allowed constructor
- LyX(int *argc, char *argv[]); // constructor
- // Always is useful a destructor
- ~LyX();
- //@}
-
- /**@name Pointers to... */
- //@{
- ///
- LyXGUI *lyxGUI; // should be only one of this
- //@}
+ /**
+ * 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
+ 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:
- /**@name Constructors and Deconstructors */
- //@{
- /// not allowed
- LyX(const LyX &){;} // not allowed
- /// not allowed
- LyX(){;} // not allowed
- //@}
-
- /**@name Private variables */
- //@{
- /// does this user start lyx for the first time?
+ 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_;
///
- struct sigaction act_;
- //@}
- /**@name Private Members */
- //@{
- ///
- void runtime();
- ///
- void init(int *argc, char *argv[]);
- ///
- void queryUserLyXDir();
- ///
- void ReadRcFile(string const & name);
- ///
- bool easyParse(int *argc, char *argv[]);
- //@}
-};
+ typedef std::list<LyXView *> ViewList;
+ ViewList views_;
-#endif
+ ///
+ bool geometryOption_;
+};
+#endif // LYX_MAIN_H