Re: Documentation Tools (from Procedure types)

From: [at]} <skulski{>
Date: Mon, 29 Nov 2004 11:44:54 -0500 (EST)

----boundary-LibPST-iamunique-1006108548_-_-
Content-type: text/plain

> I have forgotten the arguments for Xaxis (maybe I've
> even forgotten how to spell Xaxis). I wan't quick access
> to the Docu (or maybe just the interface). If p.Xaxis
> was a static procedure (eg LibPlotters.Xaxis) that would
> be easy. But since it is a type bound procedure I have to
> search myself.

Searching happens all the time. I have a habit of copying-pasting Xaxis
docu from your documentation into the text of my code. After I am done
with development I create a fold and write in bold blue "here is the Xaxis
description". A few months down the road I will have this info where I
need it. It will become obsolete when you change Xaxis with the next
release, but then the compiler will tell me something has changed, and
hopefully I will be diligent enough to update the fold.

Ugly but workable. An automatic facility would be nicer. But who would
work on this now? There are more pressing things to do, such as BlackBox
for Linux, BlackBox for .NET, etc. Having the latter would be even nicer
than having automatic Xaxis documentation.

W.

--------------------------------------------

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-1006108548_-_-
Content-type: application/rtf
Content-transfer-encoding: base64
Content-Disposition: attachment; filename="rtf-body.rtf"

e1xydGYxXGFuc2lcYW5zaWNwZzEyNTJcZnJvbXRleHQgXGRlZmYwe1xmb250dGJsDQp7XGYwXGZz
d2lzcyBBcmlhbDt9DQp7XGYxXGZtb2Rlcm4gQ291cmllciBOZXc7fQ0Ke1xmMlxmbmlsXGZjaGFy
c2V0MiBTeW1ib2w7fQ0Ke1xmM1xmbW9kZXJuXGZjaGFyc2V0MCBDb3VyaWVyIE5ldzt9fQ0Ke1xj
b2xvcnRibFxyZWQwXGdyZWVuMFxibHVlMDtccmVkMFxncmVlbjBcYmx1ZTI1NTt9DQpcdWMxXHBh
cmRccGxhaW5cZGVmdGFiMzYwIFxmMFxmczIwID4gSSBoYXZlIGZvcmdvdHRlbiB0aGUgYXJndW1l
bnRzIGZvciBYYXhpcyAobWF5YmUgSSd2ZVxwYXINCj4gZXZlbiBmb3Jnb3R0ZW4gaG93IHRvIHNw
ZWxsIFhheGlzKS4gSSB3YW4ndCBxdWljayBhY2Nlc3NccGFyDQo+IHRvIHRoZSBEb2N1IChvciBt
YXliZSBqdXN0IHRoZSBpbnRlcmZhY2UpLiBJZiBwLlhheGlzXHBhcg0KPiB3YXMgYSBzdGF0aWMg
cHJvY2VkdXJlIChlZyBMaWJQbG90dGVycy5YYXhpcykgdGhhdCB3b3VsZFxwYXINCj4gYmUgZWFz
eS4gQnV0IHNpbmNlIGl0IGlzIGEgdHlwZSBib3VuZCBwcm9jZWR1cmUgSSBoYXZlIHRvXHBhcg0K
PiBzZWFyY2ggbXlzZWxmLlxwYXINClxwYXINClNlYXJjaGluZyBoYXBwZW5zIGFsbCB0aGUgdGlt
ZS4gSSBoYXZlIGEgaGFiaXQgb2YgY29weWluZy1wYXN0aW5nIFhheGlzXHBhcg0KZG9jdSBmcm9t
IHlvdXIgZG9jdW1lbnRhdGlvbiBpbnRvIHRoZSB0ZXh0IG9mIG15IGNvZGUuIEFmdGVyIEkgYW0g
ZG9uZVxwYXINCndpdGggZGV2ZWxvcG1lbnQgSSBjcmVhdGUgYSBmb2xkIGFuZCB3cml0ZSBpbiBi
b2xkIGJsdWUgImhlcmUgaXMgdGhlIFhheGlzXHBhcg0KZGVzY3JpcHRpb24iLiBBIGZldyBtb250
aHMgZG93biB0aGUgcm9hZCBJIHdpbGwgaGF2ZSB0aGlzIGluZm8gd2hlcmUgSVxwYXINCm5lZWQg
aXQuIEl0IHdpbGwgYmVjb21lIG9ic29sZXRlIHdoZW4geW91IGNoYW5nZSBYYXhpcyB3aXRoIHRo
ZSBuZXh0XHBhcg0KcmVsZWFzZSwgYnV0IHRoZW4gdGhlIGNvbXBpbGVyIHdpbGwgdGVsbCBtZSBz
b21ldGhpbmcgaGFzIGNoYW5nZWQsIGFuZFxwYXINCmhvcGVmdWxseSBJIHdpbGwgYmUgZGlsaWdl
bnQgZW5vdWdoIHRvIHVwZGF0ZSB0aGUgZm9sZC5ccGFyDQpccGFyDQpVZ2x5IGJ1dCB3b3JrYWJs
ZS4gQW4gYXV0b21hdGljIGZhY2lsaXR5IHdvdWxkIGJlIG5pY2VyLiBCdXQgd2hvIHdvdWxkXHBh
cg0Kd29yayBvbiB0aGlzIG5vdz8gVGhlcmUgYXJlIG1vcmUgcHJlc3NpbmcgdGhpbmdzIHRvIGRv
LCBzdWNoIGFzIEJsYWNrQm94XHBhcg0KZm9yIExpbnV4LCBCbGFja0JveCBmb3IgLk5FVCwgZXRj
LiBIYXZpbmcgdGhlIGxhdHRlciB3b3VsZCBiZSBldmVuIG5pY2VyXHBhcg0KdGhhbiBoYXZpbmcg
YXV0b21hdGljIFhheGlzIGRvY3VtZW50YXRpb24uXHBhcg0KXHBhcg0KVy5ccGFyDQpccGFyDQot
LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLVxwYXINClxwYXINClRv
IHVuc3Vic2NyaWJlIGZyb20gdGhpcyBtYWlsaW5nIGxpc3QsIHNlbmQgYSBtZXNzYWdlIGNvbnRh
aW5pbmcgdGhlIHdvcmQgInVuc3Vic2NyaWJlIiB0bzpccGFyDQogICBibGFja2JveC1yZXF1ZXN0
QG9iZXJvbi5jaFxwYXINClxwYXINClRvIGdldCBhIGxpc3Qgb2YgdmFsaWQgZS1tYWlsIGNvbW1h
bmRzIGFuZCBpbnN0cnVjdGlvbnMgb24gdGhlaXIgdXNhZ2UsIHNlbmQgYSBtZXNzYWdlIGNvbnRh
aW5pbmcgdGhlIHdvcmQgImhlbHAiIHRvIHRoZSBhYm92ZSBhZGRyZXNzLlxwYXINClxwYXINClNl
bmQgYW55IHByb2JsZW0gcmVwb3J0cyBvciBxdWVzdGlvbnMgcmVsYXRlZCB0byB0aGlzIGVtYWls
IGxpc3QgdG8gdGhlIGxpc3Qgb3duZXIgYXRccGFyDQogICBvd25lci1ibGFja2JveEBvYmVyb24u
Y2hccGFyDQpccGFyDQpDdXJyZW50IHBvc3RpbmcgcG9saWN5OlxwYXINClxwYXINCmEpIFRvIHBv
c3QgeW91IHNob3VsZCB1c2UgdGhlIHNhbWUgYWRkcmVzcyBieSB3aGljaCB5b3UgYXJlIHN1YnNj
cmliZWQgdG8gdGhlIG1haWxpbmcgbGlzdC4gVGhhdCB3YXksIHRoZSBsaXN0IHNlcnZlciB3aWxs
IHJlY29nbml6ZSB5b3UgYXMgc3Vic2NyaWJlciBhbmQgZm9yd2FyZCB5b3VyIHBvc3RpbmcgaW1t
ZWRpYXRlbHksIHdpdGhvdXQgY3JlYXRpbmcgYW55IG92ZXJoZWFkLlxwYXINClxwYXINCmIpIElm
LCBmb3Igc29tZSByZWFzb24sIHlvdSBjYW5ub3QgcG9zdCBmcm9tIHRoZSBhZGRyZXNzLCBieSB3
aGljaCB5b3UgYXJlIHN1YnNjcmliZWQsIHlvdXIgbWVzc2FnZSB3aWxsIGJlIG1vZGVyYXRlZCB0
byBhdm9pZCBzcGFtLiBQbGVhc2UgdW5kZXJzdGFuZCB0aGF0IG1vZGVyYXRpb24gd2lsbCBvZnRl
biBjYXVzZSBzb21lIGRlbGF5LCBpbiBwYXJ0aWN1bGFyIG92ZXIgd2Vla2VuZHMgb3IgaG9seWRh
eXMuXHBhcg0KfQ=


----boundary-LibPST-iamunique-1006108548_-_---
Received on Mon Nov 29 2004 - 17:44:54 UTC

This archive was generated by hypermail 2.3.0 : Thu Sep 26 2013 - 06:28:29 UTC