Tickled_Pink Posted January 1, 2008 Share Posted January 1, 2008 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 ). 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. Quote Link to comment https://forums.atariage.com/topic/118976-mads-assembler-english-documentation-project/ Share on other sites More sharing options...
pps Posted January 2, 2008 Share Posted January 2, 2008 Did you check xasm.atari.org for the english manual there? It could be a start perhaps. Quote Link to comment https://forums.atariage.com/topic/118976-mads-assembler-english-documentation-project/#findComment-1437365 Share on other sites More sharing options...
Tickled_Pink Posted January 2, 2008 Author Share Posted January 2, 2008 Thanks. I'll go check it out. Quote Link to comment https://forums.atariage.com/topic/118976-mads-assembler-english-documentation-project/#findComment-1437548 Share on other sites More sharing options...
Gury Posted January 4, 2008 Share Posted January 4, 2008 (edited) 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 January 4, 2008 by Gury Quote Link to comment https://forums.atariage.com/topic/118976-mads-assembler-english-documentation-project/#findComment-1438752 Share on other sites More sharing options...
Tickled_Pink Posted January 5, 2008 Author Share Posted January 5, 2008 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. Quote Link to comment https://forums.atariage.com/topic/118976-mads-assembler-english-documentation-project/#findComment-1439158 Share on other sites More sharing options...
miker Posted January 11, 2008 Share Posted January 11, 2008 (edited) 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. mads_eng_alfa.txt Edited January 11, 2008 by miker Quote Link to comment https://forums.atariage.com/topic/118976-mads-assembler-english-documentation-project/#findComment-1443584 Share on other sites More sharing options...
Tickled_Pink Posted January 18, 2008 Author Share Posted January 18, 2008 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. Quote Link to comment https://forums.atariage.com/topic/118976-mads-assembler-english-documentation-project/#findComment-1448134 Share on other sites More sharing options...
peteym5 Posted April 24, 2008 Share Posted April 24, 2008 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. Quote Link to comment https://forums.atariage.com/topic/118976-mads-assembler-english-documentation-project/#findComment-1507643 Share on other sites More sharing options...
Wrathchild Posted April 24, 2008 Share Posted April 24, 2008 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 and I'll help you out when (if!) you get stuck Regards, Mark Quote Link to comment https://forums.atariage.com/topic/118976-mads-assembler-english-documentation-project/#findComment-1507770 Share on other sites More sharing options...
peteym5 Posted June 20, 2008 Share Posted June 20, 2008 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. MADS_MIXXED.txt Quote Link to comment https://forums.atariage.com/topic/118976-mads-assembler-english-documentation-project/#findComment-1540039 Share on other sites More sharing options...
+Stephen Posted May 21, 2009 Share Posted May 21, 2009 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 Quote Link to comment https://forums.atariage.com/topic/118976-mads-assembler-english-documentation-project/#findComment-1754296 Share on other sites More sharing options...
kenames99 Posted August 26, 2009 Share Posted August 26, 2009 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 MADS-English.txt Quote Link to comment https://forums.atariage.com/topic/118976-mads-assembler-english-documentation-project/#findComment-1824714 Share on other sites More sharing options...
flashjazzcat Posted November 2, 2010 Share Posted November 2, 2010 (edited) I totally forgot Ken had posted a pretty good MADS doc so I just did it again before I discovered his. Some of the text is less "dense" in places. Anyway, it can't hurt: MADS Assembler - English Translation.TXT 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 November 2, 2010 by flashjazzcat Quote Link to comment https://forums.atariage.com/topic/118976-mads-assembler-english-documentation-project/#findComment-2128385 Share on other sites More sharing options...
flashjazzcat Posted May 9, 2012 Share Posted May 9, 2012 Here's an edited version on the section on MADS' relocatable binary format: MADS Relocatable Binaries.txt 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. Quote Link to comment https://forums.atariage.com/topic/118976-mads-assembler-english-documentation-project/#findComment-2518689 Share on other sites More sharing options...
Synthpopalooza Posted January 20, 2016 Share Posted January 20, 2016 (edited) Necrobump ... If anyone is still trying to translate this doc to English, I have a possible means: https://www.duolingo.com/comment/13018157 Duolingo is a site that is for language learning (I have been using it to learn Swedish), and they recently added Polish for English speakers. In addition, some clever cookie has figured out how to add Immersion ... which is, crowd sourced translation of web documents, in this case from Polish to English. The people who translate it get experience points and learn a new language. I have already made a request about getting the MADS docs put up there, so that people can translate them. This might be a good way to go about it! Edited January 20, 2016 by Synthpopalooza 2 Quote Link to comment https://forums.atariage.com/topic/118976-mads-assembler-english-documentation-project/#findComment-3419730 Share on other sites More sharing options...
Synthpopalooza Posted January 20, 2016 Share Posted January 20, 2016 First one is up on Duolingo: https://www.duolingo.com/translation/1ff6b75a23d2f61f1253993d5f685089(the MADS pascal one). All you need is a duolingo account, and a rough knowledge of Polish and English ... anyone who knows both languages is of course welcome to contribute. This resource could also be used to translate other Atari docs (German or Polish) into English or German or any other language desired. If anyone has another Polish or German doc they want uploaded, let me know. 1 Quote Link to comment https://forums.atariage.com/topic/118976-mads-assembler-english-documentation-project/#findComment-3419750 Share on other sites More sharing options...
Synthpopalooza Posted January 20, 2016 Share Posted January 20, 2016 (edited) I just tried uploading the MADS documentation in Polish, but it is too big for Duolingo, so maybe someone can split the original document into smaller parts, put it on a server, so that we can upload it to Duolingo? Edited January 20, 2016 by Synthpopalooza Quote Link to comment https://forums.atariage.com/topic/118976-mads-assembler-english-documentation-project/#findComment-3419758 Share on other sites More sharing options...
snicklin Posted January 20, 2016 Share Posted January 20, 2016 Version 1.9.5 of MADS has already been translated to English, that'll be close enough I guess to the current MADS document. Or do you only want the latest version? http://mads.atari8.info/mads_eng.html Quote Link to comment https://forums.atariage.com/topic/118976-mads-assembler-english-documentation-project/#findComment-3419831 Share on other sites More sharing options...
+JAC! Posted January 21, 2016 Share Posted January 21, 2016 Necrobump ... If anyone is still trying to translate this doc to English, I have a possible means: https://www.duolingo.com/comment/13018157 Duolingo is a site that is for language learning (I have been using it to learn Swedish), and they recently added Polish for English speakers. In addition, some clever cookie has figured out how to add Immersion ... which is, crowd sourced translation of web documents, in this case from Polish to English. The people who translate it get experience points and learn a new language. I have already made a request about getting the MADS docs put up there, so that people can translate them. This might be a good way to go about it! I will keep the English version up to date with the changes after 1.9.5. There are not so many deltas, still for them this site might be helpful. This thread was continiue here: http://atariage.com/forums/topic/179559-mads-knowledge-base/?p=2686212 2 Quote Link to comment https://forums.atariage.com/topic/118976-mads-assembler-english-documentation-project/#findComment-3420570 Share on other sites More sharing options...
Recommended Posts
Join the conversation
You can post now and register later. If you have an account, sign in now to post with your account.
Note: Your post will require moderator approval before it will be visible.