%PDF-1.3
%����
2 0 obj
<<
/Length 5492
>>
stream
BT
/TT2 1 Tf
12 0 0 12 234.168 669 Tm
0 g
/GS1 gs
0 Tc
0 Tw
[(F)25(o)0(r)-250(the L)]TJ
4.0297 0 TD
-0.0067 Tc
0.0167 Tw
(ove of)Tj
2.7569 0 TD
0 Tc
0 Tw
[(T)74(r)18(off)]TJ
/TT4 1 Tf
10 0 0 10 252.76 633 Tm
[(J)35(ames K. Lowden)]TJ
/TT6 1 Tf
-0.351 -1.8 TD
(Symas Corporation)Tj
/TT4 1 Tf
1.5285 -3.6 TD
[(ABSTRA)30(CT)]TJ
/TT6 1 Tf
-13.1535 -2.4 TD
0.1786 Tw
[(The state of Unix documentation has not adv)25(anced for decades.)-678.6(The v)15(enerable)]TJ
-2.5 -1.2 TD
0.1496 Tw
[(man page remains the backbone and, as Hoare might ha)20(v)15(e)15( )-15(predicted, an impro)15(v)15(ement)]TJ
T*
0 Tw
[(o)15(v)15(e)0(r)-250(man)15(y)-250(o)0(f)-250(its successors.)]TJ
2.5 -1.56 TD
0.0423 Tw
(The plethora of competing formats and systems has created a fragmented and con-)Tj
-2.5 -1.2 TD
0.0509 Tw
[(fusing body of documentation, confusing to users who don�)18(t)-300.9(kno)25(w)-300.9(where to look, and to)]TJ
T*
0.0312 Tw
[(writers who don�)18(t)-281.2(kno)25(w)-281.2(where to start.)-531.2(One need only to search for HO)35(WT)18(O)-281.2(documents)]TJ
T*
0 Tw
(on writing documentation for conformation.)Tj
2.5 -1.56 TD
0.0874 Tw
[(This paper re)25(vie)25(ws the state of the art, and critiques the v)25(ariety of documentation)]TJ
-2.5 -1.2 TD
-0.0001 Tc
0.0596 Tw
[(systems in current use.)-559.7(It e)14.9(xplores why)-309.6(n)-0.1(e)24.9(w)24.9( )-25(systems were in)39.9(v)14.9(ented, which are currently)]TJ
T*
0 Tc
0.0739 Tw
[(f)10(ashionable, and suggests a path to a better)40(,)-323.9(uni)]TJ
/TT7 1 Tf
19.425 0 TD
0 Tw
(�)Tj
/TT6 1 Tf
0.5562 0 TD
0.0739 Tw
(ed documentation system based wholly)Tj
-19.9811 -1.2 TD
0 Tw
[(and solely on trof)25(f.)]TJ
/TT2 1 Tf
-3.6 -3.6 TD
(The Stale State of the Art)Tj
/TT6 1 Tf
2.5 -1.56 TD
[(In the be)15(ginning w)10(as the man page.)-500(It di)25(vided darkness from light.)-500(And it w)10(as good.)]TJ
T*
0.1549 Tw
[(But apparently not good enough.)-654.9(W)80(ould-be successors include T)70(e)15(xinfo, DocBook, Doxygen, and)]TJ
-2.5 -1.2 TD
0.386 Tw
[(Markdo)25(wn. )-250(F)15(ormats, beside the terminal console, include PDF and HTML.)-886(Locations might be)]TJ
T*
0.1944 Tw
[(/usr/share/man, or /usr/share/doc or /usr/share/info or /usr/share/html, or pretty much an)15(ywhere else in)]TJ
T*
0 Tw
[(/usr/share, or only on the web)40(.)]TJ
2.5 -1.56 TD
0.066 Tw
[(T)80(o)80( )-80(each its o)25(wn silo.)-566(There is no comprehensi)25(v)15(e)15( )-15(cross-reference, no accepted uni)25(v)15(ersal structure or)]TJ
-2.5 -1.2 TD
0.0191 Tw
[(encoding or output format.)-519.2(There are dif)25(ferent schools of thought about ho)25(w)-269.1(t)0(o)-269.1(encourage better documen-)]TJ
T*
0 Tw
(tation to be written, what the best output medium is, and what system should be used to render the output.)Tj
2.5 -1.56 TD
0.0482 Tw
[(Rather than progress to)25(w)10(ard a single, all-encompassing system that utilizes the full capacity of lar)18(ge)]TJ
-2.5 -1.2 TD
0.1609 Tw
[(memories, Unicode, and bit-mapped displays, documentation technology is re)15(gressing and fragmenting.)]TJ
T*
0.0368 Tw
[(The b)20(uilt-in typesetting system, trof)25(f, is considered by man)15(y)-286.8(t)0(o)-286.8(b)0(e)-286.8(v)15(estigial and archaic.)-536.8(Y)100(e)0(t)-286.9(e)25(v)15(ery alterna-)]TJ
T*
0.0427 Tw
[(ti)25(v)15(e)15( )-15.1(is)-292.8(less functional, or more complicated, or both.)-542.8(On most BSD systems trof)25(f)-292.8(has been replaced by the)]TJ
T*
0.1181 Tw
[(less functional mandoc.)-618.1(GNU continues to promote T)70(e)15(xinfo. )-250(Perl)-368.1(had pod.)-618.2(Python has p)10(ydoc and pro-)]TJ
T*
0.0367 Tw
[(motes Sphinx.)-536.7(Sub)15(v)15(ersion goes post-modern: web-only)65(.)-536.7(Man)15(y)-286.7(use Markdo)25(wn, a system with no standard,)]TJ
T*
0.1148 Tw
[(ne)25(v)15(e)0(r)-364.9(mind support for footnotes.�)-614.8(X.or)18(g)-364.8(b)0(e)15(g)15( )354.8(an)-364.8(with a set of manuals in trof)25(f)-364.8(format. )-250(Instead)-364.8(updating)]TJ
T*
0 Tw
(their content, the project opted to re-encode them in Docbook and/or Doxygen.)Tj
2.5 -1.56 TD
0.0573 Tw
[(The dysfunctional Unix documentation system has hindered progress in other w)10(ays, too.)-557.3(F)15(o)0(r)-307.4(e)15(xam-)]TJ
-2.5 -1.2 TD
0.0881 Tw
(ple, command-line shells cannot rely on documentation )Tj
/TT7 1 Tf
23.0552 0 TD
0 Tw
(�)Tj
/TT6 1 Tf
0.5562 0 TD
0.088 Tw
[(les to pro)15(vide interacti)25(v)15(e)15( )-15(help. )-250(The)-338(user cannot)]TJ
-23.6113 -1.2 TD
0 Tw
(type)Tj
2.5 -1.56 TD
($)Tj
/TT2 1 Tf
0.75 0 TD
(ssh)Tj
ET
0 G
1 J 1 j 0.4 w 10 M []0 d
1 i
120.39 137.67 21.12 -9.96 re
S
BT
/TT6 1 Tf
10 0 0 10 122.34 130.2 Tm
(help)Tj
-5.034 -1.56 TD
0.0493 Tw
[(to get a reminder of the a)20(v)25(ailable options, or � hea)20(v)15(e)0(n)-299.3(forfend � a)]TJ
/TT4 1 Tf
28.0726 0 TD
0 Tw
(form)Tj
/TT6 1 Tf
2.1885 0 TD
0.0493 Tw
[(to f)10(acilitate making the choices.)]TJ
-30.2611 -1.2 TD
0.0541 Tw
[(The bare-bones e)15(xperience at the bash prompt is in part the product of the lack of a uni)]TJ
/TT7 1 Tf
35.6422 0 TD
0 Tw
(�)Tj
/TT6 1 Tf
0.5562 0 TD
0.0541 Tw
(ed, programmati-)Tj
-36.1984 -1.2 TD
0 Tw
(cally accessible body of documentation.)Tj
ET
0.32 w
72.03 82.59 m
144.03 82.59 l
S
BT
8 0 0 8 82 72.5999 Tm
0.1004 Tw
[(�)-250(F)15(ootnotes! Dude!)-600.4(Y)110(o)0(u)-350.4(can say other stuf)25(f)-350.4(that�)55(s)-350.4(pertinent b)20(ut not strictly necessary)65(,)-350.5(without interrupting)]TJ
-1.25 -1.25 TD
0 Tw
[(the e)15(xplication.)]TJ
10 0 0 10 249.545 24 Tm
[(19 No)15(v)15(ember 2020)]TJ
ET
endstream
endobj
3 0 obj
<<
/ProcSet [/PDF /Text ]
/Font <<
/TT2 4 0 R
/TT4 5 0 R
/TT6 6 0 R
/TT7 7 0 R
>>
/ExtGState <<
/GS1 8 0 R
>>
>>
endobj
11 0 obj
<<
/Length 8973
>>
stream
BT
/TT6 1 Tf
10 0 0 10 282.17 744 Tm
0 g
/GS1 gs
0 Tc
0 Tw
(-2-)Tj
-18.517 -3.6 TD
0.02 Tw
[(The origins of our T)80(o)25(wer of Babel are historical and psychological.)-520.1(There is a certain amount of Not)]TJ
-2.5 -1.2 TD
0.0045 Tw
[(In)40(v)15(ented Here, some issues with cop)10(yright and license, opinions on what is modern and what the future will)]TJ
T*
-0.0001 Tc
0.0001 Tw
[(look lik)9.9(e, and strong bre)24.9(w)-250.1(o)-0.1(f)-250.1(technical arrogance.)]TJ
2.5 -1.56 TD
0 Tc
0.0366 Tw
[(Probably the tide cannot be held back.)-536.6(That ship, I�m often told, has already sailed.)-536.7(And surely one)]TJ
-2.5 -1.2 TD
0.0848 Tw
[(audience reading one paper at one conference will not stem the tide, or unsail the ship, or whate)25(v)15(e)0(r)55(.)55( )-304.9(But)]TJ
T*
0.0071 Tw
[(perhaps if we chart the course we ha)20(v)15(e)15( )-15(been on, we can, slo)25(wly)65(,)-257.1(steer the ship and sail to)25(w)10(ard a better desti-)]TJ
T*
0 Tw
[(nation, instead of straight to T)70(erra Incognita, with no one at the helm.)]TJ
/TT2 1 Tf
0 -2.4 TD
[(History of Ev)10(erything)]TJ
/TT6 1 Tf
2.5 -1.56 TD
0.1511 Tw
[(The history of e)25(v)15(erything is re-in)40(v)15(ention. )-250.1(The)-401.2(be)15(ginning programmer re-in)40(v)15(ents simple tools and)]TJ
-2.5 -1.2 TD
0.0655 Tw
[(e)25(v)25( )305.5(entually disco)15(v)15(ers v)15(ery fe)25(w)-315.5(simple)]TJ
/TT4 1 Tf
15.3518 0 TD
[(sui g)10(eneris)]TJ
/TT6 1 Tf
4.7318 0 TD
[(tools are better than those found in /usr/bin.)-565.5(After about)]TJ
/TT7 1 Tf
-20.0836 -1.2 TD
0 Tw
(�)Tj
/TT6 1 Tf
0.5562 0 TD
0.1736 Tw
[(v)15(e)-423.7(years, though, the be)15(ginning programmer becomes an intermediate programmer)40(,)-423.6(and there disaster)]TJ
-0.5562 -1.2 TD
-0.245 Tw
[(a)15(w)15( aits.)]TJ
2.5 -1.56 TD
0.0328 Tw
(It is hard today to )Tj
/TT7 1 Tf
7.4682 0 TD
0 Tw
(�)Tj
/TT6 1 Tf
0.5562 0 TD
0.0328 Tw
[(nd an)15(y)-282.8(Unix subsystem or function that hasn�)18(t)-282.8(been)]TJ
/TT4 1 Tf
21.1196 0 TD
0 Tw
[(r)37(epeatedly)]TJ
/TT6 1 Tf
4.4661 0 TD
0.0329 Tw
[(re-in)40(v)15(ented, often)]TJ
-36.1101 -1.2 TD
-0.0002 Tc
0.0016 Tw
[(to little or no ef)24.8(fect. )-250.1(lpd\(8\))-251.7(ga)19.8(v)14.8(e)14.8( )-15.1(w)9.8(ay to CUPS.)-501.6(/etc/rc.conf ga)19.8(v)19.8( )246.4(e)-251.6(w)9.8(ay)-251.6(to)-251.6(/etc/rc.d. )-250(init\(8\))-251.6(led to systemd\(8\).)]TJ
T*
0 Tc
0 Tw
[(Naturally)65(,)]TJ
/TT4 1 Tf
4.2165 0 TD
[(ther)37(e)-255.1(wer)37(e)-255.1(r)37(easons)]TJ
/TT6 1 Tf
7.7642 0 TD
0.0052 Tw
[(�)-255.2(perhaps e)25(v)15(en)-255.2(good reasons � to replace system)]TJ
/TT4 1 Tf
20.6953 0 TD
0 Tw
(ante)Tj
/TT6 1 Tf
1.9769 0 TD
0.0052 Tw
(with sytem)Tj
/TT4 1 Tf
4.6769 0 TD
0 Tw
(post)Tj
/TT6 1 Tf
1.667 0 TD
[(.)-505.2(But)]TJ
-40.9967 -1.2 TD
0.0858 Tw
[(the observ)25(able adv)25(ancement, from the user�)55(s)-335.8(point of vie)25(w)-335.8(o)0(r)-335.8(b)0(y)-335.8(a)0(n)15(y)15( )-15(objecti)25(v)15(e)15( )-15(measure, w)10(as close to nil.)]TJ
T*
0.0889 Tw
[(V)111(ery fe)25(w)-338.9(e)15(xamples can be found where the functionality of)25(fered by the replacement could not ha)20(v)15(e)15( )-15.1(been)]TJ
T*
0 Tw
(added to the replaced, with less dislocation and need to �upgrade�.)Tj
2.5 -1.56 TD
0.0037 Tw
[(So it is with documentation.)-503.8(T)80(o)80( )-80.1(in)40(v)40( )228.7(ent a system for encoding and rendering documentation is not dif-)]TJ
/TT7 1 Tf
-2.5 -1.2 TD
0 Tw
(�)Tj
/TT6 1 Tf
0.5562 0 TD
0.0996 Tw
[(cult. )-249.9(Neither)-349.5(are the problems inherent in an)15(y)-349.6(g)0(i)25(v)25( )339.6(en)-349.6(system hard to see \(although the ob)15(vious ones are)]TJ
-0.5562 -1.2 TD
0.1232 Tw
[(usually not the important ones\).)-623.2(The goal seems equally simple, e)25(v)15(en)-373.2(if)-373.2(it)-373.2(pr)]TJ
32.2213 0 TD
-0.015 Tc
0 Tw
(ove )Tj
1.7869 0 TD
0 Tc
0.1231 Tw
[(harder to achie)25(v)15(e)15( )-15(than)]TJ
-34.0082 -1.2 TD
0.0593 Tw
[(articulate. )-250(So)-309.3(it is not surprising we ha)20(v)15(e)15( )-15(a)15( )-15(succession of tools and systems all hoping to slay the dragon,)]TJ
T*
0 Tw
[(and mak)10(e)-250(documentation safe in our time.)]TJ
/TT2 1 Tf
0 -2.4 TD
(History of Documentation Systems)Tj
/TT6 1 Tf
2.5 -1.56 TD
0.1151 Tw
[(The halc)15(yon days of documentation systems were the 1990s, just before Bill Gates disco)15(v)15(ered the)]TJ
-2.5 -1.2 TD
0.0372 Tw
[(Internet. )-249.9(There)-287.1(w)10(a)0(s)-287.1(a)-287.1(brief and glorious struggle � well, not all that glorious, really)65(.)-537.2(The dust settled just)]TJ
T*
0.0253 Tw
[(about when the dotcom b)20(ubble b)20(urst, in 2000.)-525.4(Each team retreated to its corner)40(,)-275.3(and a cold truce settled on)]TJ
T*
0 Tw
[(the w)10(orld.)]TJ
2.5 -1.56 TD
0.0641 Tw
[(Perhaps the most widely used on a commercial scale w)10(as from IBM: the)]TJ
/TT4 1 Tf
30.0107 0 TD
0.0642 Tw
[(Standar)37(d)-314.2(Gener)15(al Markup)]TJ
-32.5107 -1.2 TD
0 Tw
[(Langua)10(g)10(e)]TJ
/TT6 1 Tf
4.3658 0 TD
0.1357 Tw
[(\(SGML\). )-250.1(It)-385.8(w)10(a)0(s)-385.8(SGML that in)40(v)15(ented what we no)25(w)-385.7(call)]TJ
/TT4 1 Tf
23.8744 0 TD
0 Tw
(semantic)Tj
/TT6 1 Tf
3.9404 0 TD
0.1357 Tw
(tags, and distinguished the)Tj
-32.1806 -1.2 TD
0.0688 Tw
[(declared meaning from the rendered formatting style.)-568.8(SGML is still with us today)65(.)-568.8(It�)55(s)-318.8(still supported by)]TJ
T*
-0.0001 Tc
0.0382 Tw
[(Jade, and still with us � in humbler form � in XML and HTML.)-538.2(Docbook be)14.9(gan)-288.2(a)-0.1(s)-288.2(a)-0.1(n)-288.2(�SGML applica-)]TJ
T*
0 Tc
0.0304 Tw
[(tion�, a standardized set of tags designed for technical documentation.)-530.5(Latterly)65(,)-280.5(Docbook de)25(v)15(elopment has)]TJ
T*
0 Tw
[(f)10(a)20(v)20(ored XML, with its simpli)]TJ
/TT7 1 Tf
11.699 0 TD
(�)Tj
/TT6 1 Tf
0.5562 0 TD
(ed schema-de)Tj
/TT7 1 Tf
5.4692 0 TD
(�)Tj
/TT6 1 Tf
0.5562 0 TD
(nition language.)Tj
-15.7806 -1.56 TD
0.1069 Tw
[(The system de)25(v)15(eloped by Bell Labs,)]TJ
/TT4 1 Tf
15.4035 0 TD
0 Tw
[(tr)45(of)18(f)]TJ
/TT6 1 Tf
1.6597 0 TD
0.1068 Tw
[(,)-356.8(w)10(as as dif)25(ferent as could be: a direct typesetter with no)]TJ
-19.5632 -1.2 TD
0.0426 Tw
[(imposed structure and no e)15(xplicit machinery to enforce separation of semantics from style.)-542.7(Instead of dic-)]TJ
T*
0.1084 Tw
[(tionaries of opaque tags, trof)25(f)-358.5(pro)15(vided sets of macros that users were free to e)15(xtend or ignore or ab)20(use.)]TJ
T*
0.0564 Tw
[(The w)10(onderful, programmable )]TJ
/TT7 1 Tf
12.6548 0 TD
0 Tw
(�)Tj
/TT6 1 Tf
0.5562 0 TD
0.0564 Tw
[(e)15(xibility w)10(as a feature to user and a b)20(ug to management: freedom for one)]TJ
-13.211 -1.2 TD
0.0376 Tw
[(is to the other loss of control.)-537.6(It should be no surprise that lar)18(ge, top-do)25(wn or)18(ganizations such as IBM and)]TJ
T*
0 Tw
[(the military preferred SGML to trof)25(f.)]TJ
2.5 -1.56 TD
-0.0001 Tc
0.0393 Tw
[(A)-289.3(third ri)24.9(v)24.9(a)-0.1(l)-289.3(i)-0.1(n)-289.3(the fray came from what might be called an or)17.9(ganization: the Free Softw)9.9(are F)14.9(ounda-)]TJ
-2.5 -1.2 TD
0 Tc
0.2529 Tw
[(tion. Richard)-252.9(Stallman )250(de)25(v)15(eloped)]TJ
/TT4 1 Tf
13.8573 0 TD
-0.178 Tw
[(T)92(e)92( xinfo)]TJ
/TT6 1 Tf
2.8875 0 TD
0.0028 Tw
[(,)-252.9(and the GNU project still considers that the One T)35(rue F)15(ormat for)]TJ
-16.7449 -1.2 TD
0.0374 Tw
[(documentation. )-249.9(Because)-287.3(it is designed only for technical manuals, it bears none of the o)15(v)15(erhead of SGML)]TJ
T*
0 Tw
(and has none of the )Tj
/TT7 1 Tf
8.0254 0 TD
(�)Tj
/TT6 1 Tf
0.5562 0 TD
[(e)15(xibility of trof)25(f. �)]TJ
-6.0815 -1.56 TD
0.1771 Tw
[(Not to be o)15(v)15(erlook)10(ed are language-speci)]TJ
/TT7 1 Tf
17.0335 0 TD
0 Tw
(�)Tj
/TT6 1 Tf
0.5562 0 TD
0.1771 Tw
[(c documentation systems and their emulators: ja)20(v)25(a)25( )-24.9(and)]TJ
/TT4 1 Tf
-20.0896 -1.2 TD
0 Tw
(javadoc)Tj
/TT6 1 Tf
3.1655 0 TD
0.1499 Tw
[(,)-399.9(perl and)]TJ
/TT4 1 Tf
4.4482 0 TD
0 Tw
(perldoc)Tj
/TT6 1 Tf
3.0547 0 TD
0.1499 Tw
[(,)-399.9(Python and)]TJ
/TT4 1 Tf
5.7275 0 TD
0 Tw
(pydoc)Tj
/TT6 1 Tf
2.3877 0 TD
0.15 Tw
[(,)-399.9(etc. )-249.9(And)-399.9(of course Doxygen, which might be vie)25(wed as)]TJ
-18.7837 -1.2 TD
0 Tw
[(ja)20(v)25(adoc for C++.)]TJ
ET
0 G
1 J 1 j 0.32 w 10 M []0 d
1 i
72.03 91.59 m
144.03 91.59 l
S
BT
8 0 0 8 82 81.5999 Tm
0.0575 Tw
[(�)-250(T)70(e)15(xinfo can be used as a preprocessor for another system not discussed here in an)15(y)-307.5(detail: T)]TJ
38.2264 -0.224 TD
0 Tw
(E)Tj
0.4858 0.224 TD
0.3075 Tw
(X. T)Tj
1.9739 -0.224 TD
0 Tw
(E)Tj
0.4858 0.224 TD
0.3075 Tc
[(Xw)317.5(a)307.5(s)]TJ
-42.422 -1.25 TD
0 Tc
0.0454 Tw
[(de)25(v)15(eloped not as a)]TJ
/TT4 1 Tf
7.8056 0 TD
0 Tw
(documentation)Tj
/TT6 1 Tf
6.2389 0 TD
0.0455 Tw
[(system, b)20(ut as a system for producing documents.)-545.5(It has ne)25(v)15(e)0(r)-295.5(played much)]TJ
-14.0444 -1.25 TD
0 Tw
[(of a role is Unix documentation e)15(xcept to generate printed matter from T)70(e)15(xinfo.)]TJ
10 0 0 10 249.545 24 Tm
[(19 No)15(v)15(ember 2020)]TJ
ET
endstream
endobj
12 0 obj
<<
/ProcSet [/PDF /Text ]
/Font <<
/TT2 4 0 R
/TT4 5 0 R
/TT6 6 0 R
/TT7 7 0 R
>>
/ExtGState <<
/GS1 8 0 R
>>
>>
endobj
14 0 obj
<<
/Length 7090
>>
stream
BT
/TT6 1 Tf
10 0 0 10 282.17 744 Tm
0 g
/GS1 gs
0 Tc
0 Tw
(-3-)Tj
-18.517 -3.6 TD
0.1052 Tw
[(Owing to the popularity of Ja)20(v)25(aScript and GitHub, in recent years)]TJ
/TT4 1 Tf
27.7167 0 TD
0 Tw
(markdown)Tj
/TT6 1 Tf
4.5774 0 TD
0.1052 Tw
[(has become popular)55(.)]TJ
-34.7941 -1.2 TD
0.1928 Tw
[(Popular)40(,)-442.8(b)20(ut simplistic: no cross-references, no table of contents, no inde)15(x. )-250(In)-442.8(the battle for semantic)]TJ
T*
0 Tw
[(markup, markdo)25(wn has no dog: it�)55(s)-250(pure formatting.)]TJ
2.5 -1.56 TD
0.0074 Tw
[(Finally)65(,)-257.4(w)0(e)-257.4(should mention)]TJ
/TT4 1 Tf
11.1584 0 TD
0 Tw
(mandoc)Tj
/TT6 1 Tf
3.166 0 TD
0.0073 Tw
[(,)-257.4(which the BSD systems ha)20(v)15(e)15( )-15(generally adopted for the base sys-)]TJ
-16.8245 -1.2 TD
0.0105 Tw
[(tem to render man pages. mandoc e)15(xists for that e)15(xact purpose: not to replace trof)25(f, b)20(ut to render man pages)]TJ
T*
0 Tw
(without it by processing the)Tj
/TT4 1 Tf
11.3599 0 TD
(man)Tj
/TT6 1 Tf
1.9722 0 TD
(and)Tj
/TT4 1 Tf
1.6938 0 TD
(mdoc)Tj
/TT6 1 Tf
2.416 0 TD
[(trof)25(f)-250(macros.)]TJ
/TT2 1 Tf
-17.4419 -2.4 TD
[(Str)18(engths of Documentation Systems)]TJ
/TT6 1 Tf
2.5 -1.56 TD
[(Let�)55(s)-250(summarize the relati)25(v)15(e)15( )-15(strengths of each system.)]TJ
/TT2 1 Tf
-2.5 -1.56 TD
(SGML)Tj
/TT8 1 Tf
3.1948 0 TD
<0041>Tj
/TT6 1 Tf
1.2368 0 TD
[(consistenc)15(y)]TJ
-1.9316 -1.2 TD
0.0661 Tw
[(SGML di)25(vides the informational content from typesetting considerations.)-816.2(By presenting the author)]TJ
T*
-0.0001 Tc
0.0941 Tw
[(only with opaque semantic tags, it reserv)14.9(es for the or)17.9(ganization decisions about font and color and)]TJ
T*
0 Tc
0 Tw
(layout.)Tj
/TT2 1 Tf
-2.5 -1.56 TD
[(tr)18(off)]TJ
/TT8 1 Tf
2.1749 0 TD
<0041>Tj
/TT6 1 Tf
1.2368 0 TD
(typesetting)Tj
-0.9117 -1.2 TD
0.0785 Tw
[(W)40(ith its macro f)10(acility)65(,)-328.6(trof)25(f)-328.6(allo)25(ws, b)20(ut does not enforce, the use of semantic tags.)-578.6(The author has)]TJ
T*
0.0897 Tw
[(complete control o)15(v)15(e)0(r)-339.8(e)25(v)15(ery typesetting choice if so desired.)-589.8(trof)25(f)-339.8(i)0(s)-339.8(the most ambitious typesetter)40(,)]TJ
T*
0 Tw
[(too: not only tables and footnotes, b)20(ut mathematics, pictures, and graphs.)]TJ
/TT2 1 Tf
-2.5 -1.56 TD
[(T)92(exinf)25(o)]TJ
/TT8 1 Tf
3.4108 0 TD
<0041>Tj
/TT6 1 Tf
1.2368 0 TD
(accessibility)Tj
-2.1476 -1.2 TD
0.1056 Tw
[(Alone among these system, T)70(e)15(xinfo includes a reader \(tw)10(o, if you count emacs\).)-605.6(Not only does it)]TJ
T*
0.0575 Tw
[(support an inde)15(x, b)20(ut the user can access an inde)15(x)15(e)0(d)-307.5(item from the command line or by typing)]TJ
ET
0 G
1 J 1 j 0.4 w 10 M []0 d
1 i
485.79 469.47 7.32 -9.96 re
S
BT
10 0 0 10 487.814 462 Tm
0.5076 Tc
0 Tw
[(Ii)507.6(n)]TJ
-39.0814 -1.2 TD
0 Tc
[(the vie)25(wer)55(.)]TJ
/TT2 1 Tf
-2.5 -1.56 TD
(Doxygen)Tj
/TT8 1 Tf
3.9722 0 TD
<0041>Tj
/TT6 1 Tf
1.2368 0 TD
[(con)40(v)15(enience)]TJ
-2.709 -1.2 TD
-0.0001 Tc
0.1147 Tw
[(The source-code documentation systems all share the philosophy)-364.8(that some documenttion is better)]TJ
T*
0 Tc
0.0063 Tw
[(than no documentation, and that programmers are more apt to update the documentation if it�)55(s)-256.3(staring)]TJ
T*
0 Tw
[(them in the f)10(ace when the)15(y)-250(change the code.�)]TJ
/TT2 1 Tf
-2.5 -1.56 TD
[(markdo)10(wn)]TJ
/TT8 1 Tf
4.9075 0 TD
<0041>Tj
/TT6 1 Tf
1.2368 0 TD
(simplicity)Tj
-3.6443 -1.2 TD
0.0518 Tw
[(Nothing \(almost\) to learn, easy to read.)-551.9(Get something up in a hurry)65(,)-301.9(and don�)18(t)-301.8(w)10(orry about consis-)]TJ
T*
0 Tw
[(tenc)15(y)-250(o)0(r)-250(the printed page.)]TJ
/TT2 1 Tf
-2.5 -1.56 TD
(mandoc)Tj
/TT8 1 Tf
3.6392 0 TD
<0041>Tj
/TT6 1 Tf
1.2368 0 TD
(just man pages)Tj
-2.376 -1.2 TD
0.0912 Tw
[(mandoc has only one objecti)25(v)15(e)0(:)-341.2(t)0(o)-341.2(render man pages.)-591.3(W)80(ell, tw)10(o)-341.3(objecti)25(v)15(es: also to render the man)]TJ
T*
0 Tw
[(page using softw)10(are with a BSD license.)]TJ
/TT2 1 Tf
-2.5 -2.4 TD
[(F)25(eatur)18(e)-250(Set Comparison)]TJ
0 -2.16 TD
1.25 Tw
[(System )-1391(VT)92(-100 HTML PDF Semantic)-250(tags Indexed Hyperlinks)]TJ
/TT6 1 Tf
0 -1.2 TD
3.983 Tw
(SGML no)Tj
/TT9 1 Tf
11.7268 0 TD
3.245 Tc
0 Tw
[<001600160003>2093<0016>]TJ
/TT6 1 Tf
15.4875 0 TD
0 Tc
(no)Tj
/TT9 1 Tf
5.7345 0 TD
<0016>Tj
/TT6 1 Tf
-32.9488 -1.2 TD
[(grof)25(f)-250(man)]TJ
/TT9 1 Tf
7.1332 0 TD
<0016>Tj
/TT6 1 Tf
4.1094 0 TD
(meh)Tj
/TT9 1 Tf
4.4832 0 TD
4.675 Tc
<00160016>Tj
/TT6 1 Tf
11.4878 0 TD
0 Tc
(no)Tj
/TT9 1 Tf
5.6095 0 TD
<0016>Tj
/TT6 1 Tf
-32.823 -1.2 TD
[(grof)25(f)-250(mdoc)]TJ
/TT9 1 Tf
7.1332 0 TD
<0016>Tj
/TT6 1 Tf
4.1094 0 TD
(meh)Tj
/TT9 1 Tf
4.4832 0 TD
4.675 Tc
<00160016>Tj
/TT6 1 Tf
11.4878 0 TD
0 Tc
(no)Tj
/TT9 1 Tf
5.6095 0 TD
<0016>Tj
/TT6 1 Tf
-32.823 -1.2 TD
-0.195 Tw
[(T)70(e)70( xinfo)]TJ
/TT9 1 Tf
7.133 0 TD
3.838 Tc
0 Tw
[<00160016>593<0016>]TJ
/TT6 1 Tf
13.5391 0 TD
0 Tc
(meh)Tj
/TT9 1 Tf
6.6637 0 TD
4.857 Tc
<00160016>Tj
/TT6 1 Tf
-27.3359 -1.2 TD
0 Tc
3.095 Tw
(Doxygen no)Tj
/TT9 1 Tf
11.7265 0 TD
0 Tw
<0016>Tj
/TT6 1 Tf
4.1554 0 TD
[(?)-4347(meh)]TJ
/TT9 1 Tf
11.4545 0 TD
4.857 Tc
<00160016>Tj
/TT6 1 Tf
-27.3364 -1.2 TD
0 Tc
2.148 Tw
[(markdo)25(wn meh)]TJ
/TT9 1 Tf
11.726 0 TD
0 Tw
<0016>Tj
/TT6 1 Tf
3.8774 0 TD
4.18 Tw
[(no no)-5180.5(no)]TJ
/TT9 1 Tf
17.345 0 TD
0 Tw
<0016>Tj
/TT6 1 Tf
-32.9484 -1.2 TD
(mandoc)Tj
/TT9 1 Tf
7.133 0 TD
3.838 Tc
[<00160016>593<0016>-837<0016>]TJ
/TT6 1 Tf
20.0805 0 TD
0 Tc
(no)Tj
/TT9 1 Tf
5.7345 0 TD
<0016>Tj
/TT2 1 Tf
-32.9481 -3 TD
(Myths of Documentation Systems)Tj
2.5 -1.56 TD
0.0817 Tw
[(Documentation is easy)55(,)-331.7(o)0(r)-331.7(should be)]TJ
/TT6 1 Tf
15.688 0 TD
[(.)-581.7(T)80(o)-331.7(write documentation is to set aside telling the computer)]TJ
-18.188 -1.2 TD
0.0308 Tw
[(what to do, and to tak)10(e)-280.8(u)0(p)-280.8(the reader�)55(s)-280.8(point of vie)25(w: What does it do, and ho)25(w)-280.8(d)0(o)-280.8(I)-280.8(use it?)-530.8(No)]TJ
/TT4 1 Tf
38.862 0 TD
0 Tw
(system)Tj
/TT6 1 Tf
2.9468 0 TD
(can)Tj
-41.8088 -1.2 TD
0.0909 Tw
[(mak)10(e)-341(that transition easy; it has to be accepted, undertak)10(en, and practiced.)-590.9(It�)55(s)-340.9(not for e)25(v)15(eryone, and it�)55(s)]TJ
ET
0.32 w
72.03 111.99 m
144.03 111.99 l
S
BT
8 0 0 8 82 102 Tm
-0.0001 Tc
0.0334 Tw
[(�)-250.1(The e)24.9(vidence in support of that proposition is nil or ne)14.9(gati)24.9(v)14.9(e)-0.1(.)-533.3(Lousy documentation based on such system)]TJ
-1.25 -1.25 TD
0 Tc
0.0996 Tw
[(abounds, and e)15(xcellent results are rare indeed.)-599.6(Observ)15(e)-349.6(that Unix itself w)10(as documented with separate docu-)]TJ
T*
0 Tw
(mentation )Tj
/TT7 1 Tf
4.278 0 TD
(�)Tj
/TT6 1 Tf
0.5562 0 TD
0.029 Tw
[(les, the method still used by the BSDs today)65(,)-279(t)0(o)-279(generally positi)25(v)15(e)15( )-15(re)25(vie)25(ws. If lazy programmers are)]TJ
-4.8342 -1.25 TD
0 Tw
[(reluctant to write documentation, making the ef)25(fort less onerous, on the e)25(vidence, does nothing for the quality of)]TJ
T*
(the results.)Tj
10 0 0 10 249.545 24 Tm
[(19 No)15(v)15(ember 2020)]TJ
ET
endstream
endobj
15 0 obj
<<
/ProcSet [/PDF /Text ]
/Font <<
/TT2 4 0 R
/TT4 5 0 R
/TT6 6 0 R
/TT7 7 0 R
/TT8 16 0 R
/TT9 17 0 R
>>
/ExtGState <<
/GS1 8 0 R
>>
>>
endobj
19 0 obj
<<
/Length 7404
>>
stream
BT
/TT6 1 Tf
10 0 0 10 282.17 744 Tm
0 g
/GS1 gs
0 Tc
0 Tw
(-4-)Tj
-21.017 -3.6 TD
(de)Tj
/TT7 1 Tf
0.9438 0 TD
(�)Tj
/TT6 1 Tf
0.5562 0 TD
(nitely not for the programmer while programming.)Tj
/TT2 1 Tf
1 -1.56 TD
0.0378 Tw
[(Write once, r)18(ender e)15(v)10(erywher)18(e)]TJ
/TT6 1 Tf
13.3239 0 TD
0 Tw
[(.)-537.8(The)]TJ
/TT4 1 Tf
2.6303 0 TD
[(pr)45(omise)]TJ
/TT6 1 Tf
3.465 0 TD
0.0378 Tw
[(of man)15(y)-287.8(systems is that, if the author will only write)]TJ
-21.9191 -1.2 TD
0 Tw
(the )Tj
/TT7 1 Tf
1.5648 0 TD
(�)Tj
/TT6 1 Tf
0.5562 0 TD
0.0931 Tw
[(ne manual, the system will repay the ef)25(fort by rendering it in e)25(v)15(ery desired format and v)15(enue. Y)110(our)]TJ
-2.1209 -1.2 TD
0 Tw
[(Name In Lights. The reality is dif)25(ferent:)]TJ
5 -1.56 TD
0.0884 Tw
[(�)-2150(The quality of the rendered output is une)25(v)15(en.)]TJ
/TT4 1 Tf
21.662 0 TD
0 Tw
(No)Tj
/TT6 1 Tf
1.5055 0 TD
0.0885 Tw
(system today is equally good at pro-)Tj
-20.6675 -1.2 TD
0 Tw
[(ducing PDF and HTML output, and rendering usefully in a terminal windo)25(w)65(.)]TJ
-2.5 -1.56 TD
0.1691 Tw
[(�)-2150(The properties of each medium are dif)25(ferent, and af)25(fect ho)25(w)-419.1(the content is best pre-)]TJ
2.5 -1.2 TD
0.0496 Tw
[(sented. )-250(Book)-299.6(publishers gi)25(v)15(e)15( )-15(consideration to ho)25(w)-299.6(t)0(e)15(x)0(t)-299.6(and )]TJ
/TT7 1 Tf
24.5012 0 TD
0 Tw
(�)Tj
/TT6 1 Tf
0.5562 0 TD
0.0496 Tw
(gures relate on the printed)Tj
-25.0573 -1.2 TD
0.1061 Tw
[(page. )-250.1(Sidebars)-356.2(are helpful, e)15(xcept in a terminal. Floating menus can w)10(ork w)10(onders in)]TJ
T*
0 Tw
(HTML, not so much on the printed page.)Tj
-5 -1.56 TD
0.0479 Tw
[(Proof: rare is the document that renders equally well in tw)10(o)-297.9(formats out of three.)-547.9(None)15(xistent is the)]TJ
-2.5 -1.2 TD
0.0689 Tw
[(one that does so without much thought and ef)25(fort on the part of the author)55(.)-568.9(I)0(t)-318.9(w)10(asn�)18(t)-318.9(written)]TJ
/TT4 1 Tf
38.2912 0 TD
0 Tw
(once)Tj
/TT6 1 Tf
1.8877 0 TD
0.3189 Tc
[(;i)318.9(tw)328.9(a)318.9(s)]TJ
-40.1789 -1.2 TD
0 Tc
[(written man)15(y)-250(times, carefully)65(.)]TJ
2.5 -1.56 TD
0.0967 Tw
[(In planning a better documentation system, there is no media-neutral solution.)-596.8(W)40(ithout considered)]TJ
-2.5 -1.2 TD
0 Tw
[(ef)25(fort,)]TJ
/TT4 1 Tf
2.848 0 TD
[(e)15(very)]TJ
/TT6 1 Tf
2.5519 0 TD
0.1522 Tw
[(document will be inherently biased to w)10(ork best in one medium or another)55(.)-652.3(It�)55(s)-402.3(useful to)]TJ
-5.3999 -1.2 TD
0 Tw
(understand that your preferred medium in)Tj
/TT7 1 Tf
16.689 0 TD
(�)Tj
/TT6 1 Tf
0.5562 0 TD
(uences what you think is the �best� system.)Tj
/TT2 1 Tf
-14.7451 -1.56 TD
0.0431 Tw
(Indexing is automatic)Tj
/TT6 1 Tf
9.3093 0 TD
0.0432 Tw
[(.)-543.1(Good documentation is curated, and no system inde)15(x)15(e)0(s)-293.2(k)10(e)15(y)0(w)10(ords automati-)]TJ
-11.8093 -1.2 TD
0.0073 Tw
[(cally)65(.)-507.3(Sure, the whole te)15(xt can be inde)15(x)15(e)0(d)-257.3(indiscriminately)65(.)-507.3(But the job of deciding where a term is de)]TJ
/TT7 1 Tf
41.1942 0 TD
0 Tw
(�)Tj
/TT6 1 Tf
0.5562 0 TD
(ned)Tj
-41.7503 -1.2 TD
[(and discussed remains, in 2018, the job of an editor)55(.�)]TJ
/TT2 1 Tf
2.5 -1.56 TD
0.0225 Tw
[(The web is the futur)18(e)]TJ
/TT6 1 Tf
9.1272 0 TD
[(.)-522.5(The web is not your machine; it�)55(s)-272.5(not e)25(v)15(en)-272.5(you virtual machine in the cloud.)]TJ
-11.6272 -1.2 TD
0.1655 Tw
[(The most reliable documentation for the system you are using is that which is included.)-665.4(Furthermore,)]TJ
T*
0.2216 Tw
[(inde)15(x- and k)10(e)15(yw)10(ord-searches are not supported by the general-purpose web bro)25(wser)40(,)-471.7(nor by standard)]TJ
T*
0 Tw
(HTML.)Tj
/TT2 1 Tf
2.5 -1.56 TD
0.0849 Tw
[(tr)18(off is obsolete)]TJ
/TT6 1 Tf
6.7055 0 TD
0.0848 Tw
[(.)-584.9(trof)25(f)-334.9(refuses to go gentle into that good night.)-584.9(The �blame� is usually placed on)]TJ
-9.2055 -1.2 TD
0.0545 Tw
[(the e)15(xisting man pages: who will re)25(write them in the ne)25(w)65(,)65( )-65.1(�modern� system? But the f)10(act is that ne)25(w)-304.6(man)]TJ
T*
0 Tw
[(pages are written e)25(v)15(ery day)65(,)-250(not least because trof)25(f)-250(i)0(s)-250(s)0(o)-250(darn functional.)]TJ
/TT2 1 Tf
0 -2.4 TD
[(Myths of T)74(r)18(off)]TJ
2.5 -1.56 TD
0.039 Tw
[(tr)18(off is dead)]TJ
/TT6 1 Tf
5.226 0 TD
0.0389 Tw
[(.)-539(There are three acti)25(v)15(e)15( )-15(trof)25(f)-288.9(projects: GNU, Heirloom, and neatrof)25(f. )-250(That)-288.9(e)15(xcludes the)]TJ
-7.726 -1.2 TD
0 Tw
[(acti)25(v)15(e)15( )-15(projects trying to)]TJ
/TT4 1 Tf
9.6792 0 TD
[(mak)10(e)]TJ
/TT6 1 Tf
2.3499 0 TD
(it obsolete.)Tj
/TT2 1 Tf
-9.5291 -1.56 TD
0.0671 Tw
[(tr)18(off is inferior to T)]TJ
8.4699 -0.224 TD
0 Tw
(E)Tj
0.542 0.224 TD
(X)Tj
/TT6 1 Tf
0.7222 0 TD
0.0671 Tw
[(.)-567.1(Science students are generally advised to learn T)]TJ
20.6401 -0.224 TD
0 Tw
(E)Tj
0.4858 0.224 TD
0.0672 Tw
[(X, and told it�)55(s)-317.2(the cat�)55(s)]TJ
-33.36 -1.2 TD
0.0104 Tw
[(pajamas for preparing manuscripts.)-510.4(And it might be; Knuth de)25(v)15(eloped T)]TJ
29.057 -0.224 TD
0 Tw
(E)Tj
0.4858 0.224 TD
0.0104 Tw
[(X)-260.4(i)0(n)-260.4(part because of his dismay at)]TJ
-29.5428 -1.2 TD
0.0005 Tw
[(the quality of the output of mathematical notation in trof)25(f. )-250(On)-250.5(the other hand, modern T)]TJ
35.0848 -0.224 TD
0 Tw
(E)Tj
0.4858 0.224 TD
0.0006 Tw
[(X)-250.6(systems are v)15(ery)]TJ
-35.5706 -1.2 TD
0.1337 Tw
[(comple)15(x, 100 times the size of an)15(y)-383.7(trof)25(f)-383.7(implementation, and the technical adv)25(antage of T)]TJ
37.6129 -0.224 TD
0 Tw
(E)Tj
0.4858 0.224 TD
0.1336 Tw
[(X)-383.7(i)0(s)-383.6(easy to)]TJ
-38.0987 -1.2 TD
0.0793 Tw
[(o)15(v)15(erstate. )-250(I)-329.3(challenge the reader of the present document, for e)15(xample, to )]TJ
/TT7 1 Tf
30.6163 0 TD
0 Tw
(�)Tj
/TT6 1 Tf
0.5562 0 TD
0.0794 Tw
[(nd a paragraph that w)10(ould be)]TJ
-31.1724 -1.2 TD
0 Tw
[(better rendered by the paragraph-at-once algorithm instead of the line-at-a-time one that w)10(as used.)]TJ
/TT2 1 Tf
2.5 -1.56 TD
[(As an author)92(,)-250(t)0(r)18(off is ugly and hard to use)]TJ
/TT6 1 Tf
17.7811 0 TD
(.)Tj
-17.7811 -1.56 TD
[(Compared to what?)-500(Pound for pound, trof)25(f)-250(i)0(s)-250(easier to use and more capable than an)15(ything else.)]TJ
T*
0.0646 Tw
[(The best SGML systems are enormously complicated.)-564.7(And e)15(xpensi)25(v)15(e)0(.)-564.6(The)15(y)-314.6(support great catalogs)]TJ
-2.5 -1.2 TD
0.0636 Tw
(of tags and transformations, plus a rich UI to let the user connect the abstract tagging sytem to a concrete)Tj
T*
0 Tw
(concurrent rendering.)Tj
2.5 -1.56 TD
0.102 Tw
[(Nothing resembling those SGML systems is a)20(v)25(ailable as free softw)10(are. )-250.1(The)-352(UI presented by Doc-)]TJ
-2.5 -1.2 TD
0.0662 Tw
[(Book is, for the most part, the same one that is presented by C++: a te)15(xt editor)40(,)-316.2(a)-316.2(command-line utility to)]TJ
T*
0.1002 Tw
[(�compile� it, and a web bro)25(wser or PDF vie)25(wer)55(.)-600.2(N)0(o)-350.2(Docbook author re)25(v)15(els in the sea of tags that o)15(v)15(e)0(r)20(-)]TJ
T*
0 Tw
(whelm the content.)Tj
ET
0 G
1 J 1 j 0.32 w 10 M []0 d
1 i
72.03 81.99 m
144.03 81.99 l
S
BT
8 0 0 8 82 72 Tm
[(�)-250(A)0(n)-250(editor with a nose, not an init )]TJ
/TT7 1 Tf
14.1646 0 TD
(�)Tj
/TT6 1 Tf
0.5562 0 TD
(le.)Tj
10 0 0 10 249.545 24 Tm
[(19 No)15(v)15(ember 2020)]TJ
ET
endstream
endobj
20 0 obj
<<
/ProcSet [/PDF /Text ]
/Font <<
/TT2 4 0 R
/TT4 5 0 R
/TT6 6 0 R
/TT7 7 0 R
>>
/ExtGState <<
/GS1 8 0 R
>>
>>
endobj
22 0 obj
<<
/Length 3989
>>
stream
BT
/TT6 1 Tf
10 0 0 10 282.17 744 Tm
0 g
/GS1 gs
0 Tc
0 Tw
(-5-)Tj
/TT11 1 Tf
8 0 0 8 108 708 Tm
()Tj
2.4 -1.5 TD
(Versions of the <acronym>TDS</> Protocol, by Product )Tj
T*
()Tj
2.4 -1.5 TD
( )Tj
2.4 -1.5 TD
0.6 Tw
( Product )Tj
2.4 -1.5 TD
0 Tw
(TDS Version )Tj
T*
(Comment )Tj
T*
(
)Tj
-2.4 -1.5 TD
()Tj
-2.4 -1.5 TD
()Tj
2.4 -1.5 TD
()Tj
2.4 -1.5 TD
(Sybase before System 10,)Tj
4.45 -1.5 TD
(Microsoft SQL Server 6.x )Tj
-4.45 -1.5 TD
(4.2 )Tj
T*
(Still works with all products,)Tj
4.45 -1.5 TD
(subject to its limitations. )Tj
/TT6 1 Tf
10 0 0 10 97 506.4 Tm
0.1254 Tw
[(trof)25(f)-375.3(w)10(as and is the only typesetting language designed e)15(xpressly for the user to input �by hand�,)]TJ
-2.5 -1.2 TD
0.1175 Tw
[(without the aid of a sophisticated UI and tag dictionary)65(.)-617.5(I)0(n)-367.5(constrast to the v)15(erbosity of SGML, trof)25(f)-367.5(i)0(s)]TJ
T*
0 Tw
[(minimalist. )-250(The)-250(same table fragment ab)]TJ
16.1338 0 TD
-0.015 Tc
0.03 Tw
[(ove i)-15(s)]TJ
2.5808 0 TD
0 Tc
0 Tw
[(entered in trof)25(f)-250(as:)]TJ
/TT11 1 Tf
8 0 0 8 108 464.4 Tm
(.ds TDS \\f[CW]TDS\\f[])Tj
0 -1.5 TD
(.SH)Tj
T*
(Versions of the \\*[TDS] Protocol, by Product)Tj
T*
(.PP)Tj
T*
(.TS)Tj
T*
(LB LB LB)Tj
T*
1.2 Tc
(LLL.)Tj
T*
0 Tc
1.45 Tw
[(Product TDS)-600(Version )-725(Comment)]TJ
T*
0 Tw
(_)Tj
T*
(Sybase before System 10, Microsoft SQL Server 6.x\\)Tj
3.125 -1.5 TD
(4.2\\)Tj
T*
(Still works with all products, subject to its limitations.)Tj
-3.125 -1.5 TD
(.TE)Tj
T*
(.NL)Tj
/TT6 1 Tf
10 0 0 10 72 290.4 Tm
0.0277 Tw
[(Half the typing: 229 characters v)15(ersus 586 for Docbook.)-527.7(And, by minimizing the markup, it�)55(s)-277.7(easier to see)]TJ
0 -1.2 TD
0 Tw
(the forest for the trees.)Tj
2.5 -1.56 TD
[(W)40(ithout doubt, the idiosyncrasies of trof)25(f)-250(are of)25(f-putting. �T)80(w)10(a)0(s)-250(e)25(v)15(e)0(r)-250(thus.)]TJ
/TT4 1 Tf
2.5 -1.56 TD
0.2214 Tw
(In spite of some obvious de)Tj
/TT12 1 Tf
11.9664 0 TD
0 Tw
(�)Tj
/TT4 1 Tf
0.5 0 TD
0.2214 Tw
[(ciencies � a r)37(ebarbative input syntax, mysterious and)]TJ
-12.4664 -1.2 TD
0.3939 Tw
[(undocumented pr)45(operties in some ar)37(eas, and a vor)15(acious appetite for computer)]TJ
T*
0.0852 Tw
[(r)37(esour)37(ces \(especially when used with macr)45(o)-335.3(pac)20(ka)10(g)10(e)0(s)-335.3(and pr)37(epr)45(ocessor)10(s)-335.2(lik)10(e)-335.2(EQN and)]TJ
T*
0.0016 Tw
[(TBL\) � TR)40(OFF has been the basis of document pr)37(epar)15(ation at Bell Labs for some year)10(s,)]TJ
T*
0 Tw
[(and is lik)10(ely to r)37(emain so for year)10(s)-250(t)0(o)-250(come)15(.)]TJ
/TT6 1 Tf
T*
[(�)-250(Brian K)25(ernighan,)]TJ
/TT4 1 Tf
8.4174 0 TD
[(A)-250(T)74(ypesetter)20(-independent TR)40(OFF)]TJ
/TT6 1 Tf
-13.4174 -1.56 TD
0.1685 Tw
[(The ne)25(w)-418.6(trof)25(f)-418.6(user is immediately af)25(fronted by the �rebarbati)25(v)15(e)15( )-15(syntax�. )-250(Lik)10(e)-418.5(parenthesis in Lisp and)]TJ
0 -1.2 TD
0.2157 Tw
[(whitespace in Python, though, the leading dots and tw)10(o-letter commands� pose no real problem, and)]TJ
T*
0.0164 Tw
[(quickly become �just the w)10(ay it is�.)-516.4(I)-266.4(h)0(a)20(v)20( )261.4(e)-266.4(yet to meet the user who spent se)25(v)15(eral hours with trof)25(f)-266.4(and then)]TJ
T*
0 Tw
[(sw)10(ore of)25(f)-250(i)0(t)-250(because of its of)25(fensi)25(v)15(e)15( )-15(syntax.)]TJ
/TT2 1 Tf
0 -2.4 TD
[(The T)74(r)18(ouble with T)74(r)18(off)]TJ
/TT6 1 Tf
2.5 -1.56 TD
[(The trouble with trof)25(f)-250(i)0(s)-250(i)0(n)-250(the)]TJ
/TT4 1 Tf
12.3334 0 TD
[(e)20(xperience)]TJ
/TT6 1 Tf
4.3101 0 TD
(.)Tj
ET
0 G
1 J 1 j 0.32 w 10 M []0 d
1 i
72.03 81.99 m
144.03 81.99 l
S
BT
8 0 0 8 82 72 Tm
[(�)-250(technically)65(,)]TJ
/TT4 1 Tf
5.5717 0 TD
[(r)37(equests)]TJ
/TT6 1 Tf
3.296 0 TD
[(,)-250(o)0(r)-250(macros.)]TJ
10 0 0 10 249.545 24 Tm
[(19 No)15(v)15(ember 2020)]TJ
ET
endstream
endobj
23 0 obj
<<
/ProcSet [/PDF /Text ]
/Font <<
/TT2 4 0 R
/TT4 5 0 R
/TT6 6 0 R
/TT11 24 0 R
/TT12 25 0 R
>>
/ExtGState <<
/GS1 8 0 R
>>
>>
endobj
27 0 obj
<<
/Length 7059
>>
stream
BT
/TT6 1 Tf
10 0 0 10 282.17 744 Tm
0 g
/GS1 gs
0 Tc
0 Tw
(-6-)Tj
-18.517 -3.6 TD
0.0243 Tw
[(De)25(v)15(elopment of the trof)25(f)-274.4(U)0(I)-274.4(ceased, along with just about the whole Unix UI, 20 years ago.)-524.4(The last)]TJ
-2.5 -1.2 TD
0.2371 Tw
[(specialized man page vie)25(wer w)10(a)0(s)]TJ
/TT4 1 Tf
14.7276 0 TD
0 Tw
(xman)Tj
/TT6 1 Tf
2.166 0 TD
0.237 Tw
[(,)-487.1(a)-487.1(t)0(o)10(y)10( )-10.1(from the MIT Athena project.)-737(Computing po)25(wer has)]TJ
-16.8937 -1.2 TD
0 Tw
[(increased by 3 orders of magnitude, and all we got w)10(as a really f)10(ast)]TJ
/TT2 1 Tf
27.1651 0 TD
(less)Tj
/TT6 1 Tf
1.5 0 TD
(\(1\).)Tj
-26.1651 -1.56 TD
[(Lack of a con)40(v)15(enient vie)25(wer might be)]TJ
/TT4 1 Tf
15.3306 0 TD
(the)Tj
/TT6 1 Tf
1.4717 0 TD
(central reason for documentation fragmentation.)Tj
/TT2 1 Tf
-19.3023 -1.56 TD
[(A)25(ppearance)]TJ
/TT6 1 Tf
2.5 -1.2 TD
0.0624 Tw
[(The author does not breathe who does not care ho)25(w)-312.4(the prose is rendered on the page.)-562.5(If appealing)]TJ
T*
0.0421 Tw
[(output didn�)18(t)-292.2(matter)40(,)-292.2(you�)50(d)-292.2(b)0(e)-292.2(reading this page in a monospace font on greenbar paper)40(,)-292.1(and the Zen)]TJ
T*
0 Tw
[(CSS Garden w)10(ouldn�)18(t)-250(e)15(xist.)]TJ
/TT2 1 Tf
-2.5 -1.56 TD
[(Con)40(v)10(enience)]TJ
/TT6 1 Tf
2.5 -1.2 TD
0.1108 Tw
(While typing)Tj
/TT4 1 Tf
5.7206 0 TD
(man foo)Tj
/TT6 1 Tf
3.7216 0 TD
[(is surely the f)10(astest w)10(ay to get to a document, it�)55(s)-360.8(f)10(ar from the best w)10(ay to)]TJ
-9.4422 -1.2 TD
0.0103 Tw
[(peruse documentation.)-510.3(T)35(r)0(y)]TJ
/TT4 1 Tf
11.2425 0 TD
(man X)Tj
/TT6 1 Tf
2.8536 0 TD
0 Tw
(or)Tj
/TT4 1 Tf
1.0933 0 TD
0.0103 Tw
(man git)Tj
/TT6 1 Tf
3.0381 0 TD
[(,)-260.3(for e)15(xample. )-250.1(Hyperlinks)-260.2(ha)20(v)15(e)15( )-15(their place and purpose,)]TJ
-18.2275 -1.2 TD
0 Tw
(and their state of the art today is undeniably in HTML.)Tj
0 -1.56 TD
0.0761 Tw
[(But, really)65(,)-326.1(i)0(s)-326.1(that enough?)-576.2(Can we ask no more of our documentation system than that ne)25(w)-326.2(pages)]TJ
-2.5 -1.2 TD
0 Tw
[(come up when we click on the blue underlined te)15(xt?)]TJ
/TT2 1 Tf
0 -2.4 TD
(The Ideal Documentation System)Tj
/TT6 1 Tf
2.5 -1.56 TD
0.1354 Tw
[(Man pages look the w)10(ay the)15(y)-385.5(do, and are used the)15(y)-385.5(w)10(ay the)15(y)-385.4(are, because the a)20(v)25(ailable softw)10(are)]TJ
-2.5 -1.2 TD
0 Tw
(mostly emulates the state of the art circa 1976.)Tj
2.5 -1.56 TD
0.0957 Tw
[(Close your e)15(yes no)25(w)-345.7(and imagine a documentation system that does what you w)10(ant. )-250.1(What)-345.8(does it)]TJ
-2.5 -1.2 TD
0 Tw
[(look lik)10(e? )-250(A)-250(bit lik)10(e)-250(a)0(n)-250(e-book reader)40(,)-250(b)20(ut smarter)40(,)-250(and with a k)10(e)15(yboard.)]TJ
/TT2 1 Tf
0 -1.56 TD
[(F)25(ast)]TJ
/TT6 1 Tf
5.556 0 TD
(It )Tj
/TT7 1 Tf
0.8608 0 TD
(�)Tj
/TT6 1 Tf
0.5562 0 TD
[(nds the page quickly)65(,)-250(scrolls quickly)65(,)-250(and searches quickly)65(.)]TJ
/TT2 1 Tf
-6.973 -1.56 TD
(Accurate)Tj
/TT6 1 Tf
5.5557 0 TD
[(Inde)15(x)-250(searches locate de)]TJ
/TT7 1 Tf
9.7296 0 TD
(�)Tj
/TT6 1 Tf
0.5562 0 TD
[(nitions and discussions, not incidental uses of the same w)10(ord.)]TJ
/TT2 1 Tf
-15.8415 -1.56 TD
[(Con)40(v)10(enient)]TJ
/TT6 1 Tf
5.5562 0 TD
0.0421 Tw
[(Hyperlinks to internal and e)15(xternal references can be follo)25(wed at a k)10(e)15(ystrok)10(e)-292.1(o)0(r)-292.1(mouse click.)]TJ
/TT4 1 Tf
-0.0002 -1.2 TD
0.0511 Tw
[(See the description of shopt below under SHELL B)10(UIL)20(TIN COMMANDS)]TJ
/TT6 1 Tf
30.0354 0 TD
[(isn�)18(t)-301.2(just a sugges-)]TJ
-30.0354 -1.2 TD
0.1604 Tw
[(tion; it�)55(s)-410.4(a)0(n)-410.4(a)0(f)25(fordance. The table of contents let you jump to the rele)25(v)25(ant section.)-660.4(Inde)15(x)]TJ
T*
0.0609 Tw
[(searches can jump to the referenced use, or display a list of conte)15(xt sentences that are them-)]TJ
T*
0.0401 Tw
[(selv)15(es links into the body of the document.)-540.1(The SEE ALSO section can be searched concur)20(-)]TJ
T*
0 Tw
(rently with the main document.)Tj
/TT2 1 Tf
-5.556 -1.56 TD
[(Attracti)10(v)10(e)]TJ
/TT6 1 Tf
5.5556 0 TD
0.0045 Tw
[(The full f)10(aith and credit of the GUI is behind it.)-504.5(Colors and font sizes are con)]TJ
/TT7 1 Tf
31.165 0 TD
0 Tw
(�)Tj
/TT6 1 Tf
0.5562 0 TD
[(gurable.)-504.6(Gone)]TJ
-31.7208 -1.2 TD
[(are monospace fonts, e)15(xcept where the)15(y)-250(add information or mak)10(e)-250(the te)15(xt easier to read.)]TJ
/TT2 1 Tf
-5.556 -1.56 TD
(Flexible)Tj
/TT6 1 Tf
5.5552 0 TD
0.029 Tw
[(There are dif)25(ferent w)10(ays and needs to read a document.)-529(Sometimes it�)55(s)-279(the )]TJ
/TT7 1 Tf
30.6371 0 TD
0 Tw
(�)Tj
/TT6 1 Tf
0.5562 0 TD
0.029 Tw
[(rst time.)-529(Some-)]TJ
-31.1924 -1.2 TD
0.0297 Tw
[(times it�)55(s)-279.7(time to dig in and really understand.)-529.7(Sometimes it�)55(s)-279.7(a)-279.7(quick lookup of an option or)]TJ
T*
0 Tw
[(k)10(e)15(yw)10(ord.)]TJ
/TT2 1 Tf
-5.556 -1.56 TD
(Consistent)Tj
/TT6 1 Tf
5.5565 0 TD
0.0705 Tw
(Consistent document structure, consistent document placement, consistent document format,)Tj
-0.0005 -1.2 TD
0.0669 Tw
[(consistent document rendering.)-566.9(The more consistent is the documentation, the easier it is to)]TJ
T*
0 Tw
(access, to understand, and to use.)Tj
/TT2 1 Tf
-5.556 -1.56 TD
(Graphical)Tj
/TT6 1 Tf
5.5555 0 TD
[(F)15(o)0(r)-250(those times when a picture or a diagram or an equation helps tell the story)65(.)]TJ
/TT2 1 Tf
-5.5555 -1.56 TD
(Integrated)Tj
/TT6 1 Tf
5.556 0 TD
0.0593 Tw
[(If documenting a command, where is the e)15(x)15(ecutable, and what does)]TJ
/TT4 1 Tf
27.9746 0 TD
0 Tw
(it)Tj
/TT6 1 Tf
0.865 0 TD
0.0593 Tw
[(say about its v)15(ersion?)]TJ
-28.8396 -1.2 TD
0 Tw
(If a function, where is the object code, and where is the supporting source?)Tj
/TT2 1 Tf
-5.556 -2.4 TD
[(Str)18(engths of T)74(r)18(off)]TJ
/TT6 1 Tf
2.5 -1.56 TD
0.0245 Tw
[(GNU trof)25(f)-274.5(\(grof)25(f\) already pro)15(vides all the artif)10(acts needed by the ideal documentation system.)-524.6(It can)]TJ
-2.5 -1.2 TD
0.0764 Tw
[(output plain te)15(xt, HTML, Postscript, and PDF directly)65(.)-576.4(There are macro sets for books, reports, manuals,)]TJ
T*
-0.0001 Tc
0.0001 Tw
(and presentations. It supports HTML and PDF hyperlinks.)Tj
2.5 -1.56 TD
0 Tc
0.0036 Tw
[(Man pages, while the)15(y)-253.6(v)25(ary in quality)65(,)-253.6(already do contain all the information needed by the ideal doc-)]TJ
-2.5 -1.2 TD
0.2456 Tw
[(umentation system.)-745.7(The syntax � whether command-line options or ar)18(gument functions � is fully)]TJ
T*
0 Tw
(described.)Tj
2.5 -1.56 TD
0.0017 Tw
[(Much of the po)25(wer of trof)25(f)-251.7(currently goes une)15(xploited. )-500(Unlik)10(e)]TJ
/TT4 1 Tf
25.5738 0 TD
0 Tw
(any)Tj
/TT6 1 Tf
1.6955 0 TD
0.0017 Tw
[(other freely a)20(v)25(ailable documenta-)]TJ
-29.7694 -1.2 TD
0.0014 Tw
[(tion system, trof)25(f)-251.5(has b)20(uilt-in support for mathematics and graphics.)-501.4(It�)55(s)-251.4(also quite tri)25(vial to construct tables)]TJ
17.7545 -4.68 TD
0 Tw
[(19 No)15(v)15(ember 2020)]TJ
ET
endstream
endobj
28 0 obj
<<
/ProcSet [/PDF /Text ]
/Font <<
/TT2 4 0 R
/TT4 5 0 R
/TT6 6 0 R
/TT7 7 0 R
>>
/ExtGState <<
/GS1 8 0 R
>>
>>
endobj
30 0 obj
<<
/Length 6580
>>
stream
BT
/TT6 1 Tf
10 0 0 10 282.17 744 Tm
0 g
/GS1 gs
0 Tc
0 Tw
(-7-)Tj
-21.017 -3.6 TD
[(automatically from database queries, e)25(v)15(en)-250(on)-250(the )]TJ
/TT7 1 Tf
19.7857 0 TD
(�)Tj
/TT6 1 Tf
0.5562 0 TD
-0.065 Tc
(y.)Tj
/TT2 1 Tf
-20.3418 -2.76 TD
0 Tc
[(Arr)18(esting Obser)10(v)10(ation)]TJ
/TT6 1 Tf
2.5 -1.56 TD
0.255 Tw
(In 30 years, no)Tj
/TT4 1 Tf
7.2129 0 TD
0 Tw
(better)Tj
/TT6 1 Tf
2.8375 0 TD
0.255 Tw
[(system has been in)40(v)15(ented. )-250(Equi)25(v)25(alent systems, ar)18(guably)65(,)-505(perhaps,)]TJ
-10.0504 -1.2 TD
0.0918 Tw
[(depending on ho)25(w)-341.8(one rates the missing and added features.)-591.8(But no system completely sub-)]TJ
T*
0 Tw
[(sumes the feature set, let alone impro)15(v)15(e)0(s)-250(o)0(n)-250(it.)]TJ
-2.5 -1.56 TD
[(That f)10(act alone is a testament to the durability and utility and functionality of trof)25(f.)]TJ
/TT2 1 Tf
0 -2.4 TD
[(Better Documentation Thr)18(ough T)74(r)18(off)]TJ
/TT6 1 Tf
2.5 -1.56 TD
[(A)-250(better vie)25(wer w)10(ould moti)25(v)25(ate better man pages.�)-500(As things stand, an)15(y)-250(discussion of �better� tags is)]TJ
-2.5 -1.2 TD
0.0064 Tw
[(academic: while it may be clearer)40(,)-256.4(i)0(n)-256.4(some sense, to say that a bit of te)15(xt is an ar)18(gument or a function name,)]TJ
T*
0.0424 Tw
[(kno)25(wing the system will underline it or boldf)10(ace it, it�)55(s)-292.5(also one more le)25(v)15(e)0(l)-292.5(o)0(f)-292.4(indirection to learn and use.)]TJ
T*
0.0773 Tw
[(The user sees no dif)25(ference. )-250(If,)-327.3(on the other hand, the system someho)25(w)-327.4(used the f)10(act that the name is an)]TJ
T*
0.0285 Tw
[(option name and not merely emphasized te)15(xt, the author no)25(w)-278.6(has a concrete reason to pro)15(vide the informa-)]TJ
T*
0 Tw
(tion.)Tj
2.5 -1.56 TD
0.0693 Tw
[(Other systems could be brought into the fold.)-569.4(Programmatic con)40(v)15(ersion of T)70(e)15(xinfo, for e)15(xample, is)]TJ
-2.5 -1.2 TD
0.0364 Tw
[(already supported and could doubtless be impro)15(v)15(ed. )-250(The)-286.4(content is there, e)25(v)15(en)-286.4(if)-286.4(the approach is inconsis-)]TJ
T*
0 Tw
(tent.)Tj
2.5 -1.56 TD
0.0352 Tw
(The language-speci)Tj
/TT7 1 Tf
7.837 0 TD
0 Tw
(�)Tj
/TT6 1 Tf
0.5562 0 TD
0.0352 Tw
[(c systems, such as ja)20(v)25(adoc, can certainly be con)40(v)15(erted to trof)25(f)-285.3(man pages with a)]TJ
-10.8931 -1.2 TD
0.1774 Tw
[(certain amount of patience and willingness to mak)10(e)-427.4(assumptions. )-250(Continuous,)-427.4(automatic con)40(v)15(ersion is)]TJ
T*
0 Tw
[(probably not feasible; a one-time con)40(v)15(ersion with touch-ups is.)]TJ
2.5 -1.56 TD
0.0601 Tw
[(Arbitrary formats usually in f)10(act ha)20(v)15(e)15( )-15(suf)]TJ
/TT7 1 Tf
16.8409 0 TD
0 Tw
(�)Tj
/TT6 1 Tf
0.5562 0 TD
0.0601 Tw
[(cient information to mak)10(e)-310.2(a)-310.2(creditable con)40(v)15(ersion to man)]TJ
-19.897 -1.2 TD
0.01 Tw
[(page format.)-510(Y)110(our humble author produced man pages from Sub)15(v)15(ersion help te)15(xt. )-250(Someone)-260(else con)40(v)15(erted)]TJ
T*
0.0355 Tw
[(SQLite�)55(s)-285.5(web documentation to man pages.)-785.5(The standard structure of a man page lends itself to program-)]TJ
T*
0 Tw
(matic generation if a little boilerplate is tolerable.)Tj
/TT2 1 Tf
0 -2.4 TD
[(My Kingdom f)25(or a V)37(iewer)]TJ
/TT6 1 Tf
2.5 -1.56 TD
(The )Tj
/TT7 1 Tf
1.9346 0 TD
(�)Tj
/TT6 1 Tf
0.5562 0 TD
0.1298 Tw
[(rst step in correcting an)15(y)-379.9(problem is recognizing it.)-629.9(No one who has e)15(xamined the state of)]TJ
-4.9907 -1.2 TD
0.0588 Tw
[(Unix documentation w)10(ould defend it as satisf)10(actory)65(,)-308.8(much less ideal.)-558.8(F)15(o)0(r)-308.8(that last 15 years, the answer to)]TJ
T*
0 Tw
[(the w)10(ay forw)10(ard has been hands in pock)10(ets while whistling a happ)10(y)-250(tune.)]TJ
2.5 -1.56 TD
[(Let�)55(s)-250(not k)10(eep our light under a bask)10(et an)15(ymore.)]TJ
T*
0.0343 Tw
[(Despite being the best we ha)20(v)15(e)0(,)-284.4(such as it is, trof)25(f)-284.3(has untapped capacity)65(.)-534.3(That capacity goes unreal-)]TJ
-2.5 -1.2 TD
0.0337 Tw
[(ized because it is, literally)65(,)-283.7(unrealized: it almost ne)25(v)15(e)0(r)-283.7(appears on screen.)-533.7(T)80(o)80( )-80(the e)15(xtent that trof)25(f)-55(�)55(s)-283.8(typeset-)]TJ
T*
0.0075 Tw
[(ting capacity is re)25(v)15(ealed in PDF form, it�)55(s)-257.5(also)]TJ
/TT4 1 Tf
18.8573 0 TD
0 Tw
[(tr)15(apped)]TJ
/TT6 1 Tf
3.3533 0 TD
0.0074 Tw
[(there, in a system that is slo)25(w)-257.4(t)0(o)-257.4(load and render)40(,)-257.4(ill-)]TJ
-22.2106 -1.2 TD
0 Tw
[(suited for searching, and generally not inte)15(grated into the rest of the system.)]TJ
2.5 -1.56 TD
(Put)Tj
/TT2 1 Tf
1.6614 0 TD
(man)Tj
/TT6 1 Tf
1.8892 0 TD
(\(1\),)Tj
/TT2 1 Tf
1.7434 0 TD
[(inf)25(o)]TJ
/TT6 1 Tf
1.642 0 TD
(\(1\),)Tj
/TT2 1 Tf
1.7434 0 TD
(xman)Tj
/TT6 1 Tf
2.3892 0 TD
(\(1\),)Tj
/TT2 1 Tf
1.7434 0 TD
(xpdf)Tj
/TT6 1 Tf
1.9453 0 TD
0.0774 Tw
[(\(1\), and your f)10(a)20(v)20(orite web bro)25(wser into a blender)55(.)-577.5(Render man)]TJ
-17.2573 -1.2 TD
0.004 Tw
[(pages in proportional font directly)65(,)-254.1(not through Postscript or PDF)80(,)-254.1(t)0(o)-254(s)0(a)20(v)20( )249(e)-254(time. )-250(Assign)-254(k)10(e)15(ys to jump to sec-)]TJ
T*
0.1092 Tw
[(tion headers.)-609.2(Automatically search the SEE ALSO section.)-609.3(Mak)10(e)-359.3(i)0(t)-359.3(easy and enjo)10(yable to follo)25(w)-359.3(links,)]TJ
T*
-0.0002 Tc
0.0002 Tw
[(forw)9.8(ard and back again.)]TJ
2.5 -1.56 TD
0 Tc
0.1068 Tw
[(In f)10(act, today�)55(s)-356.8(bro)25(wser has the functionality to interpret and render trof)25(f)-356.8(documents. )-250(No)-356.8(need for)]TJ
-2.5 -1.2 TD
0 Tw
[(HTML or PDF)80(.)]TJ
2.5 -1.56 TD
0.0518 Tw
[(Build it, and the)15(y)-301.8(will come.)-801.9(A)-301.9(better vie)25(wer will engender better documentation, and a better user)]TJ
-2.5 -1.2 TD
0 Tw
[(e)15(xperience. )-250(One)-250(day)65(,)-250(perhaps the)15(y)-250(will say:)]TJ
/TT4 1 Tf
2.5 -1.56 TD
[(I)-250(switc)15(hed to your system because at least I could under)10(stand it)]TJ
/TT6 1 Tf
25.3319 0 TD
(.)Tj
ET
0 G
1 J 1 j 0.32 w 10 M []0 d
1 i
72.03 91.95 m
144.03 91.95 l
S
BT
8 0 0 8 82 82 Tm
[(�)-250(The)]TJ
/TT4 1 Tf
2.6017 0 TD
(mdoc)Tj
/TT6 1 Tf
2.463 0 TD
0.047 Tw
(macro package has much better support for semantic tags \(and therefore more)Tj
/TT4 1 Tf
31.94 0 TD
0 Tw
(meaningful)Tj
/TT6 1 Tf
4.7965 0 TD
(tags\))Tj
-43.0512 -1.25 TD
(than the �standard�)Tj
/TT4 1 Tf
7.9688 0 TD
(man)Tj
/TT6 1 Tf
1.9722 0 TD
(macros that GNU and Linux half-heartedly recommend.)Tj
10 0 0 10 249.545 24 Tm
[(19 No)15(v)15(ember 2020)]TJ
ET
endstream
endobj
31 0 obj
<<
/ProcSet [/PDF /Text ]
/Font <<
/TT2 4 0 R
/TT4 5 0 R
/TT6 6 0 R
/TT7 7 0 R
>>
/ExtGState <<
/GS1 8 0 R
>>
>>
endobj
8 0 obj
<<
/Type /ExtGState
/SA false
/SM 0.02
/OP false
/op false
/OPM 1
/BG2 /Default
/UCR2 /Default
/HT /Default
/TR2 /Default
>>
endobj
32 0 obj
<<
/Type /FontDescriptor
/Ascent 750
/CapHeight 676
/Descent -250
/Flags 262178
/FontBBox [-168 -218 1000 935]
/FontName /Times-Bold
/ItalicAngle 0
/StemV 133
/XHeight 461
/StemH 139
>>
endobj
33 0 obj
<<
/Type /FontDescriptor
/Ascent 750
/CapHeight 653
/Descent -250
/Flags 98
/FontBBox [-169 -217 1010 883]
/FontName /Times-Italic
/ItalicAngle -15
/StemV 76
/XHeight 441
/StemH 76
>>
endobj
34 0 obj
<<
/Type /FontDescriptor
/Ascent 750
/CapHeight 662
/Descent -250
/Flags 34
/FontBBox [-168 -218 1000 898]
/FontName /Times-Roman
/ItalicAngle 0
/StemV 84
/XHeight 450
/StemH 84
>>
endobj
35 0 obj
<<
/Type /FontDescriptor
/Ascent 750
/CapHeight 662
/Descent -250
/Flags 34
/FontBBox [-168 -218 1000 898]
/FontName /Times-Roman
/ItalicAngle 0
/StemV 84
/XHeight 450
/StemH 84
>>
endobj
36 0 obj
<<
/Type /FontDescriptor
/Ascent 701
/CapHeight 0
/Descent -298
/Flags 4
/FontBBox [-167 -299 1094 827]
/FontName /DLPJCL+Symbol
/ItalicAngle 0
/StemV 0
/FontFile2 37 0 R
>>
endobj
37 0 obj
<<
/Filter /FlateDecode
/Length 20022
/Length1 39360
>>
stream
H��W}t��ovgvfwv8�DH8�֊P���%����i��C9��͎�~03K6�JJ����b����ՔҔRj)�B�ȇآ"-�"�R
���@z���&@���?�ޙ��������f��~xsB�#��{ߙE�ȝ�:�ohQ`z ?�[q`���=Y��|77!4���:c�E���l)��O����{����f��r�2�����k��}S�*�c�V7��A>&�
��Y��hC�3��]Z��G�c �$���u�^�be`��q�7Ч�#J2.�P^F}^���ۉ/��AqCT��Pq�P��8�:�_����m��q=��7���B�W��#��'��[�#�H!9
�A'�*��d���x�R7�n��Z����4��w�����ra��l8O���F������#`4:Z��V�fq{�GF���BZ5�
�ؾ������5����-$/�Lȅ��-p��ȇ����s1.^�^��@&qS9N���α0���`4B�q���*���0��0�r~X ~n)l��d9D�%���E��~R̳�n�HZ�-0����` L�#�/F}.܍��+�����c����5
��jl_��&d���I>�%X�F^���/�]���A~&4���s,�G3�G��o#��;��{d�0�8��fKp�M��!���*W�o&�a%߈��O�j�OR9�
��r�܆��8g$���*�e�ܼ���k�YN�A8�_ �^��B3�����2Zx�H����|B���.�~��E��o6�� ��(H�$��
�>w�q��bl�A��kc��km\g�Oll��9�����/8''��O��qC�b�Q/
5�0��$���P�
bHW���\T�!5����BH��j����
�J��~��o�n��q%H_�]�U�cf�)%j4d��e���F�%�*��c�MB����F�k �yc4
��Q��T���,F��Ƶ�����+�3m�'�>��TC�����Qs�T�A�㶺��AP�+��=J�HZ�m"�4b��c�5��&Mn�-Ƹ��_����7fB���q�x�E|�5[�,���.OU�n��b�}Uh4��_�)mi$nV�l��(Ɖa����D�5[�F�=>��4�L��f$�(�Ӧ��ӆ����x5�Y.R��-��_�r] ���7�N�U�rBWC}������o�0� �(�\�����m �h�\��Q��;n-V�Z�i�Ӳ
�]����Tj�~�-�#���Qw�%�Ǽi���xƐ-�.-��F��IɊ�u>%g�P�ƻޞ ����Ā�=�HD�a����h��`����<�C���^?�L~Л�䇽��<�a��L�)gHD
^�Q���,B�y\��䶢���Hd��H��NKf�JF�ɏ3�*[�Z=��'�Mv�b~��>�U۶�N�����fW�}�����a4�{)�f��k�7M�
.��]�v�r�������Al��ɺK���2Ɯ���Q��:ulog�u���u7yj�=R�wV*n�=��lp�x��;�Y{���;��=�ޕqy����
�p�QOXj��]��"���V��:#
)�p�)8N�ho e�҄t��i0�5�`�c6���V`�~&���/茍�!Fz|�{��e��.�)_�L3B���w�,�����v!�dm�[�Y�FF>���.U�FzB���?.��w���Ux�ϝ���j8Ԩ��1�Ӫ�'��#�m�t��ȶ���/z��"2ָ��!�
�" �Qg���9�������k����e��\VÚ���.5�9�=���څ�rW����J�gi�*:��k}��A�{�jI<9����>S_�ʒ� P'����Lgw�<9���'��f72*I�@�3��G�����5;$\J�0Ͼح��ːQ�4Ux�N��c0�^�<�S>�1�X���*���!q�n��D#��o0�Z#I2u�b�Q"��!��8� �3�c �y��O[�y�K��%Z����2jV{����<-;���qAz�T��t��M��.,\�:�D��8UAY���)��Q<�x���w5W���.}>����
�y�{�(]�C_;w��������5�棾�͏K%�B ���_�"���c��%���*u��}�Ag�}>ɘ9k7�����=��R��zv���6�3zZ|Eۖ��=�V������:q�+�勁x��H�ٳ0�[g��˯�~�{eUM�=Q_pA��u� ֒A�i��u�S��Z��>ؒ�\���.�3�B�Xה˱"�\{�Ųν�Qb�-����7ٍ��I��n'���F�9C��H�MO�p
���:��D���]��#�ʻ=�(����0tss���Ѩ�3�`T��$#b�a�S�iF[?��-�HƳ-�V��Gs�2)m�|ذ���,�EA�J1�
�irMFbT��Nu.�mÝа6#"�ѶÕw�v'���0s<&�$�� �_�3�q�O�X��w�JXu�
�a4A+��^�����
�Sp��e���Ab!��'?$Sȣ�O��2�T�g�J�2�H��JZ�N��G�&ɟI9F>&�I/�@.���?�P�Q'ͥn:�>D�*-���<�4���K�A}���/�:��n���6�;�}�v�O������4��,�}�=�d6�MdSY����I��-e/�լ���ZX{�����Iv�E�Ev�
p�E>���>�O�?��1�4_ʟ�/�z��o����������x���1~��O�^���e������:4Q�ٔa���$�@ņ�EԢG�3a��z�5����✓�;��\~���U���f�Bȶli�1i��
c�`�nDS�\B�$�C��I�`�L�ѭ�
e���1��6���b+L��`#�nn���/m���H���w�����s����
2�F��������ۖ��7v[Wu��;��%�1�������E�.lY�喉U�J�_��h�֙��a�9�˼���b�jI%�$�)���5���b�
��I���,��/=d����P'���~���,M�Eh�ǧ�f{lx��)qᇑ�Y�`Xj�C+�\�hk��Y.��Zf������.�ӭY��)6(��z,������H�9���e�l߹d`�Ea���d�j�Dj�5����0K%�n�m���S���U�R��.��!/�qƜ��ә���K�K��mg�'tX�0���0�,�(
�{J�MqC��U�ӻ(>{J�9#gA����٤��H�8��_�����E��E>eSKƻy!#�<|xN�m�,|��������"� ���پc��-�ٚ�,��*zh⏶%�n7�%i�,Yf+eG�����8��ߗ4j/���(N�J���}�1=v��jhw�\e0��ReuE��� ��ڋ�K�^)>?t�1���;�ֱ���iɑP��E�$� n-ȼH��!�6#�Sٜ�ّ�������Gw�9�i��U�?8*M:kC�K�]\E���R_���Z�W���|[s���,�~-�\nòT^��j��^���n��0����Ѹ�Zj˘�̮��xͽ�\��e���s�ӯ���n�ґ`����)s�]��Z,��3}g>̪�#:f�Π3ٕ_@ ��M�賗���e�DcLmFhpԍ
��l���3���u�eB���m&gYF#I4ɼ���e�2�P{��ʶ���[$���5/��O`���y�Y�@UY�-Р��l��KI�:96�֩%�����&��D�e1#���{im��c�EGA��dT�`Y��C�:;��|�t��������C��0����i��L��0�G-B�R���rl��/�Oo?9�TM-=�/����̀=�����mșL��Zc�\�&UK��dQW�q��6B4',�xiN��Y�.�İ�G�z�%C:�\����N/�c
BѝnB�Jj�:�k��g���\��������+�~�[S1��?��7���ꧾu�ܩ���E��^/�5���I�A#��
�hО%-eO�o���_��0h���c�2�~=�y��t�L��W��,�Z���1��ְ���ZR��+Ʈ�1�����7���f<��6����cY�1���f�����j��h�/���H2VQ�O��h�X,��O����t�W"��A�h�۳\��,j�x��f{�[��
��� �&gi��Ƽ����e9����,��bX��xX��>M���4�d��,<�Ɵ�$�+j
��#�ǺG+ԍ��LοA��X�O�-f9ζnf�,���,�C-���ݖ�Η����^��צ�G�9�
�і[��:?����{YPJߔ�?�^K�CGͷܠ�0A橥/K���w�=�_�B ��Z��b衅�K��U���Dww+X�ɪe)MXf�_���+���P�x���c����E�-���#�iZ���� ����4=�t@��!/�Q8��i�5���,\���}�܀E��"/zաzԄ����v��4�����h���E��U�tlǥx
^�܀����)�
܅����{�0��Sx����� �6�N��:^$Ed%YED"}U��1ROHi'ϐ�9@FH�L�S�M�;�$�w����r�d�"����n-��k��=��}���!n��1�3�W���ͽǥ�E{�Eu]�s����ܷ)�ef�.����HZ�T6(D��hjgd��L'Q�V�F���Q@%�֟V:�hg�Ĥ-���љLkg�@[cҎ�;QƟ�s/��h:�=���?�|��ߏ��]a�dUN�uy��+�V�S ���〫s�XG���EҐ5�Тl��2[*���y�5�(��
�������0�m���?��{#��8:Nh"ub*Q�
����1Q'��6�N�����G�N�P�-�;XZ�Vj%��^����T�qJ &. D�8K(X����Ֆ��$�2�4��)X
���c�k�U��Cށ���Y�Xv��?�lȦ�G��5��A����hcΥ� q�l�3tؘ�a�xʿ��] YK�C���ő�4��-i��z�A
��GS�F�<6��,4aV�Pj�<ɭ��o8s���:�ZN/j,��cIr��K���A���@z���5��}g�;�ӡ�.�~T;�B$a�
�k����Hu��_烢��-Lm���I�o�+�7�%�W���AGb��˻r{;"Qc�<&=�Y��f��zk
_���a�!������N���%�u��� ���>�� ]-�kw�$�4hH��[�u�V"9>a���*�47J�C�/��")��I⟯gE�^p���wi.�JC%����`_Ԓ�T��
T�/@$K�����W������O����̺�*S����֝8XHd�'��ϧe��u��g�27���;r��~V�*k����X����P���� ��Ir���#֮��;��l�P}Q��[�Z.�c���<�Q�V��}!�d�E�};V��*oͪ�4O�
�����5���v��7�d�夬n.\~ )]�}�L��Ese���oɐ��hi��Q�p5��?̑,K�R�=����1��^ �__(�����"�X�d�
i^}�[��煮�V�U�Ϟ� $M�2�<&%2+�����"���'��\.Ms�vC�X�ёN����C`�1H�'m��6]23H�m�{īU_�M�%�ZD�q�L��Q5�d�@��vF� qh�*�N�������dݻ�����̳�<�lU�@V�t=cnxF�����
������e5���7�ӣ^���W�ޡ���N3���k�C�����5��8�Y����DW���|u�SaPc)�Ƃ_;��Kp��'�/�L�~-�F"n1:�@�<�6cm<(@${9���4�;=`g�s�F���T]�I�O��P�� ��o%����0&�H�=V�x"�s�I�z`,O �/�fH*�?��w�U�I��SR�o/�0��Dž��u Ố
��QM�,ȅ�Ȫx,� �*��a1����3X���U�%�
�7`32�t�x��Q8}�a}�×p��xovq��d22�\��k.y�, ?!U�%RC^%kIy�D�ym%�I�E����Ȼ��#���/�<�'�7�L�$7�A�2jy�.dt�J'�)4���n���t]M����Vچ�nr��� �#=J�ѳ���� �(��$)E�IOJ�R�`f���*�ji9��:)"5I���ڤ��;��%��� K;'
O��I7��c��������Y
s3/��&��i,�e���~�����F��}�@�F\J������,��� !�/&T���0_��o��7�8�T�cBe ��+3/���r��`��0dH���
��yW�>����a~!ۼ�*0Q��1p)m��Pds�"�E�6�
����yf�I&�3��,�sǂ{xg��\�X�$aD�}�
�k���wy�B�h��0�!�Ye���\��Q.��ʸ�y����_ޣm�����/�"i_Y��JTTʽҪ&6�|��ʪ�'I���/<�M�G���
���[��t]�~�_��J�n��
�,���Ay�5t�R7��ԏO
�]��/R7}|���M�^1t`�~l�"���;5�z]�'������� ȩ;tdgL���~J�0��:Ӆ�X��t$�3��kF�D~�"��8+�y?�~a�S�#�|����8�{�mv/��6!�F3��4Q�KPI�H6�$BMT����R� �(J�w$@��0��%hGp�lg�^�a�LF�#����v�Fm������Kr vj�3��n��?��������
�Dh/A�aA��e�T�?V���6m��횇�|��f� ͯ�q�t�-��;j:J��/���ˊO�A]��3so6�嵓���|�ܢ�ysk�KE����� �^����K*�o�_������._�a濱�i����|S�4{���C��=e33־��u�5<3G��n<:������N�y��ӿ6���Ⱦ�9�����;gUی�#����5߬@& �y���ߞy���pG��Xs����i���'C3�����X��n���E�p�ܐ���w]7�?y��g>7����J�
��Duo����וl?��I1ު�Ȫ��5{�lՖ��n�����V��(X|bcmaO+�^%�=y�����~����v��Pa�4_3'�c�W����r��Y��ٍw�ˍ�WS�kl���%�͓�)�S�TP��v�|����#M����=Y}p~�܀vk�
�F���K"^t�ϕ�K{��UD�r�p��!�\�p'͆��D�[n8j���[�o�ݧ����[���[��������~����|����;p������Wm}���]�.j��2��������V��A��j�)]q~�nw}��!S؝��;A
U� ;J�"{���L��G)$�>�
M*�&Of�ٴ���$v��&Ҭ�b�h&1���4v3��]Ztjo��ޑSv��}����Q��oOص=�+�D���#>lw�f'�f���O+��.Xa�OI�@PKB1L�����C)�2�S��p7��"X��rX�z�X�ৰ����8
ϣ�:�*�3p�DM�>$�!�\E�ɵ��&��*"7���Nn#�d�&�Bu��|�Xd Y���A���'M����m��v�=����"(�=5��=J�Q�Rwc$�FU!Ơ���8o���hu�{�k�ݖWGE¨Bqs��g�{Q%�(�RZ�g���G�T���JJh#�X�z�V�}��F�!��4e��D���f��yU��LT\"n�↙ ���.ڑ��+C[��dP��I�$f����x�у�`�*�kq�&��.���h�g������3���C��%)A���놲>֢�T�v���$�4,j`$�#ACυ|����b�?��f��A�'XHoE��,��y��ƈP��Xh�F���ϓ��(6����_��N}���b^y˛�$�Y����c&� �XP��R�7�d�~�ɇʐ��/E� ��iFjl|��L*^bk�G� �8Jב��{�)���b�p���/��Hc�w��X(�f~��_�p��n�F���D��G������s}Z �:�ߡ��MH
�J�I��e��B9w�`���+0g ��������L�<����
�=��,�Y��� Y٪���%J��G�&����t�)� ���2���-��|C�
�v�:�s{�y�:"۠�Ї�u�d}�=�xRd�N����L�r/�� 4����,2�0�dpɲ���F}����O�aT�!��?�K�0�K�!H�
���>yZ��|E�(9ң��g�0l^*�@ܚ�����=�T2tK��h��fs��=�`a���"4����p��vL#.:-O(��X���ٌ�[d���6����}�a�w m4��9�l"rk��b����`�m�v�A�oi-Q�*��x% ���u�T�E��2��QT�G�SU��l,�>�"�Ok�R�����.���
#��-�T���;��"�n"Y׃�¶\�+L��ę��#X�.I�q�*�=$���d`�9���\�2��q=����"Xpd1;��Н[c�\��ņA$/�:����FW'G�8{Im�eJdS�QC��͠ẩ���d�>Z�e�Y��������_lG�ov���t��s��#��� Q"�#%q�T�vC< R�I����K_0���|��!�͉�������� !��륾V2i�f�}8cP�C��*�E7|���ǵ�� $��{������}���A��ۡ��,8�����h��ZlZ��dZd�O��}lj-��Z<��@UZ|-̢&-��*�&��a��j5��s��������R��}���\�I�`c�٥�ʼn��f�t�g̫�����o��Mq�e␥w����c����B ֬�u=��5Ƙ�ע
>Y6ޝ�Rr��T9U�pd���qJv����G�,�Ȉ����ş�%��ȼ�~�ś-�;��z�R"�Zx����TQ��g�ЂM-��5uf�-te6xx]��yz,��1tJǬ�RB�cl[V�ά5�&ހ^�]AN�-�o����]�3�qn��u-��]���X,h��9���\��.��l��w��Y8�B���{�B֝^Q����Y��OF��H/Z�E/�J. ���?����瑅�d���i���
)�y���5kɹ�N���P�l��\�ҢI�T��f1�h�����->�.]�F/�Wyc�,c'�j��`-�ʴ$-pEg�@]���-0��i?[�d�garbչ��Y-
�pL����x��Q6qPZD��u�ֆ-��(��Jh!�����Y��i���"Y c�]q���jϿ!����I|H�M= -���V�>����1�~ ���@7���iN��0�N?^x�21��ّ�'E0hgЂ�ʛ���]�Yx$ڥ8h1Y�UYwJV�yͰ�tl�IJ���g���L�U+[z�8�7��d�،b�̩���kk��ܕ'�yd�t�G�e:�+DQ�`�F�#��Z�0�����n�G������;�G
'��Z�̹����گ��)8\�R�9
-|Y1���b� -p?�&�|FZD5�ojh�6i�1��,~��t�j'��G�쫴X�f~�Weޅ��c�F�²&��5�H�1����3��]��Z��:~��dk�2V����C�b���,��E�La�nd�[��Rla�M-XK���"��3W���N���닲��{���_��zday�e���cE{3?�F����
�{8�dI��<�ο��ƦMz���#��
R��G�ԟͥ_��͗��\nV��#���N,e݉�^�pS%�On|����c��
$\֝<�;��l.hOZh�W����]� /��쐴HF%i!Z�bQx���v��75��58�5��iZ�n:��;
mh����~D��.7R=��~D���LnC�]�����
-p:T�5|O lm>F��OƋ�%U�m��Q��ǏԿ+�疻���{i;�!>����\���;��;//-�l�%�ʖ��F�,��طP�Wn�N�=Z�v�ڎq�Ɲ\`�79'"��-C��W�m4wm��6`a�Y�>�[����XJ�_����\���}����[9�W�mh�|Ԧ��w�Hp?1T��7:�ׇZ��Q���>Y(Ң��b�5��[7�A��Eȥ�!�~�x��o��^���k�O�{�?��?�,�������Zh�b�i�Ӝ�h;^������6ۉ����i�b�ۇ��p����[p��<�9�e���/�%�
���
���W�!d�|�d#��i�Mr�|��e�"�-y���w�-�PƔq�3� ���ה�S�{�*?U~������j����w�vE1�_��(TS�-.F�"�]c�B����D����
k�<4���5�0�O�k��G��qTԪ1&>��cm|�cE��;?�#�j<�������;��;��?��L����$��^��3��Y
IJ�h�bn�36�-d�l5[�6����}�.���?��x�w@�x�����|&���y3��w��(?ǿ�W�m)\�)i�UzF&����)R��Hj�~'m�>��H��2��r��&g�y���\./�_��˭����O��|SaJ��O����LV^Vf)s���*��e��{����rV�\��rI�T���Fդ�V5��KV��5S��"��vݑ�������a$��I�AT�R�R�(VP�,�.�UU \�A��D�`5�H���=iO�G�(]j2��"F�U�vF�5�S��+�?B����d�P�@&�3�0��p����/b�*#��� �F�H��H1��L�����aw�Ec$ԃ��Qn�1U1���E��Bד�!\
'��g�>$#�3�sQh"t�0F u�
�q�B��:EX�N?�#�:����b����_����<��
(n���\���B=X�z�
����(�:�=EO�5e����tݾ�oE�^��H����{�����a���V�(�֭]�o�u`]��� ,{�ulc��U���u�֎��{f70*���WH�r��7��,��ؘ�R�d(q\Ré9���h}��i�CI��}�~>e���_�2-���%�>�xbY~ui�ϽͶ�+c=1Y6��������ɦ�'��d�/{ը0��ӅO�Wqy�)�����#�aa��4���e��W�
H���_Yv��V��B��Q����U�t�}�(y�tok�����NQǴ�����+у���p��r�T�BGUb���3'B���]ki=z(�d��x�����7�����5s�o�>7b]��p1����uU���˲�
S����e�LH<�����T�a���~�JB~��-D�[t;{��<�3��㈸����>�_�u��eA~C^Ib�uYhޢ6��k��ՉUޚ�m��P���~��EG��#�|Y�}Ɩ3c1>�3�|�@�J��Tq����|հ�hB}���d�w֮�ݬn���@���O7~0�/�o?xh>�0��M:��Kղ��I�lc��X��+7+�;ߠ�5}��2������ܮ��%��L�Θ�&S����f�6��D��"��o�hf��ے��=�G�͍�Q���~F�Ca��p/����#��ߕ���)s}I?��a�Ǿ�#��u��ʇ��{�?��-��X��P�! w��@�?C�'�
�!�@>�[�yx��
/Bf^��5XUPK1�Z ��-h�?@+f`;`7��p�3p.���:�CB�Y�gD4�M�H��Dv��� 9N>!��g�^"W�
�N���Jx�S3��O`��LSi:B3���ѱ�3�h�J���;��y�?�Хt]E��Y��~����\�0=J?���g�"�L�ѯ�
�No�N`�1�1CY8晑,��b}X,�cϒؓ�?{
ie�3�;�H�E�`T�Ȓ(�%�ŨĘ^J���
2���]�DM�>�.S)&��W�KX𠅌�U�Nx��~y���J�'�!{Q]�H1>4~�b$T�eJ降�3b#.�S��paW4
�{u���A]+h�R�KA��/�̑�fI��Ab:s�� �dI��B��(��qܿR `Sd��ت}4)����sj�]�Tk��fT48|��?p8y���I}},I�R�M��t85?Qr�A�9�v�wbU�P��{��H?��{�,u�I���'��g�M.B�jմ��v)�F�)��Z��5<ߙ�Ҽ�7��ՆkӦ�q`�%^��8����X8->�+�n����~z?\��u�����2�:�D�0�H���9��>�=�g��b--Ƿ���m��Z\.�
�;R|Λs�9<+�./8�X��ޮV����zc�G��m��lA�t�,)�O<]�I��
A�%���t�I6�����Z\��葚:��Ԙp�����+S�����C�^���,>h|�!pKn�J9��]�\��0�N�Z�����P�5�?�ӑ�B.@�@�GE3`
r�>��ɖ�<�Y ��d��M�ֈ'K�
�.��v���v��:����3��0샲�� øi�6��Ò��ӴM���� b�4M��Mo��?x�A���qT�'YE�AX�\|D|^}��aD���b�����������c*�۽�����/��d^-? v}�+̹R�Ed�E��C��_d�F�U!g���rD�\ (jy�+��Oׯ<��=�㫐��sD��h���(�Q�+=9Y�S|Jq����(=�*��$?��d�6�~�:�O�ۥ��%���3��R��ҷ�7�oRY�b������=T��Bp�ظV�����zH�>���s�_�X /,�ź��^;$s_��H���'������.�>�8?��'i�r_�s�i���5��>����5�.�/��cs��6+�@ą3�7�(8s�4�d�,*��vG�x���n2�EjKP��I��y��k�Zj����S�0�fh"�A��]K�EH@�4��cu=��~8=I;��a�Ѧ� �5�o1���V�����Ͱ�$� Z �T�Ev�zt�櫭�GgO�<�O"��uZ�*0��s��%�����˨Ç�ii�%��1��HԆĶ��c��
F�`z�O���n�ܤ�*��q���B�J2O�����d�"��`���/��qo�(`��b��K�%1]��$syٙ�hV��.��9���,#Rזa�q5PAKO>f�-�<��u�'�����!=��0�k��O�Q��p��Q��~�Q�9��>��(��e��=F6�ȱ�ɱ�13u;�W�6�^T]� GG|z*w��)�:�lOeͳ8ޘ���Z�.��H�V@��X$}�4]��! KM��J�M� �,��a�02�-s��Lt]nM�jkT�)�peɤձ�9̪��Q86v{z�UE�����2���W �w�<��W������?�y~��'����_��+�����������g��yT����o~��0`EA�%!UB5B��7Ԋ�h@�J�A�H��Fe�DH�B� .�Q1�I
�Q\��ip�}_�x��?==�?�w~��}���w�94�%��>�\���m��[�]aǵ�����Q^�n���8�r1�)�N*��u���#�2�������#��c`�T�ɾ�b4�qi[斯���ظ�D��Yiq�j3>O�$ѭa��+�����/\յ���o�������ʲ2��5�(�v�>}����U��U���H��8�ao�y>��fzG��:�U���ͧ)��΄l�k�촶��E���S���K����[˾v�2����m-u��e�ת�-��{N�I�ۼ�F�uWv�K�z�+w;_:�+�=��Ƽ�� �����;�K�>9�Ȗq���+��6U2/y�*����{*o>��|�|����)��Q���=Y]��oK�/��T���j�>���ږ)1E�G>���k�:�j��� 1�%�y7ێ�ď���Q�����қӔ�Kw��N�_7��G5?vsu~�c4!���+����f��K���9rPph������yC�K��}v�hnㅼ٫��5�kO�V-��T�Ys����J5�����W2I�G�P0
�|��5It����fP�Eӏf=S�9
��I.��h��g2IZ�(�|�P:H�h7�c�����J�4�Ɩ�~FcG3��^G�~��ɉ�o��ՒM�?:C�"KR��dI �<YR@�@��>�������G��C�|��߃w�N�l���y�-�I �EN�2}�x�^��+��?�V���w�k�+�"�C����4�s_B�%�J:��B�9��������$�9��7�'���Q����`-XC�(��Uӛ�i���F�j�"[�T�rYl��J���`��a��ĥ��F1?�$zx��T�{k�ܧ�c-�ܣ��Bw���� �ȉ��[Z�)Z���X.E�p����F3�B�}1z/����^!�EN�'42�F�]d`~�s"��������]�c�F/1�B�܌6��Wp#���z^�2�C�|Xׂk0��L����0{���B�
\iY;+90e�2尧���D�m�'���ʖlX���-Y��{U�"3���s���NXd���Јh5�.��(��7�~��T4��%��ņ6�f�5��9��Rf!,i���O��al��
c]*f?c�RP'���3��tp8��@�OE�
�s
�p2�Ɓ���I�'�1�k�`4���#���ˈ�����<�-
����`�-�r����X'���P���3}!�����ɛ�P�[伱B�A�=Ɏ9�\���er�~�H��(�� �AWC�:p���(�:����;ϑ=�����#���ߢG���(d��AQ��eM_��m@k�
�P Sͻ�L8�gɠ��@�Ɵ�_���,n}?���SϏ�$)ze�d��U~��t���
�-�+�����X�N
y��m��J�,q��ء�[����'�z���6��rҰ��pYg=�9ixq
`��8hy�\YHݴ<]�Xv#7ng0
�v�p���u������rION*^�^�y���g8�#9�����C2��Pl��9X����A���[,��7)�Ŝ�������F-4��7�!��o_��a}�5'����?I��$�,R�0k%�%+�BI#�Z�^ ����M~�������ݓ��m�]����jl�_�N�Qr��j�^P��Z�Q�{����,��Ѩ�TK�r��x]WQ���rw{w��Cp�x�$� �����=P��<]�Hx�O/�ئ��4ټӜ\j=y��S��ӿ%B�$=�����#����ze5K.""�֬q�u�++8�Yl�1Y��Y�r���'DD��f,��:��3|�E�y9�O�h>wb����fs���t.�ۋY�ŷ�_.��X�
|eS�k�6�GinZ=`�;?{��3�BJ�V(Xxzu�x_H4=1�>yߪ^�����K���
endstream
endobj
38 0 obj
<<
/Type /FontDescriptor
/Ascent 813
/CapHeight 0
/Descent -176
/Flags 4
/FontBBox [0 -143 976 814]
/FontName /DLPJDD+ZapfDingbats
/ItalicAngle 0
/StemV 0
/FontFile2 39 0 R
>>
endobj
39 0 obj
<<
/Filter /FlateDecode
/Length 4941
/Length1 7996
>>
stream
H��mlg����.M�֫�.�@�\��rB>'q�6����8�㏳5!�?'��1I��*[;oն?����B�C���P[@+�@0
��$�bC��?�hx��BB��=y����z}��6�`vf�op֞���_#ij�����j�?ϯ��}��۷��]�//�ֿ'���VX(�����A���"�B^��}��/3��p��E�}��>^(U6_;0�
���?S\�j@_}�#*�RI�,�o����A}���h����h�rV+��;j���G.�˗��Ͼp��������� z~�A��h�3�쾇�S��{���lu��"{����������e8Lv�#�`�����Q~�|~�0��Ϳ�o������{�[�-�#B�0�i~���ƺ�/����{���}N�i���IC��I�V/��������z�S��=�$�v�"�P:�e�������������>���[&�7q��0B��f#�K���:B�o)������F���w��
�X��W����d�o�i�� ���e#Qa���&��4��ɾ������x�Va[!��m����0a~�-���ZQ�"{��L���y �� ��/�yO���l�rn�Ua�M!\D��~y� n�� �� �+0�e@d���(�}1l�a��݉z]0�tϖ������z�Ɯ���
|�}"��O��9�P���c,A�yŨC��6���6�P=7N�x�<PL���D/=^��$����O�1� @?
��:�a]L^ P��}u�_Aڜ�
�>�&���v�9ͷ1��0��X��n]�'�{���i���A��g0��!�
��p6��XR��8o9�=q�W!��+H[�4������O�{ip���v����w�
N�h�;Ε� ��"w����;C�Jc5�� r��r�X��Jf��w'?��z��/��w$�l��O�n��TF��.:�M2��`&�L�%������jn-���L�\te�3N9�k��R˥rN��.�J����9���2+�sC��de`���$�g�Xq�Ny\���Bѷ>27rV�xH�������rB쯔��0wTV��+ˉ�D0�-;5��]���V+�Kޅi�4)OmN�6�9y+�yF����)�&W6���`T����|"����jn9J��JdEU�J~`8����������;�$������h~`F
��KSٲ�J[a��к2)�cC%W2��y&WB�ѡ�x��
lzbK��⦿����\��J�/X[LE��T$�q�bjY ���1us9ͺ�G����s����b*6�����J@r����v�Iq�|g���$w�$Up��rU�����n���3���ϙ�y����������E��x1P��&V^����(�xA
��`I�(y"��b儀�<\�Ze�_}���?�����kE���mE���Qݦ����3�����#�+T���8(��'��i�p4����Ta���h0�72LUQ�,��Dn�Nh�J=F& ��R�&�6E'�@�?@
��fbA�@��?["�!�P1YSP֝�}u?�J�q�r��C�mB���D�A9�y�c �hV�IEsҪv0B1�3��!~M��t>�N�D��#r�(J���h�"��P���0:��+n*��E'*!u���"���I+�`Ŋ�a�04�7TNꙪ��`,FC9x��:u�ҪJf8}B��N���p�Pv�|�ziR�*Q�s�X����b��iO�Ec)�%a��L`�Q>뫔�0YlF���wꪊ�Y���!vN�׳"4"I��$yo$��%oK~D�TX��c|������'}FI�yҕ�Q�Hm�{�gx����'�5%�X�%@���s���iN�8�j��TÊ�h҆�U�(�`gA�e�Hp�JQb���T��]�l�MR��'�b�%�\�X�0)$3��W�Ry'��=Zt���#'05#r��G�"[��Y��<�Fx3y� ���J(�[c�T0�Ǜ��C�`=�4��Ña�@�T`ūVhI ���.C�$����i���6�4K�d�.+��f�<�gb�?����r�B�U�}%s�k�?�iAJFd�9��Tؗ�F9���©����2�%O��/���Y`�y�=�O�������L��@~��v<���~𗙓O�z�g�����iϯ_4!���3]y���~9�%����φ�B�%�{���>Uo۳v���C�_�������>}���g���[ܦ��+���kGf�83�6�t���������I_�}����������pς����;�<Y���.>�u.��s��w�g�|4�yg��Ɇ���ʗ�������Sbߖ+3���㿢O\_�,�_O�����eS�h��i��U!ӫ��.zϡS�o���=w_طx�f��տ;��+�\�g>W,�66�ޘ��5���j*��H?ќ^k��;���7�w����+��{ƾZ��JIK�A��PG��� �N*`��q���H
�<��l�1�R-�Aҧ��#0�Z����V�{6ι��D���}��!`�L�uo'k���ƘG���.`K`W�-:��3���6���6��������o��*
���+@k|A���We6)7OX�n���b�0�ǘ�.���e��;̮���n��.�2���M����Z�=���架�6s�e�bn�p@�i�dn�t��:;��Vo���ݖ_2��[��8�}�{�,�]�X7�737^�ybơ����?���ּ���f���Xn7���ah����B��÷.������c��5������Y
���j�i"��绷�b����k�Т���t�(�Q)#DyDE#h��3FcbB����
c�RW��Lt�/0F����.]�2�{Ϝ�n�9�dnJx���#���'P�XX�.�
����qx�Pc�bGm����A�S!|*�^ȃ�U�P�@)�������~��vB8fB�c�k:�ြ2���9)�R��@������P ,����$��K�xP���
�{���UQH`���J`���?j Ӝ��2�d��lm1�c(D1��BjQDCF.�b2�}!��0w�aV0�f��9���2�LGK�pĿ��>����ε�\ƒ�A�*4i/�Y�!77`�2�Y~�,�o���JJ_Y9u��B�˪�vCX��+}r�5��GѢ�%}կ��,f)ȴ���f�V��"�9{��j�����K]I$�2�.�jH�jHm�����li���Z�����n�LˮhpcD�Z�?�qU&���W�k�vl�?4��2��/Ǔ5cǔ���6�zS�~���ۯ�4nl\����Ao���k�F�?�S3j��T";�6V��J�r֤��Ƃ�d�X�������Xa�,�۷'���όf&&�F����NE�>����1��ˮ�;4���2U��s�>�n[�|���=aV��b}������?�?�M��X�V�bU�A?C-��
endstream
endobj
40 0 obj
<<
/Type /FontDescriptor
/Ascent 753
/CapHeight 562
/Descent -246
/Flags 35
/FontBBox [-28 -250 628 805]
/FontName /Courier
/ItalicAngle 0
/StemV 51
/XHeight 426
/StemH 51
>>
endobj
41 0 obj
<<
/Type /FontDescriptor
/Ascent 750
/CapHeight 653
/Descent -250
/Flags 98
/FontBBox [-169 -217 1010 883]
/FontName /Times-Italic
/ItalicAngle -15
/StemV 76
/XHeight 441
/StemH 76
>>
endobj
4 0 obj
<<
/Type /Font
/Subtype /TrueType
/FirstChar 32
/LastChar 121
/Widths [250 0 0 0 0 0 0 0 0 0 0 0 250 333 0 0
500 500 0 0 0 0 0 0 0 0 0 0 0 0 0 0
0 722 667 722 722 667 611 778 778 389 0 778 667 944 0 778
611 0 0 556 667 0 722 1000 722 0 0 0 0 0 0 0
0 500 556 444 556 444 333 500 556 278 0 556 278 833 556 500
556 0 444 389 333 556 500 722 500 500 ]
/Encoding /WinAnsiEncoding
/BaseFont /Times-Bold
/FontDescriptor 32 0 R
>>
endobj
5 0 obj
<<
/Type /Font
/Subtype /TrueType
/FirstChar 32
/LastChar 151
/Widths [250 0 0 0 0 0 0 0 333 333 0 0 250 333 250 0
0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
0 611 611 667 722 611 611 722 722 333 444 667 556 833 667 722
0 722 611 500 556 722 0 0 611 0 0 0 0 0 0 0
0 500 500 444 500 444 278 500 500 278 278 444 278 722 500 500
500 500 389 389 278 500 444 667 444 444 0 0 0 0 0 0
0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
0 0 0 0 0 0 0 889 ]
/Encoding /WinAnsiEncoding
/BaseFont /Times-Italic
/FontDescriptor 33 0 R
>>
endobj
6 0 obj
<<
/Type /Font
/Subtype /TrueType
/FirstChar 32
/LastChar 151
/Widths [250 333 0 0 500 0 0 0 333 333 0 564 250 333 250 278
500 500 500 500 500 500 500 500 500 500 278 278 0 0 0 444
0 722 667 667 722 611 556 722 722 333 389 722 611 889 722 722
556 722 667 556 611 722 722 944 722 722 611 0 0 0 0 0
0 444 500 444 500 444 333 500 500 278 278 500 278 778 500 500
500 500 333 389 278 500 500 722 500 500 444 0 0 0 0 0
0 0 0 0 0 0 500 500 0 0 0 0 0 0 0 0
0 0 333 444 444 350 0 1000 ]
/Encoding /WinAnsiEncoding
/BaseFont /Times-Roman
/FontDescriptor 34 0 R
>>
endobj
7 0 obj
<<
/Type /Font
/Subtype /TrueType
/FirstChar 222
/LastChar 223
/Widths [556 556 ]
/Encoding /MacRomanEncoding
/BaseFont /Times-Roman
/FontDescriptor 35 0 R
>>
endobj
16 0 obj
<<
/Type /Font
/Subtype /Type0
/BaseFont /DLPJCL+Symbol
/Encoding /Identity-H
/DescendantFonts [ 42 0 R ]
/ToUnicode 43 0 R
>>
endobj
42 0 obj
<<
/Type /Font
/Subtype /CIDFontType2
/BaseFont /DLPJCL+Symbol
/FontDescriptor 36 0 R
/CIDSystemInfo<<
/Registry (Adobe)
/Ordering (Identity)
/Supplement 0
>>
/DW 1000
/W [
65 [986]
]
>>
endobj
17 0 obj
<<
/Type /Font
/Subtype /Type0
/BaseFont /DLPJDD+ZapfDingbats
/Encoding /Identity-H
/DescendantFonts [ 44 0 R ]
/ToUnicode 45 0 R
>>
endobj
44 0 obj
<<
/Type /Font
/Subtype /CIDFontType2
/BaseFont /DLPJDD+ZapfDingbats
/FontDescriptor 38 0 R
/CIDSystemInfo<<
/Registry (Adobe)
/Ordering (Identity)
/Supplement 0
>>
/DW 1000
/W [
3 [277]
22 [754]
]
>>
endobj
24 0 obj
<<
/Type /Font
/Subtype /TrueType
/FirstChar 32
/LastChar 121
/Widths [600 0 600 0 0 0 0 0 0 0 600 0 600 0 600 600
600 600 600 600 600 0 600 0 0 0 0 0 600 600 600 0
0 0 600 600 600 600 0 0 600 0 0 0 600 600 600 0
600 600 0 600 600 0 600 600 0 0 0 600 600 600 0 600
0 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600
600 0 600 600 600 600 600 600 600 600 ]
/Encoding /WinAnsiEncoding
/BaseFont /Courier
/FontDescriptor 40 0 R
>>
endobj
25 0 obj
<<
/Type /Font
/Subtype /TrueType
/FirstChar 222
/LastChar 222
/Widths [500 ]
/Encoding /MacRomanEncoding
/BaseFont /Times-Italic
/FontDescriptor 41 0 R
>>
endobj
43 0 obj
<<
/Filter /FlateDecode
/Length 217
>>
stream
H�TP�N�0��91��n��r,8-��-����п'��C��g?�g�K�ґ� �ٛ#��,��W67�A��:��d3�2��m�8w4zh!?�p����0<=V'�ol�M 9�ϯ��k?8#E��m��(��U���d!���T��]�[\�6Ț&����u{$�~�n���,�mU?�V��ϼ|�݇Y���rx1�-8��o�Y-��`�Yj�
endstream
endobj
45 0 obj
<<
/Filter /FlateDecode
/Length 228
>>
stream
H�T�=o� �w~�Ǟ:@��U���d臚�;N�t�!��@�;u��~��S��y��P0=&���KX� �qr ֙�G�6���3�oK¹�c��e�3'�D�
��8'���������~��3���#�W���+x�-"�7��`q�� i?!�B��*O����g�:��G�UK����9*�ٽ�t)?��2+Q6\�PmC��uS1�2��+�m'
endstream
endobj
1 0 obj
<<
/Type /Page
/Parent 9 0 R
/Resources 3 0 R
/Contents 2 0 R
>>
endobj
10 0 obj
<<
/Type /Page
/Parent 9 0 R
/Resources 12 0 R
/Contents 11 0 R
>>
endobj
13 0 obj
<<
/Type /Page
/Parent 9 0 R
/Resources 15 0 R
/Contents 14 0 R
>>
endobj
18 0 obj
<<
/Type /Page
/Parent 9 0 R
/Resources 20 0 R
/Contents 19 0 R
>>
endobj
21 0 obj
<<
/Type /Page
/Parent 9 0 R
/Resources 23 0 R
/Contents 22 0 R
>>
endobj
26 0 obj
<<
/Type /Page
/Parent 9 0 R
/Resources 28 0 R
/Contents 27 0 R
>>
endobj
29 0 obj
<<
/Type /Page
/Parent 9 0 R
/Resources 31 0 R
/Contents 30 0 R
>>
endobj
46 0 obj
<<
/S /D
>>
endobj
47 0 obj
<<
/Nums [0 46 0 R ]
>>
endobj
9 0 obj
<<
/Type /Pages
/Kids [1 0 R 10 0 R 13 0 R 18 0 R 21 0 R 26 0 R 29 0 R]
/Count 7
/MediaBox [0 0 612 792]
>>
endobj
48 0 obj
<<
/CreationDate (D:20201119110005-05'00')
/ModDate (D:20201119110005-05'00')
/Producer (Apple pstopdf)
>>
endobj
49 0 obj
<<
/Type /Catalog
/Pages 9 0 R
/PageLabels 47 0 R
>>
endobj
xref
0 50
0000000000 65535 f
0000078410 00000 n
0000000016 00000 n
0000005560 00000 n
0000074764 00000 n
0000075207 00000 n
0000075725 00000 n
0000076301 00000 n
0000047914 00000 n
0000079056 00000 n
0000078490 00000 n
0000005688 00000 n
0000014714 00000 n
0000078573 00000 n
0000014843 00000 n
0000021986 00000 n
0000076475 00000 n
0000076821 00000 n
0000078656 00000 n
0000022139 00000 n
0000029596 00000 n
0000078739 00000 n
0000029725 00000 n
0000033767 00000 n
0000077187 00000 n
0000077647 00000 n
0000078822 00000 n
0000033911 00000 n
0000041023 00000 n
0000078905 00000 n
0000041152 00000 n
0000047785 00000 n
0000048054 00000 n
0000048256 00000 n
0000048456 00000 n
0000048653 00000 n
0000048850 00000 n
0000049040 00000 n
0000069152 00000 n
0000069344 00000 n
0000074373 00000 n
0000074564 00000 n
0000076618 00000 n
0000077819 00000 n
0000076970 00000 n
0000078109 00000 n
0000078988 00000 n
0000079016 00000 n
0000079179 00000 n
0000079302 00000 n
trailer
<<
/Size 50
/Root 49 0 R
/Info 48 0 R
/ID [<02520166e9790ee3952417697513653c><02520166e9790ee3952417697513653c>]
>>
startxref
79371
%%EOF