www.digitalmars.com         C & C++   DMDScript  

digitalmars.D.learn - Dlang spec

reply Imperatorn <johan_forsberg_86 hotmail.com> writes:
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?
Mar 11 2021
next sibling parent Vinod K Chandran <kcvinu82 gmail.com> writes:
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.
Mar 11 2021
prev sibling next sibling parent reply Bastiaan Veelo <Bastiaan Veelo.net> writes:
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
Mar 13 2021
parent Imperatorn <johan_forsberg_86 hotmail.com> writes:
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 😉
Mar 13 2021
prev sibling parent reply Jordi Sayol <g.sayol gmail.com> writes:
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
Mar 13 2021
parent Imperatorn <johan_forsberg_86 hotmail.com> writes:
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)?
Mar 13 2021