Re: Dlang spec

2021-03-13 Thread Imperatorn via Digitalmars-d-learn

On Saturday, 13 March 2021 at 11:48:47 UTC, Bastiaan Veelo wrote:

On Thursday, 11 March 2021 at 19:38:01 UTC, Imperatorn wrote:

[...]


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.


[...]


Oh, I see. Yes, the best way would obviously be to generate the 
most high quality pdf possible, and maybe even version it so you 
can look at older specs. I just did it quick n dirty 


Re: Dlang spec

2021-03-13 Thread Bastiaan Veelo via Digitalmars-d-learn

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