issue-#97, Create Docu for (System)Kernel

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

issue-#97, Create Docu for (System)Kernel

Post by Robert »

http://redmine.blackboxframework.org/issues/97

I have begun to draft a Docu for Kernel.

To clarify the function of Kernel.MakeFileName I ran some tests.

The Test procedure simply lists the input name & type, and the output name (hopefully the intent of my "Formatter" object f is reasonably clear).

Code: Select all

PROCEDURE  Test (VAR k : INTEGER; name : ARRAY 10 OF CHAR; type : ARRAY 8 OF CHAR);
  BEGIN
    f.IntStr (k, 4, '   '); f.StrLj (name, 14); f.StrLj (type, 12);

    Kernel.MakeFileName (name, type);

    f.StrLn (name);
    INC (k)
  END  Test;
Some results are shown next

Code: Select all

       name          type   ->   name

   0   Fred          xYz         Fred.xyz
   1   Fred.         xYz         Fred
   2   Fred.abc      xYz         Fred.abc
   3   Fred                      Fred.odc
   4   Fred.                     Fred
   5   Fred.abc                  Fred.abc

   6   Alice.abc                 Alice.abc
   7   Alice         xYz         Alice.xyz
   8   Robert.ab                 Robert.ab
   9   Robert        xY          Robert

  10   Alice         pqr         Alice.pqr
  11   Robert        pqr         Robert
  12   Alice         pqrs        
Lines 1 & 4 look suspicious to me, but maybe they are correct and this odd behaviour is intended?

Line 9 is incorrect. It has not added the type because in incorrectly thinks there is not enough space.
Line 11 is correct. It has not added the type because in correctly thinks there is not enough space.
Line 12 is incorrect. The routine crashes as it incorrectly thinks there is enough space to add the type.

(There are no spaces in the test strings.)

Should we correct these errors? I think so as they are lurking bugs that will ultimately catch out someone in the future.
User avatar
Josef Templ
Posts: 2047
Joined: Tue Sep 17, 2013 6:50 am

Re: Issue # 97, Create Docu for (System)Kernel

Post by Josef Templ »

It is important to understand the message behind

"This module has a private interface, it is only used internally."

It says that this module is part of the BB low-level modules which are
not intended to be used by normal user programs.
They are subject to change and there may be implicit assumptions of all kinds.

Even if you add docu to it, this intention remains unchanged.
Kernel etc. should still not be used by normal user programs.
Therefore this "disclaimer" message must be kept in the resulting docu.
If there is anything in Kernel that is needed for normal user programs
it should be our goal to provide this functionality at the level of
documented high-level modules.
We should at least agree on this.

Documenting the undocumented modules is a huge task.
We will not be able to do it for all modules and I cannot invest much time for it.
I cannot imagine to work on this docu with the current heavyweight voting process.
Therefore I proposed to start collecting the required knowledge in the form of wiki pages.
This is much more lightweight, provides versioning, provides search, allows multiple users to work on it, etc.
It would also have the advantage that "Info->Search in Docu", which is used by normal users,
will not find results in the low-level part and (for the disk space limited) it would not
increase the size of the installation.

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

Re: Issue # 97, Create Docu for (System)Kernel

Post by Robert »

A draft of System/Docu/Kernel ...

