Jump to content

Photo

MADS Assembler English Documentation Project


13 replies to this topic

#1 Tickled_Pink OFFLINE  

Tickled_Pink

    Quadrunner

  • 5,039 posts
  • Location:Llanerchymedd, Wales, UK

Posted Tue Jan 1, 2008 5:53 PM

As stated elsewhere, I've now started work on trying to produce an English-language manual for MADS (with a Welsh-language one to follow :P ). There are a few issues already, however.

1. I don't understand Polish, so am having to use an online translator - which is far from perfect. It's fine for things like short titles and headers, but converting entire paragraphs is a problem for it. So much of what I'm writing down at the minute is 'best guess'. Some bits that are also not that important are also being left out.

2. Since MADS borrows a great deal from XASM, the first few pages makes a lot of references to it. I've never used XASM so because of this, and the translation issue, I'm not 100% certain that everything I've written about XASM (or MADS for that matter) is accurate. I'd therefore appreciate some help checking for accuracy of content from anyone who has already used either assembler.

I'm still working on the Introduction section - my second attempt. Think I've worked out some of the quirks in translation and how to best use the translator output this time.

#2 pps OFFLINE  

pps

    Dragonstomper

  • 665 posts
  • Location:Berlin, Germany

Posted Wed Jan 2, 2008 11:43 AM

Did you check xasm.atari.org for the english manual there? It could be a start perhaps.

#3 Tickled_Pink OFFLINE  

Tickled_Pink

    Quadrunner

  • Topic Starter
  • 5,039 posts
  • Location:Llanerchymedd, Wales, UK

Posted Wed Jan 2, 2008 4:58 PM

Thanks. I'll go check it out.

#4 Gury OFFLINE  

Gury

    Stargunner

  • 1,009 posts

Posted Fri Jan 4, 2008 8:10 AM

Hej Tickled_Pink, that is a great idea. We all would be more than delighted for English translation of MADS documentation. Thank you for your efforts.

Edited by Gury, Fri Jan 4, 2008 8:10 AM.


#5 Tickled_Pink OFFLINE  

Tickled_Pink

    Quadrunner

  • Topic Starter
  • 5,039 posts
  • Location:Llanerchymedd, Wales, UK

Posted Fri Jan 4, 2008 6:36 PM

Hej Tickled_Pink, that is a great idea. We all would be more than delighted for English translation of MADS documentation. Thank you for your efforts.

Thanks for the encouragement. It's gonna take a while, though. ;)

#6 miker OFFLINE  

miker

    Stargunner

  • 1,565 posts
  • Stay Atari!
  • Location:Warsaw, Poland

Posted Fri Jan 11, 2008 1:47 PM

OK, i started translating MADS documentations to English in the middle of November but due to lack of time i gave up (at least for now). I've attached a textfile with all this i've done. Warning - it's raw and rough but maybe can help you a bit.

Attached Files


Edited by miker, Fri Jan 11, 2008 1:48 PM.


#7 Tickled_Pink OFFLINE  

Tickled_Pink

    Quadrunner

  • Topic Starter
  • 5,039 posts
  • Location:Llanerchymedd, Wales, UK

Posted Fri Jan 18, 2008 2:11 PM

OK, i started translating MADS documentations to English in the middle of November but due to lack of time i gave up (at least for now). I've attached a textfile with all this i've done. Warning - it's raw and rough but maybe can help you a bit.

Thanks. It's no rougher than mine is at the minute. ;)

#8 peteym5 OFFLINE  

peteym5

    Dragonstomper

  • 894 posts
  • Location:Buffalo NY USA

Posted Thu Apr 24, 2008 11:10 AM

Has there been any progress with this documentation. I like MADS because its easy to port from MAC/65 and even capable of mixing stuff that was made for XASM and other assemblers.

