← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/HACKING.txt

Merge description into dont-add-conflict-helpers

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/HACKING.txt
120
120
`your_lp_username`.  You can push your branch to Launchpad directly from
121
121
Bazaar::
122
122
 
123
 
  $ bzr push lp:~your_lp_username/bzr/meaningful_name_here
 
123
  $ bzr push lp:~your_lp_username/bzr/giveback
124
124
 
125
125
After you have pushed your branch, you will need to propose it for merging to
126
 
the Bazaar trunk.  Go to
127
 
<https://launchpad.net/your_lp_username/bzr/meaningful_name_here> and choose
128
 
"Propose for merging into another branch".  Select "~bzr/bzr/trunk" to hand
129
 
your changes off to the Bazaar developers for review and merging.
130
 
 
131
 
Using a meaningful name for your branch will help you and the reviewer(s)
132
 
better track the submission. Use a very succint description of your submission
133
 
and prefix it with bug number if needed (lp:~mbp/bzr/484558-merge-directory
134
 
for example). Alternatively, you can suffix with the bug number
135
 
(lp:~jameinel/bzr/export-file-511987).
136
 
 
 
126
the Bazaar trunk.  Go to <https://launchpad.net/your_lp_username/bzr/giveback>
 
127
and choose "Propose for merging into another branch".  Select "~bzr/bzr/trunk"
 
128
to hand your changes off to the Bazaar developers for review and merging.
137
129
 
138
130
Why make a local copy of bzr.dev?
139
131
---------------------------------
697
689
 
698
690
In some places we have variables which point to callables that construct
699
691
new instances.  That is to say, they can be used a lot like class objects,
700
 
but they shouldn't be *named* like classes::
 
692
but they shouldn't be *named* like classes:
701
693
 
702
694
> I think that things named FooBar should create instances of FooBar when
703
695
> called. Its plain confusing for them to do otherwise. When we have
731
723
those parameters, and this instance then has methods for operations
732
724
between the objects.
733
725
 
734
 
::
735
 
 
736
726
  inter = InterRepository.get(source_repo, target_repo)
737
727
  inter.fetch(revision_id)
738
728
 
1020
1010
finish the progress task when it exits, because it may otherwise be a long
1021
1011
time until the finally block runs.
1022
1012
 
1023
 
https://wiki.ubuntu.com/UnitsPolicy provides a good explanation about
1024
 
which unit should be used when. Roughly speaking, IEC standard applies
1025
 
for base-2 units and SI standard applies for base-10 units::
1026
 
* for network bandwidth an disk sizes, use base-10 (Mbits/s, kB/s, GB),
1027
 
* for RAM sizes, use base-2 (GiB, TiB).
1028
 
 
1029
1013
 
1030
1014
Displaying help
1031
1015
===============
1163
1147
 * new features - should be brought to their attention
1164
1148
 * bug fixes - may be of interest if the bug was affecting them, and
1165
1149
   should include the bug number if any
1166
 
 * major documentation changes, including fixed documentation bugs
 
1150
 * major documentation changes
1167
1151
 * changes to internal interfaces
1168
1152
 
1169
1153
People who made significant contributions to each change are listed in
1170
1154
parenthesis.  This can include reporting bugs (particularly with good
1171
1155
details or reproduction recipes), submitting patches, etc.
1172
1156
 
1173
 
To help with merging, NEWS entries should be sorted lexicographically
1174
 
within each section.
1175
 
 
1176
1157
Commands
1177
1158
--------
1178
1159