Live Systems Manual

Git repositories

Git repositories

The list of all the available repositories of the ${project} can be found at http://live-systems.org/gitweb/. The project's git URLs have the form: protocol://live-systems.org/git/repository. Thus, in order to clone live-manual read-only, launch:

 $ git clone git://live-systems.org/git/live-manual.git  

Or,

 $ git clone https://live-systems.org/git/live-manual.git  

Or,

 $ git clone http://live-systems.org/git/live-manual.git  

The cloning addresses with write permission have the form: git@live-systems.org:/repository.

So, again, to clone live-manual over ssh you must type:

 $ git clone git@live-systems.org:live-manual.git  

The git tree is made up of several different branches. The debian and the debian-next branches are particularly noteworthy because they contain the actual work that will eventually be included in each new release.

After cloning any of the existing repositories, you will be on the debian branch. This is appropriate to take a look at the state of the project's latest release but before starting work it is crucial to switch to the debian-next branch. To do so:

 $ git checkout debian-next  

The debian-next branch, which is not always fast-forward, is where all the changes are committed first before being merged into the debian branch. To make an analogy, it is like a testing ground. If you are working on this branch and need to pull, you will have to do a git pull --rebase so that your local modifications are staged while pulling from the server and then your changes will be put on top of it all.

Handling multiple repositories

If you intend to clone several of the live systems repositories and want to switch to the debian-next branch right away to check the latest code, write a patch or contribute with a translation you ought to know that the git server provides a mrconfig file to ease the handling of multiple repositories. In order to use it you need to install the mr package and after that, launch:

 $  mr bootstrap http://live-systems.org/other/mr/mrconfig  

This command will automatically clone and checkout to the debian-next branch the development repositories of the Debian packages produced by the project. These include, among others, the live-images repository, which contains the configurations used for the prebuilt images that the project publishes for general use. For more information on how to use this repository, see Clone a configuration published via Git



License: This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

The complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL-3 file.


SiSU Spine (object numbering & object search) 2022