File Release Notes and Changelog
Release Name: 0.8.4
Notes: $Id: mgo.readme,v 1.25 2007/05/08 15:48:17 der_hannes Exp $ *************************************************************************** * Copyright 2005/2006/2007. * * mgo is released under the terms of the Gnu General Public License (GPL) * * The text of the GPL is provided in the file "gpl.txt" * *************************************************************************** =============================================================== mgo: Playing Go and Writing Game Protocolls on Mobile Devices. =============================================================== Content: 1) About mgo 2) mgo vs. mgo_x 3) Installation 4) Features / Usage 5) Reporting Bugs NOTE: mgo is in steady development, which means that it is not yet able to what we would like it to do, yet. And it might very well not run at all. You have been warned :-) 1) About mgo ------------ With mgo, you can play 2-player Go on any java-enabled mobile device (e.g. mobile phones and PDAs). This includes writing game protocols for review and study. 2) mgo vs. mgo_x ---------------- mgo is designed to run on almost every mobile device that supports java (J2ME). Unfortunately, file-system access is not supported by simple J2ME. This means that you are able to save and restore games on your mobile's memory, but you can't export them to SGF files and transfer them *out* of your mobile. Some devices, however, fulfil an additional specification called JSR 75, which allows file-system operations. That's why we provide a version of mgo, called "mgo_x", that is able to export SGF. 3) Installation --------------- a) Visit www.mobilego.org and download the latest version. It will contain (at least) this readme file and the mgo.jar b) Transfer mgo.jar to your mobile phone (or other midp device). c) Start mgo. Alternatively: a) Use your mobile to enter "wap.GetJar.com" b) Enter "Quickdownload" c) Feed "Quick Download Code": 5316 (mgo stable) or 11173 (mgo unstable) or 11174 (mgo_x, unstable) The download number may be subject to change. Please refer to getjar.com to find the right one. [If you are using mgo_x, you must set permissions to access the filesystem. Depending on your device vendor, the device might ask you for admissin if it tries to read or write to your phone, or you may have to manipulate the "options" of the mgo_x.jar via the software of the device, before starting mgo_x. If mgo_x crashes due to file system restrictions, you can reload the game from the internal games list. It is called "AutoSave" there.] 4) Features / Usage ------------------- mgo is self explanatory. In case of crashes while saving to the online service egoban.org or while exporting to the mobile's file system (mgo_x only), a backup called "AutoSave" is stored internally and thus available at restart. 5) Reporting Bugs / Feature Requests ------------------------------------ If you found a bug or want to tell the mgo-developers about missing features, please fill in a report on http://sourceforge.net/projects/mgo/. Providing the release number or the cvs revision number (given at mgo's SysInfo screen) would help us a lot tracking down the problem.
Changes: RCS file: /cvsroot/mgo/mgo/src/mgo_x.java,v Working file: src/mgo_x.java head: 1.68 branch: locks: strict access list: symbolic names: release_0-8-3a: 1.63 release0_8_3: 1.61 release_0-8-1: 1.42 release_0-8-0: 1.38 release_0-7-4: 1.21 keyword substitution: kv total revisions: 68; selected revisions: 68 description: ---------------------------- revision 1.68 - fixed: preferences (show info at startup) appeared in saved games list ---------------------------- revision 1.67 - fixed bug: settings crashed, if there was no RMS - changed: splash screen ---------------------------- revision 1.66 - changed startup message ---------------------------- revision 1.65 - added "show help at startup" selection in settings - started startup text ---------------------------- revision 1.64 fixed: wrong information on egoban credentials in info screen fixed: pressing "Back" on settings screen did not work ---------------------------- revision 1.63 * Save to SGF creates local backup, too ---------------------------- revision 1.62 * Copy of game that is going to be transferred to egoban is saved internally, too. If the transfer makes mgo crash, we have a backup. ---------------------------- revision 1.61 * Small fix (egoban response had trailing pseudo character) ---------------------------- revision 1.60 * Small changes/additions in transfer check ---------------------------- revision 1.59 * Slightly cleaned up code ---------------------------- revision 1.58 *** empty log message *** ---------------------------- revision 1.57 * Now using bouncycastle's Base64 encoder * Now using proguard obfuscation, as the midlet does otherwise contain ~800k bouncycastle data. With proguard, the midlets is just 25k. ---------------------------- revision 1.56 * FIxed: settings are no longer shown among internally saved games. ---------------------------- revision 1.55 * Screen for transfer sucess/failure works. * Bug: logindata still appears in internal game list ---------------------------- revision 1.54 * mgo reads egoban's response (successful transfer, or login failure) ---------------------------- revision 1.53 * Export to egoban checks for username and password. If one is missing, mgo opens the settings screen. ---------------------------- revision 1.52 * Settings screen accessible through menu, but user and password RMS show up in games list (when saving/loading) ---------------------------- revision 1.51 * New class Preferences for storing/retrieving user settings. Currently used for egoban login data only. ---------------------------- revision 1.50 * Added: Custom name at egoban export ---------------------------- revision 1.49 * Fixed urlEncoder(), that did not encode ";" (and many more characters it actually should) ---------------------------- revision 1.48 * Submission to egoban works, but the egoban parser chokes on mgo's SGF ---------------------------- revision 1.47 Added: rudimentary HTTP-GET to transfer game to online server ---------------------------- revision 1.46 * fixed bug: RMSs containing pass failed to load ---------------------------- revision 1.45 * changed copyright note ---------------------------- revision 1.44 *changed Entries in "Save Menu" and their processing ---------------------------- revision 1.43 * fixed bug: GoBrett.getGroup() got some coordinates twice, thus making the capture count become too high. ---------------------------- revision 1.42 Added: Warning before overwrite Navigation: Added "Back" in naming savegame (RMS) Navigation: Added "Back" to Splash Screen Navigation: Changed all "Cancel" to "Back" ---------------------------- revision 1.41 Added: Overwrite RMS (with new name) ---------------------------- revision 1.40 Added: RMS have custom names (Bug: no overwriting of existing RMS) ---------------------------- revision 1.39 Changed: "New (slotNO)" entry for new Slots ---------------------------- revision 1.38 matejcik's patch related to (at least): - 2D coordinates - optimizing play/capture/Ko-check - code restructuring (GoBrett, review functionality, SGF loading/saving - mgo.jar shrinked to 19kB ---------------------------- revision 1.37 loading RMS did not erase DrawingGoban before adding loaded stones ---------------------------- revision 1.36 matejcik's patch: SpeedUp of DrawingGoban ---------------------------- revision 1.35 SGF deletion works ---------------------------- revision 1.34 overwriting exported SGF works (confirmation is missing) ---------------------------- revision 1.33 export in "." (actual directory) works ---------------------------- revision 1.32 browsing: select "." (actual directory) handling ---------------------------- revision 1.31 file browser: SGF import works ---------------------------- revision 1.30 changes in directory browsing (just SELECT command) ---------------------------- revision 1.29 added saveToSGF()-handling to SaveSlotsList.commandAction() ---------------------------- revision 1.28 added "Import SGF" to menu ---------------------------- revision 1.27 SaveSlotsList.loadFromSGF() implemented ---------------------------- revision 1.26 Contructor GoBrett(String SGFstring) has basic SGF-internal format translation abilities. ---------------------------- revision 1.25 fixed: pass did not count as move in Ko ---------------------------- revision 1.24 - blocked by Ko is new captureStatus "4" - EasyIntStackHash.get() gives deep copy, not shallow reference (manipulating the reference would change original object, otherwise) - play() gets additional boolean parameter indicating whether checkign for Ko is relevant (createsKo() needs play, so play should not itself use createsKo()) - Ko is marked immediately after capturing of single stone creates it ---------------------------- revision 1.23 KO-check prevents move. KO is not marked, though ---------------------------- revision 1.22 removed graphics from logo-screen (problems with small displays) ---------------------------- revision 1.21 kicked logo (temporary) ---------------------------- revision 1.20 unlimited number of RMS-"slots" ---------------------------- revision 1.19 changed: text screens like scores, help, etc, now have "Ok" as key, not "cancel". fixed: capts did always return to kifu, even when called in review mode ---------------------------- revision 1.18 added: last move marked in review, too ---------------------------- revision 1.17 changed: last stone always marked with cross, even when very small changed: small black filled circles in counting not surrounded by white circles ---------------------------- revision 1.16 added screen: captures ---------------------------- revision 1.15 removed: version screen (www.mobilego.org is in start screen, and cvs info in SysInfo screen) ---------------------------- revision 1.14 added to sysinfo: cvs "Revision" and "Id" ---------------------------- revision 1.13 mgo patch 1.52 - 1.53 (fixed logo bug, logo with www.mobilego.org) ---------------------------- revision 1.12 matejcik's patch: fixing RMS load/safe bug ---------------------------- revision 1.11 fixed bug # 1400409; neutral territory was counted as black ---------------------------- revision 1.10 aboutScreen shows cvs-id and refers to www.mobilego.org ---------------------------- revision 1.9 EGF export: directory browsing works (at least within the root directories) ---------------------------- revision 1.8 SGF export: works sometimes (browsing is still buggy) SGF export: SGF preamble slightly changed Ui: last-stone marker now as big as stone (if radius not smaller than 4) UI: black stones now just black circles (filled) ---------------------------- revision 1.7 matejcik: (1) GoBrett is a bit more self-contained now (2) changed the savegame format (3) touchscreen support (4) coordinates cursor (5) everything's taken apart, cleaned up and put together again [...], whole lot of new functions hannes: replaced splash-greeting by logo screen (logo in diff sizes, accorsing to screen dimensions) ---------------------------- revision 1.6 added: (buggy) real directory browsing ---------------------------- revision 1.5 save menu shows "export" only on devices with fileConnection abilities minor: menu titles with capital letters ---------------------------- revision 1.4 matejcik's patch: - fixed menu - added directory browsing interface ---------------------------- revision 1.3 matejcik's patch: moved the menus into Screens ---------------------------- revision 1.2 fixed: writeMenu didn't stop at last element fixed: scrolling did not start at correct entry fixed: sysinfo did not get fileConnectionInfo correctly (was deliberately set to null) added: sysinfo includes number of available lines ---------------------------- revision 1.1 major reclassification: this version will be called mgo_x (extended/export). "mgo" will run on any device. changed: main menu and size selection now by generic menu ============================================================================= RCS file: /cvsroot/mgo/mgo/src/mgo.java,v Working file: src/mgo.java head: 1.74 branch: locks: strict access list: symbolic names: release_0-8-3a: 1.64 release_0-8-3: 1.69 release0_8_3: 1.64 release_0-8-1: 1.64 release_0-8-0: 1.64 release_0-7-4: 1.58 light: 1.41.0.4 without_JSR75: 1.41.0.2 start: 1.1.1.1 vendor: 1.1.1 keyword substitution: kv total revisions: 78; selected revisions: 78 description: ---------------------------- revision 1.74 ---------------------------- revision 1.73 ---------------------------- revision 1.72 * Some changes from the mgo_x 1.63 were still missing ---------------------------- revision 1.71 ---------------------------- revision 1.70 ---------------------------- revision 1.69 * mgo (i.e. restricted) version of mgo_x.1.61 ---------------------------- revision 1.68 Release 0.8.2 ---------------------------- revision 1.67 * mgo_x patch 1.45 -> 1.46 ---------------------------- revision 1.66 Synchronized with mgo_x: Copied mgo_x.java (Revision 1.45) to mgo.java and deleted/commented/adjusted to make mgo.java compile well again ---------------------------- revision 1.65 Global commit before the 0.8.1 release ---------------------------- revision 1.64 matejcik's patch related to (at least): - 2D coordinates - optimizing play/capture/Ko-check - code restructuring (GoBrett, review functionality, SGF loading/saving - mgo.jar shrinked to 19kB ---------------------------- revision 1.63 mgo_x patch: v1.26-v1.36 ---------------------------- revision 1.62 mgo_x patch: v1.24-v1.25 ---------------------------- revision 1.61 mgo_x patch: v1.23-v1.24 ---------------------------- revision 1.60 mgo_x patch: v1.22-v1.23 ---------------------------- revision 1.59 mgo_x patch: v1.21-v1.22 ---------------------------- revision 1.58 mgo_x patch: v1.20-v1.21 ---------------------------- revision 1.57 derived from mgo_x-v1.20 ---------------------------- revision 1.56 mgo_x patch: v1.18 - v.1.19 ---------------------------- revision 1.55 mgo_x patch: v.1.16 - v1.18 ---------------------------- revision 1.54 mgo_x patch: v1.15-v1.16 (plus some strange differences between mgo_x and mgo) ---------------------------- revision 1.53 fixed: RunTimeException if no Logo added: www.mobilego.org to start-screen (below logo) ---------------------------- revision 1.52 mgo_x patch: v1.11 - 1.12 ---------------------------- revision 1.51 mgo_x patch: v.1.10 - v.1.11 ---------------------------- revision 1.50 patch mgo_x: v1.9 - v1.10 ---------------------------- revision 1.49 patch mgo_x: v1.7 - v1.8 ---------------------------- revision 1.48 patch mgo_x: v1.6 - v1.7 ---------------------------- revision 1.47 patch mgo_x (v1.4 - 1.5) ---------------------------- revision 1.46 mgo_x patch (v1.3 - v1.4) ---------------------------- revision 1.45 applied matejcik's mgo_x patch (v1.2 - v1.3) ---------------------------- revision 1.44 applied mgo_x patch (v1.1 - v1.2) ---------------------------- revision 1.43 again cleaned all fileConnection reference from the extended version (now "mgo_x"). All the changes now in mgo_x, with patch to mgo, if not concerning fileConnection ---------------------------- revision 1.42 * applied mgo_light patch: mark last stone ---------------------------- revision 1.41 branches: 1.41.4; * added: new generic menu-generating method * problem: version with SGF export do not run on mobiles without JSR 75 extension --> separate branch for those ---------------------------- revision 1.40 * added: make sure that SGF is stored with new filename (not overwriting other matches) ---------------------------- revision 1.39 * export has separate menu-entry (in "save" menu) and gives information on which rootdir and filename is used. ---------------------------- revision 1.38 * new: SGF export works in principle (actual sequence is stored as mgo.sgf, if "save" is selected in menu). ---------------------------- revision 1.37 more FileConnection code ---------------------------- revision 1.36 first fileConnection tests ---------------------------- revision 1.35 added: check, whether FileConnections are supported by device added: info in splash screen whether SGF export is supported by device ---------------------------- revision 1.34 new: saving translates sequence into valid SGF (SGF not yet stored on file system) ---------------------------- revision 1.33 added: first steps to convert move sequence to string (that will later become SGF) ---------------------------- revision 1.32 changed ui: Full scores (captures, territory, sum) are shown in extra screen, not in menu. Captures are still shown there (if there are any). ---------------------------- revision 1.31 changed: width/height ratio maximal 1.3 ---------------------------- revision 1.30 changed: sped counting up. Recount not after every cursor movement, but after declaring a group dead. ---------------------------- revision 1.29 changed: while counting territory, the user can declare groups as dead changed: the menu shows territory and total sum of points, if there is any territory counted ---------------------------- revision 1.28 added: count screen with basic territory recognition changed: menu entry for counting territory added ---------------------------- revision 1.27 changed: Control screen shows just the relevant controls: pass and undo, if in game mode, and 4/6, 1/3 and 7/9, if in review mode. ---------------------------- revision 1.26 added: Review with its own keybindings for navigation within a game (back/ahead, 10 moves back/ahead, start/end) changed: Menu allows for changeing between review and game mode changed: Review does not affect scores changed: Splash screen ---------------------------- revision 1.25 added: review feature. New entry in menu, which allows Navigation through game. changed: GoBrett methods changed from brett.xxxx to this.xxxx, making it useful for every instance of GoBrett, not just the instance called "brett". ---------------------------- revision 1.24 changed: Layout of menu screen when showing captured stones ---------------------------- revision 1.23 - changed: entries of menus are indented (5 whitespaces) - changed: no separate status screen. Scores are shown on menu screen, if there are any captured stones. - added: diagonal moves 1,3,7,9 ---------------------------- revision 1.22 - changed hoshi layout (smaller, empty circles, position according to board size) ---------------------------- revision 1.21 - added: support for diff. board sizes (goban layout, load, save, cursor movement, capturing) - fixed: loading had problems with passed moves ---------------------------- revision 1.20 - deleted lots of unnecessary (debug/experimental) code - solved: Undo did not change scores correctly ---------------------------- revision 1.19 - deleted lots of debug code ---------------------------- revision 1.18 changed: menu changed: program navigation changed: splash new: key screen ---------------------------- revision 1.17 changed ui: minor change to splash screen changed ui: minor change in scores screen's layout changed ui: changed "scores" to "scores/exit" screen added: Clean exit by pressing "#" in scores/exit screen ---------------------------- revision 1.16 changed ui: No Menu any more. Splash is followed by empty goban (kifu-mode) changed ui: Keys changed. 1 -->Load Screen, 2 -->Save Screen, 0 --> Status changed ui: Selection ("Fire") in Load/Save --> return to kifu changed ui: Changed splash screen. added: Save screen with selection of slots (no deliberate naming of saved games, yet) added: Saving GoBrett.sequence in RecordStore (deletes old store before saving, if not empty) added: Info on used and free space on "Save" screen (currently disabled, as it does not work on my siemens mc60) added: Load screen with selection of slots added: Reading GoBrett.sequence from RecordStore added: Reconstruction of GoBrett.data and .captured from .sequence by play() of every item in .sequence. This is buggy! added: Method EasyIntHashTable.valueStack() to get a stack of its values added: Method EasyIntHashTable.clear() to get rid of every key (and thus: every value) changed: Method EasyIntHashTable.indexStack() to EasyIntHashTable.keyStack() ---------------------------- revision 1.15 added: record store basics work (currently with test open/write/read) ---------------------------- revision 1.14 fixed: taking back passes works (passes are stored in sequence with color 3) added: first steps to handle record stores (not usable yet) ---------------------------- revision 1.13 fixed: undone stones left board with value 0 instead of -1 fixed: capture-counter was not affected by undo ---------------------------- revision 1.12 added: taking back moves with "*"-key (including replacement of formerly captured stones) added: counting captured stones ---------------------------- revision 1.11 fixed: color change after capture code-chage: moved game-logic into GoBrett.play() added: score/debug screen, accessed by "1"-key ---------------------------- revision 1.10 - size of stones, hoshis and cursor now relative to display dimensions - changed cursor to square (because the circle resulted in ugly shapes on small displays) ---------------------------- revision 1.9 fixed: on real device (and in me4se) the menu did non appear and the kifu was started with a stone played in the cursor's initial position ---------------------------- revision 1.8 new: EasyIntStackHash captured (stores a stack of captured stones for each mvoe) ---------------------------- revision 1.7 added: pass move with #-key ---------------------------- revision 1.6 fixed cursor movement: now cycles through rown and columns, movement outside board is no longer possible ---------------------------- revision 1.5 previous version did not work (compilation problem with eclipse/eclipseme). no other changes ---------------------------- revision 1.4 added menu ---------------------------- revision 1.3 does not work; new navigation paradigm: paint() is structured by "screen"-variable representing the actual purpose (menu, kifu, edit, ...). ---------------------------- revision 1.2 major upgrade: translated comments to english :-) ---------------------------- revision 1.1 branches: 1.1.1; Initial revision ---------------------------- revision 1.1.1.1 sourceforge start ---------------------------- revision 1.41.4.3 * added: last played stone is marked with a cross (if stone is big enough). this leeds to ugly graphics on small screens and certain board sizes. (could switched to mark/not mark in a future "options" screen) ---------------------------- revision 1.41.4.2 *** empty log message *** ---------------------------- revision 1.41.4.1 * all fileCOnnection code disabled/removed * test: should be in separate branch =============================================================================
