Better late than never (the last couple weeks have been very
busy):
On Tuesday, 23 July 2013 at 21:00:08 UTC, Walter Bright wrote:
It's true that they are based on HTML output. However, and this
is a big however, they need significantly different HTML output
than one puts on a web site. This i
On Sunday, 14 July 2013 at 20:35:45 UTC, Walter Bright wrote:
3. HTML, PDF, Ebook, and CHM outputs are generated from Ddoc.
Walter, with respect, I know you're too smart to be saying
something silly like this. Surely you know that ebooks and CHM
are specially-compiled HTML files. To imply th
Ping! I'm just bumping this thread to see where the status of
integrating pull request 271 is and whether there's anything I
can do to expedite matters. I've noticed that there are some
changes to dlang.org's website source. Are these changes working
towards HTML 5 compliance? (or, at least, th
On Saturday, 29 June 2013 at 11:33:16 UTC, Daniel Murphy wrote:
To be honest, you just have to keep bugging people. I mostly
review
compiler pulls, and I am much much more likely to review
something that
shows up in my inbox than something that sits patiently in the
list. If you
make enough
On Monday, 27 May 2013 at 02:11:00 UTC, Andrei Alexandrescu wrote:
I think it would be great. In particular, an ebook format would
be good.
You may want to wait until
https://github.com/D-Programming-Language/dlang.org/pull/271 is
in. It systematizes macros a lot and it may offer answers to
On Monday, 27 May 2013 at 02:11:00 UTC, Andrei Alexandrescu wrote:
You may want to wait until
https://github.com/D-Programming-Language/dlang.org/pull/271 is
in. It systematizes macros a lot and it may offer answers to
many of your questions.
Andrei
Professor, what sort of feedback would he
Yep, and that seems like a bad idea, so I'll just update the
macros is the xhtml.ddoc file
On Tuesday, 28 May 2013 at 00:50:04 UTC, Jonathan M Davis wrote:
On Tuesday, May 28, 2013 02:14:06 Borden wrote:
Good evening, all,
I'm making a new thread on this because my question isn't
strictly related to the DDoc issues I've mentioned in earlier
threads. Rather, it has
On Tuesday, 28 May 2013 at 00:12:57 UTC, Walter Bright wrote:
On 5/27/2013 4:47 PM, Daniel Murphy wrote:
"Hans W. Uhlig" wrote in message
news:idtvbddofuxwpsbto...@forum.dlang.org...
This also makes compiling LDC with clang rather difficult
DMD is not written in C++11. Turning of the C++11
Good evening, all,
I'm making a new thread on this because my question isn't
strictly related to the DDoc issues I've mentioned in earlier
threads. Rather, it has to do with the dependencies of the
posix.mak file in the dlang.org repo (on GitHub, for greater
clarity):
posix.mak, beginning a
Oh, and another thing: XHTML adopts the XML practice of only
defining the lt, gt and amp entities and no others (like nbsp,
mdash, accented, or non-Latin characters).
Since Unicode is, by and large, universal, I've read that the
recommended practice for including characters not on a standard
On Monday, 27 May 2013 at 03:32:54 UTC, Andrei Alexandrescu wrote:
doc.ddoc is the general skeleton file for defining the online
documentation. html.ddoc contains HTML-specific macros only,
without having anything to do with our site's specific format.
For greater clarity, html.ddoc will produ
On Monday, 27 May 2013 at 03:32:54 UTC, Andrei Alexandrescu wrote:
Yup, you got your work cut for you. Then again, wait til that
diff is merged. It fixes a bunch of problems.
That's OK. As long as I have some guidance on what to do I should
manage. This effort isn't entirely selfless - part of
On Monday, 27 May 2013 at 02:11:00 UTC, Andrei Alexandrescu wrote:
I think it would be great. In particular, an ebook format would
be good.
You may want to wait until
https://github.com/D-Programming-Language/dlang.org/pull/271 is
in. It systematizes macros a lot and it may offer answers to
Before we get too off topic in this thread, is there demand for
an xhtml5.ddoc file? If so, I'd like to make some changes to the
other DDoc files as to minimise code reuse and minimise ambiguity
in 'inherited' macro definitions. I'm willing to put in the time
but I can't do it alone.
If there
Thank you for the suggestions, Juan.
For the purposes of generating a single set of XHTML5 documents,
your advice would work. What I'm trying to do, however, is update
the makefiles for the website source so that ePUB files become a
target.
I worry, therefore, that pumping the DLang spec thr
On Sunday, 26 May 2013 at 06:43:46 UTC, Jonathan M Davis wrote:
So, in questions of whether ddoc is powerful enough or
expressive enough to do something (which appears to be the
thrust of Borden's complaints) aren't affected by it.
How I'd rewrite DDoc from scratch as its own markup language i
On Sunday, 26 May 2013 at 04:57:12 UTC, Borden wrote:
On Sunday, 26 May 2013 at 04:30:46 UTC, Walter Bright wrote:
Again, this is deliberate. Macros are set up so that the last
one overrides all the previous ones, enabling a hierarchy of
them using ddoc files. It's a simple fo
On Sunday, 26 May 2013 at 04:30:46 UTC, Walter Bright wrote:
Again, this is deliberate. Macros are set up so that the last
one overrides all the previous ones, enabling a hierarchy of
them using ddoc files. It's a simple form of 'inheritance'.
And perhaps this point could be clarified (and, wh
On Sunday, 26 May 2013 at 03:56:08 UTC, Jonathan M Davis wrote:
AFAIK, your recent posts on ddoc are the first that anyone has
complained about it in quite some time. There are plenty of
folks who want various improvements to the online documentation,
but doesn't necessarily require doing anythi
On Sunday, 26 May 2013 at 03:51:48 UTC, Walter Bright wrote:
It's not totally random. I've designed one macro language
before (ABEL), and have implemented 3 (ABEL, Make, and C
preprocessor), so I knew what I wanted. Ddoc is very similar to
Make's macro system.
BTW, the C preprocessor takes th
Good evening, Professor,
On Sunday, 26 May 2013 at 02:05:55 UTC, Andrei Alexandrescu wrote:
What vexes me is that all the sugar you propose goes against
what you opened with...
I'm not trying to cause any offence, and I apologise if any of my
phrasing or comments are construed that way. I kno
On Sunday, 26 May 2013 at 01:57:16 UTC, Andrei Alexandrescu wrote:
This is a worthy goal. We manage to generate mobi files for the
spec (and Phobos in a pull request), is the ebook format very
different?
Andrei
Good evening, Professor,
I'm still working through the ePUB standard, but, from
On Sunday, 26 May 2013 at 01:22:17 UTC, Borden wrote:
2) Adopting Latex's rule that a double line break means a new
paragraph. This will effectively make the $(P) macros rampant
in the DLang spec documentation unnecessary.
Oops. I realised that this has already been done. OK, so I guess
I want to keep this discussion focussed on the DLang spec source
code. If we want to debate the features of DDoc, we should do it
in another thread.
However, as not to appear full of cricism but short of ideas, I'm
going to break my own rule and suggest, at least for the purposes
of solving s
On Sunday, 26 May 2013 at 00:28:05 UTC, Andrei Alexandrescu wrote:
To generate several formats from one source, a macro system is
needed. One interesting thing I figured about macro systems is
they're all dirty - they can't be really considered "languages"
because they intermix the programming
On Saturday, 25 May 2013 at 23:28:46 UTC, Jonathan M Davis wrote:
aside from you, I'm not aware of anyone complaining about it
any time recently.
Good evening, Jonathan,
I'm not sure whether you mean that nobody's complained recently
about the spec being in DDoc lately, because, as in my first
I hasten to add that I don't mean to criticise the original
writers of the DLang Spec for writing it in DDoc macros. So far,
I've found the documentation fairly easy to follow (as plain
text) and so I don't want to lose any of that should the spec be
rewritten.
It's also possible (although, i
Good afternoon, all,
I would still like to compile the D Lang Spec into EPUB (and
possibly other formats) but, as we discussed in these threads:
http://forum.dlang.org/thread/bsbdpjyjubfxvmecw...@forum.dlang.org
http://forum.dlang.org/thread/uzdngvjzexukbgkxd...@forum.dlang.org
having the D L
On Thursday, 16 May 2013 at 21:36:03 UTC, Craig Dillabaugh wrote:
Can you provide a reference for the claim that the next
incarnation of TeX is going to be XML based? I did a quick
search and
couldn't turn up anything. Perhaps it was some sort of April
fool's joke
:o)
You're right. I fell
On Thursday, 16 May 2013 at 20:55:18 UTC, Adam D. Ruppe wrote:
I think if you're using a lot of macros, ddoc starts to lose
value because then it is harder to read in the code. The
plainer the text, the better, IMO.
I use ddoc macros only on the individual ($important word) here
and there and
I don't want to turn this thread into a DDoc-bashing rag, but
another observation I've made is that, ironicaly, DDoc macros are
not self documenting. If one types $(SOME_MACRO this, that, the
other) it's not immediately obvious to what 'this,' 'that,' 'the
other' refer without interpreting the
On Thursday, 16 May 2013 at 19:23:37 UTC, Jonathan M Davis wrote:
So, in this particular case, wrapping a C library would be a
stop-gap solution at best. In other cases, it may be the best
way to go, but parsing is one area where D stands out.
Thank you for the insight, Jonathan,
You have the
Good evening, all,
I imagine that this is a sensitive topic, so I'll do my best not
to flame bait and I hope that readers will assume that I mean the
best if I don't word things very diplomatically:
I think that the DDoc spec does an excellent job in creating a
common-sense, low-burdensome w
On Wednesday, 15 May 2013 at 10:39:41 UTC, Russel Winder wrote:
It might be worth noting here that SAX and DOM have not been
distinguished so far in the thread. I would have thought SAX
would be really easy in D.
Indeed. My original question is specfic to XML document
generation in D code, not
Thank you for the feedback, all.
The XML parsing bit is a little important for me because, to
generate the required boilerplate for an EPUB, one necessarily
needs to manipulate XML. The approach I'm thinking for the EPUB
is to write a 'generate EPUB from an OPF' program in D and shove
it into
Thank you very much, Walter, for your reply. I hope I've done it
correctly. I may use this thread to post various questions about
what I find in the repo as I stagger through it. As I consider
how to approach this problem, here are some questions:
1) On the documentation page for std.xml, it s
Good evening, all,
I appreciate the work of the people who've made the D
Documentation, and I've wanted to download an eBook of the
language specification to read offline. I see that the downloads
page has the spec in Mobipocket format, but, according to
wikipedia, it's been superceded by the
38 matches
Mail list logo
