This voting is about including the changes to the documentation for Controls with the current unstable release.
Here is the discussion on the topic
http://forum.blackboxframework.org/view ... f=48&t=468
and here is the Diff file
http://redmine.blackboxframework.org/pr ... 456e/diff/
issue-#100 Controls documentation
- DGDanforth
- Posts: 1061
- Joined: Tue Sep 17, 2013 1:16 am
- Location: Palo Alto, California, USA
- Contact:
Re: issue-#100 Controls documentation
1 - This is not English, or rather it is poor English.A push button is either linked to a parameterless exported procedure.
2 - It is wrong. Command Buttons, as they were called, can be linked to other procedures than just parameterless Commands. For clarity some rewording in necessary. (And is parameterless a word?)
I don't have time myself to look at this this week. (I suddenly find I am more busy than planned as I have just realised that I only have until Friday to upgrade my PC from XP to Windows 10. Another job that is bound to take longer than one thinks it will.)
- Josef Templ
- Posts: 2047
- Joined: Tue Sep 17, 2013 6:50 am
Re: issue-#100 Controls documentation
In addition to Robert's concerns, which I share, I would like to point out that
there are numerous places in BlackBox where the term 'command button' is used
for a push button. The Controls docu should document this alias name in some way.
This was so in the previous version and is important information that must not be removed.
In its current form I vote NO.
If the bugs are fixed I will of course change my vote.
- Josef
there are numerous places in BlackBox where the term 'command button' is used
for a push button. The Controls docu should document this alias name in some way.
This was so in the previous version and is important information that must not be removed.
In its current form I vote NO.
If the bugs are fixed I will of course change my vote.
- Josef
- DGDanforth
- Posts: 1061
- Joined: Tue Sep 17, 2013 1:16 am
- Location: Palo Alto, California, USA
- Contact:
Re: issue-#100 Controls documentation
Thank you both.
Here is a list of "command button" usage
Location
Dev/Docu/Inspector.odc
command button [2]
Docu/BB-Road.odc
command button [1]
Docu/Tour.odc
command button [2]
Docu/Tut-2.odc
command button [1]
Docu/Tut-4.odc
command button [26]
Docu/Tut-5.odc
command button [1]
Docu/Tut-6.odc
command button [1]
Form/Docu/Gen.odc
command button [1]
Form/Docu/User-Man.odc
command button [2]
Obx/Docu/Address0.odc
command button [1]
Obx/Docu/Controls.odc
command button [5]
Obx/Docu/FileTree.odc
command button [1]
Obx/Docu/Graphs.odc
command button [1]
Obx/Docu/ParCmd.odc
command button [3]
Obx/Docu/Sys-Map.odc
command button [1]
Sql/Docu/Dev-Man.odc
command button [1]
Std/Docu/Coder.odc
command button [2]
System/Docu/Properties.odc
command button [1]
18 Files found
15 Dirs searched
313 Files searched
0.281 Search time (seconds)
So I agree that reference to command button must be restored in Controls.
I'll take a look at it.
-Doug
Here is a list of "command button" usage
Location
Dev/Docu/Inspector.odc
command button [2]
Docu/BB-Road.odc
command button [1]
Docu/Tour.odc
command button [2]
Docu/Tut-2.odc
command button [1]
Docu/Tut-4.odc
command button [26]
Docu/Tut-5.odc
command button [1]
Docu/Tut-6.odc
command button [1]
Form/Docu/Gen.odc
command button [1]
Form/Docu/User-Man.odc
command button [2]
Obx/Docu/Address0.odc
command button [1]
Obx/Docu/Controls.odc
command button [5]
Obx/Docu/FileTree.odc
command button [1]
Obx/Docu/Graphs.odc
command button [1]
Obx/Docu/ParCmd.odc
command button [3]
Obx/Docu/Sys-Map.odc
command button [1]
Sql/Docu/Dev-Man.odc
command button [1]
Std/Docu/Coder.odc
command button [2]
System/Docu/Properties.odc
command button [1]
18 Files found
15 Dirs searched
313 Files searched
0.281 Search time (seconds)
So I agree that reference to command button must be restored in Controls.
I'll take a look at it.
-Doug
- DGDanforth
- Posts: 1061
- Joined: Tue Sep 17, 2013 1:16 am
- Location: Palo Alto, California, USA
- Contact:
Re: issue-#100 Controls documentation
Modifications made.
Here are the Diffs from the last push.
http://redmine.blackboxframework.org/pr ... 4b36/diff/
-Doug
Here are the Diffs from the last push.
http://redmine.blackboxframework.org/pr ... 4b36/diff/
-Doug
Re: issue-#100 Controls documentation
Still misleading. Command Buttons can be linked to many PROCEDURE signatures, not just parameterless ones.DGDanforth wrote:Modifications made.
- DGDanforth
- Posts: 1061
- Joined: Tue Sep 17, 2013 1:16 am
- Location: Palo Alto, California, USA
- Contact:
Re: issue-#100 Controls documentation
Got ya (I didn't actually know that). Josef has pointed me to StdInterpreter which explains those procedures. I haveRobert wrote:Still misleading. Command Buttons can be linked to many PROCEDURE signatures, not just parameterless ones.DGDanforth wrote:Modifications made.
modified the Controls text to mention that. Take a look at what I wrote at http://forum.blackboxframework.org/view ... f=48&t=468
and tell me if that is better.
-Doug
Re: issue-#100 Controls documentation
About which version do we vote here?
Doug's text or Robert's text?
To the latest link 593 I have to say no. I prefer Robert's version of change.
- Helmut
Doug's text or Robert's text?
To the latest link 593 I have to say no. I prefer Robert's version of change.
- Helmut
-
- Posts: 1700
- Joined: Tue Sep 17, 2013 12:21 am
- Location: Russia
- DGDanforth
- Posts: 1061
- Joined: Tue Sep 17, 2013 1:16 am
- Location: Palo Alto, California, USA
- Contact:
Re: issue-#100 Controls documentation
Here is the Diff file for the changes were are now voting on.
http://redmine.blackboxframework.org/pr ... d114f33298
Change your vote if appropriate.
-Doug
http://redmine.blackboxframework.org/pr ... d114f33298
Change your vote if appropriate.
-Doug