Proposal for a new standard for API specifications

Page 4/5
1 | 2 | 3 | | 5

By konamiman

Paragon (1157)

konamiman's picture

09-07-2007, 16:06

Of course I appreciate your comments. I wish more people would "criticize" the document so I can improve it. Smile

By NapalM

Master (234)

NapalM's picture

09-07-2007, 16:50

Podatron, remember that I have something obsonete for lend you at the euskalparty Wink

By Tanni

Hero (556)

Tanni's picture

09-07-2007, 16:53

That's exactly the reason why I posted my comments. But the topic seems to be very strange to most of the people here, including me, so you'll get only few reactions. To my mind, you're going the right way, i.e. making a very formal proposal on a topic with future relevance waiting for reactions and corrections, but to most of the users here, its much too formal and too professional to really care about it. (Remember that we're hobbyists!) This very way you provide your proposal don't let me expect to have such conceputal oddities in it. As I first read your text month ago, I felt that there was something I don't totally agree with, but I didn't realize what. After browsing it today, it came out clearly that's abaut this 64+1 thingy.

By Prodatron

Paragon (1801)

Prodatron's picture

09-07-2007, 17:32

@NapalM: Yes, thank you, and now it's in less than two weeks Tongue
@Konamiman: Sorry, for beeing offtopic, but that's a good place here to reach you: Will you be on the Euskal this year again?

By Tanni

Hero (556)

Tanni's picture

09-07-2007, 17:38

I also use stringlength not power of 2 in my programms, but these are in Pascal and hence easy to change and not MC.

By konamiman

Paragon (1157)

konamiman's picture

09-07-2007, 18:00

I have published the code samples in the hope that it will help to better understand the whole thing. Apart from this, I don't know what else to do in order to clarify the exposed ideas. Any suggestion? Question

Prodatron: No, sorry, this time I can't go to Euskal party. Last year trip was sort of an exception.

By Tanni

Hero (556)

Tanni's picture

09-07-2007, 18:49

Try to express your ideas in your own way, not with an RFC-style text behind it. Go out somewhere with just paper and pencil and rewrite it in your own words. Try to shorten it. The MC provided looks just fine, but who takes the effort to try to understand it if there's no need?

By AuroraMSX

Paragon (1902)

AuroraMSX's picture

09-07-2007, 21:27

Hm, one comment out of the blue, without having a look at the spec Wink
Why limit that string length to 63 (or 64 or 65 or 87.5 oO) if you want to terminate the string with a 0-byte anyway?

By konamiman

Paragon (1157)

konamiman's picture

10-07-2007, 11:54

Tanni: but that's already my style... I usually write documentation this way, only that this time I used a XML processor to generate the document with RFC look. If I try to shorten it, I will end up rewriting the "Sample scenario" section, I think.

AuroraMSX: limiting the string lengths helps developers at the time of allocating space for string mnipulation tasks. 63 chars is a good length for a short name, I think.

By konamiman

Paragon (1157)

konamiman's picture

10-07-2007, 13:35

Ok, you win:

Introduction to the MSX-UNAPI specification (short!)

If this is still not easy to understand, I'll change my Turbo-R for a Vista-capable Spectrum! :)

Page 4/5
1 | 2 | 3 | | 5