Help
Ubuntu Manual Technical Help
How to use LaTeX
Coming soon...
Using bzr
First, you'll need to make sure you have a Launchpad account, are a member of the Project and the Team, and also have registered an SSH key for your computer.
bzr, or Bazaar is the system we use to push/get branches and update branches. It is pretty intelligent and can see what changes have been made. Here's how to use it. I think these instructions should work...
Open up a new Terminal.
Install bzr:
sudo apt-get install bzr
Go to the directory you want to store the manual work, eg:
cd /home/<username>/manual
Get the bzr branch:
bzr branch lp:ubuntu-manual
Add the files to bzr:
bzr add
That should add all files in your working directory to bzr.
Now you need to see the differences (there will be none if you have got the branch for the first time):
bzr diff
Then commit it:
bzr commit -m "What you've changed"
So for example:
bzr commit -m "Fixed some spelling mistakes in chapter 6"
After it has said "committed revision X" you should be able to push it through to main:
bzr push lp:ubuntu-manual
Now go to Launchpad and check that it has indeed been pushed up to the next revision.
How to make changes
Firstly, make sure you have the latest revision by going here
- Run bzr diff when you've got the latest revision, to see what changes someone else has made
- Make your own changes
- Run bzr diff again to confirm them
- Commit them with a good description. Not word-for-word changes, but specific enough for someone to easily find again
- Push them through to main, and then check the Launchpad page to see it's gone up to the next revision.