Re: Docu: Need help to understand section about package creation

[Mechtilde]

Hello everyone,

first some general information.



Newcommers should first read
the New Maintainer Guide and the Developer Reference

You want a "complete" description about packaging also for newcommers?
At the start you don't want to read a companion with several hundred pages.

If some want to have more information you can read

https://ddp-team.pages.debian.net/dpb/BuildWithGBP.pdf in German



It is still work in Progress.

Kind regards

Mechtilde
Am 29.03.24 um 04:45 schrieb Boyuan Yang:

As I understand the information from the python-team in the wiki is to inform special handlin here. The automated translation to English is deactivated yet but in the sources at salsa.debian.org

Hi,

(I am off debian-python mailing list -- please CC me.
Also, I cannot include previous text in the threads because
I don't have them in my mailbox. Sorry!)

Reading https://lists.debian.org/debian-python/2024/03/msg00152.html
and https://lists.debian.org/debian-python/2024/03/msg00151.html ,
I can see that
https://wiki.debian.org/Python/GitPackaging#Creating_a_new_package is
indeed poorly written:

*) It still points to pages of GitDpm, which the Python team is not
using anymore.

*) It does not describe the procedure of packaging from scratch very
well. To be precise, it lacks info about packaging from a status where
both git repo and the .dsc source package are nonexistant. It doesn't
describe the "gbp import-orig" subcommand for packaging initialization,
which is suprising. The same issue applies to
https://wiki.debian.org/PackagingWithGit .

For newcomers, I believe they will get lost at the very first line on
https://wiki.debian.org/Python/GitPackaging#Creating_a_new_package ,
which is "uscan". No one knows why uscan can work with an empty
directory. The newcomer may not even know what uscan is (actually they
are supposed to know what uscan is in advance -- but explanation should
be added here anyway).

If you really want a readily-available better documentation, consider
reading the official documentation of git-buildpackage at
https://honk.sigxcpu.org/projects/git-buildpackage/manual-html/ .
After you understand that, merge the remaining useful information from
https://wiki.debian.org/Python/GitPackaging to get a thorough
understanding.

I don't have a good solution to Wiki pages yet since the article logic
needs some major editing.

Thanks,
Boyuan Yang

--
Mechtilde Stehmann
## Apache OpenOffice
## Freie Office Suite für Linux, MacOSX, Windows und OS/2
## Debian Developer
## PGP encryption welcome
## F0E3 7F3D C87A 4998 2899  39E7 F287 7BBA 141A AD7F

OpenPGP_signature.asc
Description: OpenPGP digital signature