Groups > linux.debian.maint.python > #13234

Ported Python Policy to Sphinx

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> (permalink)
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

Show key headers only | View raw

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

Back to linux.debian.maint.python | Previous | Next — Next in thread | Find similar | Unroll thread

Thread

Ported Python Policy to Sphinx Stefano Rivera <stefanor@debian.org> - 2021-02-26 00:00 +0100
  Re: Ported Python Policy to Sphinx Dmitry Shachnev <mitya57@debian.org> - 2021-02-26 09:40 +0100
    Re: Ported Python Policy to Sphinx Stefano Rivera <stefanor@debian.org> - 2021-02-26 19:20 +0100
      Re: Ported Python Policy to Sphinx Dmitry Shachnev <mitya57@debian.org> - 2021-02-26 20:20 +0100
        Re: Ported Python Policy to Sphinx Stefano Rivera <stefanor@debian.org> - 2021-02-28 00:40 +0100

csiph-web