Hi, Disclaimer: I am the current author of older maint-guide and newer debmake-doc which are displayed on www.debian.org as the packaging tutorial.
On Sun, May 14, 2017 at 07:04:06PM +0200, adrian15 wrote: > Please CC me on your answers. Thank you. ... > Forwards > ======== > If you think [email protected] is not the right place for me to send > this email please advice where to send it. Thank you. Simple enough to answer here. (debian-doc or debian-devel, I guess) > Objective > ======== > > I'm a python developer. I want to package my Hello World python > program thanks to www.d.o content. Will I be able to do so? Yes. (Of course, if your Hello World python program have proper Makefile or setup.py, it is even easier.) > * https://www.debian.org/doc/manuals/maint-guide/ - I finally find the > "New Maintainers' guide". OK. Did you go through https://www.debian.org/doc/ then it linked to https://www.debian.org/doc/devel-manuals#debmake-doc Then you had language choices. > 4) https://www.debian.org/doc/manuals/maint-guide/ should provide a > multi language link (on the bottom) to the other translated versions of > the guide. Similar to what www.d.o site does. Patch welcome. (But I see not much benefits for this complexity. If your browser is set correctly, it should pick up the right language from the URL you listed.) > 5) New maintainers guide should have at its very beginning a > quick-and-dirty mini-guide on how to package a 'Language' program for > each one of the 5 most used 'Programming languages' in Debian. That's not so simple. But I had the same concern and I rewrite the whole thing as "Guide for Debian Maintainers" (debmake-doc package). It is listed next to "Debian New Maintainers' Guide" in https://www.debian.org/doc/ which leads to: https://www.debian.org/doc/devel-manuals#debmake-doc | It is focused on the modern packaging style and comes with many simple | examples. | | * POSIX shell script packaging | * Python3 script packaging | * C with Makefile/Autotools/CMake | * multiple binary packages with shared library etc. | | This “Guide for Debian Maintainers” can be considered as the successor | to the “Debian New Maintainers’ Guide”. It has many package examples. https://www.debian.org/doc/manuals/debmake-doc/ch04.en.html https://www.debian.org/doc/manuals/debmake-doc/ch08.en.html I use debmake so packaging is a bit simpler than dh_make ;-) Please note I have hints in maint-guide as "1.2. Programs needed for development" https://www.debian.org/doc/manuals/maint-guide/start.en.html | The new debmake may be used as the alternative to the standard dh-make. | It does more and comes with HTML documentation with extensive packaging | examples in debmake-doc. Please read "Guide for Debian Maintainers" at: https://www.debian.org/doc/manuals/debmake-doc/ (Only in English now) Once Strech is released with debmake/debmake-doc, I will make the pointer from the old maint-guide to the new rewritten document clearer. > Maybe I'm wrong on this point because it might not be the 'New > maintainers guide' purpose to cover those contents but... if it is not > then it should go somewhere else in the "Developer's corner" page for sure. You overlooked! (See above comments) > 6) Please use the hello world program referenced in > https://www.debian.org/doc/manuals/maint-guide/first.en.html#choose > instead of the more complex gentoo one found in: > https://www.debian.org/doc/manuals/maint-guide/first.en.html#getit . > > This guide starts quite well by proposing to use the > 'hello-sh-1.0.tar.gz' on your own. This structure was what I originally inherited :-( > Then,later, when they explain how to try it and how to build a Debian > package then, instead of just using that previous hello-sh ... (so that > you can check if your previous steps were well done)... they base their > examples on gentoo program ! Anyway, packaging has evolved since maint-guide was originally written and there were nothing like dh command ;-) So by making patch work to improve maint-guide was getting a messy situation. > I admit gentoo program should be there because it's complex (needs to be > actually built) but the 'hello-sh-1.0.tar.gz' program should be also be > explained on how to build a Debian package. I say gentoo program in example is too simple for modern needs and the modern needs maybe more complex than gentoo. We need to cover wider spectrum of needs. debmake-doc package actually comes with many small example packages in it. So by getting its source and building it, you get to build many small example packages. Documentation is tiny portion of its usefulness. Please read it and examine it carefully. My documents are not policy nor reference. But it is a tutorial for people to get started with packaging. See https://www.debian.org/doc/manuals/debmake-doc/ch08.en.html#details Good luck, Osamu PS: This should be good explanation for https://bugs.debian.org/858573