I had no intention to start this task until someone (Ivan!) assigned me to issue #35 which included it. At that point I thought "Why not, I'll give it a try".
(It was only later I noticed that issue #35 had been changed to remove the Kernel Docu.)

The attached represents my attempt. Obviously it is not perfect, but (I think) better than nothing.

There are about 6 items (marked in colour) where I had no idea, and gave up!

If people with some better knowledge of the subject spend just a few minutes marking it up I think that would make a great improvement. Don't worry about English - I am quite happy to rewrite any sections, it is capturing the knowledge that is important.

There was some discussion of format in Topic "Documentation" in a post dated 15-Jan-2016 - how does one make links to other posts?

I have used the "Hide in fold" format suggestion because it was easy. I don't have strong views on the format, but am inclined to think the Wiki idea has benefits.
I will not reformat this Docu until the Center reaches a decision on format.

Enjoy!

Code: Select all

StdCoder.Decode ..,, ..v87...3Qw7uP5PRPPNR9Rbf9b8R79FTvMf1GomCrlAy2xhX,Cb2x
 hXhC6FU1xhiZiVBhihgmRiioedhgrZcZRiXFfaqmSrtuGfa4700zdGrr8rmCLLCJuyKtYcZRiX
 7.2.s,6EZ20k,5TWyql.bnayKmKKqGomC5XzET1.PuP.MHT9N9ntumaU2,CJuyKtQC98P9PP7O
 NbXmb.2.olFm2E157,6.,U08J99SdfJHPNjvQCJuGKfaqmY6MwdONl1QCh0708T,U..w.2aF0,
 sUGpmWbBxhYhAbndMHT9NY6Mw.sQq2Y6cwB.0.TxXw,woDG.0E.kmq686.QC18RdfQHfMf9R9v
 Q7ONb17.,.L,0.x.0.4.0kU8ro4Kq2sNQ.6.th.E1k.8Mtr.2.S12.u,0E.k.0.4264VT.E.0t
 .U,B.4.gkFI.lg73E,5zdGLmOormKmCLLOormKmGomCrls.E.MTNYAUXZF2.U1Ky9.,.s1MFNY
 .2.AU8j0Ikmj,2U.kJE.0.x.0.4E.kU85.6.V2gz,U002.0H.6.c5E..ME..,6YUy1v61IU0Ky
 B.,Uu.,US.,sz,AE2.42.E.07M8EJ5.3sKEp5.5cUZT1E.cCE.c5E.0cz5.2U,,.2UE04.8Evk
 ,C.A20E08Mtr.0E.6K6.c56.,E.3U.U,,.2UE0CE.EPk,4.8kLk,8.0kSG.3c9k67.m1,6.1O,
 gU0KyBU.2.812.u,2.yD0E.4It.c.6YU.Uk3W06aB,EaaKriqtuGaaKriKWKqt.6.AA6.w66.4
 kTkdGLmCoqGqtumb0rmuKV8rrSrtKKtWmHCpwCLuKqqyGWyqlKrLCpm8LvaqlKqtSGKSGICpwC
 LuM8bONZfRUdM,R.9.05.Zz16.,UWU.2.W.0..N5,.IZphWI3t4cUXDJcIf9P9fQbf9b8R8pum
 47ONbvM,Mw.sQRdIf9P9HWE.8D6.wNw.,kJF.0U1CS.QiiQ8CJuaLqKKWKqt2Ul1.RVtZBE.8z
 1U..2,IA6.Ikl1.RNEd9REu6F6.G.0..696.16.6.665hKE.UsQA4.4.8E.0IzK.Zz8kMVf.56
 .6.EJ.IyEU.UbV5UNV.2.5gwZ.0.E2kTE.0.3gwd.,..Y2,E.4.2.2YX00.25.1.,6.c,c,3gw
 P.0.,N.E.o12U.U,.10.,U.YLE00E.2U02U.c,N.,c.k3...g,.Y,2U0.96.0.E4E.8.w,.o,2
 UdU4w.c.c,..6J2U4Y,2Up1D.81A,2US,R.,cIc,H.i1Ok,0U.2Um.U0,N.,65c,H.u2Y.2Uq.
 D.GH.c,UlU5Ikmj,2U.EXE.0.x.0.4.A6.A.2G6.7.,s2s,7.,MjM,6.V92.w,2U.kgU.kTU.M
 .j,b0..68ADs9y4qomGrkSGKSGI.amaKKu4adM,H.9.,6Q..0E.cN3E.6.W.0..1N,oU42.Y9o
 U2U.23o.6.1M.o.koE1W.0k,E1U.gJs.6.,,B6,6.p,Bs,kPE1U.Q5oU3U.Q....z0G.0k,.6.
 5.U.QR606.5.S.0EpU3.P,B6,6.h3S.Y9oU4U.A96,6.5.7606.17.c,kBE1S.0ENE1O.0EVE1
 G.0EJ0.8.0EME1O.gc.U5.J1Bc,6.JD.w.6.j0D.0E7E1a.0ESE1.l7.oU1U.A2o.EN.kIU4U.
 A5s0kS0.S.w6oU2U.QC2UyzzzzTN.B.0EiF1C.o1oU0U.AW,U2U.QU,E1O.Q4oU5U.2Lo.kNE1
 U.21oU8.x.Dc06.56.oU1U.Q6o.6.,1Bc0E3F1W.0kEk0E.05U002.a32.y12.1sBsI....w3.
 69.A3kI6,M,Es..2U.EQF.E2E..s5c,5.,c.....U8.U76.OE0E.SE.0U4Q.2UB.UwU4Y.2U3V
 1A.0E.K.OE3E.008k,UUV4Q.s.,U4.,sDs,5.,c9E.UegC.V.,.DB.wU.kwE.0U102.U6UTV.2
 .866..U2V.IU.U.UUQIE.UsQA4.4E.6,,6ExP,0MyfUUt70QqmX,U.2...1.Bs,E,2.B.Yb0U.
 2.I3.U.UiI.S.a30E.QEU..2,w52U.E,,,..Y22U,.,.,tcU..l,k.E.0.4.OE,6.e2Ok1Ub6.
 O.2U803.,MJ2.Ux.9.,MJc,H.,6Kc,D.W2OE16.m3Ok3UzV52,2UdU5w.2UjU5.,s.s,B.a1Ok
 2E.04OE0E.a1O.2UDV0Q.0E.q.w.c1s,3.,cBc,U9V4g,2UWV52,2UdU5w.2UjU5.,s.s,B.,c
 Bc,L.,sac,J.,sU,U5I.c,,U5Q.2UcU4w,6as,U0V4I,2UYU5Y.2UPU5Q.2UCU4.,656,5.80S
 E0E.0,,s,5.y.S.2UCU4.,MSs,UN,UYV5.K2Y.2UVU1YV.E28Mtr.0E.MiE.c5E.0cz1,ME.4U
 .E.m9M0s.913cj7.N.Bs0EQ0.DM.0U.o,oUCU.I2w.EE0U.wU0.P35M2,U6Q,QUI6.8k,E.q.O
 .s2s,1.,cV,6.OE7E.C,.03K.2iEI..T.,6.Q96.A66.4kQkd....s9UKBhZxinxYgw2.HdJHP
 NM8g.g.2Uk,.E.cBE.60,E.0..h,BM20.b.D.wOg.6Q8..6.,UJ,,Uv.,k.C1C3...GLmyGWyq
 l6F9fMfvND79DtSb8R7PT7GlK5HV6U3.V1.E.0.3,,6.2,2..CE.M,Es..2U.keU.kRU.M.kd.
 ..6F9fRT7FTvM.Y3GomOryGom84a0k0Uk,.6.,UMB.6.W.0..R.B636.z4Bs,6.z.Dc.6.J0B.
 0kDk1U.g4oU8.z,G.0k60U.wU0.B,Bs,6.z.D.0EPE1U.IBwU,6.0E5E1.j0D6,6.36.wU0U.g
 3o.6.v,D6,6.T.BM,6.70Dc.E5E1m.0kek1G.0kBk1U.w4.0kn.6.N0D.0kb.6.53,czkIE1O.
 0E51.DM,6.,V.wU5.Z0Dc,6.DF.6.EJ.8cEU.UTW52U.MQE.Qkm10.E2kfE.0.322..ESE.8.2
 .2YX00.2bXl.k.0.5E.nT32o3q08zJA.2U..U,U4I0sjc.5U.2U,U.2.c8..,.b5D.n00U102.
 U6UzU.2.866..UYU.A.6.66.,.W14.4.0E.E4E1O.,EXk14.w3w.k0k1O.0k,2.,czE,k14.0E
 XE1U.o9wU1.D,Bc16.V0DM.E5E1y.0EBk1.T,D.A3oU2U.oJAV0KyBU.2.S00E.c46.,.1.eG.
 mLT5.2UEC.c6c03gwP.0.L20.p.,6.M.EJ.1.V20E2k24.g,oU9.B,Ds.kNE1S.0kjE1W.0kjU
 BU.Y6wU0U.I0wU,.D,G.0E,0E.oU8U.Y0QV0KyB.,..u,2Uz5k.6.,U,JCU,.,6YU1.P.B6,6.
 X1q.0EWk1.x.Ds.k10.Dc,6.v6.wU1U.o,oUAU.o1wU0U.Y5oU7U.I3,k3080k4E1U.w6wU2U.
 20w.6.9.D.0E,k1U.2E0k1U.o1.0EIk1U.21w.6.P.U.o,oU3U.w2,.6.R.m.0Ejk18.0E00E.
 wU1U.w5w.6.T0Bs06.l1D.QV.k1G.0E5E1W.0kgk1O.0k5U1U.o,oU8U.2CwU2U.Y,wU1.N.D6
 ,6.D2Dc,kAE1a.0Eek1C.0E2k1G.0E5E1e.0Evk18.0ETE1q.27wU2U.w6oU5U.27w.6.l7.,E
 1e.0kik1C.2,wU2U.o,oU6U.A9s.E2k1G.0E5U2U.gj.UCU.o2oU1E.Y8wU,U.A0w.6.3.D.Y.
 w.kkE1O.0kbk1C.0E5E1a.0EFk1.z,BM,EWk18.0E5E1G.0EjUAU.o9w.6.7.Ds.6.z,D.0Emk
 18.I0wU1.9.D.I1oUBU.2E0kzHoWOoYuoYGpYyIb0mZKKtuqmmq2WGJ0GryKr0rr8Lu4Klmqm0
 GIaqNWHPaGEemIin4qk2aoa0pb8Je0mdapdGpWqIK0mfaKr4IsaqRqk4QcDpdHZeBAV7Qgjhhh
 pdjZi4xhpphY3Yx2YrQbBAV7QAQetphoBgshcmJijJiUgbU2bvgV7A,nvMNPO5PGP9QTfQd96v
 76ftCPM0H6NTvMdOSVPN,ND,d6T9N5f6rN1HM0ohZ3Yx2YkQbBA,BPONPNRuPd1UlQbBA,H9PN
 PNDPMNfFVeQHfPd96vFOin4aUgBhoZighg3phYBhVphUgbUYeGhe3RbBA,PvP7PRNPNR0.anRq
 k2ohVhhZZdZphUg5ZNBhtCPM0whBhgh3Yx2YqQbBA,TfMJfHT9RB0kNin4a.Yet3iZVWsMBf6r
 N1HEs8rrCqmCrtyKt0mSAakQbBA,bPSP9Jn9Q91QiaJYv.uKu.UmQbBA,dPOPPNZONbvPNPRdP
 OTfP,ND,NA0HMiXBAVIBfEhcBAV7YcdJiZRgoxBn96v76VuHHeHdOFZ86duH,dI9uETeI786rO
 RR9R1vNDPN7PL,N1HM0HcPfPPPdC,NGR8J9uF9eIrN1Hk2y4PdC,NEZeI1OK,NAVVk24,tHB86
 TeMJ9F9vQqk2akWuIWin4qU7gcsRgkpcmBghhgEZim3Yx2YE,83gcsRgk,in4..,ND,NFl8J9e
 HbOG38H986ZOF50..EqohfJbUgcsRAUElRq.H6O1fP79P9fQp76VeITuE98FfeI986FNNlvMVf
 I9vMp76jOOR1R7IdfQ98K5OFV8JHuHRuLZOF5uHQbUggnZi4JiVFR0mWW5B0030mlyKrGrmWLu
 eHESpo.sETeHdOFl8Jr767POb9Q5uPR9Rp76HeHw6aGR0mY.qk2akWu2kYGrmqqWWLu0mS0Gc.
 Z04IVCJe8pUCIe0GdKoVEEqk2aUcggu2Y7ZiZhBAZUIcVRiZZet3iU2ZdIbUAdClX69,dH9uJN
 761eEb0QbBA,.d1UjxhgpeVZhU2ZdEVyobmoW4IbmGEu2....kV4KqmKEWmbKJe0mriKR0GVy2
 M8N76ROF.....FPMZfJ19P,,CIY4IdmGE.....YcZJiZpgU2ZKBcG3YmhgaJbUAcCBfGhc1BZg
 2YC,....wcZZiHReoJidphbpeVZhUsH6Sp761eIkbOIECJYyIdGpVWoUQbUwdJZ8T1.......6
 RZPO.Us,.CIY.sP.......AdiZgZ3jU2ZdphYhAp76H0sC,dJ1eIKKqKau2Y,p7......6RhOM
 NXdkYu269....d1EaKKr0GIaGRcH.....d1UjphbpeV,YdDpd5BdCZeg2YCh6.....TvOf9Q,7
 8RPMPPNplU83..MOp761eH......2eoJiKBgg,EcGJdmGEu2....UpZi0xhj,2ju2Y0x7.....
 .U13hVVg,CIYIedYZU......HePd1U7,AZg......moru4.mob.H79,dH.....6IdfQ.AcC,H7
 9,,.....8pm4KqOpkm4cI9OENO8N76.....kdC3.AdC3YsJbUAcG,sI.Q5T0........KKuOpk
 m4lXHhcIBZg22.....Eu.kY.10U1,........IeZBAUdEdK2N76R0....sI99R.Qe379,dH...
 ..aKxKKEWmIeX7p7EK....G5UKBggBhY3YcA382EK..M1HkW.gdjZgpFEqXE,9eIw7Z0sKu4.M
 0RPNl9RPdC,NHT9NfXvgV7kr0LuCrKeHEC3rN1HUmhgaRgiZihIbUAdClXsCP.5vP0LeaqqKqK
 mGEmqr4KmGpoq4p7683oaUwd43YH,HeHduCP.99SdP9U3,EuKKtqqKeHECorqqq4KrGqRq.uqr
 OqoqKsCrKmGEuqrOKsGLtCrKmGECqtaKxKqKmGEGqtaKxK48rtaKxUXxhYhghYZUYgVZiVhZg2
 YmhgaRihY3VfQTvM3OMbPNP79,dR1fQ3OMbPNeHEa2.kksQPdC,7ITOGcIw71eIZ0rORR1UDp6
 U1,P.V9RZvQeHE.....AdClX.Ahh3CZntqGR.I8...UBxB.gAVvPZ9RPdCGoo8rm.rN1HUiVhk
 eGLnWHb4qqKq4ak2K2g,yIleqmCKu0mS00.sH3fOsMrN1Hkb6F66v76ZOF..k4En0LtaKrGrKm
 GEyKnOqtqGKAhYhZuMGsF.HsQdfQfvMdP9p76dOSVPNPM0HMF.8pmGquCqm8LEqHE.83Ac0,22
 .P.FdQp76ZON7PRM8,dI99N66FdNf9PNfC,dEy2A3..g,K2UHBhbphVZipJiZ3Yx..I8UP,.M0
 ZHuCJugC.QbBUihCMGsF.0rk8rKeHE.4124,,ZOF50..k2AhYhZuMG.U7sQ.Y8g,ak2K2PM0HM
 FQ56JZPMVvENPN1fP9fQ,ND.83A6.,,k4M0FtMp76deQ19Q.aGECIqK4f9QN76R0Koa0Jeap4a
 k2K2UIBjkhgU..cI.r011.CroermIbUcHw6.PXhI5P0.a4A7.El4qtU,,oaUwd47JnXv.BPO99
 P7vQPdCG2sP.0LuwhapgndC42EMEM22A7UB..5uPPPP1XUUGx7UvgVBEY4KrG40mS..kYGqmuK
 uaKnaqm8LEqX,JcH,.M16Rn9Qp76H0sCkr84cHkRq.WGf4IdAhYJbUAdYdP.H76H8N916N,78.
 EK.42UBkW.6RqqUGLu8LEcI.M0TXg2YqBhnZZUYit3ig2YVZgmJbUAdC,.PXu2YBxBU7EmKqtI
 bUYet,6QI5bOKb0R7IdeIr,KaoJ5G59WBAV7g6.ROMPPN,V,JeGVmg4,tHQ6k4aUIJit3dV,Ec
 .664KK0GlmGECKR0mYu2M8rN1MJdfNl,..UH,.oe,JeBA,9fQZP9p76H0sCaUa3ihIbU..qqka
 KrSJrGKR0mYu2.wBNOOb9RPdCq2.0rlqGR0mY.Un3ihIbUA7.Eu4qliqKeHE..dfQ19QyquuKu
 q0.UqBgghZu22.kv4KuCKoKKteXE,.9fR9fPdfCa2kIUEJeDR6U,ZgYJeZpgU6Qp76H0ER.sC2
 eG,UgZhjRgBxhYhdZhhU2ZYhgntIHfSmGEqqrGqdaKxIbUA7.,dJ6N9X,ZgmZZUghjNE7fQA7U
 dQ5H6I..AgohgY3YcU7,QbB..8omKKsin428.QcVVcAgYJC.66bPODfC,tIHvNR1ZnR0mYuIE0
 rk8LR0mU83w7a2.RfC,NG.HdCm2kR..YBkRq..krmKqKqlGrRA,.6F9PMN9PTna..b0N,C36N9
 vQ42U,,.Q5.U4BgnZi1xhg,..6R19P9eQZ1FNO7fC.Q5b9RZfC,NE.Q6AZv..wcZ7HTPM7PNZf
 I9vQf9Pd96FtHcQ9vQp76H0UDVdhhkxhmNORvNN76HPPkmGKK0mr8KpK4p7610....gdjZgCBg
 hFIqqrGKRg7K50mbK3RPMPHRodVhBHtCP..UDJgepdVhB,,.UjJgeJbUwdWJhZlR0mbK3ER.H,
 ..8pmOKc8rr2Ycoe,FtoguMG..19NMG..R1pleEbkI...oeVJiU2ZK,..UhxB999,dNTfQPfC,
 tIF0kR00YgZFRMS66T011..oBI5.A3..6Jn9QuokqaU6RpFea5r,.pFbkI..AdiRioBggZh1Zh
 Zlm2Yc2CCorq4AZvM0.khCqrGqmqJEaIr.98S5HEWGf429fC,NFCa4,..A7UGhgYhC8LEWGteH
 E83kIin4...GJt44FPN5vO9fQ,FoeHEWokuKmkIi1...cJHPNKKt00....Grm8Ln4qlKKe8rk2
 dV,0GIKKwcIYZUggnZCEK0mloB99SmGEGqoC5cCa2kIeX7,QbB..Qi,Zhk3hV3YcQgcJbUQc6l
 IeX0tHkRqk2..morSrm8LEQgc,....cI9PM7PM39PcNZvPP99GrreHEaIb.H,...MJV9Q9fQ,,
 ....UAhgqhggxda3YcYiu.aGR0mdU7lR..whV7FN9P,78HWiBghdC4Id..rFfkriKR.M8rN1..
 MHTHEWmY...kIi1..jPN..plVW2rN1.UBBgfhg4BhghA1XUcJ1WiBAe1..0GuaLsKKRA6.UdQ5
 .UChgrBcmJiU2ZZZhoBjkZ3RvPKKqKqqmGEu47POPfC,NGg6U7,Q5..wdWJhU2ZKVjJbUQeN,U
 UcC,,amRq...ZON596F7Rn9Qp,Ud.Uv..2ej3iIJiVtENPN.eHEGJt.kIi1.UpRicZemBA.00.
 .a0.UFhidZiU2ZZ3jdZi1xhYhgu2Y7p7kIi1.EdKqnaqtGrm8rayKm0WhxBplaMRAZvEc..NPN
 1vQ996F7QplY.I5.i1..Um2Yc2C.A3.Q5..qqrOrmCIqKqkEEU1xB...r0qZGhAMFlvM00MNg6
 o6M8..8pryKu0GIa0...QeZBgmRgc3emxhXpeVJiUcR1fQp76HeH.,dJMPp76P0Q5hOEAgYJCa
 2kIi1..d9JZPMSou4KtGKEWmruKR0GVyYA,..whpJiXhgExhn3Ycghj,.CqrGaExhnJbUA7.p,
 Uvg,.660LqaKuuokqaUcP1Xu..kR.FPN19NN76dPMH9Pp7610.M8..YiVJio3YcQgjZAplVy4.
 ..8rowgIxhJZia3bU2Z7louKR0mU..iXDVjhioJbUA6.C3Q6.IC.kIi1.EeWqoCrVyqqq40GIq
 4.kYcP..Q6AZusE.r,..Gom66FNP..B9QZPOGLRA7.plb84M1..Eqmqb8Kp0WhxB9992im,.Qb
 UAdC7NN9PN76RPM...A7.P...BOO99P0GI8rmCKRYetlRA7u4...y291...RvH3fO,FfkokYG4
 a48bu2Y,p7G3P...NuP19N99NPuP0W7,UG,.kaMRM1..MHT9N,,.......kb8KpK4,78PXuMH.
 ,,...kb.r,..Gpw0rm0GIq4.....UIBDin4..aqq22HVA,..EtaLEWGoeXIJit37Uv2YVZZUIA
 .UdQ5..n9QyIn0GIaIbIiZRA4IbI8IbUY8Q5.UJphgxhVNH22P1kuM8..2ikhAQgcV6,CIYsCP
 ..sQ99N,78HV7,Q5..dfNGprCJu8rowgU2Z7p7H1.sI.66T0T1.kV.Et..H,.kfyqumKmOoouq
 kmqoerm00I6UvM19eH786LONZ1RN1PM1H8R,NOb96DPNRPNZPMN9Pn9619NhPObPN7HuWqkGLE
 4Ks0Lqaql4KuaqrQiUAgqNO7965PMN9PHfPD96LONZ1,dQTPRdPORPNb967POZPNGLqaLESLoK
 KtKKE0rrCrtaKlmqmuGEGJoKKtKaVNN,NRbPR1Xt7OHvNFPN0GqKKvKaUwiVBjn3YjpgUAgXRg
 ZRCHfPD96d9O996ZPNXPRHfQ99N,dNffP59RHvPRPMNPOdPSr76BvPZ9699S1PPV9P0muCrm0G
 ,Cpm8Lva4bf9dOO5vObf.,dQ19RFPNZ96d9O1fP,tGUiYedhhZpZBgVI3hdRiUYgjRgphB2YcB
 gn3YWhgZphUIiZpiZJinhgY3YZtNHfP9PNZHmIgt3Ykhgj3ighgUwicxhUwiZJiZ3Yixho3Ydp
 hqxhgpiZZgUwidZic3YYhAHvNRPORvNyKt0moqKsmahhAaKrMOdf9,7G9fP5PN,NOd96PPMn96
 5vPRnk669fQZvPCLE4KrGKEyqqaqtCroyKrCLL0Gcmqm4qt2Ymhgkxhm761fPn967PNBPO5PO9
 fP5PO9vQ,7RT96d9OQ6PnuuqoGrw0GXyKtKrqen4qE,aEVmqkCqp8orWLECorqKsyKrKKrGLE8
 ouaKqGqm8LEOor85bP0F9Rd9Qpt9TtMTPP.RdMNPM5HlyKwOKt4qqwijJifpZjJibhV7gdVBhi
 3YVJiZBg7IcABc1Rd0xdM3Y1xdB3eDpd3pdI3Y0he7Zd3JeUQeJ3eExdEJeIhV7wcmxhp3i7Ic
 gBA82O2.PEeyKsaqlaEWyql.19RHvP0moCrtKrmCLLqk4qkb8rkuqnKKEGrmWLu0GlKKqyqv0m
 ouKmaql4aZRiUghdRindPQgjpB9fPdf9PM13sETeHbGEGqruqmmGEOqomqmwBgCmGECrwuKu2D
 85N76TfMJfHTHX.aKqmqm.6RN765PS59P.ZHK0GryqaKag2YXNPPfHG5UXxBCZi,.PXpFb.gV3
 dQTHECqrGan3YpRiZZA3PSGLoKagxhVNNZf9PM1PsETeHUXZ8VHK0mtarqGZkVjJAdWZhVI3hZ
 3YaBhgtQ,NNl9R9ntaqruaUogjFVm4UYxBf1CLK0mtabWxhg3YaBBYZUAgiZA5vP7HEO4oZB.E
 qaao,AA6JKZBQekhgXdNHnt0WcFlaLuKKEyKtGqm8rouqnwidZCHfP,tMTPPVPRdPNZ96jvPZ9
 Nbf9P6HH9RdXhggiZgdVbBhqhgn3YgxhrhA4KmGKtKqtCrmCLEGrr.NnvErKrq8qm8rmGaWBho
 RiUAhi3Yo3hZtRTfQmGE8qoSqKKKrG4..AA..6OH1oB.6RuW7phohgg3Ys3bq2YkJijNNwBb96
 8rm0GqYC.c9PM1.uqk6H2YxcAfl4CJsK4.FXghgixgo3hUwha3YoBjk76ROMPHLM1.VfQT166v
 lMgVI3hZtMffQZPNR9RWamZgrBgmhgU2igBgopgjJihpZUY80Gv4aphgUwha3Yl2aUQgjJimhg
 n3ijphYRiUYij,0Lq.0GwWHPum4q.UoBB9fIku.v,VlRodphhWFEyKn0Guaql66TfN2BCrwCLu
 Kqq0GuaqqIig2YXxB.aKrSaoxBTfP996bPN5vPR9NRN1PM1dOKVOF,7FHfQsPgVPhiiZiVxAM1
 dOSVPNK5Yij3YbBhq76WLuIiiBgg3YVRgXVUYijtP3nmYinpZBgVihih,R0gVI3hZdPfPP.yKl
 e42YhBgYhgUAgqBgdZhVJggl4qkr8Kpq010n86sH3HWsMPMER961Ht4qw0mnaKvaKrSaVRgX,6
 RsP3fOELM1a3KIwC4EcM1VmYuY3J8dW3,k4qEe..MFl8J9030PsKffP.MS.UdhhkNN6R,NM,7P
 HvQd96TfNKKwCqm0LuaqruacBgiZggltum4qEqaKr..03whdphodQ,7RT96d1RPNl9R,NNlvM.
 .gVB2hVpBcC0Jdy2I8P6JMNlvM..2YkJCYgpJiZpZBgVBMKMGdPNU,JcHZeGBc1FeaLs6RFPMd
 nl4Kr0GlKKEK5UhBgfhgUYichAdPSVX7ZC0GmoARPN796HfP,NPT9N66PONdPM,NNBfN9vMdPO
 hPNNPS,NNl9Ru439P6JFXaxhgZhjxidphbNE3uIUU2im,sQ,7N9fN66d9OAhiZiZdNsQ,tPYC1
 XoBDYicBAC4kmUYhgYpZBocjJiUYichABPRRHukkAB0mrO4QiZ3YkJij,EtKKnKKt0Gu6R2YYx
 hX,4KuEEOqr8LE8kaKKu4KLaIuKqq8ELqk40JdyoV.,789fC,NGdPNK2HFV44dOS0WdkYu2D0V
 eIT0.6R.wBEEW08YDZ76IZ0...5OM2Ycw7sOp,UdgVEJ8...6OEq00Q68p403...Y6ZPNB96O3
 8baJ51eHkIqEc83...S2buId1DfJ22T0l1EEkd.sCUj,.....UoJC.Us,.C2.y4.....MGGas3
 2YgZdCaIb.r76h099PI51eH.....GLfUdkYu2M1..6R.momuaccCo7...YC.yKr.EaUCN1VeIT
 0...y4VXiVuMEZ0..AhuMER0....2eoJiK,.V8JqEc83...gioJcj,6SIcD,....U1NM6PU137
 ZO8P....U77R.A7Udg,....mYi,UAx7kIqEc83...EcIC.4IbUdgVE,...cI9PM.cI4YdgVE,.
 ..sIb0.a2lX,J8.b0UvsH.......KKuOpkEwsIGpIqEc....6R.MGU,,kV.......EdAAUdEdK
 2P6IZ0...bON.sI9m40Jd...UdFEU7p7k4..Eu.o8aKm00I6UBgVB.qorG4qkhK5S4kwgAf1ko
 .66.oAZPN5vPZ9Nb965vPAAaKrSKEaKrOqrghVZidxB4Kly4,NHT9NsQcP99SdP9.gVIViVUgd
 j,,NO0GuEqa4RN1PsPV9Rb1b098P9PP9Xn3YkoZiAap2YVVmhgnhgmNN796BvPQA6P9fQ,tPV9
 RHvPCLK0mMOHLumN4HEOqr8bfhgmpB0GnmqkSqtum4KIqK42Yloau2YBxBEo4qt.,NORPOdPO1
 9PHvQ99NRN198P.SHR0may4..7PSRPMPPO5PMN9PnHqyqkggYp3.IaoIbUYeclqyKmUdRiUAgU
 YcAZdigV3,2Yn2au2YI3B.2B2ijBhiVn3YoxB5uHP86TfMktEtKKnC4PV7p7UIVihCkrOajZic
 hgmNPT9NsQ,7R44HPPyKt2Yo3hdRCPvP71R76HeN,dQ9fN5XUY5V76d9O.66HXixho3YqBggBB
 RN1PsMTPPV9JHPPqGKYBY8cCI81WqEXQ8MGgVI3B,7RHXn3Yr3hZphUYCHXh,wiVRiUQgjhBHX
 Y3YVpB,7PTXZ76HfPdvP,NP9PPTfQnf9P6J.0GnyahFEaqtAfZBgm3YP3aRZZUgdjpho3hUQfl
 gfg2Y2Bgt3YPJaRZZU2djhimtKbNLN76POORPRdPN,tKVNLoYUQeZRgjFEipOqJLqk4KKwGrK.
 90Cou8LtoBNPS,dPTXpRiZ,dPNZPPsETnq4aYhVEJijRAEECqkmaZZgUwichAMNq4koMRR9PT1
 u0RvPB1I5H0EbKrq.Bnqy4QCHPPIC9HE8qwkoMPUigVBoB0bmRCp,..oAD9PTfM19P,7QTPOkt
 ginFE84..QgnBhuN9N767vQe5IinBBI5H0kdaKxQiUwBG5.Smt0mlyKmsQ9HuaqrYZUYgVFECr
 m.Agiltarq84aKrO4MO2YnhgX,bf9PklyKmKqK6N1XhEtKKnCbu.UExBEEG5dnmQioBgmlrO4s
 MT9N0WZ,mWYVU.UV,..UU.698rmCLsKqlGroO5um4WGeWqmIcgBAUqBgmBB39P9vQ,Fr00YgVZ
 C.THE4KtKaVdQuqnYgUAB,,8rmO5bHEyKtEEy4MOZ967PN59P1fQ19RHvPAhi322YnxhpJC0ml
 y4Hd9,N1P6QZvP829P9NFvcEER.kaKKu4KE8qkCbUAgYZAQiUogj765PMNvMf9P19RHfPYicFm
 aqtYhVRgZhhZpho3YjFs8rrgAsQ4KrcR1no.NFtKak,h1qk4uqkqqmCrK6IT09eIw71eI66T0k
 Vk4ipuu4.P6QdfQb1...A7w6Q9.6HHvQd96sPBfNKKuCLKICNPMdHvKKEGrr0Gv4Kt82mGEG5b
 9Q9vMHfNn96VvPH1Cbolr.MGd96MRb131KabBgmJgVxgZ3YX7PNnlwBN7611d9O9nVyoaQgjhB
 cQ4aYBhoBhjtQMOP9QTfQC5.83.UB,qkhoB..MPUn7NH1m4HPPV191koMPUikm2CGrK6F85yat
 7HH1sP31CLEKKw0rrMN..UUY8YBMObntyKtGrmcPn96RPMPHEyKtG4RViVhkeoAR0P6JFXiBA0
 Wa7Ra4P1M1qUNVDJgehA0mS0WD,UDFWk4Gpg03.QfppB.,lVyKrErCLEaKrO4.,NM3vPfXjJAs
 QRl4OKs85dP9plYkXkb8KpK4,dNHfPDPNZ9QZPO2YpRCYijNOYB6ROrm8rtaqr2YXxhidQT9PR
 N1PsPBfNbP9A7.BOORvN.ogjFtKql6N,7RnnmCLLMO7P9.kb.0LtyKsKKtGroKqt0mo2YkBgXR
 hVxgZZgUoAqKLqk4CLu8ruM9Yetl4aIm0mrOaWBAHvM,7RnXgEt0GsyqoUUYCGrw6N9vQ0mL0m
 taaiBAc9g,EdKKmUBAc0R8k4mooC5TXjdOsQ,NRb1dXcYimBjUYijBZUIiZZgpFEGbZNMPvPff
 Pd96TXchAV96PPNP1,NRbXig,V0.FdQpFdYAIid2YG,0GIOqucCsHN0HlU8od.GJo6QZnl.,tM
 YB7Hu6Q9fQBvPZHEGLocQ91dPOTHL0mYGLEa45PMN1S5ohZxiUghZ,8Kqyqliqt0mk85ZPNXno
 EK0GlKLu0GuWamhgUAhndPsQffNBPO5POYCPPNUdhhhhgYBhVZiZZht3YVpCAAo3d0BPOZvQd9
 6dPOKadZCHXX,AhiNN1vMF9639PTXUAggZhjNMa4,dNf9P0moCbnhgo3Y4BcARe3pZBAda3Ynh
 ia,..bXoBhgZhUoBdnkOrk.0moGbhVWhgUQAUVxgVBhi3YrBho76BPRNXnhgo7JZOJum4q.kda
 qn.qkhK511gVGhgXxBQgjpB1XdpB,NOO444MMUVphUwhW,RN18bo7RZPR.M1.31.N,wB.YCYAY
 ZUwhm7APM1RPRkY.o7.B96VPMZPMPPNdPNCr4qEs4Ktq0Ie,BfUA42ak66TeF8Z1x7qkhK5.0p
 k8rk.M0H9NMG.aEb44,FrG4,d8,dAfdB,76L76,tOHfP796PM1HsQdfQ.d0PM0H8N,,31.,tPZ
 96V1.UYVig,P.YemBA50M110UA,6JZOEV8659P9PMsQRVE,.5fCGJt44.H7650KbBgcB3eIFcK
 KtO4CLECKqK42Yj3iZJiVZCQiUAgn321fQd1GbZ3YoJiV3iU2hVpBNXik4.a5PsKMM.HePBvPA
 A66wB665uP0rrcP0Gc4qtCqkmKEGpg0pWum4G30rra4.W4dPSwYndPP7RF96PPNd9OT9N,NObn
 kGLEuqmSqkGroO5TfNBnm2YGIoo2Ye2YcohfAadoZBsQHfSq0u2EektaKx2Yj76196ZOF50N76
 d9Oohp,kmm4sQaaUAgi3Y,J81GK0GMogj761967PSRnqaaUAcG,y4d9OQCD166BPORnm.oAEc8
 pb.um4qoumKuaqKGqoqaiRidxB1HECLu4Kuaql0mUUnFt6RZPN19R99N,lt0mruahYgd,.1fQZ
 nwCLEoA1eIELqUhxhYh3q2M1d0d1MPT1uWBABMG.uokqqm.ENUfEqKKv66J76XdB,76MMd9RZP
 OYiZRCJ76d76,t8,Fnyahp3HcFTfQPfCPM018RdfQ.p76V76x96BPORPMmGE4HEuLEKIgGpW.m
 GE8HEuLEmoYqoYGpWGIK0mN0Gz0mU8odG3oZBAVAhgqhAp76BuP0GdK2QiUYicloQiUggsZCC5
 0GqKKv69,dNTHEGqwMP.66H9RbnlKLt.bPOpHLqk2u2.eXdZinNNR9RZPS,dPf1AhiNPT9NRdP
 1PPCLLcM1vQq0100WqsHY8gV7ocj76Z1QiuEt8rk2YjpAVvPH1CLEG57PNbHtaKsGrr8rt0mrO
 adZC4KrCanZijJiUMSQCaEXkk8LtsQp763PMKqh0ni0Gsy4CboxBd17PNb1EEyKn.99P91dv7b
 96dPSY36RFXX7N0mrOaVdMABCIc0Gua5RN1HcF6QT19XucMgA.QC.G485krMO6R1fQDPNd96dP
 SgVBogd7PC5G2sPa5.OqoKKq66HXYhAEuEEyKtG4RVkZimxBg342EMEM22A7.BuPIC.GJo6P..
 wha7NHvQUhVh2ijBhiNNoZUAdo,f1,dMYicln.EqsMc9,7JFXZphY3YjpAd1N1a4HfP7PO5PMY
 A3XV3Yihgb,oiVNR9f9PM1P.0mVyahBAUX,MS2Yp,sQ9fR9fQ1HEOqkCqomqoGroKqtuWBg,EY
 4KrUB2emxB.ELg,U7ZAGroO4ZP110k4Cpm4Kt2hUQgmBhohgmBhV3YaxBGJoaa4lbc9PM1dPSV
 fC.6JsQ9PMZ1HvQ8bnZimBhXZiZZgUYCy49XntRH1d9OHHEGrw66dPMDf9PM1TfMJ1u2deIPsI
 99RwBVvPHXUYijtP.OqrKLrGah7R59OHfPDHuAB..V0UUcJ2YdZAYA.aGEa2.71kbm2qkU82U1
 BggZBQipRgXhgnNOhPNNPS,dNTXjJAEEqao,..EEa2b9OTPRN9N,dQGru8Lr0Ge8pe2Yr3hZFu
 EmMOZPN796TfP996HXaxBoZBgVB.aIugh,VBAdohgh3YVZioNOUi2YJRiZ,qqrgC0G,qomAg02
 YoxhUQip3ikxhmZiUgB2YkJCDfQ1PPPPORvNRN1PsPY369G5NlkIiuMGR0MPT9Npla.P6N9vQe
 XIBDqEsGbusIkaUBggsZiuEuKa3l48pmOqm2Yolqy42YB,B1PvPZPNaKrO4PPMELqk4q.cH1XB
 QeoJidphb32nnm0muUaViBACbUQcjpB9fPCbhhinZiUIgZ3YihigZBF7AlO8,7R9fQPPORPMdP
 N7f9.YemBj6,2Yx6IZmVEdkk2YWZ35fCa2kIwbzwbBgVBY8MJdXCVB6OTfQdntGLta4...C5..
 ....UKBcG3YZJCP79,dRmqKe1.PMGRfN.2YVtPfXo3hZ7P1vQd9699S.iHE4Kr0mm8bjllyKm2
 YZJim3YVphY3Ykxhn,n9619N7POdnrAAaKrO4.,NOoiVZhig,3M09fQZP0HcR1n2CorqaZpBPM
 0t76VN098S5PN.576tPNZfQtP0HMND9678HN869fQZvPqk24HNan2aIrOrkm4,tJH8JFO1HMAb
 7AHMGRfRU1BcHhcBAVlQalAV4hiiRgo,jPOwhpZiUI8dOJZeHPM0XtAZN0dOSVPN,tNfPMZn4a
 kMQa7Adh3igBhZZgUYit,.Ya7oeVZhphgUMRdnrcQ1fPDn4akMga7AdiZgZ76TPRd1.EPakdGL
 t.TvP,7PTfPDP1HMAbtBHsIdPM5HEyKvKKtOKqyqvqk24XsAV7phohgbhgm3YjpiZ,UtAV2Bhq
 BhnBhjpB3PS,dS9fQTP1HMAd7AHMGRfNHfPHXUIe3BcA3YmtQfHuqk24HO4n28pW4IagiiZgZJ
 iaZBUmAVGhc,lrOrm.kNakeuKmKKnaaZZAZOF1Wm,cAV7AHsG9PS3vP1fQ796HfPdPNZfQf9Qd
 P1HUmAV7ZhghgbFEaanZimVdxBH6JFPNaKrC5.,tMM1HcAVtAHMGN9PUhhghlwIC19NH6JFPNY
 hghAMM79NZPNCr4aEN0HOakYmKq.P1sRZPOdn2GJoK4.44.ga7AdgZBkmWrmCquGroya7..AA.
 3M1B9QPdC.6ITHrEEG5dnmQiotMogmBA0mvW4G5m4klko66TvM5PRZfQ99NRN1qkq4qouqfcCa
 Ib.Wokuag76TfNG5qqkaKr0mfa4TvRRN1PM1yaAVhka.PcITvPdnr.mqo66TXh7NsQGLo44FPM
 hPN,dM9PNYhjBA99NAdo3YXVVltYgZtMZ18rtcNG5qqr.NloQgghiYBhixAWqrCrm0mkmKtKqk
 AjUgiiZBUUgVBgVkRghI5H0kYQio,EsyqoUU2ZkJij,,tMKLrGrmAZUwic,6P1191.T185g,b9
 QPV7,sIdPM6QT12Yr3hZ,...Et.YiVlKe1.03EEGbUkmIgZxgdphiBhixATfNUn,,tRF1Eq...
 ICUoJiVtETPRRnKe1.G3uahFtwhaNNl1ktYicBA.TvM512YnBhiRgZ3YoVV3ikZB5XdxB,tQdP
 MZnmGKLq.jPMdXZdC0JdQ6.9fRuauMG.HtC0Jtyql.K5.7PN3PRDvNHfPDf96IZ0U,ZAZGn0Wk
 J5H0ERA7UBAcYZgnNM,dQ9fN9nmuqlK4T96Vf9PME,tMT9N0Gs8bX,ogjlVyoa0mtKLscQum4.
 .YBTnaMH.QedFK0mqyaHVuMG.rFfEmQC1Gtm0A6ZX7,AZBAcnRhn3Yo3hZtPVPN44RXnBjnNNo
 gjlqKqqUW,bHnIC196NvPAgWVhluc9GqmCbHVUAhn7RsQHfSwha7RFXYVmVd,91Y3PXH,H1sQk
 r.GqkAAbnlUUAgi76d151RN1kU66B76PvP4Ym3YVJiZ3Yn7R,lrsPUn32T96d9OC5PPNP1.um4
 q...AA9HEW0a2k48pmGrusQ,7RFHE4qqyai76TXhhAkkmKq.Yij,82I62hZBgkZZUAhi3YWBjo
 tQq..EVKakhV3hhdZiUAAb9OTfQ0GlKqm0LECrrKLrGKL0GIKptKKEGoo4ajxgiIcZhA1N8PM1
 P6I.sE1Hq0GI4am,UvsQHHRQ8D18rmi12iVdC4Id8pUaZD,.u4.aGRY7UBwbzw528.6PUB6S9v
 Mggn326NT965uPPnkuan3YjlkmKq0GuW4ZnnaqtggmhgYtENPNgAbXB..whgZBgV1BACLE4Kq.
 OoouqkAhudQb99GLoohU2iZJiaxBCbV3YbBA.m4ABu0.U2NMwBP0.Q8Y3sIUYhA42N,42p,.P6
 F9PMN11Xn,,NP91n963122.MN0mqyap,kdEEa4ktUjFuW47PNICUUQCUg.b0a4ktUj,YgV,9vM
 EE442BCaY,ME2Ya.1Gt0mkEuW4VvPH122T1C5P1.c9..OokC5.P6I9fQB1..YBMOsRG5sM19Pa
 44Krab4BB.uWDJAUrVUocdpB.,NMZXixBGaVZBUYZ3ksKrmKrmGKEKLrGromKEGLo2YihgslVy
 KqUiM1..G5IC0GI..rltGLteX,dI.5WGBZBAdhhhZlkYht3Yohgm,QCkk05.2imxBCbUAhi3Yo
 VXBgnhgUwhaNM,dN19R1HEKKt8rroZBYeclm8Lt66RPRP1aqt0moGKK0mkuKmQio76HvQG54qt
 CrrCqo4KuKaUQgjhhhhAum4..S2NmkcQZmtK5,78T0ZnteX7p7.T0HPPyKtGro69,lqUZ79yae
 Vu.a3.IeZZCu4W4ZntK5yKnYicFqUVZiohgh3C,,NvP1HEGLoMPTnu66FdNTfQGLosMffQZPNR
 HEGLo8rm4adoZBIiZRCHvQ,tQ99RGrrwhilr.mqrMN0mlyKrCLu4KrGrtYgZpAkk8qrOrmum4q
 ...PWC,FNPTHRg7K5rlbErgBpFbkIqkdKKuCLEuqkqaUYij7RcP11TfNUhlu66PXi...TWCBA2
 3I5.rlrcCcO9Xv22.e1M88pm.UiVgMOohV,TfNUjJA9XUwhW76HfPG5q4fXUUi...ZONB9IZXU
 2ZKVmdNplY..4Km85H0.cPcCK3u2aWHRgVphn3YoVnBD3XUAhipAAAkrOaVZBMN0LtMN71bXiN
 M,NPTnuM1ZPNB96HvQaadNOAhu7N,7RT1QioVUAgYZA9nt0mrOaoVX3hVJiVRgohgm3Ydpha,U
 n,sP.P12YcIiZpgUgbUghjd9ZPNBvQHd9Pkr0mtCqkuKE4Kq.kus70Gs8rr.sM19P0mXKKuEcE
 EKLrGroMM8LEqXkoZBo6ggVFE0LtyaZ,,NM7fQa4b1.yKnOaZFn8rr2Yo3Bq4.51,tQ9168PXi
 QgjZgZBZg2YVpBuqk66HvQUo,2C.Smt0Gr44RN1U1,.o80WK,I5..q4999Oqrghu2YH37Q6QbU
 .7ntI5a5r76T01Xu..ErER.kIAcgZhjxin3Ytxhp3YoxBb1G5Crw..11whi3YVZBG5ObmBB3Xn
 3YgtMmKEObm,MMR9NqqrgC0Gs.sQR76BuP0mkYhdRCHfPD96TXgxhX,..0rk8rkqaolt0mrOao
 Vk,EEGrrIgZ3YoJiVphnhhdZiohgYdQ9fNN76ZHukmGKESomUEVU2imlm.1fNdPNZ96bvM1Hra
 4G5Grk850Gs85.uKmQA2Y5FdcJYZUAhnNPTnm0mF0GMWJL0mXmqr8qkcRABUj,gBK54aZ7RKao
 VVRCN1..MOMO.AgoBhjFs.c9,dFT1.2Yjln..UhhCIA,NORPO.9XmdN,NPT1Qio,YAUa7RsMkl
 Ud,P1sPBnouKuIiZRiotQ9vM.YCgBUc.vlqc9ZXn79G5RnruqlKKECqkKrtKKESomUEVg2YoxB
 dfQ1XgBgohgUYic76ZPNBHuyadpB.0mkEvKadpgt3YoNMYic,d1,dR19PfPN66Es4Kt4qqYC0m
 kGKt00uqruKxKKtyKL0mUOKuKaUYicBANlwyquQicxhpVXBA.o8m0ghjNN,ND4Hgum4qEnyKtq
 KECqku41vO996TfP,dR1XZRiUQl9qgmxhhNM,7R1fM2YjFm4KucNTXVtQ,78bON9961fMT1HN1
 7PNM9,NM,7QTPOcQwB7ntiKs8ro0LuyKtqGuaLsKamtMTXnZ3VvPH1CbVpB4KtUBohVhhZhZUo
 iVNOUiVBocjJCD9P..CLRqkqyaZ32gVVZgm3Yh2YqBAUUwhapAcNEugA31R1UoNNG4QC..q4f1
 qqroZYBgoBgdgV4xBmqr..C5UXBA.dvRT96hPMNnmIbBAaUgZUYijNM,7PTvM.UUcQ,7Q1fQ6R
 cR1XZN1b76P76BvP0GuEtogZJiZ,VPMZ1d1F,NlYuIK0mbKJeam44KmUjpA..CLuQA,dNEKqEn
 yKt0Gv4Kt.4Km6DV76B1V1YCAAuHE0HLqk4q.C2.Gpw0bClm0GIG5dOSQ5hWUohVFRo7A3Z0QC
 d1R1,tPB96EuaLsKKEGLLq..kYuqtAggtEN12Yc2iusETPP4aYBZBIeZxAb1bXUQ6P10GsmGES
 LoaqlWKESromaUIgZNMbnoSaZZgUYij7RFXYxB50krMM,dPSb1ZhZ,N761119NKKmYCU1ZBktY
 hdRCRFeWanlV.CbVJCaaqtO99N,tRK458P9Xp76HvQC4KKmuW,tEN19HECor.,NPHvNF9R,dQ9
 vQ99R,7N1XWBgnhgU2ijBBICO4KKw44KKLqk4..ruMMLa2kWEEW0gguMFCa4JCA3ztD..A7UGl
 uggm3YcIC83kIqkUGKmCbm3YoxhU.ZON71CLEm4cI99Nf1AgmlruKqaLEKrtkruqlYZUYCuao3
 Bn961fQ9HtKqqyaZZgUogm,2YgBB0GIGLoKqwghVBDZPNZPNDPOEEGLoghn7PhPNbP8RN1P...
 6JEo.,Fo6G6P8rIqkdK4WKEGrrIAGLo2YoJiV3iUQgchgXVi2Y776jPO.5PMN1,tRkk0mV.Yem
 BAbf9PMJbPN7HlMPgCIUKNNjvQ366dXddR1XYBgohAhPO9XUYC1HEaadNOGrm0Gu.q....o8gA
 ,,...IAG5UU..00.51...kt6JFPOAhn7RKakJCK42YoNMMPmah7Rb96d9OYC2YLBhiZA0mkuaU
 AgiBD1vQy46NOquuaotP4adZitpZBQedhhkFE4KrMPTfQAgYpiVphXhgYdRHPNsQUmtNUZZA3X
 oNNq4sQ,d.b8R79F9fMfH,0GHIU2dR7ON31RN1P..EuKaaBAGZV7G6P2YcggsRgkJ8MNbHXUg2
 YXdPdPNlHKYAbnVyKrI5H0M8plY.qkhCLsQAaql0Guya2BhmVhYejhZ1xdBhfUgVJRiZFny4Wr
 lK466F1aKrMO0mVyYi2Y,RA9vQYijNOd96HvQSqmgA19R99N84EVm482CqrqKsaKqc9,dHT9R,
 NOR9RuKmKKmoAginhgUIgt3YYdR99PT9Q9ntuWB.Edkt4222W4WYGBZucEyIaK2CIoKqlQiUAh
 a3YX3hUAB4aUAgg3icdM99RHvMmKECKo4459R9fQN76ZPMd9O2YoNMR960GmaqnaKu0mr8LECr
 wq4u0..morSrm8551.....2YgtR9XXBgnlk2C...RN1..I8GqkUcogmxBNFuyKRAdC,a0..0mv
 6RFPNkmghZVtdM99RjPN9fP,dNZvP0GIaKrCapRidpiZBZUAgi76dvP,7899SmquC5MP1XW76Z
 nkGKLg,..fGsKaU23...Un,.uap3ikhAC4......YdZpCy2GLR.HdC.HWBI8dPR.ggsNNCbjFq
 oC0GIaqmmGEGLocPf10mrOaWlo6RnnmCLEaKrYC2hdhgmBgmRgcBjd2YoxBdPS2Yop3..yqkYc
 gZBFNGoBI51eIZmg.sCO3yqpUD,HFayqkGqt0moYijlmkwYCYgtlqa4NPO3fQ1fQn96RPMYgUo
 hVFL0mriKE8rm0rrsQ,NOBHuWqosR1vQCruCqlQCBPRNf9P..Z0MH2YcA7UuME83.AZBY7QCu4
 .n1ghj,,dP1XY,uWBEc..jPN23.I558GgVG7R.6PT1C4Qgc,66yKt85VvPR9NEuyaX3higVB..
 qokcFmaCBA0GIO3u4e183.Q5dPSI510.M8P68fuQfPMAjd2Y3phnhimhgn3YoNMdHuW4BPONHE
 UUohVVdphXFmKqt0mkMNl9R.RlYOaiBAAggJC1nw0Go4qtAgUohjphhggh3ioBjUgA.0moGLEk
 uuqkmKuKKtKKmuW7pAUcBAoBqKsG5.EIaqm0moG5BPOZXUIYiIYUAhnNOdvQmqkC559O.aGEaK
 u00GLtKLrCqkGrm6QZPOTfQ,7RTHuWqoc6Rd6RN1HWoBjk76HvQIYUAho,DPOKKr0GugA91.3t
 P7Xg2YjZicdQjPObPN,NO....Grw69,tRFPOsQF1ohj76QA66d9OYhZBgYBhiFFuWUg3RvPdnl
 gAKKmum4KJs0rmQgVRiZ7P99RdPNZvQ,NO0WtFE4KtsMTfPhPNZ9R9HEGrrYBj144RN1d8O996
 1Ht663vPffPCbX3hZlouqn0Gqyqnaql0ml4KrIgZdNyKqKKmuGEa21vQbPRPPNb96d9O1XAhcC
 3YcYitFGaGEqHE0mN0mvWqokoMM7PNXPR19R0GnyKtohjJih7P,NRbHLgVEJiZhV7Yd3pdU.EE
 GKF1mPuGE0GbyKugAV9PHvMH9RNPSCKoK491P..odZNE2Yc6PabgcPOqmMPNFr6NkYMF.H0M1b
 ORV9QTfQdXo3hZdH9uJ,tPVPN4adVaxBGqw.4amltum4CItKqkGbnFEgA4KtEESroGLoYicFl4
 aZNNNPNKKrQCTXoBD99699PdXgsRH9RsPdPMN96RPRPXmFnggg,cPTfN91,78oAkk2YoVkFmKr
 lGLEoAd9OYBRvNQiUwB4KqmKEGahhAb1bnr6RMMkImGE6NS5ohj7N2YYBhh,c9G3OrkmaZ76B1
 99PdXUAgmhgugV0AVZZhoBDH6Jn9Q9P05uPqqmYiBM9XN0HePdXaVU2CU7Qep3CUoV1x7,tMqa
 dVBAVkAVExd7p79eIPM0akdWob8Z1VBAVmAVH3dDlYM1HsAHcEn8J9O1H6BHMGR8J9uFM0fN03
 uHT8HM1HcBHsI98JPM0jN0b8GTWGhc,ZdBAVsAVGhc,Z7an2CIY4IdMAVN0NuHRuFM14nMaEc8
 3UBAVlIa7geU2ejBhi,ztDzF,qk40Jd.229nbIhU23sPplda3q2dmR0WukwM8PsIf9Q.EbK2..
 Ie3,bf9yKEaqtQiZFuyKE4ak,22THuErK4TfMJPN22MSKKEGLL0Wa7RRtQHfSg5ZccX76T96Hv
 Q.od7ZdigV,ZhnxhU2imdRH9NCbnhik3C2YaV1VdphohAB1bf9PM1..9HdKql0GIGrwI5MFM8.
 M1b0sQUCh6..cI.Q6.1HrEtKqlEEyKnUZlw0LKAAIiZZip,H9RAgYZgmltum4..0ZkZ8QcghA6
 6FFRYemBA.am4GYghgohAYBG5GJt44.bnruKEGLo..2YgBhnFs85UXpZB..2ep7O..F,.UdMGR
 vQ9fQdvQ,tM,7RYCogmxhiZiUwB2BG3.2YgViM1VeQqEN0n2CKEaqtohjZC19PZnk66TfP,,mq
 oC5g,.MIaKu2ZZNOUuMGR0AZBgcsBhoRCd119QmaXBgoVisE19PNvQG5GrmgBYijJinFnAA.P1
 QCTfP.UUYBb15OMkkm4kHWqrGrH0GXaKrMOpHtY3WaiNMN12YjZicdQ,dFH1UisE11SpouqUAB
 98SHHc8rrsQ0mva40rk8rkqaohAKKwaa1Vik4.UGtNEtqYY32PXuMHgCam4aYdNOmqoCrmCLEG
 5q4fXUgB0mkOKu66HXctQ8aZphUYB1nmGadphoxBUtp3..YB11F7QplY.I5.qEdghjlt0mk0Gt
 oAoB996dvP0LLAcUQA7HE055HmUaV1Vn7QEL...cA2iu.kI.k4............MPsENPNUcU1x
 B4aYBZBkqktEs8rmOroyquCLqaLE8rmS4MN79658P.GLosPRPNSroEm22.,NNXPR19P,7RTXd2
 YaJCPHukVm4sQ,7PC5q..sKkiI8kWWbk32kmeX3V4,H,g,.Edy4WmI..G56R6QT16RYCIijxho
 tPYCwha,CKqKbohAb965vPPHtaqtaKrSachgV7638P11wYn3YchAum4q..sI9PM2hEtPO3oCeX
 7p7kRo8ghuMHUv.4Km8LRA7UdgVG7R.MPgC0Wg22cQm4O51HmUUwhapAMM7fQ,78BfQMPRtMT9
 NaGEyKn.bPSP1,tRH119N71oiVJiigVB.50UoZemlXKrk66FtPkbyIakIAda3YXBggNNwidVjp
 hUgbUY8fGECru8qtAiphgiZiUYeGB6,7NHvQ4qwCLE4KtKKEaacBhWBhohgYpZigVB.EdkrIiX
 hgExB,,e1UvsMGaExhnJ5HeH.p,UB..2CbPOdPOTHEaKr0WcltyamFECqr66dvPqqkCKoaKrKK
 EaandQfvMkt2YhxhY3Yh2YhxBfXg2YXxhY7I2Yh2YjdN66B1G58qmSai,yKn00QiZ,0mr.Cqr6
 6PvPEEWmqyaiQA7nIum4q..22V1Rmq2YcoBI5Ie,BfU.sCUcFmmGEGrkcC4Id..Hld0LqaanFo
 MOR9Qf9R,dP66HfPdXoxij7Q1fQdvQWqm661fPYiVFLqEr4qqK4bntC4KKmoAggdZichA4KEm4
 2YXtQ0GuMRV9Q2YX,,7RZPMRnoGro69yKt0Gny41963d93d9G3,7R99S0GlKKnyKtKKEG5IC.0
 Wm3YWoZW2YdRC5vPVPO99NGrr2hZFK6OMNMMB1a4.Eu4qo2YcYCIYi.GanRgVJiYhAHd9a2d9O
 HXghAhPNbHu44Kqq0LuaLEGLooBdnm0GuUdphU2hZFEaqtgBhPN796d1c9q..Eu4Kt2YcQAI55
 uPP1am4aIrUoVo3BCorq42YXxBu0..8ro6JUU23ABpVGVU.sCy2,tPf9RplU.sIkV.EtKqte1.
 HN15uPVPOCLEG5CLu8ro66BfQTXdphUYijtPf9R,tRFHqKKECai,HfPAho3Ya,XdBPdMH9R,NJ
 RPO5vP7HEGrrgeIpch2bUogjNPGLLqkdK48rmCLEwBV76HfN,tQC4bHn69,tPZHuMA,NOB96d1
 TPR0ruGLEggZZgZZAdXWVmhCUig,.I8GJosETnqUcgBeXB,iX7FrER.U1VdI550M1ZON.196yq
 o.W450664KE0rk8rk6RYhZRin3YEJeDR6kI0mou4FXhlu66PXUwidViBA0Gr44RN1.UU.7ONbv
 MWmqcC.iXa3CYiuMG.eXD,qEdK4.y4Uj7RFXjJA66jPOcNHnnKKt0bdFEOKs.HfPUhlu66c9P.
 ..YBIhUMPTnmmWa3CcC.Q5HWY,44p,.C3.MG.Pkm.G54KmGaZtQyKn.VfQTvM91QgV,u40mou4
 6FN8HGKqmKLqkVKbmdPm4PvP2YhhinFl2Yn7RGrrYaUYijNOR9Nkm0mk0Wm,EI8rkGLoUcBgit
 MuqtcP0GzAag2YoBD9Hz0GNmGEOrkABEzQag2YjJCBPO66x96fN8,tPZ96V76HvQ8boVZd9C2.
 OKs850moCbdxgixhmhgYp3P.C2.o6m4FdQCKRMSQ5HWiVu.a3Q6UDlmM1.bnksPEt0Wj7RsPUU
 .HHE8bX3YXBgg,EL...ohDFEo8AhYlYGaiZidpA8buMERGcGZBQ8119vQ,Fo6P66TfNOoo.kuY
 idZBTfP9nlyaoBARXVdENvP5HE8rmCqrSKraKxKKmIgt,aImUaVUAhYpZBA7OqrK5N76d130Sm
 t0Gq44KKqKqqK4,,ZHukmk4..EayqkgAPWU2Z7,I583..PWpl48pmUnVk,.kqyapFEuqk6Nu4m
 WkJChXZZgUAho3YdlkmKt.NnkEL0mbGLoKKtS5AB8rmG5cHH0P...PWU.ERU,76..k4.MM...E
 EUY,uGEaInkm.MObHry4NvPEKAho7PTXnFuum4q...y291FNPI5P0Q5.e1..sHUB....sPgA0m
 ouaoVhlu66PXUQgVZBcPc9P...GZkhgU23I5.r,Uu...GpwM1Z0...6Rn9Q0mou4MPgC0000.c
 9..Ahh76FN8YdD,I8.d15PRZfQ66dPOKanBhiVo3BCrwCbZhhU6RFXERcd2YrBAYiVJC9XdpB5
 9PTvML96dPO5Xi6JQC,loC4,7O1fR66ZntyapNOEnYidFd.UcAak24H76dPOEsKKtQiZRgjFLq
 ..UmBjU23YemBj6VghArVgcMQA.AZBAdiRioBggZhnNM,7JZPMW2EKYicdPCqkman7RFHE0551
 6O,tRHXU2CZ1dXnNMN,OGECKLqkYOac3YXBgpNNbnkuaZ3jXhAwB4KEGbV3iUErG4aqtYgd7QN
 nwKKmum4G3RHtgBQCEeEY.uWB..ADyInMGIC5fC4IbI85GRMSg,.4KE05Uo,YC2YYhgnRgm,Z9
 6TfN2B8rmCqr85ZPN5f9q..MJR1q2,78PXu.fXdMJmqrsQGLoMPgC00mGE0LtyKvUUYicBAuqr
 0mrGLoIiUYhjlmMPGqusQaqqwhmZiUAhop3..0LsEICKoEY.58GgVG,6RMRV9QsMC559O1XXVU
 sPZ1VXY,dXX3hi..ktYAFN8A7UB..AghFrGLEy4P1aLE4KqmqrCao7N,7RTHuktQC6O9HsmGEa
 KrIgtZiZd9..YCGprkowgU23ABEd4og00C3.rlbkrKbu..50.Znte1.HlVkm.YCH1B1a4dvP,t
 PGLE.CqroC.HHEO4geIp6.2YolMOnK..RldKKucQCLEwBVVatQC4b1.dXl22YCwhp7Q..8aUYC
 f1c9PMGAgUoAUZJimxBaqtMNdPN59R99NaKrABN76H9R,NOQA6NG5TXUAgiZgUIiZloCbnhgo,
 Zd9P..ZWLFqGKX.2YcA38YDZ7gV7phYBBsQ,FnUmhgUAgmhAuqwwhW,b96d9O19R4KtcQ44,7R
 THl6N9PMwB6NNFlKbU2BhXixBarmGLEWaY3Yo3hZBhmdF.855PMgARl.uS.0U,U.gkF6.6.3gw
 R.,6..NE.0k6U.M.E.3U..4k.kzjom8LrYhBgVI3hd76PHmEEWqkMM,FtaKv4KuKKEaaohAB1N
 loG5wBNHEEmABdXi7PNPSRN1qorGqukZKKtu4,7Q.b96d9O996ZPRR9RHPP0Wp3CYCBvP0GV.2
 YV3CNnlMOQCPM1BOM5POMO9XdphXZhpFEqqmkw0mq4Kr4qnKqqK4Nln4KtAA996yKqUdFKgBUg
 xBaKrYZUQC84HvM,7N9fMSqnsNKrtaKrMPG5HfPB1ABMNlvM.,7OYggBBMM2YqBAyqu2Ygxhrh
 ZghgqhACru05VfQd96BPM51ELqUBIUUYechAL06NTvMf14KuwBaanBhY76d9OHX4xhg76HvQ0L
 t.7HuyanhikFtcFZ1j1,7N9fRwBPPNR9RR7618QV9P.YgZ,Kan3YVJC4KmOrogAGrrginhgU2h
 dxA8LEmqmEEOqk.EEiom.ZvPf9RHfP91dXaVn32R9NOquQgoVVFuaLEqqkabX3BRvN9963PNdv
 REVm4UmhgghAbntuGE8k48ssHpmWb1xhiZimxBNPNZvQRtId9N58RZ9P7ONbvM,MwKKw..umVy
 KrG5EWQC,kVoB1XZJCR,85...CLL.U2V.IS,E.0.G,0.aE.0E.0E..k.8cEE.0.4K.2U52U.2U
 NV.2.5I72.0.E2kT2.,6.IEE...77.2U,2.2.2YXW.6.EQCa.A.A.2U.E,h,6..ED2.0.4.Acm
 BhVZBlk.U.2m,.,.E4WDN.Ntarm3Wj.Jklb6.bf95uP..wW.6.0..2,2.M00.VDah9.lhPnI.n
 D,AzJEsmtp2bmpF.aT....
 --- end of encoding ---
Last edited by Robert on Sat Jan 23, 2016 5:29 pm, edited 1 time in total.
Ivan Denisov
Posts: 1700
Joined: Tue Sep 17, 2013 12:21 am
Location: Russia

Re: Issue # 97, Create Docu for (System)Kernel

Post by Ivan Denisov »

Josef, I agree that we can make 1.7 without all documentation.
However we can make some of documentation.
Also Folds are protecting documentation from been find by search in documentation.
User avatar
Josef Templ
Posts: 2047
Joined: Tue Sep 17, 2013 6:50 am

Re: Issue # 97, Create Docu for (System)Kernel

Post by Josef Templ »

Folds are certainly a good idea for hiding internals from the search results.

For collaboration of multiple authors in the phase of collecting the required
knowledge, I am still convinced that something outside of the repository is
much more productive. Examples are our wiki or Google docs.

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

Re: issue-#97, Create Docu for (System)Kernel

Post by Ivan Denisov »

Include Robert's file into topic branch. The demo version is:
http://blackboxframework.org/unstable/i ... a1.414.zip

If there will be no comments for two days, I have to create the voting.
User avatar
Robert
Posts: 1024
Joined: Sat Sep 28, 2013 11:04 am
Location: Edinburgh, Scotland

Re: issue-#97, Create Docu for (System)Kernel

Post by Robert »

It would be good it someone has a go at the 6 items where I gave up.

Ivan, maybe you can make more sense of the Russian original that I could of the Google translation!
User avatar
Robert
Posts: 1024
Joined: Sat Sep 28, 2013 11:04 am
Location: Edinburgh, Scotland

Re: issue-#97, Create Docu for (System)Kernel

Post by Robert »

Josef, All

Should we fix (easy!) the bug in Kernel.MakeFileName?
User avatar
Robert
Posts: 1024
Joined: Sat Sep 28, 2013 11:04 am
Location: Edinburgh, Scotland

Re: issue-#97, Create Docu for (System)Kernel

Post by Robert »

Ivan

The second paragraph, inside the fold, suggests that errors and omissions are reported to the Community Forum. If you agree with this suggestion maybe you could create the appropriate Topic.

(If not, change the Docu!)
User avatar
Josef Templ
Posts: 2047
Joined: Tue Sep 17, 2013 6:50 am

Re: issue-#97, Create Docu for (System)Kernel

Post by Josef Templ »

This is not yet ready for voting.
I have some comments but need more time to look into the details.

One interesting point is the line spacing of the top part of the document.
Why is it using such a large line spacing and not the default line spacing.
I cannot see any ruler that sets a non standard line spacing.

- Josef
Post Reply