← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/HACKING.txt

  • Committer: Vincent Ladeuil
  • Date: 2010-02-09 17:13:04 UTC
  • mto: (5029.1.1 integration)
  • mto: This revision was merged to the branch mainline in revision 5030.
  • Revision ID: v.ladeuil+lp@free.fr-20100209171304-2ppoju422x02s7fm
Move MemoryServer to bzrlib.tests.test_server

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/HACKING.txt
689
689
 
690
690
In some places we have variables which point to callables that construct
691
691
new instances.  That is to say, they can be used a lot like class objects,
692
 
but they shouldn't be *named* like classes:
 
692
but they shouldn't be *named* like classes::
693
693
 
694
694
> I think that things named FooBar should create instances of FooBar when
695
695
> called. Its plain confusing for them to do otherwise. When we have
723
723
those parameters, and this instance then has methods for operations
724
724
between the objects.
725
725
 
 
726
::
 
727
 
726
728
  inter = InterRepository.get(source_repo, target_repo)
727
729
  inter.fetch(revision_id)
728
730
 
1010
1012
finish the progress task when it exits, because it may otherwise be a long
1011
1013
time until the finally block runs.
1012
1014
 
 
1015
https://wiki.ubuntu.com/UnitsPolicy provides a good explanation about
 
1016
which unit should be used when. Roughly speaking, IEC standard applies
 
1017
for base-2 units and SI standard applies for base-10 units::
 
1018
* for network bandwidth an disk sizes, use base-10 (Mbits/s, kB/s, GB),
 
1019
* for RAM sizes, use base-2 (GiB, TiB).
 
1020
 
1013
1021
 
1014
1022
Displaying help
1015
1023
===============
1147
1155
 * new features - should be brought to their attention
1148
1156
 * bug fixes - may be of interest if the bug was affecting them, and
1149
1157
   should include the bug number if any
1150
 
 * major documentation changes
 
1158
 * major documentation changes, including fixed documentation bugs
1151
1159
 * changes to internal interfaces
1152
1160
 
1153
1161
People who made significant contributions to each change are listed in
1154
1162
parenthesis.  This can include reporting bugs (particularly with good
1155
1163
details or reproduction recipes), submitting patches, etc.
1156
1164
 
 
1165
To help with merging, NEWS entries should be sorted lexicographically
 
1166
within each section.
 
1167
 
1157
1168
Commands
1158
1169
--------
1159
1170