Thread overview
Dlang spec
Mar 11, 2021
Imperatorn
Mar 11, 2021
Vinod K Chandran
Mar 13, 2021
Bastiaan Veelo
Mar 13, 2021
Imperatorn
Mar 13, 2021
Jordi Sayol
Mar 13, 2021
Imperatorn
March 11, 2021
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?
March 11, 2021
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?

Thanks for your effort.
March 13, 2021
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
March 13, 2021
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 😉
March 13, 2021
El 11/3/21 a les 20:38, Imperatorn via Digitalmars-d-learn ha escrit:
> 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?
> 

On d-apt <https://d-apt.sourceforge.io/> there are some dlang spec files in chm, epub, mobi and pdf format.

There are also the dmd spec and Phohos library reference, for each release, in html format.

Regards,
Jordi
March 13, 2021
On Saturday, 13 March 2021 at 13:06:46 UTC, Jordi Sayol wrote:
> El 11/3/21 a les 20:38, Imperatorn via Digitalmars-d-learn ha escrit:
>> 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?
>> 
>
> On d-apt <https://d-apt.sourceforge.io/> there are some dlang spec files in chm, epub, mobi and pdf format.
>
> There are also the dmd spec and Phohos library reference, for each release, in html format.
>
> Regards,
> Jordi

Yeah, saw that after I had uploaded them already 🙄

Do you know how those files are generated and when (on each release)?