]> git.lyx.org Git - lyx.git/blob - src/Buffer.cpp
compilation warning: scale is unsigned
[lyx.git] / src / Buffer.cpp
1 /**
2  * \file Buffer.cpp
3  * This file is part of LyX, the document processor.
4  * Licence details can be found in the file COPYING.
5  *
6  * \author Lars Gullik Bjønnes
7  * \author Stefan Schimanski
8  *
9  * Full author contact details are available in file CREDITS.
10  */
11
12 #include <config.h>
13
14 #include "Buffer.h"
15
16 #include "Author.h"
17 #include "LayoutFile.h"
18 #include "BiblioInfo.h"
19 #include "BranchList.h"
20 #include "buffer_funcs.h"
21 #include "BufferList.h"
22 #include "BufferParams.h"
23 #include "Bullet.h"
24 #include "Chktex.h"
25 #include "Converter.h"
26 #include "Counters.h"
27 #include "DocIterator.h"
28 #include "Encoding.h"
29 #include "ErrorList.h"
30 #include "Exporter.h"
31 #include "Format.h"
32 #include "FuncRequest.h"
33 #include "InsetIterator.h"
34 #include "InsetList.h"
35 #include "Language.h"
36 #include "LaTeXFeatures.h"
37 #include "LaTeX.h"
38 #include "Layout.h"
39 #include "Lexer.h"
40 #include "LyXAction.h"
41 #include "LyX.h"
42 #include "LyXRC.h"
43 #include "LyXVC.h"
44 #include "output_docbook.h"
45 #include "output.h"
46 #include "output_latex.h"
47 #include "output_plaintext.h"
48 #include "paragraph_funcs.h"
49 #include "Paragraph.h"
50 #include "ParagraphParameters.h"
51 #include "ParIterator.h"
52 #include "PDFOptions.h"
53 #include "sgml.h"
54 #include "TexRow.h"
55 #include "TexStream.h"
56 #include "Text.h"
57 #include "TextClass.h"
58 #include "TocBackend.h"
59 #include "Undo.h"
60 #include "VCBackend.h"
61 #include "version.h"
62 #include "WordList.h"
63
64 #include "insets/InsetBibitem.h"
65 #include "insets/InsetBibtex.h"
66 #include "insets/InsetInclude.h"
67 #include "insets/InsetText.h"
68
69 #include "mathed/MacroTable.h"
70 #include "mathed/MathMacroTemplate.h"
71 #include "mathed/MathSupport.h"
72
73 #include "frontends/alert.h"
74 #include "frontends/Delegates.h"
75 #include "frontends/WorkAreaManager.h"
76
77 #include "graphics/Previews.h"
78
79 #include "support/lassert.h"
80 #include "support/convert.h"
81 #include "support/debug.h"
82 #include "support/ExceptionMessage.h"
83 #include "support/FileName.h"
84 #include "support/FileNameList.h"
85 #include "support/filetools.h"
86 #include "support/ForkedCalls.h"
87 #include "support/gettext.h"
88 #include "support/gzstream.h"
89 #include "support/lstrings.h"
90 #include "support/lyxalgo.h"
91 #include "support/os.h"
92 #include "support/Package.h"
93 #include "support/Path.h"
94 #include "support/textutils.h"
95 #include "support/types.h"
96
97 #include <boost/bind.hpp>
98 #include <boost/shared_ptr.hpp>
99
100 #include <algorithm>
101 #include <fstream>
102 #include <iomanip>
103 #include <map>
104 #include <set>
105 #include <sstream>
106 #include <stack>
107 #include <vector>
108
109 using namespace std;
110 using namespace lyx::support;
111
112 namespace lyx {
113
114 namespace Alert = frontend::Alert;
115 namespace os = support::os;
116
117 namespace {
118
119 // Do not remove the comment below, so we get merge conflict in
120 // independent branches. Instead add your own.
121 int const LYX_FORMAT = 348;  // uwestoehr: add support for \*phantom
122
123 typedef map<string, bool> DepClean;
124 typedef map<docstring, pair<InsetLabel const *, Buffer::References> > RefCache;
125
126 } // namespace anon
127
128 class BufferSet : public std::set<Buffer const *> {};
129
130 class Buffer::Impl
131 {
132 public:
133         Impl(Buffer & parent, FileName const & file, bool readonly);
134
135         ~Impl()
136         {
137                 if (wa_) {
138                         wa_->closeAll();
139                         delete wa_;
140                 }
141                 delete inset;
142         }
143
144         BufferParams params;
145         LyXVC lyxvc;
146         FileName temppath;
147         mutable TexRow texrow;
148         Buffer const * parent_buffer;
149
150         /// need to regenerate .tex?
151         DepClean dep_clean;
152
153         /// is save needed?
154         mutable bool lyx_clean;
155
156         /// is autosave needed?
157         mutable bool bak_clean;
158
159         /// is this a unnamed file (New...)?
160         bool unnamed;
161
162         /// buffer is r/o
163         bool read_only;
164
165         /// name of the file the buffer is associated with.
166         FileName filename;
167
168         /** Set to true only when the file is fully loaded.
169          *  Used to prevent the premature generation of previews
170          *  and by the citation inset.
171          */
172         bool file_fully_loaded;
173
174         ///
175         mutable TocBackend toc_backend;
176
177         /// macro tables
178         typedef pair<DocIterator, MacroData> ScopeMacro;
179         typedef map<DocIterator, ScopeMacro> PositionScopeMacroMap;
180         typedef map<docstring, PositionScopeMacroMap> NamePositionScopeMacroMap;
181         /// map from the macro name to the position map,
182         /// which maps the macro definition position to the scope and the MacroData.
183         NamePositionScopeMacroMap macros;
184         bool macro_lock;
185
186         /// positions of child buffers in the buffer
187         typedef map<Buffer const * const, DocIterator> BufferPositionMap;
188         typedef pair<DocIterator, Buffer const *> ScopeBuffer;
189         typedef map<DocIterator, ScopeBuffer> PositionScopeBufferMap;
190         /// position of children buffers in this buffer
191         BufferPositionMap children_positions;
192         /// map from children inclusion positions to their scope and their buffer
193         PositionScopeBufferMap position_to_children;
194
195         /// Container for all sort of Buffer dependant errors.
196         map<string, ErrorList> errorLists;
197
198         /// timestamp and checksum used to test if the file has been externally
199         /// modified. (Used to properly enable 'File->Revert to saved', bug 4114).
200         time_t timestamp_;
201         unsigned long checksum_;
202
203         ///
204         frontend::WorkAreaManager * wa_;
205
206         ///
207         Undo undo_;
208
209         /// A cache for the bibfiles (including bibfiles of loaded child
210         /// documents), needed for appropriate update of natbib labels.
211         mutable support::FileNameList bibfilesCache_;
212
213         // FIXME The caching mechanism could be improved. At present, we have a
214         // cache for each Buffer, that caches all the bibliography info for that
215         // Buffer. A more efficient solution would be to have a global cache per
216         // file, and then to construct the Buffer's bibinfo from that.
217         /// A cache for bibliography info
218         mutable BiblioInfo bibinfo_;
219         /// whether the bibinfo cache is valid
220         bool bibinfoCacheValid_;
221         /// Cache of timestamps of .bib files
222         map<FileName, time_t> bibfileStatus_;
223
224         mutable RefCache ref_cache_;
225
226         /// our Text that should be wrapped in an InsetText
227         InsetText * inset;
228 };
229
230
231 /// Creates the per buffer temporary directory
232 static FileName createBufferTmpDir()
233 {
234         static int count;
235         // We are in our own directory.  Why bother to mangle name?
236         // In fact I wrote this code to circumvent a problematic behaviour
237         // (bug?) of EMX mkstemp().
238         FileName tmpfl(package().temp_dir().absFilename() + "/lyx_tmpbuf" +
239                 convert<string>(count++));
240
241         if (!tmpfl.createDirectory(0777)) {
242                 throw ExceptionMessage(WarningException, _("Disk Error: "), bformat(
243                         _("LyX could not create the temporary directory '%1$s' (Disk is full maybe?)"),
244                         from_utf8(tmpfl.absFilename())));
245         }
246         return tmpfl;
247 }
248
249
250 Buffer::Impl::Impl(Buffer & parent, FileName const & file, bool readonly_)
251         : parent_buffer(0), lyx_clean(true), bak_clean(true), unnamed(false),
252           read_only(readonly_), filename(file), file_fully_loaded(false),
253           toc_backend(&parent), macro_lock(false), timestamp_(0),
254           checksum_(0), wa_(0), undo_(parent), bibinfoCacheValid_(false)
255 {
256         temppath = createBufferTmpDir();
257         lyxvc.setBuffer(&parent);
258         if (use_gui)
259                 wa_ = new frontend::WorkAreaManager;
260 }
261
262
263 Buffer::Buffer(string const & file, bool readonly)
264         : d(new Impl(*this, FileName(file), readonly)), gui_(0)
265 {
266         LYXERR(Debug::INFO, "Buffer::Buffer()");
267
268         d->inset = new InsetText(*this);
269         d->inset->setAutoBreakRows(true);
270         d->inset->getText(0)->setMacrocontextPosition(par_iterator_begin());
271 }
272
273
274 Buffer::~Buffer()
275 {
276         LYXERR(Debug::INFO, "Buffer::~Buffer()");
277         // here the buffer should take care that it is
278         // saved properly, before it goes into the void.
279
280         // GuiView already destroyed
281         gui_ = 0;
282
283         if (d->unnamed && d->filename.extension() == "internal") {
284                 // No need to do additional cleanups for internal buffer.
285                 delete d;
286                 return;
287         }
288
289         // loop over children
290         Impl::BufferPositionMap::iterator it = d->children_positions.begin();
291         Impl::BufferPositionMap::iterator end = d->children_positions.end();
292         for (; it != end; ++it) {
293                 Buffer * child = const_cast<Buffer *>(it->first);
294                 // The child buffer might have been closed already.
295                 if (theBufferList().isLoaded(child))
296                         theBufferList().releaseChild(this, child);
297         }
298
299         // clear references to children in macro tables
300         d->children_positions.clear();
301         d->position_to_children.clear();
302
303         if (!d->temppath.destroyDirectory()) {
304                 Alert::warning(_("Could not remove temporary directory"),
305                         bformat(_("Could not remove the temporary directory %1$s"),
306                         from_utf8(d->temppath.absFilename())));
307         }
308
309         // Remove any previewed LaTeX snippets associated with this buffer.
310         thePreviews().removeLoader(*this);
311
312         delete d;
313 }
314
315
316 void Buffer::changed() const
317 {
318         if (d->wa_)
319                 d->wa_->redrawAll();
320 }
321
322
323 frontend::WorkAreaManager & Buffer::workAreaManager() const
324 {
325         LASSERT(d->wa_, /**/);
326         return *d->wa_;
327 }
328
329
330 Text & Buffer::text() const
331 {
332         return d->inset->text();
333 }
334
335
336 Inset & Buffer::inset() const
337 {
338         return *d->inset;
339 }
340
341
342 BufferParams & Buffer::params()
343 {
344         return d->params;
345 }
346
347
348 BufferParams const & Buffer::params() const
349 {
350         return d->params;
351 }
352
353
354 ParagraphList & Buffer::paragraphs()
355 {
356         return text().paragraphs();
357 }
358
359
360 ParagraphList const & Buffer::paragraphs() const
361 {
362         return text().paragraphs();
363 }
364
365
366 LyXVC & Buffer::lyxvc()
367 {
368         return d->lyxvc;
369 }
370
371
372 LyXVC const & Buffer::lyxvc() const
373 {
374         return d->lyxvc;
375 }
376
377
378 string const Buffer::temppath() const
379 {
380         return d->temppath.absFilename();
381 }
382
383
384 TexRow & Buffer::texrow()
385 {
386         return d->texrow;
387 }
388
389
390 TexRow const & Buffer::texrow() const
391 {
392         return d->texrow;
393 }
394
395
396 TocBackend & Buffer::tocBackend() const
397 {
398         return d->toc_backend;
399 }
400
401
402 Undo & Buffer::undo()
403 {
404         return d->undo_;
405 }
406
407
408 string Buffer::latexName(bool const no_path) const
409 {
410         FileName latex_name = makeLatexName(d->filename);
411         return no_path ? latex_name.onlyFileName()
412                 : latex_name.absFilename();
413 }
414
415
416 string Buffer::logName(LogType * type) const
417 {
418         string const filename = latexName(false);
419
420         if (filename.empty()) {
421                 if (type)
422                         *type = latexlog;
423                 return string();
424         }
425
426         string const path = temppath();
427
428         FileName const fname(addName(temppath(),
429                                      onlyFilename(changeExtension(filename,
430                                                                   ".log"))));
431         FileName const bname(
432                 addName(path, onlyFilename(
433                         changeExtension(filename,
434                                         formats.extension("literate") + ".out"))));
435
436         // If no Latex log or Build log is newer, show Build log
437
438         if (bname.exists() &&
439             (!fname.exists() || fname.lastModified() < bname.lastModified())) {
440                 LYXERR(Debug::FILES, "Log name calculated as: " << bname);
441                 if (type)
442                         *type = buildlog;
443                 return bname.absFilename();
444         }
445         LYXERR(Debug::FILES, "Log name calculated as: " << fname);
446         if (type)
447                         *type = latexlog;
448         return fname.absFilename();
449 }
450
451
452 void Buffer::setReadonly(bool const flag)
453 {
454         if (d->read_only != flag) {
455                 d->read_only = flag;
456                 setReadOnly(flag);
457         }
458 }
459
460
461 void Buffer::setFileName(string const & newfile)
462 {
463         d->filename = makeAbsPath(newfile);
464         setReadonly(d->filename.isReadOnly());
465         updateTitles();
466 }
467
468
469 int Buffer::readHeader(Lexer & lex)
470 {
471         int unknown_tokens = 0;
472         int line = -1;
473         int begin_header_line = -1;
474
475         // Initialize parameters that may be/go lacking in header:
476         params().branchlist().clear();
477         params().preamble.erase();
478         params().options.erase();
479         params().master.erase();
480         params().float_placement.erase();
481         params().paperwidth.erase();
482         params().paperheight.erase();
483         params().leftmargin.erase();
484         params().rightmargin.erase();
485         params().topmargin.erase();
486         params().bottommargin.erase();
487         params().headheight.erase();
488         params().headsep.erase();
489         params().footskip.erase();
490         params().columnsep.erase();
491         params().fontsCJK.erase();
492         params().listings_params.clear();
493         params().clearLayoutModules();
494         params().clearRemovedModules();
495         params().pdfoptions().clear();
496
497         for (int i = 0; i < 4; ++i) {
498                 params().user_defined_bullet(i) = ITEMIZE_DEFAULTS[i];
499                 params().temp_bullet(i) = ITEMIZE_DEFAULTS[i];
500         }
501
502         ErrorList & errorList = d->errorLists["Parse"];
503
504         while (lex.isOK()) {
505                 string token;
506                 lex >> token;
507
508                 if (token.empty())
509                         continue;
510
511                 if (token == "\\end_header")
512                         break;
513
514                 ++line;
515                 if (token == "\\begin_header") {
516                         begin_header_line = line;
517                         continue;
518                 }
519
520                 LYXERR(Debug::PARSER, "Handling document header token: `"
521                                       << token << '\'');
522
523                 string unknown = params().readToken(lex, token, d->filename.onlyPath());
524                 if (!unknown.empty()) {
525                         if (unknown[0] != '\\' && token == "\\textclass") {
526                                 Alert::warning(_("Unknown document class"),
527                        bformat(_("Using the default document class, because the "
528                                               "class %1$s is unknown."), from_utf8(unknown)));
529                         } else {
530                                 ++unknown_tokens;
531                                 docstring const s = bformat(_("Unknown token: "
532                                                                         "%1$s %2$s\n"),
533                                                          from_utf8(token),
534                                                          lex.getDocString());
535                                 errorList.push_back(ErrorItem(_("Document header error"),
536                                         s, -1, 0, 0));
537                         }
538                 }
539         }
540         if (begin_header_line) {
541                 docstring const s = _("\\begin_header is missing");
542                 errorList.push_back(ErrorItem(_("Document header error"),
543                         s, -1, 0, 0));
544         }
545
546         params().makeDocumentClass();
547
548         return unknown_tokens;
549 }
550
551
552 // Uwe C. Schroeder
553 // changed to be public and have one parameter
554 // Returns true if "\end_document" is not read (Asger)
555 bool Buffer::readDocument(Lexer & lex)
556 {
557         ErrorList & errorList = d->errorLists["Parse"];
558         errorList.clear();
559
560         if (!lex.checkFor("\\begin_document")) {
561                 docstring const s = _("\\begin_document is missing");
562                 errorList.push_back(ErrorItem(_("Document header error"),
563                         s, -1, 0, 0));
564         }
565
566         // we are reading in a brand new document
567         LASSERT(paragraphs().empty(), /**/);
568
569         readHeader(lex);
570
571         if (params().outputChanges) {
572                 bool dvipost    = LaTeXFeatures::isAvailable("dvipost");
573                 bool xcolorulem = LaTeXFeatures::isAvailable("ulem") &&
574                                   LaTeXFeatures::isAvailable("xcolor");
575
576                 if (!dvipost && !xcolorulem) {
577                         Alert::warning(_("Changes not shown in LaTeX output"),
578                                        _("Changes will not be highlighted in LaTeX output, "
579                                          "because neither dvipost nor xcolor/ulem are installed.\n"
580                                          "Please install these packages or redefine "
581                                          "\\lyxadded and \\lyxdeleted in the LaTeX preamble."));
582                 } else if (!xcolorulem) {
583                         Alert::warning(_("Changes not shown in LaTeX output"),
584                                        _("Changes will not be highlighted in LaTeX output "
585                                          "when using pdflatex, because xcolor and ulem are not installed.\n"
586                                          "Please install both packages or redefine "
587                                          "\\lyxadded and \\lyxdeleted in the LaTeX preamble."));
588                 }
589         }
590
591         if (!params().master.empty()) {
592                 FileName const master_file = makeAbsPath(params().master,
593                            onlyPath(absFileName()));
594                 if (isLyXFilename(master_file.absFilename())) {
595                         Buffer * master = 
596                                 checkAndLoadLyXFile(master_file, true);
597                         if (master) {
598                                 // set master as master buffer, but only
599                                 // if we are a real child
600                                 if (master->isChild(this))
601                                         setParent(master);
602                                 // if the master is not fully loaded
603                                 // it is probably just loading this
604                                 // child. No warning needed then.
605                                 else if (master->isFullyLoaded())
606                                         LYXERR0("The master '"
607                                                 << params().master
608                                                 << "' assigned to this document '"
609                                                 << absFileName()
610                                                 << "' does not include "
611                                                 "this document. Ignoring the master assignment.");
612                         }
613                 }
614         }
615
616         // read main text
617         bool const res = text().read(*this, lex, errorList, d->inset);
618
619         updateMacros();
620         updateMacroInstances();
621         return res;
622 }
623
624
625 // needed to insert the selection
626 void Buffer::insertStringAsLines(ParagraphList & pars,
627         pit_type & pit, pos_type & pos,
628         Font const & fn, docstring const & str, bool autobreakrows)
629 {
630         Font font = fn;
631
632         // insert the string, don't insert doublespace
633         bool space_inserted = true;
634         for (docstring::const_iterator cit = str.begin();
635             cit != str.end(); ++cit) {
636                 Paragraph & par = pars[pit];
637                 if (*cit == '\n') {
638                         if (autobreakrows && (!par.empty() || par.allowEmpty())) {
639                                 breakParagraph(params(), pars, pit, pos,
640                                                par.layout().isEnvironment());
641                                 ++pit;
642                                 pos = 0;
643                                 space_inserted = true;
644                         } else {
645                                 continue;
646                         }
647                         // do not insert consecutive spaces if !free_spacing
648                 } else if ((*cit == ' ' || *cit == '\t') &&
649                            space_inserted && !par.isFreeSpacing()) {
650                         continue;
651                 } else if (*cit == '\t') {
652                         if (!par.isFreeSpacing()) {
653                                 // tabs are like spaces here
654                                 par.insertChar(pos, ' ', font, params().trackChanges);
655                                 ++pos;
656                                 space_inserted = true;
657                         } else {
658                                 par.insertChar(pos, *cit, font, params().trackChanges);
659                                 ++pos;
660                                 space_inserted = true;
661                         }
662                 } else if (!isPrintable(*cit)) {
663                         // Ignore unprintables
664                         continue;
665                 } else {
666                         // just insert the character
667                         par.insertChar(pos, *cit, font, params().trackChanges);
668                         ++pos;
669                         space_inserted = (*cit == ' ');
670                 }
671
672         }
673 }
674
675
676 bool Buffer::readString(string const & s)
677 {
678         params().compressed = false;
679
680         // remove dummy empty par
681         paragraphs().clear();
682         Lexer lex;
683         istringstream is(s);
684         lex.setStream(is);
685         FileName const name = FileName::tempName("Buffer_readString");
686         switch (readFile(lex, name, true)) {
687         case failure:
688                 return false;
689         case wrongversion: {
690                 // We need to call lyx2lyx, so write the input to a file
691                 ofstream os(name.toFilesystemEncoding().c_str());
692                 os << s;
693                 os.close();
694                 return readFile(name);
695         }
696         case success:
697                 break;
698         }
699
700         return true;
701 }
702
703
704 bool Buffer::readFile(FileName const & filename)
705 {
706         FileName fname(filename);
707
708         params().compressed = fname.isZippedFile();
709
710         // remove dummy empty par
711         paragraphs().clear();
712         Lexer lex;
713         lex.setFile(fname);
714         if (readFile(lex, fname) != success)
715                 return false;
716
717         return true;
718 }
719
720
721 bool Buffer::isFullyLoaded() const
722 {
723         return d->file_fully_loaded;
724 }
725
726
727 void Buffer::setFullyLoaded(bool value)
728 {
729         d->file_fully_loaded = value;
730 }
731
732
733 Buffer::ReadStatus Buffer::readFile(Lexer & lex, FileName const & filename,
734                 bool fromstring)
735 {
736         LASSERT(!filename.empty(), /**/);
737
738         // the first (non-comment) token _must_ be...
739         if (!lex.checkFor("\\lyxformat")) {
740                 Alert::error(_("Document format failure"),
741                              bformat(_("%1$s is not a readable LyX document."),
742                                        from_utf8(filename.absFilename())));
743                 return failure;
744         }
745
746         string tmp_format;
747         lex >> tmp_format;
748         //lyxerr << "LyX Format: `" << tmp_format << '\'' << endl;
749         // if present remove ".," from string.
750         size_t dot = tmp_format.find_first_of(".,");
751         //lyxerr << "           dot found at " << dot << endl;
752         if (dot != string::npos)
753                         tmp_format.erase(dot, 1);
754         int const file_format = convert<int>(tmp_format);
755         //lyxerr << "format: " << file_format << endl;
756
757         // save timestamp and checksum of the original disk file, making sure
758         // to not overwrite them with those of the file created in the tempdir
759         // when it has to be converted to the current format.
760         if (!d->checksum_) {
761                 // Save the timestamp and checksum of disk file. If filename is an
762                 // emergency file, save the timestamp and checksum of the original lyx file
763                 // because isExternallyModified will check for this file. (BUG4193)
764                 string diskfile = filename.absFilename();
765                 if (suffixIs(diskfile, ".emergency"))
766                         diskfile = diskfile.substr(0, diskfile.size() - 10);
767                 saveCheckSum(FileName(diskfile));
768         }
769
770         if (file_format != LYX_FORMAT) {
771
772                 if (fromstring)
773                         // lyx2lyx would fail
774                         return wrongversion;
775
776                 FileName const tmpfile = FileName::tempName("Buffer_readFile");
777                 if (tmpfile.empty()) {
778                         Alert::error(_("Conversion failed"),
779                                      bformat(_("%1$s is from a different"
780                                               " version of LyX, but a temporary"
781                                               " file for converting it could"
782                                                             " not be created."),
783                                               from_utf8(filename.absFilename())));
784                         return failure;
785                 }
786                 FileName const lyx2lyx = libFileSearch("lyx2lyx", "lyx2lyx");
787                 if (lyx2lyx.empty()) {
788                         Alert::error(_("Conversion script not found"),
789                                      bformat(_("%1$s is from a different"
790                                                " version of LyX, but the"
791                                                " conversion script lyx2lyx"
792                                                             " could not be found."),
793                                                from_utf8(filename.absFilename())));
794                         return failure;
795                 }
796                 ostringstream command;
797                 command << os::python()
798                         << ' ' << quoteName(lyx2lyx.toFilesystemEncoding())
799                         << " -t " << convert<string>(LYX_FORMAT)
800                         << " -o " << quoteName(tmpfile.toFilesystemEncoding())
801                         << ' ' << quoteName(filename.toFilesystemEncoding());
802                 string const command_str = command.str();
803
804                 LYXERR(Debug::INFO, "Running '" << command_str << '\'');
805
806                 cmd_ret const ret = runCommand(command_str);
807                 if (ret.first != 0) {
808                         Alert::error(_("Conversion script failed"),
809                                      bformat(_("%1$s is from a different version"
810                                               " of LyX, but the lyx2lyx script"
811                                                             " failed to convert it."),
812                                               from_utf8(filename.absFilename())));
813                         return failure;
814                 } else {
815                         bool const ret = readFile(tmpfile);
816                         // Do stuff with tmpfile name and buffer name here.
817                         return ret ? success : failure;
818                 }
819
820         }
821
822         if (readDocument(lex)) {
823                 Alert::error(_("Document format failure"),
824                              bformat(_("%1$s ended unexpectedly, which means"
825                                                     " that it is probably corrupted."),
826                                        from_utf8(filename.absFilename())));
827         }
828
829         d->file_fully_loaded = true;
830         return success;
831 }
832
833
834 // Should probably be moved to somewhere else: BufferView? LyXView?
835 bool Buffer::save() const
836 {
837         // We don't need autosaves in the immediate future. (Asger)
838         resetAutosaveTimers();
839
840         string const encodedFilename = d->filename.toFilesystemEncoding();
841
842         FileName backupName;
843         bool madeBackup = false;
844
845         // make a backup if the file already exists
846         if (lyxrc.make_backup && fileName().exists()) {
847                 backupName = FileName(absFileName() + '~');
848                 if (!lyxrc.backupdir_path.empty()) {
849                         string const mangledName =
850                                 subst(subst(backupName.absFilename(), '/', '!'), ':', '!');
851                         backupName = FileName(addName(lyxrc.backupdir_path,
852                                                       mangledName));
853                 }
854                 if (fileName().copyTo(backupName)) {
855                         madeBackup = true;
856                 } else {
857                         Alert::error(_("Backup failure"),
858                                      bformat(_("Cannot create backup file %1$s.\n"
859                                                "Please check whether the directory exists and is writeable."),
860                                              from_utf8(backupName.absFilename())));
861                         //LYXERR(Debug::DEBUG, "Fs error: " << fe.what());
862                 }
863         }
864
865         // ask if the disk file has been externally modified (use checksum method)
866         if (fileName().exists() && isExternallyModified(checksum_method)) {
867                 docstring const file = makeDisplayPath(absFileName(), 20);
868                 docstring text = bformat(_("Document %1$s has been externally modified. Are you sure "
869                                                              "you want to overwrite this file?"), file);
870                 int const ret = Alert::prompt(_("Overwrite modified file?"),
871                         text, 1, 1, _("&Overwrite"), _("&Cancel"));
872                 if (ret == 1)
873                         return false;
874         }
875
876         if (writeFile(d->filename)) {
877                 markClean();
878                 return true;
879         } else {
880                 // Saving failed, so backup is not backup
881                 if (madeBackup)
882                         backupName.moveTo(d->filename);
883                 return false;
884         }
885 }
886
887
888 bool Buffer::writeFile(FileName const & fname) const
889 {
890         if (d->read_only && fname == d->filename)
891                 return false;
892
893         bool retval = false;
894
895         docstring const str = bformat(_("Saving document %1$s..."),
896                 makeDisplayPath(fname.absFilename()));
897         message(str);
898
899         if (params().compressed) {
900                 gz::ogzstream ofs(fname.toFilesystemEncoding().c_str(), ios::out|ios::trunc);
901                 retval = ofs && write(ofs);
902         } else {
903                 ofstream ofs(fname.toFilesystemEncoding().c_str(), ios::out|ios::trunc);
904                 retval = ofs && write(ofs);
905         }
906
907         if (!retval) {
908                 message(str + _(" could not write file!"));
909                 return false;
910         }
911
912         removeAutosaveFile(d->filename.absFilename());
913
914         saveCheckSum(d->filename);
915         message(str + _(" done."));
916
917         return true;
918 }
919
920
921 bool Buffer::write(ostream & ofs) const
922 {
923 #ifdef HAVE_LOCALE
924         // Use the standard "C" locale for file output.
925         ofs.imbue(locale::classic());
926 #endif
927
928         // The top of the file should not be written by params().
929
930         // write out a comment in the top of the file
931         ofs << "#LyX " << lyx_version
932             << " created this file. For more info see http://www.lyx.org/\n"
933             << "\\lyxformat " << LYX_FORMAT << "\n"
934             << "\\begin_document\n";
935
936         /// For each author, set 'used' to true if there is a change
937         /// by this author in the document; otherwise set it to 'false'.
938         AuthorList::Authors::const_iterator a_it = params().authors().begin();
939         AuthorList::Authors::const_iterator a_end = params().authors().end();
940         for (; a_it != a_end; ++a_it)
941                 a_it->second.setUsed(false);
942
943         ParIterator const end = const_cast<Buffer *>(this)->par_iterator_end();
944         ParIterator it = const_cast<Buffer *>(this)->par_iterator_begin();
945         for ( ; it != end; ++it)
946                 it->checkAuthors(params().authors());
947
948         // now write out the buffer parameters.
949         ofs << "\\begin_header\n";
950         params().writeFile(ofs);
951         ofs << "\\end_header\n";
952
953         // write the text
954         ofs << "\n\\begin_body\n";
955         text().write(*this, ofs);
956         ofs << "\n\\end_body\n";
957
958         // Write marker that shows file is complete
959         ofs << "\\end_document" << endl;
960
961         // Shouldn't really be needed....
962         //ofs.close();
963
964         // how to check if close went ok?
965         // Following is an attempt... (BE 20001011)
966
967         // good() returns false if any error occured, including some
968         //        formatting error.
969         // bad()  returns true if something bad happened in the buffer,
970         //        which should include file system full errors.
971
972         bool status = true;
973         if (!ofs) {
974                 status = false;
975                 lyxerr << "File was not closed properly." << endl;
976         }
977
978         return status;
979 }
980
981
982 bool Buffer::makeLaTeXFile(FileName const & fname,
983                            string const & original_path,
984                            OutputParams const & runparams,
985                            bool output_preamble, bool output_body) const
986 {
987         string const encoding = runparams.encoding->iconvName();
988         LYXERR(Debug::LATEX, "makeLaTeXFile encoding: " << encoding << "...");
989
990         ofdocstream ofs;
991         try { ofs.reset(encoding); }
992         catch (iconv_codecvt_facet_exception & e) {
993                 lyxerr << "Caught iconv exception: " << e.what() << endl;
994                 Alert::error(_("Iconv software exception Detected"), bformat(_("Please "
995                         "verify that the support software for your encoding (%1$s) is "
996                         "properly installed"), from_ascii(encoding)));
997                 return false;
998         }
999         if (!openFileWrite(ofs, fname))
1000                 return false;
1001
1002         //TexStream ts(ofs.rdbuf(), &texrow());
1003         ErrorList & errorList = d->errorLists["Export"];
1004         errorList.clear();
1005         bool failed_export = false;
1006         try {
1007                 d->texrow.reset();
1008                 writeLaTeXSource(ofs, original_path,
1009                       runparams, output_preamble, output_body);
1010         }
1011         catch (EncodingException & e) {
1012                 odocstringstream ods;
1013                 ods.put(e.failed_char);
1014                 ostringstream oss;
1015                 oss << "0x" << hex << e.failed_char << dec;
1016                 docstring msg = bformat(_("Could not find LaTeX command for character '%1$s'"
1017                                           " (code point %2$s)"),
1018                                           ods.str(), from_utf8(oss.str()));
1019                 errorList.push_back(ErrorItem(msg, _("Some characters of your document are probably not "
1020                                 "representable in the chosen encoding.\n"
1021                                 "Changing the document encoding to utf8 could help."),
1022                                 e.par_id, e.pos, e.pos + 1));
1023                 failed_export = true;
1024         }
1025         catch (iconv_codecvt_facet_exception & e) {
1026                 errorList.push_back(ErrorItem(_("iconv conversion failed"),
1027                         _(e.what()), -1, 0, 0));
1028                 failed_export = true;
1029         }
1030         catch (exception const & e) {
1031                 errorList.push_back(ErrorItem(_("conversion failed"),
1032                         _(e.what()), -1, 0, 0));
1033                 failed_export = true;
1034         }
1035         catch (...) {
1036                 lyxerr << "Caught some really weird exception..." << endl;
1037                 lyx_exit(1);
1038         }
1039
1040         ofs.close();
1041         if (ofs.fail()) {
1042                 failed_export = true;
1043                 lyxerr << "File '" << fname << "' was not closed properly." << endl;
1044         }
1045
1046         errors("Export");
1047         return !failed_export;
1048 }
1049
1050
1051 void Buffer::writeLaTeXSource(odocstream & os,
1052                            string const & original_path,
1053                            OutputParams const & runparams_in,
1054                            bool const output_preamble, bool const output_body) const
1055 {
1056         // The child documents, if any, shall be already loaded at this point.
1057
1058         OutputParams runparams = runparams_in;
1059
1060         // Classify the unicode characters appearing in math insets
1061         Encodings::initUnicodeMath(*this);
1062
1063         // validate the buffer.
1064         LYXERR(Debug::LATEX, "  Validating buffer...");
1065         LaTeXFeatures features(*this, params(), runparams);
1066         validate(features);
1067         LYXERR(Debug::LATEX, "  Buffer validation done.");
1068
1069         // The starting paragraph of the coming rows is the
1070         // first paragraph of the document. (Asger)
1071         if (output_preamble && runparams.nice) {
1072                 os << "%% LyX " << lyx_version << " created this file.  "
1073                         "For more info, see http://www.lyx.org/.\n"
1074                         "%% Do not edit unless you really know what "
1075                         "you are doing.\n";
1076                 d->texrow.newline();
1077                 d->texrow.newline();
1078         }
1079         LYXERR(Debug::INFO, "lyx document header finished");
1080
1081         // Don't move this behind the parent_buffer=0 code below,
1082         // because then the macros will not get the right "redefinition"
1083         // flag as they don't see the parent macros which are output before.
1084         updateMacros();
1085
1086         // fold macros if possible, still with parent buffer as the
1087         // macros will be put in the prefix anyway.
1088         updateMacroInstances();
1089
1090         // There are a few differences between nice LaTeX and usual files:
1091         // usual is \batchmode and has a
1092         // special input@path to allow the including of figures
1093         // with either \input or \includegraphics (what figinsets do).
1094         // input@path is set when the actual parameter
1095         // original_path is set. This is done for usual tex-file, but not
1096         // for nice-latex-file. (Matthias 250696)
1097         // Note that input@path is only needed for something the user does
1098         // in the preamble, included .tex files or ERT, files included by
1099         // LyX work without it.
1100         if (output_preamble) {
1101                 if (!runparams.nice) {
1102                         // code for usual, NOT nice-latex-file
1103                         os << "\\batchmode\n"; // changed
1104                         // from \nonstopmode
1105                         d->texrow.newline();
1106                 }
1107                 if (!original_path.empty()) {
1108                         // FIXME UNICODE
1109                         // We don't know the encoding of inputpath
1110                         docstring const inputpath = from_utf8(latex_path(original_path));
1111                         os << "\\makeatletter\n"
1112                            << "\\def\\input@path{{"
1113                            << inputpath << "/}}\n"
1114                            << "\\makeatother\n";
1115                         d->texrow.newline();
1116                         d->texrow.newline();
1117                         d->texrow.newline();
1118                 }
1119
1120                 // get parent macros (if this buffer has a parent) which will be
1121                 // written at the document begin further down.
1122                 MacroSet parentMacros;
1123                 listParentMacros(parentMacros, features);
1124
1125                 // Write the preamble
1126                 runparams.use_babel = params().writeLaTeX(os, features, d->texrow);
1127
1128                 runparams.use_japanese = features.isRequired("japanese");
1129
1130                 if (!output_body)
1131                         return;
1132
1133                 // make the body.
1134                 os << "\\begin{document}\n";
1135                 d->texrow.newline();
1136
1137                 // output the parent macros
1138                 MacroSet::iterator it = parentMacros.begin();
1139                 MacroSet::iterator end = parentMacros.end();
1140                 for (; it != end; ++it)
1141                         (*it)->write(os, true);
1142         } // output_preamble
1143
1144         d->texrow.start(paragraphs().begin()->id(), 0);
1145
1146         LYXERR(Debug::INFO, "preamble finished, now the body.");
1147
1148         // if we are doing a real file with body, even if this is the
1149         // child of some other buffer, let's cut the link here.
1150         // This happens for example if only a child document is printed.
1151         Buffer const * save_parent = 0;
1152         if (output_preamble) {
1153                 save_parent = d->parent_buffer;
1154                 d->parent_buffer = 0;
1155         }
1156
1157         // the real stuff
1158         latexParagraphs(*this, text(), os, d->texrow, runparams);
1159
1160         // Restore the parenthood if needed
1161         if (output_preamble)
1162                 d->parent_buffer = save_parent;
1163
1164         // add this just in case after all the paragraphs
1165         os << endl;
1166         d->texrow.newline();
1167
1168         if (output_preamble) {
1169                 os << "\\end{document}\n";
1170                 d->texrow.newline();
1171                 LYXERR(Debug::LATEX, "makeLaTeXFile...done");
1172         } else {
1173                 LYXERR(Debug::LATEX, "LaTeXFile for inclusion made.");
1174         }
1175         runparams_in.encoding = runparams.encoding;
1176
1177         // Just to be sure. (Asger)
1178         d->texrow.newline();
1179
1180         LYXERR(Debug::INFO, "Finished making LaTeX file.");
1181         LYXERR(Debug::INFO, "Row count was " << d->texrow.rows() - 1 << '.');
1182 }
1183
1184
1185 bool Buffer::isLatex() const
1186 {
1187         return params().documentClass().outputType() == LATEX;
1188 }
1189
1190
1191 bool Buffer::isLiterate() const
1192 {
1193         return params().documentClass().outputType() == LITERATE;
1194 }
1195
1196
1197 bool Buffer::isDocBook() const
1198 {
1199         return params().documentClass().outputType() == DOCBOOK;
1200 }
1201
1202
1203 void Buffer::makeDocBookFile(FileName const & fname,
1204                               OutputParams const & runparams,
1205                               bool const body_only) const
1206 {
1207         LYXERR(Debug::LATEX, "makeDocBookFile...");
1208
1209         ofdocstream ofs;
1210         if (!openFileWrite(ofs, fname))
1211                 return;
1212
1213         writeDocBookSource(ofs, fname.absFilename(), runparams, body_only);
1214
1215         ofs.close();
1216         if (ofs.fail())
1217                 lyxerr << "File '" << fname << "' was not closed properly." << endl;
1218 }
1219
1220
1221 void Buffer::writeDocBookSource(odocstream & os, string const & fname,
1222                              OutputParams const & runparams,
1223                              bool const only_body) const
1224 {
1225         LaTeXFeatures features(*this, params(), runparams);
1226         validate(features);
1227
1228         d->texrow.reset();
1229
1230         DocumentClass const & tclass = params().documentClass();
1231         string const top_element = tclass.latexname();
1232
1233         if (!only_body) {
1234                 if (runparams.flavor == OutputParams::XML)
1235                         os << "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n";
1236
1237                 // FIXME UNICODE
1238                 os << "<!DOCTYPE " << from_ascii(top_element) << ' ';
1239
1240                 // FIXME UNICODE
1241                 if (! tclass.class_header().empty())
1242                         os << from_ascii(tclass.class_header());
1243                 else if (runparams.flavor == OutputParams::XML)
1244                         os << "PUBLIC \"-//OASIS//DTD DocBook XML//EN\" "
1245                             << "\"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd\"";
1246                 else
1247                         os << " PUBLIC \"-//OASIS//DTD DocBook V4.2//EN\"";
1248
1249                 docstring preamble = from_utf8(params().preamble);
1250                 if (runparams.flavor != OutputParams::XML ) {
1251                         preamble += "<!ENTITY % output.print.png \"IGNORE\">\n";
1252                         preamble += "<!ENTITY % output.print.pdf \"IGNORE\">\n";
1253                         preamble += "<!ENTITY % output.print.eps \"IGNORE\">\n";
1254                         preamble += "<!ENTITY % output.print.bmp \"IGNORE\">\n";
1255                 }
1256
1257                 string const name = runparams.nice
1258                         ? changeExtension(absFileName(), ".sgml") : fname;
1259                 preamble += features.getIncludedFiles(name);
1260                 preamble += features.getLyXSGMLEntities();
1261
1262                 if (!preamble.empty()) {
1263                         os << "\n [ " << preamble << " ]";
1264                 }
1265                 os << ">\n\n";
1266         }
1267
1268         string top = top_element;
1269         top += " lang=\"";
1270         if (runparams.flavor == OutputParams::XML)
1271                 top += params().language->code();
1272         else
1273                 top += params().language->code().substr(0, 2);
1274         top += '"';
1275
1276         if (!params().options.empty()) {
1277                 top += ' ';
1278                 top += params().options;
1279         }
1280
1281         os << "<!-- " << ((runparams.flavor == OutputParams::XML)? "XML" : "SGML")
1282             << " file was created by LyX " << lyx_version
1283             << "\n  See http://www.lyx.org/ for more information -->\n";
1284
1285         params().documentClass().counters().reset();
1286
1287         updateMacros();
1288
1289         sgml::openTag(os, top);
1290         os << '\n';
1291         docbookParagraphs(paragraphs(), *this, os, runparams);
1292         sgml::closeTag(os, top_element);
1293 }
1294
1295
1296 // chktex should be run with these flags disabled: 3, 22, 25, 30, 38(?)
1297 // Other flags: -wall -v0 -x
1298 int Buffer::runChktex()
1299 {
1300         setBusy(true);
1301
1302         // get LaTeX-Filename
1303         FileName const path(temppath());
1304         string const name = addName(path.absFilename(), latexName());
1305         string const org_path = filePath();
1306
1307         PathChanger p(path); // path to LaTeX file
1308         message(_("Running chktex..."));
1309
1310         // Generate the LaTeX file if neccessary
1311         OutputParams runparams(&params().encoding());
1312         runparams.flavor = OutputParams::LATEX;
1313         runparams.nice = false;
1314         makeLaTeXFile(FileName(name), org_path, runparams);
1315
1316         TeXErrors terr;
1317         Chktex chktex(lyxrc.chktex_command, onlyFilename(name), filePath());
1318         int const res = chktex.run(terr); // run chktex
1319
1320         if (res == -1) {
1321                 Alert::error(_("chktex failure"),
1322                              _("Could not run chktex successfully."));
1323         } else if (res > 0) {
1324                 ErrorList & errlist = d->errorLists["ChkTeX"];
1325                 errlist.clear();
1326                 bufferErrors(terr, errlist);
1327         }
1328
1329         setBusy(false);
1330
1331         errors("ChkTeX");
1332
1333         return res;
1334 }
1335
1336
1337 void Buffer::validate(LaTeXFeatures & features) const
1338 {
1339         params().validate(features);
1340
1341         updateMacros();
1342
1343         for_each(paragraphs().begin(), paragraphs().end(),
1344                  boost::bind(&Paragraph::validate, _1, boost::ref(features)));
1345
1346         if (lyxerr.debugging(Debug::LATEX)) {
1347                 features.showStruct();
1348         }
1349 }
1350
1351
1352 void Buffer::getLabelList(vector<docstring> & list) const
1353 {
1354         // If this is a child document, use the parent's list instead.
1355         if (d->parent_buffer) {
1356                 d->parent_buffer->getLabelList(list);
1357                 return;
1358         }
1359
1360         list.clear();
1361         Toc & toc = d->toc_backend.toc("label");
1362         TocIterator toc_it = toc.begin();
1363         TocIterator end = toc.end();
1364         for (; toc_it != end; ++toc_it) {
1365                 if (toc_it->depth() == 0)
1366                         list.push_back(toc_it->str());
1367         }
1368 }
1369
1370
1371 void Buffer::updateBibfilesCache() const
1372 {
1373         // If this is a child document, use the parent's cache instead.
1374         if (d->parent_buffer) {
1375                 d->parent_buffer->updateBibfilesCache();
1376                 return;
1377         }
1378
1379         d->bibfilesCache_.clear();
1380         for (InsetIterator it = inset_iterator_begin(inset()); it; ++it) {
1381                 if (it->lyxCode() == BIBTEX_CODE) {
1382                         InsetBibtex const & inset =
1383                                 static_cast<InsetBibtex const &>(*it);
1384                         support::FileNameList const bibfiles = inset.getBibFiles();
1385                         d->bibfilesCache_.insert(d->bibfilesCache_.end(),
1386                                 bibfiles.begin(),
1387                                 bibfiles.end());
1388                 } else if (it->lyxCode() == INCLUDE_CODE) {
1389                         InsetInclude & inset =
1390                                 static_cast<InsetInclude &>(*it);
1391                         inset.updateBibfilesCache();
1392                         support::FileNameList const & bibfiles =
1393                                         inset.getBibfilesCache(*this);
1394                         d->bibfilesCache_.insert(d->bibfilesCache_.end(),
1395                                 bibfiles.begin(),
1396                                 bibfiles.end());
1397                 }
1398         }
1399         // the bibinfo cache is now invalid
1400         d->bibinfoCacheValid_ = false;
1401 }
1402
1403
1404 void Buffer::invalidateBibinfoCache()
1405 {
1406         d->bibinfoCacheValid_ = false;
1407 }
1408
1409
1410 support::FileNameList const & Buffer::getBibfilesCache() const
1411 {
1412         // If this is a child document, use the parent's cache instead.
1413         if (d->parent_buffer)
1414                 return d->parent_buffer->getBibfilesCache();
1415
1416         // We update the cache when first used instead of at loading time.
1417         if (d->bibfilesCache_.empty())
1418                 const_cast<Buffer *>(this)->updateBibfilesCache();
1419
1420         return d->bibfilesCache_;
1421 }
1422
1423
1424 BiblioInfo const & Buffer::masterBibInfo() const
1425 {
1426         // if this is a child document and the parent is already loaded
1427         // use the parent's list instead  [ale990412]
1428         Buffer const * const tmp = masterBuffer();
1429         LASSERT(tmp, /**/);
1430         if (tmp != this)
1431                 return tmp->masterBibInfo();
1432         return localBibInfo();
1433 }
1434
1435
1436 BiblioInfo const & Buffer::localBibInfo() const
1437 {
1438         if (d->bibinfoCacheValid_) {
1439                 support::FileNameList const & bibfilesCache = getBibfilesCache();
1440                 // compare the cached timestamps with the actual ones.
1441                 support::FileNameList::const_iterator ei = bibfilesCache.begin();
1442                 support::FileNameList::const_iterator en = bibfilesCache.end();
1443                 for (; ei != en; ++ ei) {
1444                         time_t lastw = ei->lastModified();
1445                         if (lastw != d->bibfileStatus_[*ei]) {
1446                                 d->bibinfoCacheValid_ = false;
1447                                 d->bibfileStatus_[*ei] = lastw;
1448                                 break;
1449                         }
1450                 }
1451         }
1452
1453         if (!d->bibinfoCacheValid_) {
1454                 d->bibinfo_.clear();
1455                 for (InsetIterator it = inset_iterator_begin(inset()); it; ++it)
1456                         it->fillWithBibKeys(d->bibinfo_, it);
1457                 d->bibinfoCacheValid_ = true;
1458         }
1459         return d->bibinfo_;
1460 }
1461
1462
1463 bool Buffer::isDepClean(string const & name) const
1464 {
1465         DepClean::const_iterator const it = d->dep_clean.find(name);
1466         if (it == d->dep_clean.end())
1467                 return true;
1468         return it->second;
1469 }
1470
1471
1472 void Buffer::markDepClean(string const & name)
1473 {
1474         d->dep_clean[name] = true;
1475 }
1476
1477
1478 bool Buffer::dispatch(string const & command, bool * result)
1479 {
1480         return dispatch(lyxaction.lookupFunc(command), result);
1481 }
1482
1483
1484 bool Buffer::dispatch(FuncRequest const & func, bool * result)
1485 {
1486         bool dispatched = true;
1487
1488         switch (func.action) {
1489                 case LFUN_BUFFER_EXPORT: {
1490                         bool const tmp = doExport(to_utf8(func.argument()), false);
1491                         if (result)
1492                                 *result = tmp;
1493                         break;
1494                 }
1495
1496                 case LFUN_BRANCH_ACTIVATE:
1497                 case LFUN_BRANCH_DEACTIVATE: {
1498                         BranchList & branchList = params().branchlist();
1499                         docstring const branchName = func.argument();
1500                         Branch * branch = branchList.find(branchName);
1501                         if (!branch)
1502                                 LYXERR0("Branch " << branchName << " does not exist.");
1503                         else
1504                                 branch->setSelected(func.action == LFUN_BRANCH_ACTIVATE);
1505                         if (result)
1506                                 *result = true;
1507                 }
1508
1509                 default:
1510                         dispatched = false;
1511         }
1512         return dispatched;
1513 }
1514
1515
1516 void Buffer::changeLanguage(Language const * from, Language const * to)
1517 {
1518         LASSERT(from, /**/);
1519         LASSERT(to, /**/);
1520
1521         for_each(par_iterator_begin(),
1522                  par_iterator_end(),
1523                  bind(&Paragraph::changeLanguage, _1, params(), from, to));
1524 }
1525
1526
1527 bool Buffer::isMultiLingual() const
1528 {
1529         ParConstIterator end = par_iterator_end();
1530         for (ParConstIterator it = par_iterator_begin(); it != end; ++it)
1531                 if (it->isMultiLingual(params()))
1532                         return true;
1533
1534         return false;
1535 }
1536
1537
1538 DocIterator Buffer::getParFromID(int const id) const
1539 {
1540         Buffer * buf = const_cast<Buffer *>(this);
1541         if (id < 0) {
1542                 // John says this is called with id == -1 from undo
1543                 lyxerr << "getParFromID(), id: " << id << endl;
1544                 return doc_iterator_end(buf);
1545         }
1546
1547         for (DocIterator it = doc_iterator_begin(buf); !it.atEnd(); it.forwardPar())
1548                 if (it.paragraph().id() == id)
1549                         return it;
1550
1551         return doc_iterator_end(buf);
1552 }
1553
1554
1555 bool Buffer::hasParWithID(int const id) const
1556 {
1557         return !getParFromID(id).atEnd();
1558 }
1559
1560
1561 ParIterator Buffer::par_iterator_begin()
1562 {
1563         return ParIterator(doc_iterator_begin(this));
1564 }
1565
1566
1567 ParIterator Buffer::par_iterator_end()
1568 {
1569         return ParIterator(doc_iterator_end(this));
1570 }
1571
1572
1573 ParConstIterator Buffer::par_iterator_begin() const
1574 {
1575         return ParConstIterator(doc_iterator_begin(this));
1576 }
1577
1578
1579 ParConstIterator Buffer::par_iterator_end() const
1580 {
1581         return ParConstIterator(doc_iterator_end(this));
1582 }
1583
1584
1585 Language const * Buffer::language() const
1586 {
1587         return params().language;
1588 }
1589
1590
1591 docstring const Buffer::B_(string const & l10n) const
1592 {
1593         return params().B_(l10n);
1594 }
1595
1596
1597 bool Buffer::isClean() const
1598 {
1599         return d->lyx_clean;
1600 }
1601
1602
1603 bool Buffer::isBakClean() const
1604 {
1605         return d->bak_clean;
1606 }
1607
1608
1609 bool Buffer::isExternallyModified(CheckMethod method) const
1610 {
1611         LASSERT(d->filename.exists(), /**/);
1612         // if method == timestamp, check timestamp before checksum
1613         return (method == checksum_method
1614                 || d->timestamp_ != d->filename.lastModified())
1615                 && d->checksum_ != d->filename.checksum();
1616 }
1617
1618
1619 void Buffer::saveCheckSum(FileName const & file) const
1620 {
1621         if (file.exists()) {
1622                 d->timestamp_ = file.lastModified();
1623                 d->checksum_ = file.checksum();
1624         } else {
1625                 // in the case of save to a new file.
1626                 d->timestamp_ = 0;
1627                 d->checksum_ = 0;
1628         }
1629 }
1630
1631
1632 void Buffer::markClean() const
1633 {
1634         if (!d->lyx_clean) {
1635                 d->lyx_clean = true;
1636                 updateTitles();
1637         }
1638         // if the .lyx file has been saved, we don't need an
1639         // autosave
1640         d->bak_clean = true;
1641 }
1642
1643
1644 void Buffer::markBakClean() const
1645 {
1646         d->bak_clean = true;
1647 }
1648
1649
1650 void Buffer::setUnnamed(bool flag)
1651 {
1652         d->unnamed = flag;
1653 }
1654
1655
1656 bool Buffer::isUnnamed() const
1657 {
1658         return d->unnamed;
1659 }
1660
1661
1662 // FIXME: this function should be moved to buffer_pimpl.C
1663 void Buffer::markDirty()
1664 {
1665         if (d->lyx_clean) {
1666                 d->lyx_clean = false;
1667                 updateTitles();
1668         }
1669         d->bak_clean = false;
1670
1671         DepClean::iterator it = d->dep_clean.begin();
1672         DepClean::const_iterator const end = d->dep_clean.end();
1673
1674         for (; it != end; ++it)
1675                 it->second = false;
1676 }
1677
1678
1679 FileName Buffer::fileName() const
1680 {
1681         return d->filename;
1682 }
1683
1684
1685 string Buffer::absFileName() const
1686 {
1687         return d->filename.absFilename();
1688 }
1689
1690
1691 string Buffer::filePath() const
1692 {
1693         return d->filename.onlyPath().absFilename() + "/";
1694 }
1695
1696
1697 bool Buffer::isReadonly() const
1698 {
1699         return d->read_only;
1700 }
1701
1702
1703 void Buffer::setParent(Buffer const * buffer)
1704 {
1705         // Avoids recursive include.
1706         d->parent_buffer = buffer == this ? 0 : buffer;
1707         updateMacros();
1708 }
1709
1710
1711 Buffer const * Buffer::parent() const
1712 {
1713         return d->parent_buffer;
1714 }
1715
1716
1717 void Buffer::collectRelatives(BufferSet & bufs) const
1718 {
1719         bufs.insert(this);
1720         if (parent())
1721                 parent()->collectRelatives(bufs);
1722
1723         // loop over children
1724         Impl::BufferPositionMap::iterator it = d->children_positions.begin();
1725         Impl::BufferPositionMap::iterator end = d->children_positions.end();
1726         for (; it != end; ++it)
1727                 bufs.insert(const_cast<Buffer *>(it->first));
1728 }
1729
1730
1731 std::vector<Buffer const *> Buffer::allRelatives() const
1732 {
1733         BufferSet bufs;
1734         collectRelatives(bufs);
1735         BufferSet::iterator it = bufs.begin();
1736         std::vector<Buffer const *> ret;
1737         for (; it != bufs.end(); ++it)
1738                 ret.push_back(*it);
1739         return ret;
1740 }
1741
1742
1743 Buffer const * Buffer::masterBuffer() const
1744 {
1745         if (!d->parent_buffer)
1746                 return this;
1747
1748         return d->parent_buffer->masterBuffer();
1749 }
1750
1751
1752 bool Buffer::isChild(Buffer * child) const
1753 {
1754         return d->children_positions.find(child) != d->children_positions.end();
1755 }
1756
1757
1758 DocIterator Buffer::firstChildPosition(Buffer const * child)
1759 {
1760         Impl::BufferPositionMap::iterator it;
1761         it = d->children_positions.find(child);
1762         if (it == d->children_positions.end())
1763                 return DocIterator(this);
1764         return it->second;
1765 }
1766
1767
1768 template<typename M>
1769 typename M::iterator greatest_below(M & m, typename M::key_type const & x)
1770 {
1771         if (m.empty())
1772                 return m.end();
1773
1774         typename M::iterator it = m.lower_bound(x);
1775         if (it == m.begin())
1776                 return m.end();
1777
1778         it--;
1779         return it;
1780 }
1781
1782
1783 MacroData const * Buffer::getBufferMacro(docstring const & name,
1784                                          DocIterator const & pos) const
1785 {
1786         LYXERR(Debug::MACROS, "Searching for " << to_ascii(name) << " at " << pos);
1787
1788         // if paragraphs have no macro context set, pos will be empty
1789         if (pos.empty())
1790                 return 0;
1791
1792         // we haven't found anything yet
1793         DocIterator bestPos = par_iterator_begin();
1794         MacroData const * bestData = 0;
1795
1796         // find macro definitions for name
1797         Impl::NamePositionScopeMacroMap::iterator nameIt
1798                 = d->macros.find(name);
1799         if (nameIt != d->macros.end()) {
1800                 // find last definition in front of pos or at pos itself
1801                 Impl::PositionScopeMacroMap::const_iterator it
1802                         = greatest_below(nameIt->second, pos);
1803                 if (it != nameIt->second.end()) {
1804                         while (true) {
1805                                 // scope ends behind pos?
1806                                 if (pos < it->second.first) {
1807                                         // Looks good, remember this. If there
1808                                         // is no external macro behind this,
1809                                         // we found the right one already.
1810                                         bestPos = it->first;
1811                                         bestData = &it->second.second;
1812                                         break;
1813                                 }
1814
1815                                 // try previous macro if there is one
1816                                 if (it == nameIt->second.begin())
1817                                         break;
1818                                 it--;
1819                         }
1820                 }
1821         }
1822
1823         // find macros in included files
1824         Impl::PositionScopeBufferMap::const_iterator it
1825                 = greatest_below(d->position_to_children, pos);
1826         if (it == d->position_to_children.end())
1827                 // no children before
1828                 return bestData;
1829
1830         while (true) {
1831                 // do we know something better (i.e. later) already?
1832                 if (it->first < bestPos )
1833                         break;
1834
1835                 // scope ends behind pos?
1836                 if (pos < it->second.first) {
1837                         // look for macro in external file
1838                         d->macro_lock = true;
1839                         MacroData const * data
1840                         = it->second.second->getMacro(name, false);
1841                         d->macro_lock = false;
1842                         if (data) {
1843                                 bestPos = it->first;
1844                                 bestData = data;
1845                                 break;
1846                         }
1847                 }
1848
1849                 // try previous file if there is one
1850                 if (it == d->position_to_children.begin())
1851                         break;
1852                 --it;
1853         }
1854
1855         // return the best macro we have found
1856         return bestData;
1857 }
1858
1859
1860 MacroData const * Buffer::getMacro(docstring const & name,
1861         DocIterator const & pos, bool global) const
1862 {
1863         if (d->macro_lock)
1864                 return 0;
1865
1866         // query buffer macros
1867         MacroData const * data = getBufferMacro(name, pos);
1868         if (data != 0)
1869                 return data;
1870
1871         // If there is a master buffer, query that
1872         if (d->parent_buffer) {
1873                 d->macro_lock = true;
1874                 MacroData const * macro = d->parent_buffer->getMacro(
1875                         name, *this, false);
1876                 d->macro_lock = false;
1877                 if (macro)
1878                         return macro;
1879         }
1880
1881         if (global) {
1882                 data = MacroTable::globalMacros().get(name);
1883                 if (data != 0)
1884                         return data;
1885         }
1886
1887         return 0;
1888 }
1889
1890
1891 MacroData const * Buffer::getMacro(docstring const & name, bool global) const
1892 {
1893         // set scope end behind the last paragraph
1894         DocIterator scope = par_iterator_begin();
1895         scope.pit() = scope.lastpit() + 1;
1896
1897         return getMacro(name, scope, global);
1898 }
1899
1900
1901 MacroData const * Buffer::getMacro(docstring const & name,
1902         Buffer const & child, bool global) const
1903 {
1904         // look where the child buffer is included first
1905         Impl::BufferPositionMap::iterator it = d->children_positions.find(&child);
1906         if (it == d->children_positions.end())
1907                 return 0;
1908
1909         // check for macros at the inclusion position
1910         return getMacro(name, it->second, global);
1911 }
1912
1913
1914 void Buffer::updateMacros(DocIterator & it, DocIterator & scope) const
1915 {
1916         pit_type lastpit = it.lastpit();
1917
1918         // look for macros in each paragraph
1919         while (it.pit() <= lastpit) {
1920                 Paragraph & par = it.paragraph();
1921
1922                 // iterate over the insets of the current paragraph
1923                 InsetList const & insets = par.insetList();
1924                 InsetList::const_iterator iit = insets.begin();
1925                 InsetList::const_iterator end = insets.end();
1926                 for (; iit != end; ++iit) {
1927                         it.pos() = iit->pos;
1928
1929                         // is it a nested text inset?
1930                         if (iit->inset->asInsetText()) {
1931                                 // Inset needs its own scope?
1932                                 InsetText const * itext
1933                                 = iit->inset->asInsetText();
1934                                 bool newScope = itext->isMacroScope();
1935
1936                                 // scope which ends just behind the inset
1937                                 DocIterator insetScope = it;
1938                                 ++insetScope.pos();
1939
1940                                 // collect macros in inset
1941                                 it.push_back(CursorSlice(*iit->inset));
1942                                 updateMacros(it, newScope ? insetScope : scope);
1943                                 it.pop_back();
1944                                 continue;
1945                         }
1946
1947                         // is it an external file?
1948                         if (iit->inset->lyxCode() == INCLUDE_CODE) {
1949                                 // get buffer of external file
1950                                 InsetInclude const & inset
1951                                         = static_cast<InsetInclude const &>(*iit->inset);
1952                                 d->macro_lock = true;
1953                                 Buffer * child = inset.loadIfNeeded(*this);
1954                                 d->macro_lock = false;
1955                                 if (!child)
1956                                         continue;
1957
1958                                 // register its position, but only when it is
1959                                 // included first in the buffer
1960                                 if (d->children_positions.find(child)
1961                                         == d->children_positions.end())
1962                                         d->children_positions[child] = it;
1963
1964                                 // register child with its scope
1965                                 d->position_to_children[it] = Impl::ScopeBuffer(scope, child);
1966                                 continue;
1967                         }
1968
1969                         if (iit->inset->lyxCode() != MATHMACRO_CODE)
1970                                 continue;
1971
1972                         // get macro data
1973                         MathMacroTemplate & macroTemplate
1974                         = static_cast<MathMacroTemplate &>(*iit->inset);
1975                         MacroContext mc(*this, it);
1976                         macroTemplate.updateToContext(mc);
1977
1978                         // valid?
1979                         bool valid = macroTemplate.validMacro();
1980                         // FIXME: Should be fixNameAndCheckIfValid() in fact,
1981                         // then the BufferView's cursor will be invalid in
1982                         // some cases which leads to crashes.
1983                         if (!valid)
1984                                 continue;
1985
1986                         // register macro
1987                         d->macros[macroTemplate.name()][it] =
1988                                 Impl::ScopeMacro(scope, MacroData(*this, it));
1989                 }
1990
1991                 // next paragraph
1992                 it.pit()++;
1993                 it.pos() = 0;
1994         }
1995 }
1996
1997
1998 void Buffer::updateMacros() const
1999 {
2000         if (d->macro_lock)
2001                 return;
2002
2003         LYXERR(Debug::MACROS, "updateMacro of " << d->filename.onlyFileName());
2004
2005         // start with empty table
2006         d->macros.clear();
2007         d->children_positions.clear();
2008         d->position_to_children.clear();
2009
2010         // Iterate over buffer, starting with first paragraph
2011         // The scope must be bigger than any lookup DocIterator
2012         // later. For the global lookup, lastpit+1 is used, hence
2013         // we use lastpit+2 here.
2014         DocIterator it = par_iterator_begin();
2015         DocIterator outerScope = it;
2016         outerScope.pit() = outerScope.lastpit() + 2;
2017         updateMacros(it, outerScope);
2018 }
2019
2020
2021 void Buffer::updateMacroInstances() const
2022 {
2023         LYXERR(Debug::MACROS, "updateMacroInstances for "
2024                 << d->filename.onlyFileName());
2025         DocIterator it = doc_iterator_begin(this);
2026         DocIterator end = doc_iterator_end(this);
2027         for (; it != end; it.forwardPos()) {
2028                 // look for MathData cells in InsetMathNest insets
2029                 Inset * inset = it.nextInset();
2030                 if (!inset)
2031                         continue;
2032
2033                 InsetMath * minset = inset->asInsetMath();
2034                 if (!minset)
2035                         continue;
2036
2037                 // update macro in all cells of the InsetMathNest
2038                 DocIterator::idx_type n = minset->nargs();
2039                 MacroContext mc = MacroContext(*this, it);
2040                 for (DocIterator::idx_type i = 0; i < n; ++i) {
2041                         MathData & data = minset->cell(i);
2042                         data.updateMacros(0, mc);
2043                 }
2044         }
2045 }
2046
2047
2048 void Buffer::listMacroNames(MacroNameSet & macros) const
2049 {
2050         if (d->macro_lock)
2051                 return;
2052
2053         d->macro_lock = true;
2054
2055         // loop over macro names
2056         Impl::NamePositionScopeMacroMap::iterator nameIt = d->macros.begin();
2057         Impl::NamePositionScopeMacroMap::iterator nameEnd = d->macros.end();
2058         for (; nameIt != nameEnd; ++nameIt)
2059                 macros.insert(nameIt->first);
2060
2061         // loop over children
2062         Impl::BufferPositionMap::iterator it = d->children_positions.begin();
2063         Impl::BufferPositionMap::iterator end = d->children_positions.end();
2064         for (; it != end; ++it)
2065                 it->first->listMacroNames(macros);
2066
2067         // call parent
2068         if (d->parent_buffer)
2069                 d->parent_buffer->listMacroNames(macros);
2070
2071         d->macro_lock = false;
2072 }
2073
2074
2075 void Buffer::listParentMacros(MacroSet & macros, LaTeXFeatures & features) const
2076 {
2077         if (!d->parent_buffer)
2078                 return;
2079
2080         MacroNameSet names;
2081         d->parent_buffer->listMacroNames(names);
2082
2083         // resolve macros
2084         MacroNameSet::iterator it = names.begin();
2085         MacroNameSet::iterator end = names.end();
2086         for (; it != end; ++it) {
2087                 // defined?
2088                 MacroData const * data =
2089                 d->parent_buffer->getMacro(*it, *this, false);
2090                 if (data) {
2091                         macros.insert(data);
2092
2093                         // we cannot access the original MathMacroTemplate anymore
2094                         // here to calls validate method. So we do its work here manually.
2095                         // FIXME: somehow make the template accessible here.
2096                         if (data->optionals() > 0)
2097                                 features.require("xargs");
2098                 }
2099         }
2100 }
2101
2102
2103 Buffer::References & Buffer::references(docstring const & label)
2104 {
2105         if (d->parent_buffer)
2106                 return const_cast<Buffer *>(masterBuffer())->references(label);
2107
2108         RefCache::iterator it = d->ref_cache_.find(label);
2109         if (it != d->ref_cache_.end())
2110                 return it->second.second;
2111
2112         static InsetLabel const * dummy_il = 0;
2113         static References const dummy_refs;
2114         it = d->ref_cache_.insert(
2115                 make_pair(label, make_pair(dummy_il, dummy_refs))).first;
2116         return it->second.second;
2117 }
2118
2119
2120 Buffer::References const & Buffer::references(docstring const & label) const
2121 {
2122         return const_cast<Buffer *>(this)->references(label);
2123 }
2124
2125
2126 void Buffer::setInsetLabel(docstring const & label, InsetLabel const * il)
2127 {
2128         masterBuffer()->d->ref_cache_[label].first = il;
2129 }
2130
2131
2132 InsetLabel const * Buffer::insetLabel(docstring const & label) const
2133 {
2134         return masterBuffer()->d->ref_cache_[label].first;
2135 }
2136
2137
2138 void Buffer::clearReferenceCache() const
2139 {
2140         if (!d->parent_buffer)
2141                 d->ref_cache_.clear();
2142 }
2143
2144
2145 void Buffer::changeRefsIfUnique(docstring const & from, docstring const & to,
2146         InsetCode code)
2147 {
2148         //FIXME: This does not work for child documents yet.
2149         LASSERT(code == CITE_CODE, /**/);
2150         // Check if the label 'from' appears more than once
2151         vector<docstring> labels;
2152         string paramName;
2153         BiblioInfo const & keys = masterBibInfo();
2154         BiblioInfo::const_iterator bit  = keys.begin();
2155         BiblioInfo::const_iterator bend = keys.end();
2156
2157         for (; bit != bend; ++bit)
2158                 // FIXME UNICODE
2159                 labels.push_back(bit->first);
2160         paramName = "key";
2161
2162         if (count(labels.begin(), labels.end(), from) > 1)
2163                 return;
2164
2165         for (InsetIterator it = inset_iterator_begin(inset()); it; ++it) {
2166                 if (it->lyxCode() == code) {
2167                         InsetCommand & inset = static_cast<InsetCommand &>(*it);
2168                         docstring const oldValue = inset.getParam(paramName);
2169                         if (oldValue == from)
2170                                 inset.setParam(paramName, to);
2171                 }
2172         }
2173 }
2174
2175
2176 void Buffer::getSourceCode(odocstream & os, pit_type par_begin,
2177         pit_type par_end, bool full_source) const
2178 {
2179         OutputParams runparams(&params().encoding());
2180         runparams.nice = true;
2181         runparams.flavor = OutputParams::LATEX;
2182         runparams.linelen = lyxrc.plaintext_linelen;
2183         // No side effect of file copying and image conversion
2184         runparams.dryrun = true;
2185
2186         d->texrow.reset();
2187         if (full_source) {
2188                 os << "% " << _("Preview source code") << "\n\n";
2189                 d->texrow.newline();
2190                 d->texrow.newline();
2191                 if (isDocBook())
2192                         writeDocBookSource(os, absFileName(), runparams, false);
2193                 else
2194                         // latex or literate
2195                         writeLaTeXSource(os, string(), runparams, true, true);
2196         } else {
2197                 runparams.par_begin = par_begin;
2198                 runparams.par_end = par_end;
2199                 if (par_begin + 1 == par_end) {
2200                         os << "% "
2201                            << bformat(_("Preview source code for paragraph %1$d"), par_begin)
2202                            << "\n\n";
2203                 } else {
2204                         os << "% "
2205                            << bformat(_("Preview source code from paragraph %1$s to %2$s"),
2206                                         convert<docstring>(par_begin),
2207                                         convert<docstring>(par_end - 1))
2208                            << "\n\n";
2209                 }
2210                 d->texrow.newline();
2211                 d->texrow.newline();
2212                 // output paragraphs
2213                 if (isDocBook())
2214                         docbookParagraphs(paragraphs(), *this, os, runparams);
2215                 else 
2216                         // latex or literate
2217                         latexParagraphs(*this, text(), os, d->texrow, runparams);
2218         }
2219 }
2220
2221
2222 ErrorList & Buffer::errorList(string const & type) const
2223 {
2224         static ErrorList emptyErrorList;
2225         map<string, ErrorList>::iterator I = d->errorLists.find(type);
2226         if (I == d->errorLists.end())
2227                 return emptyErrorList;
2228
2229         return I->second;
2230 }
2231
2232
2233 void Buffer::updateTocItem(std::string const & type,
2234         DocIterator const & dit) const
2235 {
2236         if (gui_)
2237                 gui_->updateTocItem(type, dit);
2238 }
2239
2240
2241 void Buffer::structureChanged() const
2242 {
2243         if (gui_)
2244                 gui_->structureChanged();
2245 }
2246
2247
2248 void Buffer::errors(string const & err) const
2249 {
2250         if (gui_)
2251                 gui_->errors(err);
2252 }
2253
2254
2255 void Buffer::message(docstring const & msg) const
2256 {
2257         if (gui_)
2258                 gui_->message(msg);
2259 }
2260
2261
2262 void Buffer::setBusy(bool on) const
2263 {
2264         if (gui_)
2265                 gui_->setBusy(on);
2266 }
2267
2268
2269 void Buffer::setReadOnly(bool on) const
2270 {
2271         if (d->wa_)
2272                 d->wa_->setReadOnly(on);
2273 }
2274
2275
2276 void Buffer::updateTitles() const
2277 {
2278         if (d->wa_)
2279                 d->wa_->updateTitles();
2280 }
2281
2282
2283 void Buffer::resetAutosaveTimers() const
2284 {
2285         if (gui_)
2286                 gui_->resetAutosaveTimers();
2287 }
2288
2289
2290 void Buffer::setGuiDelegate(frontend::GuiBufferDelegate * gui)
2291 {
2292         gui_ = gui;
2293 }
2294
2295
2296
2297 namespace {
2298
2299 class AutoSaveBuffer : public ForkedProcess {
2300 public:
2301         ///
2302         AutoSaveBuffer(Buffer const & buffer, FileName const & fname)
2303                 : buffer_(buffer), fname_(fname) {}
2304         ///
2305         virtual boost::shared_ptr<ForkedProcess> clone() const
2306         {
2307                 return boost::shared_ptr<ForkedProcess>(new AutoSaveBuffer(*this));
2308         }
2309         ///
2310         int start()
2311         {
2312                 command_ = to_utf8(bformat(_("Auto-saving %1$s"),
2313                                                  from_utf8(fname_.absFilename())));
2314                 return run(DontWait);
2315         }
2316 private:
2317         ///
2318         virtual int generateChild();
2319         ///
2320         Buffer const & buffer_;
2321         FileName fname_;
2322 };
2323
2324
2325 int AutoSaveBuffer::generateChild()
2326 {
2327         // tmp_ret will be located (usually) in /tmp
2328         // will that be a problem?
2329         // Note that this calls ForkedCalls::fork(), so it's
2330         // ok cross-platform.
2331         pid_t const pid = fork();
2332         // If you want to debug the autosave
2333         // you should set pid to -1, and comment out the fork.
2334         if (pid != 0 && pid != -1)
2335                 return pid;
2336
2337         // pid = -1 signifies that lyx was unable
2338         // to fork. But we will do the save
2339         // anyway.
2340         bool failed = false;
2341         FileName const tmp_ret = FileName::tempName("lyxauto");
2342         if (!tmp_ret.empty()) {
2343                 buffer_.writeFile(tmp_ret);
2344                 // assume successful write of tmp_ret
2345                 if (!tmp_ret.moveTo(fname_))
2346                         failed = true;
2347         } else
2348                 failed = true;
2349
2350         if (failed) {
2351                 // failed to write/rename tmp_ret so try writing direct
2352                 if (!buffer_.writeFile(fname_)) {
2353                         // It is dangerous to do this in the child,
2354                         // but safe in the parent, so...
2355                         if (pid == -1) // emit message signal.
2356                                 buffer_.message(_("Autosave failed!"));
2357                 }
2358         }
2359
2360         if (pid == 0) // we are the child so...
2361                 _exit(0);
2362
2363         return pid;
2364 }
2365
2366 } // namespace anon
2367
2368
2369 // Perfect target for a thread...
2370 void Buffer::autoSave() const
2371 {
2372         if (isBakClean() || isReadonly()) {
2373                 // We don't save now, but we'll try again later
2374                 resetAutosaveTimers();
2375                 return;
2376         }
2377
2378         // emit message signal.
2379         message(_("Autosaving current document..."));
2380
2381         // create autosave filename
2382         string fname = filePath();
2383         fname += '#';
2384         fname += d->filename.onlyFileName();
2385         fname += '#';
2386
2387         AutoSaveBuffer autosave(*this, FileName(fname));
2388         autosave.start();
2389
2390         markBakClean();
2391         resetAutosaveTimers();
2392 }
2393
2394
2395 string Buffer::bufferFormat() const
2396 {
2397         if (isDocBook())
2398                 return "docbook";
2399         if (isLiterate())
2400                 return "literate";
2401         if (params().encoding().package() == Encoding::japanese)
2402                 return "platex";
2403         return "latex";
2404 }
2405
2406
2407 bool Buffer::doExport(string const & format, bool put_in_tempdir,
2408         string & result_file) const
2409 {
2410         string backend_format;
2411         OutputParams runparams(&params().encoding());
2412         runparams.flavor = OutputParams::LATEX;
2413         runparams.linelen = lyxrc.plaintext_linelen;
2414         vector<string> backs = backends();
2415         if (find(backs.begin(), backs.end(), format) == backs.end()) {
2416                 // Get shortest path to format
2417                 Graph::EdgePath path;
2418                 for (vector<string>::const_iterator it = backs.begin();
2419                      it != backs.end(); ++it) {
2420                         Graph::EdgePath p = theConverters().getPath(*it, format);
2421                         if (!p.empty() && (path.empty() || p.size() < path.size())) {
2422                                 backend_format = *it;
2423                                 path = p;
2424                         }
2425                 }
2426                 if (!path.empty())
2427                         runparams.flavor = theConverters().getFlavor(path);
2428                 else {
2429                         Alert::error(_("Couldn't export file"),
2430                                 bformat(_("No information for exporting the format %1$s."),
2431                                    formats.prettyName(format)));
2432                         return false;
2433                 }
2434         } else {
2435                 backend_format = format;
2436                 // FIXME: Don't hardcode format names here, but use a flag
2437                 if (backend_format == "pdflatex")
2438                         runparams.flavor = OutputParams::PDFLATEX;
2439         }
2440
2441         string filename = latexName(false);
2442         filename = addName(temppath(), filename);
2443         filename = changeExtension(filename,
2444                                    formats.extension(backend_format));
2445
2446         // fix macros
2447         updateMacroInstances();
2448
2449         // Plain text backend
2450         if (backend_format == "text")
2451                 writePlaintextFile(*this, FileName(filename), runparams);
2452         // no backend
2453         else if (backend_format == "lyx")
2454                 writeFile(FileName(filename));
2455         // Docbook backend
2456         else if (isDocBook()) {
2457                 runparams.nice = !put_in_tempdir;
2458                 makeDocBookFile(FileName(filename), runparams);
2459         }
2460         // LaTeX backend
2461         else if (backend_format == format) {
2462                 runparams.nice = true;
2463                 if (!makeLaTeXFile(FileName(filename), string(), runparams))
2464                         return false;
2465         } else if (!lyxrc.tex_allows_spaces
2466                    && contains(filePath(), ' ')) {
2467                 Alert::error(_("File name error"),
2468                            _("The directory path to the document cannot contain spaces."));
2469                 return false;
2470         } else {
2471                 runparams.nice = false;
2472                 if (!makeLaTeXFile(FileName(filename), filePath(), runparams))
2473                         return false;
2474         }
2475
2476         string const error_type = (format == "program")
2477                 ? "Build" : bufferFormat();
2478         ErrorList & error_list = d->errorLists[error_type];
2479         string const ext = formats.extension(format);
2480         FileName const tmp_result_file(changeExtension(filename, ext));
2481         bool const success = theConverters().convert(this, FileName(filename),
2482                 tmp_result_file, FileName(absFileName()), backend_format, format,
2483                 error_list);
2484         // Emit the signal to show the error list.
2485         if (format != backend_format)
2486                 errors(error_type);
2487         if (!success)
2488                 return false;
2489
2490         if (put_in_tempdir) {
2491                 result_file = tmp_result_file.absFilename();
2492                 return true;
2493         }
2494
2495         result_file = changeExtension(absFileName(), ext);
2496         // We need to copy referenced files (e. g. included graphics
2497         // if format == "dvi") to the result dir.
2498         vector<ExportedFile> const files =
2499                 runparams.exportdata->externalFiles(format);
2500         string const dest = onlyPath(result_file);
2501         CopyStatus status = SUCCESS;
2502         for (vector<ExportedFile>::const_iterator it = files.begin();
2503                 it != files.end() && status != CANCEL; ++it) {
2504                 string const fmt = formats.getFormatFromFile(it->sourceName);
2505                 status = copyFile(fmt, it->sourceName,
2506                         makeAbsPath(it->exportName, dest),
2507                         it->exportName, status == FORCE);
2508         }
2509         if (status == CANCEL) {
2510                 message(_("Document export cancelled."));
2511         } else if (tmp_result_file.exists()) {
2512                 // Finally copy the main file
2513                 status = copyFile(format, tmp_result_file,
2514                         FileName(result_file), result_file,
2515                         status == FORCE);
2516                 message(bformat(_("Document exported as %1$s "
2517                         "to file `%2$s'"),
2518                         formats.prettyName(format),
2519                         makeDisplayPath(result_file)));
2520         } else {
2521                 // This must be a dummy converter like fax (bug 1888)
2522                 message(bformat(_("Document exported as %1$s"),
2523                         formats.prettyName(format)));
2524         }
2525
2526         return true;
2527 }
2528
2529
2530 bool Buffer::doExport(string const & format, bool put_in_tempdir) const
2531 {
2532         string result_file;
2533         return doExport(format, put_in_tempdir, result_file);
2534 }
2535
2536
2537 bool Buffer::preview(string const & format) const
2538 {
2539         string result_file;
2540         if (!doExport(format, true, result_file))
2541                 return false;
2542         return formats.view(*this, FileName(result_file), format);
2543 }
2544
2545
2546 bool Buffer::isExportable(string const & format) const
2547 {
2548         vector<string> backs = backends();
2549         for (vector<string>::const_iterator it = backs.begin();
2550              it != backs.end(); ++it)
2551                 if (theConverters().isReachable(*it, format))
2552                         return true;
2553         return false;
2554 }
2555
2556
2557 vector<Format const *> Buffer::exportableFormats(bool only_viewable) const
2558 {
2559         vector<string> backs = backends();
2560         vector<Format const *> result =
2561                 theConverters().getReachable(backs[0], only_viewable, true);
2562         for (vector<string>::const_iterator it = backs.begin() + 1;
2563              it != backs.end(); ++it) {
2564                 vector<Format const *>  r =
2565                         theConverters().getReachable(*it, only_viewable, false);
2566                 result.insert(result.end(), r.begin(), r.end());
2567         }
2568         return result;
2569 }
2570
2571
2572 vector<string> Buffer::backends() const
2573 {
2574         vector<string> v;
2575         if (params().baseClass()->isTeXClassAvailable()) {
2576                 v.push_back(bufferFormat());
2577                 // FIXME: Don't hardcode format names here, but use a flag
2578                 if (v.back() == "latex")
2579                         v.push_back("pdflatex");
2580         }
2581         v.push_back("text");
2582         v.push_back("lyx");
2583         return v;
2584 }
2585
2586
2587 bool Buffer::readFileHelper(FileName const & s)
2588 {
2589         // File information about normal file
2590         if (!s.exists()) {
2591                 docstring const file = makeDisplayPath(s.absFilename(), 50);
2592                 docstring text = bformat(_("The specified document\n%1$s"
2593                                                      "\ncould not be read."), file);
2594                 Alert::error(_("Could not read document"), text);
2595                 return false;
2596         }
2597
2598         // Check if emergency save file exists and is newer.
2599         FileName const e(s.absFilename() + ".emergency");
2600
2601         if (e.exists() && s.exists() && e.lastModified() > s.lastModified()) {
2602                 docstring const file = makeDisplayPath(s.absFilename(), 20);
2603                 docstring const text =
2604                         bformat(_("An emergency save of the document "
2605                                   "%1$s exists.\n\n"
2606                                                "Recover emergency save?"), file);
2607                 switch (Alert::prompt(_("Load emergency save?"), text, 0, 2,
2608                                       _("&Recover"),  _("&Load Original"),
2609                                       _("&Cancel")))
2610                 {
2611                 case 0:
2612                         // the file is not saved if we load the emergency file.
2613                         markDirty();
2614                         return readFile(e);
2615                 case 1:
2616                         break;
2617                 default:
2618                         return false;
2619                 }
2620         }
2621
2622         // Now check if autosave file is newer.
2623         FileName const a(onlyPath(s.absFilename()) + '#' + onlyFilename(s.absFilename()) + '#');
2624
2625         if (a.exists() && s.exists() && a.lastModified() > s.lastModified()) {
2626                 docstring const file = makeDisplayPath(s.absFilename(), 20);
2627                 docstring const text =
2628                         bformat(_("The backup of the document "
2629                                   "%1$s is newer.\n\nLoad the "
2630                                                "backup instead?"), file);
2631                 switch (Alert::prompt(_("Load backup?"), text, 0, 2,
2632                                       _("&Load backup"), _("Load &original"),
2633                                       _("&Cancel") ))
2634                 {
2635                 case 0:
2636                         // the file is not saved if we load the autosave file.
2637                         markDirty();
2638                         return readFile(a);
2639                 case 1:
2640                         // Here we delete the autosave
2641                         a.removeFile();
2642                         break;
2643                 default:
2644                         return false;
2645                 }
2646         }
2647         return readFile(s);
2648 }
2649
2650
2651 bool Buffer::loadLyXFile(FileName const & s)
2652 {
2653         if (s.isReadableFile()) {
2654                 if (readFileHelper(s)) {
2655                         lyxvc().file_found_hook(s);
2656                         if (!s.isWritable())
2657                                 setReadonly(true);
2658                         return true;
2659                 }
2660         } else {
2661                 docstring const file = makeDisplayPath(s.absFilename(), 20);
2662                 // Here we probably should run
2663                 if (LyXVC::file_not_found_hook(s)) {
2664                         docstring const text =
2665                                 bformat(_("Do you want to retrieve the document"
2666                                                        " %1$s from version control?"), file);
2667                         int const ret = Alert::prompt(_("Retrieve from version control?"),
2668                                 text, 0, 1, _("&Retrieve"), _("&Cancel"));
2669
2670                         if (ret == 0) {
2671                                 // How can we know _how_ to do the checkout?
2672                                 // With the current VC support it has to be,
2673                                 // a RCS file since CVS do not have special ,v files.
2674                                 RCS::retrieve(s);
2675                                 return loadLyXFile(s);
2676                         }
2677                 }
2678         }
2679         return false;
2680 }
2681
2682
2683 void Buffer::bufferErrors(TeXErrors const & terr, ErrorList & errorList) const
2684 {
2685         TeXErrors::Errors::const_iterator cit = terr.begin();
2686         TeXErrors::Errors::const_iterator end = terr.end();
2687
2688         for (; cit != end; ++cit) {
2689                 int id_start = -1;
2690                 int pos_start = -1;
2691                 int errorRow = cit->error_in_line;
2692                 bool found = d->texrow.getIdFromRow(errorRow, id_start,
2693                                                        pos_start);
2694                 int id_end = -1;
2695                 int pos_end = -1;
2696                 do {
2697                         ++errorRow;
2698                         found = d->texrow.getIdFromRow(errorRow, id_end, pos_end);
2699                 } while (found && id_start == id_end && pos_start == pos_end);
2700
2701                 errorList.push_back(ErrorItem(cit->error_desc,
2702                         cit->error_text, id_start, pos_start, pos_end));
2703         }
2704 }
2705
2706
2707 void Buffer::updateLabels(bool childonly) const
2708 {
2709         // Use the master text class also for child documents
2710         Buffer const * const master = masterBuffer();
2711         DocumentClass const & textclass = master->params().documentClass();
2712
2713         // keep the buffers to be children in this set. If the call from the
2714         // master comes back we can see which of them were actually seen (i.e.
2715         // via an InsetInclude). The remaining ones in the set need still be updated.
2716         static std::set<Buffer const *> bufToUpdate;
2717         if (!childonly) {
2718                 // If this is a child document start with the master
2719                 if (master != this) {
2720                         bufToUpdate.insert(this);
2721                         master->updateLabels(false);
2722
2723                         // was buf referenced from the master (i.e. not in bufToUpdate anymore)?
2724                         if (bufToUpdate.find(this) == bufToUpdate.end())
2725                                 return;
2726                 }
2727
2728                 // start over the counters in the master
2729                 textclass.counters().reset();
2730         }
2731
2732         // update will be done below for this buffer
2733         bufToUpdate.erase(this);
2734
2735         // update all caches
2736         clearReferenceCache();
2737         inset().setBuffer(const_cast<Buffer &>(*this));
2738         updateMacros();
2739
2740         Buffer & cbuf = const_cast<Buffer &>(*this);
2741
2742         LASSERT(!text().paragraphs().empty(), /**/);
2743
2744         // do the real work
2745         ParIterator parit = cbuf.par_iterator_begin();
2746         updateLabels(parit);
2747
2748         if (master != this)
2749                 // TocBackend update will be done later.
2750                 return;
2751
2752         cbuf.tocBackend().update();
2753         if (!childonly)
2754                 cbuf.structureChanged();
2755 }
2756
2757
2758 static depth_type getDepth(DocIterator const & it)
2759 {
2760         depth_type depth = 0;
2761         for (size_t i = 0 ; i < it.depth() ; ++i)
2762                 if (!it[i].inset().inMathed())
2763                         depth += it[i].paragraph().getDepth() + 1;
2764         // remove 1 since the outer inset does not count
2765         return depth - 1;
2766 }
2767
2768 static depth_type getItemDepth(ParIterator const & it)
2769 {
2770         Paragraph const & par = *it;
2771         LabelType const labeltype = par.layout().labeltype;
2772
2773         if (labeltype != LABEL_ENUMERATE && labeltype != LABEL_ITEMIZE)
2774                 return 0;
2775
2776         // this will hold the lowest depth encountered up to now.
2777         depth_type min_depth = getDepth(it);
2778         ParIterator prev_it = it;
2779         while (true) {
2780                 if (prev_it.pit())
2781                         --prev_it.top().pit();
2782                 else {
2783                         // start of nested inset: go to outer par
2784                         prev_it.pop_back();
2785                         if (prev_it.empty()) {
2786                                 // start of document: nothing to do
2787                                 return 0;
2788                         }
2789                 }
2790
2791                 // We search for the first paragraph with same label
2792                 // that is not more deeply nested.
2793                 Paragraph & prev_par = *prev_it;
2794                 depth_type const prev_depth = getDepth(prev_it);
2795                 if (labeltype == prev_par.layout().labeltype) {
2796                         if (prev_depth < min_depth)
2797                                 return prev_par.itemdepth + 1;
2798                         if (prev_depth == min_depth)
2799                                 return prev_par.itemdepth;
2800                 }
2801                 min_depth = min(min_depth, prev_depth);
2802                 // small optimization: if we are at depth 0, we won't
2803                 // find anything else
2804                 if (prev_depth == 0)
2805                         return 0;
2806         }
2807 }
2808
2809
2810 static bool needEnumCounterReset(ParIterator const & it)
2811 {
2812         Paragraph const & par = *it;
2813         LASSERT(par.layout().labeltype == LABEL_ENUMERATE, /**/);
2814         depth_type const cur_depth = par.getDepth();
2815         ParIterator prev_it = it;
2816         while (prev_it.pit()) {
2817                 --prev_it.top().pit();
2818                 Paragraph const & prev_par = *prev_it;
2819                 if (prev_par.getDepth() <= cur_depth)
2820                         return  prev_par.layout().labeltype != LABEL_ENUMERATE;
2821         }
2822         // start of nested inset: reset
2823         return true;
2824 }
2825
2826
2827 // set the label of a paragraph. This includes the counters.
2828 static void setLabel(Buffer const & buf, ParIterator & it)
2829 {
2830         BufferParams const & bp = buf.masterBuffer()->params();
2831         DocumentClass const & textclass = bp.documentClass();
2832         Paragraph & par = it.paragraph();
2833         Layout const & layout = par.layout();
2834         Counters & counters = textclass.counters();
2835
2836         if (par.params().startOfAppendix()) {
2837                 // FIXME: only the counter corresponding to toplevel
2838                 // sectionning should be reset
2839                 counters.reset();
2840                 counters.appendix(true);
2841         }
2842         par.params().appendix(counters.appendix());
2843
2844         // Compute the item depth of the paragraph
2845         par.itemdepth = getItemDepth(it);
2846
2847         if (layout.margintype == MARGIN_MANUAL) {
2848                 if (par.params().labelWidthString().empty())
2849                         par.params().labelWidthString(par.translateIfPossible(layout.labelstring(), bp));
2850         } else {
2851                 par.params().labelWidthString(docstring());
2852         }
2853
2854         switch(layout.labeltype) {
2855         case LABEL_COUNTER:
2856                 if (layout.toclevel <= bp.secnumdepth
2857                     && (layout.latextype != LATEX_ENVIRONMENT
2858                         || isFirstInSequence(it.pit(), it.plist()))) {
2859                         counters.step(layout.counter);
2860                         par.params().labelString(
2861                                 par.expandLabel(layout, bp));
2862                 } else
2863                         par.params().labelString(docstring());
2864                 break;
2865
2866         case LABEL_ITEMIZE: {
2867                 // At some point of time we should do something more
2868                 // clever here, like:
2869                 //   par.params().labelString(
2870                 //    bp.user_defined_bullet(par.itemdepth).getText());
2871                 // for now, use a simple hardcoded label
2872                 docstring itemlabel;
2873                 switch (par.itemdepth) {
2874                 case 0:
2875                         itemlabel = char_type(0x2022);
2876                         break;
2877                 case 1:
2878                         itemlabel = char_type(0x2013);
2879                         break;
2880                 case 2:
2881                         itemlabel = char_type(0x2217);
2882                         break;
2883                 case 3:
2884                         itemlabel = char_type(0x2219); // or 0x00b7
2885                         break;
2886                 }
2887                 par.params().labelString(itemlabel);
2888                 break;
2889         }
2890
2891         case LABEL_ENUMERATE: {
2892                 // FIXME: Yes I know this is a really, really! bad solution
2893                 // (Lgb)
2894                 docstring enumcounter = from_ascii("enum");
2895
2896                 switch (par.itemdepth) {
2897                 case 2:
2898                         enumcounter += 'i';
2899                 case 1:
2900                         enumcounter += 'i';
2901                 case 0:
2902                         enumcounter += 'i';
2903                         break;
2904                 case 3:
2905                         enumcounter += "iv";
2906                         break;
2907                 default:
2908                         // not a valid enumdepth...
2909                         break;
2910                 }
2911
2912                 // Maybe we have to reset the enumeration counter.
2913                 if (needEnumCounterReset(it))
2914                         counters.reset(enumcounter);
2915
2916                 counters.step(enumcounter);
2917
2918                 string format;
2919
2920                 switch (par.itemdepth) {
2921                 case 0:
2922                         format = N_("\\arabic{enumi}.");
2923                         break;
2924                 case 1:
2925                         format = N_("(\\alph{enumii})");
2926                         break;
2927                 case 2:
2928                         format = N_("\\roman{enumiii}.");
2929                         break;
2930                 case 3:
2931                         format = N_("\\Alph{enumiv}.");
2932                         break;
2933                 default:
2934                         // not a valid enumdepth...
2935                         break;
2936                 }
2937
2938                 par.params().labelString(counters.counterLabel(
2939                         par.translateIfPossible(from_ascii(format), bp)));
2940
2941                 break;
2942         }
2943
2944         case LABEL_SENSITIVE: {
2945                 string const & type = counters.current_float();
2946                 docstring full_label;
2947                 if (type.empty())
2948                         full_label = buf.B_("Senseless!!! ");
2949                 else {
2950                         docstring name = buf.B_(textclass.floats().getType(type).name());
2951                         if (counters.hasCounter(from_utf8(type))) {
2952                                 counters.step(from_utf8(type));
2953                                 full_label = bformat(from_ascii("%1$s %2$s:"), 
2954                                                      name, 
2955                                                      counters.theCounter(from_utf8(type)));
2956                         } else
2957                                 full_label = bformat(from_ascii("%1$s #:"), name);      
2958                 }
2959                 par.params().labelString(full_label);   
2960                 break;
2961         }
2962
2963         case LABEL_NO_LABEL:
2964                 par.params().labelString(docstring());
2965                 break;
2966
2967         case LABEL_MANUAL:
2968         case LABEL_TOP_ENVIRONMENT:
2969         case LABEL_CENTERED_TOP_ENVIRONMENT:
2970         case LABEL_STATIC:      
2971         case LABEL_BIBLIO:
2972                 par.params().labelString(
2973                         par.translateIfPossible(layout.labelstring(), bp));
2974                 break;
2975         }
2976 }
2977
2978
2979 void Buffer::updateLabels(ParIterator & parit) const
2980 {
2981         LASSERT(parit.pit() == 0, /**/);
2982
2983         // set the position of the text in the buffer to be able
2984         // to resolve macros in it. This has nothing to do with
2985         // labels, but by putting it here we avoid implementing
2986         // a whole bunch of traversal routines just for this call.
2987         parit.text()->setMacrocontextPosition(parit);
2988
2989         depth_type maxdepth = 0;
2990         pit_type const lastpit = parit.lastpit();
2991         for ( ; parit.pit() <= lastpit ; ++parit.pit()) {
2992                 // reduce depth if necessary
2993                 parit->params().depth(min(parit->params().depth(), maxdepth));
2994                 maxdepth = parit->getMaxDepthAfter();
2995
2996                 // set the counter for this paragraph
2997                 setLabel(*this, parit);
2998
2999                 // Now the insets
3000                 InsetList::const_iterator iit = parit->insetList().begin();
3001                 InsetList::const_iterator end = parit->insetList().end();
3002                 for (; iit != end; ++iit) {
3003                         parit.pos() = iit->pos;
3004                         iit->inset->updateLabels(parit);
3005                 }
3006         }
3007 }
3008
3009 } // namespace lyx