PilotGOne - view/record/edit GO games (SGF) in PalmOS


Previous: Manage SGF Files: First Line, ..., Sorting/Searching       Contents       Next: Earlier Versions, Downloads, ...


Moving SGF files, Bugs, ..., Future Features, ..., Credits, PalmGOne

Moving SGF files between your PC and PalmOS® device

To make best use of the Memo Pad, it is a good idea to have all your SGF files in their own Memo Pad category – "SGF", say. This will help you to keep them separated from other memos, and will reduce sort/search times if you have many other memos.

To create a new category of Memo in the Palm™ Desktop – select Tools/ Categories/ New, and enter "SGF". You will need to do this once only.

Memos are normally copied to your Palm™ Desktop, whenever you use HotSync®.

Using Palm™ Desktop to store games "offline"

If you have many SGF records, and do not want to keep them all on the PalmOS® device at the same time, then you can use the Palm™ Desktop to achieve this efficiently.

Once only, in Palm™ Desktop, do "Tools/ Users .../ New ...", and then add a new user called "SGF Archive", say. If your normal, PalmOS® device, username is "PP User", then you can move/copy multiple Memo Pad entries between "PP User" and "SGF Archive", by using simple drag-and drop in Palm Desktop. This is much easier than moving to/from Windows itself.

Perhaps you can keep all your SGF records in "SGF Archive", and just the current ones in "PP User". You will not need to use the "SGF Archive" user in any other way.

Adding files to your PalmOS® device

To transfer SGF game records from your PC to the PalmOS® device, you have first to transfer them to the Palm™ Desktop, before doing a HotSync®. In the Palm™ Desktop, select the Memo Pad facility; make sure that you have chosen the "SGF" category at the top, then press "New...", and copy the contents of the SGF file to the window at right.

If you use Linux you can install several files simultaneously, using install-memo thus:
install-memo -c SGF /dev/pilot *.sgf
For more details, please refer to the man page for install.

There are no standard tools for moving several files simultaneously from your Windows PC to the PalmOS® device, or back. However, if you use a Windows PC (Windows 98/ ME/ 2000/ NT/ XP) then there are now tools to help you transfer multiple files in either direction (PC <–> Palm). These are SGFtoMPA, and MPAtoSGF. They were written by Martin Schmidt, but have not been tested by us. Please note that both programs work only with memos < 4Kb in size.

Removing game-records from the PalmOS® device

Obviously, you can remove single records, either from the PalmOS® device (within Memo Pad), or from the Palm™ Desktop. If you are in PilotGOne, and you want to delete the current game record, you can use Edit This Var. If you want to delete many game-records simultaneously then you might be able to do something like this:

There is a (freeware) tool – Mass Transit – that makes it easier to delete multiple memos. It also lets you move, simultaneously, a number of selected memos to another category – could be useful. If you are patient, Mass Transit can be downloaded from palmgear.com. Alternatively go to Mass Transit's Home Page – splatbang. Please tell us your experience.

File/memo sizes

PilotGOne will happily work with, and create, memos that are longer than the 4 kb limit that MemoPad seems to impose. It is perfectly possible to view and delete stuff from these with MemoPad, but not to extend them. For PilotGOne, there is a practical limit of 64 kb, and some files larger than 4 kb may not work properly.

The Unix tools will let you download large SGF games as one memo.

Recent versions (v3.0, and later) of the Windows Palm™ Desktop can be used automatically to split large files into 4 Kb chunks, putting a part number in the First Line of each chunk. You will need to prepare the SGF file for later use: edit the file using a text editor such as Notepad, to create a meaningful "First Line" – e.g. Insert the text "Joseki_Dictionary" on a line of its own at the beginning of the SGF file. When in the Palm Desktop, Select the "Memo" icon; make sure that the Category is "SGF"; click on "File" / "Import..."; change to the directory where the SGF file is; (probably best to select "Files of Type: Text"); now type the name of the file in the "File name" field, and then click on the "Import" button at right. This will break up the SGF file into several memos with first lines like "Joseki_Dictionary 1", "Joseki_Dictionary 2", etc.

PilotGOne will now spot when you open a game whose first line ends in " 1", " 2", etc – note the space before the "1", etc – and join the chunks back together again, although you have to have enough memory free to do this, and it is a little slow. At present, there may be problems when Hot Syncing large memos – see Ideas for future features.

Some Odds and Ends

Known "Bugs"/Limitations

Some things that you may consider limitations may be included in Ideas for future features.

Ideas for future features

This is a wish-list – mainly for the benefit of (potential) developers. Warning: do not get too excited – some of these may never be implemented! ... unless you do it :-)

