Mercurial > evolve
changeset 1288:c3ecf6871872 stable
docs: format concepts guide better, with literal blocks
author | Greg Ward <greg@gerg.ca> |
---|---|
date | Thu, 23 Apr 2015 21:13:13 -0400 |
parents | 6f2c1574eda8 |
children | 12d5c9eaa86d |
files | docs/concepts.rst |
diffstat | 1 files changed, 7 insertions(+), 7 deletions(-) [+] |
line wrap: on
line diff
--- a/docs/concepts.rst Thu Apr 23 21:05:54 2015 -0400 +++ b/docs/concepts.rst Thu Apr 23 21:13:13 2015 -0400 @@ -24,7 +24,7 @@ isn't quite right yet, and the diagrams are missing for malformatted.) -This document follows standard set theory notation: +This document follows standard set theory notation:: x ∈ A: x is a member of A @@ -133,7 +133,7 @@ public phase; only mutable changesets are divergent). The collective term for unstable, bumped, and divergent changeset is -*troubled*: +*troubled*:: troubled = unstable ∪ bumped ∪ divergent @@ -155,7 +155,7 @@ changesets; these are bugs and will be fixed in due course.) All hidden changesets are obsolete, and all obsolete changesets are -part of your repository. Mathematically speaking: +part of your repository. Mathematically speaking:: repo ⊇ obsolete ⊇ hidden @@ -177,7 +177,7 @@ Why is this changeset visible? ------------------------------ -Any changeset which is not hidden is *visible*. That is, +Any changeset which is not hidden is *visible*. That is, :: visible = repo ∖ hidden @@ -185,7 +185,7 @@ changesets that are in *repo* but not in *hidden*.) After amending or pruning a changeset, you might expect it to be -hidden. It doesn't always work out that way. The precise rules are: +hidden. It doesn't always work out that way. The precise rules are:: hideable = obsolete blockers = bookmarks ∪ parents(workingcopy) ∪ localtags @@ -193,7 +193,7 @@ This will probably be clearer with a worked example. First, here's a repository with some obsolete changesets, some troubled changesets, -one bookmark, a working copy, and some hidden changesets: +one bookmark, a working copy, and some hidden changesets:: x-x / @@ -202,7 +202,7 @@ x-x-o Here's the computation required to determine which changesets are -hidden: +hidden:: repo = { 0, 1, 2, 3, 4, 5, 6, 7, 8 }