Difference between revisions of "Development"

From Syslinux Wiki
Jump to: navigation, search
m (Resources: Add internal link to Debugging.)
(Tracking SYSLINUX development with GIT: --recursive)
Line 8: Line 8:
 
To clone the repository for your own development, install the [http://www.kernel.org/pub/software/scm/git/ git] software package, and run:
 
To clone the repository for your own development, install the [http://www.kernel.org/pub/software/scm/git/ git] software package, and run:
  
     git clone git://repo.or.cz/syslinux.git a-new-directory
+
     git clone --recursive git://repo.or.cz/syslinux.git a-new-directory
  
 
or alternatively using the Hyper Text Transfer Protocol:
 
or alternatively using the Hyper Text Transfer Protocol:
  
     git clone http://repo.or.cz/syslinux.git a-new-directory
+
     git clone --recursive http://repo.or.cz/syslinux.git a-new-directory
  
 
<!-- Note: both repositories are official, but they are sometimes not fully synchronized during development periods between stable releases. -->
 
<!-- Note: both repositories are official, but they are sometimes not fully synchronized during development periods between stable releases. -->

Revision as of 08:15, 25 October 2015

Tracking SYSLINUX development with GIT

The following link points to the status page of the official development tree:

   http://repo.or.cz/syslinux.git


To clone the repository for your own development, install the git software package, and run:

   git clone --recursive git://repo.or.cz/syslinux.git a-new-directory

or alternatively using the Hyper Text Transfer Protocol:

   git clone --recursive http://repo.or.cz/syslinux.git a-new-directory


You can then make changes and "git commit" them to your own repository, thus maintaining a parallel branch of development. Furthermore, you can use the command "git pull" to update your tree with upstream changes:

   git pull

The "gitk" tool will show you a visual history of the repository.

For more information about GIT, see an overview, the tutorial, or the man pages.

Browse the SYSLINUX source code

You can browse the SYSLINUX source code through the GIT web interface at one of the following repositories:

   http://git.kernel.org/cgit/boot/syslinux/syslinux.git
   http://git.zytor.com/?p=syslinux/syslinux.git;a=summary
   http://repo.or.cz/syslinux.git

Note: These repositories are official, but they are sometimes not fully synchronized during development periods between stable releases.


Submitting Patches

Please see the doc/SubmittingPatches.txt file inside the SYSLINUX source code.

If it's in a public git tree, a common procedure is to follow a <something>-for-<someone> branch naming convention where <something> is what's done and <someone> is the person to whom you are addressing the change.

SYSLINUX internals

A series of pages describing the SYSLINUX internal architecture and functionality are being written. They are in an initial stage of development, and are organized under Category:SYSLINUX_Internals.

Any contributions are welcome!

Resources