// -*- C++ -*-
-/* This file is part of
-* ======================================================
-*
-* LyX, The Document Processor
-*
-* Copyright 1995 Matthias Ettrich
-* Copyright 1995-2000 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
-#ifdef __GNUG__
-#pragma interface
-#endif
+#include <boost/scoped_ptr.hpp>
+#include <boost/utility.hpp>
-#include <csignal>
+#include <string>
-#include "LString.h"
-#include <boost/utility.hpp>
+namespace lyx {
-class LyXGUI;
-class LyXRC;
-class LastFiles;
class Buffer;
+class BufferList;
+class Converters;
+class ErrorItem;
+class InsetBase;
+class LyXFunc;
+class LyXServer;
+class LyXServerSocket;
+class LyXView;
+class Messages;
+class Mover;
+class Movers;
+class Session;
class kb_keymap;
-///
-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 bool use_gui;
+namespace frontend { class Application; }
-/**
- This is the main LyX object it encapsulates most of the other objects.
-*/
+/// initial startup
class LyX : boost::noncopyable {
public:
- /// the only allowed constructor
- LyX(int * argc, char * argv[]); // constructor
- /// Always is useful a destructor
+
+ LyX();
~LyX();
+ /// Execute LyX.
+ int exec(int & argc, char * argv[]);
+
+ static LyX & ref();
+ static LyX const & cref();
+
+ /// in the case of failure
+ void emergencyCleanup() const;
+
///
- LyXGUI * lyxGUI; // should be only one of this
-private:
- /// does this user start lyx for the first time?
- bool first_start;
+ BufferList & bufferList();
+ BufferList const & bufferList() const;
///
- string batch_command;
+ Session & session();
+ Session const & session() const;
///
- void runtime();
+ LyXFunc & lyxFunc();
+ LyXFunc const & lyxFunc() const;
///
- void init(int * argc, char * argv[], bool);
+ LyXServer & server();
+ LyXServer const & server() const;
///
- void defaultKeyBindings(kb_keymap * kbmap);
+ LyXServerSocket & socket();
+ LyXServerSocket const & socket() const;
+
///
- void deadKeyBindings(kb_keymap * kbmap);
+ frontend::Application & application();
+ frontend::Application const & application() const;
+
+ ///
+ kb_keymap & topLevelKeymap();
+ kb_keymap const & topLevelKeymap() const;
+
///
- void queryUserLyXDir(bool explicit_userdir);
- /** Search for and read the LyXRC file name, return
- true if successfull.
+ Converters & converters();
+ Converters & systemConverters();
+
+ ///
+ Messages & getMessages(std::string const & language);
+ ///
+ Messages & getGuiMessages();
+ ///
+ void setGuiLanguage(std::string const & language);
+
+ ///
+ LyXView * newLyXView();
+
+ /** 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;
+
+ /// Execute batch commands if available.
+ void execBatchCommands();
+
+private:
+ /// Do some cleanup in preparation of an exit.
+ void prepareExit();
+
+ /// Early exit during the initialisation process.
+ void earlyExit(int status);
+
+ /// Initialise LyX and fills-in the vector of files to be loaded.
+ /**
+ \return exit code failure if any.
*/
- 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);
- ///
- bool easyParse(int * argc, char * argv[]);
+ int init(int & argc, char * argv[]);
+
+ /// Load files passed at command-line.
+ /**
+ This method is used only in non-GUI mode.
+ */
+ void loadFiles();
+
+ /// Create a View, load files and restore GUI Session.
+ void restoreGuiSession();
+
+ /// Initialize RC font for the GUI.
+ void initGuiFont();
+
+ /// 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, bool include = false);
+ /// read the given languages file
+ bool readLanguagesFile(std::string const & name);
+ /// read the encodings.
+ /// \param enc_name encodings definition file
+ /// \param symbols_name unicode->LaTeX mapping file
+ bool readEncodingsFile(std::string const & enc_name,
+ std::string const & symbols_name);
+ /// parsing of non-gui LyX options.
+ void 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;
+
+ /// Use the Pimpl idiom to hide the internals.
+ struct Singletons;
+ boost::scoped_ptr<Singletons> pimpl_;
+
+ friend Movers & theMovers();
+ friend Mover const & getMover(std::string const & fmt);
+ friend void setMover(std::string const & fmt, std::string const & command);
+ friend Movers & theSystemMovers();
+ friend frontend::Application * theApp();
};
-#endif
+} // namespace lyx
+
+#endif // LYX_MAIN_H