Hi,

There is now (long overdue) expanded documentation of the user-facing features of GDC online on GCC's documentation site.

https://gcc.gnu.org/onlinedocs/gdc/ (also in PDF or PostScript or an HTML tarball)

The GDC options documentation has been around since the start. What's new is the language reference section, covering code generation choices specific to GDC - what attributes are supported, intrinsics, pragmas, predefined versions, language extensions, missing features and deviations from spec, ...

More could be added or elaborated upon, such as what linkage do different symbols get, mixed language programming with C and C++, the anatomy of a TypeInfo and ModuleInfo object, and so on. This is enough as a first revision just to get it off the ground.

Being a first revision, expect some grammar mistakes, and unclear use of language in some parts throughout.

If any curious reader spots any such mistakes, or thinks there needs to be more clarity in some phrase or paragraph, you can either raise a bugzilla issue against GDC or name and shame me here.

Meanwhile GDC-13 development is still tracking DMD's mainline branch, no plans to switch to a stable D2 release just yet. DMD releases will resume a predictable cadence in the New Year, starting with the 2.102-beta release in January, meaning 2.102-final in February. So the expected D2 version GDC-13 would be using is v2.103.1 by the time our May release comes around.

Regards,
Iain.

On Tuesday, 6 December 2022 at 12:13:59 UTC, Iain Buclaw wrote:

Wow Iain,
this is great stuff!

I had been thinking about something like this for LDC too. We can use this as a blueprint.

-Johan

On Tuesday, 6 December 2022 at 12:13:59 UTC, Iain Buclaw wrote:

There are new documents to learn.

On Tuesday, 6 December 2022 at 12:13:59 UTC, Iain Buclaw wrote:

There is quite some momentum on the GDC front recently. Well done. Much appreciated.

On Tuesday, 6 December 2022 at 12:13:59 UTC, Iain Buclaw wrote:

This is very much appreciated, especially the SIMD portion.

Thanks.

On Tuesday, 6 December 2022 at 12:13:59 UTC, Iain Buclaw wrote:

Nice.

GDC expanded documentation looks really good, and covers everything I could think of, that was previously scattered in many places. Also it is great to see it in PDF format.

Thanks Iain!

On Tuesday, 6 December 2022 at 12:13:59 UTC, Iain Buclaw wrote:

Just now, I had trouble finding this. I don't think there is a pointer on GDC's own website? (https://gdcproject.org/)

cheers,
Johan

On Sunday, 15 January 2023 at 19:00:50 UTC, Johan wrote:

Hi Johan,

Good point, I really need to give a bit more TLC to the site repository.