X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ian/git?p=topbloke-formulae.git;a=blobdiff_plain;f=notation.tex;h=19cf243733e1a9ba8edce18d7d7a70a8e0fb1097;hp=0db33f686daa2b29a0e186d1e12b67717cd875d8;hb=13a217e73c1ab13c7899dd2c1be7cbc909fed331;hpb=93847d78953ec63725065981dd9f2d439627990e diff --git a/notation.tex b/notation.tex index 0db33f6..19cf243 100644 --- a/notation.tex +++ b/notation.tex @@ -1,4 +1,7 @@ -\section{Notation} +\stdsection{Notation} + +Throughout, any free variables are implicitly universally quantified +at the outermost level. \begin{basedescript}{ \desclabelwidth{5em} @@ -28,16 +31,20 @@ are respectively the base and tip git branches. $\p$ may be used where the context requires a set, in which case the statement is to be taken as applying to both $\py$ and $\pn$. All of these sets will be disjoint by construction -(see Invariants, below). Hence: +(see Invariants, below). -\item[ $\set A$, $\set P$, $\ldots$ ] -Arbitrary sets of commits. Maybe $\set P = \p$ i.e.\ some $\py$ or $\pn$, but -maybe not. +\item[ $\foreign$ ] +The set of all commits which are not part of a Topbloke branch. We +call these foreign commits. Hence: \item[ $ \patchof{ C } $ ] -Either $\p$ s.t. $ C \in \p $, or $\bot$. +Either $\p$ s.t. $ C \in \p $, or $\foreign$. A function from commits to patches' sets $\p$. +\item[ $\set A$, $\set P$, $\ldots$ ] +Arbitrary sets of commits. Maybe $\set P = \p$ i.e.\ some $\py$ or $\pn$, but +maybe not. + \item[ $ \pancsof{C}{\set P} $ ] $ \{ A \; | \; A \le C \land A \in \set P \} $ i.e. all the ancestors of $C$ @@ -79,15 +86,41 @@ the relevant Topbloke branches, we hope that if the user still cares about the Topbloke patch, git's merge algorithm will DTRT when trying to re-apply the changes. -\item[ $\displaystyle \mergeof{C}{L}{M}{R} $ ] -The contents of a git merge result: +\item[ $\displaystyle \stmtmergeof{L}{M}{R} $ ] +The proper results of a merge. Formally, +where $L$, $M$ and $R$ are statements: +$$ + \stmtmergeof{L}{M}{R} + \equiv + \begin{cases} + (L \land R) : & \true \\ + (\neg L \land \neg R) : & \false \\ + \text{otherwise} : & \neg M + \end{cases} +$$ + +May also be used where $L$, $M$ and $R$ are sets, in which case +$$ + \setmergeof{L}{M}{R} + = + \left\{ + \; + D \; \middle| \; + \setmergeof{ D \in L }{ D \in M }{ D \in R } + \; + \right\} +$$ + +\item[ $\displaystyle \commitmergeof{C}{L}{M}{R} $ ] +$C$ has exactly the contents of a git merge result: $\displaystyle D \isin C \equiv \begin{cases} - (D \isin L \land D \isin R) \lor D = C : & \true \\ - (D \not\isin L \land D \not\isin R) \land D \neq C : & \false \\ - \text{otherwise} : & D \not\isin M + D = C : & \true \\ + D \neq C : & \stmtmergeof{ D \isin L }{ D \isin M }{ D \isin R } \end{cases} $ +We will refer to this as \commitmergename. + \end{basedescript}