Proposal for a new standard for API specifications (Development MSX Forum)MSX Resource Center               
              
English Nederlands Espa�ol Portugu�s Russian         
 News
   Frontpage
  News archive
  News topics

 Resources
   MSX Forum
  Articles
  Reviews
  Fair reports
  Photo shoots
  Fairs and meetings
  Polls
  Links
  Search

 Software
   Downloads
  Webshop

 MRC
   Who we are
  Join our team
  Donate
  Policies
  Contact us
  Link to Us
  Statistics

 Search
 
  

  

 Login
 

Username

Password




Don't you have an account yet? Become an MSX-friend and register an account now!.


 Statistics
 

There are 37 guests and 1 MSX friend online

You are an anonymous user.
 

MSX Forum


MSX Forum

Development - Proposal for a new standard for API specifications

Goto page ( Previous Page 1 | 2 | 3 )
Author

Proposal for a new standard for API specifications

Tanni
msx addict
Posts: 303
Posted: July 09 2007, 15:45   
I just browsed the text and the code today, read it as you first came up with it a couple of month ago. It's quite difficult to keep every detail in mind. I never had the need to code things concerning your proposal, so I can only find conceptual oddities like the 64+1 name length.
konamiman
msx freak
Posts: 138
Posted: July 09 2007, 16:06   
Of course I appreciate your comments. I wish more people would "criticize" the document so I can improve it.
NapalM
msx lover
Posts: 85
Posted: July 09 2007, 16:50   
Podatron, remember that I have something obsonete for lend you at the euskalparty
Tanni
msx addict
Posts: 303
Posted: July 09 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.
Prodatron
msx master
Posts: 1110
Posted: July 09 2007, 17:32   
@NapalM: Yes, thank you, and now it's in less than two weeks
@Konamiman: Sorry, for beeing offtopic, but that's a good place here to reach you: Will you be on the Euskal this year again?
Tanni
msx addict
Posts: 303
Posted: July 09 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.
konamiman
msx freak
Posts: 138
Posted: July 09 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?

Prodatron: No, sorry, this time I can't go to Euskal party. Last year trip was sort of an exception.
Tanni
msx addict
Posts: 303
Posted: July 09 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?
AuroraMSX

msx master
Posts: 1262
Posted: July 09 2007, 21:27   
Hm, one comment out of the blue, without having a look at the spec
Why limit that string length to 63 (or 64 or 65 or 87.5 ) if you want to terminate the string with a 0-byte anyway?
konamiman
msx freak
Posts: 138
Posted: July 10 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.
konamiman
msx freak
Posts: 138
Posted: July 10 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!
konamiman
msx freak
Posts: 138
Posted: July 25 2007, 13:12   
Version 0.4 of the specification is ready.

Also, I have added a section for MSX-UNAPI in my web page, from where where all the published documents are easily reachable.
manuel
msx guru
Posts: 3545
Posted: July 25 2007, 18:33   
What's new compared to the previous ones?
konamiman
msx freak
Posts: 138
Posted: July 25 2007, 18:48   
Please look at the document version history at the end of the document itself. And remember to check out the introductory document, it is more human readable than the complete spec.
manuel
msx guru
Posts: 3545
Posted: July 26 2007, 08:49   
Oops, missed that Thanks. However, the history only goes up to version 0.2, I thought you said there's 0.4 now?
 
Goto page ( Previous Page 1 | 2 | 3 )
 







(c) 1994 - 2008 MSX Resource Center Foundation. MSX is a trademark of MSX Licensing Corporation.