Rev 3455: (mbp) developer documentation about reprs and packaging in file:///home/pqm/archives/thelove/bzr/%2Btrunk/
Canonical.com Patch Queue Manager
pqm at pqm.ubuntu.com
Thu May 29 07:36:04 BST 2008
At file:///home/pqm/archives/thelove/bzr/%2Btrunk/
------------------------------------------------------------
revno: 3455
revision-id:pqm at pqm.ubuntu.com-20080529063551-zfhfve9vxrk288fm
parent: pqm at pqm.ubuntu.com-20080529004957-2tz3cdbcogwn39df
parent: mbp at sourcefrog.net-20080529023843-j8kamupplvad3hq0
committer: Canonical.com Patch Queue Manager <pqm at pqm.ubuntu.com>
branch nick: +trunk
timestamp: Thu 2008-05-29 07:35:51 +0100
message:
(mbp) developer documentation about reprs and packaging
modified:
NEWS NEWS-20050323055033-4e00b5db738777ff
doc/developers/HACKING.txt HACKING-20050805200004-2a5dc975d870f78c
doc/developers/index.txt index.txt-20070508041241-qznziunkg0nffhiw-1
doc/developers/releasing.txt releasing.txt-20080502015919-fnrcav8fwy8ccibu-1
------------------------------------------------------------
revno: 3408.1.10
revision-id:mbp at sourcefrog.net-20080529023843-j8kamupplvad3hq0
parent: mbp at sourcefrog.net-20080527081420-zkj8onst7llsby4v
committer: Martin Pool <mbp at sourcefrog.net>
branch nick: doc
timestamp: Thu 2008-05-29 12:38:43 +1000
message:
Review feedback
modified:
NEWS NEWS-20050323055033-4e00b5db738777ff
doc/developers/HACKING.txt HACKING-20050805200004-2a5dc975d870f78c
------------------------------------------------------------
revno: 3408.1.9
revision-id:mbp at sourcefrog.net-20080527081420-zkj8onst7llsby4v
parent: mbp at sourcefrog.net-20080527081228-2ft0nnz7edsz1jfa
committer: Martin Pool <mbp at sourcefrog.net>
branch nick: doc
timestamp: Tue 2008-05-27 18:14:20 +1000
message:
Use new-style deprecated_in
modified:
doc/developers/HACKING.txt HACKING-20050805200004-2a5dc975d870f78c
------------------------------------------------------------
revno: 3408.1.8
revision-id:mbp at sourcefrog.net-20080527081228-2ft0nnz7edsz1jfa
parent: mbp at sourcefrog.net-20080527080956-38zfzrblgkx2xrak
parent: pqm at pqm.ubuntu.com-20080527013230-8qjaju10duxpy3e2
committer: Martin Pool <mbp at sourcefrog.net>
branch nick: doc
timestamp: Tue 2008-05-27 18:12:28 +1000
message:
merge trunk
added:
bzrlib/smart/message.py message.py-20080222013625-ncqmh3nrxjkxab87-1
bzrlib/tests/file_utils.py file_utils.py-20080506145406-a1h3ydg2lsh2iriy-1
bzrlib/tests/repository_implementations/test_get_parent_map.py test_get_parent_map.-20080421172708-x1z6ot341osr0jq1-1
doc/developers/repository-stream.txt repositorystream.txt-20080410222511-nh6b9bvscvcerh48-1
doc/en/user-guide/bzrtools_plugin.txt bzrtools_plugin.txt-20080509065016-cjc90f46407vi9a0-1
doc/en/user-guide/svn_plugin.txt svn_plugin.txt-20080509065016-cjc90f46407vi9a0-2
doc/en/user-guide/web_browsing.txt web_browsing.txt-20080509065016-cjc90f46407vi9a0-3
doc/es/ es-20080504181154-x2fm3oprvjohiz7n-1
doc/es/guia-desarrollador/ guiadesarrollador-20080504181514-qlh50dq1mj769bic-1
doc/es/guia-usuario/ guiausuario-20080504181514-qlh50dq1mj769bic-2
doc/es/guia-usuario/index.txt index.txt-20080512005856-hgdxkh9xo58n7zdp-2
doc/es/guia-usuario/resolving_conflicts.txt conflicts.txt-20080504181626-aqnzjwfhpju5ypfe-1
doc/es/guia-usuario/version_info.txt version_info.txt-20080504181730-u24nugzokrcrk1bf-1
doc/es/mini-tutorial/ minitutorial-20080504181514-qlh50dq1mj769bic-3
doc/es/mini-tutorial/index.txt index.txt-20080504182136-wmoc35u2t6kom8ca-1
doc/es/notas-version/ notasversion-20080504181514-qlh50dq1mj769bic-4
doc/es/referencia/ referencia-20080504181514-qlh50dq1mj769bic-5
doc/es/referencia-rapida/ referenciarapida-20080504181514-qlh50dq1mj769bic-6
doc/es/referencia-rapida/Makefile makefile-20080506002609-y60mr4avuqwzlf4s-1
doc/es/referencia-rapida/referencia-rapida.svg referenciarapida.svg-20080506002609-y60mr4avuqwzlf4s-2
doc/index.es.txt index.es.txt-20080506002113-aunzdhptcoc0h6hm-1
renamed:
doc/en/user-guide/best_practice_intro.txt => doc/en/user-guide/part2_intro.txt best_practice_intro.-20071123154453-dk2mjhrg1vpjm5w2-1
modified:
Makefile Makefile-20050805140406-d96e3498bb61c5bb
NEWS NEWS-20050323055033-4e00b5db738777ff
bzr bzr.py-20050313053754-5485f144c7006fa6
bzrlib/__init__.py __init__.py-20050309040759-33e65acf91bbcd5d
bzrlib/_dirstate_helpers_py.py _dirstate_helpers_py-20070710145033-90nz6cqglsk150jy-1
bzrlib/_patiencediff_py.py cdvdifflib.py-20051106064558-f8f8097fbf0db4e4
bzrlib/add.py add.py-20050323030017-3a77d63feda58e33
bzrlib/annotate.py annotate.py-20050922133147-7c60541d2614f022
bzrlib/atomicfile.py atomicfile.py-20050509044450-dbd24e6c564f7c66
bzrlib/benchmarks/bench_bundle.py bench_bundle.py-20060719055338-o1c6ieybbwt6c3zv-1
bzrlib/benchmarks/tree_creator/kernel_like.py kernel_like.py-20060815024128-b16a7pn542u6b13k-1
bzrlib/branch.py branch.py-20050309040759-e4baf4e0d046576e
bzrlib/builtins.py builtins.py-20050830033751-fc01482b9ca23183
bzrlib/bundle/bundle_data.py read_changeset.py-20050619171944-c0d95aa685537640
bzrlib/bundle/serializer/v08.py v06.py-20051119041339-ee43f97270b01823
bzrlib/bundle/serializer/v4.py v10.py-20070611062757-5ggj7k18s9dej0fr-1
bzrlib/bzrdir.py bzrdir.py-20060131065624-156dfea39c4387cb
bzrlib/commands.py bzr.py-20050309040720-d10f4714595cf8c3
bzrlib/commit.py commit.py-20050511101309-79ec1a0168e0e825
bzrlib/config.py config.py-20051011043216-070c74f4e9e338e8
bzrlib/counted_lock.py counted_lock.py-20070502135927-7dk86io3ok7ctx6k-1
bzrlib/debug.py debug.py-20061102062349-vdhrw9qdpck8cl35-1
bzrlib/delta.py delta.py-20050729221636-54cf14ef94783d0a
bzrlib/deprecated_graph.py graph.py-20050905070950-b47dce53236c5e48
bzrlib/diff.py diff.py-20050309040759-26944fbbf2ebbf36
bzrlib/dirstate.py dirstate.py-20060728012006-d6mvoihjb3je9peu-1
bzrlib/doc/__init__.py __init__.py-20051224020731-eb3eb3ef5b4570df
bzrlib/doc/api/__init__.py __init__.py-20051224020744-7b87d590843855bc
bzrlib/errors.py errors.py-20050309040759-20512168c4e14fbd
bzrlib/fetch.py fetch.py-20050818234941-26fea6105696365d
bzrlib/graph.py graph_walker.py-20070525030359-y852guab65d4wtn0-1
bzrlib/hashcache.py hashcache.py-20050706091756-fe3a8cc1143ff24f
bzrlib/help.py help.py-20050505025907-4dd7a6d63912f894
bzrlib/help_topics/__init__.py help_topics.py-20060920210027-rnim90q9e0bwxvy4-1
bzrlib/help_topics/en/authentication.txt authentication_conf.-20071104135035-glfv0ri355tyg1nf-1
bzrlib/help_topics/en/hooks.txt hooks.txt-20070830033044-xxu2rced13f72dka-1
bzrlib/index.py index.py-20070712131115-lolkarso50vjr64s-1
bzrlib/info.py info.py-20050323235939-6bbfe7d9700b0b9b
bzrlib/intset.py intset.py-20050717175247-81cd658f9aaa2731
bzrlib/inventory.py inventory.py-20050309040759-6648b84ca2005b37
bzrlib/knit.py knit.py-20051212171256-f056ac8f0fbe1bd9
bzrlib/lazy_import.py lazy_import.py-20060910203832-f77c54gf3n232za0-1
bzrlib/lazy_regex.py lazy_regex.py-20061009091222-fyettq6z5qomdl9e-1
bzrlib/lock.py lock.py-20050527050856-ec090bb51bc03349
bzrlib/lockable_files.py control_files.py-20051111201905-bb88546e799d669f
bzrlib/lockdir.py lockdir.py-20060220222025-98258adf27fbdda3
bzrlib/log.py log.py-20050505065812-c40ce11702fe5fb1
bzrlib/lru_cache.py lru_cache.py-20070119165515-tlw203kuwh0id5gv-1
bzrlib/merge.py merge.py-20050513021216-953b65a438527106
bzrlib/merge3.py merge3.py-20050704130834-bf0597094828a2e1
bzrlib/merge_directive.py merge_directive.py-20070228184838-ja62280spt1g7f4x-1
bzrlib/missing.py missing.py-20050812153334-097f7097e2a8bcd1
bzrlib/multiparent.py __init__.py-20070410133617-n1jdhcc1n1mibarp-1
bzrlib/mutabletree.py mutabletree.py-20060906023413-4wlkalbdpsxi2r4y-2
bzrlib/option.py option.py-20051014052914-661fb36e76e7362f
bzrlib/osutils.py osutils.py-20050309040759-eeaff12fbf77ac86
bzrlib/patches.py patches.py-20050727183609-378c1cc5972ce908
bzrlib/plugin.py plugin.py-20050622060424-829b654519533d69
bzrlib/plugins/launchpad/lp_registration.py lp_registration.py-20060315190948-daa617eafe3a8d48
bzrlib/plugins/launchpad/test_register.py test_register.py-20060315182712-40f5dda945c829a8
bzrlib/progress.py progress.py-20050610070202-df9faaab791964c0
bzrlib/reconcile.py reweave_inventory.py-20051108164726-1e5e0934febac06e
bzrlib/remote.py remote.py-20060720103555-yeeg2x51vn0rbtdp-1
bzrlib/repofmt/knitrepo.py knitrepo.py-20070206081537-pyy4a00xdas0j4pf-1
bzrlib/repofmt/pack_repo.py pack_repo.py-20070813041115-gjv5ma7ktfqwsjgn-1
bzrlib/repofmt/weaverepo.py presplitout.py-20070125045333-wfav3tsh73oxu3zk-1
bzrlib/repository.py rev_storage.py-20051111201905-119e9401e46257e3
bzrlib/revision.py revision.py-20050309040759-e77802c08f3999d5
bzrlib/revisionspec.py revisionspec.py-20050907152633-17567659fd5c0ddb
bzrlib/revisiontree.py revisiontree.py-20060724012533-bg8xyryhxd0o0i0h-1
bzrlib/rio.py rio.py-20051128032247-770b120b34dfff60
bzrlib/smart/branch.py branch.py-20061124031907-mzh3pla28r83r97f-1
bzrlib/smart/client.py client.py-20061116014825-2k6ada6xgulslami-1
bzrlib/smart/medium.py medium.py-20061103051856-rgu2huy59fkz902q-1
bzrlib/smart/protocol.py protocol.py-20061108035435-ot0lstk2590yqhzr-1
bzrlib/smart/repository.py repository.py-20061128022038-vr5wy5bubyb8xttk-1
bzrlib/smart/request.py request.py-20061108095550-gunadhxmzkdjfeek-1
bzrlib/smart/server.py server.py-20061110062051-chzu10y32vx8gvur-1
bzrlib/store/__init__.py store.py-20050309040759-164dc5173d6406c2
bzrlib/store/revision/knit.py knit.py-20060303020652-de5fa299e941a3c7
bzrlib/store/revision/text.py text.py-20060303020652-e49155f0da4d14ab
bzrlib/store/versioned/__init__.py weavestore.py-20050907094258-88262e0434babab9
bzrlib/symbol_versioning.py symbol_versioning.py-20060105104851-9ecf8af605d15a80
bzrlib/testament.py testament.py-20051011100429-6d319a18183b13c8
bzrlib/tests/__init__.py selftest.py-20050531073622-8d0e3c8845c97a64
bzrlib/tests/blackbox/__init__.py __init__.py-20051128053524-eba30d8255e08dc3
bzrlib/tests/blackbox/test_branch.py test_branch.py-20060524161337-noms9gmcwqqrfi8y-1
bzrlib/tests/blackbox/test_ls.py test_ls.py-20060712232047-0jraqpecwngee12y-1
bzrlib/tests/blackbox/test_missing.py test_missing.py-20051211212735-a2cf4c1840bb84c4
bzrlib/tests/blackbox/test_selftest.py test_selftest.py-20060123024542-01c5f1bbcb596d78
bzrlib/tests/blackbox/test_serve.py test_serve.py-20060913064329-8t2pvmsikl4s3xhl-1
bzrlib/tests/branch_implementations/__init__.py __init__.py-20060123013057-b12a52c3f361daf4
bzrlib/tests/branch_implementations/test_branch.py testbranch.py-20050711070244-121d632bc37d7253
bzrlib/tests/branch_implementations/test_permissions.py test_permissions.py-20060210110243-245c01403bf0fde6
bzrlib/tests/branch_implementations/test_push.py test_push.py-20070130153159-fhfap8uoifevg30j-1
bzrlib/tests/bzrdir_implementations/__init__.py __init__.py-20060131065642-34c39b54f42dd048
bzrlib/tests/commands/__init__.py __init__.py-20070520095518-ecfl8531fxgjeycj-1
bzrlib/tests/ftp_server.py ftpserver.py-20071019102346-61jbvdkrr70igauv-1
bzrlib/tests/http_server.py httpserver.py-20061012142527-m1yxdj1xazsf8d7s-1
bzrlib/tests/http_utils.py HTTPTestUtil.py-20050914180604-247d3aafb7a43343
bzrlib/tests/interrepository_implementations/__init__.py __init__.py-20060220054744-baf49a1f88f17b1a
bzrlib/tests/interrepository_implementations/test_fetch.py test_fetch.py-20080425213627-j60cjh782ufm83ry-1
bzrlib/tests/interrepository_implementations/test_interrepository.py test_interrepository.py-20060220061411-1ec13fa99e5e3eee
bzrlib/tests/intertree_implementations/__init__.py __init__.py-20060724101752-09ysswo1a92uqyoz-3
bzrlib/tests/interversionedfile_implementations/__init__.py __init__.py-20060302012326-981af525594d02ed
bzrlib/tests/interversionedfile_implementations/test_join.py test_join.py-20060302012326-9b5e9b0f0a03fedc
bzrlib/tests/inventory_implementations/__init__.py __init__.py-20070821044532-olbadbokgv3qv1yd-1
bzrlib/tests/per_lock/__init__.py __init__.py-20070314201444-u92yjsqrkh2m3qcb-1
bzrlib/tests/repository_implementations/__init__.py __init__.py-20060131092037-9564957a7d4a841b
bzrlib/tests/repository_implementations/test_has_same_location.py test_has_same_locati-20070807074648-2i2ah82fbe83iys7-1
bzrlib/tests/repository_implementations/test_repository.py test_repository.py-20060131092128-ad07f494f5c9d26c
bzrlib/tests/repository_implementations/test_revision.py testrevprops.py-20051013073044-92bc3c68302ce1bf
bzrlib/tests/revisionstore_implementations/__init__.py __init__.py-20060303020702-976c4186a0f99edb
bzrlib/tests/stub_sftp.py stub_sftp.py-20051027032739-0e7ef4f7bab0e174
bzrlib/tests/test_ancestry.py test_ancestry.py-20050913023709-69768e94848312c6
bzrlib/tests/test_bundle.py test.py-20050630184834-092aa401ab9f039c
bzrlib/tests/test_bzrdir.py test_bzrdir.py-20060131065654-deba40eef51cf220
bzrlib/tests/test_commit.py test_commit.py-20050914060732-279f057f8c295434
bzrlib/tests/test_config.py testconfig.py-20051011041908-742d0c15d8d8c8eb
bzrlib/tests/test_conflicts.py test_conflicts.py-20051006031059-e2dad9bbeaa5891f
bzrlib/tests/test_dirstate.py test_dirstate.py-20060728012006-d6mvoihjb3je9peu-2
bzrlib/tests/test_errors.py test_errors.py-20060210110251-41aba2deddf936a8
bzrlib/tests/test_fetch.py testfetch.py-20050825090644-f73e07e7dfb1765a
bzrlib/tests/test_graph.py test_graph_walker.py-20070525030405-enq4r60hhi9xrujc-1
bzrlib/tests/test_http.py testhttp.py-20051018020158-b2eef6e867c514d9
bzrlib/tests/test_http_response.py test_http_response.py-20060628233143-950b2a482a32505d
bzrlib/tests/test_knit.py test_knit.py-20051212171302-95d4c00dd5f11f2b
bzrlib/tests/test_lockable_files.py test_lockable_files.py-20051225183927-365c7fd99591caf1
bzrlib/tests/test_merge_core.py test_merge_core.py-20050824132511-eb99b23a0eec641b
bzrlib/tests/test_merge_directive.py test_merge_directive-20070228184838-ja62280spt1g7f4x-2
bzrlib/tests/test_missing.py test_missing.py-20051212000028-694fa4f658a81f48
bzrlib/tests/test_osutils.py test_osutils.py-20051201224856-e48ee24c12182989
bzrlib/tests/test_osutils_encodings.py test_osutils_encodin-20061226013130-kkp732tpt3lm91vv-1
bzrlib/tests/test_patches.py test_patches.py-20051231203844-f4974d20f6aea09c
bzrlib/tests/test_permissions.py test_permissions.py-20051215004520-ccf475789c80e80c
bzrlib/tests/test_plugins.py plugins.py-20050622075746-32002b55e5e943e9
bzrlib/tests/test_read_bundle.py test_read_bundle.py-20060615211421-ud8cwr1ulgd914zf-1
bzrlib/tests/test_registry.py test_lazy_factory.py-20060809213415-2gfvqadtvdn0phtg-2
bzrlib/tests/test_remote.py test_remote.py-20060720103555-yeeg2x51vn0rbtdp-2
bzrlib/tests/test_repository.py test_repository.py-20060131075918-65c555b881612f4d
bzrlib/tests/test_revision.py testrevision.py-20050804210559-46f5e1eb67b01289
bzrlib/tests/test_revisiontree.py test_revisiontree.py-20060615095324-aij44ndxbv1h4c9f-1
bzrlib/tests/test_selftest.py test_selftest.py-20051202044319-c110a115d8c0456a
bzrlib/tests/test_smart.py test_smart.py-20061122024551-ol0l0o0oofsu9b3t-2
bzrlib/tests/test_smart_transport.py test_ssh_transport.py-20060608202016-c25gvf1ob7ypbus6-2
bzrlib/tests/test_source.py test_source.py-20051207061333-a58dea6abecc030d
bzrlib/tests/test_strace.py test_strace.py-20070323001526-6zquhhw8leb9m6j8-2
bzrlib/tests/test_subsume.py test_subsume.py-20060927040024-tsvh4pchajoayymg-1
bzrlib/tests/test_transform.py test_transaction.py-20060105172520-b3ffb3946550e6c4
bzrlib/tests/test_transport_implementations.py test_transport_implementations.py-20051227111451-f97c5c7d5c49fce7
bzrlib/tests/test_upgrade.py test_upgrade.py-20051004040251-555fe1d2bae1bc71
bzrlib/tests/test_version_info.py test_version_info.py-20051228204928-2c364e30b702b41b
bzrlib/tests/test_versionedfile.py test_versionedfile.py-20060222045249-db45c9ed14a1c2e5
bzrlib/tests/test_weave.py testknit.py-20050627023648-9833cc5562ffb785
bzrlib/tests/test_workingtree.py testworkingtree.py-20051004024258-b88d0fe8f101d468
bzrlib/tests/transport_util.py transportutil.py-20070525113600-5v2igk89s8fensom-1
bzrlib/tests/tree_implementations/__init__.py __init__.py-20060717075546-420s7b0bj9hzeowi-2
bzrlib/tests/tree_implementations/test_inv.py test_inv.py-20070312023226-0cdvk5uwhutis9vg-1
bzrlib/tests/treeshape.py treeshape.py-20051004094628-312a98f0194306a8
bzrlib/tests/workingtree_implementations/__init__.py __init__.py-20060203003124-b2aa5aca21a8bfad
bzrlib/tests/workingtree_implementations/test_add_reference.py test_add_reference.p-20061211024451-yo9i1691dgbv1eyn-1
bzrlib/tests/workingtree_implementations/test_basis_inventory.py test_basis_inventory.py-20051218151655-3650468941091309
bzrlib/tests/workingtree_implementations/test_parents.py test_set_parents.py-20060807231740-yicmnlci1mj8smu1-1
bzrlib/tests/workingtree_implementations/test_set_root_id.py test_set_root_id.py-20061004073850-0r1c7qikmnkb8m9k-1
bzrlib/tests/workingtree_implementations/test_walkdirs.py test_walkdirs.py-20060731045042-ch366w6dve2m7ro9-1
bzrlib/tests/workingtree_implementations/test_workingtree.py test_workingtree.py-20060203003124-817757d3e31444fb
bzrlib/textinv.py textinv.py-20050411024435-e3898231b7d1897b26c38878
bzrlib/textui.py textui.py-20050309040759-5d0cebe09c528e7d
bzrlib/timestamp.py timestamp.py-20070306142322-ttbb9oulf3jotljd-1
bzrlib/trace.py trace.py-20050309040759-c8ed824bdcd4748a
bzrlib/transactions.py transactions.py-20051007010900-f1313d53cf58e223
bzrlib/transform.py transform.py-20060105172343-dd99e54394d91687
bzrlib/transport/__init__.py transport.py-20050711165921-4978aa7ce1285ad5
bzrlib/transport/chroot.py chroot.py-20061011104729-0us9mgm97z378vnt-1
bzrlib/transport/decorator.py decorator.py-20060402223305-e913a0f25319ab42
bzrlib/transport/fakenfs.py fakenfs.py-20060402223312-0e29c7275aa384dd
bzrlib/transport/ftp.py ftp.py-20051116161804-58dc9506548c2a53
bzrlib/transport/http/__init__.py http_transport.py-20050711212304-506c5fd1059ace96
bzrlib/transport/http/_pycurl.py pycurlhttp.py-20060110060940-4e2a705911af77a6
bzrlib/transport/http/_urllib.py _urlgrabber.py-20060113083826-0bbf7d992fbf090c
bzrlib/transport/http/_urllib2_wrappers.py _urllib2_wrappers.py-20060913231729-ha9ugi48ktx481ao-1
bzrlib/transport/http/response.py _response.py-20060613154423-a2ci7hd4iw5c7fnt-1
bzrlib/transport/http/wsgi.py wsgi.py-20061005091552-rz8pva0olkxv0sd8-2
bzrlib/transport/local.py local_transport.py-20050711165921-9b1f142bfe480c24
bzrlib/transport/memory.py memory.py-20051016101338-cd008dbdf69f04fc
bzrlib/transport/remote.py ssh.py-20060608202016-c25gvf1ob7ypbus6-1
bzrlib/transport/sftp.py sftp.py-20051019050329-ab48ce71b7e32dfe
bzrlib/transport/ssh.py ssh.py-20060824042150-0s9787kng6zv1nwq-1
bzrlib/tree.py tree.py-20050309040759-9d5f2496be663e77
bzrlib/treebuilder.py treebuilder.py-20060907214856-4omn6hf1u7fvrart-1
bzrlib/tuned_gzip.py tuned_gzip.py-20060407014720-5aadc518e928e8d2
bzrlib/urlutils.py urlutils.py-20060502195429-e8a161ecf8fac004
bzrlib/version_info_formats/__init__.py generate_version_info.py-20051228204928-8358edabcddcd97e
bzrlib/versionedfile.py versionedfile.py-20060222045106-5039c71ee3b65490
bzrlib/weave.py knit.py-20050627021749-759c29984154256b
bzrlib/weavefile.py weavefile.py-20050629135233-2ffe0200f103f6c2
bzrlib/workingtree.py workingtree.py-20050511021032-29b6ec0a681e02e3
bzrlib/workingtree_4.py workingtree_4.py-20070208044105-5fgpc5j3ljlh5q6c-1
bzrlib/xml4.py xml4.py-20050916091259-db5ab55e7e6ca324
bzrlib/xml5.py xml5.py-20080328030717-t9guwinq8hom0ar3-1
bzrlib/xml8.py xml5.py-20050907032657-aac8f960815b66b1
doc/developers/HACKING.txt HACKING-20050805200004-2a5dc975d870f78c
doc/developers/authentication-ring.txt authring.txt-20070718200437-q5tdik0ne6lor86d-1
doc/developers/index.txt index.txt-20070508041241-qznziunkg0nffhiw-1
doc/developers/network-protocol.txt networkprotocol.txt-20070903044232-woustorrjbmg5zol-1
doc/developers/tortoise-strategy.txt tortoisestrategy.txt-20080403024510-2ahdqrvnwqrb5p5t-1
doc/en/user-guide/bug_trackers.txt bug_trackers.txt-20070713223459-khxdlcudraii95uv-1
doc/en/user-guide/configuring_bazaar.txt configuring_bazaar.t-20071128000722-ncxiua259xwbdbg7-1
doc/en/user-guide/distributed_intro.txt distributed_intro.tx-20071123154453-dk2mjhrg1vpjm5w2-2
doc/en/user-guide/hooks.txt hooks.txt-20070829200551-7nr6e5a1io6x78uf-1
doc/en/user-guide/index.txt index.txt-20060622101119-tgwtdci8z769bjb9-2
doc/en/user-guide/introducing_bazaar.txt introducing_bazaar.t-20071114035000-q36a9h57ps06uvnl-5
doc/index.txt index.txt-20070813101924-07gd9i9d2jt124bf-1
doc/en/user-guide/part2_intro.txt best_practice_intro.-20071123154453-dk2mjhrg1vpjm5w2-1
------------------------------------------------------------
revno: 3408.1.7
revision-id:mbp at sourcefrog.net-20080527080956-38zfzrblgkx2xrak
parent: mbp at sourcefrog.net-20080527080932-2na1essjfo1fzvsr
committer: Martin Pool <mbp at sourcefrog.net>
branch nick: doc
timestamp: Tue 2008-05-27 18:09:56 +1000
message:
Move coding standards to be a top-level section in the developer guide
modified:
doc/developers/HACKING.txt HACKING-20050805200004-2a5dc975d870f78c
------------------------------------------------------------
revno: 3408.1.6
revision-id:mbp at sourcefrog.net-20080527080932-2na1essjfo1fzvsr
parent: mbp at sourcefrog.net-20080527072952-cs394am6uh0ik2kv
committer: Martin Pool <mbp at sourcefrog.net>
branch nick: doc
timestamp: Tue 2008-05-27 18:09:32 +1000
message:
Fix link to developer guide
modified:
doc/developers/index.txt index.txt-20070508041241-qznziunkg0nffhiw-1
------------------------------------------------------------
revno: 3408.1.5
revision-id:mbp at sourcefrog.net-20080527072952-cs394am6uh0ik2kv
parent: mbp at sourcefrog.net-20080521065656-flffn94nrnj3j685
committer: Martin Pool <mbp at sourcefrog.net>
branch nick: doc
timestamp: Tue 2008-05-27 17:29:52 +1000
message:
Coding standard: repr methods
modified:
doc/developers/HACKING.txt HACKING-20050805200004-2a5dc975d870f78c
------------------------------------------------------------
revno: 3408.1.4
revision-id:mbp at sourcefrog.net-20080521065656-flffn94nrnj3j685
parent: mbp at sourcefrog.net-20080520043027-e53woy109sh3by43
committer: Martin Pool <mbp at sourcefrog.net>
branch nick: doc
timestamp: Wed 2008-05-21 16:56:56 +1000
message:
Merge beuno's PPA release process docs
modified:
doc/developers/releasing.txt releasing.txt-20080502015919-fnrcav8fwy8ccibu-1
------------------------------------------------------------
revno: 3408.1.3
revision-id:mbp at sourcefrog.net-20080520043027-e53woy109sh3by43
parent: mbp at sourcefrog.net-20080519222117-9kgspc7m6nljouj9
committer: Martin Pool <mbp at sourcefrog.net>
branch nick: doc
timestamp: Tue 2008-05-20 14:30:27 +1000
message:
More release process updates
modified:
doc/developers/releasing.txt releasing.txt-20080502015919-fnrcav8fwy8ccibu-1
------------------------------------------------------------
revno: 3408.1.2
revision-id:mbp at sourcefrog.net-20080519222117-9kgspc7m6nljouj9
parent: mbp at sourcefrog.net-20080507044610-thcasb9ic2ay2yup
committer: Martin Pool <mbp at sourcefrog.net>
branch nick: doc
timestamp: Tue 2008-05-20 08:21:17 +1000
message:
Use debuild -D to get nicer errors for missing dependencies
modified:
doc/developers/releasing.txt releasing.txt-20080502015919-fnrcav8fwy8ccibu-1
=== modified file 'NEWS'
--- a/NEWS 2008-05-27 01:05:57 +0000
+++ b/NEWS 2008-05-29 02:38:43 +0000
@@ -90,6 +90,10 @@
on the plugin and integration chapters of the User Guide.
(Ian Clatworthy)
+ * More Bazaar developer documentation about packaging and release process,
+ and about use of Python reprs.
+ (Martin Pool, Martin Albisetti)
+
* Updated Tortise strategy document. (Mark Hammond)
TESTING:
=== modified file 'doc/developers/HACKING.txt'
--- a/doc/developers/HACKING.txt 2008-05-09 06:46:17 +0000
+++ b/doc/developers/HACKING.txt 2008-05-29 02:38:43 +0000
@@ -650,62 +650,11 @@
the form of URL components.
-Core Topics
-###########
-
-Evolving Interfaces
-===================
-
-We have a commitment to 6 months API stability - any supported symbol in a
-release of bzr MUST NOT be altered in any way that would result in
-breaking existing code that uses it. That means that method names,
-parameter ordering, parameter names, variable and attribute names etc must
-not be changed without leaving a 'deprecated forwarder' behind. This even
-applies to modules and classes.
-
-If you wish to change the behaviour of a supported API in an incompatible
-way, you need to change its name as well. For instance, if I add an optional keyword
-parameter to branch.commit - that's fine. On the other hand, if I add a
-keyword parameter to branch.commit which is a *required* transaction
-object, I should rename the API - i.e. to 'branch.commit_transaction'.
-
-When renaming such supported API's, be sure to leave a deprecated_method (or
-_function or ...) behind which forwards to the new API. See the
-bzrlib.symbol_versioning module for decorators that take care of the
-details for you - such as updating the docstring, and issuing a warning
-when the old api is used.
-
-For unsupported API's, it does not hurt to follow this discipline, but it's
-not required. Minimally though, please try to rename things so that
-callers will at least get an AttributeError rather than weird results.
-
-
-Deprecation decorators
-----------------------
-
-``bzrlib.symbol_versioning`` provides decorators that can be attached to
-methods, functions, and other interfaces to indicate that they should no
-longer be used.
-
-To deprecate a static method you must call ``deprecated_function``
-(**not** method), after the staticmethod call::
-
- @staticmethod
- @deprecated_function(zero_ninetyone)
- def create_repository(base, shared=False, format=None):
-
-When you deprecate an API, you should not just delete its tests, because
-then we might introduce bugs in them. If the API is still present at all,
-it should still work. The basic approach is to use
-``TestCase.applyDeprecated`` which in one step checks that the API gives
-the expected deprecation message, and also returns the real result from
-the method, so that tests can keep running.
-
Coding Style Guidelines
-=======================
+#######################
hasattr and getattr
--------------------
+===================
``hasattr`` should not be used because it swallows exceptions including
``KeyboardInterrupt``. Instead, say something like ::
@@ -714,7 +663,7 @@
Code layout
------------
+===========
Please write PEP-8__ compliant code.
@@ -803,7 +752,7 @@
Module Imports
---------------
+==============
* Imports should be done at the top-level of the file, unless there is
a strong reason to have them lazily loaded when a particular
@@ -815,7 +764,7 @@
Naming
-------
+======
Functions, methods or members that are "private" to bzrlib are given
a leading underscore prefix. Names without a leading underscore are
@@ -838,7 +787,7 @@
Standard Names
---------------
+==============
``revision_id`` not ``rev_id`` or ``revid``
@@ -847,7 +796,7 @@
Destructors
------------
+===========
Python destructors (``__del__``) work differently to those of other
languages. In particular, bear in mind that destructors may be called
@@ -855,7 +804,9 @@
later time, or possibly never at all. Therefore we have restrictions on
what can be done inside them.
- 0. Never use a __del__ method without asking Martin/Robert first.
+ 0. If you think you need to use a ``__del__`` method ask another
+ developer for alternatives. If you do need to use one, explain
+ why in a comment.
1. Never rely on a ``__del__`` method running. If there is code that
must run, do it from a ``finally`` block instead.
@@ -869,7 +820,7 @@
Factories
----------
+=========
In some places we have variables which point to callables that construct
new instances. That is to say, they can be used a lot like class objects,
@@ -884,7 +835,7 @@
Registries
-----------
+==========
Several places in Bazaar use (or will use) a registry, which is a
mapping from names to objects or classes. The registry allows for
@@ -893,7 +844,7 @@
Lazy Imports
-------------
+============
To make startup time faster, we use the ``bzrlib.lazy_import`` module to
delay importing modules until they are actually used. ``lazy_import`` uses
@@ -923,10 +874,6 @@
the variable is a module, and these object should be hidden anyway, since
they shouldn't be imported into other namespaces.
-
-Modules versus Members
-~~~~~~~~~~~~~~~~~~~~~~
-
While it is possible for ``lazy_import()`` to import members of a module
when using the ``from module import member`` syntax, it is recommended to
only use that syntax to load sub modules ``from module import submodule``.
@@ -943,10 +890,6 @@
This will incorrectly fail, because ``MyClass`` is a ``ImportReplacer``
object, rather than the real class.
-
-Passing to Other Variables
-~~~~~~~~~~~~~~~~~~~~~~~~~~
-
It also is incorrect to assign ``ImportReplacer`` objects to other variables.
Because the replacer only knows about the original name, it is unable to
replace other variables. The ``ImportReplacer`` class will raise an
@@ -956,7 +899,7 @@
The Null revision
------------------
+=================
The null revision is the ancestor of all revisions. Its revno is 0, its
revision-id is ``null:``, and its tree is the empty tree. When referring
@@ -965,6 +908,102 @@
being phased out.
+Object string representations
+=============================
+
+Python prints objects using their ``__repr__`` method when they are
+written to logs, exception tracebacks, or the debugger. We want
+objects to have useful representations to help in determining what went
+wrong.
+
+If you add a new class you should generally add a ``__repr__`` method
+unless there is an adequate method in a parent class. There should be a
+test for the repr.
+
+Representations should typically look like Python constructor syntax, but
+they don't need to include every value in the object and they don't need
+to be able to actually execute. They're to be read by humans, not
+machines. Don't hardcode the classname in the format, so that we get the
+correct value if the method is inherited by a subclass. If you're
+printing attributes of the object, including strings, you should normally
+use ``%r`` syntax (to call their repr in turn).
+
+Try to avoid the representation becoming more than one or two lines long.
+(But balance this against including useful information, and simplicity of
+implementation.)
+
+Because repr methods are often called when something has already gone
+wrong, they should be written more defensively than most code. The object
+may be half-initialized or in some other way in an illegal state. The
+repr method shouldn't raise an exception, or it may hide the (probably
+more useful) underlying exception.
+
+Example::
+
+ def __repr__(self):
+ try:
+ return '%s(%r)' % (self.__class__.__name__,
+ self._transport)
+ except:
+ return 'FooObject(**unprintable**)'
+
+
+Core Topics
+###########
+
+Evolving Interfaces
+===================
+
+We have a commitment to 6 months API stability - any supported symbol in a
+release of bzr MUST NOT be altered in any way that would result in
+breaking existing code that uses it. That means that method names,
+parameter ordering, parameter names, variable and attribute names etc must
+not be changed without leaving a 'deprecated forwarder' behind. This even
+applies to modules and classes.
+
+If you wish to change the behaviour of a supported API in an incompatible
+way, you need to change its name as well. For instance, if I add an optional keyword
+parameter to branch.commit - that's fine. On the other hand, if I add a
+keyword parameter to branch.commit which is a *required* transaction
+object, I should rename the API - i.e. to 'branch.commit_transaction'.
+
+When renaming such supported API's, be sure to leave a deprecated_method (or
+_function or ...) behind which forwards to the new API. See the
+bzrlib.symbol_versioning module for decorators that take care of the
+details for you - such as updating the docstring, and issuing a warning
+when the old api is used.
+
+For unsupported API's, it does not hurt to follow this discipline, but it's
+not required. Minimally though, please try to rename things so that
+callers will at least get an AttributeError rather than weird results.
+
+
+Deprecation decorators
+----------------------
+
+``bzrlib.symbol_versioning`` provides decorators that can be attached to
+methods, functions, and other interfaces to indicate that they should no
+longer be used. For example::
+
+ @deprecated_method(deprecated_in((0, 1, 4)))
+ def foo(self):
+ return self._new_foo()
+
+To deprecate a static method you must call ``deprecated_function``
+(**not** method), after the staticmethod call::
+
+ @staticmethod
+ @deprecated_function(deprecated_in((0, 1, 4)))
+ def create_repository(base, shared=False, format=None):
+
+When you deprecate an API, you should not just delete its tests, because
+then we might introduce bugs in them. If the API is still present at all,
+it should still work. The basic approach is to use
+``TestCase.applyDeprecated`` which in one step checks that the API gives
+the expected deprecation message, and also returns the real result from
+the method, so that tests can keep running.
+
+
Getting Input
=============
@@ -1208,7 +1247,7 @@
Assertions
-----------
+==========
Do not use the Python ``assert`` statement, either in tests or elsewhere.
A source test checks that it is not used. It is ok to explicitly raise
=== modified file 'doc/developers/index.txt'
--- a/doc/developers/index.txt 2008-05-11 23:49:50 +0000
+++ b/doc/developers/index.txt 2008-05-27 08:12:28 +0000
@@ -8,7 +8,7 @@
Overall developer documentation
===============================
-* `Developer Guide <en/developer-guide/HACKING.html>`_
+* `Developer Guide <../en/developer-guide/HACKING.html>`_
* `bzrlib API reference <http://bazaar-vcs.org/BzrLib>`_
Process
=== modified file 'doc/developers/releasing.txt'
--- a/doc/developers/releasing.txt 2008-05-07 04:46:10 +0000
+++ b/doc/developers/releasing.txt 2008-05-21 06:56:56 +0000
@@ -23,6 +23,7 @@
#. Add a new "series" in Launchpad at <https://launchpad.net/bzr/+addseries>. There is one
series for every *x.y* release.
+
Weekly Status Updates
---------------------
@@ -61,7 +62,8 @@
#. In the release branch, update ``version_info`` in ``./bzrlib/__init__.py``
-#. Add the date and release number to ``./NEWS``.
+#. Add the date and release number to ``./NEWS``, and a one-paragraph
+ summary of changes in this release.
#. Commit these changes to the release branch, using a command like::
@@ -100,12 +102,14 @@
Making the source tarball
-------------------------
-#. Change into the source directory and run
+#. Change into the source directory and run ::
make dist
-#. Unpack the tarball into a temporary directory and run ``make check`` in
- that directory, to check for packaging problems.
+#. Now we'll try expanding this tarball and running the test suite
+ to check for packaging problems::
+
+ make check-dist-tarball
Publishing the release
@@ -188,6 +192,10 @@
Remember to check the results afterwards.
+ To be able to register the release you must create an account on
+ <http://pypi.python.org/pypi> and have one of the existing owners of
+ the project add you to the group.
+
Merging the released code back to trunk
---------------------------------------
@@ -214,7 +222,7 @@
The ``debian/`` directory containing the packaging information is kept in
branches on Launchpad, named like
-<https://code.launchpad.net/~bzr/bzrtools/packaging-dapper>.
+<https://code.launchpad.net/~bzr/bzr/packaging-hardy>.
Preconditions for building these packages:
@@ -236,28 +244,28 @@
* You need a Ubuntu (or probably Debian) machine, and ::
- sudo apt-get install build-essential devscripts dput
+ sudo apt-get install build-essential devscripts dput quilt patch
Here is the process; there are some steps which should be automated in
future:
#. You will need a working directory for each supported release, such as
- ``~/bzr/Packaging/dapper``
+ ``~/bzr/Packaging/hardy``
#. Download the official tarball of the release to e.g. ``~/bzr/Releases``
#. Copy the original tarball into your per-disto directory, then untar it
and if necessary rename it::
- cp -l ~/bzr/Releases/bzrtools-1.3.0.tar.gz bzrtools_1.3.0.orig.tar.gz
- tar xfvz bzrtools_1.3.0.orig.tar.gz
- mv bzrtools bzrtools-1.3.0
+ cp -l ~/bzr/Releases/bzr-1.3.tar.gz bzr_1.3.orig.tar.gz
+ tar xfvz bzr_1.3.orig.tar.gz
+ mv bzr bzr-1.3
#. Change into that directory and check out the packaging branch::
- cd bzrtools
+ cd bzr
bzr checkout \
- bzr+ssh://bazaar.launchpad.net/~bzr/bzrtools/packaging-dapper \
+ bzr+ssh://bazaar.launchpad.net/~bzr/bzr/packaging-hardy \
debian
#. For Bazaar plugins, change the ``debian/control`` file to express a
@@ -271,19 +279,19 @@
#. Make a new ``debian/changelog`` entry for the new release,
either by using ``dch`` or just editing the file::
- dch -v '1.3.0-1~bazaar1~dapper1' -D dapper
+ dch -v '1.3-1~bazaar1' -D hardy
dch will default to the distro you're working in and this isn't checked
against the version number (which is just our conversion), so make sure
to specify it.
- **Caution:** Release candidates must insert a tilde to make them sort before the
- final release, like this: ``bzr-1.4~rc2-1~bazaar1~dapper1``.
+ **Caution:** Release candidates must insert a tilde to make them sort
+ before the final release, like this: ``bzr-1.4~rc2-1~bazaar1``.
Make sure you have the correct email address for yourself, version
number, and distribution. It should look something like this::
- bzrtools (1.3.0-1~bazaar1~dapper1) dapper; urgency=low
+ bzr (1.3-1~bazaar1) hardy; urgency=low
* New upstream release.
@@ -297,11 +305,11 @@
#. Commit these changes into the packaging branch::
- bzr ci -m '1.3.0-1~bazaar1~dapper1: New upstream release.' debian
+ bzr ci -m '1.3-1~bazaar1: New upstream release.' debian
#. Build a source package::
- debuild -S -sa -i
+ debuild -S -sa -i -D
This will create a ``.changes`` file in the per-distro directory,
and should invoke gpg to sign it with your key.
@@ -310,7 +318,7 @@
#. Upload into the PPA::
- dput bzr-ppa ../bzrtools__1.3.0-1\~bazaar1\~dapper1_source.changes
+ dput bzr-ppa ../bzr__1.3-1\~bazaar1\_source.changes
Don't forget the ``bzr-ppa`` component or dput will try to upload into
the main archive by default. You can disable this by adding this
@@ -319,9 +327,20 @@
[ubuntu]
fqdn = SPECIFY.A.PPA.NAME
+#. Copy the uploaded package over to other Ubuntu releases, taking advantage
+ of Launchpad's Copy Package feature <https://launchpad.net/~bzr/+archive/+copy-packages>
+
+ **Caution:** Make sure the dependencies are the same between Ubuntu releases,
+ Dapper has different dependencies, but others might change in time.
+ If you upload a release-specific version, you should add a ~release1 to
+ the package version, for example:: bzr.1.3-1~bazaar1~dapper1
+
#. You should soon get an "upload accepted" mail from Launchpad, which
means that your package is waiting to be built. You can then track its
progress in <https://launchpad.net/~bzr/+archive> and
<https://launchpad.net/~bzr/+archive/+builds>.
+If you add all the bzr PPAs to your ``sources.list`` then you can see a
+summary of current package versions with::
+ apt-cache madison bzr
More information about the bazaar-commits
mailing list