issue-#100 Review all the existing documentation

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 »

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
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 preferred the first option, because it is easy and does not require money.
I can support that.
Last edited by Robert on Fri Mar 11, 2016 9:06 am, edited 1 time in total.
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 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?
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 »

Module Dates.

The UTC functions are not documented. There is some documentation, as comments, in the Mod file. This should be moved.
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 »

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.
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 »

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
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 »

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.
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 »

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.
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 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/
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 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 236 times
Post Reply