----boundary-LibPST-iamunique-1695350605_-_-
Content-type: text/plain
Hi,
well, yes, you are quite right to point this out, and I must admit that I
have never read it through in the way I've read the original Oberon
documentation. As a result I can't really offer any useful criticism of the
content.
I won't try to excuse or justify myself, but I will try to offer a reason:
online and printed documentation are very different things altogether. The
case study is more suitable as printed documentation than online. If it was
available as a printed book, I would almost certainly buy it, just as I
bought Hannes Marais's 'The Oberon Companion' rather than read it online or
print it on a work printer.
For some situations a properly typeset and printed book is easier and more
convenient for me. For instance, I can read it on the tube on the way to
work. Or when I'm using BB I can refer to it more conveniently when it is in
my hand than when it's on the screen. Large tracts of text are not
well-suited to online use. Printing the entire thing is very difficult. My
home printer is too slow and poor quality; it takes too long at work, and is
slightly sinful in such quantities. Most importantly, the format and size of
such documentation is not as convenient as a real book; real books are
rarely A4 and great care is taken about the published format for good
reasons.
Regards,
Bob
----Original Message Follows----
From: Wojtek Skulski <skulski{([at]})nowhere.xy
Bob, but they do provide the "Case study..." book, seven chapters in
total. Just look at Help->Content. What is wrong with this? Is it not
the kind of the overview that you are talking about?
I am myself not a big fan of the module-by-module documentation,
and I must admit I do not like the "Case study..." either, but let's
try be more specific. If we all seem to agree the BB docu is not perfect,
where is the imperfection? What's missing in their "Case study" and how
it could be improved?
Wojtek
_________________________________________________________________
Sign-up for a FREE BT Broadband connection today!
http://www.msn.co.uk/specials/btbroadband
--------------------------------------------
To unsubscribe from this mailing list, send a message containing the word "unsubscribe" to:
blackbox-request{([at]})nowhere.xy
To get a list of valid e-mail commands and instructions on their usage, send a message containing the word "help" to the above address.
Send any problem reports or questions related to this email list to the list owner at
owner-blackbox{([at]})nowhere.xy
Current posting policy:
a) To post you should use the same address by which you are subscribed to the mailing list. That way, the list server will recognize you as subscriber and forward your posting immediately, without creating any overhead.
b) If, for some reason, you cannot post from the address, by which you are subscribed, your message will be moderated to avoid spam. Please understand that moderation will often cause some delay, in particular over weekends or holydays.
----boundary-LibPST-iamunique-1695350605_-_-
Content-type: application/rtf
Content-transfer-encoding: base64
Content-Disposition: attachment; filename="rtf-body.rtf"
e1xydGYxXGFuc2lcYW5zaWNwZzEyNTJcZnJvbXRleHQgXGRlZmYwe1xmb250dGJsDQp7XGYwXGZz
d2lzcyBBcmlhbDt9DQp7XGYxXGZtb2Rlcm4gQ291cmllciBOZXc7fQ0Ke1xmMlxmbmlsXGZjaGFy
c2V0MiBTeW1ib2w7fQ0Ke1xmM1xmbW9kZXJuXGZjaGFyc2V0MCBDb3VyaWVyIE5ldzt9fQ0Ke1xj
b2xvcnRibFxyZWQwXGdyZWVuMFxibHVlMDtccmVkMFxncmVlbjBcYmx1ZTI1NTt9DQpcdWMxXHBh
cmRccGxhaW5cZGVmdGFiMzYwIFxmMFxmczIwIEhpLFxwYXINClxwYXINCndlbGwsIHllcywgeW91
IGFyZSBxdWl0ZSByaWdodCB0byBwb2ludCB0aGlzIG91dCwgYW5kIEkgbXVzdCBhZG1pdCB0aGF0
IEkgXHBhcg0KaGF2ZSBuZXZlciByZWFkIGl0IHRocm91Z2ggaW4gdGhlIHdheSBJJ3ZlIHJlYWQg
dGhlIG9yaWdpbmFsIE9iZXJvbiBccGFyDQpkb2N1bWVudGF0aW9uLiBBcyBhIHJlc3VsdCBJIGNh
bid0IHJlYWxseSBvZmZlciBhbnkgdXNlZnVsIGNyaXRpY2lzbSBvZiB0aGUgXHBhcg0KY29udGVu
dC5ccGFyDQpccGFyDQpJIHdvbid0IHRyeSB0byBleGN1c2Ugb3IganVzdGlmeSBteXNlbGYsIGJ1
dCBJIHdpbGwgdHJ5IHRvIG9mZmVyIGEgcmVhc29uOiBccGFyDQpvbmxpbmUgYW5kIHByaW50ZWQg
ZG9jdW1lbnRhdGlvbiBhcmUgdmVyeSBkaWZmZXJlbnQgdGhpbmdzIGFsdG9nZXRoZXIuIFRoZSBc
cGFyDQpjYXNlIHN0dWR5IGlzIG1vcmUgc3VpdGFibGUgYXMgcHJpbnRlZCBkb2N1bWVudGF0aW9u
IHRoYW4gb25saW5lLiBJZiBpdCB3YXMgXHBhcg0KYXZhaWxhYmxlIGFzIGEgcHJpbnRlZCBib29r
LCBJIHdvdWxkIGFsbW9zdCBjZXJ0YWlubHkgYnV5IGl0LCBqdXN0IGFzIEkgXHBhcg0KYm91Z2h0
IEhhbm5lcyBNYXJhaXMncyAnVGhlIE9iZXJvbiBDb21wYW5pb24nIHJhdGhlciB0aGFuIHJlYWQg
aXQgb25saW5lIG9yIFxwYXINCnByaW50IGl0IG9uIGEgd29yayBwcmludGVyLlxwYXINClxwYXIN
CkZvciBzb21lIHNpdHVhdGlvbnMgYSBwcm9wZXJseSB0eXBlc2V0IGFuZCBwcmludGVkIGJvb2sg
aXMgZWFzaWVyIGFuZCBtb3JlIFxwYXINCmNvbnZlbmllbnQgZm9yIG1lLiBGb3IgaW5zdGFuY2Us
IEkgY2FuIHJlYWQgaXQgb24gdGhlIHR1YmUgb24gdGhlIHdheSB0byBccGFyDQp3b3JrLiBPciB3
aGVuIEknbSB1c2luZyBCQiBJIGNhbiByZWZlciB0byBpdCBtb3JlIGNvbnZlbmllbnRseSB3aGVu
IGl0IGlzIGluIFxwYXINCm15IGhhbmQgdGhhbiB3aGVuIGl0J3Mgb24gdGhlIHNjcmVlbi4gTGFy
Z2UgdHJhY3RzIG9mIHRleHQgYXJlIG5vdCBccGFyDQp3ZWxsLXN1aXRlZCB0byBvbmxpbmUgdXNl
LiBQcmludGluZyB0aGUgZW50aXJlIHRoaW5nIGlzIHZlcnkgZGlmZmljdWx0LiBNeSBccGFyDQpo
b21lIHByaW50ZXIgaXMgdG9vIHNsb3cgYW5kIHBvb3IgcXVhbGl0eTsgaXQgdGFrZXMgdG9vIGxv
bmcgYXQgd29yaywgYW5kIGlzIFxwYXINCnNsaWdodGx5IHNpbmZ1bCBpbiBzdWNoIHF1YW50aXRp
ZXMuIE1vc3QgaW1wb3J0YW50bHksIHRoZSBmb3JtYXQgYW5kIHNpemUgb2YgXHBhcg0Kc3VjaCBk
b2N1bWVudGF0aW9uIGlzIG5vdCBhcyBjb252ZW5pZW50IGFzIGEgcmVhbCBib29rOyByZWFsIGJv
b2tzIGFyZSBccGFyDQpyYXJlbHkgQTQgYW5kIGdyZWF0IGNhcmUgaXMgdGFrZW4gYWJvdXQgdGhl
IHB1Ymxpc2hlZCBmb3JtYXQgZm9yIGdvb2QgXHBhcg0KcmVhc29ucy5ccGFyDQpccGFyDQpSZWdh
cmRzLFxwYXINClxwYXINCkJvYlxwYXINClxwYXINCi0tLS1PcmlnaW5hbCBNZXNzYWdlIEZvbGxv
d3MtLS0tXHBhcg0KRnJvbTogV29qdGVrIFNrdWxza2kgPHNrdWxza2lAcGFzLnJvY2hlc3Rlci5l
ZHU+XHBhcg0KXHBhcg0KQm9iLCBidXQgdGhleSBkbyBwcm92aWRlIHRoZSAiQ2FzZSBzdHVkeS4u
LiIgYm9vaywgc2V2ZW4gY2hhcHRlcnMgaW5ccGFyDQp0b3RhbC4gSnVzdCBsb29rIGF0IEhlbHAt
PkNvbnRlbnQuIFdoYXQgaXMgd3Jvbmcgd2l0aCB0aGlzPyBJcyBpdCBub3RccGFyDQp0aGUga2lu
ZCBvZiB0aGUgb3ZlcnZpZXcgdGhhdCB5b3UgYXJlIHRhbGtpbmcgYWJvdXQ/XHBhcg0KXHBhcg0K
SSBhbSBteXNlbGYgbm90IGEgYmlnIGZhbiBvZiB0aGUgbW9kdWxlLWJ5LW1vZHVsZSBkb2N1bWVu
dGF0aW9uLFxwYXINCmFuZCBJIG11c3QgYWRtaXQgSSBkbyBub3QgbGlrZSB0aGUgIkNhc2Ugc3R1
ZHkuLi4iIGVpdGhlciwgYnV0IGxldCdzXHBhcg0KdHJ5IGJlIG1vcmUgc3BlY2lmaWMuIElmIHdl
IGFsbCBzZWVtIHRvIGFncmVlIHRoZSBCQiBkb2N1IGlzIG5vdCBwZXJmZWN0LFxwYXINCndoZXJl
IGlzIHRoZSBpbXBlcmZlY3Rpb24/IFdoYXQncyBtaXNzaW5nIGluIHRoZWlyICJDYXNlIHN0dWR5
IiBhbmQgaG93XHBhcg0KaXQgY291bGQgYmUgaW1wcm92ZWQ/XHBhcg0KXHBhcg0KV29qdGVrXHBh
cg0KXHBhcg0KX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f
X19fX19fX19fX19fX19fX19ccGFyDQpTaWduLXVwIGZvciBhIEZSRUUgQlQgQnJvYWRiYW5kIGNv
bm5lY3Rpb24gdG9kYXkhIFxwYXINCmh0dHA6Ly93d3cubXNuLmNvLnVrL3NwZWNpYWxzL2J0YnJv
YWRiYW5kXHBhcg0KXHBhcg0KLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t
LS0tLS1ccGFyDQpccGFyDQpUbyB1bnN1YnNjcmliZSBmcm9tIHRoaXMgbWFpbGluZyBsaXN0LCBz
ZW5kIGEgbWVzc2FnZSBjb250YWluaW5nIHRoZSB3b3JkICJ1bnN1YnNjcmliZSIgdG86XHBhcg0K
ICAgYmxhY2tib3gtcmVxdWVzdEBvYmVyb24uY2hccGFyDQpccGFyDQpUbyBnZXQgYSBsaXN0IG9m
IHZhbGlkIGUtbWFpbCBjb21tYW5kcyBhbmQgaW5zdHJ1Y3Rpb25zIG9uIHRoZWlyIHVzYWdlLCBz
ZW5kIGEgbWVzc2FnZSBjb250YWluaW5nIHRoZSB3b3JkICJoZWxwIiB0byB0aGUgYWJvdmUgYWRk
cmVzcy5ccGFyDQpccGFyDQpTZW5kIGFueSBwcm9ibGVtIHJlcG9ydHMgb3IgcXVlc3Rpb25zIHJl
bGF0ZWQgdG8gdGhpcyBlbWFpbCBsaXN0IHRvIHRoZSBsaXN0IG93bmVyIGF0XHBhcg0KICAgb3du
ZXItYmxhY2tib3hAb2Jlcm9uLmNoXHBhcg0KXHBhcg0KQ3VycmVudCBwb3N0aW5nIHBvbGljeTpc
cGFyDQpccGFyDQphKSBUbyBwb3N0IHlvdSBzaG91bGQgdXNlIHRoZSBzYW1lIGFkZHJlc3MgYnkg
d2hpY2ggeW91IGFyZSBzdWJzY3JpYmVkIHRvIHRoZSBtYWlsaW5nIGxpc3QuIFRoYXQgd2F5LCB0
aGUgbGlzdCBzZXJ2ZXIgd2lsbCByZWNvZ25pemUgeW91IGFzIHN1YnNjcmliZXIgYW5kIGZvcndh
cmQgeW91ciBwb3N0aW5nIGltbWVkaWF0ZWx5LCB3aXRob3V0IGNyZWF0aW5nIGFueSBvdmVyaGVh
ZC5ccGFyDQpccGFyDQpiKSBJZiwgZm9yIHNvbWUgcmVhc29uLCB5b3UgY2Fubm90IHBvc3QgZnJv
bSB0aGUgYWRkcmVzcywgYnkgd2hpY2ggeW91IGFyZSBzdWJzY3JpYmVkLCB5b3VyIG1lc3NhZ2Ug
d2lsbCBiZSBtb2RlcmF0ZWQgdG8gYXZvaWQgc3BhbS4gUGxlYXNlIHVuZGVyc3RhbmQgdGhhdCBt
b2RlcmF0aW9uIHdpbGwgb2Z0ZW4gY2F1c2Ugc29tZSBkZWxheSwgaW4gcGFydGljdWxhciBvdmVy
IHdlZWtlbmRzIG9yIGhvbHlkYXl9fQBsaXN0LCBzZW5kIGE=
----boundary-LibPST-iamunique-1695350605_-_---
Received on Mon Aug 04 2003 - 00:21:33 UTC