Path: csiph.com!news.mixmin.net!aioe.org!bofh.it!news.nic.it!robomod
From: Stefano Rivera <stefanor@debian.org>
Newsgroups: linux.debian.maint.python
Subject: Ported Python Policy to Sphinx
Date: Fri, 26 Feb 2021 00:00:03 +0100
Message-ID: <BMxLZ-tn-5@gated-at.bofh.it>
X-Mailbox-Line: From debian-python-request@lists.debian.org  Thu Feb 25 22:59:00 2021
Old-Return-Path: <stefano@rivera.za.net>
X-Amavis-Spam-Status: No, score=-6.852 tagged_above=-10000 required=5.3 tests=[BAYES_00=-2, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, HEADER_FROM_DIFFERENT_DOMAINS=0.249, LDO_WHITELIST=-5] autolearn=ham autolearn_force=no
X-Policyd-Weight: NOT_IN_SBL_XBL_SPAMHAUS=-1.5 CL_IP_EQ_FROM_MX=-3.1; rate: -4.6
Dkim-Signature: v=1; a=ed25519-sha256; c=relaxed/simple; d=debian.org; i=@debian.org; q=dns/txt; s=satie-ed25519.stefanor.user; t=1614293921; h=date : from : to : subject : message-id : mime-version : content-type : from; bh=xoconnH31JWU6+ejzye54B8bitageXGzFL0d6SU6IRs=; b=KUGZQkc2aHZiVtq0ubyY5wHPOvK/Wxbzaj+D03MQAzTscLPJEJJc6RNLQnaU2ZjPS0cI/ aW5U4gmY+d2kRtcBQ==
Dkim-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=debian.org; i=@debian.org; q=dns/txt; s=satie-rsa.stefanor.user; t=1614293921; h=date : from : to : subject : message-id : mime-version : content-type : from; bh=xoconnH31JWU6+ejzye54B8bitageXGzFL0d6SU6IRs=; b=FkxL97swOmg9/Z4twWxe0DO7wckBI6C5Zy/7/oqb8TzbTKttGibwtef8VHPskIU+XO9AV mEllTf/KinERmxIViWZhG4IsVRFR9BxgH79RRKSM7oF89sd0vFLb3YZwPTGotq2uBaQfaIF mBALoZu4PY+PWc0nQY9WETLyS0cLSyOnJ0XT3RkdR3iPm8ET0IpWPDveG4oU43fLlrvEVi4 8QkUIKNYmJKOCcBqv5jXJw40q/tCUGaBG0qHA9XfY9y3q4c3+MXV+mya+wlhm4zfmT4fKWJ 75LtT0EAUbPi/JtEVy5Qkjm2YlfSoOgj13b9Q+KioRTm+EO/tr1hl4EHMC7g==
Mail-Followup-To: debian-python <debian-python@lists.debian.org>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
X-Gpg-Public-Key: http://www.rivera.za.net/stefano.gpg
User-Agent: NeoMutt/20180716
X-Mailing-List: <debian-python@lists.debian.org> archive/latest/19018
List-ID: <debian-python.lists.debian.org>
List-URL: <https://lists.debian.org/debian-python/>
List-Archive: https://lists.debian.org/msgid-search/20210225225841.ji33shs5affgoidc@satie.tumbleweed.org.za
Approved: robomod@news.nic.it
Lines: 25
Organization: linux.* mail to news gateway
Sender: robomod@news.nic.it
X-Original-Date: Thu, 25 Feb 2021 22:58:41 +0000
X-Original-Message-ID: <20210225225841.ji33shs5affgoidc@satie.tumbleweed.org.za>
Xref: csiph.com linux.debian.maint.python:13234

Hacking on the docbook Python Policy is no fun.

I ported the current version to sphinx.

MR: https://salsa.debian.org/cpython-team/python3-defaults/-/merge_requests/10

Render: https://people.debian.org/~stefanor/python-policy-sphinx/

I'd appreciate it if anyone who has the time would give it a proof-read.

There are definitely sections that could use garbage collection and/or
re-writes for clarity, but the intention of this MR is to just port to
Sphinx without content changes.

There's no direct equivalent in RST for
<literal>python3.<replaceable>Y</replaceable></literal>, the best is
``python3.Y``.
Similarly, I replaced 3<replaceable>Y+1</replaceable> with ``3.(Y+1)``.

SR

-- 
Stefano Rivera
  http://tumbleweed.org.za/
  +1 415 683 3272