[tex-eplain] emulating a \description environment

[Guy Worthington]

This is a multi-part message in MIME format.

------=_NextPart_000_0005_01C0A23E.902E4F40
Content-Type: text/plain;
	charset="iso-8859-1"
Content-Transfer-Encoding: 7bit

Finally got a \description environment that gives a satisfactory
output.  It's not pretty code, in particular I'd like to get rid of
the need to adjust two dimensions: \dimen0 in the \Annotation macro,
and \listleftindent in the \Description macro, especially since one
adds what the other removes.  I'd also like to remove the \hang macro
but can't seem to get rid of paragraph indentation any other way.

------------------------------------------------------------
\input eplain
\def\debug{\immediate\write-1}
\hsize=30pc  \vsize=50pc \parindent=3pc
\font\KeywordFont=cmsltt10

\def\Token#1{{\tt#1}}
\def\Key#1{{\KeywordFont#1}}   % Keyword Font

\def\Annotation#1&{%
   \hang
   \dimen0 = \listleftindent \advance\dimen0 by 2\parindent
   \llap{\hbox to \dimen0{#1\hss}}\ignorespaces}

% parameter #1 is a template for the widest annotation
\def\Description#1{\environment{AnnotatedParagraph}%
   % indent left margin by width(template) - 2 parindent + 1em
  \setbox0 = \hbox{#1}
  \advance\listleftindent by \wd0 
  \advance\listleftindent by -2\parindent
  \advance\listleftindent by 1em
  \def\li{\leavevmode\Annotation}% starts a new paragraph
  \beginlist}                                 

\def\endDescription{%
  \par
  \endenvironment{AnnotatedParagraph}
  \endlist}

\Description{\Token{wait(\Key{long} timeout)}}

\li{\bf Method} & {\bf Description}

\vskip1\jot

\li\Token{wait()} & There are three overloaded versions of this method.
This version has no parameters and suspends the current thread until
the \Token{notify()} method for the object to which the \Token{wait()}
belongs, is called.  Note that when \Token{wait()} is called, it
release the synchronization lock on the object, so another method or
code block synchronized on the same object can be called.  This will
allow other threads to call \Token{wait()} for the same object.

\li & \indent Since all version of the \Token{wait()} method can throw 
an \Token{InteruptedException}, you must call it in a try block with a
catch block for this exception, or indicate that the method calling it
throws this exception.

\vskip1\jot

\li\Token{wait(\Key{long} timeout)} & This version suspends the
current thread until the number of milliseconds specified by the
argument has expired, or until the \Token{notify()} method for the
object to which the \Token{wait()} method belongs is called, if that
occurs sooner.

\vskip1\jot

\li\vtop to 0pt{\hbox{\Token{wait(\Key{long} timeout,}}
             \hbox{\Token{\Key{int} nanos)}}\vss} & This version works
in the same way as the previous version, except that the time interval
is specified by two arguments, the first in milliseconds and the
second in nanoseconds.

\vskip1\jot

\li\Token{notify()} & This will restart the thread that has called the
\Token{wait()} method for the object to which the \Token{notify()} method
belongs.  If no threads are waiting, the method does nothing.

\vskip1\jot

\li\Token{notifyAll()} & This will restart all threads that have called
the \Token{wait()} for the objects to which the \Token{notifyAll()} method
belongs.

\endDescription

\bye
------------------------------------------------------------

------=_NextPart_000_0005_01C0A23E.902E4F40
Content-Type: application/octet-stream;
	name="annot6.dvi"
Content-Transfer-Encoding: base64
Content-Disposition: attachment;
	filename="annot6.dvi"

9wIBg5LAHDsAAAAAA+gbIFRlWCBvdXRwdXQgMjAwMS4wMy4wMToxMDI0iwAAAAEAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD/////jZ/yAACOoAJYAACNoP2yAACNjY3zFxryIlYA
CgAAAAoAAAAGY21ieDEwwk1ldGhvkFHHZI6OkWh/y0Rlc2NyaXB0aW9ujqkPAACNjY3zHd/qPHgA
CgAAAAoAAAAGY210dDEwyHdhaXQoKY6OkWh/y/MAS/FgeQAKAAAACgAAAAVjbXIxMKtUaGVyZZYD
7jthcmWTdGhyZWWTb5W443aTZXJsb2FkZWSbA+47dpNlcnNpb25zmG9mmHRoaXOYbWV0aG+QRx1k
LpEGPHpUaGlzjqQMAACNkWh/y3aauONlcnNpb26WAtjmaGFzk25vk3BhcmFtZXRlcnOTYW5kk3N1
c3CQRx1lbmRzk3RoZZNjdXJyZW6YdJN0aHJlYWSOoY2RaH/LdW6auON0aWyWBQvgdGhlk8hub3Rp
ZnkoKZOrbWV0aG+QRx1kk2ZvcpN0aGWTb2KRAI44amVjdJN0b5N3aGljmGiTdGhljqGNkWh/y8h3
YWl0KCmWArt8q2KQRx1lbG9uZ3MskQLaQWlzk2NhbGxlZC6RBD5/Tm90ZZN0aGF0k3doZW6TyHdh
aXQoKZOraXOTY2FsbGVkLI6hjZFof8tpdJYCmq1yZWxlYXNlk3RoZZNzeW5jmrjjaHJvbml6YXRp
b26TbG+QRx1jmGuTb26TdGhlk29ikQCOOGplY3QskQLAAnNvk2Fub3RoZXKOoY2RaH/LbWV0aG+a
Rx1klgLwNW9yk2NvmGRlk2Jsb5hjmrjja5NzeW5jmGhyb25pemVkk29uk3RoZZNzYW1lk29ikQCO
OGplY3STY2FujqGNkWh/y2KQRx1llgOUwWNhbGxlZC6RBTAMVGhpc5N3aWxsk2FsbG+QuON3k290
aGVyk3RocmVhZHOTdG+TY2FsbJPId2FpdCgpk6tmb3KOoY2RaH/LdGhllgNVVXNhbWWTb2KRAI44
amVjdC6OoY2SAIx/y1NpbmNllgOXImFsbJN2mrjjZXJzaW9uk29mk3RoZZPId2FpdCgpk6ttZXRo
b5BHHWSTY2Fuk3Rocm+Yd46hjZFof8thbpYDy8PISW50ZXJ1cHRlZEV4Y2VwdGlvbqsskQPpXnma
uONvdZNtmHVzdJNjYWxsk2l0k2luk2GTdHJ5k2Jsb5BHHWOYa46hjZFof8t3aXRolgOyTmGTY2F0
Y5q442iTYmxvkEcdY5hrk2ZvcpN0aGlzk2V4Y2VwdGlvbiyRA8mMb3KTaW5kaWNhdGWTdGhhdJN0
aGWOoY2RaH/LbWV0aG+QRx1klgNVVWNhbGxpbmeTaXSTdGhyb5C443dzk3RoaXOTZXhjZXB0aW9u
Lo6mjY2NyHdhaXQo8yDf6jx4AAoAAAAKAAAACGNtc2x0dDEwy2xvbmeRBT/9yHRpbWVvdXQpjo6R
aH/Lq1RoaXOWBIcgdpq442Vyc2lvbpNzdXNwkEcdZW5kc5N0aGWTY3VycmVumHSTdGhyZWFkk3Vu
mHRpbJN0aGWTbph1bS2OoY2RaH/LYppHHWVylgOZym9mk21pbGxpc2Vjb25kc5NzcJhlY2kMZWST
Ypq443mTdGhlk2FyZ3VtZW6YdJNoYXOTZXhwaXJlZCyOoY2RaH/Lb3KWA6ZsdW6auON0aWyTdGhl
k8hub3RpZnkoKZOrbWV0aG+QRx1kk2ZvcpN0aGWTb2KRAI44amVjdJN0b5N3aGljmGiTdGhljqGN
kWh/y8h3YWl0KCmWA1VVq21ldGhvmkcdZJNimGVsb25nc5Npc5NjYWxsZWQsk2lmk3RoYXSTb5hj
Y3Vyc5Nzb5hvbmVyLo6mjY2NjY3Id2FpdCjLbG9uZ5EFP/3IdGltZW91dCyOoY3LaW50kQU//chu
YW5vcymOjo6OkWh/y6tUaGlzlgKqrXaauONlcnNpb26Td5hvcmtzk2luk3RoZZNzYW1lk3eYYZh5
k2Fzk3RoZZNwcmV2aW91c5N2mGVyc2lvbiyOoY2RaH/LZXhjZXB0lgLHH3RoYXSTdGhlk3RpbWWT
aW6auON0ZXJ2kf9xx2Fsk2lzk3NwkEcdZWNpDGVkk2KYeZN0mHeYb5Nhcmd1bWVumHRzLI6hjZFo
f8t0aGWWA1VVDHJzdJNpbpNtaWxsaXNlY29uZHOTYW5kk3RoZZNzZWNvbmSTaW6TbmFub3NlY29u
ZHMujqaNjY3Ibm90aWZ5KCmOjpFof8urVGhpc5YFG613aWxsk3Jlc3RhcnSTdGhlk3RocmVhZJN0
aGF0k2hhc5NjYWxsZWSTdGhlk8h3YWl0KCmOoY2RaH/Lq21ldGhvmkcdZJYDqFFmb3KTdGhlk29i
kQCOOGplY3STdG+Td2hpY5C442iTdGhlk8hub3RpZnkoKZOrbWV0aG+YZJNimGUtjqGNkWh/y2xv
bmdzLpEEa/RJZpYDQ9tub5N0aHJlYWRzk2FyZZN3kLjjYWl0aW5nLJEDR1p0aGWTbWV0aG+aRx1k
k2RvmGVzk25vdGhpbmcujqaNjY3Ibm90aWZ5QWxsKCmOjpFof8urVGhpc5YC0RV3aWxsk3Jlc3Rh
cnSTYWxsk3RocmVhZHOTdGhhdJNoYZW443aTZZYC0RVjYWxsZWSTdGhlk8h3YWl0KCmTq2Zvco6h
jZFof8t0aGWWA1VVb2KRAI44amVjdHOTdG+Td2hpY5C442iTdGhlk8hub3RpZnlBbGwoKZOrbWV0
aG+aRx1kk2KYZWxvbmdzLo6OnxgAAI2SALGAADGOjPgAAAAqAYOSwBw7AAAAAAPoAnAAAAFoAAAA
BgAB8yDf6jx4AAoAAAAKAAAACGNtc2x0dDEw8x3f6jx4AAoAAAAKAAAABmNtdHQxMPMXGvIiVgAK
AAAACgAAAAZjbWJ4MTDzAEvxYHkACgAAAAoAAAAFY21yMTD5AAAIXALf39/f

------=_NextPart_000_0005_01C0A23E.902E4F40--