TODO

   1 This file contains features that need work.  If you wish to tackle
   2 any of them, please post a quick message to the mailing list of your
   3 intentions, in order to avoid duplication of effort.
   4
   5 If you would like help or more information on any of these items,
   6 please ask on the mailing list as well.
   7
   8 - Chris
   9 <cdfrey@foursquare.net>
  10
  11
  12 Next Release Checklist (- todo, + done, x skipped)
  13 ==============================================================================
  14 Target: release version 0.15
  15         - finish javaloader support, implementing all known commands
  16                 + write COD to device
  17                 + list
  18                 + set time
  19                 - device-info
  20                 + screenshot
  21                 + delete COD files (javaloader erase)
  22         - polish up bfuse, and add feature to split out fields
  23         - add record classes for Content Store, SMS Messages, based on
  24                 Martin Owens' doc/barry-research.ods
  25         - test and fix all build and functionality issues on:
  26                 - Fedora 10
  27                 - Ubuntu 8.10
  28                 - Debian lenny and unstable
  29                         - see sknauert's email
  30                 - openSUSE 11.1
  31                         - see mailing list reports
  32                 - give openBSD a test compile
  33         - catchup on sourceforge tracker items
  34         - incorporate Bill Paul's modem HOWTO for FreeBSD into web docs
  35                 (see list emails)
  36         - review all website documentation before release
  37         + make sure all manpages are up to date, including bjavaloader
  38
  39 Target: release version 0.16
  40         - port opensync plugin to 0.4x
  41
  42
  43
  44
  45 General Features
  46 ==============================================================================
  47
  48 Add support for the Blackberry Storm
  49 ------------------------------------
  50 The new Blackberry Storm, model 9530, appears to have a different database
  51 protocol.  This will likely be an ongoing effort to add support for this
  52 device, or at least find a way to use the old protocol with it.
  53
  54 Search the mailing list archives for "Storm" or "9530".
  55
  56
  57 Look into password support in the OpenSync framework
  58 ----------------------------------------------------
  59 Currently, if a Blackberry uses a password, in order to sync it,
  60 you need to store the password in plaintext in the sync configuration.
  61 This is less than ideal.
  62
  63 Ideally, opensync should prompt for the password, so that this is a
  64 part of the user interface.  Someone needs to research OpenSync, and if
  65 there is support for passwords in the plugin API, implement it for Barry
  66
  67
  68 Reverse engineer date/time functions
  69 ------------------------------------
  70 The date/time calculations in src/time.cc:Message2Time() are still not
  71 completely understood.  There is an explanation of sorts in an email
  72 from Brian Edginton on the mailing list, but there are odd constants, etc.
  73 Need to understand it fully and document it.
  74
  75 Mail from Brian Edginton on the topic:
  76 http://sourceforge.net/mailarchive/message.php?msg_id=200706291619.05854.edge%40edginton.net
  77
  78
  79 Fix GUI configure script to run a check for libtar
  80 --------------------------------------------------
  81 Currently, the autoconf scripts only take an argument on the command line
  82 for the location of libtar, and assumes its location otherwise.
  83 There should be an actual test for this, that tries linking against
  84 libtar, and stops the configure script if not available.
  85
  86
  87 An automated test suite
  88 -----------------------
  89 Testing Barry will be a challenge, since an actual device is required
  90 for a large bulk of tests.  Ideally, it should be easy for someone to
  91 make a full backup of their device, donate it to science, and then
  92 restore their settings and data, since not everyone has a pure device
  93 for testing.
  94
  95 Things that need automated testing:
  96
  97         - test all possible compile options (finished, see test/)
  98         - test parsing of all supported records
  99         - test building of all supported records
 100         - test backup and restore, of random sets of databases, as well
 101                 as the "all databases" set
 102         - test LDAP / LDIF conversions
 103         - test test Boost serialization backups and restore
 104         - make sure it is possible to create records with the same
 105                 SHA1 sums, purely programmatically
 106         - test syncing of all fields, including international data / charsets
 107         - test password support, and password safety catch (bad passwd X times)
 108         - test modem functionality
 109
 110 Estimated time: open ended
 111
 112
 113
 114 Flesh out the Troubleshooting web doc
 115 -------------------------------------
 116 Every stumbling block that users run into should either be fixed
 117 in the code or binary package, or documented in a Troubleshooting
 118 document.  This troubleshooting document is already started, but
 119 contributions are welcome from all users!
 120
 121
 122
 123 Porting opensync plugin to opensync 0.40
 124 ----------------------------------------
 125 There's two options to this item:
 126
 127         - simple way
 128         - proper way
 129
 130 The difference between opensync 0.22 and 0.40 involves some API changes.
 131 You should be able to note the changes in the example plugin code once
 132 0.40 is released.
 133
 134 The simple way involves merely updating Barry's opensync plugin to match
 135 the new API.  This shouldn't be too difficult, but you may run across
 136 some small surprises.
 137
 138 The proper way involves:
 139
 140         - switching from the vcard/vevent formats to the opensync XML
 141                 formats
 142         - switching from storing state information in text files to
 143                 storing it in the built in database (optional)
 144         - making use of the new opensync time APIs to properly support
 145                 timezones for all time operations
 146
 147 Switching away from text based vcard and vevent formats will remove
 148 the burden of raw data parsing and formatting from the plugin itself,
 149 and make use of the more tested opensync library.  Any bugs fixed
 150 in opensync's parsers will automatically fix bugs in the Barry plugin.
 151
 152 Switching state storage formats may allow for greater flexibility
 153 in supporting multiple devices.  This needs more research, but it
 154 is the "way things are done" in opensync, and likely worth moving
 155 in that direction.
 156
 157 Support for timezones will likely stress the opensync API as well as
 158 the Barry API, but definitely needs to be done for completeness on both
 159 sides of the equation.
 160
 161 Estimated time:   simple way: 10 hours if lucky
 162                   proper way: open ended
 163
 164
 165
 166 Adding support for Tasks database to opensync plugin
 167 ----------------------------------------------------
 168 This will require research into the proper vformat for tasks.  If
 169 the above port to 0.40 is complete, then use the XML format.  If not,
 170 then find the appropriate v-format.
 171
 172 Estimated time: 16 hours
 173 Depending on: ideally, wait for 0.40 XML format support
 174
 175
 176
 177 Adding support for Memos (notes) to opensync plugin
 178 ---------------------------------------------------
 179 Same as above, for Tasks.  If done together, may be able to save some time.
 180
 181 Estimated time: 16 hours
 182 Depending on: ideally, wait for 0.40 XML format support
 183
 184
 185
 186 Adding support for recurring calendar items to opensync plugin
 187 --------------------------------------------------------------
 188 See vCalendar::RecurToBarryCal() in the opensync sources, and compare
 189 with RecurToVCal().  See also iCal format RFC's.
 190 http://tools.ietf.org/html/rfc2445
 191
 192
 193
 194 Multi-program Database and Modem Access
 195 ---------------------------------------
 196 The architectural challenge:
 197
 198         As Barry is not a single application, how do you access the
 199         database while pppob is using the modem?
 200
 201 There are two viable ways of dealing with this.  One involves placing
 202 a (hopefully thin) driver in the kernel, and the other involves using
 203 a daemon and RPC calls.
 204
 205 My preference is to implement this using RPC calls if needed, and hammer
 206 out all the implementation details in user space.  Once they are well
 207 understood, a smaller kernel driver hook may be more easily written
 208 that supports routing messages according to socket or application
 209 needs.  For example, one application may register an interest in
 210 database messages, another in javaloader messages, and another in the
 211 multiple modem socket messages.
 212
 213 There is currently no support for this RPC daemon, but threading
 214 support already exists.
 215
 216 Estimated tasks:
 217         - design suitable RPC system
 218         - implement support in the Barry library so it works
 219                 with and without a daemon, using the same API
 220 Estimated time: open ended
 221
 222
 223
 224 Add bluetooth serial support
 225 ----------------------------
 226 It is reported that it is possible to access the database through
 227 Bluetooth using the older Blackberry serial protocol.  XmBlackBerry
 228 has support for this and may be used as a reference.
 229
 230 The goal here would be to hide the bluetooth access behind the
 231 same Barry library API, so that syncing with the opensync plugin
 232 would be seamless whether plugged in via USB or Bluetooth.
 233
 234 Estimated tasks:
 235         - research and design serial protocol stack to reuse as much
 236                 library code as possible
 237 Estimated time: unknown
 238
 239
 240
 241 Add internationalization (i18n) support to the backup GUI and tools
 242 -------------------------------------------------------------------
 243 Translations are needed for the GUI and command line tool prompts, as
 244 well as support in the code for this translation.
 245
 246 Estimated tasks:
 247         - update the code to support i18n
 248         - translate to languages of interest
 249
 250 Estimated time: unknown
 251
 252
 253
 254 Write simple GUI for streamlining sync setup and action
 255 -------------------------------------------------------
 256 Syncing setup and operation is currently a tedious, complicated task.
 257 A GUI that performed all the detailed setup and configuration work,
 258 for a Blackberry-specific sync, using opensync libraries and plugins
 259 for Evolution, Sunbird, etc, would be very helpful.
 260
 261 This would be much easier for an experienced GUI programmer, but there is
 262 a learning curve for the opensync API.
 263
 264 Estimated tasks:
 265         - document the settings required for Blackberry, and
 266                 all intended plugins required
 267         - write application that:
 268                 - does the opensync configuration through the opensync
 269                         API directly
 270                 - scans the USB bus for available Blackberry devices using
 271                         Barry
 272                 - lives in the system tray watching for Blackberry devices
 273         - if aiming for super ease of use, script a source build of
 274                 all needed opensync components and install in private
 275                 area to avoid conflict with system
 276 Estimated time: unknown
 277 Note: Depending how fast HAL, OpenSync, and Conduit are implemented,
 278         this may never be needed... but if it existed today, there's a
 279         lot of users who would be very happy...
 280
 281
 282
 283 Document the USB protocol
 284 -------------------------
 285 Currently the only english documentation for the Blackberry protocol
 286 is the webpage by the Cassis project (found at
 287 http://off.net/cassis/protocol-description.html).
 288
 289 The USB protocol is not nearly so well documented.  The best documentation
 290 available can be found in the Barry header files: protocol.h and
 291 protostructs.h.
 292
 293 Translating the code into documentation (into a wiki, that will hopefully
 294 soon be available) is a great way to get involved in the project and
 295 learn a lot about the Blackberry from a low level.
 296
 297 Unfortunately, Jedi mind tricks don't often work when trying to convince
 298 people to write documentation for me... :-)
 299
 300 Estimated tasks:
 301         - write, write, write
 302 Estimated time: 40 hours (documentation expands to fill available time...)
 303
 304
 305
 306 Code cleanup
 307 ------------
 308 Code can always be improved.  There are two big ways to help:
 309
 310         - write an application using the Barry library
 311         - improve the Barry library itself and send patches
 312
 313 By writing an application, you can provide crucial feedback on the ease
 314 of use of the Barry API.  I'm very eager for such feedback.
 315
 316 Secondly, there is currently a lot of code ducplication in the record
 317 classes, and a careful refactoring is required.  I would be open to a class
 318 hierarchy, with possibly private or protected inheritance.  My primary
 319 concern is object safety when using the record classes as objects in
 320 STL containers, with a secondary concern to make it easier to
 321 abstractly work with a record.  This implies a careful mix of
 322 virtual functions and a generic record base class.  Patches in this
 323 area will be thoughtfully considered.
 324
 325 Estimated tasks (refactoring):
 326         - design safe hierarchy
 327         - move common code to base class
 328         - make sure all record classes use the common record API
 329         - test
 330 Estimated time: 7 hours
 331
 332
 333
 334 C API wrapper
 335 -------------
 336 For those that write applications in C, a C API wrapper has been started
 337 in the cbarry.h header.  It has not yet been implemented, but should be
 338 straightforward.
 339
 340 Estimated tasks:
 341         - finish some API design work (head not fully complete)
 342         - implement all functions (about 50)
 343         - write test application, or test suite, for C API
 344 Estimated time: unknown
 345
 346
 347
 348 Python wrappers and example code
 349 --------------------------------
 350 For those that write applications in Python, a SWIG wrapper has been
 351 started by H Miz Jones.  This is partially functional, and involves
 352 working with the Barry API, and may introduce changes to it depending
 353 how hard it is to translate things to the Python world.
 354
 355 The SWIG wrapper scripts have not yet been publically released, but
 356 please contact me if you are interested.
 357
 358 Estimated tasks:
 359         - finish C++ / Python integration (possible template issues)
 360         - finish SWIG wrapper
 361 Estimated time: unknown
 362
 363
 364
 365 Command line backup and restore
 366 -------------------------------
 367 The only command line backup currently available is the one in btool,
 368 using the -f and -s switches.  This does not backup exact data from
 369 the device, but parses it, stores it in the Boost serialization format,
 370 and then reverses the process for restore.  This is a great test
 371 for the Barry library, but not so great for backup, since not all
 372 databases can be parsed.
 373
 374 There is already an exact backup and restore interface with the GUI, but
 375 there is a lot of useful functionality trapped in a layer of GUI
 376 that could be just as useful from the command line.  Tasks such as a nightly
 377 cron backup of any Blackberry devices attached to the system would be more
 378 easily done via command line.
 379
 380 You could add command line arguments to the barrybackup program to skip
 381 the GUI (tricky and possibly error prone), or you could pull the backup
 382 functionality into a standalone command line utility (more work, but smarter
 383 in the long run).  This is mostly a code refactoring job, consisting of
 384 all working code that's already there, and I know there are people
 385 who would thank you. :-)
 386
 387 Note: see also the perl scripts in contrib/
 388
 389 Estimated tasks:
 390         - split out tar and backup functionality code into shared library
 391         - write and test command line tool
 392 Estimated time: 6 hours
 393
 394
 395
 396 Misc Low Level Todo Items:
 397 --------------------------
 398 - test whether sorting of contact records is required before
 399         uploading data to the device... test whether it is ok
 400         to upload a GroupLink item in the middle of a contact
 401         upload, even before all the groups have been sent...
 402         if ok, remove the sorting code from Contact, Message, and
 403         Calendar classes
 404