← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/help_topics/__init__.py

Prevent losing data when reconfiguring to lightweight checkout
        (abentley)

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/help_topics/__init__.py
605
605
differences.
606
606
"""
607
607
 
 
608
_branches_out_of_sync = """Branches out of sync
 
609
 
 
610
When reconfiguring a checkout, tree or branch into a lightweight checkout,
 
611
a local branch must be destroyed.  (For checkouts, this is the local branch
 
612
that serves primarily as a cache.)  If the branch-to-be-destroyed does not
 
613
have the same last revision as the new reference branch for the lightweight
 
614
checkout, data could be lost, so Bazaar refuses.
 
615
 
 
616
How you deal with this depends on *why* the branches are out of sync.
 
617
 
 
618
If you have a checkout and have done local commits, you can get back in sync
 
619
by running "bzr update" (and possibly "bzr commit").
 
620
 
 
621
If you have a branch and the remote branch is out-of-date, you can push
 
622
the local changes using "bzr push".  If the local branch is out of date, you
 
623
can do "bzr pull".  If both branches have had changes, you can merge, commit
 
624
and then push your changes.  If you decide that some of the changes aren't
 
625
useful, you can "push --overwrite" or "pull --overwrite" instead.
 
626
"""
 
627
 
608
628
 
609
629
# Register help topics
610
630
topic_registry.register("revisionspec", _help_on_revisionspec,
662
682
                        'Information on working trees', SECT_CONCEPT)
663
683
topic_registry.register('criss-cross', _criss_cross,
664
684
                        'Information on criss-cross merging', SECT_CONCEPT)
 
685
topic_registry.register('sync-for-reconfigure', _branches_out_of_sync,
 
686
                        'Information on criss-cross merging', SECT_CONCEPT)
665
687
 
666
688
 
667
689
class HelpTopicIndex(object):