Re: [Gambas-user] Gambas-Documentation

[PICCORO McKAY Lenz]

Hi adamnt42,

2017-06-06 20:40 GMT-04:00 adamn...@gmail.com :
>
> What is the "Size" parameter in GetIcon(Size As Integer)?
>
> Where is a convenient place to talk about that question? I don't think it
really belongs in the mailing list as it may take a reasonable time before
someone with that knowledge notices the post and answers it. In the mean
time the post just drifts farther and farther down the time line.  I don't
think that adding content to the page concerned would work either, as the
person with the knowledge is not likely to be referring to the page in the
course of their normal day.

same happened to me on the ODBC documentation.. many errors happened and
due mail list dont answer quickly (and to not receive responses like "it's
obviously that") i decide triying by myselft.. that take me a lot of time
but well...the result was that ODBC module componente has some bugs
reported by me...

>
> And while I'm at it - how do you add an image to a wiki page? Like the
http://gambaswiki.org/wiki/howto/makereport/arrange.png?  in the "How to to
make a report with Gambas" page.  Note, I mean how do I upload the .png
files I want to put in a page, not how to reference it in the markup ( i.e.
I know "[doc/myhowto/blah.png]" ).

a big problem, graphical examples need images with those in action... for
that i not have a suggested solution due i not code too many desktop apps..
i made more daemons and services programs in gambas ...

>
> cheers
> b
>
> --
> B Bruen 
>
>
--
> Check out the vibrant tech community on one of the world's most
> engaging tech sites, Slashdot.org! http://sdm.link/slashdot
> ___
> Gambas-user mailing list
> Gambas-user@lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/gambas-user
--
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
___
Gambas-user mailing list
Gambas-user@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/gambas-user

Re: [Gambas-user] Gambas-Documentation

[Benoît Minisini via Gambas-user]

Le 07/06/2017 à 02:40, adamn...@gmail.com a écrit :

I think one of the things that is hard about doing something about
the documentation is that there does not appear to be any simple way
to collaborate on it.  For example, stirred up a bit by this thread,
I started having a go at some of the wiki "ToDo" list, specifically
the gb.desktop component.  I had added some descriptive and example
content for much of the DesktopFile class then hit this snag

What is the "Size" parameter in GetIcon(Size As Integer)?

Where is a convenient place to talk about that question? I don't
think it really belongs in the mailing list as it may take a
reasonable time before someone with that knowledge notices the post
and answers it. In the mean time the post just drifts farther and
farther down the time line.  I don't think that adding content to the
page concerned would work either, as the person with the knowledge is
not likely to be referring to the page in the course of their normal
day.

And while I'm at it - how do you add an image to a wiki page? Like
the http://gambaswiki.org/wiki/howto/makereport/arrange.png?  in the
"How to to make a report with Gambas" page.  Note, I mean how do I
upload the .png files I want to put in a page, not how to reference
it in the markup ( i.e. I know "[doc/myhowto/blah.png]" ).

cheers b



Images are wiki pages whose URL ends with ".png" or ".jpg".

To upload an image, you have to login and then access the page. You will
get then a button to upload the image.

Regards,

--
Benoît Minisini

--
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
___
Gambas-user mailing list
Gambas-user@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/gambas-user

Re: [Gambas-user] Gambas-Documentation

[adamn...@gmail.com]

I think one of the things that is hard about doing something about the 
documentation is that there does not appear to be any simple way to collaborate 
on it.  For example, stirred up a bit by this thread, I started having a go at 
some of the wiki "ToDo" list, specifically the gb.desktop component.  I had 
added some descriptive and example content for much of the DesktopFile class 
then hit this snag

What is the "Size" parameter in GetIcon(Size As Integer)?

Where is a convenient place to talk about that question? I don't think it 
really belongs in the mailing list as it may take a reasonable time before 
someone with that knowledge notices the post and answers it. In the mean time 
the post just drifts farther and farther down the time line.  I don't think 
that adding content to the page concerned would work either, as the person with 
the knowledge is not likely to be referring to the page in the course of their 
normal day.

And while I'm at it - how do you add an image to a wiki page? Like the 
http://gambaswiki.org/wiki/howto/makereport/arrange.png?  in the "How to to 
make a report with Gambas" page.  Note, I mean how do I upload the .png files I 
want to put in a page, not how to reference it in the markup ( i.e. I know 
"[doc/myhowto/blah.png]" ).

cheers
b

-- 
B Bruen 

--
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
___
Gambas-user mailing list
Gambas-user@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/gambas-user

Re: [Gambas-user] Gambas-Documentation

[Jussi Lahtinen]

I meant documentation should have example codes. It's great point to start
with, and it doesn't require much skills in English.
If examples are out of date, then likely also documentation is out of date.
So, it's not specific problem of example code.


Jussi



On Tue, Jun 6, 2017 at 9:58 PM, PICCORO McKAY Lenz 
wrote:

> 2017-06-06 14:32 GMT-04:00 Jussi Lahtinen :
> > I think many times short example codes tells much more, than human
> language
> > explanation. If the function, variable, etc names are in English, then I
> > think it is usually enough. Maybe some short comments are necessary
> > sometimes. Let the Gambas be our common language.
>
> documentation its the firts piece of view when a project its about to
> start! come on, if this where true, no maillist will exist,
>
> and taking about of pieces of code, in the past all "odbc connections
> examples" was out of date, that more thant help new developers make it
> confuses
>
> >
> >
> > Jussi
> >
> >
> >
> > On Tue, Jun 6, 2017 at 7:49 PM, Dimitris Anogiatis 
> wrote:
> >
> >> While Google translate and other online transaction tools are not
> perfect
> >> we could try a few of them to see which combination of such tools makes
> >> more sense for both the English side and the non-English side.
> >>
> >> Keep in mind that the way we put words to our thoughts is also affected
> by
> >> different patterns and experiences in all our lives as well as mood and
> >> stress levels at the time of asking for info or documenting a piece of
> >> code. Plus not all words have a direct equivalent in every language. So
> we
> >> also have to have a balance between specifics and verbosity.
> >>
> >> That's my 2 cents worth of wisdom anyways :)
> >>
> >> On Jun 6, 2017 10:00 AM, "Benoît Minisini via Gambas-user" <
> >> gambas-user@lists.sourceforge.net> wrote:
> >>
> >> Le 06/06/2017 à 17:54, PICCORO McKAY Lenz a écrit :
> >>
> >> > hi benoit, there many issues in gb.db specifically in odbc component,
> i
> >> > wish to be fixed in the next release please, thanks in advance
> >> >
> >> > currently i can to contribute to the documentation how-to's wiki parts
> >> but
> >> > i cannot write on both languajes, its very tedious for me write
> english..
> >> > so if any could translate from spanish will be usefully
> >> >
> >> >
> >> I don't speak spanish, and your english is often unreadable, so we need
> >> some help...
> >>
> >> --
> >> Benoît Minisini
> >>
> >>
> >> 
> >> --
> >> Check out the vibrant tech community on one of the world's most
> >> engaging tech sites, Slashdot.org! http://sdm.link/slashdot
> >> ___
> >> Gambas-user mailing list
> >> Gambas-user@lists.sourceforge.net
> >> https://lists.sourceforge.net/lists/listinfo/gambas-user
> >> 
> >> --
> >> Check out the vibrant tech community on one of the world's most
> >> engaging tech sites, Slashdot.org! http://sdm.link/slashdot
> >> ___
> >> Gambas-user mailing list
> >> Gambas-user@lists.sourceforge.net
> >> https://lists.sourceforge.net/lists/listinfo/gambas-user
> >>
> > 
> --
> > Check out the vibrant tech community on one of the world's most
> > engaging tech sites, Slashdot.org! http://sdm.link/slashdot
> > ___
> > Gambas-user mailing list
> > Gambas-user@lists.sourceforge.net
> > https://lists.sourceforge.net/lists/listinfo/gambas-user
>
> 
> --
> Check out the vibrant tech community on one of the world's most
> engaging tech sites, Slashdot.org! http://sdm.link/slashdot
> ___
> Gambas-user mailing list
> Gambas-user@lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/gambas-user
>
--
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
___
Gambas-user mailing list
Gambas-user@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/gambas-user

Re: [Gambas-user] Gambas-Documentation

[Cristiano Guadagnino]

I speak both spanish and english, so I can be of help, but my free time is
very limited, so ultimately it depends on the amount of work that needs to
be done.

Cris



   Sent with Mailtrack


On Tue, Jun 6, 2017 at 5:59 PM, Benoît Minisini via Gambas-user <
gambas-user@lists.sourceforge.net> wrote:

> Le 06/06/2017 à 17:54, PICCORO McKAY Lenz a écrit :
>
>> hi benoit, there many issues in gb.db specifically in odbc component, i
>> wish to be fixed in the next release please, thanks in advance
>>
>> currently i can to contribute to the documentation how-to's wiki parts
>> but i cannot write on both languajes, its very tedious for me write
>> english.. so if any could translate from spanish will be usefully
>>
>>
> I don't speak spanish, and your english is often unreadable, so we need
> some help...
>
> --
> Benoît Minisini
>
>
> 
> --
> Check out the vibrant tech community on one of the world's most
> engaging tech sites, Slashdot.org! http://sdm.link/slashdot
> ___
> Gambas-user mailing list
> Gambas-user@lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/gambas-user
>
--
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
___
Gambas-user mailing list
Gambas-user@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/gambas-user

Re: [Gambas-user] Gambas-Documentation

[PICCORO McKAY Lenz]

2017-06-06 14:32 GMT-04:00 Jussi Lahtinen :
> I think many times short example codes tells much more, than human language
> explanation. If the function, variable, etc names are in English, then I
> think it is usually enough. Maybe some short comments are necessary
> sometimes. Let the Gambas be our common language.

documentation its the firts piece of view when a project its about to
start! come on, if this where true, no maillist will exist,

and taking about of pieces of code, in the past all "odbc connections
examples" was out of date, that more thant help new developers make it
confuses

>
>
> Jussi
>
>
>
> On Tue, Jun 6, 2017 at 7:49 PM, Dimitris Anogiatis  wrote:
>
>> While Google translate and other online transaction tools are not perfect
>> we could try a few of them to see which combination of such tools makes
>> more sense for both the English side and the non-English side.
>>
>> Keep in mind that the way we put words to our thoughts is also affected by
>> different patterns and experiences in all our lives as well as mood and
>> stress levels at the time of asking for info or documenting a piece of
>> code. Plus not all words have a direct equivalent in every language. So we
>> also have to have a balance between specifics and verbosity.
>>
>> That's my 2 cents worth of wisdom anyways :)
>>
>> On Jun 6, 2017 10:00 AM, "Benoît Minisini via Gambas-user" <
>> gambas-user@lists.sourceforge.net> wrote:
>>
>> Le 06/06/2017 à 17:54, PICCORO McKAY Lenz a écrit :
>>
>> > hi benoit, there many issues in gb.db specifically in odbc component, i
>> > wish to be fixed in the next release please, thanks in advance
>> >
>> > currently i can to contribute to the documentation how-to's wiki parts
>> but
>> > i cannot write on both languajes, its very tedious for me write english..
>> > so if any could translate from spanish will be usefully
>> >
>> >
>> I don't speak spanish, and your english is often unreadable, so we need
>> some help...
>>
>> --
>> Benoît Minisini
>>
>>
>> 
>> --
>> Check out the vibrant tech community on one of the world's most
>> engaging tech sites, Slashdot.org! http://sdm.link/slashdot
>> ___
>> Gambas-user mailing list
>> Gambas-user@lists.sourceforge.net
>> https://lists.sourceforge.net/lists/listinfo/gambas-user
>> 
>> --
>> Check out the vibrant tech community on one of the world's most
>> engaging tech sites, Slashdot.org! http://sdm.link/slashdot
>> ___
>> Gambas-user mailing list
>> Gambas-user@lists.sourceforge.net
>> https://lists.sourceforge.net/lists/listinfo/gambas-user
>>
> --
> Check out the vibrant tech community on one of the world's most
> engaging tech sites, Slashdot.org! http://sdm.link/slashdot
> ___
> Gambas-user mailing list
> Gambas-user@lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/gambas-user

--
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
___
Gambas-user mailing list
Gambas-user@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/gambas-user

Re: [Gambas-user] Gambas-Documentation

[Jussi Lahtinen]

I think many times short example codes tells much more, than human language
explanation. If the function, variable, etc names are in English, then I
think it is usually enough. Maybe some short comments are necessary
sometimes. Let the Gambas be our common language.


Jussi



On Tue, Jun 6, 2017 at 7:49 PM, Dimitris Anogiatis  wrote:

> While Google translate and other online transaction tools are not perfect
> we could try a few of them to see which combination of such tools makes
> more sense for both the English side and the non-English side.
>
> Keep in mind that the way we put words to our thoughts is also affected​ by
> different patterns and experiences in all our lives as well as mood and
> stress levels at the time of asking for info or documenting a piece of
> code. Plus not all words have a direct equivalent in every language. So we
> also have to have a balance between specifics and verbosity.
>
> That's my 2 cents worth of wisdom anyways :)
>
> On Jun 6, 2017 10:00 AM, "Benoît Minisini via Gambas-user" <
> gambas-user@lists.sourceforge.net> wrote:
>
> Le 06/06/2017 à 17:54, PICCORO McKAY Lenz a écrit :
>
> > hi benoit, there many issues in gb.db specifically in odbc component, i
> > wish to be fixed in the next release please, thanks in advance
> >
> > currently i can to contribute to the documentation how-to's wiki parts
> but
> > i cannot write on both languajes, its very tedious for me write english..
> > so if any could translate from spanish will be usefully
> >
> >
> I don't speak spanish, and your english is often unreadable, so we need
> some help...
>
> --
> Benoît Minisini
>
>
> 
> --
> Check out the vibrant tech community on one of the world's most
> engaging tech sites, Slashdot.org! http://sdm.link/slashdot
> ___
> Gambas-user mailing list
> Gambas-user@lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/gambas-user
> 
> --
> Check out the vibrant tech community on one of the world's most
> engaging tech sites, Slashdot.org! http://sdm.link/slashdot
> ___
> Gambas-user mailing list
> Gambas-user@lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/gambas-user
>
--
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
___
Gambas-user mailing list
Gambas-user@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/gambas-user

Re: [Gambas-user] Gambas-Documentation

[PICCORO McKAY Lenz]

2017-06-06 12:49 GMT-04:00 Dimitris Anogiatis :
> While Google translate and other online transaction tools are not perfect
> we could try a few of them to see which combination of such tools makes
> more sense for both the English side and the non-English side.

that-s a totally true..


> Keep in mind that the way we put words to our thoughts is also affected by
> different patterns and experiences in all our lives as well as mood and
> stress levels at the time of asking for info or documenting a piece of
> code. Plus not all words have a direct equivalent in every language. So we
> also have to have a balance between specifics and verbosity.

this point its a special problem.. many possible users don't
contribute due the language are its wall.. and take too much time
translate to other language..

>
> That's my 2 cents worth of wisdom anyways :)
>
> On Jun 6, 2017 10:00 AM, "Benoît Minisini via Gambas-user" <
> gambas-user@lists.sourceforge.net> wrote:
>
> Le 06/06/2017 à 17:54, PICCORO McKAY Lenz a écrit :
>
>> hi benoit, there many issues in gb.db specifically in odbc component, i
>> wish to be fixed in the next release please, thanks in advance
>>
>> currently i can to contribute to the documentation how-to's wiki parts but
>> i cannot write on both languajes, its very tedious for me write english..
>> so if any could translate from spanish will be usefully
>>
>>
> I don't speak spanish, and your english is often unreadable, so we need
> some help...
>
> --
> Benoît Minisini
>
>
> 
> --
> Check out the vibrant tech community on one of the world's most
> engaging tech sites, Slashdot.org! http://sdm.link/slashdot
> ___
> Gambas-user mailing list
> Gambas-user@lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/gambas-user
> --
> Check out the vibrant tech community on one of the world's most
> engaging tech sites, Slashdot.org! http://sdm.link/slashdot
> ___
> Gambas-user mailing list
> Gambas-user@lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/gambas-user

--
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
___
Gambas-user mailing list
Gambas-user@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/gambas-user

Re: [Gambas-user] Gambas-Documentation

[Dimitris Anogiatis]

While Google translate and other online transaction tools are not perfect
we could try a few of them to see which combination of such tools makes
more sense for both the English side and the non-English side.

Keep in mind that the way we put words to our thoughts is also affected​ by
different patterns and experiences in all our lives as well as mood and
stress levels at the time of asking for info or documenting a piece of
code. Plus not all words have a direct equivalent in every language. So we
also have to have a balance between specifics and verbosity.

That's my 2 cents worth of wisdom anyways :)

On Jun 6, 2017 10:00 AM, "Benoît Minisini via Gambas-user" <
gambas-user@lists.sourceforge.net> wrote:

Le 06/06/2017 à 17:54, PICCORO McKAY Lenz a écrit :

> hi benoit, there many issues in gb.db specifically in odbc component, i
> wish to be fixed in the next release please, thanks in advance
>
> currently i can to contribute to the documentation how-to's wiki parts but
> i cannot write on both languajes, its very tedious for me write english..
> so if any could translate from spanish will be usefully
>
>
I don't speak spanish, and your english is often unreadable, so we need
some help...

-- 
Benoît Minisini



--
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
___
Gambas-user mailing list
Gambas-user@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/gambas-user
--
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
___
Gambas-user mailing list
Gambas-user@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/gambas-user

Re: [Gambas-user] Gambas-Documentation

[Benoît Minisini via Gambas-user]

Le 06/06/2017 à 17:54, PICCORO McKAY Lenz a écrit :
hi benoit, there many issues in gb.db specifically in odbc component, i 
wish to be fixed in the next release please, thanks in advance


currently i can to contribute to the documentation how-to's wiki parts 
but i cannot write on both languajes, its very tedious for me write 
english.. so if any could translate from spanish will be usefully




I don't speak spanish, and your english is often unreadable, so we need 
some help...


--
Benoît Minisini

--
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
___
Gambas-user mailing list
Gambas-user@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/gambas-user

Re: [Gambas-user] Gambas-Documentation

[PICCORO McKAY Lenz]

hi benoit, there many issues in gb.db specifically in odbc component, i
wish to be fixed in the next release please, thanks in advance

currently i can to contribute to the documentation how-to's wiki parts but
i cannot write on both languajes, its very tedious for me write english..
so if any could translate from spanish will be usefully

2017-06-06 7:23 GMT-04:00 Benoît Minisini via Gambas-user <
gambas-user@lists.sourceforge.net>:

> Le 06/06/2017 à 12:53, Hans Lehmann a écrit :
>
>> A warm Hello to all friends of the Gambas programming language,
>>
>> many years ago users complained in various Gambas forum posts about the
>> lack of books about Gambas in the German language. I liked Gambas from
>> the beginning. Its conception allows people, like myself, switching over
>> from other environments as well as ambitioned programmers to work on a
>> range of different tasks in a single language. This motivated me as early
>> as 2008 to design a concept for a Gambas book. For a few years now this
>> book is made available online at www.gambas-buch.de. Many chapters have
>> already been published. With great effort, the team of authors pursues
>> the goal to produce a good description of the components and classes of
>> Gambas and to demonstrate their use in example projects. Every chapter
>> and its parts are also offered as a PDF file, and archives of the tested
>> demonstration projects are available for download.
>>
>> However, our work on the online book is hampered increasingly because some
>> components and their classes have only fragmentary documentation in the
>> Gambas wiki, or none at all. By tolerating this condition, the Gambas
>> developers throw away opportunities for newcomers to discover and use
>> Gambas. A class or component should, in my opinion, only be released after
>> its documentation is complete and correct and put on the Gambas wiki.
>> Do the developers really believe that a potential Gambas user will read
>> all the source code to understand how the properties, methods and events
>> work? (I, for one, have never learned C.) To me, for example, it is clear
>> after over 44 years as a grammar school teacher -- among others for
>> Computer Science -- that nothing motivates more than success und success
>> has to be prepared.
>>
>> This brings us to the crucial point with Gambas: all efforts should
>> currently
>> be directed towards quickly closing the gaps and flaws in the
>> documentation!
>> One only learns a language well by speaking it -- and this is only
>> possible
>> with a good dictionary! Such an excellent programming language as Gambas
>> should enjoy a thorough documentation of the existing components and
>> classes
>> with small projects or code snippets which show the essential properties
>> and methods in action. If you have a look at the current state of the
>> documentation, you will see that it is exceedingly incomplete. Do the
>> developers seriously think that the Gambas programmers can read in a
>> crystal
>> ball if all that's known about a class is the names of its properties,
>> methods and events?
>>
>> The software farm with its projects does not replace a systematic
>> treatment
>> of the basics of the language. The online book wanted to provide just that
>> for the German-speaking Gambas programmers, and those who want to be! If
>> none or only insufficient information about the properties, methods and
>> events of a Gambas class is available, then a newbie or a Gambas
>> programmer,
>> who wants to use this class, will resign and turn to other languages.
>>
>> My wish is essentially just that the developers do their job until the end
>> and provide the documentation for their classes, because only then can
>> their
>> valuable work be truly useful. Only then can Gambas finally make progress.
>>
>> Honsek
>> www.gambas-buch.de
>>
>>
> You are right, it's just that time is missing on my side, because of many
> other activities.
>
> I plan to release Gambas 3.10 soon, and document the gb.web.form component
> that allows to make web applications a bit like GUI applications.
>
> And of course filling the other missing entries in the documentation on
> the components I made.
>
> Regards,
>
> --
> Benoît Minisini
>
>
> 
> --
> Check out the vibrant tech community on one of the world's most
> engaging tech sites, Slashdot.org! http://sdm.link/slashdot
> ___
> Gambas-user mailing list
> Gambas-user@lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/gambas-user
>
--
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
___
Gambas-user mailing list
Gambas-user@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/gambas-user

Re: [Gambas-user] Gambas-Documentation

[Benoît Minisini via Gambas-user]

Le 06/06/2017 à 12:53, Hans Lehmann a écrit :

A warm Hello to all friends of the Gambas programming language,

many years ago users complained in various Gambas forum posts about the
lack of books about Gambas in the German language. I liked Gambas from
the beginning. Its conception allows people, like myself, switching over
from other environments as well as ambitioned programmers to work on a
range of different tasks in a single language. This motivated me as early
as 2008 to design a concept for a Gambas book. For a few years now this
book is made available online at www.gambas-buch.de. Many chapters have
already been published. With great effort, the team of authors pursues
the goal to produce a good description of the components and classes of
Gambas and to demonstrate their use in example projects. Every chapter
and its parts are also offered as a PDF file, and archives of the tested
demonstration projects are available for download.

However, our work on the online book is hampered increasingly because some
components and their classes have only fragmentary documentation in the
Gambas wiki, or none at all. By tolerating this condition, the Gambas
developers throw away opportunities for newcomers to discover and use
Gambas. A class or component should, in my opinion, only be released after
its documentation is complete and correct and put on the Gambas wiki.
Do the developers really believe that a potential Gambas user will read
all the source code to understand how the properties, methods and events
work? (I, for one, have never learned C.) To me, for example, it is clear
after over 44 years as a grammar school teacher -- among others for
Computer Science -- that nothing motivates more than success und success
has to be prepared.

This brings us to the crucial point with Gambas: all efforts should 
currently
be directed towards quickly closing the gaps and flaws in the 
documentation!

One only learns a language well by speaking it -- and this is only possible
with a good dictionary! Such an excellent programming language as Gambas
should enjoy a thorough documentation of the existing components and 
classes

with small projects or code snippets which show the essential properties
and methods in action. If you have a look at the current state of the
documentation, you will see that it is exceedingly incomplete. Do the
developers seriously think that the Gambas programmers can read in a 
crystal

ball if all that's known about a class is the names of its properties,
methods and events?

The software farm with its projects does not replace a systematic treatment
of the basics of the language. The online book wanted to provide just that
for the German-speaking Gambas programmers, and those who want to be! If
none or only insufficient information about the properties, methods and
events of a Gambas class is available, then a newbie or a Gambas 
programmer,

who wants to use this class, will resign and turn to other languages.

My wish is essentially just that the developers do their job until the end
and provide the documentation for their classes, because only then can 
their

valuable work be truly useful. Only then can Gambas finally make progress.

Honsek
www.gambas-buch.de



You are right, it's just that time is missing on my side, because of 
many other activities.


I plan to release Gambas 3.10 soon, and document the gb.web.form 
component that allows to make web applications a bit like GUI applications.


And of course filling the other missing entries in the documentation on 
the components I made.


Regards,

--
Benoît Minisini

--
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
___
Gambas-user mailing list
Gambas-user@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/gambas-user

Re: [Gambas-user] Gambas-Documentation

[PICCORO McKAY Lenz]

2017-06-06 6:53 GMT-04:00 Hans Lehmann :

> A warm Hello to all friends of the Gambas programming language,
>
> many years ago users complained in various Gambas forum posts about the
> lack of books about Gambas in the German language. I liked Gambas from
> the beginning. Its conception allows people, like myself, switching over
> from other environments as well as ambitioned programmers to work on a
> range of different tasks in a single language. This motivated me as early
> as 2008 to design a concept for a Gambas book. For a few years now this
> book is made available online at www.gambas-buch.de. Many chapters have
> already been published. With great effort, the team of authors pursues
> the goal to produce a good description of the components and classes of
> Gambas and to demonstrate their use in example projects. Every chapter
> and its parts are also offered as a PDF file, and archives of the tested
> demonstration projects are available for download.
>
the gambas buch its a great book, the problem its that its only in German..
many articles/chapers i read in that book, that-s why i made an effor this
weekend
and produce te lasted ODBC documentation examples in gambas wiki

that problem i anunce some oportunities before, but benoit mention that
made this only for hobie
its a great effort the components and languaje made by gambas developers..
for spanish users there's the jsbsan blog .. but hangs my web browser due
many anuncies

As hans mentions, prawns have evolved and is beyond simple pastime, many
projects i had to perform in php or java due to the urgency of having them
"fast", losing the opportunity to develop in this confortable and flexible
programing languaje called gambas ...

We are clear that the learning curve is fast and easy to program, but the
type of responses such as "it is the programmer's job" or assumes that "the
programmer must know how to program" distances the prospects, and does not
allow the development Of a business model Cost-effective based on low
maintenance and fast obtaining of manpowers

Currently taking the ODBC component as example, i note many lack of
documentation.. complete in this lasted days by me, the first ODBC
component documentation was very poor and inconsistent with the component
behaviour.. and as last, the compoent ntil version 3.8.1 was in very bad
state... and all the documentation assumed that all the features of the
mysql db componente are same for the rest.. and that's not true.. this
limit the gambas to a mysql database for novice users... due documentation
does not offer how to solve that situations...


> However, our work on the online book is hampered increasingly because some
> components and their classes have only fragmentary documentation in the
> Gambas wiki, or none at all. By tolerating this condition, the Gambas
> developers throw away opportunities for newcomers to discover and use
> Gambas. A class or component should, in my opinion, only be released after
> its documentation is complete and correct and put on the Gambas wiki.
> Do the developers really believe that a potential Gambas user will read
> all the source code to understand how the properties, methods and events
> work? (I, for one, have never learned C.) To me, for example, it is clear
> after over 44 years as a grammar school teacher -- among others for
> Computer Science -- that nothing motivates more than success und success
> has to be prepared.
>
>
Hi hans, in this way, there's a problem.. many developers need the
component xyz due newer develop needs..

The real solution its that the documentation must be generated from the
component code.. like JAva does..

later then must be complete in the gambas wiki.. WITH EXAMPLES, i mean the
code documentations must not have example, only teoric implementations, and
later any enhanchement must be done in the generated gambas wiki page,
currently this behaviour seems are, but need more improvement...



> This brings us to the crucial point with Gambas: all efforts should
> currently
> be directed towards quickly closing the gaps and flaws in the
> documentation!
> One only learns a language well by speaking it -- and this is only possible
> with a good dictionary! Such an excellent programming language as Gambas
> should enjoy a thorough documentation of the existing components and
> classes
> with small projects or code snippets which show the essential properties
> and methods in action. If you have a look at the current state of the
> documentation, you will see that it is exceedingly incomplete. Do the
> developers seriously think that the Gambas programmers can read in a
> crystal
> ball if all that's known about a class is the names of its properties,
> methods and events?
>
> The software farm with its projects does not replace a systematic treatment
> of the basics of the language. The online book wanted to provide just that
> for the German-speaking Gambas programmers, and those who want to 

Re: [Gambas-user] Gambas-Documentation

[Fernando Cabral]

Agreed, Honsek. I am a newcomer, I liked Gambas at first sight, but I have
had a hard time finding proper documentation and  good examples on how-to.

- fernando



2017-06-06 7:53 GMT-03:00 Hans Lehmann :

> A warm Hello to all friends of the Gambas programming language,
>
> many years ago users complained in various Gambas forum posts about the
> lack of books about Gambas in the German language. I liked Gambas from
> the beginning. Its conception allows people, like myself, switching over
> from other environments as well as ambitioned programmers to work on a
> range of different tasks in a single language. This motivated me as early
> as 2008 to design a concept for a Gambas book. For a few years now this
> book is made available online at www.gambas-buch.de. Many chapters have
> already been published. With great effort, the team of authors pursues
> the goal to produce a good description of the components and classes of
> Gambas and to demonstrate their use in example projects. Every chapter
> and its parts are also offered as a PDF file, and archives of the tested
> demonstration projects are available for download.
>
> However, our work on the online book is hampered increasingly because some
> components and their classes have only fragmentary documentation in the
> Gambas wiki, or none at all. By tolerating this condition, the Gambas
> developers throw away opportunities for newcomers to discover and use
> Gambas. A class or component should, in my opinion, only be released after
> its documentation is complete and correct and put on the Gambas wiki.
> Do the developers really believe that a potential Gambas user will read
> all the source code to understand how the properties, methods and events
> work? (I, for one, have never learned C.) To me, for example, it is clear
> after over 44 years as a grammar school teacher -- among others for
> Computer Science -- that nothing motivates more than success und success
> has to be prepared.
>
> This brings us to the crucial point with Gambas: all efforts should
> currently
> be directed towards quickly closing the gaps and flaws in the
> documentation!
> One only learns a language well by speaking it -- and this is only possible
> with a good dictionary! Such an excellent programming language as Gambas
> should enjoy a thorough documentation of the existing components and
> classes
> with small projects or code snippets which show the essential properties
> and methods in action. If you have a look at the current state of the
> documentation, you will see that it is exceedingly incomplete. Do the
> developers seriously think that the Gambas programmers can read in a
> crystal
> ball if all that's known about a class is the names of its properties,
> methods and events?
>
> The software farm with its projects does not replace a systematic treatment
> of the basics of the language. The online book wanted to provide just that
> for the German-speaking Gambas programmers, and those who want to be! If
> none or only insufficient information about the properties, methods and
> events of a Gambas class is available, then a newbie or a Gambas
> programmer,
> who wants to use this class, will resign and turn to other languages.
>
> My wish is essentially just that the developers do their job until the end
> and provide the documentation for their classes, because only then can
> their
> valuable work be truly useful. Only then can Gambas finally make progress.
>
> Honsek
> www.gambas-buch.de
>
> 
> --
> Check out the vibrant tech community on one of the world's most
> engaging tech sites, Slashdot.org! http://sdm.link/slashdot
> ___
> Gambas-user mailing list
> Gambas-user@lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/gambas-user
>



-- 
Fernando Cabral
Blogue: http://fernandocabral.org
Twitter: http://twitter.com/fjcabral
e-mail: fernandojosecab...@gmail.com
Facebook: f...@fcabral.com.br
Telegram: +55 (37) 99988-8868
Wickr ID: fernandocabral
WhatsApp: +55 (37) 99988-8868
Skype:  fernandojosecabral
Telefone fixo: +55 (37) 3521-2183
Telefone celular: +55 (37) 99988-8868

Enquanto houver no mundo uma só pessoa sem casa ou sem alimentos,
nenhum político ou cientista poderá se gabar de nada.
--
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
___
Gambas-user mailing list
Gambas-user@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/gambas-user

Re: [Gambas-user] gambas documentation offline include in source (gb.web)

[PICCORO McKAY Lenz]

From: Rob Kudla sourceforge-raind...@kudla.org

 Should be... I did apt-get source gambas3 and the source for the program is
 here inside the tarball:

 gambas3-3.1.1/app/src/doc.cgi/

yes, but the idea its to generate when user/admin goes to install, and the
ide use it that in preference to online



  this could solve the problem of online documentation ... for me will be
  very usefully when i go in a journey to Tepuys, where no are a interenet
  connection.

 This might help. It seems to be only English (I didn't realize when I
 started that it doesn't give you the language links if you're using a
 crawler, and the English version alone took half an hour to crawl from a
 host on the same subnet as the server) but I hope it'll get you started.
 Works well on my own laptop. It's 23.1 MB, expands to 83.

 http://www.gambasdoc.org/gambasdoc-static-20131130.tar.gz

thanks for the file Rob, but the wiki of gambas like to be reproducible
locally too

at least, how could users or admins/packages can generate the documentation
locally and use it prefered to online?

i see some lines of code prepared for that inside ide source, also i see
configure do not touch or generate any doc..

benoit what do u think about it?



 Rob




 From: John Rose john.aaron.r...@gmail.com

 Subject: Re: [Gambas-user] Web apps




 I don't see the Gambas Documentation Wiki app in the examples for Gambas
 3.5.1: where can it be obtained? Can the Gambas project for

search the sources men

 http://www.gambasforge.org/index.html be downloaded? Please direct me to
 an example of (ideally) a Gambas app (running in, say, Firefox) that
 displays  updates data (from a database).

read the web, seem do u use too many windo...
--
Rapidly troubleshoot problems before they affect your business. Most IT 
organizations don't have a clear picture of how application performance 
affects their revenue. With AppDynamics, you get 100% visibility into your 
Java,.NET,  PHP application. Start your 15-day FREE TRIAL of AppDynamics Pro!
http://pubads.g.doubleclick.net/gampad/clk?id=84349351iu=/4140/ostg.clktrk
___
Gambas-user mailing list
Gambas-user@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/gambas-user

Re: [Gambas-user] gambas documentation offline include in source (gb.web)

[Tobias Boege]

On Mon, 02 Dec 2013, PICCORO McKAY Lenz wrote:
 From: Rob Kudla sourceforge-raind...@kudla.org
 
  Should be... I did apt-get source gambas3 and the source for the program is
  here inside the tarball:
 
  gambas3-3.1.1/app/src/doc.cgi/
 
 yes, but the idea its to generate when user/admin goes to install, and the
 ide use it that in preference to online
 
 
 
   this could solve the problem of online documentation ... for me will be
   very usefully when i go in a journey to Tepuys, where no are a interenet
   connection.
 
  This might help. It seems to be only English (I didn't realize when I
  started that it doesn't give you the language links if you're using a
  crawler, and the English version alone took half an hour to crawl from a
  host on the same subnet as the server) but I hope it'll get you started.
  Works well on my own laptop. It's 23.1 MB, expands to 83.
 
  http://www.gambasdoc.org/gambasdoc-static-20131130.tar.gz
 
 thanks for the file Rob, but the wiki of gambas like to be reproducible
 locally too
 
 at least, how could users or admins/packages can generate the documentation
 locally and use it prefered to online?
 
 i see some lines of code prepared for that inside ide source, also i see
 configure do not touch or generate any doc..
 

Here we are again on my favourite topic! :-) IIRC, the situation was like
this to *me* when we talked about this the last time:

