wishes for next Lout version (documentation)

[basile . starynkevitch]

I have a few wishes for the next Lout expert guide release...

--------------------
1) an appendix or section giving all (or most) Lout error messages,
and common hints to avoid (or correct) them.

--------------------
2) a detailed explaination (in Expert Guide chapter 4) of

   how indexes work
     (and how to add a new index-like feature to dl)

   how tables of contents work
     (and how to add a new table-of-contents-like feature to dl)

   how numbered displays work
     (and how to add a new numbered-display-like feature to dl)
     -numbered displays seems to use galleys within galleys and I
     can't follow exactly what  @BeginNumberedPlace,
     @EndNumberedPlace,  @NextNumberPlace are for.

Perhaps such explanations could be illustrated with 
   how to add numbered theorems to Lout dl - each theorem is tagged,
   has a title and a body.
   with a table of theorems (by order of apparence, and with their
   title, page and number)
   with an index of theorems (by alphabetical order of their tag)

I don't want a full theorem feature in dl, but I would like to be able
to add one. I'm trying to, but with pain!

--------------------
3) a list of lout programming clichés (ie code patterns) - with
cross-referencing elsewhere in the Expert guide.


==================================================

I tried to make a toy example with chunks (much like theorems
above). I want them to be numbered by Lout (like
@NumberedDisplay-s). So I hacked the toylayout (see below my
uuencoded gnuzipped try.lt self-contained Lout file). But I couldn't
see numbers on my paper, and I'm still getting a

%  lout try.lt -o try.ps
lout file "try":
   210,1: no @EndChunkPlace precedes this @EndChunkPlace&&preceding  


