X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=src%2Flyx_main.h;h=ab1619f97e7372a30b189ec50a4817141ad1ee43;hb=35204f8f33d7400a5fefeffea533fb4cb4097211;hp=087b8fb0432e26a959fa7cd22e23bfebe0f452d0;hpb=0b98ee5f2ec731d156b976856b0db52dc9534e59;p=lyx.git diff --git a/src/lyx_main.h b/src/lyx_main.h index 087b8fb043..ab1619f97e 100644 --- a/src/lyx_main.h +++ b/src/lyx_main.h @@ -1,85 +1,170 @@ // -*- 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 +#include -#include +#include +#include -#include "LString.h" -#include +namespace lyx { -class LyXGUI; -class LyXRC; -class LastFiles; class Buffer; +class BufferList; +class ErrorItem; +class IconvProcessor; +class InsetBase; +class LyXFunc; +class LyXServer; +class LyXServerSocket; +class LyXView; +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. The startup sequence is as follows: + * -# LyX::exec() + * -# LyX::priv_exec() + * -# lyx::createApplication() + * Step 3 is omitted if no gui is wanted. We need lyx::createApplication() + * 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). + */ + int exec(int & argc, char * argv[]); + + static LyX & ref(); + static LyX const & cref(); + + /// in the case of failure + void emergencyCleanup() const; + + /// Ask the LyX class to exit. + /** + In GUI mode, after this function has been called, application_ leaves + the main event loop and returns from the call to Application::start(). + */ + void quit(); + /// - 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. + IconvProcessor & iconvProcessor(); + + 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; + +private: + /// Do some cleanup in preparation of an exit. + void prepareExit(); + + /// Early exit during the initialisation process. + void earlyExit(int status); + + /// Initialise LyX and execute batch commands if available. + /** + \param files is filled in with the command-line file names. + \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 execBatchCommands(int & argc, char * argv[], + std::vector & files); + + /// Create a View and restore GUI Session. + void restoreGuiSession(std::vector const & files); + + /// 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); + /// 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. + 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 pimpl_; + + /// + bool geometryOption_; }; -#endif +} // namespace lyx + +#endif // LYX_MAIN_H