Gambas components have .info files which contain information about virtually
every class, method, property, event (did I miss something?) defined in a
component. Look, e.g., at /usr/share/gambas3/info/gb.map.info. You will see
that also documentation from Gambas components is included by the compiler.

I have written a bunch of scripts and a program to also extract in-source
documentation from C/C++ components and merge them into the component's
.info file so that we _can_ have all the documentation of all components in
their .info files - potentially. The only drawback currently is that gbi3
generates the .info files for all components first and my scripts would have
to be run in a 2nd phase over all the C/C++ components to patch the .info's.
(Let's keep aside that my program is not _that_ flexible at the moment
because I only needed it to document my gb.data and gb.openssl components.)

But let's suppose, we have all the documentation in the .info files ready.
(To be clear, you can document any item there: classes, constants, methods,
properties, events - everything.) Then it would be easy (in fact, I think it
is already partially (?) implemented) to let the IDE read these .info files
and display the help (if you are offline).

Even better, we could write a module to regenerate the gambasdoc.org pages
from these .info files because they are structured similarly (one page per
class/method/property/event/...) - which would make a dream of mine come
true: not having to click around anymore in the web interface. (Not that it
is _that_ horrible (by far not!) but writing documentation in-source is more
comfortable (also by far!) and seems less prone to the not-consistent-with-
the-implementation kind of flaws.)

