For machines without a newer Emacs, this has no effect, but if a new Emacs is present, the .txt and .html files shall be regenerated if the org file is newer.
Signed-off-by: Manoj Srivastava <sriva...@debian.org> --- Makefile | 2 ++ README.html | 38 +++++++++++++++++--------------------- README.org | 15 +++++++-------- README.txt | 25 +++++++++++++++---------- debian/rules | 4 +++- 5 files changed, 44 insertions(+), 40 deletions(-) diff --git a/Makefile b/Makefile index d9031ff..c3e6b49 100644 --- a/Makefile +++ b/Makefile @@ -8,6 +8,8 @@ ifneq (,$(strip $(HAVE_ORG_EMACS))) %.txt: %.org $(EMACS) --batch -Q -l ./README-css.el -l org --visit $^ \ --funcall org-export-as-ascii >/dev/null 2>&1 + 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-export-as-html-batch >/dev/null 2>&1 diff --git a/README.html b/README.html index 765c626..2da20e2 100644 --- a/README.html +++ b/README.html @@ -13,22 +13,19 @@ lang="en" xml:lang="en"> <title>Debian Policy</title> <meta http-equiv="Content-Type" content="text/html;charset=utf-8"/> <meta name="generator" content="Org-mode"/> -<meta name="generated" content="2009-09-12 17:30:48 CDT"/> -<meta name="author" content="Manoj Srivastava"/> +<meta name="generated" content="2009-09-15 15:48:45 CDT"/> +<meta name="author" content="Manoj Srivastava And Russ Allbery"/> <meta name="description" content=""/> <meta name="keywords" content=""/> -<link href="/styles/simple_screen.css" type="text/css" rel="stylesheet" media="screen" /> -<link href="/styles/simple_print.css" type="text/css" rel="stylesheet" media="print" /> -<link href="/styles/common.css" type="text/css" rel="stylesheet" /> <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: gainsboro; - background-color: DarkSlateGrey; + color: #000000; + background-color: LightSlateGray; padding: 5pt; font-family: "Courier New", courier, monospace; font-size: 90%; @@ -46,8 +43,8 @@ lang="en" xml:lang="en"> font-weight:bold; } body { - color: LightSlateGray; - background-color: #000000; + color: DarkSlateGrey; + background-color: gainsboro; font-family: Palatino, "Palatino Linotype", "Hoefler Text", "Times New Roman", Times, Georgia, Utopia, serif; } .org-agenda-date { color: #87cefa; } @@ -179,7 +176,7 @@ Request tracker:: <a href="http://bugs.debian.org/src:debian-policy">http://bugs <p>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 PolicyChangesProcess. +phase, see <a href="./Process.html">Policy changes process</a>. </p> <p> Once the wording for a change has been finalized, please send a patch @@ -215,7 +212,7 @@ 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 <span style="color: #ffc1c1;">"you <<a href="mailto:your@email">your@email</a>>"</span> \ +git send-email --from <span style="font-style: italic;">"you <<a href="mailto:your@email">your@email</a>>"</span> \ --to debian-policy@lists.debian.org \ $dir/ </pre> @@ -328,7 +325,7 @@ In addition to the main technical manual, the team currently also maintains: </li> </ul> -<p>These documents are maintained using the <a href="http://wiki.debian.org/PolicyChangesProcess">Policy changes process</a>, and +<p>These documents are maintained using the <a href="./Process.html">Policy changes process</a>, and the current state of all change proposals is tracked using the <a href="http://bugs.debian.org/src:debian-policy">debian-policy BTS</a>. </p> @@ -350,7 +347,7 @@ 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 <a href="http://wiki.debian.org/PolicyChangesProcess">Policy changes process</a> +the current Policy document. All of the steps of <a href="./Process.html">Policy changes process</a> 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. @@ -563,7 +560,7 @@ branches. The equivalent of the following commands should do that: <pre class="src src-Sh">for i in `git show-ref --heads | awk '{print $2}'`; do j=$(basename $i) - if [ <span style="color: #ffc1c1;">"$j"</span> != <span style="color: #ffc1c1;">"master"</span> ]; then + if [ <span style="font-style: italic;">"$j"</span> != <span style="font-style: italic;">"master"</span> ]; then git checkout $j && git merge master fi done @@ -633,11 +630,10 @@ Policy release. Resolving a bug means one of the following: </p> <ul> <li> -Proposing new language to address the bug that's seconded and -approved by the readers of the Policy list following the -PolicyChangesProcess (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). +Proposing new language to address the bug that's seconded and approved by +the readers of the Policy list following the <a href="./Progress.html">Policy changes process</a> (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). </li> <li> Determining that the bug is not relevant to Policy and closing it. @@ -672,10 +668,10 @@ reach one of the resolution states above. </div> </div> <div id="postamble"> -<p class="author"> Author: Manoj Srivastava +<p class="author"> Author: Manoj Srivastava And Russ Allbery <a href="mailto:sriva...@debian.org"><sriva...@debian.org></a> </p> -<p class="date"> Date: 2009-09-12 17:30:48 CDT</p> +<p class="date"> Date: 2009-09-15 15:48:45 CDT</p> <p class="creator">HTML generated by org-mode 6.30trans in emacs 23</p> </div> </div> diff --git a/README.org b/README.org index 3228229..8596396 100644 --- a/README.org +++ b/README.org @@ -51,7 +51,7 @@ 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 PolicyChangesProcess. +phase, see [[./Process.org][Policy changes process]]. 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 @@ -140,7 +140,7 @@ In addition to the main technical manual, the team currently also maintains: + [[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 ]] -These documents are maintained using the [[http://wiki.debian.org/PolicyChangesProcess][Policy changes process]], and +These documents are maintained using the [[./Process.org][Policy changes process]], and the current state of all change proposals is tracked using the [[http://bugs.debian.org/src:debian-policy][debian-policy BTS]]. @@ -154,7 +154,7 @@ 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 [[http://wiki.debian.org/PolicyChangesProcess][Policy changes process]] +the current Policy document. All of the steps of [[./Process.org][Policy changes process]] 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. @@ -319,11 +319,10 @@ useful, when trying to find a place to start, to pick a manageable set 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 - PolicyChangesProcess (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). ++ 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 + 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 a problem, that the solutions that we can currently come up with are diff --git a/README.txt b/README.txt index ff48eaa..55e9b23 100644 --- a/README.txt +++ b/README.txt @@ -1,8 +1,8 @@ Debian Policy ============= -Author: Manoj Srivastava <sriva...@debian.org> -Date: 2009-09-13 00:31:16 CDT +Author: Manoj Srivastava And Russ Allbery <sriva...@debian.org> +Date: 2009-09-15 15:48:35 CDT Infrastructure @@ -26,7 +26,7 @@ Interacting with the team 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 PolicyChangesProcess. +phase, see [Policy changes process]. 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 @@ -68,6 +68,9 @@ 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. + +[Policy changes process]: Process.txt + Usual Roles ~~~~~~~~~~~~ @@ -126,7 +129,7 @@ the current state of all change proposals is tracked using the [Debian MIME support sub-policy]: http://www.debian.org/doc/packaging-manuals/mime-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 -[Policy changes process]: http://wiki.debian.org/PolicyChangesProcess +[Policy changes process]: Process.txt [debian-policy BTS]: http://bugs.debian.org/src:debian-policy Get involved @@ -179,7 +182,7 @@ help you get started. [current open bugs]: http://bugs.debian.org/src:debian-policy [debian-pol...@lists.debian.org]: mailto:debian-policy@lists.debian.org -[Policy changes process]: http://wiki.debian.org/PolicyChangesProcess +[Policy changes process]: Process.txt [debian-pol...@lists.debian.org ]: mailto:debian-policy@lists.debian.org Maintenance procedures @@ -312,11 +315,10 @@ useful, when trying to find a place to start, to pick a manageable set 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 - PolicyChangesProcess (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). ++ Proposing new language to address the bug that's seconded and approved by + the readers of the Policy list following the [Policy changes process] (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 a problem, that the solutions that we can currently come up with are @@ -339,3 +341,6 @@ One of the best ways to help out is to pick one or two bugs (checking on the Policy list first), say that you'll make resolving them a goal for the next release, and guide the discussion until the bugs can reach one of the resolution states above. + +[Policy changes process]: ./Progress.org + diff --git a/debian/rules b/debian/rules index 393c1f1..dcf5e91 100755 --- a/debian/rules +++ b/debian/rules @@ -83,7 +83,9 @@ make_directory := install -p -d -o root -g root -m 755 all build: stamp-build -stamp-build: version.ent $(sanitycheck) +stamp-build: version.ent $(sanitycheck) upgrading-checklist.html \ + upgrading-checklist.txt README.txt README.html \ + Process.txt Process.html $(MAKE) $(SGML_FILES:=.sgml.validate) \ $(SGML_FILES:=.html.tar.gz) \ $(SGML_FILES:=-1.html) \ -- 1.6.4.3 -- To UNSUBSCRIBE, email to debian-policy-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org