----boundary-LibPST-iamunique-697552334_-_-
Content-type: text/plain
Folks,
Subject: BlackBox documentation
Since no one (yet) has objected to Rex Couture's suggestion that I 'lead
the effort' for developing extended BlackBox documentation, I have the
following suggestion.
Let's call the extended documention the 'CookBook'. This choice is
based on the (seeming) desire to keep topics short and concise with an
introduction and a few examples for each topic.
The CookBook can also be viewed as a 'Journal' where individuals submit
articles for 'publication'. I suggest that the submission be in .odc
format (see below).
The CookBook would reside on Helmut's Component Pascal Collections (CPC)
and I will need Helmut to help setup his first page with a leading entry
to the HTML(and .odc) based CookBook. Helmut?
I can act as the initial editor of the articles but ask that a second
editor step forth so that the effort can be shared. I would hope that
everyone of us would eventually act as editor on a rotating basis.
Internal vs external
Using HTML as the medium of publication for the CookBook allows wide
access to this documentation. It also means that the principle of 'one
place only' is violated when it is assumed that the internal version of
the CookBook is in .odc and the external is in HTML. Hopefully the
process of converting from .odc to .html can be automated as much as
possible (graphics, executable code?) (Michael Franz's slim binaries,
http://www.ics.uci.edu/~franz/SlimBinaries.html, keeps occuring to me
when I think of web based executables in an Oberon environment as
opposed to Java).
Let me know your thoughts concerning 'CookBook'.
-Doug
--- BlackBox
--- send subject HELP or UNSUBSCRIBE to blackbox{([at]})nowhere.xy
----boundary-LibPST-iamunique-697552334_-_-
Content-type: application/rtf
Content-transfer-encoding: base64
Content-Disposition: attachment; filename="rtf-body.rtf"
e1xydGYxXGFuc2lcYW5zaWNwZzEyNTJcZnJvbXRleHQgXGRlZmYwe1xmb250dGJsDQp7XGYwXGZz
d2lzcyBBcmlhbDt9DQp7XGYxXGZtb2Rlcm4gQ291cmllciBOZXc7fQ0Ke1xmMlxmbmlsXGZjaGFy
c2V0MiBTeW1ib2w7fQ0Ke1xmM1xmbW9kZXJuXGZjaGFyc2V0MCBDb3VyaWVyIE5ldzt9fQ0Ke1xj
b2xvcnRibFxyZWQwXGdyZWVuMFxibHVlMDtccmVkMFxncmVlbjBcYmx1ZTI1NTt9DQpcdWMxXHBh
cmRccGxhaW5cZGVmdGFiMzYwIFxmMFxmczIwIEZvbGtzLFxwYXINClN1YmplY3Q6IEJsYWNrQm94
IGRvY3VtZW50YXRpb25ccGFyDQpccGFyDQpTaW5jZSBubyBvbmUgKHlldCkgaGFzIG9iamVjdGVk
IHRvIFJleCBDb3V0dXJlJ3Mgc3VnZ2VzdGlvbiB0aGF0IEkgJ2xlYWQgXHBhcg0KdGhlIGVmZm9y
dCcgZm9yIGRldmVsb3BpbmcgZXh0ZW5kZWQgQmxhY2tCb3ggZG9jdW1lbnRhdGlvbiwgSSBoYXZl
IHRoZSBccGFyDQpmb2xsb3dpbmcgc3VnZ2VzdGlvbi5ccGFyDQpccGFyDQpMZXQncyBjYWxsIHRo
ZSBleHRlbmRlZCBkb2N1bWVudGlvbiB0aGUgJ0Nvb2tCb29rJy4gIFRoaXMgY2hvaWNlIGlzIFxw
YXINCmJhc2VkIG9uIHRoZSAoc2VlbWluZykgZGVzaXJlIHRvIGtlZXAgdG9waWNzIHNob3J0IGFu
ZCBjb25jaXNlIHdpdGggYW4gXHBhcg0KaW50cm9kdWN0aW9uIGFuZCBhIGZldyBleGFtcGxlcyBm
b3IgZWFjaCB0b3BpYy5ccGFyDQpccGFyDQpUaGUgQ29va0Jvb2sgY2FuIGFsc28gYmUgdmlld2Vk
IGFzIGEgJ0pvdXJuYWwnIHdoZXJlIGluZGl2aWR1YWxzIHN1Ym1pdCBccGFyDQphcnRpY2xlcyBm
b3IgJ3B1YmxpY2F0aW9uJy4gIEkgc3VnZ2VzdCB0aGF0IHRoZSBzdWJtaXNzaW9uIGJlIGluIC5v
ZGMgXHBhcg0KZm9ybWF0IChzZWUgYmVsb3cpLlxwYXINClxwYXINClRoZSBDb29rQm9vayB3b3Vs
ZCByZXNpZGUgb24gSGVsbXV0J3MgQ29tcG9uZW50IFBhc2NhbCBDb2xsZWN0aW9ucyAoQ1BDKSBc
cGFyDQphbmQgSSB3aWxsIG5lZWQgSGVsbXV0IHRvIGhlbHAgc2V0dXAgaGlzIGZpcnN0IHBhZ2Ug
d2l0aCBhIGxlYWRpbmcgZW50cnkgXHBhcg0KdG8gdGhlIEhUTUwoYW5kIC5vZGMpIGJhc2VkIENv
b2tCb29rLiAgSGVsbXV0P1xwYXINClxwYXINCkkgY2FuIGFjdCBhcyB0aGUgaW5pdGlhbCBlZGl0
b3Igb2YgdGhlIGFydGljbGVzIGJ1dCBhc2sgdGhhdCBhIHNlY29uZCBccGFyDQplZGl0b3Igc3Rl
cCBmb3J0aCBzbyB0aGF0IHRoZSBlZmZvcnQgY2FuIGJlIHNoYXJlZC4gIEkgd291bGQgaG9wZSB0
aGF0IFxwYXINCmV2ZXJ5b25lIG9mIHVzIHdvdWxkIGV2ZW50dWFsbHkgYWN0IGFzIGVkaXRvciBv
biBhIHJvdGF0aW5nIGJhc2lzLlxwYXINClxwYXINCkludGVybmFsIHZzIGV4dGVybmFsXHBhcg0K
VXNpbmcgSFRNTCBhcyB0aGUgbWVkaXVtIG9mIHB1YmxpY2F0aW9uIGZvciB0aGUgQ29va0Jvb2sg
YWxsb3dzIHdpZGUgXHBhcg0KYWNjZXNzIHRvIHRoaXMgZG9jdW1lbnRhdGlvbi4gIEl0IGFsc28g
bWVhbnMgdGhhdCB0aGUgcHJpbmNpcGxlIG9mICdvbmUgXHBhcg0KcGxhY2Ugb25seScgaXMgdmlv
bGF0ZWQgd2hlbiBpdCBpcyBhc3N1bWVkIHRoYXQgdGhlIGludGVybmFsIHZlcnNpb24gb2YgXHBh
cg0KdGhlIENvb2tCb29rIGlzIGluIC5vZGMgYW5kIHRoZSBleHRlcm5hbCBpcyBpbiBIVE1MLiAg
SG9wZWZ1bGx5IHRoZSBccGFyDQpwcm9jZXNzIG9mIGNvbnZlcnRpbmcgZnJvbSAub2RjIHRvIC5o
dG1sIGNhbiBiZSBhdXRvbWF0ZWQgYXMgbXVjaCBhcyBccGFyDQpwb3NzaWJsZSAoZ3JhcGhpY3Ms
IGV4ZWN1dGFibGUgY29kZT8pIChNaWNoYWVsIEZyYW56J3Mgc2xpbSBiaW5hcmllcywgXHBhcg0K
aHR0cDovL3d3dy5pY3MudWNpLmVkdS9+ZnJhbnovU2xpbUJpbmFyaWVzLmh0bWwsIGtlZXBzIG9j
Y3VyaW5nIHRvIG1lIFxwYXINCndoZW4gSSB0aGluayBvZiB3ZWIgYmFzZWQgZXhlY3V0YWJsZXMg
aW4gYW4gT2Jlcm9uIGVudmlyb25tZW50IGFzIFxwYXINCm9wcG9zZWQgdG8gSmF2YSkuXHBhcg0K
XHBhcg0KTGV0IG1lIGtub3cgeW91ciB0aG91Z2h0cyBjb25jZXJuaW5nICdDb29rQm9vaycuXHBh
cg0KXHBhcg0KLURvdWdccGFyDQpccGFyDQotLS0gQmxhY2tCb3hccGFyDQotLS0gc2VuZCBzdWJq
ZWN0IEhFTFAgb3IgVU5TVUJTQ1JJQkUgdG8gYmxhY2tib3hAb2Jlcm9uLmNoXHBhcg0KXHBhcg0K
fQ==
----boundary-LibPST-iamunique-697552334_-_---
Received on Mon Mar 28 2005 - 18:13:13 UTC