[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Debian New Maintainer Guide 0.1



In article <19981114152134.A32277@cibalia.gkvk.hr>, Josip Rodin <joy@cibalia.gkvk.hr> writes:
> Hello, Take a look at http://www.debian.org/~joy/ And don't yell at
> me too much :)

Ok, here's some issues:

| This document will try to describe building of a Debian GNU/Linux
| package to the common Debian user (and wannabe developer) in simple
| English language

Please don't be anglocentric.  Just say "common language".

| One of the things that makes Debian such a top-notch Linux
| distribution is its' package system.
                   ^
                  its

| libg++272 - the C++ libraries. Fakeroot needs them.

No longer true.

| debmake - the most used set of tools for creating Debian packages. You
| don't really need it to create a package, just as you don't really
| need debhelper, but its good to have it around.

No longer true.

| developers-reference - information for people who want to become
| official Debian maintainers.

Actually, the point of the developer's reference is to be an
*official* reference for all matters not specifically about the
technical details of packaging.  As such, it goes into a lot of detail
about the structure of the archive, how to rename, orphan, pick up
packages, how to do NMUs, how to manage bugs, when to upload to
stable, unstable, frozen, and experimental, etc.

Actually there are many parts of the developer's reference which you
can copy and paste (or boil down) for your document there.

Zipping ahead:

| 5.2 the `rules' file 

I feel that you need more explanation of the debian/rules file.
Briefly explain Makefile targets and the various dh_* scripts.

| dirs 
|
| This file specifies the directories which our package will create. By
| default, it looks like this:

Actually, 'debian/dirs' is only used by dh_installdirs (see the man
page).  Interestingly enough, your example debian/rules file doesn't
include dh_installdirs!


You also need to add a section talking about maintainer scripts.


> To Adam Di Carlo: I'm planning to do it with sgml for 1.0 but I
> think the contents is more important than the form.  And about DDP -
> I could join, but I'll first have to use SGML, and to learn how to
> use CVS (what a lamer).

Hey, don't worry about it.  We really encourage you to use DDP
resources since it helps us try to cohere the efforts which are out
there.  But it's meant to be a resource which *helps* Debian
documenters.  I.e., if you maintained the documentation out of CVS, I
could always check out the most recent copy and edit it and send you
patches, or, with your permission, even commit changes.

I'd be happy to help you set up CVS when you're ready, but I agree
that getting content out there is more important right now.

--
.....Adam Di Carlo....adam@onShore.com.....<URL:http://www.onShore.com/>


Reply to: