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
