Is there some documentation describing how to add to the documentation? I'd 
be happy to do so if I had a clue how.

Eric

On Wednesday, February 25, 2015 at 10:08:41 AM UTC-6, Tim Holy wrote:
>
> It's a mix: the author has a lot of implicit knowledge that's s/he takes 
> for 
> granted, and that makes it harder to write good documentation. In 
> combination 
> with edits from the package author, a user who is just learning a package 
> is 
> the _perfect_ person to write documentation. 
>
> The other point is that developers who release code are giving a gift to 
> the 
> community, and then being extra nice by answering questions on the mailing 
> list. Asking the developers to do even more is, in a sense, asking too 
> much. 
> In my opinion, it's simply a fair exchange if the asker then takes that 
> information that s/he has received, polishes it up as necessary, and adds 
> it 
> to the README. I help you, you help me. 
>
> Converting "one answered question on the user list" into "one community- 
> contributed improvement in the documentation" will go a long, long ways to 
> improving the documentation for future users---if everyone did that, we 
> would 
> erase our documentation problems very quickly. 
>
> --Tim 
>
> On Wednesday, February 25, 2015 07:35:57 AM Eric S wrote: 
> > I guess I would if I had the knowledge. I was hoping the author of the 
> > package might help here since I'm assuming that person could do it much 
> > more efficiently. 
> > 
> > Eric 
> > 
> > On Wednesday, February 25, 2015 at 9:27:14 AM UTC-6, Tim Holy wrote: 
> > > By all means, please improve the documentation! 
> > > 
> > > --Tim 
> > > 
> > > On Wednesday, February 25, 2015 07:09:33 AM Eric S wrote: 
> > > > Thanks, 
> > > > 
> > > > This is exactly what I want. The documentation for the Tk package 
> > > 
> > > doesn't 
> > > 
> > > > list all the available methods/functions. There needs to be a more 
> > > > discoverable method of finding them than asking in the user group. 
> > > > 
> > > > Eric 
> > > > 
> > > > On Tuesday, February 24, 2015 at 6:55:52 PM UTC-6, j verzani wrote: 
> > > > > You can try `GetOpenFile`, `GetSaveFile`, or `ChooseDirectory` in 
> the 
> > > > > Tk.jl package. They all return a file name or "" if canceled. If 
> you 
> > > 
> > > have 
> > > 
> > > > > other calls you want, these are just simple wrappers. For example, 
> ` 
> > > > > GetOpenFile() = tcl("tk_getOpenFile")`. 
> > > > > 
> > > > > On Tuesday, February 24, 2015 at 6:56:21 PM UTC-5, Eric S wrote: 
> > > > >> I did try the Tk package instead. The message dialog look a lot 
> > > 
> > > better, 
> > > 
> > > > >> but there is nothing in the documentation which suggests how to 
> get 
> > > 
> > > at 
> > > 
> > > > >> Tk's 
> > > > >> askopenfile or other dialogs. Any help would be appreciated. 
> > > > >> 
> > > > >> Eric 
> > > > >> 
> > > > >> On Tuesday, February 24, 2015 at 5:22:19 PM UTC-6, Eric S wrote: 
> > > > >>> I'm enjoying Julia, but one thing I'm missing is standard file 
> open 
> > > 
> > > and 
> > > 
> > > > >>> file save dialogs. I've found the Gtk package and tried that. It 
> > > 
> > > does 
> > > 
> > > > >>> indeed generate a file dialog, but it is really ugly and 
> nonstandard 
> > > 
> > > (on 
> > > 
> > > > >>> OS 
> > > > >>> X) and also generates the following error like messages in the 
> > > 
> > > terminal 
> > > 
> > > > >>> (below). Perhaps there is something wrong with my installation. 
> > > > >>> 
> > > > >>> Is there something like how R works where you can just type "> 
> > > > >>> file.choose()" and a nice file picker dialog comes up. 
> > > > >>> 
> > > > >>> -Eric 
> > > > >>> 
> > > > >>> Gtk-Message: GtkDialog mapped without a transient parent. This 
> is 
> > > > >>> discouraged. 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): Gtk-WARNING **: Error loading theme icon 
> > > > >>> 'image-missing' for stock: Icon 'image-missing' not present in 
> theme 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): Gtk-WARNING **: Error loading theme icon 
> > > > >>> 'image-missing' for stock: Icon 'image-missing' not present in 
> theme 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): GLib-GObject-CRITICAL **: g_object_ref: 
> assertion 
> > > > >>> 'G_IS_OBJECT (object)' failed 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): Gtk-WARNING **: Error loading theme icon 
> > > > >>> 'image-missing' for stock: Icon 'image-missing' not present in 
> theme 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): Gtk-WARNING **: Error loading theme icon 
> > > > >>> 'image-missing' for stock: Icon 'image-missing' not present in 
> theme 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): GLib-GObject-CRITICAL **: g_object_ref: 
> assertion 
> > > > >>> 'G_IS_OBJECT (object)' failed 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): Gtk-WARNING **: Error loading theme icon 
> > > > >>> 'image-missing' for stock: Icon 'image-missing' not present in 
> theme 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): Gtk-WARNING **: Error loading theme icon 
> > > > >>> 'image-missing' for stock: Icon 'image-missing' not present in 
> theme 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): GLib-GObject-CRITICAL **: g_object_ref: 
> assertion 
> > > > >>> 'G_IS_OBJECT (object)' failed 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): Gtk-WARNING **: Error loading theme icon 
> > > > >>> 'image-missing' for stock: Icon 'image-missing' not present in 
> theme 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): Gtk-WARNING **: Error loading theme icon 
> > > > >>> 'image-missing' for stock: Icon 'image-missing' not present in 
> theme 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): GLib-GObject-CRITICAL **: g_object_ref: 
> assertion 
> > > > >>> 'G_IS_OBJECT (object)' failed 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): Gtk-WARNING **: Error loading theme icon 
> > > > >>> 'image-missing' for stock: Icon 'image-missing' not present in 
> theme 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): Gtk-WARNING **: Error loading theme icon 
> > > > >>> 'image-missing' for stock: Icon 'image-missing' not present in 
> theme 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): GLib-GObject-CRITICAL **: g_object_ref: 
> assertion 
> > > > >>> 'G_IS_OBJECT (object)' failed 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): Gtk-WARNING **: Error loading theme icon 
> > > > >>> 'image-missing' for stock: Icon 'image-missing' not present in 
> theme 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): Gtk-WARNING **: Error loading theme icon 
> > > > >>> 'image-missing' for stock: Icon 'image-missing' not present in 
> theme 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): GLib-GObject-CRITICAL **: g_object_ref: 
> assertion 
> > > > >>> 'G_IS_OBJECT (object)' failed 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): Gtk-WARNING **: Error loading theme icon 
> > > > >>> 'image-missing' for stock: Icon 'image-missing' not present in 
> theme 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): Gtk-WARNING **: Error loading theme icon 
> > > > >>> 'image-missing' for stock: Icon 'image-missing' not present in 
> theme 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): GLib-GObject-CRITICAL **: g_object_ref: 
> assertion 
> > > > >>> 'G_IS_OBJECT (object)' failed 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): Gtk-WARNING **: Error loading theme icon 
> > > > >>> 'image-missing' for stock: Icon 'image-missing' not present in 
> theme 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): Gtk-WARNING **: Error loading theme icon 
> > > > >>> 'image-missing' for stock: Icon 'image-missing' not present in 
> theme 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): GLib-GObject-CRITICAL **: g_object_ref: 
> assertion 
> > > > >>> 'G_IS_OBJECT (object)' failed 
> > > 
> > > > >>> (<unknown>:2678): GLib-GObject-CRITICAL **: g_object_unref: 
> > > assertion 
> > > 
> > > > >>> 'G_IS_OBJECT (object)' failed 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): Gtk-WARNING **: Error loading theme icon 
> > > > >>> 'image-missing' for stock: Icon 'image-missing' not present in 
> theme 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): Gtk-WARNING **: Error loading theme icon 
> > > > >>> 'image-missing' for stock: Icon 'image-missing' not present in 
> theme 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): GLib-GObject-CRITICAL **: g_object_ref: 
> assertion 
> > > > >>> 'G_IS_OBJECT (object)' failed 
> > > 
> > > > >>> (<unknown>:2678): GLib-GObject-CRITICAL **: g_object_unref: 
> > > assertion 
> > > 
> > > > >>> 'G_IS_OBJECT (object)' failed 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): Gtk-WARNING **: Error loading theme icon 
> > > > >>> 'image-missing' for stock: Icon 'image-missing' not present in 
> theme 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): Gtk-WARNING **: Error loading theme icon 
> > > > >>> 'image-missing' for stock: Icon 'image-missing' not present in 
> theme 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): GLib-GObject-CRITICAL **: g_object_ref: 
> assertion 
> > > > >>> 'G_IS_OBJECT (object)' failed 
> > > 
> > > > >>> (<unknown>:2678): GLib-GObject-CRITICAL **: g_object_unref: 
> > > assertion 
> > > 
> > > > >>> 'G_IS_OBJECT (object)' failed 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): Gtk-WARNING **: Error loading theme icon 
> > > > >>> 'image-missing' for stock: Icon 'image-missing' not present in 
> theme 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): Gtk-WARNING **: Error loading theme icon 
> > > > >>> 'image-missing' for stock: Icon 'image-missing' not present in 
> theme 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): GLib-GObject-CRITICAL **: g_object_ref: 
> assertion 
> > > > >>> 'G_IS_OBJECT (object)' failed 
> > > 
> > > > >>> (<unknown>:2678): GLib-GObject-CRITICAL **: g_object_unref: 
> > > assertion 
> > > 
> > > > >>> 'G_IS_OBJECT (object)' failed 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): Gtk-WARNING **: Error loading theme icon 
> > > > >>> 'image-missing' for stock: Icon 'image-missing' not present in 
> theme 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): Gtk-WARNING **: Error loading theme icon 
> > > > >>> 'image-missing' for stock: Icon 'image-missing' not present in 
> theme 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): GLib-GObject-CRITICAL **: g_object_ref: 
> assertion 
> > > > >>> 'G_IS_OBJECT (object)' failed 
> > > 
> > > > >>> (<unknown>:2678): GLib-GObject-CRITICAL **: g_object_unref: 
> > > assertion 
> > > 
> > > > >>> 'G_IS_OBJECT (object)' failed 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): Gtk-WARNING **: Error loading theme icon 
> > > > >>> 'image-missing' for stock: Icon 'image-missing' not present in 
> theme 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): Gtk-WARNING **: Error loading theme icon 
> > > > >>> 'image-missing' for stock: Icon 'image-missing' not present in 
> theme 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): GLib-GObject-CRITICAL **: g_object_ref: 
> assertion 
> > > > >>> 'G_IS_OBJECT (object)' failed 
> > > 
> > > > >>> (<unknown>:2678): GLib-GObject-CRITICAL **: g_object_unref: 
> > > assertion 
> > > 
> > > > >>> 'G_IS_OBJECT (object)' failed 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): Gtk-WARNING **: Error loading theme icon 
> > > > >>> 'image-missing' for stock: Icon 'image-missing' not present in 
> theme 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): Gtk-WARNING **: Error loading theme icon 
> > > > >>> 'image-missing' for stock: Icon 'image-missing' not present in 
> theme 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): GLib-GObject-CRITICAL **: g_object_ref: 
> assertion 
> > > > >>> 'G_IS_OBJECT (object)' failed 
> > > 
> > > > >>> (<unknown>:2678): GLib-GObject-CRITICAL **: g_object_unref: 
> > > assertion 
> > > 
> > > > >>> 'G_IS_OBJECT (object)' failed 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): Gtk-WARNING **: Error loading theme icon 
> > > > >>> 'image-missing' for stock: Icon 'image-missing' not present in 
> theme 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): Gtk-WARNING **: Error loading theme icon 
> > > > >>> 'image-missing' for stock: Icon 'image-missing' not present in 
> theme 
> > > > >>> 
> > > > >>> 
> > > > >>> (<unknown>:2678): GLib-GObject-CRITICAL **: g_object_ref: 
> assertion 
> > > > >>> 'G_IS_OBJECT (object)' failed 
> > > 
> > > > >>> (<unknown>:2678): GLib-GObject-CRITICAL **: g_object_unref: 
> > > assertion 
> > > 
> > > > >>> 'G_IS_OBJECT (object)' failed 
>
>

Reply via email to