What I need specifically is information regarding bank loading for a cartridge. Cartridges that use bank switching, XEGS and so-forth. I see there is something about it, (LMB ##, NMB, RMB), but not sure it does the trick of loading stuff into different banks for a cartridge image. I pretty much know how to do the bank switching on the $D5xx registers, but not sure how to compile a XEGS cart image.

#9 Wrathchild ONLINE  

Wrathchild

    Stargunner

  • 1,546 posts
  • Location:Reading, UK.

Posted Thu Apr 24, 2008 1:22 PM

MAC/65 -> CA65 isn't too difficult either and its macro support pretty much covers everything else you maybe trying to do in MADS. The linker LD65 will take care of laying out the code into a binary image for you. Give it a try :cool: and I'll help you out when (if!) you get stuck ;)

Regards,
Mark

#10 peteym5 OFFLINE  

peteym5

    Dragonstomper

  • 894 posts
  • Location:Buffalo NY USA

Posted Fri Jun 20, 2008 11:50 AM

Hey I have attempted to use the Google translation of the page, it worked for the most part. I attempted to copy and past it into a blank document, but now has both Polish-English mixed after every sentence. I started editing some of the Polish text out of it and tried to changed some of the other un-translated words to English. I currently don't have a whole lot of time since I am working on the Tempest Xtreem project

The translation is not 100% complete and hoping someone can complete the editing and figure out what some of these things finally translate to.

Attached Files



#11 Stephen OFFLINE  

Stephen

    River Patroller

  • 4,776 posts
  • A8 Gear Head
  • Location:Akron, Ohio

Posted Thu May 21, 2009 11:17 AM

Hey I have attempted to use the Google translation of the page, it worked for the most part. I attempted to copy and past it into a blank document, but now has both Polish-English mixed after every sentence. I started editing some of the Polish text out of it and tried to changed some of the other un-translated words to English. I currently don't have a whole lot of time since I am working on the Tempest Xtreem project

The translation is not 100% complete and hoping someone can complete the editing and figure out what some of these things finally translate to.

Bumping an old topic, but has anyone made progress with this documentation? The VBXE2 source code examples were done with MADS 1.8.4 so I will be learning to use it.

Stephen Anderson

#12 kenames99 OFFLINE  

kenames99

    Space Invader

  • 14 posts

Posted Wed Aug 26, 2009 1:29 PM

Hey I have attempted to use the Google translation of the page, it worked for the most part. I attempted to copy and past it into a blank document, but now has both Polish-English mixed after every sentence. I started editing some of the Polish text out of it and tried to changed some of the other un-translated words to English. I currently don't have a whole lot of time since I am working on the Tempest Xtreem project

The translation is not 100% complete and hoping someone can complete the editing and figure out what some of these things finally translate to.

Bumping an old topic, but has anyone made progress with this documentation? The VBXE2 source code examples were done with MADS 1.8.4 so I will be learning to use it.

Stephen Anderson


hi,
I did this also on google and it seems a bit more translated. I hope it is usable to some and anyone is welcome to update it as they see fit. thanks for all the great info in these forums.

Ken

Attached Files



#13 flashjazzcat OFFLINE  

flashjazzcat

    Quadrunner

  • 8,541 posts
  • Location:United Kingdom

Posted Tue Nov 2, 2010 10:30 AM

I totally forgot Ken had posted a pretty good MADS doc so I just did it again before I discovered his. Posted Image Some of the text is less "dense" in places. Anyway, it can't hurt:

Attached File  MADS Assembler - English Translation.TXT   155.7KB   285 downloads

This is a fine assembler but I don't think I'm using more than ten per cent of the (very useful) advanced features at the moment.

Edited by flashjazzcat, Tue Nov 2, 2010 10:30 AM.


#14 flashjazzcat OFFLINE  

flashjazzcat

    Quadrunner

  • 8,541 posts
  • Location:United Kingdom

Posted Wed May 9, 2012 6:03 AM

Here's an edited version on the section on MADS' relocatable binary format:

Attached File  MADS Relocatable Binaries.txt   5.35KB   71 downloads

The parts I understand the least probably make the least sense (i.e. parameter passing and software stack manipulation). I'll have another look at these when I have a better grasp of them. :)




0 user(s) are browsing this forum

0 members, 0 guests, 0 anonymous users