Re: comments vs. directives

Schimon Jehudah via Docutils-users <[email protected]> Fri, 10 Oct 2025 14:58:38 +0300
Newsgroups gmane.text.docutils.user
Message-ID <[email protected]>
R8O8bnRlci4gR29vZCBhZnRlcm5vb24uCgpJIGhhdmUganVzdCBoYWQgYSBuZXcgcmVhbGl6YXRp
b24sIGNvbnNlcXVlbnQgdG8geW91ciBtZW50aW9uIG9mIENTVi4KCk9uIEZyaSwgMTAgT2N0IDIw
MjUgMTA6MjA6NTEgLTAwMDAgKFVUQykKR3VlbnRlciBNaWxkZSB2aWEgRG9jdXRpbHMtdXNlcnMg
PGRvY3V0aWxzLXVzZXJzQGxpc3RzLnNvdXJjZWZvcmdlLm5ldD4Kd3JvdGU6Cgo+IE9uIDIwMjUt
MTAtMTAsIFNjaGltb24gSmVodWRhaCB2aWEgRG9jdXRpbHMtdXNlcnMgd3JvdGU6Cj4gCj4gPj4g
PiA+ID4+ID4+IFRoZSBwcmVhbWJsZSBbLi4uXSBsb29rcyBjb25mdXNpbmdseSBzaW1pbGFyIHRv
IAo+ID4+ID4gPiA+PiA+PiByZVN0cnVjdHVyZWR0ZXh0IGRpcmVjdGl2ZXMuICAgIAo+IAo+ID4g
VGhlbiwgZG8geW91IGltcGx5LCBieSB0aGF0IHN0YXRlbWVudCwgdGhhdCBpdCBiZSBhIHByZWZl
cmFibGUKPiA+IHByYWN0aWNlIGZvciBwcmVhbWJsZXMgdG8gZGlmZmVyIGZyb20gcmVTdHJ1Y3R1
cmVkdGV4dCBkaXJlY3RpdmVzPyAgCj4gCj4gSSB3b3VsZCBoYXZlIGNob3NlbiBhIGRpZmZlcmVu
dCBzeW50YXguCj4gCj4gSG93ZXZlciwgY29uc2lkZXJpbmcgdGhlIGFjdHVhbCBzaXR1YXRpb24s
IEkgc3VnZ2VzdCBrZWVwaW5nIHRoZQo+IGN1cnJlbnQgc3ludGF4IChtYXliZSBldmVuIHJldmVy
dGluZyB0byB1c2UgYSBzZW1pY29sb24pLgo+IAoKSSBoYXZlIGNoYW5nZWQgcHJlYW1ibGVzIGlu
IGFjY29yZGFuY2Ugd2l0aCBUaGUgQXRvbSBTeW5kaWNhdGlvbgpGb3JtYXQsIHdoaWNoIHRoZSBw
dWJsaXNoaW5nIHByb2plY3Qgc29mdHdhcmUgIlJpdmlzdGEgVm95YWdlciIKZm9jdXNlcyBhdC4K
CkFwcGx5aW5nIENTViB0YWJsZXMgdG8gcHJlYW1ibGVzIHdpdGggbXVsdGlwbGUgdmFsdWVzIHdv
dWxkIGZ1cnRoZXIKYWxsb3csIGR1ZSB0byB0aGUgYnVpbHQtaW4gImNzdiIgbW9kdWxlIG9mIFB5
dGhvbiwgdG8gaGF2ZSBhIHNpbmdsZQpmdW5jdGlvbiB0byBoYW5kbGUgZGlmZmVyZW50IHByZWFt
Ymxlcywgd2hpY2ggd291bGQgZnVydGhlciBhbGxvdyB0bwpjYXJlIGZvciBuZXcgYXR0cmlidXRl
cyBpZiBuZWVkZWQuCgouLiBhdXRob3I6CiAgIG5hbWUsdXJpCiAgIFNjaGltb24gSmVodWRhaCBa
YWNoYXJ5ICwgeG1wcDpzY2hAcGltdXguZGU/bWVzc2FnZQoKLi4gbGlua3M6CiAgIHRpdGxlLGhy
ZWYscmVsCiAgIE1ldGFsaW5rZXIub3JnIC0gV2h5IE1ldGFsaW5rPyAsIGh0dHBzOi8vbWV0YWxp
bmtlci5vcmcvd2h5Lmh0bWwgLCByZWxhdGVkCiAgIE1ldGFsaW5rZXI6IEludGVncmF0aW5nIEhU
VFAsIEZUUCBhbmQgUDJQICwgaHR0cHM6Ly90b3JyZW50ZnJlYWsuY29tL21ldGFsaW5rZXItaW50
ZWdyYXRpbmctaHR0cC1mdHAtYW5kLXAycC8gLCByZWxhdGVkCiAgIE1ldGFsaW5rIEAgUGFja2Fn
ZXMgUmVzb3VyY2VzICwgaHR0cDovL21ldGFsaW5rLnBhY2thZ2VzLnJvICwgcmVsYXRlZAogICBT
aGFyZWF6YSBXaWtpICwgaHR0cHM6Ly9zaGFyZWF6YS5zb3VyY2Vmb3JnZS5uZXQvbWVkaWF3aWtp
L01haW5fUGFnZSAsIHJlbGF0ZWQKICAgR251dGVsbGEyIERldmVsb3BlciBOZXR3b3JrICwgaHR0
cHM6Ly9nMi5kb3h1Lm9yZyAsIHJlbGF0ZWQKCkluc3RlYWQgb2Ygc3BsaXRpbmcgYW5kIGNvdW50
aW5nIGFuZCBndWVzc2luZyBvZiB0eXBlcyBvZiB2YWx1ZXMgb2YKdGhvc2UgcHJlYW1ibGVzLCB0
aG9zZSBjb3VsZCBiZSBoYW5kbGVkIGJ5IHRoaXMgc2hvcnRlciBjb2RlLgoKaW1wb3J0IGNzdgps
aW5lcyA9IGNzdl9zdHJpbmcuc3RyaXAoKS5zcGxpdCgnXG4nKQpmb3IgaSBpbiBjc3YuRGljdFJl
YWRlcihsaW5lcyk6IGkKClRob3VnaCwgSSB3b3VsZCBsYXRlciBzb2x2ZSBob3cgdG8gcmV0YWlu
IHZhbHVlcyB0aGF0CmluY2x1ZGUgY29tbWFzLiAiUXVvdGF0aW9uIG1hcmtzIiBkbyBub3Qgc29s
dmUgdGhpcy4KCk5ldmVydGhlbGVzcywgaW5jb3Jwb3JhdGluZyBDU1YgaXMgc2lnbmlmaWNhbnRs
eSBiZXR0ZXIuCgo+IEfDvG50ZXIKPiAKClNjaGltb24KCgpfX19fX19fX19fX19fX19fX19fX19f
X19fX19fX19fX19fX19fX19fX19fX19fXwpEb2N1dGlscy11c2VycyBtYWlsaW5nIGxpc3QKRG9j
dXRpbHMtdXNlcnNAbGlzdHMuc291cmNlZm9yZ2UubmV0Cmh0dHBzOi8vbGlzdHMuc291cmNlZm9y
Z2UubmV0L2xpc3RzL2xpc3RpbmZvL2RvY3V0aWxzLXVzZXJzCgpQbGVhc2UgdXNlICJSZXBseSBB
bGwiIHRvIHJlcGx5IHRvIHRoZSBsaXN0Lgo=