From c086ac18511ce648a0ed88ab470965470bd422c5 Mon Sep 17 00:00:00 2001
From: David Kalnischkies <kalnischkies@gmail.com>
Date: Sun, 20 May 2012 18:24:23 +0200
Subject: * doc/*.xml:   - add a few translator notes and reword some
 paragraphs to ensure that     translators and users alike can better
 understand them (Closes: #669409)

---
 doc/apt.ent | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

(limited to 'doc/apt.ent')

diff --git a/doc/apt.ent b/doc/apt.ent
index e48087fa7..2b014ef3c 100644
--- a/doc/apt.ent
+++ b/doc/apt.ent
@@ -119,7 +119,7 @@
 
      <varlistentry><term><filename>&cachedir;/archives/partial/</filename></term>
      <listitem><para>Storage area for package files in transit.
-     Configuration Item: <literal>Dir::Cache::Archives</literal> (implicit partial). </para></listitem>
+     Configuration Item: <literal>Dir::Cache::Archives</literal> (<filename>partial</filename> will be implicitly appended). </para></listitem>
      </varlistentry>
 ">
 
@@ -160,7 +160,7 @@
 
      <varlistentry><term><filename>&statedir;/lists/partial/</filename></term>
      <listitem><para>Storage area for state information in transit.
-     Configuration Item: <literal>Dir::State::Lists</literal> (implicit partial).</para></listitem>
+     Configuration Item: <literal>Dir::State::Lists</literal> (<filename>partial</filename> will be implicitly appended).</para></listitem>
      </varlistentry>
 ">
 
@@ -242,11 +242,17 @@
 <!-- TRANSLATOR: used as in apt-extracttemplates filename -->
 <!ENTITY synopsis-filename "filename">
 
-<!-- TRANSLATOR: used as parameters for apt-ftparchive  e.g. apt-ftparchive packages path override pathprefix -->
+<!-- TRANSLATOR: used as parameter for apt-ftparchive  e.g. apt-ftparchive packages path override-file pathprefix -->
 <!ENTITY synopsis-path "path">
+
+<!-- TRANSLATOR: used as parameter for apt-ftparchive  e.g. apt-ftparchive packages path override-file pathprefix -->
+<!ENTITY synopsis-override "override-file">
+
+<!-- TRANSLATOR: used as parameter for apt-ftparchive  e.g. apt-ftparchive packages path override-file pathprefix -->
 <!ENTITY synopsis-pathprefix "pathprefix">
+
+<!-- TRANSLATOR: used as parameter for apt-ftparchive  e.g. apt-ftparchive generate section -->
 <!ENTITY synopsis-section "section">
-<!ENTITY synopsis-override "override">
 
 <!-- TRANSLATOR: used as in apt-key export keyid  e.g. apt-key export 473041FA -->
 <!ENTITY synopsis-keyid "keyid">
-- 
cgit v1.2.3


From 760bb8ff3894b9359b5b7af142df6359802d418b Mon Sep 17 00:00:00 2001
From: David Kalnischkies <kalnischkies@gmail.com>
Date: Mon, 21 May 2012 04:58:30 +0200
Subject: remove the mode-line from apt.ent to save them from being
 "translated"

---
 doc/apt.ent | 2 --
 1 file changed, 2 deletions(-)

(limited to 'doc/apt.ent')

diff --git a/doc/apt.ent b/doc/apt.ent
index 2b014ef3c..43ab79af2 100644
--- a/doc/apt.ent
+++ b/doc/apt.ent
@@ -1,5 +1,3 @@
-<!-- -*- mode: sgml; mode: fold -*- -->
-
 <!-- Boiler plate docinfo section -->
 <!ENTITY apt-docinfo "
  <refentryinfo>
-- 
cgit v1.2.3


From 45fb8bf7f0b3f1e5b69b37a2f9a07a6864448f03 Mon Sep 17 00:00:00 2001
From: David Kalnischkies <kalnischkies@gmail.com>
Date: Mon, 21 May 2012 06:13:03 +0200
Subject: auto-generate the correct <date> translation

---
 doc/apt.ent | 14 --------------
 1 file changed, 14 deletions(-)

(limited to 'doc/apt.ent')

diff --git a/doc/apt.ent b/doc/apt.ent
index 43ab79af2..ea1dc0265 100644
--- a/doc/apt.ent
+++ b/doc/apt.ent
@@ -1,17 +1,3 @@
-<!-- Boiler plate docinfo section -->
-<!ENTITY apt-docinfo "
- <refentryinfo>
-   <address><email>apt@packages.debian.org</email></address>
-   <author>
-     <firstname>Jason</firstname> <surname>Gunthorpe</surname>
-     <contrib></contrib>
-   </author>
-   <copyright><year>1998-2001</year> <holder>Jason Gunthorpe</holder></copyright>
-   <date>28 October 2008</date>
-   <productname>Linux</productname>
- </refentryinfo>
-">
-
 <!ENTITY apt-author.team "
    <author>
     <othername>APT team</othername>
-- 
cgit v1.2.3


From aec2216091b3d70b3baa5a5b8c87ce208e35c19c Mon Sep 17 00:00:00 2001
From: David Kalnischkies <kalnischkies@gmail.com>
Date: Wed, 23 May 2012 18:00:32 +0200
Subject: * doc/*.xml:   - mark even more stuff as untranslateable and improve
 the     markup here and there (no real text change)

---
 doc/apt.ent | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

(limited to 'doc/apt.ent')

diff --git a/doc/apt.ent b/doc/apt.ent
index ea1dc0265..6a3837b95 100644
--- a/doc/apt.ent
+++ b/doc/apt.ent
@@ -103,7 +103,7 @@
 
      <varlistentry><term><filename>&cachedir;/archives/partial/</filename></term>
      <listitem><para>Storage area for package files in transit.
-     Configuration Item: <literal>Dir::Cache::Archives</literal> (<filename>partial</filename> will be implicitly appended). </para></listitem>
+     Configuration Item: <literal>Dir::Cache::Archives</literal> (<filename>partial</filename> will be implicitly appended)</para></listitem>
      </varlistentry>
 ">
 
@@ -144,7 +144,7 @@
 
      <varlistentry><term><filename>&statedir;/lists/partial/</filename></term>
      <listitem><para>Storage area for state information in transit.
-     Configuration Item: <literal>Dir::State::Lists</literal> (<filename>partial</filename> will be implicitly appended).</para></listitem>
+     Configuration Item: <literal>Dir::State::Lists</literal> (<filename>partial</filename> will be implicitly appended)</para></listitem>
      </varlistentry>
 ">
 
-- 
cgit v1.2.3