Author Topic: Update of documentation CB on Windows  (Read 4022 times)

Offline ThierryD

  • Multiple posting newcomer
  • *
  • Posts: 45
Update of documentation CB on Windows
« on: September 11, 2024, 03:27:44 pm »
Hi,

I read online documentation of CB on Wiki, and on the main site Internet of CB.
First constat : many "old" docs and informations not up to date.
It's not a criticism, neither reproach, I know it's a "time consuming" task.
But me, I have this adequate time because I'm to be retired (many chance !).
 
You can exploit all documentations about configuration into CB with many C/C++ compilers on Windows 11 64bits up to you ... on this site (it's free) : https://github.com/tdechaize/tools_tde.
Same "text" with different formats : markdow, pdf and "simple text file" "*.readme".

And, with Wiki format : https://github.com/tdechaize/tools_tde/wiki

I'm not pro about all of these formats, but all described instructions are tested and run on Windows 11 64bits.

Volunteers ?

Sincerly.

Thierry D.


Offline Miguel Gimenez

  • Developer
  • Lives here!
  • *****
  • Posts: 1628
Re: Update of documentation CB on Windows
« Reply #1 on: September 11, 2024, 03:54:16 pm »
Thanks for the information

The wiki can be modified by any user logged in this forum, feel free to update it or mark obsolete pages as such.

Offline ThierryD

  • Multiple posting newcomer
  • *
  • Posts: 45
Re: Update of documentation CB on Windows
« Reply #2 on: September 11, 2024, 05:00:43 pm »
Ok, thank's Miguel.

I see, and update Wiki if possible.

Sincerly.

Thierry D.

Offline ollydbg

  • Developer
  • Lives here!
  • *****
  • Posts: 6025
  • OpenCV and Robotics
    • Chinese OpenCV forum moderator
Re: Update of documentation CB on Windows
« Reply #3 on: September 12, 2024, 04:58:59 pm »
The language of your github repo is not in English language?

For example, the homepage document: https://github.com/tdechaize/tools_tde/tree/main

It is a little hard to understand the content for me.  :(
« Last Edit: September 12, 2024, 05:02:15 pm by ollydbg »
If some piece of memory should be reused, turn them to variables (or const variables).
If some piece of operations should be reused, turn them to functions.
If they happened together, then turn them to classes.

Offline ThierryD

  • Multiple posting newcomer
  • *
  • Posts: 45
Re: Update of documentation CB on Windows
« Reply #4 on: September 12, 2024, 05:32:07 pm »
Hi,

Yes, i cannot hide I'm French ...  ;D, Sorry!
This repository is, generally, clearly destinated to french users ... but I'have created deliberately, on this site, all documentations about configuration of different compilers into CB in English.

You can only select all files that began by "How config ...." on this repo, and click on this files to read contents (it's same content beetween Makdown, PDF or txt format for each category of "compilers/packages"), or download it.

I'm very interested, if you have remarks about contents, because I'm have not "rereader" in my environment to critisize these "first try of documentation".

Thank's for all,

Regards.

Offline ollydbg

  • Developer
  • Lives here!
  • *****
  • Posts: 6025
  • OpenCV and Robotics
    • Chinese OpenCV forum moderator
Re: Update of documentation CB on Windows
« Reply #5 on: September 13, 2024, 11:58:45 am »
In this document:

https://github.com/tdechaize/tools_tde/blob/main/How%20config%20CB%20MinGW64%20GCC%20C_C%2B%2B%20compiler%20into%20CodeBlocks.md

My suggestion is that you need to add some makdown code syntax field for the setting code, otherwise, the generated pdf is hard to read. Thanks.
If some piece of memory should be reused, turn them to variables (or const variables).
If some piece of operations should be reused, turn them to functions.
If they happened together, then turn them to classes.

Offline ThierryD

  • Multiple posting newcomer
  • *
  • Posts: 45
Re: Update of documentation CB on Windows
« Reply #6 on: September 13, 2024, 01:57:58 pm »
Yes, you rigth.

I must reformat with clearly most "end of line" in all Markdown (an after refresh export PDF issued of Obsidian "MD writer").

Thank's.

Thierry D.

Offline ThierryD

  • Multiple posting newcomer
  • *
  • Posts: 45
Re: Update of documentation CB on Windows
« Reply #7 on: September 13, 2024, 07:04:55 pm »
Hi,

After change and reformat MD and PDF (but not about all doc, only middle made) for lisibility, result are most presentable ?

Thank's Ollydbg (or anyone of team CB).

Sincerly.


Offline ThierryD

  • Multiple posting newcomer
  • *
  • Posts: 45
Re: Update of documentation CB on Windows
« Reply #8 on: September 15, 2024, 06:11:29 pm »
Hi

Finalization of reformat MD and PDF files about documentation of CB.
You can see changes at : https://github.com/tdechaize/tools_tde

Regards.

Thierry D.

Offline ollydbg

  • Developer
  • Lives here!
  • *****
  • Posts: 6025
  • OpenCV and Robotics
    • Chinese OpenCV forum moderator
Re: Update of documentation CB on Windows
« Reply #9 on: September 16, 2024, 05:14:28 am »
Hi

Finalization of reformat MD and PDF files about documentation of CB.
You can see changes at : https://github.com/tdechaize/tools_tde

Regards.

Thierry D.

The document is still a bit hard to read for me.

My suggestion:

You need to use some format of markdown to quote the code section.

See here:

https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax

If some piece of memory should be reused, turn them to variables (or const variables).
If some piece of operations should be reused, turn them to functions.
If they happened together, then turn them to classes.

Offline ThierryD

  • Multiple posting newcomer
  • *
  • Posts: 45
Re: Update of documentation CB on Windows
« Reply #10 on: September 16, 2024, 01:53:17 pm »
OK, sorry newbie with MD format.

Thank's for the link. I read contents and apply on documentations.
 
Bye.

Offline ThierryD

  • Multiple posting newcomer
  • *
  • Posts: 45
Re: Update of documentation CB on Windows
« Reply #11 on: September 18, 2024, 03:55:42 pm »
Hi,

I think to have finish to include preconisations suggered by "Ollydbg" into all documents MD and PDF available on my site GitHub
   justify text,
   add new paragraphs,
   add newline or suppress it if necessary to ameliore lisibility,
   add bullet list,
   mark source code with balise "Code" of MD.

But on the found of these contents, nothing remarks ?
 
Thank's.

Thierry D.

Offline ThierryD

  • Multiple posting newcomer
  • *
  • Posts: 45
Re: Update of documentation CB on Windows
« Reply #12 on: September 24, 2024, 04:14:06 pm »
Hi,

Just to illustrate and "for fun", an example of CB project with 64 generations of target on W11 64b, with same C source code (32 and 64 bit, Debug / Release, all declination of "free" compilers C/C++ available on Windows)
If you can configure correctly one compiler C/C++ into CB, then you can configure many...

And, to illustrated also, an example of target DLL in CB project with all of these compilers, two test program with call DLL "implicit" or "explicit" also in CB project, and finally test program in Python (not in CB, but maybe possible) here :
    https://github.com/tdechaize/Test_DLL_ALL

Very very open and simply IDE. Enjoy.

TDE.

Offline ollydbg

  • Developer
  • Lives here!
  • *****
  • Posts: 6025
  • OpenCV and Robotics
    • Chinese OpenCV forum moderator
Re: Update of documentation CB on Windows
« Reply #13 on: September 24, 2024, 04:32:53 pm »
Hi,

Just to illustrate and "for fun", an example of CB project with 64 generations of target on W11 64b, with same C source code (32 and 64 bit, Debug / Release, all declination of "free" compilers C/C++ available on Windows)
If you can configure correctly one compiler C/C++ into CB, then you can configure many...

And, to illustrated also, an example of target DLL in CB project with all of these compilers, two test program with call DLL "implicit" or "explicit" also in CB project, and finally test program in Python (not in CB, but maybe possible) here :
    https://github.com/tdechaize/Test_DLL_ALL

Very very open and simply IDE. Enjoy.

TDE.

Nice work!

Thanks for sharing the experience, especially so many kinds of compilers.  :)
If some piece of memory should be reused, turn them to variables (or const variables).
If some piece of operations should be reused, turn them to functions.
If they happened together, then turn them to classes.

Offline ThierryD

  • Multiple posting newcomer
  • *
  • Posts: 45
Re: Update of documentation CB on Windows
« Reply #14 on: September 25, 2024, 06:01:44 pm »
Thank's much.

Not very important, but with my test DLL into CB, I see that result "Build log" into CB is not the same that messages screened into simple CMD on Windows.
Certains lines appears in CMD (all lines) and missed in "Build log", and sequentiality of these lines is sometimes unrespected (mixed ?) in "Build log" too.

Sincerly.