add README.source
Norbert Preining
3 years ago
| 0 | Building an orig tarball for texlive-bin | |
| 1 | ======================================== | |
| 2 | ||
| 3 | Building a orig tarball for texlive-bin requires either a | |
| 4 | svn checkout[1] of the upstream texlive sources or a clone | |
| 5 | of the git-svn mirror[2]. | |
| 6 | ||
| 7 | The partial git-svn mirror of only the source directory at | |
| 8 | github[3] might work, too, but is untested. | |
| 9 | ||
| 10 | Assume that the sources are in $TLSOURCE, the script | |
| 11 | debian/make-orig-tar can be used to build the orig tarball. | |
| 12 | ||
| 13 | Expected arguments are: | |
| 14 | * -svn as first argument if it is a svn checkout (default to | |
| 15 | git clone) | |
| 16 | * the $TLSOURCE | |
| 17 | ||
| 18 | That is, when a git clone is in $TLSOURCE, a call | |
| 19 | bash make-orig-tar $TLSOURCE | |
| 20 | should suffice. If this is a subversion checkout, then | |
| 21 | bash make-orig-tar -svn $TLSOURCE | |
| 22 | ||
| 23 | The default for $TLSOURCE is | |
| 24 | ~/Development/TeX/texlive.git/Build/source | |
| 25 | which is where it is on my computer ;-) | |
| 26 | ||
| 27 | ||
| 28 | The generated tar ball will have a version number consisting | |
| 29 | of the TL release year, and a timestamp, followed by the | |
| 30 | subversion revision id: | |
| 31 | ||
| 32 | YYYY.yyyymmdd.ssss | |
| 33 | ||
| 34 | where YYYY is the TeX Live release year. yyyymmdd is the | |
| 35 | date stamp when the checkout was made, and ssss the subversion | |
| 36 | revision info. | |
| 37 | ||
| 38 | **WARNING** this number is NOT automatically determined but | |
| 39 | hard-coded in make-orig-tar, and needs to be updated for each | |
| 40 | new release year. | |
| 41 |