The categories below are not completely distinct.

Rules, SGF

Ease of Use

Variations

Managing Records, Sorting and Searching

Editing

Other

Some Sources of SGF Files

Sorry, some of the larger SGF files will not be very useful until we have better handling of memos which are bigger than 4 Kb.

PilotGOne Mailing lists

If you want to keep up-to-date with changes to PilotGOne, or want to share ideas about PilotGOne with other users, or want to help with the development of the program, then you can subscribe to an appropriate mailing list: You can subscribe by emailing <chosen-list>-subscribe@ithil.org – e.g. send an email to pilotgone-user-subscribe@ithil.org

As messages are sent they will be added to an archive of posted messages (new place). Anyone can read the archived messages – you do not have to be a subscriber to a list to do so.

These mailing lists use EZMLM (EZ Mailing List Manager). To find out what this offers you, check out the documentation of the EZMLM/IDX MAILING LIST MANAGER, or if this does not work, then a duplicate copy of the EZMAN-0.32: EZMLM/IDX USER'S MANUAL

Using ZIP Files

There are many programs that can unpack "ZIP" files. You may want to use one of these:

Splitting Files

There are many tools, available on host computers (especially PCs), for splitting files into smaller pieces. Perhaps find a freeware, or shareware, tool that suits you (not many features needed) by searching for "file split" at TUCOWS, or even cast the net wider by searching with Google, or your favourite search-engine. Maybe look for "split60i.zip" or "chop31.zip".

How can you help?

An easy way of helping might be to share in the discussion on one of the PilotGOne Mailing lists, especially the pilotgone-dev mailing list.

If you are a programmer, who is happy (to start) working in the very good development environment SDK 4.0 (supplied free by Palm), then check out the Ideas for future features to find a problem to solve, and then look at the sources that are freely available – maybe check with the pilotgone-dev mailing list, in case someone else is already working on it?

We are also looking for some general tools – for PalmOS® and/or Windows. Some things that would be helpful are:

PilotGOne Team – Credits

A number of people have been involved in various ways in bringing PilotGOne to its present state.

1998 - today: Brian Brunswick – the originator. In 1998 he worked on the first versions alone. He is still actively involved in the development, and is also responsible for running the web site and the mailing lists.

early 2000 - today: Sylvain Soliman: coding (first published in Nov 2000); co-ordinating function; beta-testing.

late 2000 - today: Harry Fearnley: documentation (first published April 2001); beta testing.

In early 2001, PilotGOne was placed under the Gnu GPL licence. Later in 2001, some mailing lists were created for PilotGOne users, and (potential) developers, to share ideas.

Throughout the years, a number of people have kindly reported problems that they found with PilotGOne – sometimes they have done extensive tests. Others have written with suggestions for additions, and improvements that they would like to see -- some of these have been very detailed specifications. Since early 2001, several others have helped with Beta testing, or have contributed specific bits of code. Sometimes, these people have been mentioned, by name, in the "Change History", sometimes not – sorry!

Individual contributors include (in alphabetical order of family name):
Joerg Abendroth, Tomas Brauer, Pascal Cuoq, Damien Doligez, Bob Felice, Jean-Loup Gailly, Todd Heidenrich, Peter Hoehe, Tobias Klaus, Burkhard Landskron, Nishikawara Youichi ( PalmGOne developer), Sebastian Strollo, Dan Stromberg, Steve Taylor, Mikael Thulin, Rodney Topor, Kenneth Yeon, and "The Nose who Knows".

Please let us know of any omissions.

We have also used the free tools: Palm Inc's PalmOS Software Development Kit, and PalmOS Emulator (POSE) -- especially for the screenshots; Xenu Link Sleuth to check the links in the web pages; gifsicle to create the animated GIF image; and JASC Software's shareware version 3.11 of Paint Shop Pro, for compressing the screenshot images, and converting from BMP to GIF and PNG format.

Development Platforms

Currently we use: Palm Pilot Professional, Palm IIIe, Handspring Visor Prism, Handspring Platinum, Sony Clie N770C (Japanese).

PalmGOne – Japanese Version

There is a Japanese variant of an earlier version (0.7.0?) of PilotGOne. It is called PalmGOne, and there is an associated eGroups Discussion Group – igo-palm – in Japanese. Many thanks to Nishikawara Youichi for this version. There is also a beta version -- probably based on PilotGOne 0.8.0.


Previous: Manage SGF Files: First Line, ..., Sorting/Searching       Contents       Next: Earlier Versions, Downloads, ...


HotSync and Palm OS are registered trademarks of Palm, Inc.