On Sun, Dec 26, 2004 at 02:12:49PM +0100, Osamu Aoki wrote: > Hi, > > I have been merging many BTS reports on maint-guide per Josip's loose > approval. Can anyone look into my changes to proofread it (Debian site > has been somewhat updated but I have more changes committed now. Now FAQ, > NM, linda, pbuilder etc. are all mentioned. So you need to wait 1 day or > so to be current.) > > http://www.debian.org/doc/manuals/maint-guide/ > > or specifically check correctness for the following sentences. > (I welcome English grammar correction too.) > > Josip (or I if he agrees) will upload package after new year day, > I hope. > > --------------------------------------- > 9.3 The orig.tar.gz file > -If you simply copy contents of debian/ directory from old package into +If you simply copy the contents of the debian/ directory from the old package into the
-new upstream version of source tree and try to build package, you may +new upstream version of the source tree and try to build it, you may -end up with unintended result of creating a native source package which +end up unintentionally creating a native source package which -comes without diff.gz file. This type of packaging is allowed for the +comes without diff.gz file. This type of packaging is only appropriate for debian-specific packages, which will never be useful in another distribution [2]. -Here, you must have the upstream tar ball as orig.tar.gz file in the +Here, you must have the upstream tarball as <name>.orig.tar.gz file in the -parent directory. Usually, this tar ball should untar to a source tree +parent directory, where <name> refers to the name and version. Usually, this tarball should untar to a source tree -rooting from a directory with a name <packagename>-<upstream_version>/. +under a directory named like <packagename>-<upstream_version>/. -In this cases, orig.tar.gz source file can be obtained by simply rename +In this case, the orig.tar.gz source file can be obtained by simply renaming -upstream tar ball to the original file name +the upstream tarball to: -<packagename>_<upstream_version>.orig.tar.gz . Please note that the 2 +<packagename>_<upstream_version>.orig.tar.gz . Please note that 2 > changes exist between source tree directory name and the tar file name: > > * Change hyphen "-" to underscore "_" > * Add "orig." before "tar.gz." > > The dh_make command usually takes care creation of orig.tar.gz file. > ---------- > [2] > Some people argue that, even for the Debian specific package, it is a -better practice to package the contents of debian/ directory residing +better practice to package the contents of the debian/ directory -not in the orig.tar.gz file but in the diff.gz file. +not in the orig.tar.gz file, but in the diff.gz file. > --------------------------------------- > > >From changelog > ---- > * Add Korean translation by Yooseong Yang <[EMAIL PROTECTED]> . > * Fix Policy chapter for changelog for all languages. > (closes: #216405, #243339) - * Fix debian/rule example for all languages. (closes: #244463) + * Fix debian/rules example for all languages. (closes: #244463) > * List <package/xutils/ for all but ES and RU. (closes: #167395) > * Fixed only in English. Still unfixed for translations. > - Fix file location while introducing default.ent. (closes: #203609) > - Add linda and pbuilder (closes: #287064) > - Add mentors-FAQ URL (closes: #279312) > - Add dupload example (closes: #114948) > - Add -sa option, cvs-buildackage etc., dpatch. > - Add Build dep method per virlon's debian-mentor posting. > - Address issues of Debian native package. (closes: #128077) > - Add reference to buildd and FTBFS in pbuilder. (closes: #138575) > - Make working directory name consistent: ~/gentoo/ . (closes: #174816) > - Minor wording polishes and tag updates. (closes: #258273) > * Translation updated with CVS Please be advised that I'm beeing picky! Justin
