Documentation and TODO changes.

This commit is contained in:
Pietro Gagliardi 2014-03-01 15:23:49 -05:00
parent be5458c0a3
commit 2e869615d3
2 changed files with 3 additions and 8 deletions

View File

@ -2,7 +2,7 @@
package ui package ui
// Go sets up the UI environment and runs main in a goroutine. // Go sets up the UI environment and runs main in a goroutine.
// If initialization fails, Go returns an error. // If initialization fails, Go returns an error and main is not called.
// Otherwise, Go does not return to its caller until (unless? TODO) the application loop exits, at which point it returns nil. // Otherwise, Go does not return to its caller until (unless? TODO) the application loop exits, at which point it returns nil.
// //
// This model is undesirable, but Cocoa limitations require it. // This model is undesirable, but Cocoa limitations require it.

View File

@ -23,6 +23,8 @@ so I don't forget:
- ensure MsgBoxError can run if initialization failed if things change ever - ensure MsgBoxError can run if initialization failed if things change ever
important things: important things:
- ui.Go() should exit when the main() you pass in exits
- because the main event loop is not called if initialization fails, it is presently impossible for MsgBoxError() to work if UI initialization fails; this basically means we cannot allow initializiation to fail on Mac OS X if we want to be able to report UI init failures to the user with one
- there's no GTK+ error handling whatsoever; we need to figure out how it works - there's no GTK+ error handling whatsoever; we need to figure out how it works
- make sure GTK+ documentation point differences don't matter - make sure GTK+ documentation point differences don't matter
- button sizes and LineEdit sizes on Windows seem too big; Comboboxes have margins - button sizes and LineEdit sizes on Windows seem too big; Comboboxes have margins
@ -55,11 +57,4 @@ far off:
maybe: maybe:
- rename Stack to Box? - rename Stack to Box?
- make Combobox and Listbox satisfy sort.Interface? - make Combobox and Listbox satisfy sort.Interface?
- this:
```
[16:27] <cespare> pietro10: depends what you mean by safe
[16:27] <cespare> pietro10: sounds like you should move this functionality into a function though.
[16:28] <cespare> (so the user can decide what to do with the error)
[16:28] <cespare> typically people don't like their libraries calling exit :)
```
- indeterminate progress bars (not supported on Windows 2000) - indeterminate progress bars (not supported on Windows 2000)