is not used any more and exists only for history. Post new tickets on the Github account. n'est plus utilisée, et existe uniquement pour son historique. Postez les nouveaux tickets sur le compte github.

Changes between Initial Version and Version 1 of en/patches

Mar 30, 2009, 11:56:45 AM (13 years ago)



  • en/patches

    v1 v1  
     1= Proposing a patch =
     3You have to follow this steps, in order to create a patch.
     5 1. retrieve the last version of jelix (trunk) from the repository (and not from the download area !)
     6 1. create the ini file for the build script
     7 1. modify the sources of jelix in order to fix the bug you want to correct, or to made improvements
     8 1. build Jelix and build testapp
     9 1. test your changes and launch unit tests in the testapp application
     10 1. if not ok, back to the third step.
     11 1. all is ok, you can create the patch.
     14Details about this steps are described [wiki:en/sources here], except the last one. Let's explain it.
     17== The content of your patch ==
     19Your patch should contain all the modifications in the code, but it must all contains modifications in the headers of all files you changed: your name, your copyright etc. You should also update the lib/jelix/CREDITS files.
     21== Creating the patch ==
     23In the directory of your local copy of the repository, you should have made all your changes. Go into the trunk directory and type:
     25  svn diff > mypatch.diff
     27Then you have a mypatch.diff file.
     29Perhaps you should made same changes in other branches. Provide then a patch for these branches
     31== Proposing the patch ==
     33Submit it into a ticket on The ticket can be an existant one, or perhaps you have to create it. Create/edit the ticket and attached the file.
     35If your patch is not finished (because you haven't no more time to work on it for example), so add a comment to explain the situation, and then this is the end for you.
     37But if it is a finished patch, you should ask a review by setting the "review" field of the ticket to "review?". Then a reviewer will verify your patch. If it is ok, he will set "review+". If your patch needs some improvements, he will  set "review-" and then you will have to make improvements he asked and you will create a new patch, submit it on the ticket, ask "review?" and so on.
     39When you have "review+", you can commit the patch in the repository if you have write acces, or a "commiter" will do it for you.
     41See [wiki:en/subversion to know the 'commit styles'].
     46[wiki:en/ summary]