3 * This file is part of LyX, the document processor.
4 * Licence details can be found in the file COPYING.
6 * \author Alfredo Braunstein
7 * \author Lars Gullik Bjønnes
8 * \author Jean-Marc Lasgouttes
10 * \author André Pönitz
12 * Full author contact details are available in file CREDITS.
20 #include "AspellChecker.h"
22 #include "BufferList.h"
25 #include "ConverterCache.h"
26 #include "Converter.h"
27 #include "CutAndPaste.h"
28 #include "EnchantChecker.h"
30 #include "ErrorList.h"
32 #include "FuncStatus.h"
33 #include "HunspellChecker.h"
36 #include "LayoutFile.h"
39 #include "LyXAction.h"
41 #include "ModuleList.h"
44 #include "ServerSocket.h"
47 #include "frontends/alert.h"
48 #include "frontends/Application.h"
50 #include "graphics/Previews.h"
52 #include "support/lassert.h"
53 #include "support/debug.h"
54 #include "support/environment.h"
55 #include "support/ExceptionMessage.h"
56 #include "support/filetools.h"
57 #include "support/gettext.h"
58 #include "support/lstrings.h"
59 #include "support/Messages.h"
60 #include "support/os.h"
61 #include "support/Package.h"
62 #include "support/Path.h"
63 #include "support/Systemcall.h"
65 #include <boost/bind.hpp>
66 #include <boost/scoped_ptr.hpp>
77 using namespace lyx::support;
81 namespace Alert = frontend::Alert;
82 namespace os = support::os;
86 // Are we using the GUI at all? We default to true and this is changed
87 // to false when the export feature is used.
93 // Filled with the command line arguments "foo" of "-sysdir foo" or
95 string cl_system_support;
96 string cl_user_support;
100 LyX * singleton_ = 0;
102 void showFileError(string const & error)
104 Alert::warning(_("Could not read configuration file"),
105 bformat(_("Error while reading the configuration file\n%1$s.\n"
106 "Please check your installation."), from_utf8(error)));
110 void reconfigureUserLyXDir()
112 string const configure_command = package().configure_command();
114 lyxerr << to_utf8(_("LyX: reconfiguring user directory")) << endl;
115 PathChanger p(package().user_support());
117 one.startscript(Systemcall::Wait, configure_command);
118 lyxerr << "LyX: " << to_utf8(_("Done!")) << endl;
123 /// The main application class private implementation.
126 Impl() : spell_checker_(0), aspell_checker_(0), enchant_checker_(0), hunspell_checker_(0)
128 // Set the default User Interface language as soon as possible.
129 // The language used will be derived from the environment
131 messages_["GUI"] = Messages();
136 delete aspell_checker_;
137 delete enchant_checker_;
138 delete hunspell_checker_;
142 BufferList buffer_list_;
144 KeyMap toplevel_keymap_;
146 CmdDef toplevel_cmddef_;
148 boost::scoped_ptr<Server> lyx_server_;
150 boost::scoped_ptr<ServerSocket> lyx_socket_;
152 boost::scoped_ptr<frontend::Application> application_;
153 /// lyx session, containing lastfiles, lastfilepos, and lastopened
154 boost::scoped_ptr<Session> session_;
156 /// Files to load at start.
157 vector<string> files_to_load_;
159 /// The messages translators.
160 map<string, Messages> messages_;
162 /// The file converters.
163 Converters converters_;
165 // The system converters copy after reading lyxrc.defaults.
166 Converters system_converters_;
171 Movers system_movers_;
173 /// has this user started lyx for the first time?
175 /// the parsed command line batch command if any
176 vector<string> batch_commands;
179 graphics::Previews preview_;
181 SpellChecker * spell_checker_;
183 SpellChecker * aspell_checker_;
185 SpellChecker * enchant_checker_;
187 SpellChecker * hunspell_checker_;
191 frontend::Application * theApp()
194 return singleton_->pimpl_->application_.get();
207 void lyx_exit(int exit_code)
210 // Something wrong happened so better save everything, just in
215 // Properly crash in debug mode in order to get a useful backtrace.
219 // In release mode, try to exit gracefully.
221 theApp()->exit(exit_code);
235 Messages & LyX::messages(string const & language)
237 map<string, Messages>::iterator it = pimpl_->messages_.find(language);
239 if (it != pimpl_->messages_.end())
242 pair<map<string, Messages>::iterator, bool> result =
243 pimpl_->messages_.insert(make_pair(language, Messages(language)));
245 LASSERT(result.second, /**/);
246 return result.first->second;
250 void setRcGuiLanguage()
252 LASSERT(singleton_, /**/);
253 if (lyxrc.gui_language == "auto")
255 Language const * language = languages.getLanguage(lyxrc.gui_language);
257 LYXERR(Debug::LOCALE, "Setting LANGUAGE to " << language->code());
258 if (!setEnv("LANGUAGE", language->code()))
259 LYXERR(Debug::LOCALE, "\t... failed!");
261 LYXERR(Debug::LOCALE, "Setting LC_ALL to en_US");
262 if (!setEnv("LC_ALL", "en_US"))
263 LYXERR(Debug::LOCALE, "\t... failed!");
265 singleton_->pimpl_->messages_["GUI"] = Messages();
269 int LyX::exec(int & argc, char * argv[])
271 // Here we need to parse the command line. At least
272 // we need to parse for "-dbg" and "-help"
273 easyParse(argc, argv);
276 init_package(os::utf8_argv(0),
277 cl_system_support, cl_user_support,
278 top_build_dir_is_one_level_up);
279 } catch (ExceptionMessage const & message) {
280 if (message.type_ == ErrorException) {
281 Alert::error(message.title_, message.details_);
283 } else if (message.type_ == WarningException) {
284 Alert::warning(message.title_, message.details_);
288 // Reinit the messages machinery in case package() knows
289 // something interesting about the locale directory.
293 // FIXME: create a ConsoleApplication
294 int exit_status = init(argc, argv);
300 // this is correct, since return values are inverted.
301 exit_status = !loadFiles();
303 if (pimpl_->batch_commands.empty() || pimpl_->buffer_list_.empty()) {
308 BufferList::iterator begin = pimpl_->buffer_list_.begin();
310 bool final_success = false;
311 for (BufferList::iterator I = begin; I != pimpl_->buffer_list_.end(); ++I) {
313 if (buf != buf->masterBuffer())
315 vector<string>::const_iterator bcit = pimpl_->batch_commands.begin();
316 vector<string>::const_iterator bcend = pimpl_->batch_commands.end();
318 for (; bcit != bcend; bcit++) {
319 LYXERR(Debug::ACTION, "Buffer::dispatch: cmd: " << *bcit);
320 buf->dispatch(*bcit, dr);
321 final_success |= !dr.error();
325 return !final_success;
328 // Let the frontend parse and remove all arguments that it knows
329 pimpl_->application_.reset(createApplication(argc, argv));
331 // Reestablish our defaults, as Qt overwrites them
332 // after createApplication()
335 // Parse and remove all known arguments in the LyX singleton
336 // Give an error for all remaining ones.
337 int exit_status = init(argc, argv);
339 // Kill the application object before exiting.
340 pimpl_->application_.reset();
347 /* Create a CoreApplication class that will provide the main event loop
348 * and the socket callback registering. With Qt4, only QtCore
349 * library would be needed.
350 * When this is done, a server_mode could be created and the following two
351 * line would be moved out from here.
353 // Note: socket callback must be registered after init(argc, argv)
354 // such that package().temp_dir() is properly initialized.
355 pimpl_->lyx_server_.reset(new Server(lyxrc.lyxpipes));
356 pimpl_->lyx_socket_.reset(new ServerSocket(
357 FileName(package().temp_dir().absFilename() + "/lyxsocket")));
359 // Start the real execution loop.
360 exit_status = pimpl_->application_->exec();
368 void LyX::prepareExit()
370 // Clear the clipboard and selection stack:
371 cap::clearCutStack();
372 cap::clearSelection();
374 // Write the index file of the converter cache
375 ConverterCache::get().writeIndex();
377 // close buffers first
378 pimpl_->buffer_list_.closeAll();
380 // register session changes and shutdown server and socket
382 if (pimpl_->session_)
383 pimpl_->session_->writeFile();
384 pimpl_->session_.reset();
385 pimpl_->lyx_server_.reset();
386 pimpl_->lyx_socket_.reset();
389 // do any other cleanup procedures now
390 if (package().temp_dir() != package().system_temp_dir()) {
391 string const abs_tmpdir = package().temp_dir().absFilename();
392 if (!contains(package().temp_dir().absFilename(), "lyx_tmpdir")) {
393 docstring const msg =
394 bformat(_("%1$s does not appear like a LyX created temporary directory."),
395 from_utf8(abs_tmpdir));
396 Alert::warning(_("Cannot remove temporary directory"), msg);
398 LYXERR(Debug::INFO, "Deleting tmp dir "
399 << package().temp_dir().absFilename());
400 if (!package().temp_dir().destroyDirectory()) {
401 docstring const msg =
402 bformat(_("Unable to remove the temporary directory %1$s"),
403 from_utf8(package().temp_dir().absFilename()));
404 Alert::warning(_("Unable to remove temporary directory"), msg);
409 // Kill the application object before exiting. This avoids crashes
410 // when exiting on Linux.
411 if (pimpl_->application_)
412 pimpl_->application_.reset();
416 void LyX::earlyExit(int status)
418 LASSERT(pimpl_->application_.get(), /**/);
419 // LyX::pimpl_::application_ is not initialised at this
420 // point so it's safe to just exit after some cleanup.
426 int LyX::init(int & argc, char * argv[])
428 // check for any spurious extra arguments
429 // other than documents
430 for (int argi = 1; argi < argc ; ++argi) {
431 if (argv[argi][0] == '-') {
433 bformat(_("Wrong command line option `%1$s'. Exiting."),
434 from_utf8(os::utf8_argv(argi)))) << endl;
439 // Initialization of LyX (reads lyxrc and more)
440 LYXERR(Debug::INIT, "Initializing LyX::init...");
441 bool success = init();
442 LYXERR(Debug::INIT, "Initializing LyX::init...done");
446 // Remaining arguments are assumed to be files to load.
447 for (int argi = argc - 1; argi >= 1; --argi)
448 pimpl_->files_to_load_.push_back(os::utf8_argv(argi));
451 pimpl_->files_to_load_.push_back(
452 i18nLibFileSearch("examples", "splash.lyx").absFilename());
459 bool LyX::loadFiles()
461 LASSERT(!use_gui, /**/);
463 vector<string>::const_iterator it = pimpl_->files_to_load_.begin();
464 vector<string>::const_iterator end = pimpl_->files_to_load_.end();
466 for (; it != end; ++it) {
467 // get absolute path of file and add ".lyx" to
468 // the filename if necessary
469 FileName fname = fileSearch(string(), os::internal_path(*it), "lyx",
475 Buffer * buf = pimpl_->buffer_list_.newBuffer(fname.absFilename(), false);
476 if (buf->loadLyXFile(fname)) {
477 ErrorList const & el = buf->errorList("Parse");
479 for_each(el.begin(), el.end(),
480 boost::bind(&LyX::printError, this, _1));
483 pimpl_->buffer_list_.release(buf);
491 void execBatchCommands()
493 LASSERT(singleton_, /**/);
494 singleton_->execCommands();
498 void LyX::execCommands()
500 // The advantage of doing this here is that the event loop
501 // is already started. So any need for interaction will be
504 // if reconfiguration is needed.
505 if (LayoutFileList::get().empty()) {
506 switch (Alert::prompt(
507 _("No textclass is found"),
508 _("LyX will have minimal functionality because no textclasses "
509 "have been found. You can either try to reconfigure LyX normally, "
510 "try to reconfigure using only the defaults, or continue."),
517 // regular reconfigure
518 lyx::dispatch(FuncRequest(LFUN_RECONFIGURE, ""));
521 // reconfigure --without-latex-config
522 lyx::dispatch(FuncRequest(LFUN_RECONFIGURE,
523 " --without-latex-config"));
530 // create the first main window
531 lyx::dispatch(FuncRequest(LFUN_WINDOW_NEW, geometryArg));
533 if (!pimpl_->files_to_load_.empty()) {
534 // if some files were specified at command-line we assume that the
535 // user wants to edit *these* files and not to restore the session.
536 for (size_t i = 0; i != pimpl_->files_to_load_.size(); ++i) {
538 FuncRequest(LFUN_FILE_OPEN, pimpl_->files_to_load_[i]));
540 // clear this list to save a few bytes of RAM
541 pimpl_->files_to_load_.clear();
543 pimpl_->application_->restoreGuiSession();
545 // Execute batch commands if available
546 if (pimpl_->batch_commands.empty())
549 vector<string>::const_iterator bcit = pimpl_->batch_commands.begin();
550 vector<string>::const_iterator bcend = pimpl_->batch_commands.end();
551 for (; bcit != bcend; bcit++) {
552 LYXERR(Debug::INIT, "About to handle -x '" << *bcit << '\'');
553 lyx::dispatch(lyxaction.lookupFunc(*bcit));
561 The SIGHUP signal does not exist on Windows and does not need to be handled.
563 Windows handles SIGFPE and SIGSEGV signals as expected.
565 Ctrl+C interrupts (mapped to SIGINT by Windows' POSIX compatability layer)
566 cause a new thread to be spawned. This may well result in unexpected
567 behaviour by the single-threaded LyX.
569 SIGTERM signals will come only from another process actually sending
570 that signal using 'raise' in Windows' POSIX compatability layer. It will
571 not come from the general "terminate process" methods that everyone
572 actually uses (and which can't be trapped). Killing an app 'politely' on
573 Windows involves first sending a WM_CLOSE message, something that is
574 caught already by the Qt frontend.
576 For more information see:
578 http://aspn.activestate.com/ASPN/Mail/Message/ActiveTcl/2034055
579 ...signals are mostly useless on Windows for a variety of reasons that are
582 'UNIX Application Migration Guide, Chapter 9'
583 http://msdn.microsoft.com/library/en-us/dnucmg/html/UCMGch09.asp
585 'How To Terminate an Application "Cleanly" in Win32'
586 http://support.microsoft.com/default.aspx?scid=kb;en-us;178893
590 static void error_handler(int err_sig)
592 // Throw away any signals other than the first one received.
593 static sig_atomic_t handling_error = false;
596 handling_error = true;
598 // We have received a signal indicating a fatal error, so
599 // try and save the data ASAP.
602 // These lyxerr calls may or may not work:
604 // Signals are asynchronous, so the main program may be in a very
605 // fragile state when a signal is processed and thus while a signal
606 // handler function executes.
607 // In general, therefore, we should avoid performing any
608 // I/O operations or calling most library and system functions from
611 // This shouldn't matter here, however, as we've already invoked
617 msg = _("SIGHUP signal caught!\nBye.");
621 msg = _("SIGFPE signal caught!\nBye.");
624 msg = _("SIGSEGV signal caught!\n"
625 "Sorry, you have found a bug in LyX, "
626 "hope you have not lost any data.\n"
627 "Please read the bug-reporting instructions "
628 "in 'Help->Introduction' and send us a bug report, "
629 "if necessary. Thanks !\nBye.");
638 lyxerr << "\nlyx: " << msg << endl;
639 // try to make a GUI message
640 Alert::error(_("LyX crashed!"), msg);
643 // Deinstall the signal handlers
645 signal(SIGHUP, SIG_DFL);
647 signal(SIGINT, SIG_DFL);
648 signal(SIGFPE, SIG_DFL);
649 signal(SIGSEGV, SIG_DFL);
650 signal(SIGTERM, SIG_DFL);
653 if (err_sig == SIGSEGV ||
654 (err_sig != SIGHUP && !getEnv("LYXDEBUG").empty())) {
656 if (err_sig == SIGSEGV || !getEnv("LYXDEBUG").empty()) {
659 // with abort() it crashes again.
672 void LyX::printError(ErrorItem const & ei)
674 docstring tmp = _("LyX: ") + ei.error + char_type(':')
676 cerr << to_utf8(tmp) << endl;
683 signal(SIGHUP, error_handler);
685 signal(SIGFPE, error_handler);
686 signal(SIGSEGV, error_handler);
687 signal(SIGINT, error_handler);
688 signal(SIGTERM, error_handler);
689 // SIGPIPE can be safely ignored.
691 lyxrc.tempdir_path = package().temp_dir().absFilename();
692 lyxrc.document_path = package().document_dir().absFilename();
694 if (lyxrc.example_path.empty()) {
695 lyxrc.example_path = addPath(package().system_support().absFilename(),
698 if (lyxrc.template_path.empty()) {
699 lyxrc.template_path = addPath(package().system_support().absFilename(),
704 // Read configuration files
707 // This one may have been distributed along with LyX.
708 if (!readRcFile("lyxrc.dist"))
711 // Set the language defined by the distributor.
714 // Set the PATH correctly.
715 #if !defined (USE_POSIX_PACKAGING)
716 // Add the directory containing the LyX executable to the path
717 // so that LyX can find things like tex2lyx.
718 if (package().build_support().empty())
719 prependEnvPath("PATH", package().binary_dir().absFilename());
721 if (!lyxrc.path_prefix.empty())
722 prependEnvPath("PATH", lyxrc.path_prefix);
724 // Check that user LyX directory is ok.
725 if (queryUserLyXDir(package().explicit_user_support()))
726 reconfigureUserLyXDir();
728 // no need for a splash when there is no GUI
733 // This one is generated in user_support directory by lib/configure.py.
734 if (!readRcFile("lyxrc.defaults"))
737 // Query the OS to know what formats are viewed natively
738 formats.setAutoOpen();
740 // Read lyxrc.dist again to be able to override viewer auto-detection.
741 readRcFile("lyxrc.dist");
743 // Set again the language defined by the distributor.
746 system_lyxrc = lyxrc;
747 system_formats = formats;
748 pimpl_->system_converters_ = pimpl_->converters_;
749 pimpl_->system_movers_ = pimpl_->movers_;
750 system_lcolor = lcolor;
752 // This one is edited through the preferences dialog.
753 if (!readRcFile("preferences"))
756 if (!readEncodingsFile("encodings", "unicodesymbols"))
758 if (!readLanguagesFile("languages"))
761 // Set the language defined by the user.
764 LYXERR(Debug::INIT, "Reading layouts...");
766 LayoutFileList::get().read();
768 theModuleList.read();
770 // read keymap and ui files in batch mode as well
771 // because InsetInfo needs to know these to produce
772 // the correct output
774 // Set up command definitions
775 pimpl_->toplevel_cmddef_.read(lyxrc.def_file);
778 pimpl_->toplevel_keymap_.read("site");
779 pimpl_->toplevel_keymap_.read(lyxrc.bind_file);
780 // load user bind file user.bind
781 pimpl_->toplevel_keymap_.read("user", 0, KeyMap::MissingOK);
783 if (lyxerr.debugging(Debug::LYXRC))
786 os::windows_style_tex_paths(lyxrc.windows_style_tex_paths);
787 if (!lyxrc.path_prefix.empty())
788 prependEnvPath("PATH", lyxrc.path_prefix);
790 FileName const document_path(lyxrc.document_path);
791 if (document_path.exists() && document_path.isDirectory())
792 package().document_dir() = document_path;
794 package().set_temp_dir(createLyXTmpDir(FileName(lyxrc.tempdir_path)));
795 if (package().temp_dir().empty()) {
796 Alert::error(_("Could not create temporary directory"),
797 bformat(_("Could not create a temporary directory in\n"
799 "Make sure that this path exists and is writable and try again."),
800 from_utf8(lyxrc.tempdir_path)));
801 // createLyXTmpDir() tries sufficiently hard to create a
802 // usable temp dir, so the probability to come here is
803 // close to zero. We therefore don't try to overcome this
804 // problem with e.g. asking the user for a new path and
805 // trying again but simply exit.
809 LYXERR(Debug::INIT, "LyX tmp dir: `"
810 << package().temp_dir().absFilename() << '\'');
812 LYXERR(Debug::INIT, "Reading session information '.lyx/session'...");
813 pimpl_->session_.reset(new Session(lyxrc.num_lastfiles));
815 // This must happen after package initialization and after lyxrc is
816 // read, therefore it can't be done by a static object.
817 ConverterCache::init();
823 void emergencyCleanup()
825 // what to do about tmpfiles is non-obvious. we would
826 // like to delete any we find, but our lyxdir might
827 // contain documents etc. which might be helpful on
830 singleton_->pimpl_->buffer_list_.emergencyWriteAll();
832 if (singleton_->pimpl_->lyx_server_)
833 singleton_->pimpl_->lyx_server_->emergencyCleanup();
834 singleton_->pimpl_->lyx_server_.reset();
835 singleton_->pimpl_->lyx_socket_.reset();
840 // return true if file does not exist or is older than configure.py.
841 static bool needsUpdate(string const & file)
843 // We cannot initialize configure_script directly because the package
844 // is not initialized yet when static objects are constructed.
845 static FileName configure_script;
846 static bool firstrun = true;
849 FileName(addName(package().system_support().absFilename(),
855 FileName(addName(package().user_support().absFilename(), file));
856 return !absfile.exists()
857 || configure_script.lastModified() > absfile.lastModified();
861 bool LyX::queryUserLyXDir(bool explicit_userdir)
863 // Does user directory exist?
864 FileName const sup = package().user_support();
865 if (sup.exists() && sup.isDirectory()) {
868 return needsUpdate("lyxrc.defaults")
869 || needsUpdate("lyxmodules.lst")
870 || needsUpdate("textclass.lst")
871 || needsUpdate("packages.lst");
874 first_start = !explicit_userdir;
876 // If the user specified explicitly a directory, ask whether
877 // to create it. If the user says "no", then exit.
878 if (explicit_userdir &&
880 _("Missing user LyX directory"),
881 bformat(_("You have specified a non-existent user "
882 "LyX directory, %1$s.\n"
883 "It is needed to keep your own configuration."),
884 from_utf8(package().user_support().absFilename())),
886 _("&Create directory"),
888 lyxerr << to_utf8(_("No user LyX directory. Exiting.")) << endl;
889 earlyExit(EXIT_FAILURE);
892 lyxerr << to_utf8(bformat(_("LyX: Creating directory %1$s"),
893 from_utf8(sup.absFilename()))) << endl;
895 if (!sup.createDirectory(0755)) {
896 // Failed, so let's exit.
897 lyxerr << to_utf8(_("Failed to create directory. Exiting."))
899 earlyExit(EXIT_FAILURE);
906 bool LyX::readRcFile(string const & name)
908 LYXERR(Debug::INIT, "About to read " << name << "... ");
910 FileName const lyxrc_path = libFileSearch(string(), name);
911 if (!lyxrc_path.empty()) {
912 LYXERR(Debug::INIT, "Found in " << lyxrc_path);
913 if (lyxrc.read(lyxrc_path) < 0) {
918 LYXERR(Debug::INIT, "Not found." << lyxrc_path);
923 // Read the languages file `name'
924 bool LyX::readLanguagesFile(string const & name)
926 LYXERR(Debug::INIT, "About to read " << name << "...");
928 FileName const lang_path = libFileSearch(string(), name);
929 if (lang_path.empty()) {
933 languages.read(lang_path);
938 // Read the encodings file `name'
939 bool LyX::readEncodingsFile(string const & enc_name,
940 string const & symbols_name)
942 LYXERR(Debug::INIT, "About to read " << enc_name << " and "
943 << symbols_name << "...");
945 FileName const symbols_path = libFileSearch(string(), symbols_name);
946 if (symbols_path.empty()) {
947 showFileError(symbols_name);
951 FileName const enc_path = libFileSearch(string(), enc_name);
952 if (enc_path.empty()) {
953 showFileError(enc_name);
956 encodings.read(enc_path, symbols_path);
963 /// return the the number of arguments consumed
964 typedef boost::function<int(string const &, string const &, string &)> cmd_helper;
966 int parse_dbg(string const & arg, string const &, string &)
969 lyxerr << to_utf8(_("List of supported debug flags:")) << endl;
970 Debug::showTags(lyxerr);
973 lyxerr << to_utf8(bformat(_("Setting debug level to %1$s"), from_utf8(arg))) << endl;
975 lyxerr.setLevel(Debug::value(arg));
976 Debug::showLevel(lyxerr, lyxerr.level());
981 int parse_help(string const &, string const &, string &)
984 to_utf8(_("Usage: lyx [ command line switches ] [ name.lyx ... ]\n"
985 "Command line switches (case sensitive):\n"
986 "\t-help summarize LyX usage\n"
987 "\t-userdir dir set user directory to dir\n"
988 "\t-sysdir dir set system directory to dir\n"
989 "\t-geometry WxH+X+Y set geometry of the main window\n"
990 "\t-dbg feature[,feature]...\n"
991 " select the features to debug.\n"
992 " Type `lyx -dbg' to see the list of features\n"
993 "\t-x [--execute] command\n"
994 " where command is a lyx command.\n"
995 "\t-e [--export] fmt\n"
996 " where fmt is the export format of choice.\n"
997 " Look on Tools->Preferences->File formats->Format\n"
998 " to get an idea which parameters should be passed.\n"
999 " Note that the order of -e and -x switches matters.\n"
1000 "\t-i [--import] fmt file.xxx\n"
1001 " where fmt is the import format of choice\n"
1002 " and file.xxx is the file to be imported.\n"
1003 "\t-batch execute commands without launching GUI and exit.\n"
1004 "\t-version summarize version and build info\n"
1005 "Check the LyX man page for more details.")) << endl;
1011 int parse_version(string const &, string const &, string &)
1013 lyxerr << "LyX " << lyx_version
1014 << " (" << lyx_release_date << ")" << endl;
1015 lyxerr << "Built on " << __DATE__ << ", " << __TIME__ << endl;
1017 lyxerr << lyx_version_info << endl;
1023 int parse_sysdir(string const & arg, string const &, string &)
1026 Alert::error(_("No system directory"),
1027 _("Missing directory for -sysdir switch"));
1030 cl_system_support = arg;
1035 int parse_userdir(string const & arg, string const &, string &)
1038 Alert::error(_("No user directory"),
1039 _("Missing directory for -userdir switch"));
1042 cl_user_support = arg;
1047 int parse_execute(string const & arg, string const &, string & batch)
1050 Alert::error(_("Incomplete command"),
1051 _("Missing command string after --execute switch"));
1059 int parse_export(string const & type, string const &, string & batch)
1062 lyxerr << to_utf8(_("Missing file type [eg latex, ps...] after "
1063 "--export switch")) << endl;
1066 batch = "buffer-export " + type;
1072 int parse_import(string const & type, string const & file, string & batch)
1075 lyxerr << to_utf8(_("Missing file type [eg latex, ps...] after "
1076 "--import switch")) << endl;
1080 lyxerr << to_utf8(_("Missing filename for --import")) << endl;
1084 batch = "buffer-import " + type + ' ' + file;
1089 int parse_geometry(string const & arg1, string const &, string &)
1092 // don't remove "-geometry", it will be pruned out later in the
1093 // frontend if need be.
1098 int parse_batch(string const &, string const &, string &)
1108 void LyX::easyParse(int & argc, char * argv[])
1110 map<string, cmd_helper> cmdmap;
1112 cmdmap["-dbg"] = parse_dbg;
1113 cmdmap["-help"] = parse_help;
1114 cmdmap["--help"] = parse_help;
1115 cmdmap["-version"] = parse_version;
1116 cmdmap["--version"] = parse_version;
1117 cmdmap["-sysdir"] = parse_sysdir;
1118 cmdmap["-userdir"] = parse_userdir;
1119 cmdmap["-x"] = parse_execute;
1120 cmdmap["--execute"] = parse_execute;
1121 cmdmap["-e"] = parse_export;
1122 cmdmap["--export"] = parse_export;
1123 cmdmap["-i"] = parse_import;
1124 cmdmap["--import"] = parse_import;
1125 cmdmap["-geometry"] = parse_geometry;
1126 cmdmap["-batch"] = parse_batch;
1128 for (int i = 1; i < argc; ++i) {
1129 map<string, cmd_helper>::const_iterator it
1130 = cmdmap.find(argv[i]);
1132 // don't complain if not found - may be parsed later
1133 if (it == cmdmap.end())
1137 (i + 1 < argc) ? os::utf8_argv(i + 1) : string();
1139 (i + 2 < argc) ? os::utf8_argv(i + 2) : string();
1142 int const remove = 1 + it->second(arg, arg2, batch);
1144 pimpl_->batch_commands.push_back(batch);
1146 // Now, remove used arguments by shifting
1147 // the following ones remove places down.
1149 os::remove_internal_args(i, remove);
1151 for (int j = i; j < argc; ++j)
1152 argv[j] = argv[j + remove];
1159 FuncStatus getStatus(FuncRequest const & action)
1161 LASSERT(theApp(), /**/);
1162 return theApp()->getStatus(action);
1166 void dispatch(FuncRequest const & action)
1168 LASSERT(theApp(), /**/);
1169 return theApp()->dispatch(action);
1173 void dispatch(FuncRequest const & action, DispatchResult & dr)
1175 LASSERT(theApp(), /**/);
1176 return theApp()->dispatch(action, dr);
1180 BufferList & theBufferList()
1182 LASSERT(singleton_, /**/);
1183 return singleton_->pimpl_->buffer_list_;
1187 Server & theServer()
1189 // FIXME: this should not be use_gui dependent
1190 LASSERT(use_gui, /**/);
1191 LASSERT(singleton_, /**/);
1192 return *singleton_->pimpl_->lyx_server_.get();
1196 ServerSocket & theServerSocket()
1198 // FIXME: this should not be use_gui dependent
1199 LASSERT(use_gui, /**/);
1200 LASSERT(singleton_, /**/);
1201 return *singleton_->pimpl_->lyx_socket_.get();
1205 KeyMap & theTopLevelKeymap()
1207 LASSERT(singleton_, /**/);
1208 return singleton_->pimpl_->toplevel_keymap_;
1212 Converters & theConverters()
1214 LASSERT(singleton_, /**/);
1215 return singleton_->pimpl_->converters_;
1219 Converters & theSystemConverters()
1221 LASSERT(singleton_, /**/);
1222 return singleton_->pimpl_->system_converters_;
1226 Movers & theMovers()
1228 LASSERT(singleton_, /**/);
1229 return singleton_->pimpl_->movers_;
1233 Mover const & getMover(string const & fmt)
1235 LASSERT(singleton_, /**/);
1236 return singleton_->pimpl_->movers_(fmt);
1240 void setMover(string const & fmt, string const & command)
1242 LASSERT(singleton_, /**/);
1243 singleton_->pimpl_->movers_.set(fmt, command);
1247 Movers & theSystemMovers()
1249 LASSERT(singleton_, /**/);
1250 return singleton_->pimpl_->system_movers_;
1254 Messages const & getMessages(string const & language)
1256 LASSERT(singleton_, /**/);
1257 return singleton_->messages(language);
1261 Messages const & getGuiMessages()
1263 LASSERT(singleton_, /**/);
1264 return singleton_->pimpl_->messages_["GUI"];
1268 graphics::Previews & thePreviews()
1270 LASSERT(singleton_, /**/);
1271 return singleton_->pimpl_->preview_;
1275 Session & theSession()
1277 LASSERT(singleton_, /**/);
1278 return *singleton_->pimpl_->session_.get();
1282 CmdDef & theTopLevelCmdDef()
1284 LASSERT(singleton_, /**/);
1285 return singleton_->pimpl_->toplevel_cmddef_;
1289 SpellChecker * theSpellChecker()
1291 if (!singleton_->pimpl_->spell_checker_)
1293 return singleton_->pimpl_->spell_checker_;
1297 void setSpellChecker()
1299 #if defined(USE_ASPELL)
1300 if (lyxrc.spellchecker == "aspell") {
1301 if (!singleton_->pimpl_->aspell_checker_)
1302 singleton_->pimpl_->aspell_checker_ = new AspellChecker();
1303 singleton_->pimpl_->spell_checker_ = singleton_->pimpl_->aspell_checker_;
1307 #if defined(USE_ENCHANT)
1308 if (lyxrc.spellchecker == "enchant") {
1309 if (!singleton_->pimpl_->enchant_checker_)
1310 singleton_->pimpl_->enchant_checker_ = new EnchantChecker();
1311 singleton_->pimpl_->spell_checker_ = singleton_->pimpl_->enchant_checker_;
1315 #if defined(USE_HUNSPELL)
1316 if (lyxrc.spellchecker == "hunspell") {
1317 if (!singleton_->pimpl_->hunspell_checker_)
1318 singleton_->pimpl_->hunspell_checker_ = new HunspellChecker();
1319 singleton_->pimpl_->spell_checker_ = singleton_->pimpl_->hunspell_checker_;
1323 singleton_->pimpl_->spell_checker_ = 0;