Re: [doc] How to do simple things? Missing

From: Christian Henning (chhenning_at_[hidden])
Date: 2019-06-10 20:08:45

Hi Miral,

there are a few snippets here:

https://github.com/boostorg/gil/wiki/Code-Samples

Hope this helps,
Christian

On Mon, Jun 10, 2019 at 7:21 AM Miral Shah <miralshah2211_at_[hidden]> wrote:

> I completely agree here with you. I started my journey with Boost.GIL by
> reading this question. Although GIL is well documented, one more thing we
> can do is add complete code snippets which can be copied and run directly.
> I have struggled with this problem because every time when I had to run
> something from documentation I first had to find the corresponding headers,
> or we can specify which headers are supposed to be included and we can let
> driver code written by the user.
>
> On Sat, Jun 8, 2019 at 1:12 AM Mateusz Loskot <mateusz_at_[hidden]> wrote:
>
> > Hi,
> >
> > Today I stumbled upon an interesting comment to a GIL related quetsion on
> > StackOverflow [1]:
> >
> > "Create an image of, say 512x512. Fill it with red pixels. Write to PNG.
> I
> > can't
> > find anything about doing any of that, at all, in the documentation for
> > gil."
> >
> > and
> >
> > "I had this same problem (...) the tutorial material shows you a ton of
> > clever
> > stuff with the view types...but then you come to try it yourself and
> > realize
> > you've still been given no idea how to actually create an concrete image
> > for
> > a view to refer to!"
> >
> > I think these are very important hints to us on how to make the
> > documentation
> > better. We need to consider growing the tutorials section, writing it as
> a
> > cookbook of basic and short recipies.
> >
> >
> > And, despite the lacking documentation the person is willing to share
> some
> > good
> > opinion: "stick with it [GIL], it really is an incredibly elegant library
> > for dealing with images". This should be encouraging, innit? :D
> >
> > [1]
> >
> https://stackoverflow.com/questions/5889235/creating-image-with-boost-gil#comment6776063_5889235
> >
> > Best regards,
> > --
> > Mateusz Loskot, http://mateusz.loskot.net
> > Fingerprint=C081 EA1B 4AFB 7C19 38BA  9C88 928D 7C2A BB2A C1F2
> > --
> > Boost-gil mailing list
> > Boost-gil_at_[hidden]
> > https://lists.boost.org/mailman/listinfo.cgi/boost-gil
> >
>
>
> --
> Thank you,
> Miral Shah
> --
> Boost-gil mailing list
> Boost-gil_at_[hidden]
> https://lists.boost.org/mailman/listinfo.cgi/boost-gil
>