Dlang spec

[Bastiaan Veelo]

On Thursday, 11 March 2021 at 19:38:01 UTC, Imperatorn wrote:
> I created some PDFs (on request) of the dlang spec mobi-file 
> and uploaded them here:
> https://gofile.io/d/ijctZt
>
> Different converters were used, hence multiple files.
>
> Maybe someone can upload a good version on dlang.org and link 
> to it?

The spec is written in ddoc format, and I thought that ddoc was 
able to output in PDF (at least at one point). It didn’t look 
very good and I’m not sure if the functionality is still there. I 
was only able to find an old initiative [1] and two old threads 
discussing the idea [2][3]. I didn’t read all that now.

Regarding uploading, the way this usually goes is that you submit 
a PR against the website. But I’m not sure it will be accepted if 
the process cannot be automated so that the PDFs stay in sync 
with any future changes in the spec without manual intervention.

In my opinion the way to produce quality PDF is through LaTeX. 
Maybe something can be based on adrdox to produce useful LaTeX, 
that would be an interesting project.

— Bastiaan.

[1] https://forum.dlang.org/post/dhq4k6$12tp$1@digitaldaemon.com
[2] https://forum.dlang.org/post/i9fco2$i05$1@digitalmars.com
[3] https://forum.dlang.org/post/kc883a$1b8p$1@digitalmars.com