begin 644 try.lt.gz
M'XL(" 5'^B\" W1R>2YL= #E6.MSVD80_^S[*S;.#$D<(\"/29.93E6P6[NE
MA*F=9OKQ$ =2$7<:Z< PF/^]NZ?3$QP[K;^D)>,@;A^WC]_NWNDE-(^:$,BQ
MD%J,FUJL-*VPEP"36,VAKQ8:W%NU[O,U/4;<F_&address@hidden>_B,address@hidden'N
MS3JYEEZX& O8P$1)/1:3!+8U0LCEU!+P"Q4GFL\C)-P&<]$T/S[ 8>?]^_-F
M^UVS?>ZTWWTX/?W0;L.GVQY\#R.>!*%PD#%>RYE8!MKS74]P9Q(?HDXF5I&*
MT>!K<address@hidden"]$GR,1H(['(+;Q[\+_!L,@4'Z<?MBHB^") KY&L5L'/*%'OV,
M\X5<ZI;BY%XH;S%'#N3S%W*6=,4TD/9'MG8IQYD4LSYGP33KDL_%&,W#H'X.
MQMH'#,9)QVE[Z$Z-?B6"J:^)_MYY1W37;,@,W\OG^Z3ZX+D^N;address@hidden@!
MD1R#GV8&G[@<(ZYB/HUYY"?.D_4]KWW/&#^CT.3ZVNX1F\RM,'<WH8H$N"86
MJY2X+?B[._Q=%8ZK[&address@hidden<6<2!BZ/)$0//$.8^VN?RV9-I%=T<4KD2X
M%#KP. QX'*L[:)Y%L%\\*ZQ"'!,X):AV8\%GY$HN,.=>K$P)VL\&6JV.<[I<
M 2(=E2'R!33:@77-\O?W\-<^%?Z+"G_;.5_"%_D'-?V=T1[^;Z:Z;(MZO'[^
address@hidden<address@hidden'6>;5D3/F1N-*!:>,.C=L@,+8".U80?N1RE^
M1^2G"U4 EV=%"AO"W'TV% IS:(U(K98UHH:\^IRQBDXF7ZNH-I\R18A]G(*/
M*OIFL$W3#\\.-#2=_PFVZ83Q)6R;$\A$Q<B0(3P7J2(<JC,B WH%X$:EB7*%
MZZ!T+DF;=/address@hidden(#V]).G Z)_G ( H?_[5(-$CEKR-?2.B<12NBFQG!
M#B[E- P2U-W'0\&"MM] V_Q#GANA>RK$:4:address@hidden /?WG8 =F"*YNEQ%=')P
M_[ /JY1 +(:9'6SWNM@/T*+43;F8YW4_3+>WM=,D&OY/<^0L**<#6T:K9?F-
M*G= J<A45?I/=C[<E';N9"S?0-W="#J7:8&address@hidden/KP
MI'34ZPZ/address@hidden:"2,<$6LVT.Q^TY2DLE%\&:P*W#Y!0'"V:[$8)_$'J&\
M3535-!H3%8;JSO0*V)!*9]!SRKX9YFK54,EDV6BU3I:K_-=]A^Y?)F3](\/:
MJ&]9DBPKK]>1N3+M2TP/_<R]J2=LM_>5+<7B]HQU;WO=WML*X=0K&]/9)]1$
MH6:%<.;5\KCGU%"^&address@hidden:!XO$EZZ2M8Y?V;KD>9;(WN5N(JNP1NSL
MQ;-AW0WTP^/%WE-O^10V^6)V.:CF(3MB61M[#FQN/%^I<*34S%Z0JA>7[4-A
MA4V6!3S;.*BI[".V\N^HEQ?P,_([M9IEN/ 9]TOA1Q$NW]B9'=/NI\3$L'@Q
address@hidden _V#8&]H.^<T_+K$]OH>$T/(2GA*/*;(AV-AL0(N1\C(3%,*''8
M.D22U#X]_"EX?(Q*<#@>^K@>R(466XP/WK'8%6X$00+:%V#?J-CW+(;\V>?Z
M50(address@hidden@*.(-23!_<&\!_)1T3&,!&).&&UXW2R#>9$(AWPKEAB[]6EG
MDL9O,_OY!#VOB3KIQE5NCC;=%2\"'address@hidden'79- DB!/-E!1O
M7F2&(,R,5AL PX%S2U+1E%;,0'/@1D&0;AXFJD0NK#"&EC4FPE/E%Q:@)KMZ
MAR+V>93 ]2M$TTAH# '#^*(#HP!OR7%)G**,OL)8R5<:9I1V%>>_/<J,CVO&
M3(;'IC!<(UC4C'*E4I<B'HG88=NOB&J:E<+N/*YXDF)JM S4(L&-2LFW?F.P
M7Z!U/A6IIHWN G1QSF<((address@hidden"-8LZ7 - ;:*7(%[)%LV5T?2A>K
MI2M+1E4L-^".8S<Q5A<26J$2="$12Q'ST.R>.$]PL1)45G/Q:^6MA>Q?RIO]
M&<E#&0P/0?<)0486RMB>$.YHPSGQ2"39 Y[45>W!S*X:/N5HW#]4QFK1U?%"
M(,,3M.&MV19:%EH.R9RF1A&)4N/;address@hidden<address@hidden'S&address@hidden;Y$
M3HG- 0<'C]=%A0$?*:2EA97GO""GTUHDU1Y.DRV02^5Q'2B9QS?M,T*JQ=0O
=NCN]Q=ZKVR(address@hidden:6C4QL/^QO;61H!UT8  "0
 
end

-- 

----------------------------------------------------------------------
Basile STARYNKEVITCH   ----  Commissariat a l Energie Atomique (civil)
DRN/DMT/SERMA * C.E. Saclay bat.470 * 91191 GIF/YVETTE CEDEX * France
fax: (33) 1- 69.08.85.68; phone: (33) 1- 69.08.40.66; homephone: (33) 1- 
46.65.45.53
email: address@hidden (redirected to address@hidden);  
----------------------------------------------------------------------

N.B. Any opinions expressed here are solely mine, and not of my organization.
N.B. Les opinions exprimees ici me sont personnelles et n engagent pas le CEA.

Please cite a **small pertinent part** of my mail in all answers
Veuillez citer une **petite partie pertinente** de mon courrier dans vos 
reponses