Alas, Sebastian Kulesz who aimed at redesigning the gambasdoc.org engine,
doc.cgi, (his project was then called gb.wiki, IIRC), doesn't have time to
continue at the moment.

To sum up: if we do want to write documentation in-source (which I would
prefer, but that's really MHO), then we can already have all documentation
in the components' .info files.

In a next step, we would write a parser to let the IDE display this help and
then a module (or a standalone program) for gb.wiki to regenerate the
documentation database from .info files and in effect, everyone can have his
own local copy of the help - of any version he wants (because then
documentation is completely revision-bound) - and gambasdoc.org just happens
to provide a reasonably recent version of the docs online.

Regards,
Tobi

--
Rapidly troubleshoot problems before they affect your business. Most IT 
organizations don't have a clear picture of how application performance 
affects their revenue. With AppDynamics, you get 100% visibility into your 
Java,.NET,  PHP application. Start your 15-day FREE TRIAL of AppDynamics Pro!
http://pubads.g.doubleclick.net/gampad/clk?id=84349351iu=/4140/ostg.clktrk
___
Gambas-user mailing list
Gambas-user@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/gambas-user

Re: [Gambas-user] gambas documentation offline include in source (gb.web)

[Bruce]

On Mon, 2013-12-02 at 18:16 +0100, Tobias Boege wrote:
 In a next step, we would write a parser to let the IDE display this
 help and
Its already there. Local modules inline help is shown even if there is
no internet connection. Another idea would be to somehow generate all
the structural help from gambasdoc back into the .info files.
 then a module (or a standalone program) for gb.wiki to regenerate the
 documentation database from .info files and in effect, everyone can
 have his
 own local copy of the help - of any version he wants (because then
 documentation is completely revision-bound) - and gambasdoc.org just
 happens
 to provide a reasonably recent version of the docs online. 
However, there is all the other non-module information that is in
gambasdoc.org - it would not be available.

B


--
Rapidly troubleshoot problems before they affect your business. Most IT 
organizations don't have a clear picture of how application performance 
affects their revenue. With AppDynamics, you get 100% visibility into your 
Java,.NET,  PHP application. Start your 15-day FREE TRIAL of AppDynamics Pro!
http://pubads.g.doubleclick.net/gampad/clk?id=84349351iu=/4140/ostg.clktrk
___
Gambas-user mailing list
Gambas-user@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/gambas-user

[Gambas-user] gambas documentation offline include in source (gb.web)

[PICCORO McKAY Lenz]

In a mail response from Rob Kudla sourceforge-raind...@kudla.org
 Subject: Re: [Gambas-user] Web apps
write that:

 Yes, the Gambas documentation wiki is a CGI program written in Gambas. I
 think the source is included in the Gambas tarball as an example, or used
 to be.
Could be possible to buld the documentation locally? if are atached to
the sources?
this could solve the problem of online documentation ...
for me will be very usefully when i go in a journey to Tepuys, where
no are a interenet connection.


of course, maibe and idea will be a compiled documentation into html
pages from sources...
event have the .webpages files and use webserver to interperted!

--
Rapidly troubleshoot problems before they affect your business. Most IT 
organizations don't have a clear picture of how application performance 
affects their revenue. With AppDynamics, you get 100% visibility into your 
Java,.NET,  PHP application. Start your 15-day FREE TRIAL of AppDynamics Pro!
http://pubads.g.doubleclick.net/gampad/clk?id=84349351iu=/4140/ostg.clktrk
___
Gambas-user mailing list
Gambas-user@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/gambas-user

Re: [Gambas-user] gambas documentation offline include in source (gb.web)

[Rob Kudla]

On 11/30/2013 11:59 AM, PICCORO McKAY Lenz wrote:
 Yes, the Gambas documentation wiki is a CGI program written in
 Gambas. I think the source is included in the Gambas tarball as an
 example, or used to be.
 Could be possible to buld the documentation locally? if are atached to 
 the sources?

Should be... I did apt-get source gambas3 and the source for the program is
here inside the tarball:

gambas3-3.1.1/app/src/doc.cgi/

 this could solve the problem of online documentation ... for me will be 
 very usefully when i go in a journey to Tepuys, where no are a interenet
 connection.

This might help. It seems to be only English (I didn't realize when I
started that it doesn't give you the language links if you're using a
crawler, and the English version alone took half an hour to crawl from a
host on the same subnet as the server) but I hope it'll get you started.
Works well on my own laptop. It's 23.1 MB, expands to 83.

http://www.gambasdoc.org/gambasdoc-static-20131130.tar.gz

Rob

--
Rapidly troubleshoot problems before they affect your business. Most IT 
organizations don't have a clear picture of how application performance 
affects their revenue. With AppDynamics, you get 100% visibility into your 
Java,.NET,  PHP application. Start your 15-day FREE TRIAL of AppDynamics Pro!
http://pubads.g.doubleclick.net/gampad/clk?id=84349351iu=/4140/ostg.clktrk
___
Gambas-user mailing list
Gambas-user@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/gambas-user

[Gambas-user] Gambas documentation

[Keith Clark]

I'm using Gambas on Ubuntu 9.04 and when I try to view the documentation
by pressing F1, noting comes up in the called upon browser.  It states
there is no documentation, check your path.

For example, when looking for documentation on Chart:

File “/usr/share/gambas2/help/help/comp/gb+chart/chart.html” not found.

Check the location of the file and try again.

Thanks.

Keith



--
OpenSolaris 2009.06 is a cutting edge operating system for enterprises 
looking to deploy the next generation of Solaris that includes the latest 
innovations from Sun and the OpenSource community. Download a copy and 
enjoy capabilities such as Networking, Storage and Virtualization. 
Go to: http://p.sf.net/sfu/opensolaris-get
___
Gambas-user mailing list
Gambas-user@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/gambas-user