← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/bzrdir.py

Merged bzr.dev into cmdline-parser.

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/bzrdir.py
1
 
# Copyright (C) 2005, 2006, 2007, 2008, 2009 Canonical Ltd
 
1
# Copyright (C) 2005-2010 Canonical Ltd
2
2
#
3
3
# This program is free software; you can redistribute it and/or modify
4
4
# it under the terms of the GNU General Public License as published by
3108
3108
 
3109
3109
    def __init__(self):
3110
3110
        BzrDirMetaFormat1.__init__(self)
 
3111
        # XXX: It's a bit ugly that the network name is here, because we'd
 
3112
        # like to believe that format objects are stateless or at least
 
3113
        # immutable,  However, we do at least avoid mutating the name after
 
3114
        # it's returned.  See <https://bugs.edge.launchpad.net/bzr/+bug/504102>
3111
3115
        self._network_name = None
3112
3116
 
 
3117
    def __repr__(self):
 
3118
        return "%s(_network_name=%r)" % (self.__class__.__name__,
 
3119
            self._network_name)
 
3120
 
3113
3121
    def get_format_description(self):
3114
3122
        if self._network_name:
3115
3123
            real_format = network_format_registry.get(self._network_name)
3252
3260
        args.append(self._serialize_NoneString(repo_format_name))
3253
3261
        args.append(self._serialize_NoneTrueFalse(make_working_trees))
3254
3262
        args.append(self._serialize_NoneTrueFalse(shared_repo))
3255
 
        if self._network_name is None:
3256
 
            self._network_name = \
 
3263
        request_network_name = self._network_name or \
3257
3264
            BzrDirFormat.get_default_format().network_name()
3258
3265
        try:
3259
3266
            response = client.call('BzrDirFormat.initialize_ex_1.16',
3260
 
                self.network_name(), path, *args)
 
3267
                request_network_name, path, *args)
3261
3268
        except errors.UnknownSmartMethod:
3262
3269
            client._medium._remember_remote_is_before((1,16))
3263
3270
            local_dir_format = BzrDirMetaFormat1()
3513
3520
                experimental_pairs.append((key, help))
3514
3521
            else:
3515
3522
                output += wrapped(key, help, info)
3516
 
        output += "\nSee ``bzr help formats`` for more about storage formats."
 
3523
        output += "\nSee :doc:`formats-help` for more about storage formats."
3517
3524
        other_output = ""
3518
3525
        if len(experimental_pairs) > 0:
3519
3526
            other_output += "Experimental formats are shown below.\n\n"
3532
3539
            other_output += \
3533
3540
                "\nNo deprecated formats are available.\n\n"
3534
3541
        other_output += \
3535
 
            "\nSee ``bzr help formats`` for more about storage formats."
 
3542
                "\nSee :doc:`formats-help` for more about storage formats."
3536
3543
 
3537
3544
        if topic == 'other-formats':
3538
3545
            return other_output
3707
3714
format_registry.register('weave', BzrDirFormat6,
3708
3715
    'Pre-0.8 format.  Slower than knit and does not'
3709
3716
    ' support checkouts or shared repositories.',
 
3717
    hidden=True,
3710
3718
    deprecated=True)
3711
3719
format_registry.register_metadir('metaweave',
3712
3720
    'bzrlib.repofmt.weaverepo.RepositoryFormat7',
3713
3721
    'Transitional format in 0.8.  Slower than knit.',
3714
3722
    branch_format='bzrlib.branch.BzrBranchFormat5',
3715
3723
    tree_format='bzrlib.workingtree.WorkingTreeFormat3',
 
3724
    hidden=True,
3716
3725
    deprecated=True)
3717
3726
format_registry.register_metadir('knit',
3718
3727
    'bzrlib.repofmt.knitrepo.RepositoryFormatKnit1',
3719
3728
    'Format using knits.  Recommended for interoperation with bzr <= 0.14.',
3720
3729
    branch_format='bzrlib.branch.BzrBranchFormat5',
3721
3730
    tree_format='bzrlib.workingtree.WorkingTreeFormat3',
 
3731
    hidden=True,
3722
3732
    deprecated=True)
3723
3733
format_registry.register_metadir('dirstate',
3724
3734
    'bzrlib.repofmt.knitrepo.RepositoryFormatKnit1',
3728
3738
    # this uses bzrlib.workingtree.WorkingTreeFormat4 because importing
3729
3739
    # directly from workingtree_4 triggers a circular import.
3730
3740
    tree_format='bzrlib.workingtree.WorkingTreeFormat4',
 
3741
    hidden=True,
3731
3742
    deprecated=True)
3732
3743
format_registry.register_metadir('dirstate-tags',
3733
3744
    'bzrlib.repofmt.knitrepo.RepositoryFormatKnit1',
3736
3747
        ' Incompatible with bzr < 0.15.',
3737
3748
    branch_format='bzrlib.branch.BzrBranchFormat6',
3738
3749
    tree_format='bzrlib.workingtree.WorkingTreeFormat4',
 
3750
    hidden=True,
3739
3751
    deprecated=True)
3740
3752
format_registry.register_metadir('rich-root',
3741
3753
    'bzrlib.repofmt.knitrepo.RepositoryFormatKnit4',
3743
3755
        ' bzr < 1.0.',
3744
3756
    branch_format='bzrlib.branch.BzrBranchFormat6',
3745
3757
    tree_format='bzrlib.workingtree.WorkingTreeFormat4',
 
3758
    hidden=True,
3746
3759
    deprecated=True)
3747
3760
format_registry.register_metadir('dirstate-with-subtree',
3748
3761
    'bzrlib.repofmt.knitrepo.RepositoryFormatKnit3',
3759
3772
    help='New in 0.92: Pack-based format with data compatible with '
3760
3773
        'dirstate-tags format repositories. Interoperates with '
3761
3774
        'bzr repositories before 0.92 but cannot be read by bzr < 0.92. '
3762
 
        'Previously called knitpack-experimental.  '
3763
 
        'For more information, see '
3764
 
        'http://doc.bazaar-vcs.org/latest/developers/packrepo.html.',
 
3775
        ,
3765
3776
    branch_format='bzrlib.branch.BzrBranchFormat6',
3766
3777
    tree_format='bzrlib.workingtree.WorkingTreeFormat4',
3767
3778
    )
3770
3781
    help='New in 0.92: Pack-based format with data compatible with '
3771
3782
        'dirstate-with-subtree format repositories. Interoperates with '
3772
3783
        'bzr repositories before 0.92 but cannot be read by bzr < 0.92. '
3773
 
        'Previously called knitpack-experimental.  '
3774
 
        'For more information, see '
3775
 
        'http://doc.bazaar-vcs.org/latest/developers/packrepo.html.',
 
3784
        ,
3776
3785
    branch_format='bzrlib.branch.BzrBranchFormat6',
3777
3786
    tree_format='bzrlib.workingtree.WorkingTreeFormat4',
3778
3787
    hidden=True,
3784
3793
         '(needed for bzr-svn and bzr-git).',
3785
3794
    branch_format='bzrlib.branch.BzrBranchFormat6',
3786
3795
    tree_format='bzrlib.workingtree.WorkingTreeFormat4',
 
3796
    hidden=True,
3787
3797
    )
3788
3798
format_registry.register_metadir('1.6',
3789
3799
    'bzrlib.repofmt.pack_repo.RepositoryFormatKnitPack5',
3792
3802
         'not present locally.',
3793
3803
    branch_format='bzrlib.branch.BzrBranchFormat7',
3794
3804
    tree_format='bzrlib.workingtree.WorkingTreeFormat4',
 
3805
    hidden=True,
3795
3806
    )
3796
3807
format_registry.register_metadir('1.6.1-rich-root',
3797
3808
    'bzrlib.repofmt.pack_repo.RepositoryFormatKnitPack5RichRoot',
3799
3810
         '(needed for bzr-svn and bzr-git).',
3800
3811
    branch_format='bzrlib.branch.BzrBranchFormat7',
3801
3812
    tree_format='bzrlib.workingtree.WorkingTreeFormat4',
 
3813
    hidden=True,
3802
3814
    )
3803
3815
format_registry.register_metadir('1.9',
3804
3816
    'bzrlib.repofmt.pack_repo.RepositoryFormatKnitPack6',
3807
3819
         'performance for most operations.',
3808
3820
    branch_format='bzrlib.branch.BzrBranchFormat7',
3809
3821
    tree_format='bzrlib.workingtree.WorkingTreeFormat4',
 
3822
    hidden=True,
3810
3823
    )
