This page is a basic intro to tla. It's commands are almost identical to those of baz, so use whatever you like. I do not know what is or was the difference, and you won't find any too, if you need this tutorial... Just replace tla by baz in the shell commands that follow... This introduction is not very verbose, to have a really good, but longer one, visit http://www.gnu.org/software/gnu-arch/tutorial/. 

 

Contents

1. registering / creating an archive
2. branch
3. get (checkout)
4. undo
5. commit
6. merge

 The archives used here might be deprecated, for the actual archives, please see Code_source. 

First thing you have to do after installing tla, you need to register yourself. (You won't use my name, will you?) 

 tla my-id "Michael Karlen <michael.karlen@epfl.ch>"

 

registering / creating an archive

• You can either register an existing archive: 

   tla register-archive "http://empc51.epfl.ch/~arch/infoscience/2005"

  • REMARK: You will not be able to commit to an archive registered that way, because you ain't got write-access. An archive you have write-access to would more likely look that way: 

       tla register-archive "sftp://mkarlen@empc51.epfl.ch/home/arch/repository/infoscience/2005"

    To make this work, there must be a corresponding user account mkarlen in the group arch on empc51.epfl.ch, which can be accessed via sftp. (Actually, those two archives registered right now point to the same one. It's name is "infoscience@epfl.ch--2005") 

• Or create a new, empty one. (It will be registered automatically.) 

   tla make-archive michael.karlen@epfl.ch--2005 sftp://mkarlen@empc51.epfl.ch/home/mkarlen/archives/2005

  michael.karlen@epfl.ch--2005 is the name of the archive, sftp://mkarlen@... is the location you want to store it. Obviously you need read/write-access to that account. 

• tla archives will show you all archives registered and their location. 

• tla abrowse michael.karlen@epfl.ch--2005 will show you the contents of a registered archive. 

 

branch

If you have to read this tutorial, it's quite likely you haven't got write access to the main infoscience archive. But perhaps you want to contribute some code and the Boss will merge it later on. So you have to branch the main archive to your place. Suppse you have two archives registered, one you want to branch and an empty one, respectively: 

 baz branch infoscience@epfl.ch--2005/framework--devel--1.0 michael.karlen@epfl.ch--2005/framework--devel--1.0

 

get (checkout)

To get a working copy of a registered archive, type 

 baz get michael.karlen@epfl.ch--2005/framework--devel--1.0 filters

So a new directory named filters is created. 

 

undo

To revert uncommitted local changes run 

baz undo <revision-or-patch-name>

for example: 

kis@ditdevsrv12 - infoscience > tla undo infoscience@epfl.ch--2005/infoscience--devel--1.0--patch-273

 

commit

• If you want to know what files have changed since your last commit, type tla changes. 

• A detailed output with all your changes is generated by tla diff. 

• To undo your changes since the last commit, type tla undo. 

Remember, to commit changes, you need write-access to that archive: 

 tla commit -s 'this is a small, but precise description of what you changed'

 

merge

If the main branch has changed, and you want to update your working branch, use: (It also works the other way round...) 

 tla star-merge infoscience@epfl.ch--2005/framework--devel--1.0

It is strongly recommended to make a commit before and after a merge, so you can undo potential errors and bugs introduced. 

But if you are working on a read-only archive, just use: 

 tla replay

Archives/HOWTO_arch (last edited 2011-06-03 06:35:12 by localhost)