Page 5 of 8

Re: issue-#100 Review all the existing documentation

Posted: Sun Feb 28, 2016 3:29 pm
by Ivan Denisov
Robert wrote:Does anyone know what is going on? Can / should we avoid this?
To avoid this we should sign executables with certificate.
Like I did for this file:
http://blackboxframework.org/stable/Set ... _SibFU.exe

For signing we need to agree about using Siberian Federal University signature OR register our own organization and pay annually for certificate of BlackBox Framework Center.

I preferred the first option, because it is easy and does not require money. We are discussing this in the thread:
http://forum.blackboxframework.org/view ... f=33&t=115

Re: issue-#100 Review all the existing documentation

Posted: Thu Mar 10, 2016 8:55 pm
by Robert
Ivan Denisov wrote:I preferred the first option, because it is easy and does not require money.
I can support that.

Re: issue-#100 Review all the existing documentation

Posted: Thu Mar 10, 2016 8:58 pm
by Robert
The procedure HostDialog.HookProc has system flag [2]. This is not documented in Platform-Specific Issues.

And should we remove the procedure if it is not used since Windows 95?

Re: issue-#100 Review all the existing documentation

Posted: Thu Mar 10, 2016 9:07 pm
by Robert
Module Dates.

The UTC functions are not documented. There is some documentation, as comments, in the Mod file. This should be moved.

Re: issue-#100 Review all the existing documentation

Posted: Thu Mar 10, 2016 9:10 pm
by Robert
Platform-Specific Issues; section "Using COM without special ... compiler".

There is no longer a special compiler. There is no "add-on product". So some re-wording is wanted.

Re: issue-#100 Review all the existing documentation

Posted: Fri Mar 11, 2016 12:38 pm
by Josef Templ
Robert wrote:The procedure HostDialog.HookProc has system flag [2]. This is not documented in Platform-Specific Issues.

And should we remove the procedure if it is not used since Windows 95?
insert the following line into "System flags for procedures"
callback 2 WinApi callback function; uses __stdcall calling conventions.

I don't know if removing is possible, probably it is. Needs to be tested.
Would be a different issue, though, e.g. "removing dead code".

- Josef

Re: issue-#100 Review all the existing documentation

Posted: Fri Mar 11, 2016 12:41 pm
by Josef Templ
Robert wrote:Module Dates.

The UTC functions are not documented. There is some documentation, as comments, in the Mod file. This should be moved.
Agree.

Re: issue-#100 Review all the existing documentation

Posted: Fri Mar 11, 2016 12:42 pm
by Josef Templ
Robert wrote:Platform-Specific Issues; section "Using COM without special ... compiler".

There is no longer a special compiler. There is no "add-on product". So some re-wording is wanted.
Agree.

Re: issue-#100 Review all the existing documentation

Posted: Fri Mar 11, 2016 2:49 pm
by Ivan Denisov
I made this changes in P-S-I:
http://blackboxframework.org/unstable/i ... a1.449.zip

Robert and others, please, use the last version from topic branch for suggesting changes:
http://blackboxframework.org/unstable/issue-%23100/

Re: issue-#100 Review all the existing documentation

Posted: Fri Mar 11, 2016 2:52 pm
by Ivan Denisov
I revert the links behavior to default, because my solution has two disadvantaged:
1. Links sometimes not clicking
2. Caret is blinking

This is the version I developed. If somebody will improve it somehow, we will return to discussion of this.
Links.odc.zip
(8.7 KiB) Downloaded 2789 times