Update README.source.
Timo Aaltonen
3 years ago
| 18 | 18 | ------------------------------------ |
| 19 | 19 | |
| 20 | 20 | The X Strike Force team maintains X packages in git repositories on |
| 21 | git.debian.org in the pkg-xorg subdirectory. Most upstream packages | |
| 21 | salsa.debian.org in the xorg-team group. Most upstream packages | |
| 22 | 22 | are actually maintained in git repositories as well, so they often |
| 23 | just need to be pulled into git.debian.org in a "upstream-*" branch. | |
| 23 | just need to be pulled into salsa.debian.org in a "upstream-*" branch. | |
| 24 | 24 | Otherwise, the upstream sources are manually installed in the Debian |
| 25 | 25 | git repository. |
| 26 | 26 | |
| 46 | 46 | case, it appears directly in the .diff.gz. |
| 47 | 47 | * Otherwise, the patch is added to debian/patches/ which is managed |
| 48 | 48 | with quilt as documented in /usr/share/doc/quilt/README.source. |
| 49 | ||
| 50 | quilt is actually invoked by the Debian X packaging through a larger | |
| 51 | set of scripts called XSFBS. XSFBS brings some other X specific | |
| 52 | features such as managing dependencies and conflicts due to the video | |
| 53 | and input driver ABIs. | |
| 54 | XSFBS itself is maintained in a separate repository at | |
| 55 | git://git.debian.org/pkg-xorg/xsfbs.git | |
| 56 | and it is pulled inside the other Debian X repositories when needed. | |
| 57 | ||
| 58 | The XSFBS patching system requires a build dependency on quilt. Also | |
| 59 | a dependency on $(STAMP_DIR)/patch has to be added to debian/rules | |
| 60 | so that the XSFBS patching occurs before the actual build. So the | |
| 61 | very first target of the build (likely the one running autoreconf) | |
| 62 | should depend on $(STAMP_DIR)/patch. It should also not depend on | |
| 63 | anything so that parallel builds are correctly supported (nothing | |
| 64 | should probably run while patching is being done). And finally, the | |
| 65 | clean target should depend on the xsfclean target so that patches | |
| 66 | are unapplied on clean. | |
| 67 | ||
| 68 | When the upstream sources contain some DFSG-nonfree files, they are | |
| 69 | listed in text files in debian/prune/ in the "debian-*" branch of | |
| 70 | the Debian repository. XSFBS' scripts then take care of removing | |
| 71 | these listed files during the build so as to generate a modified | |
| 72 | DFSG-free .orig.tar.gz tarball. | |