Re: Do we still need to mention the "Debian Packagint Manual" in /doc/devel-manuals ?
Le Sat, Aug 25, 2012 at 11:35:48PM -0400, David Prévot a écrit :
>
> Seems fine, thanks, but could you please also add it back to the
> obsolete page [0] instead of removing it completely?
>
> 0: http://www.debian.org/doc/obsolete
I propose to first transfer the description in all languages as in the attached
patch, to save tranlators from redoing the first paragraph from scratch, and
then apply the following change in English only, replacing:
<status>
Parts that were de facto policy were recently merged into debian-policy;
the rest is planned to be included in a new `dpkg packaging manual', to
be written by Wichert Akkerman.
</status>
<availability>
Previously available in the <code>packaging-manual</code> package.
</availability>
by :
<status>
Parts that were de facto policy were merged into
<a href="devel-manuals#policy">debian-policy</a>.
</status>
<availability>
<inoldpackage "packaging-manual">
</availability>
Is that good ?
Cheers,
--
Charles
Index: ./danish/doc/obsolete.wml
===================================================================
RCS file: /cvs/webwml/webwml/danish/doc/obsolete.wml,v
retrieving revision 1.12
diff -u -r1.12 obsolete.wml
--- ./danish/doc/obsolete.wml 26 May 2011 10:04:03 -0000 1.12
+++ ./danish/doc/obsolete.wml 26 Aug 2012 04:01:26 -0000
@@ -1,5 +1,5 @@
#use wml::debian::template title="Forældet dokumentation"
-#use wml::debian::translation-check translation="1.13"
+#use wml::debian::translation-check translation="1.14"
#include "$(ENGLISHDIR)/doc/manuals.defs"
<h1 id="historical">Historiske dokumenter</h1>
@@ -318,6 +318,31 @@
</doctable>
</div>
+<hr />
+
+<document "Debians pakningshåndbog" "packman">
+
+<div class="centerblock">
+<p>
+ Denne håndbog beskriver de tekniske aspekter ved fremstillingen af
+ Debians binære- og kildekodepakker. Den dokumenterer også grænsefladen
+ mellem dselect og dettes adgangsscripts. Håndbogen behandler ikke
+ Debian-projekets retningslinier, og den forudsætter kendskab til dpkg's
+ funktionalitet fra en systemadministrators perspektiv.
+
+<doctable>
+ <authors "Ian Jackson, Klee Dienes, David A. Morris, Christian Schwarz">
+ <status>
+ Delene som var de facto-retningslinier blev for nylig flettet ind i
+ debian-policy; resten er planlagt til at blive indkluderet i en ny
+ 'dpkg pakningshåndbog', som Wichert Akkerman vil skrive.
+ </status>
+ <availability>
+ Tidligere tilgængelig i pakken <code>packaging-manual</code>.
+ </availability>
+</doctable>
+</div>
+
<h2 id="misc">Forskellig dokumentation</h2>
<document "Debians META-håndbog" "meta">
Index: ./english/doc/obsolete.wml
===================================================================
RCS file: /cvs/webwml/webwml/english/doc/obsolete.wml,v
retrieving revision 1.13
diff -u -r1.13 obsolete.wml
--- ./english/doc/obsolete.wml 26 May 2011 10:05:29 -0000 1.13
+++ ./english/doc/obsolete.wml 26 Aug 2012 04:01:26 -0000
@@ -313,6 +313,31 @@
</doctable>
</div>
+<hr />
+
+<document "Debian Packaging Manual" "packman">
+
+<div class="centerblock">
+<p>
+ This manual describes the technical aspects of creating Debian binary
+ and source packages. It also documents the interface between dselect
+ and its access method scripts. It does not deal with the Debian
+ Project policy requirements, and it assumes familiarity with dpkg's
+ functions from the system administrator's perspective.
+
+<doctable>
+ <authors "Ian Jackson, Klee Dienes, David A. Morris, Christian Schwarz">
+ <status>
+ Parts that were de facto policy were recently merged into debian-policy;
+ the rest is planned to be included in a new `dpkg packaging manual', to
+ be written by Wichert Akkerman.
+ </status>
+ <availability>
+ Previously available in the <code>packaging-manual</code> package.
+ </availability>
+</doctable>
+</div>
+
<h2 id="misc">Miscellaneous documentation</h2>
<document "Debian META Manual" "meta">
Index: ./finnish/doc/obsolete.wml
===================================================================
RCS file: /cvs/webwml/webwml/finnish/doc/obsolete.wml,v
retrieving revision 1.12
diff -u -r1.12 obsolete.wml
--- ./finnish/doc/obsolete.wml 26 May 2011 10:05:58 -0000 1.12
+++ ./finnish/doc/obsolete.wml 26 Aug 2012 04:01:27 -0000
@@ -1,6 +1,6 @@
#use wml::debian::template title="Vanhentuneet oppaat"
#include "$(ENGLISHDIR)/doc/manuals.defs"
-#use wml::debian::translation-check translation="1.13"
+#use wml::debian::translation-check translation="1.14"
<h1 id="historical">Historialliset oppaat</h1>
@@ -312,6 +312,31 @@
</doctable>
</div>
+<hr />
+
+<document "Debianin pakettiopas (englanninkielinen)" "packman">
+
+<div class="centerblock">
+<p>
+ Tämä opas kertoo Debianin binääri- ja lähdekoodipakettien luomiseen
+ liittyvistä teknisistä näkökohdista. Se dokumentoi myös dselect:in ja
+ sen hakutoimintoskriptien välistä liittymää. Se ei käsittele
+ Debian-projektin linjausten vaatimuksia, ja olettaa dpkg:n
+ toimintojen tuntemista järjestelmän ylläpitäjän näkökulmasta.
+
+<doctable>
+ <authors "Ian Jackson, Klee Dienes, David A. Morris, Christian Schwarz">
+ <status>
+ Osat jotka olivat de facto-käytäntöä yhdistettiin äskettäin
+ debian-policy-oppaaseen; loput on suunniteltu liitettäväksi
+ uuteen `dpkg-pakettioppaaseen', jonka kirjoittaa Wichert Akkerman.
+ </status>
+ <availability>
+ Ollut aiemmin saatavilla <code>packaging-manual</code>-paketissa.
+ </availability>
+</doctable>
+</div>
+
<h2 id="misc">Sekalaiset oppaat</h2>
<document "Debian META-opas (englanninkielinen)" "meta">
Index: ./french/doc/obsolete.wml
===================================================================
RCS file: /cvs/webwml/webwml/french/doc/obsolete.wml,v
retrieving revision 1.12
diff -u -r1.12 obsolete.wml
--- ./french/doc/obsolete.wml 26 May 2011 10:06:15 -0000 1.12
+++ ./french/doc/obsolete.wml 26 Aug 2012 04:01:27 -0000
@@ -1,6 +1,6 @@
#use wml::debian::template title="Documentation obsolète"
#include "$(ENGLISHDIR)/doc/manuals.defs"
-#use wml::debian::translation-check translation="1.13" maintainer="Nicolas Bertolissio"
+#use wml::debian::translation-check translation="1.14" maintainer="Nicolas Bertolissio"
<h1 id="historical">Documents d'archive</h1>
@@ -375,6 +375,31 @@
</div>
+<hr />
+
+<document "Manuel de l'empaquetage Debian" "packman">
+
+<div class="centerblock">
+<p>
+ Ce manuel décrit les aspects techniques de la création de paquets binaires
+ et de paquets sources Debian. Il documente également l'interface entre
+ dselect et ses scripts de méthodes d'accès. Il ne traite pas des exigences
+ définies par la Charte du projet Debian et il suppose une certaine
+ familiarité avec les fonctions de dpkg du point de vue de l'administration
+ d'un système.
+
+<doctable>
+ <authors "Ian Jackson, Klee Dienes, David A. Morris, Christian Schwarz">
+ <status>
+ Les parties propres à la Charte ont été récemment versées dans
+ debian-policy ; le reste sera inclus dans le nouveau « Manuel dpkg
+ du paquet » que doit écrire Wichert Akkerman.
+ </status>
+ <availability>
+ Auparavant disponible dans le paquet <code>packaging-manual</code>.
+ </availability>
+</doctable>
+</div>
<h2 id="misc">Documentation diverse</h2>
Index: ./german/doc/obsolete.wml
===================================================================
RCS file: /cvs/webwml/webwml/german/doc/obsolete.wml,v
retrieving revision 1.11
diff -u -r1.11 obsolete.wml
--- ./german/doc/obsolete.wml 29 Nov 2011 12:40:42 -0000 1.11
+++ ./german/doc/obsolete.wml 26 Aug 2012 04:01:27 -0000
@@ -1,5 +1,5 @@
#use wml::debian::template title="Veraltete Dokumentation"
-#use wml::debian::translation-check translation="1.13"
+#use wml::debian::translation-check translation="1.14"
# $Id: obsolete.wml,v 1.11 2011-11-29 12:40:42 holger-guest Exp $
#include "$(ENGLISHDIR)/doc/manuals.defs"
# Translator: Helge Kreutzmann <debian@helgefjell.de>, 2007-06-30
@@ -326,6 +326,33 @@
</doctable>
</div>
+<hr />
+
+<document "Debian Paketierungs-Handbuch" "packman">
+
+<div class="centerblock">
+<p>
+ Dieses Handbuch beschreibt die technischen Aspekte bei der Erzeugung
+ von Binär- und Quellpaketen für Debian. Es dokumentiert die
+ Schnittstelle zwischen dselect und den Skripten der Access-Methoden.
+ Es behandelt nicht die Policy-Anforderungen und es setzt
+ Vertrautheit mit Funktionen von dpkg aus der Perspektive eines
+ Systemadministrators voraus.
+</p>
+
+<doctable>
+ <authors "Ian Jackson, Klee Dienes, David A. Morris, Christian Schwarz">
+ <status>
+ Teile, die de facto Policy waren, wurden kürzlich in die
+ debian-policy aufgenommen. Es ist geplant, den Rest in ein neues
+ <q>dpkg Paketierungs-Handbuch</q> aufzunehmen, das von Wichert Akkerman
+ geschrieben werden soll.
+ </status>
+ <availability>
+ Bisher verfügbar im Paket <code>packaging-manual</code>.
+ </availability>
+</doctable>
+</div>
<h2 id="misc">Verschiedene Dokumentation</h2>
Index: ./italian/doc/obsolete.wml
===================================================================
RCS file: /cvs/webwml/webwml/italian/doc/obsolete.wml,v
retrieving revision 1.7
diff -u -r1.7 obsolete.wml
--- ./italian/doc/obsolete.wml 26 May 2011 10:08:02 -0000 1.7
+++ ./italian/doc/obsolete.wml 26 Aug 2012 04:01:28 -0000
@@ -1,6 +1,6 @@
#use wml::debian::template title="Documentazione obsoleta"
#include "$(ENGLISHDIR)/doc/manuals.defs"
-#use wml::debian::translation-check translation="1.13" maintainer="Francesca Ciceri"
+#use wml::debian::translation-check translation="1.14" maintainer="Francesca Ciceri"
#first translator and maintainer="Johan Haggi"
<h1 id="historical">Documenti storici</h1>
@@ -312,6 +312,31 @@
</doctable>
</div>
+<hr />
+
+<document "Debian Packaging Manual" "packman">
+
+<div class="centerblock">
+<p>
+ Questo manuale descrive gli aspetti tecnici della creazione di pacchetti Debian binari
+ o di sorgenti. Documenta anche l'interfaccia tra dselect
+ e gli script per i suoi metodi di accesso. Non tratta delle linee guida del Progetto
+ Debian e presuppone una buona conoscenza del funzionamento di dpkg
+ dal punto di vista dell'amministratore di sistema.
+
+<doctable>
+ <authors "Ian Jackson, Klee Dienes, David A. Morris, Christian Schwarz">
+ <status>
+ Parti che erano di fatto linee guida sono state recentemente inserite debian-policy;
+ il resto è previsto che sia incluso nel nuovo "dpkg packaging manual", in
+ corso di scrittura da parte di Wichert Akkerman.
+ </status>
+ <availability>
+ Precedentemente disponibile nel pacchetto <code>packaging-manual</code>.
+ </availability>
+</doctable>
+</div>
+
<h2 id="misc">Documentazione varia</h2>
<document "Debian META Manual" "meta">
Index: ./swedish/doc/obsolete.wml
===================================================================
RCS file: /cvs/webwml/webwml/swedish/doc/obsolete.wml,v
retrieving revision 1.8
diff -u -r1.8 obsolete.wml
--- ./swedish/doc/obsolete.wml 26 May 2011 10:09:12 -0000 1.8
+++ ./swedish/doc/obsolete.wml 26 Aug 2012 04:01:28 -0000
@@ -1,6 +1,6 @@
#use wml::debian::template title="Förlegad dokumentation"
#include "$(ENGLISHDIR)/doc/manuals.defs"
-#use wml::debian::translation-check translation="1.13"
+#use wml::debian::translation-check translation="1.14"
<h1 id="historical">Historiska dokument</h1>
@@ -314,6 +314,31 @@
</doctable>
</div>
+<hr />
+
+<document "Debians paketeringshandbok" "packman">
+
+<div class="centerblock">
+<p>
+ Denna handbok beskriver de tekniska aspekterna vad gäller att skapa
+ binär- och källkodspaket för Debian.
+ Den beskriver även gränssnittet mellan dselect och dess åtkomstskript.
+ Den hanterar inte Debianprojektets policykrav, och förutsätter
+ förtrogenhet med dpkgs funktioner från systemadministratörens synvinkel.
+
+<doctable>
+ <authors "Ian Jackson, Klee Dienes, David A. Morris, Christian Schwarz">
+ <status>
+ Delar som var de facto-policy flyttades nyligen in i debian-policy;
+ resten är planerad att ingå i en ny "dpkg-paketeringshandbok", som
+ skall skrivas av Wichert Akkerman.
+ </status>
+ <availability>
+ Tidigare tillgängligt i paketet <code>packaging-manual</code>.
+ </availability>
+</doctable>
+</div>
+
<h2 id="misc">Blandad dokumentation</h2>
<document "Debians META-manual" "meta">
Reply to: