issue-#100 Review all the existing documentation

User avatar
Josef Templ
Posts: 2047
Joined: Tue Sep 17, 2013 6:50 am

Re: issue-#100 Review all the existing documentation

Post by Josef Templ »

Zinn wrote:I miss in "Help" -> "Contents" list the link to the Map of the Ctl subsystem
and the link to document of the Direct-To-COM Compiler (Docu/DTC-Env.odc).
Map to the Std subsystem is also missing.
- Helmut
The map to the Std subsystem is available under the link named "Custom Commands".
This is confusing indeed because (1) it should be under "Developer Manuals" and (2) it should be named "Std Subsystem".

The DTC docu, I guess, is omitted from the Help Contents page because it used to be a separate product and
it is Windows specific. It has separate Help menu items in its menu, though.

- Josef
Ivan Denisov
Posts: 1700
Joined: Tue Sep 17, 2013 12:21 am
Location: Russia

Re: issue-#100 Review all the existing documentation

Post by Ivan Denisov »

Josef Templ wrote:@Ivan: the grammar in the docu needs to be fixed. It is simply wrong.
Done.
http://blackboxframework.org/unstable/i ... a1.424.zip
User avatar
Josef Templ
Posts: 2047
Joined: Tue Sep 17, 2013 6:50 am

Re: issue-#100 Review all the existing documentation

Post by Josef Templ »

