#include <pp_Revision.h>
some text</> ^^^^^^^^^^^^^^
R1, etc., conform to the following syntax (items in square brackets are optional):
[+]n[{props}[{atrrs}]] -- addition with optional properties and attributes; props and attrs are formed as `name:value' -n -- deletion !n{props} -- formating change only
where n is a numerical id of the revision and props is regular property string, for instance
font-family:Times New Roman
revoval of property/attribute is indicated by setting to -/-, e.g.,
font-family:-/-
(the revision attribute parser in the class translates that into "")
The class provides methods for adding and removing individual revisions and evaluating how a particular revised fragment should be displayed in the document
| PP_RevisionAttr::PP_RevisionAttr | ( | ) | [inline] |
| PP_RevisionAttr::PP_RevisionAttr | ( | const gchar * | r | ) |
create class instance from an XML attribute string
References _init().
| PP_RevisionAttr::PP_RevisionAttr | ( | UT_uint32 | iId, | |
| PP_RevisionType | eType, | |||
| const gchar ** | pAttrs, | |||
| const gchar ** | pProps | |||
| ) |
create class instance from a single revision data
References UT_GenericVector< T >::addItem(), and m_vRev.
| PP_RevisionAttr::~PP_RevisionAttr | ( | ) |
References _clear().
| void PP_RevisionAttr::setRevision | ( | const gchar * | r | ) |
initialize instance with XML attribute string
References _clear(), and _init().
Referenced by pt_PieceTable::_translateRevisionAttribute().
| void PP_RevisionAttr::addRevision | ( | UT_uint32 | iId, | |
| PP_RevisionType | eType, | |||
| const gchar ** | pAttrs, | |||
| const gchar ** | pProps | |||
| ) |
adds id to the revision vector handling the special cases where id is already present in this attribute.
References UT_GenericVector< T >::addItem(), UT_GenericVector< T >::deleteNthItem(), gchar, PP_Revision::getId(), UT_GenericVector< T >::getItemCount(), UT_GenericVector< T >::getNthItem(), PP_Revision::getType(), m_bDirty, m_iSuperfluous, m_pLastRevision, m_vRev, PP_REVISION_ADDITION, PP_REVISION_ADDITION_AND_FMT, PP_REVISION_DELETION, PP_REVISION_FMT_CHANGE, PP_Revision::setAttributes(), and PP_AttrProp::setProperties().
Referenced by pt_PieceTable::_fixHdrFtrReferences(), pt_PieceTable::_translateRevisionAttribute(), pt_PieceTable::changeSpanFmt(), pt_PieceTable::changeStruxFmt(), and pt_PieceTable::deleteSpan().
| bool PP_RevisionAttr::changeRevisionType | ( | UT_uint32 | iId, | |
| PP_RevisionType | eType | |||
| ) |
changes the type of revision with id iId to eType; if revision with that id is not present, returns false
References PP_Revision::getId(), UT_GenericVector< T >::getItemCount(), UT_GenericVector< T >::getNthItem(), m_bDirty, m_vRev, and PP_Revision::setType().
| void PP_RevisionAttr::removeRevisionIdWithType | ( | UT_uint32 | iId, | |
| PP_RevisionType | eType | |||
| ) |
removes id from this revision, respecting the sign, i.e., it will not remove -5 if given 5
References UT_GenericVector< T >::deleteNthItem(), PP_Revision::getId(), UT_GenericVector< T >::getItemCount(), UT_GenericVector< T >::getNthItem(), PP_Revision::getType(), m_bDirty, m_pLastRevision, and m_vRev.
| void PP_RevisionAttr::removeRevisionIdTypeless | ( | UT_uint32 | iId | ) |
removes id from the attribute disregarding sign, i.e., if given 5 it will remove both -5 and +5
References UT_GenericVector< T >::deleteNthItem(), PP_Revision::getId(), UT_GenericVector< T >::getItemCount(), UT_GenericVector< T >::getNthItem(), m_bDirty, m_pLastRevision, and m_vRev.
| void PP_RevisionAttr::removeAllLesserOrEqualIds | ( | UT_uint32 | iId | ) |
removes all IDs from the attribute whose value is lesser or equal the given id
References UT_GenericVector< T >::deleteNthItem(), PP_Revision::getId(), UT_GenericVector< T >::getItemCount(), UT_GenericVector< T >::getNthItem(), m_bDirty, m_pLastRevision, and m_vRev.
| void PP_RevisionAttr::removeAllHigherOrEqualIds | ( | UT_uint32 | iId | ) |
removes all IDs from the attribute whose value is higher or equal the given id
References UT_GenericVector< T >::deleteNthItem(), UT_GenericVector< T >::getItemCount(), UT_GenericVector< T >::getNthItem(), m_bDirty, m_pLastRevision, and m_vRev.
Referenced by PD_Document::_acceptRejectRevision().
| void PP_RevisionAttr::removeRevision | ( | const PP_Revision * | pRev | ) |
removes pRev unconditionally from the attribute
References UT_GenericVector< T >::deleteNthItem(), UT_GenericVector< T >::getItemCount(), UT_GenericVector< T >::getNthItem(), m_bDirty, m_pLastRevision, and m_vRev.
| const PP_Revision * PP_RevisionAttr::getGreatestLesserOrEqualRevision | ( | UT_uint32 | id, | |
| const PP_Revision ** | ppR | |||
| ) |
References PP_Revision::getId(), UT_GenericVector< T >::getItemCount(), getLastRevision(), UT_GenericVector< T >::getNthItem(), PP_Revision::getType(), m_vRev, PP_REVISION_ADDITION, PP_REVISION_ADDITION_AND_FMT, PP_REVISION_DELETION, s_add, and s_del.
Referenced by PD_Document::acceptRejectRevision(), pt_PieceTable::deleteSpan(), getType(), hasProperty(), and isVisible().
| const PP_Revision * PP_RevisionAttr::getLowestGreaterOrEqualRevision | ( | UT_uint32 | id | ) |
References PP_Revision::getId(), UT_GenericVector< T >::getItemCount(), UT_GenericVector< T >::getNthItem(), m_vRev, and PD_MAX_REVISION.
Referenced by PD_Document::rejectAllHigherRevisions().
| const PP_Revision * PP_RevisionAttr::getLastRevision | ( | ) |
finds the highest revision number in this attribute
References PP_Revision::getId(), UT_GenericVector< T >::getItemCount(), UT_GenericVector< T >::getNthItem(), m_pLastRevision, and m_vRev.
Referenced by pt_PieceTable::_translateRevisionAttribute(), fp_Run::draw(), PD_Document::explodeRevisions(), fp_Run::getFGColor(), getGreatestLesserOrEqualRevision(), getType(), hasProperty(), fl_BlockLayout::isSentenceSeparator(), and fl_BlockLayout::isWordDelimiter().
| const PP_Revision * PP_RevisionAttr::getRevisionWithId | ( | UT_uint32 | iId, | |
| UT_uint32 & | minId | |||
| ) |
find revision with id == iId; if revision is not found minId contains the smallest id in this set greater than iId; if return value is and minId is PD_MAX_REVISION then there are revisions preset
References PP_Revision::getId(), UT_GenericVector< T >::getItemCount(), UT_GenericVector< T >::getNthItem(), m_vRev, and PD_MAX_REVISION.
Referenced by pt_PieceTable::_fixHdrFtrReferences(), and PD_Document::explodeRevisions().
| UT_uint32 PP_RevisionAttr::getRevisionsCount | ( | ) | const [inline] |
| const PP_Revision* PP_RevisionAttr::getNthRevision | ( | UT_uint32 | n | ) | const [inline] |
| void PP_RevisionAttr::pruneForCumulativeResult | ( | PD_Document * | pDoc | ) |
this function removes any revisions that no-longer contribute to the cumulative effect it is used in full-history mode when transfering attrs and props from the revision attribute into the main attrs and props
References UT_GenericVector< T >::deleteNthItem(), PP_AttrProp::explodeStyle(), gchar, PP_AttrProp::getAttribute(), PP_AttrProp::getAttributes(), UT_GenericVector< T >::getItemCount(), UT_GenericVector< T >::getNthItem(), PP_AttrProp::getProperties(), PP_Revision::getType(), m_vRev, PP_REVISION_DELETION, PP_AttrProp::prune(), PP_AttrProp::setAttribute(), PP_Revision::setAttributes(), PP_AttrProp::setProperties(), UT_ASSERT_HARMLESS, UT_return_if_fail, and v.
Referenced by pt_PieceTable::_translateRevisionAttribute(), and PD_Document::acceptAllRevisions().
| bool PP_RevisionAttr::isVisible | ( | UT_uint32 | id | ) |
please note that the following are convenience functions; if you need to make repeated enqueries, it is better to call getGreatestLesserOrEqualRevision() or getLastRevision() and querie the returned PP_Revision object.
given revision level id, this function returns true if given segment of text is to be visible, false if it is to be hidden
References getGreatestLesserOrEqualRevision(), PP_Revision::getType(), PP_REVISION_ADDITION, and PP_REVISION_ADDITION_AND_FMT.
Referenced by PD_Document::explodeRevisions().
| bool PP_RevisionAttr::hasProperty | ( | UT_uint32 | iId, | |
| const gchar * | pName, | |||
| const gchar *& | pValue | |||
| ) |
returns true if after revision iId this fragment carries revised property pName, the value of which will be stored in pValue; see notes on PP_Revision::hasProperty(...)
References getGreatestLesserOrEqualRevision(), PP_AttrProp::getProperty(), and s.
| bool PP_RevisionAttr::hasProperty | ( | const gchar * | pName, | |
| const gchar *& | pValue | |||
| ) |
returns true if after the last revision this fragment carries revised property pName, the value of which will be stored in pValue; see notes on PP_Revision::hasProperty(...)
References getLastRevision(), and PP_AttrProp::getProperty().
| PP_RevisionType PP_RevisionAttr::getType | ( | UT_uint32 | iId | ) |
returns the type of cumulative revision up to iId represented by this attribute
References getGreatestLesserOrEqualRevision(), PP_Revision::getType(), PP_REVISION_FMT_CHANGE, and s.
| PP_RevisionType PP_RevisionAttr::getType | ( | void | ) |
returns the type of overall cumulative revision represented by this attribute
References getLastRevision(), and PP_Revision::getType().
| const gchar * PP_RevisionAttr::getXMLstring | ( | ) |
get an gchar string representation of this revision
References _refreshString(), UT_String::c_str(), gchar, m_bDirty, and m_sXMLstring.
Referenced by PD_Document::_acceptRejectRevision(), pt_PieceTable::_fixHdrFtrReferences(), pt_PieceTable::_translateRevisionAttribute(), pt_PieceTable::changeSpanFmt(), pt_PieceTable::changeStruxFmt(), and pt_PieceTable::deleteSpan().
| void PP_RevisionAttr::forceDirty | ( | ) | [inline] |
Referenced by pt_PieceTable::_fixHdrFtrReferences().
| bool PP_RevisionAttr::isFragmentSuperfluous | ( | ) | const |
returns true if the fragment marked by this attribute is superfluous, i.e, it was created in the process of the present revision but the editor has later changed his/her mind and decided it should go away
References UT_GenericVector< T >::getItemCount(), UT_GenericVector< T >::getNthItem(), m_iSuperfluous, m_vRev, and UT_return_val_if_fail.
| bool PP_RevisionAttr::operator== | ( | const PP_RevisionAttr & | op2 | ) | const |
References UT_GenericVector< T >::getItemCount(), UT_GenericVector< T >::getNthItem(), and m_vRev.
| void PP_RevisionAttr::_init | ( | const gchar * | r | ) | [private] |
parse given XML attribute string and fill the instance with the data
References UT_GenericVector< T >::addItem(), FREEP, gchar, m_bDirty, m_iSuperfluous, m_pLastRevision, m_vRev, PP_REVISION_ADDITION, PP_REVISION_ADDITION_AND_FMT, PP_REVISION_DELETION, PP_REVISION_FMT_CHANGE, s, and UT_DEBUGMSG.
Referenced by PP_RevisionAttr(), and setRevision().
| void PP_RevisionAttr::_clear | ( | ) | [private] |
destroys all internal data
References UT_GenericVector< T >::clear(), UT_GenericVector< T >::getItemCount(), UT_GenericVector< T >::getNthItem(), m_bDirty, m_pLastRevision, and m_vRev.
Referenced by setRevision(), and ~PP_RevisionAttr().
| void PP_RevisionAttr::_refreshString | ( | ) | [private] |
create XML string from our vector
References UT_String::clear(), PP_Revision::getAttrsString(), PP_Revision::getId(), UT_GenericVector< T >::getItemCount(), UT_GenericVector< T >::getNthItem(), PP_Revision::getPropsString(), PP_Revision::getType(), PP_AttrProp::hasAttributes(), PP_AttrProp::hasProperties(), m_bDirty, m_sXMLstring, m_vRev, PP_REVISION_DELETION, and PP_REVISION_FMT_CHANGE.
Referenced by getXMLstring().
UT_Vector PP_RevisionAttr::m_vRev [private] |
Referenced by _clear(), _init(), _refreshString(), addRevision(), changeRevisionId(), changeRevisionType(), getGreatestLesserOrEqualRevision(), getLastRevision(), getLowestGreaterOrEqualRevision(), getRevisionWithId(), isFragmentSuperfluous(), operator==(), PP_RevisionAttr(), pruneForCumulativeResult(), removeAllHigherOrEqualIds(), removeAllLesserOrEqualIds(), removeRevision(), removeRevisionIdTypeless(), and removeRevisionIdWithType().
UT_String PP_RevisionAttr::m_sXMLstring [private] |
Referenced by _refreshString(), and getXMLstring().
bool PP_RevisionAttr::m_bDirty [private] |
UT_uint32 PP_RevisionAttr::m_iSuperfluous [private] |
Referenced by _init(), addRevision(), and isFragmentSuperfluous().
const PP_Revision* PP_RevisionAttr::m_pLastRevision [private] |
1.5.5