ubuntu-manual team mailing list archive
-
ubuntu-manual team
-
Mailing list archive
-
Message #01908
Re: How to commit code
Hi Jason,
Yes you can fix multiple bugs and then commit/push, rather than doing so
after each bug. The commit operation will record any changes you have made
across the whole ubuntu-manual branch. Just make sure you list the bug
numbers you have addressed in the [comment] when you run bzr commit -m
[comment].
It would probably be helpful also make the appropriate changes to the bug(s)
in launchpad soon after.
Cheers,
Jamin
On Wed, May 26, 2010 at 11:04 AM, Jason Cook <jason@xxxxxxxxxxx> wrote:
> Thanks for this guide. I have just started fixing bugs today and I have a
> few questions. Each time you change a bug do you need to "commit and push"
> or can you change multiple bugs and then "commit and push".
> The command to run are when you make a change are:
> cd ~/Projects/ubuntu-manual
> make clean; make
> bzr pull
> bzr commit -m [comment]
> bzr push
> bzr pull
>
> On Tue, May 25, 2010 at 7:07 PM, Kevin Godby <godbyk@xxxxxxxxx> wrote:
>
>> Hello, all.
>>
>> I wanted to thank everyone who's helped so far with reporting and
>> fixing bugs in the manual. We really appreciate it!
>>
>> Unfortunately, we've had a few new bugs slip in to the code in the
>> process. So here's a quick guide on how to commit code for our
>> manual:
>>
>> 1. We're commit our code against the lucid-e2 branch. To get a fresh
>> copy of this branch, run:
>>
>> bzr branch lp:ubuntu-manual/lucid-e2
>>
>> 2. Once this branch is checked out, you can edit the .tex files
>> located in the subdirectories (named after the chapters they contain).
>>
>> 3. After fixing the bug, run:
>>
>> make clean; make
>>
>> This will clear out the old temporary files and PDF and recreate
>> them from scratch. This ensures that the manual can be compiled and
>> that you haven't made any obvious typos in your LaTeX commands. Do
>> not commit your code until you've ensured it compiles successfully.
>>
>> 3. After compiling the code successfully, *before* you commit, run:
>>
>> bzr pull
>>
>> 4. Double-check to make sure your bug is still properly fixed and that
>> any changes that were just pulled in were merged properly. (If the
>> changes only impacted files you haven't edited, they should be fine.)
>>
>> 5. Now you can commit your code. Run:
>>
>> bzr commit
>>
>> and enter the numbers of any bugs you fixed.
>>
>> 6. Finally, run:
>>
>> bzr push
>>
>> If you've never pushed code to this branch before, bzr will
>> complain. You can run:
>>
>> bzr push lp:ubuntu-manual/lucid-e2
>>
>> to satisfy it. From that point on, bzr will remember the location
>> and you should be able to simply run 'bzr push'.
>>
>> 7. Run:
>>
>> bzr pull
>>
>> to grab the latest code and start again on the next bug.
>>
>>
>> If you take too long between running 'bzr commit' and 'bzr push', you
>> may find that someone else has pushed code to the branch. If this
>> occurs, run:
>>
>> bzr uncommit
>>
>> to undo your commit. Your changes are still in the files, so nothing
>> is lost. Then start at step 3 again.
>>
>> As always, if you have any questions, you can reply to this email or
>> chat with us on IRC in #ubuntu-manual on Freenode.
>>
>> Thanks!
>>
>> --Kevin Godby
>>
>> _______________________________________________
>> Mailing list: https://launchpad.net/~ubuntu-manual
>> Post to : ubuntu-manual@xxxxxxxxxxxxxxxxxxx
>> Unsubscribe : https://launchpad.net/~ubuntu-manual
>> More help : https://help.launchpad.net/ListHelp
>>
>>
>
> _______________________________________________
> Mailing list: https://launchpad.net/~ubuntu-manual
> Post to : ubuntu-manual@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~ubuntu-manual
> More help : https://help.launchpad.net/ListHelp
>
>
Follow ups
References