Annotation of pkgsrc/x11/xview-config/README.patches, Revision 1.1
1.1 ! dholland 1: This package uses per-topic patches, rather than per-file patches.
! 3: This means some of the patches patch multiple files, and some files
! 4: are patched more than once. The order the patches are applied in
! 5: matters, too. If you use mkpatches or regenerate patches naively you
! 6: *will* screw things up. Don't.
! 8: If you need to rebuild any of the existing patches, until such time as
! 9: pkgsrc gets native support for per-topic patches the proper way is to
! 10: (1) make extract, (2) touch work/.patch_done, (3) use quilt or
! 11: Mercurial's mq extension to push and pop the patches one at a time and
! 12: regenerate as necessary. (When done, don't forget to propagate the
! 13: updated patches back to the patches directory if necessary before
! 14: making clean.)
! 16: However, in general you shouldn't need to rebuild the existing
! 17: patches; if you have additional changes, in general they should go in
! 18: as additional new patches.
! 20: The long-term intent is to move these and the large number of
! 21: xview-lib and xview-clients patches to distfile patches, or maybe even
! 22: to issue a new distfile. However, doing this usefully requires
! 23: organization. Per-topic patches aren't critical for xview-config,
! 24: because there's only a handful of relatively minor changes; however,
! 25: the old way there are 131 patches in xview-lib and 96 in xview-clients
! 26: and (particularly in the absence of cvs rename) it's become nearly
! 27: impossible to work with them, so sorting and reorganization has to be
! 28: done in small steps.
! 30: The intent also is for the xview-config patches to be patch-a?-*,
! 31: xview-lib patches to be patch-[b-n]?-* or thereabouts, and the
! 32: xview-clients patches to be patch-[o-z]?-* or thereabouts, so that the
! 33: three sets of patches can be combined later without excessive
! 34: difficulty. These three sets should be disjoint: files in config/ are
! 35: patched in xview-config, files in clients/ are patched in xview-clients,
! 36: and the rest are patched in xview-lib. The build is such that there's
! 37: no overlap at build time.
! 39: Hopefully the above is enough information for someone to pick this up
! 40: if I get hit by a bus.
! 42: - dholland 20110811