Bug#849483: debian-policy: emacs build dependencies probably need adjustment
Hi!
On Thu, 2016-12-29 at 15:55:27 -0600, Rob Browning wrote:
> Actually it looks like debian/rules will also need a minor adjustment,
> i.e. perhaps change this:
>
> EMACS := emacs24
>
> to
>
> EMACS := emacs
>
> or similar.
Or perhaps the attached patch is a better alternative? It reduces the
languages used in policy from four to three (Docbook, DebianDoc-SGML
and (Multi)Markdown), which ideally would become two in the future once
DebianDoc-SGML is converted to Docbook.
I've tried to make the output match as much as possible. The only
questionable thing is probably that the README.css is not embedded
anymore. That could be solved by adding the stylesheet directly into
the README.md, although that makes it a bit uglier (or injecting it
with sed or similar?).
(This also fixes the Email pseudo-field and a heading level which was
off-by-one, I think. I could send those as separate patches if you
want, though.)
I've only build tested the specific files, because I'm getting at
least two build failures, the first due to a bogus tag (patch
attached), the other with debiandoc2latexps failing with:
,---
LANG=C debiandoc2latexps policy.sgml
debiandoc2latexps: ERROR: policy.dvi could not be generated properly
debiandoc2latexps: rerun with the -v option to find out why
debiandoc2latexps: or check the log file policy.log
Makefile:35: recipe for target 'policy.ps' failed
`---
I'm attaching the policy.log, but I don't see anything obvious there. :/
BTW I don't install recommends by default on my systems.
Thanks,
Guillem
From 68b667376ad4d0e5c91b07123d5c52bfc2f0d4e9 Mon Sep 17 00:00:00 2001
From: Guillem Jover <guillem@debian.org>
Date: Sun, 8 Jan 2017 17:05:06 +0100
Subject: [PATCH] Fix DebianDoc-SGML tag
---
upgrading-checklist.sgml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/upgrading-checklist.sgml b/upgrading-checklist.sgml
index 236ca7b..f0665a7 100644
--- a/upgrading-checklist.sgml
+++ b/upgrading-checklist.sgml
@@ -64,7 +64,7 @@ Not Released Yet
<item>New <tt>Build-Depends-Arch</tt> and <tt>Build-Conflicts-Arch</tt>
fields are now supported.</item>
<tag>9.3.3.2</tag>
- <item>Packages must not call <path>/etc/init.d</path> scripts directly
+ <item>Packages must not call <file>/etc/init.d</file> scripts directly
even as a fallback, and instead must always use <prgn>invoke-rc.d</prgn>
(which is essential and shouldn't require any conditional).</item>
<tag>10.1</tag>
--
2.11.0
From 8c4d8eb3e607da57c265d121b2c32f66ac2d6b67 Mon Sep 17 00:00:00 2001
From: Guillem Jover <guillem@debian.org>
Date: Sun, 8 Jan 2017 13:45:03 +0100
Subject: [PATCH] Use MultiMarkdown instead of Org-Mode
This reduces the current formatting languages used from four to three,
and removes the build dependency on emacs and the overhead of having to
know an application specific formatting language.
Closes: #849483
---
Makefile | 12 +-
Process.org => Process.md | 99 ++++++++-------
README-css.el | 75 ------------
README-header.tex | 22 ----
README.css | 24 ++++
README.org => README.md | 301 ++++++++++++++++++++++------------------------
autopkgtest/Makefile | 4 +-
debian/control | 3 +-
debian/rules | 22 ++--
9 files changed, 242 insertions(+), 320 deletions(-)
rename Process.org => Process.md (71%)
delete mode 100644 README-css.el
delete mode 100644 README-header.tex
create mode 100644 README.css
rename README.org => README.md (58%)
diff --git a/Makefile b/Makefile
index 10b0f5a..bc649d7 100644
--- a/Makefile
+++ b/Makefile
@@ -4,14 +4,12 @@ policy.sgml: version.ent
menu-policy.sgml: version.ent
perl-policy.sgml: version.ent
-%.txt: %.org
- $(EMACS) --batch -Q -l ./README-css.el -l org --visit $^ \
- --funcall org-ascii-export-to-ascii
+%.txt: %.md
+ cat $^ > $@
test "$@" != "README.txt" || \
- perl -pli -e 's,./Process.org,Process.txt,g' $@
-%.html: %.org
- $(EMACS) --batch -Q -l ./README-css.el -l org --visit $^ \
- --funcall org-html-export-to-html
+ perl -pli -e 's,./Process.md,Process.txt,g' $@
+%.html: %.md
+ $(MDWN) $< > $@
%.validate: %
onsgmls -wall -gues $<
diff --git a/Process.org b/Process.md
similarity index 71%
rename from Process.org
rename to Process.md
index 75d3c2c..3057ade 100644
--- a/Process.org
+++ b/Process.md
@@ -1,19 +1,17 @@
-# -*- mode: org; fill-column: 78 -*-
-#+STARTUP: showall
-#+STARTUP: lognotedone lognotestate
-#+OPTIONS: H:4 toc:2
-#+TITLE: Debian Policy changes process
-#+AUTHOR: Margarita Manterola, Clint Adams, Russ Allbery, and Manoj Srivastava
-#+EMAIL: srivasta@debian.org
-#+OPTIONS: H:3 num:nil toc:nil \n:nil @:t ::t |:t ^:t -:t f:t *:t TeX:t LaTeX:nil skip:t d:nil tags:not-in-toc
-#+LINK_HOME: http://wiki.debian.org/Teams/Policy
-#+LINK_UP: http://www.debian.org/
-#+LATEX_HEADER: \input{README-header.tex}
+Format: complete
+Title: Debian Policy changes process
+Author: Margarita Manterola, Clint Adams, Russ Allbery, and Manoj Srivastava
+Email: debian-policy@packages.debian.org
+Link Home: http://wiki.debian.org/Teams/Policy
+Link Up: http://www.debian.org/
+XHTML Header: <style type="text/css">h1 { text-align: center; }</style>
+
+# Debian Policy changes process
To introduce a change in the current DebianPolicy, the change proposal
has to go through a certain process.
-* Change Goals
+## Change Goals
+ The change should be technically correct, and consistent with the
rest of the policy document. This means no legislating the value of
@@ -38,14 +36,14 @@ has to go through a certain process.
access to policy change proposals, even if they do not subscribe to
policy mailing lists (policy gazette?).
-* Current Process
+## Current Process
Each suggested change goes through different states. These states are
denoted through either usertags of the
-[[mailto:debian-policy@packages.debian.org][debian-policy@packages.debian.org]] user or, for patch, pending, and
-wontfix, regular tags.
+[debian-policy@packages.debian.org](mailto:debian-policy@packages.debian.org)
+user or, for patch, pending, and wontfix, regular tags.
-[[http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=debian-policy&pend-exc=done][Current list of bugs]]
+[Current list of bugs](http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=debian-policy&pend-exc=done)
The Policy delegates are responsible for managing the tags on bugs and
will update tags as new bugs are submitted or as activity happens on
@@ -53,12 +51,12 @@ bugs. All Debian Developers should feel free to add the seconded tag
as described below. Other tags should be changed with the coordination
of the Policy Team.
-** State A: Issue raised
+### State A: Issue raised
Detect need, like gaps/flaws in current policy, or a new rule should
be added. Any user or developer may start this step. There is a
decision point here, not all issues are in scope of policy.
-[[http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=debian-policy&tag=issue][TAG: issue]]
+[TAG: issue](http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=debian-policy&tag=issue)
What needs to happen next: If this is in scope for Policy, discuss the
issue and possible solutions, moving to the discussion tag, or if the
@@ -66,22 +64,22 @@ matter is sufficiently clear, go directly to a proposal for how to
address it, moving to the proposal tag. If this is not in scope for
Policy, close the bug.
-** State B: Discussion
+### State B: Discussion
Discuss remedy. Alternate proposals. Discussion guided by
delegates. There should be a clear time limit to this stage, but as
yet we have not set one.
-[[http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=debian-policy&pend-exc=done&tag=discussion][TAG: discussion]]
+[TAG: discussion](http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=debian-policy&pend-exc=done&tag=discussion)
What needs to happen next: Reach a conclusion and consensus in the
discussion and make a final proposal for what should be changed (if
anything), moving to the proposal tag.
-** State C: Proposal
+### State C: Proposal
A final proposal has emerged from the discussion, and there is a rough
-consensus on how to proceed to resolve the issue.
-[[http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=debian-policy&pend-exc=done&tag=proposal][TAG: proposal]]
+consensus on how to proceed to resolve the issue.
+[TAG: proposal](http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=debian-policy&pend-exc=done&tag=proposal)
What needs to happen next: Provided that the rough consensus persists,
develop a patch against the current Policy document with specific
@@ -89,20 +87,20 @@ wording of the change. Often this is done in conjunction with the
proposal, in which case one may skip this step and move directly to
patch tag.
-** State D: Wording proposed
+### State D: Wording proposed
A patch against the Policy document reflecting the consensus has been
created and is waiting for formal seconds. The standard patch tag is
used for this state, since it's essentially equivalent to the standard
-meaning of that tag.
-[[http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=debian-policy&pend-exc=done&tag=patch][TAG: patch]]
+meaning of that tag.
+[TAG: patch](http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=debian-policy&pend-exc=done&tag=patch)
What needs to happen next: The proposal needs to be reviewed and
seconded. Any Debian developer who agrees with the change and the
conclusion of rough consensus from the discussion should say so in the
bug log by seconding the proposal.
-** State E: Seconded
+### State E: Seconded
The proposal is signed off on by N Debian Developers. To start with,
we're going with N=3, meaning that if three Debian Developers agree,
@@ -113,8 +111,8 @@ partly a technical project governance method, one must be a Debian
Developer to formally second, although review and discussion is
welcome from anyone. Once this tag has been applied, the bug is
waiting for a Policy team member to apply the patch to the package
-repository.
-[[http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=debian-policy&pend-exc=done&tag=seconded][TAG: seconded]]
+repository.
+[TAG: seconded](http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=debian-policy&pend-exc=done&tag=seconded)
What needs to happen next: A Policy maintainer does the final review
and confirmation, and then applies the patch for the next Policy
@@ -124,18 +122,18 @@ This tag is not used very much because normally a Policy maintainer
applies the patch and moves the proposal to the next state once enough
seconds are reached.
-** State F: Accepted
+### State F: Accepted
Change accepted, will be in next upload. The standard pending tag is
used for this state since it matches the regular meaning of
-pending.
-[[http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=debian-policy&pend-exc=done&tag=pending][TAG: pending]]
+pending.
+[TAG: pending](http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=debian-policy&pend-exc=done&tag=pending)
What needs to happen next: The bug is now in the waiting queue for the
next Policy release, and there's nothing left to do except for upload
a new version of Policy.
-** State G: Reject
+### State G: Reject
Rejected proposals. The standard wontfix is used for this
state. Normally, bugs in this state will not remain open; instead, a
@@ -143,42 +141,51 @@ Policy team member will close them with an explanation. The submitter
may then appeal to the tech-ctte if they so desire. Alternately,
issues appealed to the tech-ctte may remain open with this tag while
that appeal proceeds.
-[[http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=debian-policy&pend-exc=done&tag=rejected][TAG: wontfix]]
+[TAG: wontfix](http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=debian-policy&pend-exc=done&tag=rejected)
We may use one of the following tags here, but to date we have only
used dubious and ctte. It's not clear whether we need more tags for
this tage.
-+ *dubious* :: Not a policy matter
-+ *ctte* :: Referred to the Technical Committee (tech-ctte)
-+ *devel* :: Referred to the developer body
-+ *delegate* :: Rejected by a Policy delegate
-+ *obsolete* :: The proposal timed out without a conclusion
+**dubious**
+: Not a policy matter
+
+**ctte**
+: Referred to the Technical Committee (tech-ctte)
+
+**devel**
+: Referred to the developer body
+
+**delegate**
+: Rejected by a Policy delegate
+
+**obsolete**
+: The proposal timed out without a conclusion
What needs to happen next: The bug should be closed once a final
resolution is reached, or retagged to an appropriate state if that
final resolution reverses the decision to reject the proposal.
-* Other Tags
+## Other Tags
All Policy bugs are additionally categorized by class of bug.
The normative tag is used for bugs that make normative changes to
Policy, meaning that the dictates of Policy will change in some
fashion as part of the resolution of the bug if the proposal is
-accepted. The full process is followed for such bugs.
-[[http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=debian-policy&pend-exc=done&tag=normative][TAG: normative]]
+accepted. The full process is followed for such bugs.
+[TAG: normative](http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=debian-policy&pend-exc=done&tag=normative)
The informative tag is used for bugs about wording issues, typos,
informative footnotes, or other changes that do not affect the formal
dictates of Policy, just the presentation. The same tags are used for
these bugs for convenience, but the Policy maintainers may make
informative changes without following the full process. Informative
-bugs fall under their discretion.
-[[http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=debian-policy&pend-exc=done&tag=informative][TAG: informative]]
+bugs fall under their discretion.
+[TAG: informative](http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=debian-policy&pend-exc=done&tag=informative)
The packaging tag is used for bugs about the packaging and build
process of the debian-policy Debian package. These bugs do not follow
the normal process and will not have the other tags except for pending
-and wontfix (used with their normal meanings).
-[[http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=debian-policy&pend-exc=done&tag=packaging][TAG: packaging]]
+and wontfix (used with their normal meanings).
+[TAG: packaging](http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=debian-policy&pend-exc=done&tag=packaging)
diff --git a/README-css.el b/README-css.el
deleted file mode 100644
index 7dfb41b..0000000
--- a/README-css.el
+++ /dev/null
@@ -1,75 +0,0 @@
-(setq
- org-export-html-style-include-default nil
- org-export-html-style
- "
-<style type=\"text/css\">
- html { font-family: Times, serif; font-size: 12pt; }
- .title { text-align: center; }
- p.verse { margin-left: 3% }
- pre {
- border: 1pt solid #AEBDCC;
- color: #000000;
- background-color: LightSlateGray;
- padding: 5pt;
- font-family: \"Courier New\", courier, monospace;
- font-size: 90%;
- overflow:auto;
- }
- dt { font-weight: bold; }
- div.figure { padding: 0.5em; }
- div.figure p { text-align: center; }
- .linenr { font-size:smaller }
- .code-highlighted {background-color:#ffff00;}
- .org-info-js_info-navigation { border-style:none; }
- #org-info-js_console-label { font-size:10px; font-weight:bold;
- white-space:nowrap; }
- .org-info-js_search-highlight {background-color:#ffff00; color:#000000;
- font-weight:bold; }
-
- body {
- color: black;
- background-color: white;
- font-family: Palatino, \"Palatino Linotype\", \"Hoefler Text\", \"Times New Roman\", Times, Georgia, Utopia, serif;
- }
- .org-agenda-date { color: #87cefa; }
- .org-agenda-structure { color: #87cefa; }
- .org-scheduled { color: #98fb98; }
- .org-scheduled-previously { color: #ff7f24; }
- .org-scheduled-today { color: #98fb98; }
- .org-tag { font-weight: bold; }
- .org-todo {
- color: #ffc0cb;
- font-weight: bold;
- }
-
- a:hover { text-decoration: underline; }
- .todo { font-weight:bold; }
- .done { font-weight:bold; }
- .TODO { color:red; }
- .WAITING { color:orange; }
- .DONE { color:green; }
- .timestamp { color: grey }
- .timestamp-kwd { color: CadetBlue }
- .tag { background-color:lightblue; font-weight:normal }
- .target { background-color: lavender; }
-table {
- border-collapse: collapse; /*separate; */
- border: outset 3pt;
- border-spacing: 0pt;
- /* border-spacing: 5pt; */
- }
-table td { vertical-align: top; border: 1px solid; }
-table th { vertical-align: top; border: 2px solid; }
-</style>
-<script =\"text/javascript\" language=\"JavaScript\" src=\"/styles/org-info.js\"></script>
-<script type=\"text/javascript\" language=\"JavaScript\">
-/* <![CDATA[ */
-org_html_manager.set(\"LOCAL_TOC\", 0);
-org_html_manager.set(\"VIEW_BUTTONS\", 1);
-org_html_manager.set(\"VIEW\", \"info\");
-org_html_manager.set(\"TOC\", 1);
-org_html_manager.set(\"MOUSE_HINT\", \"underline\"); // could be a background-color like #eeeeee
-org_html_manager.setup ();
-/* ]]> */
-</script>
-")
diff --git a/README-header.tex b/README-header.tex
deleted file mode 100644
index 6073d76..0000000
--- a/README-header.tex
+++ /dev/null
@@ -1,22 +0,0 @@
-\usepackage{landscape}
-
-\setlength{\oddsidemargin}{0in} % default=0in
-\setlength{\textwidth}{9in} % default=9in
-
-\setlength{\columnsep}{0.5in} % default=10pt
-\setlength{\columnseprule}{1pt} % default=0pt (no line)
-
-\setlength{\textheight}{5.85in} % default=5.15in
-\setlength{\topmargin}{-0.15in} % default=0.20in
-\setlength{\headsep}{0.25in} % default=0.35in
-
-\setlength{\parskip}{1.2ex}
-\setlength{\parindent}{0mm}
-\pagestyle{empty}
-
-\setlength{\headheight}{0pt}
-\setlength{\headsep}{0pt}
-\setlength{\footskip}{5pt}
-\setlength{\textheight}{9.0in}
-\setlength{\textwidth}{6.5in}
-
diff --git a/README.css b/README.css
new file mode 100644
index 0000000..e3a05a2
--- /dev/null
+++ b/README.css
@@ -0,0 +1,24 @@
+h1 { text-align: center; }
+pre {
+ border: 1px solid #ccc;
+ box-shadow: 3px 3px 3px #eee;
+ padding: 8pt;
+ font-family: monospace;
+ overflow: auto;
+ margin: 1.2em;
+}
+pre code {
+ position: relative;
+ overflow: visible;
+ padding-top: 1.2em;
+}
+pre code:before {
+ display: none;
+ position: absolute;
+ background-color: white;
+ top: -10px;
+ right: 10px;
+ padding: 3px;
+ border: 1px solid black;
+}
+pre code:hover:before { display: inline; }
diff --git a/README.org b/README.md
similarity index 58%
rename from README.org
rename to README.md
index a86f9e3..76a236b 100644
--- a/README.org
+++ b/README.md
@@ -1,81 +1,79 @@
-# -*- mode: org; fill-column: 78 -*-
-#+STARTUP: showall
-#+STARTUP: lognotedone lognotestate
-#+OPTIONS: H:4 toc:2
-#+TITLE: Debian Policy
-#+AUTHOR: Manoj Srivastava And Russ Allbery
-#+EMAIL: srivasta@debian.org
-#+OPTIONS: H:3 num:nil toc:nil \n:nil @:t ::t |:t ^:t -:t f:t *:t TeX:t LaTeX:nil skip:t d:nil tags:not-in-toc
-#+LINK_HOME: http://wiki.debian.org/Teams/Policy
-#+LINK_UP: http://www.debian.org/
-#+LATEX_HEADER: \input{README-header.tex}
-* Infrastructure
-
-+ Website:: http://www.debian.org/doc/devel-manuals#policy
-+ Mailing list:: debian-policy@lists.debian.org lists
+Format: complete
+Css: README.css
+Title: Debian Policy
+Author: Manoj Srivastava and Russ Allbery
+Email: debian-policy@packages.debian.org
+Link Home: http://wiki.debian.org/Teams/Policy
+Link Up: http://www.debian.org/
+
+# Debian Policy
+
+## Infrastructure
+
++ Website:: <http://www.debian.org/doc/devel-manuals#policy>
++ Mailing list:: <debian-policy@lists.debian.org> lists
+ Source Code::
* git clone git://anonscm.debian.org/dbnpolicy/policy.git
- * Browser: http://anonscm.debian.org/gitweb/?p=dbnpolicy/policy.git
+ * Browser: <http://anonscm.debian.org/gitweb/?p=dbnpolicy/policy.git>
+ Unix group:: dbnpolicy
-+ Alioth Project:: http://alioth.debian.org/projects/dbnpolicy (exists
++ Alioth Project:: <http://alioth.debian.org/projects/dbnpolicy> (exists
to manage the repository but not otherwise used)
-** Interacting with the team
+### Interacting with the team
-+ Email contact:: mailto:debian-policy@lists.debian.org
-+ Request tracker:: http://bugs.debian.org/src:debian-policy
++ Email contact:: <debian-policy@lists.debian.org>
++ Request tracker:: <http://bugs.debian.org/src:debian-policy>
Debian Policy uses a formal procedure and a set of user tags to manage
the lifecycle of change proposals. For definitions of those tags and
proposal states and information about what the next step is for each
-phase, see [[./Process.org][Policy changes process]].
+phase, see [Policy changes process](./Process.md).
Once the wording for a change has been finalized, please send a patch
against the current Git master branch to the bug report, if you're not
familiar with Git, the following commands are the basic process:
-#+BEGIN_SRC Sh
-git clone git://anonscm.debian.org/dbnpolicy/policy.git
-git checkout -b <local-branch-name>
-
-# edit files, but don't make changes to upgrading-checklist or debian/changelog
-git add <files>
-git commit
-# repeat as necessary
-
-# update your branch against the current master
-git checkout master
-git pull
-
-git checkout master
-git merge --no-commit <local-branch-name>
-git reset --hard HEAD;
-git checkout <local-branch-name>;
-
-# If there are changes in master that make the branch not apply cleanly, there
-# should have been en error during the merge step above. If there was an
-# error, merge the master branch into the local branch, fix the conflicts, and
-# commit the new version of the local branch.
- : git merge master
-# Edit files to remove conflict
- : git commit -s
-
-# Checkout the local branch, to create the patch to send to the policy
-git checkout <local-branch-name>
-dir=$(mktemp -d)
-git format-patch -o $dir -s master
-# check out the patches created in $dir
-git send-email --from "you <your@email>" \
- --to debian-policy@lists.debian.org \
- $dir/
-#+END_SRC
-
-<local-branch-name> is some convenient name designating your local
+
+ git clone git://anonscm.debian.org/dbnpolicy/policy.git
+ git checkout -b <local-branch-name>
+
+ # edit files, but don't make changes to upgrading-checklist or debian/changelog
+ git add <files>
+ git commit
+ # repeat as necessary
+
+ # update your branch against the current master
+ git checkout master
+ git pull
+
+ git checkout master
+ git merge --no-commit <local-branch-name>
+ git reset --hard HEAD;
+ git checkout <local-branch-name>;
+
+ # If there are changes in master that make the branch not apply cleanly,
+ # there should have been en error during the merge step above. If there
+ # was an error, merge the master branch into the local branch, fix the
+ # conflicts, and commit the new version of the local branch.
+ : git merge master
+ # Edit files to remove conflict
+ : git commit -s
+
+ # Checkout the local branch, to create the patch to send to the policy
+ git checkout <local-branch-name>
+ dir=$(mktemp -d)
+ git format-patch -o $dir -s master
+ # check out the patches created in $dir
+ git send-email --from "you <your@email>" \
+ --to debian-policy@lists.debian.org \
+ $dir/
+
+<local-branch-name> is some convenient name designating your local
changes. You may want to use some common prefix like local-. You can
use git format-patch and git send-email if you want, but usually it's
overkill.
-* Usual Roles
+## Usual Roles
The Debian Policy team are official project delegates (see the DPL
delegation). All of the Policy team members do basically the same
@@ -87,7 +85,7 @@ consensus has been reached. The current delegates are:
+ Jonathan Nieder (jrnieder)
+ Russ Allbery (rra)
-* Task description
+## Task description
The Debian Policy team is responsible for maintaining and coordinating
updates to the Debian Policy Manual and all the other policy documents
@@ -98,17 +96,13 @@ The Debian Policy Editors:
+ Guide the work on the Debian Policy Manual and related documents as a
collaborative process where developers review and second or object to
proposals, usually on the debian-policy mailing list.
-
+ Count seconds and weight objections to proposals, to determine whether
they have reached sufficient consensus to be included, and accept
consensual proposals.
-
+ Reject or refer to the Technical Committee proposals that fail to
reach consensus.
-
+ Commit changes to the version control system repository used to
maintain the Debian Policy Manual and related documents.
-
+ Maintain the "debian-policy" package. As package maintainers, they
have the last word on package content, releases, bug reports, etc.
@@ -120,27 +114,28 @@ mailing list without being project delegates.
In addition to the main technical manual, the team currently also maintains:
-+ [[http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/][Machine-readable debian/copyright format]]
-+ [[http://www.debian.org/doc/packaging-manuals/menu-policy/][Debian Menu sub-policy]]
-+ [[http://www.debian.org/doc/packaging-manuals/perl-policy/][Debian Perl Policy]]
-+ [[http://www.debian.org/doc/packaging-manuals/debconf_specification.html][Debconf Specification]]
-+ [[http://www.debian.org/doc/packaging-manuals/virtual-package-names-list.txt][Authoritative list of virtual package names ]]
++ [Machine-readable debian/copyright format](http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/)
++ [Debian Menu sub-policy](http://www.debian.org/doc/packaging-manuals/menu-policy/)
++ [Debian Perl Policy](http://www.debian.org/doc/packaging-manuals/perl-policy/)
++ [Debconf Specification](http://www.debian.org/doc/packaging-manuals/debconf_specification.html)
++ [Authoritative list of virtual package names ](http://www.debian.org/doc/packaging-manuals/virtual-package-names-list.txt)
-These documents are maintained using the [[./Process.org][Policy changes process]], and
+These documents are maintained using the [Policy changes process](./Process.md), and
the current state of all change proposals is tracked using the
-[[http://bugs.debian.org/src:debian-policy][debian-policy BTS]].
+[debian-policy BTS](http://bugs.debian.org/src:debian-policy).
-* Get involved
+## Get involved
-The best way to help is to review the [[http://bugs.debian.org/src:debian-policy][current open bugs]], pick a bug
-that no one is currently shepherding (ask on
-[[mailto:debian-policy@lists.debian.org][debian-policy@lists.debian.org]] if you're not sure if a particular bug
+The best way to help is to review the [current open bugs](http://bugs.debian.org/src:debian-policy),
+pick a bug that no one is currently shepherding (ask on
+[debian-policy@lists.debian.org](mailto:debian-policy@lists.debian.org) if
+you're not sure if a particular bug
is being shepherded), and help it through the change process. This
will involve guiding the discussion, seeking additional input
(particularly from experts in the area being discussed), possibly
raising the issue on other mailing lists, proposing or getting other
people to propose specific wording changes, and writing diffs against
-the current Policy document. All of the steps of [[./Process.org][Policy changes process]]
+the current Policy document. All of the steps of [Policy changes process](./Process.md)
can be done by people other than Policy team members except
the final acceptance steps and almost every change can be worked on
independently, so there's a lot of opportunity for people to help.
@@ -166,35 +161,36 @@ There are also some other, larger projects:
+ Policy has grown organically over the years and suffers from
organizational issues because of it. It also doesn't make use of the
abilities that a current XML language might give us, such as being
- able to extract useful portions of the document (all *must*
+ able to extract useful portions of the document (all **must**
directives, for example). There has been quite a bit of discussion
of a new format that would allow for this, probably as part of
switching to DocBook, but as yet such a reorganization and reworking
has not been started.
If you want to work on any of these projects, please mail
-[[mailto:debian-policy@lists.debian.org][debian-policy@lists.debian.org ]] for more information. We'll be happy to
-help you get started.
+[debian-policy@lists.debian.org](mailto:debian-policy@lists.debian.org)
+for more information. We'll be happy to help you get started.
-** Maintenance procedures
+## Maintenance procedures
-** Repository layout
+### Repository layout
The Git repository used for Debian Policy has the following branches:
-+ master:: the current accepted changes that will be in the next release
-+ bug<number>-<user>:: changes addressing bug <number>, shepherded by <user>
-+ rra:: old history of Russ's arch repository, now frozen
-+ srivasta:: old history of Manoj's arch repository
++ master:: the current accepted changes that will be in the next release
++ bug<number>-<user>:: changes addressing bug <number>,
+ shepherded by <user>
++ rra:: old history of Russ's arch repository, now frozen
++ srivasta:: old history of Manoj's arch repository
-** Managing a bug
+### Managing a bug
The process used by Policy team members to manage a bug, once there is
proposed wording, is:
-+ Create a bug<number>-<user> branch for the bug, where <number> is
- the bug number in the BTS and <user> is a designator of the Policy
- team member who is shepherding the bug.
++ Create a bug<number>-<user> branch for the bug, where
+ <number> is the bug number in the BTS and <user>is a
+ designator of the Policy team member who is shepherding the bug.
+ Commit wording changes in that branch until consensus is
achieved. Do not modify debian/changelog or upgrading-checklist.html
during this phase. Use the BTS to track who proposed the wording and
@@ -211,78 +207,73 @@ proposed wording, is:
+ Delete the now-merged branch.
The Git commands used for this workflow are:
-#+BEGIN_SRC Sh
-git checkout -b bug12345-rra master
-# edit files
-# git add files
-git commit
-git push origin bug12345-rra
-# iterate until good
-# update your local master branch
-git checkout master
-git pull
-
-git checkout master
-git merge --no-commit bug12345-rra
-git reset --hard HEAD;
-
-# If there are changes in master that make the branch not apply cleanly, there
-# should have been en error during the merge step above. If there was an
-# error, merge the master branch into the local branch, fix the conflicts, and
-# commit the new version of the local branch.
- : git checkout bug12345-rra
- : git merge master
-# Edit files to remove conflict
- : git commit -s
-
-git checkout master
-git merge bug12345-rra
-# edit debian/changelog and upgrading-checklist.html
-git add debian/changelog upgrading-checklist.html
-git commit
-git push origin master
-git branch -d bug12345-rra
-git push origin :bug12345-rra
-#+END_SRC
+
+ git checkout -b bug12345-rra master
+ # edit files
+ # git add files
+ git commit
+ git push origin bug12345-rra
+ # iterate until good
+ # update your local master branch
+ git checkout master
+ git pull
+
+ git checkout master
+ git merge --no-commit bug12345-rra
+ git reset --hard HEAD;
+
+ # If there are changes in master that make the branch not apply cleanly,
+ # there should have been en error during the merge step above. If there
+ # was an error, merge the master branch into the local branch, fix the
+ # conflicts, and commit the new version of the local branch.
+ : git checkout bug12345-rra
+ : git merge master
+ # Edit files to remove conflict
+ : git commit -s
+
+ git checkout master
+ git merge bug12345-rra
+ # edit debian/changelog and upgrading-checklist.html
+ git add debian/changelog upgrading-checklist.html
+ git commit
+ git push origin master
+ git branch -d bug12345-rra
+ git push origin :bug12345-rra
For the debian/changelog entry, use the following format:
-#+BEGIN_EXAMPLE
- * <document>: <brief change description>
- Wording: <author of wording>
- Seconded: <seconder>
- Seconded: <seconder>
- Closes: <bug numbers>
-#+END_EXAMPLE
+
+ * <document>: <brief change description>
+ Wording: <author of wording>
+ Seconded: <seconder>
+ Seconded: <seconder>
+ Closes: <bug numbers>
For example:
-#+BEGIN_EXAMPLE
- * Policy: better document version ranking and empty Debian revisions
- Wording: Russ Allbery <rra@debian.org>
- Seconded: Raphaël Hertzog <hertzog@debian.org>
- Seconded: Manoj Srivastava <srivasta@debian.org>
- Seconded: Guillem Jover <guillem@debian.org>
- Closes: #186700, #458910
-#+END_EXAMPLE
-** Updating branches
+ * Policy: better document version ranking and empty Debian revisions
+ Wording: Russ Allbery <rra@debian.org>
+ Seconded: Raphaël Hertzog <hertzog@debian.org>
+ Seconded: Manoj Srivastava <srivasta@debian.org>
+ Seconded: Guillem Jover <guillem@debian.org>
+ Closes: #186700, #458910
+
+### Updating branches
After commits to master have been pushed, either by you or by another
Policy team member, you will generally want to update your working bug
branches. The equivalent of the following commands should do that:
-#+BEGIN_SRC Sh
-for i in `git show-ref --heads | awk '{print $2}'`; do
- j=$(basename $i)
- if [ "$j" != "master" ]; then
- git checkout $j && git merge master
- fi
-done
-git push --all origin
-#+END_SRC
+ for i in `git show-ref --heads | awk '{print $2}'`; do
+ j=$(basename $i)
+ if [ "$j" != "master" ]; then
+ git checkout $j && git merge master
+ fi
+ done
+ git push --all origin
assuming that you haven't packed the refs in your repository.
-** Making a release
+### Making a release
For a final Policy release, change UNRELEASED to unstable in
debian/changelog and update the timestamp to match the final release
@@ -293,11 +284,9 @@ that it builds and installs.
Then, tag the repository and push the final changes to Alioth:
-#+BEGIN_SRC Sh
-git tag -s v3.8.0.0
-git push origin
-git push --tags origin
-#+END_SRC
+ git tag -s v3.8.0.0
+ git push origin
+ git push --tags origin
replacing the version number with the version of the release, of course.
@@ -305,7 +294,7 @@ Finally, announce the new Policy release on debian-devel-announce,
including in the announcement the upgrading-checklist section for the
new release.
-** Setting release goals
+### Setting release goals
Policy has a large bug backlog, and each bug against Policy tends to
take considerable time and discussion to resolve. I've found it
@@ -314,8 +303,8 @@ of bugs and set as a target resolving them completely before the next
Policy release. Resolving a bug means one of the following:
+ Proposing new language to address the bug that's seconded and approved by
- the readers of the Policy list following the [[./Progress.org][Policy changes process]] (or
- that's accepted by one of the Policy delegates if the change isn't
+ the readers of the Policy list following the [Policy changes process](./Progress.md)
+ (or that's accepted by one of the Policy delegates if the change isn't
normative; i.e., doesn't change the technical meaning of the document).
+ Determining that the bug is not relevant to Policy and closing it.
+ Determining that either there is no consensus that the bug indicates
diff --git a/autopkgtest/Makefile b/autopkgtest/Makefile
index 8ec4719..1d0c5ad 100644
--- a/autopkgtest/Makefile
+++ b/autopkgtest/Makefile
@@ -1,7 +1,9 @@
+MDWN ?= multimarkdown
+
all: autopkgtest.html autopkgtest.txt.gz
autopkgtest.html: autopkgtest.md.expanded
- markdown $< > $@
+ $(MDWN) $< > $@
autopkgtest.txt.gz: autopkgtest.md.expanded
gzip -ncf9 $< > $@
diff --git a/debian/control b/debian/control
index 3184577..183d9f4 100644
--- a/debian/control
+++ b/debian/control
@@ -12,10 +12,9 @@ Build-Depends:
debiandoc-sgml (>= 1.1.47),
docbook-dsssl,
docbook-xml,
- emacs25-nox | emacs25,
groff,
links | elinks,
- markdown,
+ libtext-multimarkdown-perl,
openjade,
opensp,
pstoedit,
diff --git a/debian/rules b/debian/rules
index 761c0ba..3435772 100755
--- a/debian/rules
+++ b/debian/rules
@@ -5,11 +5,10 @@ package := $(shell grep Source debian/control | sed 's/^Source: //')
date := $(shell date +"%Y-%m-%d")
version := $(shell dpkg-parsechangelog | awk '/^Version:/ { print $$2; exit }')
-# Current version of Emacs used to build org-mode files. Assume the build
-# dependencies pick up the correct version and we can use the generic name
-# to avoid changing things in multiple places when new versions are
-# released.
-EMACS := emacs
+# Select the Markdown implementation to use.
+MDWN := multimarkdown
+
+export MDWN
# Location of the source and build directories.
SRCTOP := $(CURDIR)
@@ -22,9 +21,9 @@ LIBDIR := $(TMPTOP)/usr/share/doc-base
# and generate a tarball of the source.
SGML_FILES := policy menu-policy perl-policy upgrading-checklist
-# org-mode source files in the top-level directory. We generate text and
+# Markdown source files in the top-level directory. We generate text and
# HTML versions from these.
-ORG_FILES := Process README
+MDWN_FILES := Process README
# doc-base description files for the documents we include.
DESC_FILES := copyright-format-1.0 debian-policy debian-menu-policy \
@@ -47,7 +46,8 @@ POLICY_FILES := $(SGML_FILES:=.sgml) $(SGML_FILES:=.txt.gz) \
autopkgtest/autopkgtest.txt.gz \
debconf_spec/debconf_specification.html \
debconf_spec/debconf_specification.txt.gz \
- policy.ps.gz policy.pdf.gz README.txt README.html \
+ policy.ps.gz policy.pdf.gz \
+ README.txt README.html README.css \
Process.txt Process.html
# Used by the clean rules. STAMPS_TO_CLEAN are the stamp files used to tell
@@ -58,7 +58,7 @@ STAMPS_TO_CLEAN := stamp-binary stamp-build
DIRS_TO_CLEAN := $(SGML_FILES:=.html) debian/tmp fhs
FILES_TO_CLEAN := $(SGML_FILES:=.txt) $(SGML_FILES:=.txt.gz) \
$(SGML_FILES:=.html.tar.gz) $(SGML_FILES:=-1.html) \
- $(ORG_FILES:=.html) $(ORG_FILES:=.txt) \
+ $(MDWN_FILES:=.html) $(MDWN_FILES:=.txt) \
policy.pdf.gz policy.ps.gz \
policy.pdf policy.ps policy.tpt policy.txt \
copyright-format/version.xml \
@@ -83,8 +83,8 @@ stamp-build: version.ent copyright-format/version.xml \
$(SGML_FILES:=-1.html) \
$(SGML_FILES:=.txt.gz) \
policy.ps.gz policy.pdf.gz
- $(MAKE) $(ORG_FILES:=.html) \
- $(ORG_FILES:=.txt)
+ $(MAKE) $(MDWN_FILES:=.html) \
+ $(MDWN_FILES:=.txt)
$(MAKE) -C copyright-format all
$(MAKE) -C autopkgtest all
$(MAKE) -C debconf_spec all
--
2.11.0
This is pdfTeX, Version 3.14159265-2.6-1.40.17 (TeX Live 2016/Debian) (preloaded format=latex 2016.12.1) 8 JAN 2017 17:06
entering extended mode
restricted \write18 enabled.
%&-line parsing enabled.
**policy.tex
(./policy.tex
LaTeX2e <2016/03/31> patch level 3
Babel <3.9r> and hyphenation patterns for 3 language(s) loaded.
(/usr/share/texlive/texmf-dist/tex/latex/base/book.cls
Document Class: book 2014/09/29 v1.4h Standard LaTeX document class
(/usr/share/texlive/texmf-dist/tex/latex/base/bk10.clo
File: bk10.clo 2014/09/29 v1.4h Standard LaTeX file (size option)
)
\c@part=\count79
\c@chapter=\count80
\c@section=\count81
\c@subsection=\count82
\c@subsubsection=\count83
\c@paragraph=\count84
\c@subparagraph=\count85
\c@figure=\count86
\c@table=\count87
\abovecaptionskip=\skip41
\belowcaptionskip=\skip42
\bibindent=\dimen102
)
(/usr/share/texlive/texmf-dist/tex/latex/base/inputenc.sty
Package: inputenc 2015/03/17 v1.2c Input encoding file
\inpenc@prehook=\toks14
\inpenc@posthook=\toks15
(/usr/share/texlive/texmf-dist/tex/latex/base/latin1.def
File: latin1.def 2015/03/17 v1.2c Input encoding file
))
(/usr/share/texlive/texmf-dist/tex/latex/base/fontenc.sty
Package: fontenc 2016/06/19 v1.99m Standard LaTeX package
(/usr/share/texlive/texmf-dist/tex/latex/base/t1enc.def
File: t1enc.def 2016/06/19 v1.99m Standard LaTeX file
LaTeX Font Info: Redeclaring font encoding T1 on input line 48.
))
(/usr/share/texlive/texmf-dist/tex/generic/oberdiek/ifpdf.sty
Package: ifpdf 2016/05/14 v3.1 Provides the ifpdf switch
)
(/usr/share/texlive/texmf-dist/tex/latex/psnfss/pifont.sty
Package: pifont 2005/04/12 PSNFSS-v9.2a Pi font support (SPQR)
LaTeX Font Info: Try loading font information for U+pzd on input line 63.
(/usr/share/texlive/texmf-dist/tex/latex/psnfss/upzd.fd
File: upzd.fd 2001/06/04 font definitions for U/pzd.
)
LaTeX Font Info: Try loading font information for U+psy on input line 64.
(/usr/share/texlive/texmf-dist/tex/latex/psnfss/upsy.fd
File: upsy.fd 2001/06/04 font definitions for U/psy.
))
(/usr/share/texlive/texmf-dist/tex/latex/base/textcomp.sty
Package: textcomp 2016/06/19 v1.99m Standard LaTeX package
Package textcomp Info: Sub-encoding information:
(textcomp) 5 = only ISO-Adobe without \textcurrency
(textcomp) 4 = 5 + \texteuro
(textcomp) 3 = 4 + \textohm
(textcomp) 2 = 3 + \textestimated + \textcurrency
(textcomp) 1 = TS1 - \textcircled - \t
(textcomp) 0 = TS1 (full)
(textcomp) Font families with sub-encoding setting implement
(textcomp) only a restricted character set as indicated.
(textcomp) Family '?' is the default used for unknown fonts.
(textcomp) See the documentation for details.
Package textcomp Info: Setting ? sub-encoding to TS1/1 on input line 79.
(/usr/share/texlive/texmf-dist/tex/latex/base/ts1enc.def
File: ts1enc.def 2001/06/05 v3.0e (jk/car/fm) Standard LaTeX file
)
LaTeX Info: Redefining \oldstylenums on input line 334.
)
(/usr/share/texlive/texmf-dist/tex/latex/wasysym/wasysym.sty
Package: wasysym 2003/10/30 v2.0 Wasy-2 symbol support package
\symwasy=\mathgroup4
LaTeX Font Info: Overwriting symbol font `wasy' in version `bold'
(Font) U/wasy/m/n --> U/wasy/b/n on input line 90.
)
(/usr/share/texlive/texmf-dist/tex/generic/babel/babel.sty
Package: babel 2016/04/23 3.9r The Babel package
(/usr/share/texlive/texmf-dist/tex/generic/babel-english/english.ldf
Language: english 2012/08/20 v3.3p English support from the babel system
(/usr/share/texlive/texmf-dist/tex/generic/babel/babel.def
File: babel.def 2016/04/23 3.9r Babel common definitions
\babel@savecnt=\count88
\U@D=\dimen103
)
\l@british = a dialect from \language\l@english
\l@UKenglish = a dialect from \language\l@english
\l@canadian = a dialect from \language\l@american
\l@australian = a dialect from \language\l@british
\l@newzealand = a dialect from \language\l@british
))
(/usr/share/texlive/texmf-dist/tex/latex/psnfss/helvet.sty
Package: helvet 2005/04/12 PSNFSS-v9.2a (WaS)
(/usr/share/texlive/texmf-dist/tex/latex/graphics/keyval.sty
Package: keyval 2014/10/28 v1.15 key=value parser (DPC)
\KV@toks@=\toks16
))
(/usr/share/texlive/texmf-dist/tex/latex/psnfss/palatino.sty
Package: palatino 2005/04/12 PSNFSS-v9.2a (SPQR)
)
(/usr/share/texlive/texmf-dist/tex/latex/vmargin/vmargin.sty
Package: vmargin 2004/07/15 V2.5 set document margins (VK)
Package: vmargin 2004/07/15 V2.5 set document margins (VK)
\PaperWidth=\dimen104
\PaperHeight=\dimen105
) (/usr/share/texlive/texmf-dist/tex/latex/fancyhdr/fancyhdr.sty
Package: fancyhdr 2016/09/06 3.8 Extensive control of page headers and footers
\fancy@headwidth=\skip43
\f@ncyO@elh=\skip44
\f@ncyO@erh=\skip45
\f@ncyO@olh=\skip46
\f@ncyO@orh=\skip47
\f@ncyO@elf=\skip48
\f@ncyO@erf=\skip49
\f@ncyO@olf=\skip50
\f@ncyO@orf=\skip51
)
(/usr/share/texlive/texmf-dist/tex/latex/paralist/paralist.sty
Package: paralist 2016/08/07 v2.6 Extended list environments
\pltopsep=\skip52
\plpartopsep=\skip53
\plitemsep=\skip54
\plparsep=\skip55
\pl@lab=\toks17
)
(/usr/share/texlive/texmf-dist/tex/latex/base/alltt.sty
Package: alltt 1997/06/16 v2.0g defines alltt environment
)
(/usr/share/texlive/texmf-dist/tex/latex/footmisc/footmisc.sty
Package: footmisc 2011/06/06 v5.5b a miscellany of footnote facilities
\FN@temptoken=\toks18
\footnotemargin=\dimen106
\c@pp@next@reset=\count89
Package footmisc Info: Declaring symbol style bringhurst on input line 855.
Package footmisc Info: Declaring symbol style chicago on input line 863.
Package footmisc Info: Declaring symbol style wiley on input line 872.
Package footmisc Info: Declaring symbol style lamport-robust on input line 883.
Package footmisc Info: Declaring symbol style lamport* on input line 903.
Package footmisc Info: Declaring symbol style lamport*-robust on input line 924
.
)
(/usr/share/texlive/texmf-dist/tex/latex/url/url.sty
\Urlmuskip=\muskip10
Package: url 2013/09/16 ver 3.4 Verb mode for urls, etc.
)
(/usr/share/texlive/texmf-dist/tex/latex/tools/varioref.sty
Package: varioref 2016/02/16 v1.5c package for extended references (FMi)
\c@vrcnt=\count90
)
(/usr/share/texlive/texmf-dist/tex/latex/hyperref/hyperref.sty
Package: hyperref 2016/06/24 v6.83q Hypertext links for LaTeX
(/usr/share/texlive/texmf-dist/tex/generic/oberdiek/hobsub-hyperref.sty
Package: hobsub-hyperref 2016/05/16 v1.14 Bundle oberdiek, subset hyperref (HO)
(/usr/share/texlive/texmf-dist/tex/generic/oberdiek/hobsub-generic.sty
Package: hobsub-generic 2016/05/16 v1.14 Bundle oberdiek, subset generic (HO)
Package: hobsub 2016/05/16 v1.14 Construct package bundles (HO)
Package: infwarerr 2016/05/16 v1.4 Providing info/warning/error messages (HO)
Package: ltxcmds 2016/05/16 v1.23 LaTeX kernel commands for general use (HO)
Package: ifluatex 2016/05/16 v1.4 Provides the ifluatex switch (HO)
Package ifluatex Info: LuaTeX not detected.
Package: ifvtex 2016/05/16 v1.6 Detect VTeX and its facilities (HO)
Package ifvtex Info: VTeX not detected.
Package: intcalc 2016/05/16 v1.2 Expandable calculations with integers (HO)
Package hobsub Info: Skipping package `ifpdf' (already loaded).
Package: etexcmds 2016/05/16 v1.6 Avoid name clashes with e-TeX commands (HO)
Package etexcmds Info: Could not find \expanded.
(etexcmds) That can mean that you are not using pdfTeX 1.50 or
(etexcmds) that some package has redefined \expanded.
(etexcmds) In the latter case, load this package earlier.
Package: kvsetkeys 2016/05/16 v1.17 Key value parser (HO)
Package: kvdefinekeys 2016/05/16 v1.4 Define keys (HO)
Package: pdftexcmds 2016/05/21 v0.22 Utility functions of pdfTeX for LuaTeX (HO
)
Package pdftexcmds Info: LuaTeX not detected.
Package pdftexcmds Info: \pdf@primitive is available.
Package pdftexcmds Info: \pdf@ifprimitive is available.
Package pdftexcmds Info: \pdfdraftmode is ignored in DVI mode.
Package: pdfescape 2016/05/16 v1.14 Implements pdfTeX's escape features (HO)
Package: bigintcalc 2016/05/16 v1.4 Expandable calculations on big integers (HO
)
Package: bitset 2016/05/16 v1.2 Handle bit-vector datatype (HO)
Package: uniquecounter 2016/05/16 v1.3 Provide unlimited unique counter (HO)
)
Package hobsub Info: Skipping package `hobsub' (already loaded).
Package: letltxmacro 2016/05/16 v1.5 Let assignment for LaTeX macros (HO)
Package: hopatch 2016/05/16 v1.3 Wrapper for package hooks (HO)
Package: xcolor-patch 2016/05/16 xcolor patch
Package: atveryend 2016/05/16 v1.9 Hooks at the very end of document (HO)
Package atveryend Info: \enddocument detected (standard20110627).
Package: atbegshi 2016/06/09 v1.18 At begin shipout hook (HO)
Package: refcount 2016/05/16 v3.5 Data extraction from label references (HO)
Package: hycolor 2016/05/16 v1.8 Color options for hyperref/bookmark (HO)
)
(/usr/share/texlive/texmf-dist/tex/generic/ifxetex/ifxetex.sty
Package: ifxetex 2010/09/12 v0.6 Provides ifxetex conditional
)
(/usr/share/texlive/texmf-dist/tex/latex/oberdiek/auxhook.sty
Package: auxhook 2016/05/16 v1.4 Hooks for auxiliary files (HO)
)
(/usr/share/texlive/texmf-dist/tex/latex/oberdiek/kvoptions.sty
Package: kvoptions 2016/05/16 v3.12 Key value format for package options (HO)
)
\@linkdim=\dimen107
\Hy@linkcounter=\count91
\Hy@pagecounter=\count92
(/usr/share/texlive/texmf-dist/tex/latex/hyperref/pd1enc.def
File: pd1enc.def 2016/06/24 v6.83q Hyperref: PDFDocEncoding definition (HO)
)
\Hy@SavedSpaceFactor=\count93
(/usr/share/texlive/texmf-dist/tex/latex/latexconfig/hyperref.cfg
File: hyperref.cfg 2002/06/06 v1.2 hyperref configuration of TeXLive
)
Package hyperref Info: Hyper figures OFF on input line 4486.
Package hyperref Info: Link nesting OFF on input line 4491.
Package hyperref Info: Hyper index ON on input line 4494.
Package hyperref Info: Plain pages OFF on input line 4501.
Package hyperref Info: Backreferencing OFF on input line 4506.
Package hyperref Info: Implicit mode ON; LaTeX internals redefined.
Package hyperref Info: Bookmarks ON on input line 4735.
\c@Hy@tempcnt=\count94
LaTeX Info: Redefining \url on input line 5088.
\XeTeXLinkMargin=\dimen108
\Fld@menulength=\count95
\Field@Width=\dimen109
\Fld@charsize=\dimen110
Package hyperref Info: Hyper figures OFF on input line 6342.
Package hyperref Info: Link nesting OFF on input line 6347.
Package hyperref Info: Hyper index ON on input line 6350.
Package hyperref Info: backreferencing OFF on input line 6357.
Package hyperref Info: Link coloring OFF on input line 6362.
Package hyperref Info: Link coloring with OCG OFF on input line 6367.
Package hyperref Info: PDF/A mode OFF on input line 6372.
LaTeX Info: Redefining \ref on input line 6412.
LaTeX Info: Redefining \pageref on input line 6416.
\Hy@abspage=\count96
\c@Item=\count97
\c@Hfootnote=\count98
)
Package hyperref Message: Driver: hypertex.
(/usr/share/texlive/texmf-dist/tex/latex/hyperref/hypertex.def
File: hypertex.def 2016/06/24 v6.83q Hyperref driver for HyperTeX specials
\Hy@SectionHShift=\skip56
)
(/usr/share/texlive/texmf-dist/tex/latex/tools/xspace.sty
Package: xspace 2014/10/28 v1.13 Space after command names (DPC,MH)
)
No file policy.aux.
\openout1 = `policy.aux'.
LaTeX Font Info: Checking defaults for OML/cmm/m/it on input line 71.
LaTeX Font Info: ... okay on input line 71.
LaTeX Font Info: Checking defaults for T1/cmr/m/n on input line 71.
LaTeX Font Info: ... okay on input line 71.
LaTeX Font Info: Checking defaults for OT1/cmr/m/n on input line 71.
LaTeX Font Info: ... okay on input line 71.
LaTeX Font Info: Checking defaults for OMS/cmsy/m/n on input line 71.
LaTeX Font Info: ... okay on input line 71.
LaTeX Font Info: Checking defaults for OMX/cmex/m/n on input line 71.
LaTeX Font Info: ... okay on input line 71.
LaTeX Font Info: Checking defaults for U/cmr/m/n on input line 71.
LaTeX Font Info: ... okay on input line 71.
LaTeX Font Info: Checking defaults for TS1/cmr/m/n on input line 71.
LaTeX Font Info: Try loading font information for TS1+cmr on input line 71.
(/usr/share/texlive/texmf-dist/tex/latex/base/ts1cmr.fd
File: ts1cmr.fd 2014/09/29 v2.5h Standard LaTeX font definitions
)
LaTeX Font Info: ... okay on input line 71.
LaTeX Font Info: Checking defaults for PD1/pdf/m/n on input line 71.
LaTeX Font Info: ... okay on input line 71.
LaTeX Font Info: Try loading font information for T1+ppl on input line 71.
(/usr/share/texlive/texmf-dist/tex/latex/psnfss/t1ppl.fd
File: t1ppl.fd 2001/06/04 font definitions for T1/ppl.
)
\AtBeginShipoutBox=\box26
Package hyperref Info: Link coloring OFF on input line 71.
(/usr/share/texlive/texmf-dist/tex/latex/hyperref/nameref.sty
Package: nameref 2016/05/21 v2.44 Cross-referencing by name of section
(/usr/share/texlive/texmf-dist/tex/generic/oberdiek/gettitlestring.sty
Package: gettitlestring 2016/05/16 v1.5 Cleanup title references (HO)
)
\c@section@level=\count99
LaTeX Info: Redefining \Ref on input line 515.
)
LaTeX Info: Redefining \ref on input line 71.
LaTeX Info: Redefining \pageref on input line 71.
LaTeX Info: Redefining \nameref on input line 71.
LaTeX Info: Redefining \Ref on input line 71.
LaTeX Font Info: Font shape `T1/ppl/bx/n' in size <14.4> not available
(Font) Font shape `T1/ppl/b/n' tried instead on input line 97.
[1
]
LaTeX Font Info: Try loading font information for TS1+ppl on input line 115.
(/usr/share/texlive/texmf-dist/tex/latex/psnfss/ts1ppl.fd
File: ts1ppl.fd 2001/06/04 font definitions for TS1/ppl.
)
LaTeX Font Info: Try loading font information for T1+pcr on input line 134.
(/usr/share/texlive/texmf-dist/tex/latex/psnfss/t1pcr.fd
File: t1pcr.fd 2001/06/04 font definitions for T1/pcr.
)
LaTeX Font Info: External font `cmex10' loaded for size
(Font) <7> on input line 136.
LaTeX Font Info: External font `cmex10' loaded for size
(Font) <5> on input line 136.
LaTeX Font Info: Try loading font information for U+wasy on input line 136.
(/usr/share/texlive/texmf-dist/tex/latex/wasysym/uwasy.fd
File: uwasy.fd 2003/10/30 v2.0 Wasy-2 symbol font definitions
) [2]
LaTeX Font Info: Font shape `T1/ppl/bx/n' in size <24.88> not available
(Font) Font shape `T1/ppl/b/n' tried instead on input line 143.
\tf@toc=\write3
\openout3 = `policy.toc'.
[1
] [2
]
Chapter 1.
LaTeX Font Info: Font shape `T1/ppl/bx/n' in size <20.74> not available
(Font) Font shape `T1/ppl/b/n' tried instead on input line 145.
LaTeX Font Info: External font `cmex10' loaded for size
(Font) <8> on input line 189.
LaTeX Font Info: External font `cmex10' loaded for size
(Font) <6> on input line 189.
LaTeX Font Info: Font shape `T1/ppl/bx/n' in size <8> not available
(Font) Font shape `T1/ppl/b/n' tried instead on input line 189.
Underfull \hbox (badness 10000) in paragraph at lines 236--240
\T1/ppl/m/n/10 This man-ual is dis-tributed via the De-bian pack-age \T1/pcr/m/
n/10 debian-policy ([]$http : / / packages . debian . org /
[]
[1]
LaTeX Font Info: Font shape `T1/ppl/bx/n' in size <10> not available
(Font) Font shape `T1/ppl/b/n' tried instead on input line 354.
[2] [3] [4
]
Chapter 2.
[5]
LaTeX Font Info: Font shape `T1/ppl/bx/n' in size <12> not available
(Font) Font shape `T1/ppl/b/n' tried instead on input line 494.
LaTeX Font Info: Font shape `T1/pcr/m/it' in size <10> not available
(Font) Font shape `T1/pcr/m/sl' tried instead on input line 608.
[6]
LaTeX Font Info: Font shape `T1/pcr/bx/n' in size <10> not available
(Font) Font shape `T1/pcr/b/n' tried instead on input line 770.
[7] [8]
Chapter 3.
[9
] [10] [11]
Underfull \hbox (badness 10000) in paragraph at lines 1215--1220
[]\T1/ppl/m/n/10 The De-bian Con-fig-u-ra-tion Man-age-ment Spec-i-fi-ca-tion i
s in-cluded in the \T1/pcr/m/n/10 debconf_specification
[]
Underfull \hbox (badness 10000) in paragraph at lines 1215--1220
\T1/ppl/m/n/10 files in the \T1/pcr/m/n/10 debian-policy \T1/ppl/m/n/10 pack-ag
e. It is also avail-able from the De-bian web mir-rors at
[]
Underfull \hbox (badness 10000) in paragraph at lines 1215--1220
\T1/pcr/m/n/10 /doc/packaging-manuals/debconf_specification.html ([]$http : / /
www . debian . org / doc /
[]
[12] [13] [14
]
Chapter 4.
[15]
LaTeX Font Info: Font shape `T1/pcr/bx/n' in size <14.4> not available
(Font) Font shape `T1/pcr/b/n' tried instead on input line 1414.
LaTeX Font Info: Font shape `T1/pcr/m/it' in size <7> not available
(Font) Font shape `T1/pcr/m/sl' tried instead on input line 1441.
[16] [17] [18]
LaTeX Font Info: Font shape `T1/pcr/bx/n' in size <12> not available
(Font) Font shape `T1/pcr/b/n' tried instead on input line 1877.
[19] [20] [21] [22]
Chapter 5.
[23
]
Underfull \hbox (badness 4120) in paragraph at lines 2298--2310
[]\T1/ppl/m/n/10 These fields are used by \T1/pcr/m/n/10 dpkg-gencontrol \T1/pp
l/m/n/10 to gen-er-ate con-trol files for bi-nary pack-ages (see be-low), by
[]
Underfull \hbox (badness 5637) in paragraph at lines 2311--2316
[]\T1/ppl/m/n/10 The fields here may con-tain vari-able ref-er-ences - their va
l-ues will be sub-sti-tuted by \T1/pcr/m/n/10 dpkg-gencontrol\T1/ppl/m/n/10 ,
[]
[24] [25] [26] [27]
Underfull \hbox (badness 2189) in paragraph at lines 2678--2678
[]\T1/ppl/b/n/12 Package in-ter-re-la-tion-ship fields: \T1/pcr/b/n/12 Depends\
T1/ppl/b/n/12 , \T1/pcr/b/n/12 Pre-Depends\T1/ppl/b/n/12 , \T1/pcr/b/n/12 Recom
mends\T1/ppl/b/n/12 , \T1/pcr/b/n/12 Suggests\T1/ppl/b/n/12 ,
[]
LaTeX Font Info: Font shape `T1/ppl/bx/it' in size <10> not available
(Font) Font shape `T1/ppl/b/it' tried instead on input line 2726.
[28]
LaTeX Font Info: Font shape `T1/ppl/bx/it' in size <8> not available
(Font) Font shape `T1/ppl/b/it' tried instead on input line 2934.
[29] [30] [31]
Overfull \hbox (58.39586pt too wide) in paragraph at lines 3198--3204
[]
[]
[32] [33] [34
]
Chapter 6.
Underfull \vbox (badness 1205) has occurred while \output is active []
[35]
Overfull \hbox (43.81268pt too wide) in paragraph at lines 3469--3488
[]
[]
[36]
Overfull \hbox (5.02303pt too wide) in paragraph at lines 3499--3507
[]
[]
[37] [38] [39] [40]
Chapter 7.
Underfull \hbox (badness 10000) in paragraph at lines 4081--4089
[]\T1/ppl/m/n/10 For build re-la-tion-ship fields (\T1/pcr/m/n/10 Build-Depends
\T1/ppl/m/n/10 , \T1/pcr/m/n/10 Build-Depends-Indep\T1/ppl/m/n/10 , \T1/pcr/m/n
/10 Build-Conflicts \T1/ppl/m/n/10 and
[]
[41
]
Underfull \hbox (badness 3000) in paragraph at lines 4165--4165
[]\T1/ppl/b/n/14.4 Binary De-pen-den-cies - \T1/pcr/b/n/14.4 Depends\T1/ppl/b/n
/14.4 , \T1/pcr/b/n/14.4 Recommends\T1/ppl/b/n/14.4 , \T1/pcr/b/n/14.4 Suggests
\T1/ppl/b/n/14.4 , \T1/pcr/b/n/14.4 Enhances\T1/ppl/b/n/14.4 ,
[]
[42] [43] [44] [45]
Underfull \hbox (badness 2698) in paragraph at lines 4682--4682
[]\T1/ppl/b/n/14.4 Relationships be-tween source and bi-nary pack-ages - \T1/pc
r/b/n/14.4 Build-Depends\T1/ppl/b/n/14.4 ,
[]
Underfull \hbox (badness 10000) in paragraph at lines 4722--4726
[]\T1/ppl/m/n/10 The \T1/pcr/m/n/10 Build-Depends\T1/ppl/m/n/10 , \T1/pcr/m/n/1
0 Build-Conflicts\T1/ppl/m/n/10 ,
[]
[46] [47] [48
]
Chapter 8.
[49] [50]
LaTeX Font Info: Font shape `T1/pcr/m/it' in size <8> not available
(Font) Font shape `T1/pcr/m/sl' tried instead on input line 5038.
[51] [52] [53] [54]
Underfull \hbox (badness 1292) in paragraph at lines 5598--5604
\T1/ppl/m/n/10 Packages us-ing only \T1/pcr/m/n/10 compress \T1/ppl/m/n/10 woul
d then get a de-pen-dency on \T1/pcr/m/n/10 zlib1g (>= 1:1.1.4)\T1/ppl/m/n/10 ,
but pack-ages us-ing
[]
[55] [56] [57] [58
]
Chapter 9.
[59]
Underfull \hbox (badness 1502) in paragraph at lines 6014--6020
[]\T1/ppl/m/n/10 The re-quire-ment for \T1/pcr/m/n/10 /usr /local /lib<qual> \
T1/ppl/m/n/10 to ex-ist if \T1/pcr/m/n/10 /lib<qual> \T1/ppl/m/n/10 or \T1/pc
r/m/n/10 /usr /lib<qual> \T1/ppl/m/n/10 ex-ists (where
[]
[60] [61] [62] [63] [64] [65] [66]
! Missing $ inserted.
<inserted text>
$
l.6946 the 22� 22 size, and preferably up to 64�4. The icon
I've inserted a begin-math/end-math symbol since I think
you left one out. Proceed, with fingers crossed.
! Missing $ inserted.
<inserted text>
$
l.6951
I've inserted a begin-math/end-math symbol since I think
you left one out. Proceed, with fingers crossed.
! Missing } inserted.
<inserted text>
}
l.6951
I've inserted something that you may have forgotten.
(See the <inserted text> above.)
With luck, this will get me unwedged. But if you
really didn't forget anything, try typing `2' now; then
my insertion and my current dilemma will both disappear.
Underfull \hbox (badness 10000) in paragraph at lines 6944--6951
[]\T1/ppl/m/n/10 Unless hid-den by de-fault, the desk-top en-try must point to
a PNG or SVG icon
[]
Underfull \hbox (badness 10000) in paragraph at lines 6944--6951
\T1/ppl/m/n/10 with a trans-par-ent back-ground, pro-vid-ing at least the 22$\O
MS/cmsy/m/n/10 ^^B\OT1/cmr/m/n/10 22\OML/cmm/m/it/10 size; andpreferablyupto\OT
1/cmr/m/n/10 64 \OMS/cmsy/m/n/10 ^^B
[]
Overfull \hbox (332.99747pt too wide) in paragraph at lines 6944--6951
\OT1/cmr/m/n/10 64\OML/cmm/m/it/10 :Theiconshouldbeneutralenoughtointegratewell
withthedefaulticonthemes:Itisencouragedtoshiptheiconinthedefault[]iconthemedire
ctories; ortouseanexistingiconfromthe[]theme:[]$
[]
! Extra }, or forgotten \endgroup.
\par ...m \@noitemerr {\@@par }\fi \else {\@@par }
\fi
l.6951
I've deleted a group-closing symbol because it seems to be
spurious, as in `$x}$'. But perhaps the } is legitimate and
you forgot something else, as in `\hbox{$x}'. In such cases
the way to recover is to insert both the forgotten and the
deleted material, e.g., by typing `I$}'.
Underfull \hbox (badness 3058) in paragraph at lines 6974--6980
[]\T1/ppl/m/n/10 Packages can, to be com-pat-i-ble with De-bian ad-di-tions to
some win-dow man-agers that do not sup-port the
[]
Underfull \hbox (badness 6016) in paragraph at lines 6974--6980
\T1/ppl/m/n/10 FreeDesk-top stan-dard, also pro-vide a \T1/ppl/m/it/10 De-bian
menu \T1/ppl/m/n/10 file, fol-low-ing the \T1/ppl/m/it/10 De-bian menu pol-icy\
T1/ppl/m/n/10 , which can be
[]
Underfull \hbox (badness 1817) in paragraph at lines 6974--6980
\T1/ppl/m/n/10 found in the \T1/pcr/m/n/10 menu-policy \T1/ppl/m/n/10 files in
the \T1/pcr/m/n/10 debian-policy \T1/ppl/m/n/10 pack-age. It is also avail-able
from the De-bian web
[]
Underfull \hbox (badness 2165) in paragraph at lines 6974--6980
\T1/ppl/m/n/10 mir-rors at \T1/pcr/m/n/10 /doc/packaging-manuals/menu-policy/ (
[]$http : / / www . debian . org / doc / packaging-[]manuals /
[]
[67] [68] [69] [70]
Chapter 10.
[71
] [72] [73]
Underfull \hbox (badness 10000) in paragraph at lines 7783--7790
[]\T1/ppl/m/n/10 As noted else-where, \T1/pcr/m/n/10 /etc /init.d \T1/ppl/m/n/
10 scripts, \T1/pcr/m/n/10 /etc /default \T1/ppl/m/n/10 files, scripts in-stal
led in \T1/pcr/m/n/10 /etc
[]
Underfull \hbox (badness 1430) in paragraph at lines 7783--7790
\T1/pcr/m/n/10 /cron.{hourly,daily,weekly,monthly}\T1/ppl/m/n/10 , and cron con
-fig-u-ra-tion in-stalled in \T1/pcr/m/n/10 /etc /cron.d \T1/ppl/m/n/10 must b
e treated
[]
[74] [75] [76] [77] [78]
Chapter 11.
[79
] [80] [81] [82] [83]
Underfull \hbox (badness 1292) in paragraph at lines 8922--8926
[]\T1/ppl/m/n/10 The Perl pol-icy can be found in the \T1/pcr/m/n/10 perl-polic
y \T1/ppl/m/n/10 files in the \T1/pcr/m/n/10 debian-policy \T1/ppl/m/n/10 pack-
age. It is also avail-able
[]
Underfull \hbox (badness 1297) in paragraph at lines 8922--8926
\T1/ppl/m/n/10 from the De-bian web mir-rors at \T1/pcr/m/n/10 /doc/packaging-m
anuals/perl-policy/ ([]$http : / / www . debian . org / doc /
[]
[84] [85] [86
]
Chapter 12.
[87] [88]
Underfull \hbox (badness 10000) in paragraph at lines 9261--9261
[][][]\T1/ppl/m/n/8 In par-tic-u-lar, \T1/pcr/m/n/8 /usr /share /common-licens
es /Apache-2.0\T1/ppl/m/n/8 , \T1/pcr/m/n/8 /usr /share /common-licenses /Arti
stic\T1/ppl/m/n/8 , \T1/pcr/m/n/8 /usr /share
[]
Underfull \hbox (badness 10000) in paragraph at lines 9261--9261
\T1/pcr/m/n/8 /common-licenses /GPL-1\T1/ppl/m/n/8 , \T1/pcr/m/n/8 /usr /share
/common-licenses /GPL-2\T1/ppl/m/n/8 , \T1/pcr/m/n/8 /usr /share /common-lice
nses /GPL-3\T1/ppl/m/n/8 , \T1/pcr/m/n/8 /usr /share
[]
Underfull \hbox (badness 10000) in paragraph at lines 9261--9261
\T1/pcr/m/n/8 /common-licenses /LGPL-2\T1/ppl/m/n/8 , \T1/pcr/m/n/8 /usr /shar
e /common-licenses /LGPL-2.1\T1/ppl/m/n/8 , \T1/pcr/m/n/8 /usr /share /common-
licenses /LGPL-3\T1/ppl/m/n/8 , \T1/pcr/m/n/8 /usr /share
[]
Underfull \hbox (badness 1377) in paragraph at lines 9261--9261
\T1/pcr/m/n/8 /common-licenses /GFDL-1.2\T1/ppl/m/n/8 , and \T1/pcr/m/n/8 /usr
/share /common-licenses /GFDL-1.3 \T1/ppl/m/n/8 re-spec-tively. The Uni-ver-si
ty of Cal-i-for-nia BSD li-cense is
[]
[89] [90]
Appendix A.
[91
] [92
]
Appendix B.
[93] [94]
Appendix C.
Underfull \hbox (badness 2334) in paragraph at lines 9605--9612
[]\T1/ppl/m/n/10 with the \T1/pcr/m/sl/10 filename\T1/pcr/m/n/10 .tar.gz \T1/pp
l/m/n/10 and \T1/pcr/m/sl/10 filename\T1/pcr/m/n/10 .diff.gz \T1/ppl/m/n/10 (if
ap-pli-ca-ble) in the same di-rec-tory. It un-packs into
[]
[95
] [96]
LaTeX Font Info: Font shape `T1/pcr/bx/it' in size <10> not available
(Font) Font shape `T1/pcr/b/it' tried instead on input line 9794.
LaTeX Font Info: Font shape `T1/pcr/b/it' in size <10> not available
(Font) Font shape `T1/pcr/b/sl' tried instead on input line 9794.
[97] [98]
Appendix D.
[99
] [100]
Appendix E.
[101
] [102]
Appendix F.
LaTeX Font Info: Font shape `T1/pcr/bx/n' in size <24.88> not available
(Font) Font shape `T1/pcr/b/n' tried instead on input line 10143.
[103
] [104
]
Appendix G.
Package atveryend Info: Empty hook `BeforeClearDocument' on input line 10261.
[105] [106]
Package atveryend Info: Empty hook `AfterLastShipout' on input line 10261.
(./policy.aux)
Package atveryend Info: Empty hook `AtVeryEndDocument' on input line 10261.
Package atveryend Info: Empty hook `AtEndAfterFileList' on input line 10261.
LaTeX Warning: Label(s) may have changed. Rerun to get cross-references right.
Package atveryend Info: Empty hook `AtVeryVeryEnd' on input line 10261.
)
Here is how much of TeX's memory you used:
6520 strings out of 494946
92248 string characters out of 6181058
168523 words of memory out of 5000000
9744 multiletter control sequences out of 15000+600000
28502 words of font info for 59 fonts, out of 8000000 for 9000
14 hyphenation exceptions out of 8191
29i,11n,43p,348b,555s stack positions out of 5000i,500n,10000p,200000b,80000s
Output written on policy.dvi (110 pages, 466296 bytes).
Reply to: