improve documentation

This commit is contained in:
Georg Baum 2012-11-13 21:53:13 +01:00
parent 393e7924bd
commit b07383b026
2 changed files with 21 additions and 16 deletions

View File

@ -47,12 +47,13 @@ public:
LyX loads a file. This function then checks for a master VC file (for LyX loads a file. This function then checks for a master VC file (for
RCS this is *,v or RCS/ *,v ; for CVS this is CVS/Entries and .svn/entries RCS this is *,v or RCS/ *,v ; for CVS this is CVS/Entries and .svn/entries
for SVN) if this file or entry is found, the loaded file is assumed to be for SVN) if this file or entry is found, the loaded file is assumed to be
under controll by VC, and the appropiate actions is taken. under control by VC, and the appropiate actions is taken.
Returns true if the file is under control by a VCS. Returns true if the file is under control by a VCS.
*/ */
bool file_found_hook(support::FileName const & fn); bool file_found_hook(support::FileName const & fn);
/** This function should be run when a file is requested for loading, /** Is \p fn in under version control?
This function should be run when a file is requested for loading,
but it does not exist. This function will then check for a VC master but it does not exist. This function will then check for a VC master
file with the same name (see above function). If this exists the file with the same name (see above function). If this exists the
user should be asked if he/her wants to checkout a version for user should be asked if he/her wants to checkout a version for
@ -64,7 +65,7 @@ public:
/// ///
void setBuffer(Buffer *); void setBuffer(Buffer *);
/// Register the document as an VC file. /// Register the document as a VC file.
bool registrer(); bool registrer();

View File

@ -41,29 +41,33 @@ public:
virtual void registrer(std::string const & msg) = 0; virtual void registrer(std::string const & msg) = 0;
/// check in the current revision, returns log /// check in the current revision, returns log
virtual std::string checkIn(std::string const & msg) = 0; virtual std::string checkIn(std::string const & msg) = 0;
// can be this operation processed in the current RCS? /// can this operation be processed in the current VCS?
virtual bool checkInEnabled() = 0; virtual bool checkInEnabled() = 0;
// should a log message provided for next checkin? /// should a log message provided for next checkin?
virtual bool isCheckInWithConfirmation() = 0; virtual bool isCheckInWithConfirmation() = 0;
/// check out for editing, returns log /// check out for editing, returns log
virtual std::string checkOut() = 0; virtual std::string checkOut() = 0;
// can be this operation processed in the current RCS? /// can this operation be processed in the current VCS?
virtual bool checkOutEnabled() = 0; virtual bool checkOutEnabled() = 0;
/// synchronize with repository, returns log /// synchronize with repository, returns log
virtual std::string repoUpdate() = 0; virtual std::string repoUpdate() = 0;
// can be this operation processed in the current RCS? /// can this operation be processed in the current VCS?
virtual bool repoUpdateEnabled() = 0; virtual bool repoUpdateEnabled() = 0;
// toggle locking property of the file /// toggle locking property of the file
virtual std::string lockingToggle() = 0; virtual std::string lockingToggle() = 0;
// can be this operation processed in the current RCS? /// can this operation be processed in the current VCS?
virtual bool lockingToggleEnabled() = 0; virtual bool lockingToggleEnabled() = 0;
/// revert current edits /// revert current edits
virtual bool revert() = 0; virtual bool revert() = 0;
// should a confirmation before revert requested? /// should a confirmation before revert requested?
virtual bool isRevertWithConfirmation() = 0; virtual bool isRevertWithConfirmation() = 0;
/// FIXME /**
* Merge the current with the previous version
* in a reverse patch kind of way, so that the
* result is to revert the last changes.
*/
virtual void undoLast() = 0; virtual void undoLast() = 0;
// can be this operation processed in the current RCS? /// can this operation be processed in the current VCS?
virtual bool undoLastEnabled() = 0; virtual bool undoLastEnabled() = 0;
/** /**
* getLog - read the revision log into the given file * getLog - read the revision log into the given file
@ -81,13 +85,13 @@ public:
virtual bool toggleReadOnlyEnabled() = 0; virtual bool toggleReadOnlyEnabled() = 0;
/// Return revision info specified by the argument. /// Return revision info specified by the argument.
virtual std::string revisionInfo(LyXVC::RevisionInfo const info) = 0; virtual std::string revisionInfo(LyXVC::RevisionInfo const info) = 0;
/// can this operation be processed in the current VCS?
virtual bool prepareFileRevision(std::string const & rev, std::string & f) = 0; virtual bool prepareFileRevision(std::string const & rev, std::string & f) = 0;
/// can this operation be processed in the current VCS?
virtual bool prepareFileRevisionEnabled() = 0; virtual bool prepareFileRevisionEnabled() = 0;
/// Check the directory of file and all parent directories /// Check the directory of file and all parent directories
// for the existence of the given pathname /// for the existence of the given pathname
static bool checkparentdirs(support::FileName const & file, std::string const & pathname); static bool checkparentdirs(support::FileName const & file, std::string const & pathname);
protected: protected:
@ -98,7 +102,7 @@ protected:
/// If needed converts last or relative number to the absolute revision. /// If needed converts last or relative number to the absolute revision.
bool makeRCSRevision(std::string const &version, std::string &revis) const; bool makeRCSRevision(std::string const &version, std::string &revis) const;
// GUI container for doVCCommandCall /// GUI container for doVCCommandCall
int doVCCommand(std::string const & cmd, support::FileName const & path, bool reportError = true); int doVCCommand(std::string const & cmd, support::FileName const & path, bool reportError = true);
/** /**
* doVCCommandCall - call out to the version control utility * doVCCommandCall - call out to the version control utility