Difference between revisions of "Development"

From Syslinux Wiki
Jump to: navigation, search
m (Submitting Patches: Add internal link.)
m (Update repositories info.)
Line 2: Line 2:
  
 
The following link points to the status page of the official development tree:
 
The following link points to the status page of the official development tree:
 +
 +
    http://git.kernel.org/cgit/boot/syslinux/syslinux.git
 +
 +
or alternatively:
  
 
     http://git.zytor.com/?p=syslinux/syslinux.git;a=summary  
 
     http://git.zytor.com/?p=syslinux/syslinux.git;a=summary  
  
<font size=1>Go down the above linked page to find Syslinux branches. Under ''heads''
+
<font size=1>When using the latter link, go down the linked page to find Syslinux branches, under ''heads''.
 
</font size>
 
</font size>
  
  
 
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://git.kernel.org/pub/scm/boot/syslinux/syslinux.git working-directory
 +
 +
or alternatively:
  
 
     git clone git://git.zytor.com/syslinux/syslinux.git working-directory
 
     git clone git://git.zytor.com/syslinux/syslinux.git working-directory
  
You can then make changes and "<tt>git commit</tt>" them to your own repository, thus maintaining a parallel branch of development. Furthermore, you can use the command "<tt>git pull</tt>" to update your tree with upstream changes:
+
Note: both repositories are official, but they are sometimes not fully synchronized during development periods between stable releases.
 +
 
 +
You can then make changes and "<tt>git commit</tt>" them to your own repository, thus maintaining a parallel branch of development.  
 +
Furthermore, you can use the command "<tt>git pull</tt>" to update your tree with upstream changes:
  
 
     git pull
 
     git pull
Line 26: Line 37:
 
== Browse the SYSLINUX source code ==
 
== Browse the SYSLINUX source code ==
  
You can browse the SYSLINUX source code through the GIT webinterface at http://git.zytor.com/?p=syslinux/syslinux.git;a=summary
+
You can browse the SYSLINUX source code through the GIT webinterface at http://git.kernel.org/cgit/boot/syslinux/syslinux.git or alternatively at http://git.zytor.com/?p=syslinux/syslinux.git;a=summary .
 +
 
 +
Note: both repositories are official, but they are sometimes not fully synchronized during development periods between stable releases.
  
 
== Submitting Patches ==
 
== Submitting Patches ==
Line 38: Line 51:
 
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]].
 
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!
+
Any [[Contact|contributions]] are welcome!
  
 
=== Resources ===
 
=== Resources ===

Revision as of 12:33, 20 November 2014

Tracking SYSLINUX development with GIT

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

   http://git.kernel.org/cgit/boot/syslinux/syslinux.git 

or alternatively:

   http://git.zytor.com/?p=syslinux/syslinux.git;a=summary 

When using the latter link, go down the linked page to find Syslinux branches, under heads.


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

   git clone git://git.kernel.org/pub/scm/boot/syslinux/syslinux.git working-directory

or alternatively:

   git clone git://git.zytor.com/syslinux/syslinux.git working-directory

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

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 webinterface at http://git.kernel.org/cgit/boot/syslinux/syslinux.git or alternatively at http://git.zytor.com/?p=syslinux/syslinux.git;a=summary .

Note: both 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