On 2008/09/16 20:29, Stuart Cassoff wrote: > Matthias Kilian wrote: >> Porters, *please* prepend some comments to the patches included in >> your ports, unless the purpose of a patch is obvious. >> >> And if you're committing security patches, just don't name the thing >> in the cvs commit message but also in the patch file (a simple >> CVE-whatever is enough). >> >> Ciao, >> Kili > > Perhaps a 'portnotes' file? Where one could find details on > what was done and why, difficulties/particularities/gripes > the porter had when porting the software, and so on. > > A companion file to README.OpenBSD, never to be installed, > containing supplementary information that would be > useful/interesting to porters and their ilk.
I think putting this sort of thing in the Makefile, or above the actual patch in patches/*, is as good as anywhere.. A separate file that's not always present will likely get missed.
