Wiki improvements

Forum for discussion about the documentation project.
Post Reply
srvaldez
Posts: 3373
Joined: Sep 25, 2005 21:54

Re: Wiki improvements

Post by srvaldez »

hello fxm
I had a quick look, and it looks very good to me, thank you :-)
fxm
Moderator
Posts: 12081
Joined: Apr 22, 2009 12:46
Location: Paris suburbs, FRANCE

Re: Wiki improvements

Post by fxm »

fxm wrote:This is progressing well in my opinion (started since September 2, 2019).
Go see it if the above subject interests you !
New complete sub-section added in the Programmer's Guide:

Multi-Threading
fxm
Moderator
Posts: 12081
Joined: Apr 22, 2009 12:46
Location: Paris suburbs, FRANCE

Re: Wiki improvements

Post by fxm »

@admin,

About 6 months ago, I proposed to close this bug report (which I had created myself), but no reaction since?
#807 'ScreenSet' ordering in main thread is ignored by user threads even created after that!
coderJeff
Site Admin
Posts: 4313
Joined: Nov 04, 2005 14:23
Location: Ontario, Canada
Contact:

Re: Wiki improvements

Post by coderJeff »

fxm wrote:@admin,

About 6 months ago, I proposed to close this bug report (which I had created myself), but no reaction since?
#807 'ScreenSet' ordering in main thread is ignored by user threads even created after that!
There are several gfxlib2 and threading bugs which may or may not be related to each other. Sorry, I've been focused on other areas of the compiler that I did not read this bug. I have read it now. My opinion is that it is worth keeping open until the gfxlib2 and threading bugs are reviewed as a whole. Your note about gfxlib2 using thread local storage (TLS) in #807 reminds that commit 58a795... adds new data that is not in TLS.
coderJeff
Site Admin
Posts: 4313
Joined: Nov 04, 2005 14:23
Location: Ontario, Canada
Contact:

Re: Wiki improvements

Post by coderJeff »

fxm wrote:
fxm wrote:New complete sub-section added in the Programmer's Guide:

Multi-Threading
Wow! I've read the new topics. They are very good with a logical progression of topics and information. Wonderful work, fxm.
D.J.Peters
Posts: 8586
Joined: May 28, 2005 3:28
Contact:

Re: Wiki improvements

Post by D.J.Peters »

coderJeff wrote:Wow! I've read the new topics. They are very good with a logical progression of topics and information. Wonderful work, fxm.
Same here well done.

Joshy
fxm
Moderator
Posts: 12081
Joined: Apr 22, 2009 12:46
Location: Paris suburbs, FRANCE

Re: Wiki improvements

Post by fxm »

About the "Programmer's Guide / Procedures / Procedure Scopes" page

- Is the purpose of describing the scope of variables within a procedure?
  • In this case, already covered by "Programmer's Guide / Declarations / Variable Scope" page.
- Or to speak about the visibility of the procedures through the different modules?
  • But then, a page for a few lines!
    (can be added in the "Procedures Overview" page)
coderJeff
Site Admin
Posts: 4313
Joined: Nov 04, 2005 14:23
Location: Ontario, Canada
Contact:

Re: Wiki improvements

Post by coderJeff »

fxm wrote:- Or to speak about the visibility of the procedures through the different modules?
My guess is that Procedure Scopes title might be reserved for this concept.
- private, visible within a module
- public, visible within an executable
- export, visible between executables

But that's just a guess because I don't remember. And there is nothing on Missing Documentation that gives us a hint.
fxm
Moderator
Posts: 12081
Joined: Apr 22, 2009 12:46
Location: Paris suburbs, FRANCE

Re: Wiki improvements

Post by fxm »

'Assignments' page filled in the Programmer's Guide / Statements and Expressions:
- ProPgAssignments → fxm [new page created]
- CatPgProgrammer → fxm [added link to "Assignments" page]
- PrintToc → fxm [added link to "Assignments" page]

[edit]
'Procedure Scopes' page previously filled in the Programmer's Guide / Procedures.
fxm
Moderator
Posts: 12081
Joined: Apr 22, 2009 12:46
Location: Paris suburbs, FRANCE

Re: Wiki improvements

Post by fxm »

'Constants and Enumerations' page filled in the Programmer's Guide / Variables and Datatypes:
- ProPgEnumerations → fxm [new page created]
- CatPgProgrammer → fxm [added link to "Constants and Enumerations" page]
- PrintToc → fxm [added link to "Constants and Enumerations" page]
fxm
Moderator
Posts: 12081
Joined: Apr 22, 2009 12:46
Location: Paris suburbs, FRANCE

Re: Wiki improvements

Post by fxm »

'Numeric Types' page filled in the Programmer's Guide / Variables and Datatypes:
- ProPgNumericTypes → fxm [new page created]
- CatPgProgrammer → fxm [added link to "Numeric Types" page]
- PrintToc → fxm [added link to "Numeric Types" page]
fxm
Moderator
Posts: 12081
Joined: Apr 22, 2009 12:46
Location: Paris suburbs, FRANCE

Re: Wiki improvements

Post by fxm »

'Strings (string, zstring, and wstring)' page filled in the Programmer's Guide / Variables and Datatypes:
- ProPgStringsTypes → fxm [new page created]
- CatPgProgrammer → fxm [added link to "Strings (string, zstring, and wstring)" page]
- PrintToc → fxm [added link to "Strings (string, zstring, and wstring)" page]

Now I'm taking a big break!
fxm
Moderator
Posts: 12081
Joined: Apr 22, 2009 12:46
Location: Paris suburbs, FRANCE

Re: Wiki improvements

Post by fxm »

'Overview', 'Conditional Compilation' and 'Macros' pages filled in the Programmer's Guide / Preprocessor:
- ProPgPreprocessor → fxm [new page created]
- ProPgConditionalCompilation → fxm [new page created]
- ProPgMacros → fxm [new page created]
fxm
Moderator
Posts: 12081
Joined: Apr 22, 2009 12:46
Location: Paris suburbs, FRANCE

Re: Wiki improvements

Post by fxm »

If someone else could fill in the last two remaining pages "Graphics / External Graphics File Formats" and "Making Binaries / Executables" (it's outside of my skills), it would be nice to finally have a complete Programmer's Guide.

If it is only formatting on the wiki that annoys some, they can write free text on a page that I would format later.
coderJeff
Site Admin
Posts: 4313
Joined: Nov 04, 2005 14:23
Location: Ontario, Canada
Contact:

Re: Wiki improvements

Post by coderJeff »

fxm, your work is fabulous. We are so close to remove the "Work in progress" notice on the programmer's guide. Thank-you.

Yes, would be nice if there was someone besides you or me to help...

For executables topic: I think this should describe the components: (object modules and/or import library and/or library) => executable.

For external graphics file formats topic: what is supported by BLOAD & BSAVE. To be cross platform, the QB/BMP formats that can be loaded/saved are hard coded in the rtlib. So, this is will be a description of what is specifically supported by the rtlib.
Post Reply