3811
3824
format_registry.register_metadir('1.9-rich-root',
3812
3825
    'bzrlib.repofmt.pack_repo.RepositoryFormatKnitPack6RichRoot',
3814
3827
         '(needed for bzr-svn and bzr-git).',
3815
3828
    branch_format='bzrlib.branch.BzrBranchFormat7',
3816
3829
    tree_format='bzrlib.workingtree.WorkingTreeFormat4',
 
3830
    hidden=True,
3817
3831
    )
3818
3832
format_registry.register_metadir('1.14',
3819
3833
    'bzrlib.repofmt.pack_repo.RepositoryFormatKnitPack6',
3835
3849
        'to and from rich-root-pack (and anything compatible with '
3836
3850
        'rich-root-pack) format repositories. Repositories and branches in '
3837
3851
        'this format can only be read by bzr.dev. Please read '
3838
 
        'http://doc.bazaar-vcs.org/latest/developers/development-repo.html '
 
3852
        'http://doc.bazaar.canonical.com/latest/developers/development-repo.html '
3839
3853
        'before use.',
3840
3854
    branch_format='bzrlib.branch.BzrBranchFormat7',
3841
3855
    tree_format='bzrlib.workingtree.WorkingTreeFormat6',
3842
3856
    experimental=True,
3843
3857
    alias=True,
 
3858
    hidden=True,
3844
3859
    )
3845
3860
format_registry.register_metadir('development-subtree',
3846
3861
    'bzrlib.repofmt.pack_repo.RepositoryFormatPackDevelopment2Subtree',
3848
3863
        'from pack-0.92-subtree (and anything compatible with '
3849
3864
        'pack-0.92-subtree) format repositories. Repositories and branches in '
3850
3865
        'this format can only be read by bzr.dev. Please read '
3851
 
        'http://doc.bazaar-vcs.org/latest/developers/development-repo.html '
 
3866
        'http://doc.bazaar.canonical.com/latest/developers/development-repo.html '
3852
3867
        'before use.',
3853
3868
    branch_format='bzrlib.branch.BzrBranchFormat7',
3854
3869
    tree_format='bzrlib.workingtree.WorkingTreeFormat6',
3855
3870
    experimental=True,
 
3871
    hidden=True,
3856
3872
    alias=False, # Restore to being an alias when an actual development subtree format is added
3857
3873
                 # This current non-alias status is simply because we did not introduce a
3858
3874
                 # chk based subtree format.
3863
3879
    'bzrlib.repofmt.groupcompress_repo.RepositoryFormatCHK1',
3864
3880
    help='pack-1.9 with 255-way hashed CHK inv, group compress, rich roots '
3865
3881
        'Please read '
3866
 
        'http://doc.bazaar-vcs.org/latest/developers/development-repo.html '
 
3882
        'http://doc.bazaar.canonical.com/latest/developers/development-repo.html '
3867
3883
        'before use.',
3868
3884
    branch_format='bzrlib.branch.BzrBranchFormat7',
3869
3885
    tree_format='bzrlib.workingtree.WorkingTreeFormat6',
3875
3891
    'bzrlib.repofmt.groupcompress_repo.RepositoryFormatCHK2',
3876
3892
    help='pack-1.9 with 255-way hashed CHK inv, bencode revision, group compress, '
3877
3893
        'rich roots. Please read '
3878
 
        'http://doc.bazaar-vcs.org/latest/developers/development-repo.html '
 
3894
        'http://doc.bazaar.canonical.com/latest/developers/development-repo.html '
3879
3895
        'before use.',
3880
3896
    branch_format='bzrlib.branch.BzrBranchFormat7',
3881
3897
    tree_format='bzrlib.workingtree.WorkingTreeFormat6',
3902
3918
    branch_format='bzrlib.branch.BzrBranchFormat7',
3903
3919
    tree_format='bzrlib.workingtree.WorkingTreeFormat6',
3904
3920
    alias=True,
 
3921
    hidden=True,
3905
3922
    help='Same as 2a.')
3906
3923
 
3907
3924
# The current format that is made on 'bzr init'.