Re: Documentation Tools (from Procedure types)

From: Fyodor Tkachov <"Fyodor>
Date: Tue, 30 Nov 2004 12:48:02 +0300

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

I think Robert is right here: its a non-feature that is on the surface, very visible.
On the other hand it does not seem too hard to implement it, so it's not hopeless.

Cheers
Fyodor

> > 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.
> ####

Powered by the E-mail PIM - Info Select - www.miclog.com
--------------------------------------------

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

e1xydGYxXGFuc2lcYW5zaWNwZzEyNTJcZnJvbXRleHQgXGRlZmYwe1xmb250dGJsDQp7XGYwXGZz
d2lzcyBBcmlhbDt9DQp7XGYxXGZtb2Rlcm4gQ291cmllciBOZXc7fQ0Ke1xmMlxmbmlsXGZjaGFy
c2V0MiBTeW1ib2w7fQ0Ke1xmM1xmbW9kZXJuXGZjaGFyc2V0MCBDb3VyaWVyIE5ldzt9fQ0Ke1xj
b2xvcnRibFxyZWQwXGdyZWVuMFxibHVlMDtccmVkMFxncmVlbjBcYmx1ZTI1NTt9DQpcdWMxXHBh
cmRccGxhaW5cZGVmdGFiMzYwIFxmMFxmczIwIEkgdGhpbmsgUm9iZXJ0IGlzIHJpZ2h0IGhlcmU6
IGl0cyBhIG5vbi1mZWF0dXJlIHRoYXQgaXMgb24gdGhlIHN1cmZhY2UsIHZlcnkgdmlzaWJsZS5c
cGFyDQpPbiB0aGUgb3RoZXIgaGFuZCBpdCBkb2VzIG5vdCBzZWVtIHRvbyBoYXJkIHRvIGltcGxl
bWVudCBpdCwgc28gaXQncyBub3QgaG9wZWxlc3MuXHBhcg0KXHBhcg0KQ2hlZXJzXHBhcg0KRnlv
ZG9yXHBhcg0KXHBhcg0KPiA+IEkgaGF2ZSBmb3Jnb3R0ZW4gdGhlIGFyZ3VtZW50cyBmb3IgWGF4
aXMgKG1heWJlIEkndmVccGFyDQo+ID4gZXZlbiBmb3Jnb3R0ZW4gaG93IHRvIHNwZWxsIFhheGlz
KS4gSSB3YW4ndCBxdWljayBhY2Nlc3NccGFyDQo+ID4gdG8gdGhlIERvY3UgKG9yIG1heWJlIGp1
c3QgdGhlIGludGVyZmFjZSkuIElmIHAuWGF4aXNccGFyDQo+ID4gd2FzIGEgc3RhdGljIHByb2Nl
ZHVyZSAoZWcgTGliUGxvdHRlcnMuWGF4aXMpIHRoYXQgd291bGRccGFyDQo+ID4gYmUgZWFzeS4g
QnV0IHNpbmNlIGl0IGlzIGEgdHlwZSBib3VuZCBwcm9jZWR1cmUgSSBoYXZlIHRvXHBhcg0KPiA+
IHNlYXJjaCBteXNlbGYuXHBhcg0KPlxwYXINCj4gU2VhcmNoaW5nIGhhcHBlbnMgYWxsIHRoZSB0
aW1lLiBJIGhhdmUgYSBoYWJpdCBvZiBjb3B5aW5nLXBhc3RpbmcgWGF4aXNccGFyDQo+IGRvY3Ug
ZnJvbSB5b3VyIGRvY3VtZW50YXRpb24gaW50byB0aGUgdGV4dCBvZiBteSBjb2RlLiBBZnRlciBJ
IGFtIGRvbmVccGFyDQo+IHdpdGggZGV2ZWxvcG1lbnQgSSBjcmVhdGUgYSBmb2xkIGFuZCB3cml0
ZSBpbiBib2xkIGJsdWUgImhlcmUgaXMgdGhlIFhheGlzXHBhcg0KPiBkZXNjcmlwdGlvbiIuIEEg
ZmV3IG1vbnRocyBkb3duIHRoZSByb2FkIEkgd2lsbCBoYXZlIHRoaXMgaW5mbyB3aGVyZSBJXHBh
cg0KPiBuZWVkIGl0LiBJdCB3aWxsIGJlY29tZSBvYnNvbGV0ZSB3aGVuIHlvdSBjaGFuZ2UgWGF4
aXMgd2l0aCB0aGUgbmV4dFxwYXINCj4gcmVsZWFzZSwgYnV0IHRoZW4gdGhlIGNvbXBpbGVyIHdp
bGwgdGVsbCBtZSBzb21ldGhpbmcgaGFzIGNoYW5nZWQsIGFuZFxwYXINCj4gaG9wZWZ1bGx5IEkg
d2lsbCBiZSBkaWxpZ2VudCBlbm91Z2ggdG8gdXBkYXRlIHRoZSBmb2xkLlxwYXINCj5ccGFyDQo+
IFVnbHkgYnV0IHdvcmthYmxlLlxwYXINCj4gQW4gYXV0b21hdGljIGZhY2lsaXR5IHdvdWxkIGJl
IG5pY2VyLlxwYXINCj4gQnV0IHdobyB3b3VsZCB3b3JrIG9uIHRoaXMgbm93PyBUaGVyZSBhcmUg
bW9yZSBwcmVzc2luZyB0aGluZ3MgdG8gZG8sIHN1Y2ggYXMgQmxhY2tCb3ggZm9yIExpbnV4LCBC
bGFja0JveCBmb3IgLk5FVCwgZXRjLlxwYXINCj4gSGF2aW5nIHRoZSBsYXR0ZXIgd291bGQgYmUg
ZXZlbiBuaWNlciB0aGFuIGhhdmluZyBhdXRvbWF0aWMgWGF4aXMgZG9jdW1lbnRhdGlvbi5ccGFy
DQo+XHBhcg0KPiBXLlxwYXINCj4gIyMjI1xwYXINClxwYXINClBvd2VyZWQgYnkgdGhlIEUtbWFp
bCBQSU0gLSBJbmZvIFNlbGVjdCAtIHd3dy5taWNsb2cuY29tXHBhcg0KLS0tLS0tLS0tLS0tLS0t
LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS1ccGFyDQpccGFyDQpUbyB1bnN1YnNjcmliZSBm
cm9tIHRoaXMgbWFpbGluZyBsaXN0LCBzZW5kIGEgbWVzc2FnZSBjb250YWluaW5nIHRoZSB3b3Jk
ICJ1bnN1YnNjcmliZSIgdG86XHBhcg0KICAgYmxhY2tib3gtcmVxdWVzdEBvYmVyb24uY2hccGFy
DQpccGFyDQpUbyBnZXQgYSBsaXN0IG9mIHZhbGlkIGUtbWFpbCBjb21tYW5kcyBhbmQgaW5zdHJ1
Y3Rpb25zIG9uIHRoZWlyIHVzYWdlLCBzZW5kIGEgbWVzc2FnZSBjb250YWluaW5nIHRoZSB3b3Jk
ICJoZWxwIiB0byB0aGUgYWJvdmUgYWRkcmVzcy5ccGFyDQpccGFyDQpTZW5kIGFueSBwcm9ibGVt
IHJlcG9ydHMgb3IgcXVlc3Rpb25zIHJlbGF0ZWQgdG8gdGhpcyBlbWFpbCBsaXN0IHRvIHRoZSBs
aXN0IG93bmVyIGF0XHBhcg0KICAgb3duZXItYmxhY2tib3hAb2Jlcm9uLmNoXHBhcg0KXHBhcg0K
Q3VycmVudCBwb3N0aW5nIHBvbGljeTpccGFyDQpccGFyDQphKSBUbyBwb3N0IHlvdSBzaG91bGQg
dXNlIHRoZSBzYW1lIGFkZHJlc3MgYnkgd2hpY2ggeW91IGFyZSBzdWJzY3JpYmVkIHRvIHRoZSBt
YWlsaW5nIGxpc3QuIFRoYXQgd2F5LCB0aGUgbGlzdCBzZXJ2ZXIgd2lsbCByZWNvZ25pemUgeW91
IGFzIHN1YnNjcmliZXIgYW5kIGZvcndhcmQgeW91ciBwb3N0aW5nIGltbWVkaWF0ZWx5LCB3aXRo
b3V0IGNyZWF0aW5nIGFueSBvdmVyaGVhZC5ccGFyDQpccGFyDQpiKSBJZiwgZm9yIHNvbWUgcmVh
c29uLCB5b3UgY2Fubm90IHBvc3QgZnJvbSB0aGUgYWRkcmVzcywgYnkgd2hpY2ggeW91IGFyZSBz
dWJzY3JpYmVkLCB5b3VyIG1lc3NhZ2Ugd2lsbCBiZSBtb2RlcmF0ZWQgdG8gYXZvaWQgc3BhbS4g
UGxlYXNlIHVuZGVyc3RhbmQgdGhhdCBtb2RlcmF0aW9uIHdpbGwgb2Z0ZW4gY2F1c2Ugc29tZSBk
ZWxheSwgaW4gcGFydGljdWxhciBvdmVyIHdlZWtlbmRzIG9yIGhvbHlkYXlzfX0ARVNNVFA

----boundary-LibPST-iamunique-25154455_-_---
Received on Tue Nov 30 2004 - 10:48:02 UTC

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