From 8b5c10a61f6339d2a516e4d8d477cba96480e6c2 Mon Sep 17 00:00:00 2001 From: Alessandro Coglio Date: Fri, 29 Apr 2022 21:58:34 -0700 Subject: [PATCH] [ABNF] Improve doc comment. Given that the Leo Reference explains well that the format string grammar applies to the character sequence after processing escapes, we do not need to say this here. Instead, we just explain the rule similarly to what we do for others. --- docs/grammar/README.md | Bin 50394 -> 24171 bytes docs/grammar/abnf-grammar.txt | 3 +-- 2 files changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/grammar/README.md b/docs/grammar/README.md index 44c9f6b666d7ee4b10f5a30ff6b5e73782dda80b..63e83b52af3799be6169febf38d336709d59473b 100644 GIT binary patch literal 24171 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 VY2gK^YRH7A27WaYMjCBw{69Uk(!Kxy literal 50394 zcmeHQ`Ey)H5q>{Y#s9D@6^KpbE5y#>gmRqNP!%ABok|5K6(m_Q0_#9WVh8xwf&Qk| znVC1o*RzrmB}HvXyZd(fo1VU==X&qI|G7WyPY2V>>2TVao=tz9j;F=+>U4j)BJa1R z8`I6{t!XWMx+VV?)4l2Wv?Vl)>5)(!N%^g5SKb%X@20(JbGkPDbo$BkSdezY)opnP z#p3k)!L%-Qp_ct=TmBzQN&NcJDe7}6w;?4^>g6e#A-2mI`nFJQ1-zqxe>{C1khZ3` zrH+?!?L^);<=URSqwLeb*Rgy?y(ghPKm&&;^>n%}REP3ySKd*2TX4XUmN^M!wn7PO z3uJP5DwVvI52rs&p9t1NDX|wyt&4OP)5lWthJ4x)-XIISqr{Q?2Op5{!MA0Og3O-E zwT)9=tmX$&ueSfuto@7WL1;Z%v@WgNk#Bp`Yl5*AS^_Pgm0yMTqto9P)9Z3AZ$r)< z5Fj5&Z{Sz$6n4KS6p#_5j{1K;eJJSnrDm<+-t@k3@=@Rh z^{aJ02;cu8Wgp24+WwSg}iCq0y$~_XQYf|o!@M1FB3U#k$ zuiK|Q!DC>L3u)n&v}!%b`Y7@0&!hxA5*Ce5&x0(WA=sgMC_G^&e21LYLowjvWE9wOMD&>ja*g5`kgyV9Ctc^yc*-j?`rT~P75CN=Cy zE3XN~p?tm`^dCL_NUpq>NC&*F&0e@>f8gwe$OiEYQRJbZu8Upm%7699Id%TsaPCTZ zv;(wT)4S7BJ{<|_j=Yw_(OuzdUEWdtFX6Q=Ua@y-pRw#hXcyBf!qW}m`i|IOq-fW5 zB-qkH|telG2U#~z9%5m69#(dQn^_gL~u@a!j2 zvSpAb>pw( z4ZRn#n6==)uv^YiNfY@%UlsZINIWZzIc+`=|6r**^8PIFgI?!2*zcZ$r#^k;?}LoL z`_g;*_&buG0N$|W;3bxg^&&o{l6fS(wy)-=Vl|psLQDUU&*-Z>e6%Q2u5Kk#Jk~9hYtPBDPsNT5#~M2`*IEaAd6mR^_m|e zbJW(NchC&-YNb78glor|i;YrqsjP*l1-YV+LUzX^1IOU9z9pG#?BQPzy|hREh%M@2 z{6C^(PfwPSU;ja9tc=H|yM9#k>vPo_a&4!X8@%d%qUR5tUN)lTz8&;!;I53Z(07?7 z+!b!?eZ}ST;8xr>tJo0R-<Z%uDrYR&)h2cr2HnRT4D8?p|JDKX~Y5x!5a8jNKy z#@D$njKKT7i+VXLQ(_~+vr%9lmE}o&Y8x$ufSkCE@14SDp@tAk0cM_cNm#v!Yr-#)7&%8lX0k{xCHJgvT7gZaXBi8`Z}oZGd1gMBZD zqgb80^W$i4;WoC3^Hdk@gJq4(7CF!3_FtDXMA5&$C{Wmsg%&kzNmL#8{_Po51&)mm&&i=?$q7E0(OB ztpxINSh3SpP^@S4YuEKX^ws{7x)Xzy-;y?A6_J(0J}8uh%=^6R?g?HBJCCr!sylgD z`DdajtOXs=`gde@g`w@pOx$fpsn=yigk#;Fe(flAQ?NXoZ9A~AD%jTo)|t4q#64M? z6cL^h*ChM3pEz22;?lv1%#v~)oQO8L4p3v%K|aq?MjF`KfwcKB%=N%WFuH^cbR5p( zC_}Jl^g?*QDd=xZ=?d~ax$@_rWyY!QcsL8E3?XuQJ8*g@<8)m({l>}Zi2PD%D+gSn zI;VpjAZ>ZTc5|7Q>ljQTEZ1Q4mh-R{v3eN2C%?z89PF0bl|B)>Gq8K-nfxJsu-#K_ z+GsPnj`@1ny@dQ4>ke3Le#>PunES!%_9$m{x{|AO)m`^}mG)6a2kbX}5psytWydj; z+n$VdoU$&O(%G}d3Hl@cpb=Mg7HDT{EvJlVQ zevL|{nMakYvXct4z%eeVT-rRF+`bGlyi)ClZ4{}tZhIg!Kh`~<^Sl)Kto~w|=9X9& zcHAPH)*eT9Nm@zpyf4xCT6mQA6SgXkJ^Y`(OfgXrddsXO>>z1nq@2t zInhu`pww~B8PjrJ+N0;QNw-JMB&&ISDjmz>^J}GKcTTgzyxe7zY#d>YTWy=RE>*S6 zNTs6*)&u0$a{jh;AkhP7R8B&Vzb0O6W4>{T__2BtiX2=H3FUpmxK#S|Dhag>oG3bx z7;1TfSq!3koG-{Nri{n=9LqSrefpGN@TL7BIDSLMpW3hYM*zv>Xz-aS)aIP ze7vn3L)+Whi-J7~^PTH+F4jawkdv**VwZe*Qd?EmiynJ>6owjKVjs7+VmV4W=CqgZ%G-<`eG*KEH%Xw4HsJv z@;{tNLOl=5dooYyft<+l|n zbDge|i6P%>MU(SEXVGF+u9?TLiaX+^tJdN7tyOFAdjx98eYNc2nGRWh#po?(8<9P$ za|Fxk_jv-V*@t3v`fY*L>qoM>nGdlV8NJoxw?MCktHC!U*xHTZ@hFP~Jq$J` z>G8m1-=j_S-7ClHU~=;46WQ)=&?Qzc#`W2!SAF(%?$u`8buj1Bi{M||_e9e+KTL0J zO0$f<#29{`+UoF2gVpCp@>ryv!^fHYRqU}xt=8DLSZ+&*EdBiuK8*ez1s_Ij`)y(N)2B9j?aQ3i(WkaLxI9@s9Kq`9+aar`Pi=Md^vY`J(R%#&NX}c~ zzK(kOiS6r5ORJwQr=NwT&yOf_|lg@gyntMW>vO=anlP zsn;a>T7q{i`<#AzC;8>=!WC3RixO0u_4OXiWOTwlXIU9e{w z>v7BmV_CJpe6RJKFG#JnTfA1T*DKY^NAJe|v|5SOU+{Y_hjMseJp9THNF{2ji%HCTA$w!dM$VuuH)~K^jjF?>Yhwwq2qU$2EO5y zF{vE4;m+sS>Bg;~O{+Gcaq^;06QE6bq$yjMk7)fZtJ9^ex~QG}o>tArRQ`6gD79rh zeZr^fQYkquBYvHd`B0t8yt2(L!);TR9$MN|I%4)qzDAYWQ~ceROT=CMxD&P4V{23? z7x8x=7r0-qK4k&@22QtOob2bPPp_P{Z5B2eqxr*@n%z>QSeh zSven1y2BB7e#XqWpPM?J@=?w;8LoO9^Je&KF5k$RB3K*KGbmPv$9G%k%r{ze=5zg) zar9o4v^vZS^vrCO3`1|x8E#Le47*3`i5sRn?gds-Ev;^a9t)^bvUb*~JS|KkHAWtK zPaniuj8r{YG(%8{;3U`+`CE!NV~*kr`O8O%IOnBaw47SAKsKk5=gnolmLoIi<)uAR z!`=JPXX=wHQVHZU#@ueaNGippoT!8J(i&@8gPe7qiI?=v29+{q$V}>t-lK<6Y3Jot zro9;%>lb|5_V~9~-%NU59E+m8R`R+qr%+!-@@Og5bglvJA8lIIo`1dU$D>Pso0(?) zNFF@{P48fX=PqIg(+io2vAet3J;vC~u?IzUUz_uU59YJ(t#8QYa%&u;wOCwhCE{;= zO`*pPo*0 zcm!+HwyhZR0&`nH4*%?QhY99X^@(lFDm*w$ULFk7L`_Q!zecl~R!SMIqMs5)HDw-; zJhtXJ*#C+=*K)6V8DzPd32TOiOc;MLVlbW7aG8v2G#(kl3L%fx<2gf!{W$A8eDN7^ z-PXHV-6M!PZt);8{dsygrcV!s`6T0+)y3#NcBJ-)`>kUA7&EQt*;dUFM$pv0SQ~tn zkoMlNGlmLF)Ex>IF?+-!t6^vJA0LkT%y>&iJO|$5 z<;Lb5FB3^9r9_m?ip9tj8E{39Ek`(c=j^2aYotnBm14I*m!AGZ{V{^#q?J zFV6aP@8MF0!#p{ouSLx3d?+4I+X~N<#z+AD&gx@KAC7vO z&nrhg&4-HdfbFREQCu7!x|ds@FN^!E^`o7~x_m8S*5yO-SQl2t_NKojGihfT7mT3U zhyYJZXVyKU;W!Ey<0kI;_j!s(+anw>osVEyHsNattJ#O*u{PYX|LEMTZ3IoNZA6Bv z+1waUcCtkGQhWXIhhTXla$xp1g5|NojgYgRZN`>ksKt%&?$PTA-ghlm^)7IT@iF?9 zv&>(PpsB36PFC}2j*FZHr;cm}Gam)vS3RFp8zXtN&N*PZ<_NLRC|9HzdaYd^Ppr}L z)u#VrQEnxBLdPM_&mS z$cxwI>?O_&;ki6`){O2;)wyQGf*yv-M!Cbv$LbiR?#nj!IKlIf_GL%Ls1$I25g*xR z>wi4Pw#`KcMi*A zK5`2?NuAGUm#3PT{5WR}LHX6)vT4~~W`tARo`_ZJ^_d21G#+hvHP0pHMM@=y=#P62 z*Ux*$Y%=br$BfzKlJRT8{S(OwkPGNu20cG@DEoL`oqjHJK6p9{&aG%HMz*1`u0~^? zZ7pUPR?eeq>vdU_5Q@w%Lw#UT??ul%% zG_&hi(j-)ia15nJ+PB0-k#ZKOPViX9lae1n1BBv+?0TdwiK5Nk9ZJ=8hjTBy^dHk+1Ei`5gt zHLruU+Nm@q@ftmoPL0MRom8sxvqoG-J?d0auvR?F7X6f-1=ZXH`O!1E=ILqDy2?{R zW4xC1%B`I;La!6|ZP=d zGNVlKO9UpZK6Nc(&D$_i!<^Qmk2y_i6^rZ0iYdq-q+C3$hlpx--L!mqoQF8Z@K{$h3=Ly>-1=*hQu^cqq#^As_%>7I;zvPJfvRQBg4`% z>sU;#UL2p5?}XhDTuNA9!pfP-__E%A z{{D{q0zZdspr_aQE!_F$SYBIl9e%wh|I_>yb3WVQ_e1#wl*m0ns~8w{przPF0}QMm zVyuK~2ST@yHE`XBzmWBA@Rw_`l%mens@`v@~K9qll5`e~QJOUB(zSLYwEuHFlMin8x?N&qdbx^VhiN^`x9*DW9dM_PlNG zefSP9?$uga_j%V)v&ZwUqps`HD$8+ZUp6%h;yoJXL|U<=hG=<2pBLnz@^-g~v{dAYxrwu&p(|JysR+28NP9*|w5zk7H( zs)p4ah7v|mz8ihn3!;Bh#CW$+E`=JEwtplix3WyjR?ef_l(X7g>R8)q2-?nkE)nw0 z^Nlj<M;q8U>nV-?s2x}*f}OjWfAFA|4Z4QhjDmKmeBMU^5?Pp8a