Message 298112 - Python tracker (original) (raw)

Message298112

Author	jaraco
Recipients	abarry, ezio.melotti, gvanrossum, jaraco, jayvdb, martin.panter, python-dev, r.david.murray, serhiy.storchaka, terry.reedy, vstinner, yan12125, ztane
Date	2017-07-11.03:39:49
SpamBayes Score	-1.0
Marked as misclassified	Yes
Message-id	1499744389.65.0.0807228798242.issue27364@psf.upfronthosting.co.za
In-reply-to

Content
One consequence of this change is that now any string that has a backslash needs to be escaped or raw, leading to changes like this on (https://github.com/cherrypy/cherrypy/pull/1610/commits/1d8c03ea8c5fe90f29bbea267300b97c78391c24#diff-be33a4f55d59dfc70fc6452482f3a7a4) where the diagram in the docstring is the culprit. An escaped backslash is not viable in this case, so a raw string is required. This particular example strikes me as counter-intuitive, though maybe I just need to adjust my intuition. Was the intention for a docstring like above to use raw strings?

Content

One consequence of this change is that now any string that has a backslash needs to be escaped or raw, leading to changes like this on (https://github.com/cherrypy/cherrypy/pull/1610/commits/1d8c03ea8c5fe90f29bbea267300b97c78391c24#diff-be33a4f55d59dfc70fc6452482f3a7a4) where the diagram in the docstring is the culprit. An escaped backslash is not viable in this case, so a raw string is required. This particular example strikes me as counter-intuitive, though maybe I just need to adjust my intuition. Was the intention for a docstring like above to use raw strings?

History
Date	User	Action	Args
2017-07-11 03:39:49	jaraco	set	recipients: + jaraco, gvanrossum, terry.reedy, vstinner, ezio.melotti, r.david.murray, python-dev, martin.panter, serhiy.storchaka, ztane, jayvdb, yan12125, abarry
2017-07-11 03:39:49	jaraco	set	messageid: 1499744389.65.0.0807228798242.issue27364@psf.upfronthosting.co.za
2017-07-11 03:39:49	jaraco	link	issue27364 messages
2017-07-11 03:39:49	jaraco	create