I am sorry but I have overlooked another error in the SET syntax:
The closing brace for the iteration is missing.
"{" [integer [".." integer] { "," integer [".." integer]] "}"

change to:

"{" [integer [".." integer] {"," integer [".." integer] } ] "}"

- Josef
Zinn
Posts: 476
Joined: Tue Mar 25, 2014 5:56 pm
Location: Frankfurt am Main
Contact:

Re: issue-#100 Review all the existing documentation

Post by Zinn »

I porpose to change the help page see StdCoder.Decode below.
1. Rename "Custom Commands" to "Std Subsystem".
2. Add Map to Ctl Subsystem under the Platform-Specific Issues
3. Add Direct-To-Com Compiler under the Ctl Subsystem
- Helmut

Code: Select all

StdCoder.Decode ..,, ..L00...3Qw7uP5PRPPNR9Rbf9b8R79FTvMf1GomCrlAy2xhX,Cb2x
 hXhC6FU1xhiZiVBhihgmRiioedhgrZcZRiXFfaqmSrtuGfa4700zdGrr8rmCLLCJuyKtYcZRiX
 7.2.s,65,,,k,5TWyql.bnayKmKKqGomC5XzET1.PuP.MHT9N9ntumaU2,CJuyKtQC98P9PP7O
 NbXmb.2.IhTk2Ely,,6.,U08J99SdfJHPNjvQCJuGKfaqmY6MwdONl1QCh0708T,U..w.YVTU.
 2U18J99SqorGqmQCbWBxhYFWUl1UnNHEWUmr.6.wkRk5kzq,,6.,.3d4cU.ktAcoZimBhWhioh
 gnZcZRCY.2.I42U.EDU.U,.1eQHPMNHA0z.U.Yr0.,.emuKFeWQ1Iklb8IepZhZJinpZHZCZOR
 NX2hgnRg.AS.QiiIepZhZ7F6.Zz.6.,UgW5UXW.2.52.CLLC3b8Rn9P99F9vQ0ks,Uikwm46.Z
 z,E..W.e32.86.c918R..,E0E...7,,M.E...VuI3EQC4Fgh3.0.AU0KyB.,Uf.,US.,.16.ME
 UER80.,6jUnU0Ikmj,6.w42U.EDU.U,.1021U.2m,.1.36.6.J,Etv.2.46S.a40E.Qkm50,6.
 ,.E2kbU.E,9T7U...d,,M.E...V0l,F21.7EUWI5685VVA5,gUF03M.6.L.3.CE,9z4E.0.Z,0
 .x.0.4.A6Eyuv.U.2GE.EN1E,QXiI.3Qwb8R79HHfPLvQR7HHfPL9F9vQs.2U.2.4I.E.6C6.A
 Uk2.,sId9N5OP7vQRtHVPNRfEZvPjvQ9fQFt77uP5PRT7JTPRZv7N76DtFfPO7PN796duPffQa
 W2Ikmj,6.w46.o16.wT6.1eQ.U.2Gk3k,0.,cg.IyH.,UW2.2.W.0.U1A.QU.Um0.E.MI6.,Ur
 .,k.y0C3...U0JchIejBgYxYg2YbIejBgYhhV3ibA37s,s.6.Z3.U.EFU.E2E..QU,U12.IK..
 0.B10.N0,U,g6Q8...yIlWrLGorC4bOSbP9POMVv7N76qok0LEGrr0GuWqm0mb8Kw0mdKLlCrw
 CLuKqqSmIYUHU1U.IK..0.N,,.F.,.k,4.8.2U.F.CE.EN,.6.2M0.oI6.3kakd0EuYA5mqYAb
 HLw7VnmoB3GtwBjntgAZHIw27mrQAfnLY8fHug3dmbQ6DFK22DFVYB1nlQB3mr2D,7.dmukrIC
 HnkYB,l70GEY81HlYB9HEwBBHEQ6THrYC9HrYCbnHA3AU.E04,C.IK..0.N,,.F.,.E,2.0E1k
 ,4.CE.EN,.6.292.o52U.M.h,b8R...G2YepZihAabYZUwYJRiZJiUAdiZiZJiVRgoBhjphbA3
 8,,s.EN,.6.I20E.0.F.,.k,4.2.IK..0.p00.,W.U,25Q8....ENSGKsETPPVvPffP7967uP5
 nqUbA3763,6.C.IK..0.3,0.F.,.k,4.2.IK..0.1H.2U.kXU.M.zF.Q8...Uj.bt7N76DdENP
 M5vO3uPl967ONbPODfP,7IZPM59RCqmCrHa0Z.5.,cg..2.SW.E.606..Ck.U6U12.IK..0.P0
 0.b,0U,Q3Q8....EOSGK0W4xhmhhnxYdk1k,E.89..,UWU.2.W.0.U1A.QU.Um0.E.MH6.,Un.
 ,k.UH,....KnHmGEYeZ3joRibA3U1U.IK..0.D,0.F.,.k,4.A,,k,0.89..,UNV.2.y12.1sB
 sI....UqwYg22hOO9vR,tETfPb9RZPR59RHvPUH6.C.0EN,.6.Y32.2,2..5M.E3k,U12.IK..
 0.11,6.w66.4EU0.b0....AcbYZUME,dEZPO9fN,7GHvQdvPZPS,tPB96VOMbvM19PDN8I1.89
 ..,UWU.2.W.0.U1A.QU.Um0.E.sNE.MH6.,k.O2C3....cED79,FX8rrqKE0pkC50Guya1xhh3
 CRPNR9R,7I1vQs7cAs.EN,.6.w26.2,2..5M.k.0.0.I32Nc16.,UW4.S.Ka.E.QE6.,.E2kZU
 .E,F.2U...V,,M.E...VuI252F.56.,glbEUXRJ2kRY62UA2.8.2UFU0.,62c.UBU0.5E.cg.s
 2E.6N0U.U8,,k.CI.sId1..kdartGrmwZ2xhXleCrmgZBBgixYg22bOSEEKptKKt0ma4KrKrkm
 qHa0H.E.89..,UW.,U6U..s.1.0.89..,UP,,U,3.0E.AUuUH,...kL.bWh..dXUgdV3ibA3U1
 .Z3.U.EFE.0.F.,.k,4.2.IK..0.t0,.3W.6.4.Q8...G2QcEhZABgixgbYZU6H1fPDPR1vN99
 6ZONBPNZPNRvM9v7HVDU1U.IK..0.3,,6.2,2..5M.E.EN,.6.g92U.kV2.0U,Q5Q8....3WAB
 hXhgiRiZxYg2230UABhXhAM8w.Q.2Um0.E.c6E.606..Ck.k,0.89..,UUV.U47.2.1sDsI...
 YeZlLGorkekK.Y82YJRiZ76.E56.5.,cg..2.800E.606..Ck.U.Um0.E.sJE.MD6.,k.O1C3.
 ..kL.bWh.N,66POMVnI.C.IK..0.3,,6.2,2..5M.s.,.Z3.U.EoE.EbU.M.D0b0..U2,5WChg
 rxYgkfWqkGLEaqt0GbKqv0mouKECorq4..s0s.6.Z3.U.EFU.E2E..QU,.,.Z3.U.EmE.EZU.M
 .30b0...UjphoJidJAyKtCrHmGEI6.CoruKu.kI61s.EN,.6.I22U.E2E..QU,.,.Z3.U.EkE.
 EXU.M.z,b0..U4xByGWy4K3q0U4xB0meC5,,.u.C.0EN,.6.I22U.E2E..QU,.,.Z3.U.kfU.k
 SE.0U,o4Q8...Uj.C3Ug.2YBBAa0k,Um0.E.c66.,U6U..s.1.56.cg..2.W30.u1,E.AUrUH,
 ..EWU0lVWqk8rtSGKsEFPMZPM5nm8LECpmGrHa0P.E.89..,UW.,U6U..s.1.0.89..,UYV.U8
 ,,k.CI.sId1..UZpijYcjRA0pKCpKaoHmGE2egBgopgjJihhZH3iZRgdpgdRgUAdnRiphgnxYd
 EAk,E.89..,UW.,U6U..s.1.0.89..,US,,U27.0.1MDsI....UJVh.6F9HEKptKaU..P.5.89
 ..,UW.,U6U..s.1.0.89..,UJV.2.i12.16BsI...Uj.C3Ug.0ma4KsA3U1.Z3.U.EFU.E2E..
 QU,.,.Z3.U.kl6.0.H0,6.4EVkd...krEV6FTvMSGK00TXhVVZidxhi3Y1xhipiZphoBhjphnx
 YdkAk,Um0.E.c66.,U6U..c.E,0.SyG8U34j0cUZ52.G20.i12.1sA,UH,..kVGLqyGWy4TtI.
 m058R0ma44Hl08Mtr.0E.sB2U.2.u,2.yD2U,JC644.2UEC.M1c.kn,.6.I26.2,2..5M.s.,.
 Z3.U.Ep0.0.V8.0E.M.H0b0..UHZiYxZ2xB.EKMH2YoFukdGrkuKm4KtGKECorqqq4KrGqtSmI
 M1s.EN,.6.I26.2,2..5M.E.EN,.6.g82U.kRU.M.d,b0...X9PT7FT1.UHBC,NH1Xd6,k,Um0
 .E.c6E.606..Ck.U.Um0.E.cM,.,U6V.k.42C3...7082ZORNPNbv7NVEJijxgmBghhhdphb3Y
 1dP..j.5.,cg..2.802.W.0.U0A.IU.Ub1.E.ML6.,U1,,k.i1C3...U2Ze1hZ6hgg3ibYZU6G
 99PV967OOZPN59RP7JTP95uHPu7Hl0O,8.0kn,.2U.E9U.E2E..QU8U4Ikmj,6.I4,E.0.x.0.
 4E.kU.t16.VImuwzzD2qjS5tuG5E,5zVyKrsPNvQRdFHPNN9N7ONbvM4zV.sETfPd17ONbXm10
 .v00.T00E0GZZ7SGb1NPUicNaai7NuWa,6.0..4k.U..102wAC.6.VI.Ok.k18Mtr.0E.cAE.c
 5E.k.0.42.E.0d6bnzzTsxNx0ap4CU0CS.bXchgXRh0FWKqtk8U.k.V.kt2.0E0..Ui.UiMOSa
 itP8bZtE4anNN0U7tN.66OW1NM.0E..4.2.kU..0E63U1A.2V0KyBU.2.812.u,2.A.MEUw,2U
 E8m.0GhfUsbj1cUX5.VmtWKVKLuGrruKWKqt.6..kpU.YU2NNObHNN4K.8bX7OuWH,.aYi7Fya
 XF.WWbs7UH3UZ,U.6..4k.E.0.A6Ek,0E63UzLUBBgk32.38P1vMEEEsy42Y0hidZhYhgm7FTv
 Mq4.Pc.PMIfPO5vO,tIdPMZ9RHc.DORH9N2oIxB8k28EdyqkG48k28kbOrm8Lvaqm2oWBjUics
 Bgh3ighg0gVBYepZijJidBggJbUQcjhBUhIgVRiZZgUQejpgoxiVJiZ3Y2hgqhggxhkhhZpho3
 YrBho3hUIcgBAk2ak2aE,Gpk8KqKKEyKnQcjphohgiZinJUB2eVJio3Y7BV0AaUiendQ,RGRnm
 UdF,aE,8HEDorq4fXUacj,QCHc.b7c7ONbPO2oEJCsMCL,qEc.HO036B,hFTfQPvQ3M03MB,BJ
 99SdvQ3M1.ao28EP0OfaqmsETnt.y4PMEV9Q9XdRgZN03MEp7c3eQHXU4ddlr6cTfN,BI1XVd.
 Hc.3eC,BFHfNBPNZPNsQ,dM99RjPN9fP,7I110mkuKm0mVkru40GcQCIUBgV0genhgm32u4Cr2
 GomOrmkm8LEq2U1xhh3C.U7gddRiXhggZhVphZxhpRiBIU4JiVhhZxijJifJU7IU4JC.6H1fPD
 10OdKKsyKtGL,aE,mooCqmu43M136J99Sd9cbOR3vQMNPf.Hc.dON..sJFPMdv7b9cRONyH,aE
 ,CoruamBBkt8k48EXyKt2oHhiW,U4xB..QccBgmVZ7cbONdf.Hc.V8P19RkK.6cHuQgA3M136F
 9fR,xIffMUhV2hA..whXNPMMEEDoruKvkosQ3M03EumKECpu.M13sId9N,tIf1U7sIX9P,xIf1
 .0Jtyqn.2o1,.3U2BhmhA.2Y1xhhNONPNZf.P66,76,76E,0G,aU0CyIhgstETfPdnrYhZJinp
 ZHZiYRcoJigZcZRiX3Ulb8..umVy4.70,kVkk.Um,..Unp3.6F6.ZD,6.636.M00.,E00.,.1c
 Uu.2.44SE.MK6.,k,V.2..F6.w5,U.E,F.6..EG0.,M.,.,.,tcp00EA0z.2bXl.k.E.0.3o46
 .0..I26.M.EYKKqOrmGroCqkYjyC.6.VQ.0.,.E4WDN.RzipGgmuPIklb6.bf95uP..I16..E2
 E.M.E.YiRRC,t75J.nT32kwL,dDMFnMXHA,SN1...
 --- end of encoding ---
Ivan Denisov
Posts: 1700
Joined: Tue Sep 17, 2013 12:21 am
Location: Russia

Re: issue-#100 Review all the existing documentation

Post by Ivan Denisov »

I like Helmut version. However I am not sure about removing underline style of links.

Dear Center members, what do you think about underlining of help file?
Attachments
help.png
(58.88 KiB) Downloaded 5 times
User avatar
Robert
Posts: 1024
Joined: Sat Sep 28, 2013 11:04 am
Location: Edinburgh, Scotland

Re: issue-#100 Review all the existing documentation

Post by Robert »

Ivan Denisov wrote:I like Helmut version. However I am not sure about removing underline style of links.
I agree with both comments.

Removing the underlining does look better, BUT everyone uses underlines for active links, so keep them.

Robert
Zinn
Posts: 476
Joined: Tue Mar 25, 2014 5:56 pm
Location: Frankfurt am Main
Contact:

Re: issue-#100 Review all the existing documentation

Post by Zinn »

In Wikipedia hyperlinks are not underlined. It is better to read and it looks much prettier.
Only when the cursor points on it then it is underlined and the status line shows the link.
Can someone implement it in BlackBox that pointing on a hyperlink shows the link in the status line like Wikipedia?
- Helmut
Ivan Denisov
Posts: 1700
Joined: Tue Sep 17, 2013 12:21 am
Location: Russia

Re: issue-#100 Review all the existing documentation

Post by Ivan Denisov »

Zinn wrote:In Wikipedia hyperlinks are not underlined. It is better to read and it looks much prettier.
Only when the cursor points on it then it is underlined and the status line shows the link.
Can someone implement it in BlackBox that pointing on a hyperlink shows the link in the status line like Wikipedia?
I like the idea of changing all the links to modern style. Lets look what other members think.
http://forum.blackboxframework.org/view ... 3184#p3184
User avatar
Josef Templ
Posts: 2047
Joined: Tue Sep 17, 2013 6:50 am

Re: issue-#100 Review all the existing documentation

Post by Josef Templ »

I would not go as far as removing all underlined links.
This is a lot of work for nothing.

When you look at more modern link styles you will find additional differences.
For example, links are underlined when you move the mouse over it.
Do we have this feature? No, we don't have it. Therefore it is better to keep
the underlines and it saves so much work.

- Josef
User avatar
Robert
Posts: 1024
Joined: Sat Sep 28, 2013 11:04 am
Location: Edinburgh, Scotland

Re: issue-#100 Review all the existing documentation

Post by Robert »

The License in BlackBox version 434 says "Copyright (c) 2013 - 2015 BlackBox Framework Center".
Should this be 2013-2016?


When I run this version I get a nuisance pop-up box:

"Open File - Security Warning
The publisher could not be verified. Are you sure you want to run this software ?
Unknown Publisher
... no valid digital signature ..."

Does anyone know what is going on? Can / should we avoid this?
Post Reply