Questions & Answers
mentors.debian.net is a rather complex service. Things can go wrong on your side or on this server. Before contacting the support please see if your question is answered here:Getting started
How do I build a package?
If you want to learn how to create a proper Debian package you can find some interesting documentation to start with:
- The Debian Policy Manual
- A must read resource to learn about technical specification and technical requirements of Debian packages.
- New Maintainer's Guide
- A must read resource to learn basics of Debian source packages
- Lucas Nussbaum's packaging tutorial
- A quick introduction to Debian packaging
- Developer's Reference
- A comprehensive manual describing typical workflows and best practices related to Debian packages
- Guide for Debian Maintainers
- Successor to the “Debian New Maintainers’ Guide”.
- Debian Mentors FAQ (Debian Wiki)
- Another valuable resource to learn about common terms and workflows related to Debian
What is the Debian policy?
Every package must comply with the Debian policy before it can enter the Debian distribution. This is a document which describes the structure and contents of the Debian archive and several design issues of the operating system, as well as technical requirements that each package must satisfy to be included in the distribution.
The policy is not a tutorial. Its a technical manual which specifies normative requirements of packages. Read it to learn package specifications. If you don't know how to package something for Debian, please read additionally the New Maintainer's Guide.
Is my package technically okay?
When you upload your package to mentors.debian.net it will automatically be checked for common mistakes. You will get an information email after the upload. Either your package contains bugs and will be rejected, or the package is clean except for some minor technical issues. You will get hints about how to fix the package. If the email tells you that your package is fine then a sponsor will still do further checks. Don't worry too much. If your package is accepted by mentors.debian.net then let the sponsor help you with the rest.
What is Lintian?
Lintian is a Debian package checker (and available as Debian package so you can run it yourself). It can be used to check binary and source packages for compliance with the Debian policy and for other common packaging errors.
Packaging for Debian is rather complex because one has to consider hundreds of guidelines to make the package "policy compliant". Lintian tries to address this issue by providing an automated static analysis framework. You can learn more about Lintian in the Lintian Wiki.
Your Account
Why do I not receive a confirmation email?
First make sure that you signed the package with the proper PGP key. Next check where you uploaded your package. By default the dput and dupload tools upload to Debian's official FTP master server. That server will silently drop your upload. If the problem persist please send an email to Site email: support@mentors.debian.net if you require assistance.
My binary packages do not show up
The current policy on mentors.debian.net is to deliberately throw away the binary packages. This is done for two main reasons. First, it saves a lot of disk space. And second, in the past Debian users downloaded the packages and used them carelessly to get brand-new versions. This led to a lot of support questions. So we decided to just keep the source packages.
How long will it take until my upload is available to sponsors?
Regardless of the upload method you choose, the importer process runs every 15 minutes. The process usually takes less than a minute to process a package but it can be longer on bigger packages.
During the importing process, the server does quality assurance and other checks on your package. You will receive an email when it is ready.
Information for sponsors
What is a sponsor?
Someone who uploads the package and is responsible for the package in the archive. The sponsor is responsible for the quality of the package and checks the work of the package maintainer to improve their skills.
Why should I sponsor uploads
Thanks for your interest. There are a lot of sponsorees waiting for a Developer to help them with their packages, and if you want to help with the New Maintainer process this is a good step to get involved.
What to do for sponsoring?
Look for packages that you would like to sponsor on this website. Once you have found some you should download, build and test them. Please notify your sponsoree of every problem that you find in order to give him a chance to fix them. We believe that it is of uttermost importance to stay in contact with your sponsorees to keep them interested in working on Debian. Moreover, they will also learn how to maintain packages within a team and will learn skills that are crucial for Debian Developers more easily.