NOTE: This wiki is currently undergoing a review. This page will be reworked.
(For an alternate view, please have a look at ?this proposal)

For those participating, please have a look here.

monotone wiki

This is the wiki for the version control system monotone.

monotone is a free distributed version control system. It provides a simple, single-file transactional version store, with fully disconnected operation and an efficient peer-to-peer synchronization protocol. It understands history-sensitive merging, lightweight branches, integrated code review and 3rd party testing. It uses cryptographic version naming and client-side RSA certificates. It has good internationalization support, few external dependencies, and runs on unix, OSX, windows, and is licensed under the GNU GPL.

For Users

About Monotone

• Hosting
• ProjectsUsingMonotone
• EvaluationFeatures
• Testimonials
• Talks
• Users
• Developers

Getting Monotone

• Building
  • on Windows and VisualC8
  • on Mac
  • on Solaris
  • via pkgsrc on a wide variety of platforms
• MonotoneOnDebian
• MonotoneProjectServer

Using Monotone

• InterfacesFrontendsAndTools -- other programs that work with monotone
• EssentialMonotone -- the minimal commands needed to get anything done
• AlternativeOverview -- a different order than the Tutorial for introducing monotone capabilites
• BestPractices -- best practices for using monotone
• MasterRepository -- Master Repositories you might be used to with a centralised VCS, and why you don't need one with monotone.
• MonotoneAndCVS -- different ways of working with CVS and monotone.
• UsingCerts -- how certs work, and don't, in practice.
• TrustFoundations -- the basics of monotone's trust model, and how it works with certs
• BranchAnalogy -- understanding how monotone's branches work, and might be different to other tools.
• BranchNamingConventions and BranchRenaming -- discussions about how to name your branches and what to do when you change your mind.
• DaggyFixes -- handling bug fixes, backports, and cherry picking
• TipsTricksScripts -- useful snippets for getting more out of monotone
• TroubleShooting -- what to try when things aren't working
• RosterifyingPrivateBranches -- specific issues for those migrating private changes from monotone 0.25 and earlier to 0.26 and later.
• Glossary -- an explanation of some terms
• AutomateMagic -- some nifty things you can do with the automation interface
• WishList -- a list of features some people would like to have

For Developers of Monotone

• QuickieTasks -- This is a good starting point for new developers.
• AutomateWishlist
• TrustDiscussion
• NetsyncTodo
• RostersTodo
• MagicSelectors
• BranchStatuses
• BugSquashingParty
• AttrUseCases
• HistoryBlueSky
• TestHarnessIssues
• TestIntro
• BuildBot
• MergeViaWorkingDir
• DatabaseLocking
• CaseInsensitiveFilesystems
• FileSystemIssues
• Win32DeviceFiles
• RevertUI
• SymLinks
• IPv6
• BranchUI
• SurveyQuestions
• RootDirRenaming
• I18nL10n
• PerformanceWork
• AutoInodeprints
• DeltaStorageStrategies
• LineEndingMunging
• NonMergeConflicts
• DocTodo
• CarrotAndStick
• TimeStamps
• VersionedPolicy
• ThingsStatusShouldShow
• CherryPicking
• PieceCache
• SpeedySpeedySHA1
• CertCleanup
• RevisionNumbering (Heights)
• NotesOnTestingChangesetify
• WorkspaceConflicts
• DatabaseCompaction
• ConflictFixupPolicy
• ?KeystoreFiles
• LogUI
• SimplerIgnoreMechanism
• RoadMap
• AutomateVersions

Previous Activities

• Monotone Summit 2009 -- Cyberspace
• Monotone Summit 2008 -- Germany
• Monotone Summit 2007 -- Mountain View
• Summer of Code 2006

Interesting starting points:

• Formatting: quick access to wiki syntax