On Friday, 5 October 2012 at 15:38:13 UTC, mist wrote:
I'd gladly do it but it feels like someones pretty experienced
time is required to actually validate stuff :(
That is where the pull request is great. The hard work of finding
and making the change can be done by the many, and review can b
Reviving old topic.
I've been recently checking few general dlang.org pages like
http://dlang.org/cpptod.html and noticed that there is plenty of
stuff that is either deprecated ( like typedef ) or not really
advised ( like C-style function type declarations ). Probably all
language docs need
http://forum.dlang.org/thread/k4f4tp$8p4$1...@digitalmars.com#post-k4fdsc:24v9u:241:40digitalmars.com
vibe.d got clickable types in documentation, perhaps this could
be somehow integrated into phobos docs?
On Saturday, 29 September 2012 at 16:34:41 UTC, Andrei
Alexandrescu wrote:
On 9/29/12 11:30 AM, Mr. Anonymous wrote:
I think documentation is really important, and something has
to be done
about it. How can a newcomer get started with D when he
doesn't have a
readable documentation of Phobos?
On Monday, 1 October 2012 at 19:39:35 UTC, Piotr Szturmaj wrote:
Mr. Anonymous wrote:
OK, I looked at it, and I saw that the links are generated by
javascript.
So I decided to try and write a better javascript function for
creating
links.
Here's what I came up with:
The JS code: http://pasteb
Mr. Anonymous wrote:
OK, I looked at it, and I saw that the links are generated by javascript.
So I decided to try and write a better javascript function for creating
links.
Here's what I came up with:
The JS code: http://pastebin.com/Pz4fb4JR
Screenshots: http://i.imgur.com/gwxrI.png, http://i.
On Saturday, 29 September 2012 at 15:29:46 UTC, Mr. Anonymous
wrote:
Hi guys.
I was browsing the book "Programming in D" by Ali Çehreli. It
was pretty much clear, and then I stumbled upon this on page 89:
20.9 Exercises
1. Browse the documentations of the std.string, std.array,
std.algorithm,
I think documentation is really important, and something has to
be done about it. How can a newcomer get started with D when he
doesn't have a readable documentation of Phobos?
A couple of random things I'd like to see:
1. Improve index.html. It's the first thing new users are likely
to see a
On Sun, 30 Sep 2012 07:02:15 -0400, Jacob Carlborg wrote:
On 2012-09-30 04:17, Adam D. Ruppe wrote:
On Saturday, 29 September 2012 at 17:20:48 UTC, Dmitry Olshansky wrote:
Agreed. What's needed to make it a reality ?
Need to integrate my helper program into the website build process.
Is i
On 2012-10-01 04:55, Adam D. Ruppe wrote:
A problem I've been having ever since I started doing professional
programming is that my focus time is a lot less than it used to be.
I used to be able to sit down and spend a full month on one single
thing, very few distractions as the monday return t
On 2012-09-30 21:23, Adam D. Ruppe wrote:
What hurts me most in doing it is just that it is C++... I know my way
around the compiler reasonably well. Not great but good enough to get
by... but doing new code is just such a pain. Little things like no
auto, forward declarations, weak sauce arrays
On Sunday, 30 September 2012 at 20:24:17 UTC, Andrei Alexandrescu
wrote:
It would be great if we had some more finalized things.
A problem I've been having ever since I started doing
professional programming is that my focus time is a lot less than
it used to be.
I used to be able to sit do
On 9/30/12 11:53 AM, Adam D. Ruppe wrote:
On Sunday, 30 September 2012 at 15:41:46 UTC, Adam D. Ruppe wrote:
If you want to write the code, feel free.
I'm sorry, this probably came across as rude, but the answer for why not
do it the right way is simply that the right way takes time and I don'
On Sunday, 30 September 2012 at 17:27:43 UTC, Jacob Carlborg
wrote:
I would like to fix it but I think the DMD code base is quite
horrible and just a big mess.
What hurts me most in doing it is just that it is C++... I know
my way around the compiler reasonably well. Not great but good
enough
On 2012-09-30 17:53, Adam D. Ruppe wrote:
On Sunday, 30 September 2012 at 15:41:46 UTC, Adam D. Ruppe wrote:
If you want to write the code, feel free.
I'm sorry, this probably came across as rude, but the answer for why not
do it the right way is simply that the right way takes time and I don'
On 2012-09-30 17:37, Adam D. Ruppe wrote:
On Sunday, 30 September 2012 at 15:31:30 UTC, Jacob Carlborg wrote:
And we're back at the fact that we need a compiler library.
Not necessarily... the ddoc comments are available in the compiler's
json output (use -X and -D together in dmd). It doesn't
On Sunday, 30 September 2012 at 15:41:46 UTC, Adam D. Ruppe wrote:
If you want to write the code, feel free.
I'm sorry, this probably came across as rude, but the answer for
why not do it the right way is simply that the right way takes
time and I don't feel like putting it in. Apparently not
On Sunday, 30 September 2012 at 15:36:50 UTC, Jacob Carlborg
wrote:
What's wrong with "hey, lets fix this the right way for a
change".
If you want to write the code, feel free.
On Sunday, 30 September 2012 at 15:31:30 UTC, Jacob Carlborg
wrote:
And we're back at the fact that we need a compiler library.
Not necessarily... the ddoc comments are available in the
compiler's json output (use -X and -D together in dmd). It
doesn't do syntax highlighting and could offer a
On 2012-09-30 15:49, Adam D. Ruppe wrote:
Eh, maybe. I just find doing fancier things inside the compiler to be a
pain in the butt. Basically D > C++. And it is harder to get code into
dmd than it is to just do your own thing.
But really what matters is that we get something that doesn't suck
r
On 2012-09-30 17:00, foobar wrote:
Which is why the doc generation utility should be a separate tool and
not built directly into the compiler. I understand Walter's desire to
have batteries included with D (doc generation, unit-testing, profiling,
...) but that does not mean they should be welde
On Sunday, 30 September 2012 at 13:48:41 UTC, Adam D. Ruppe wrote:
On Sunday, 30 September 2012 at 11:01:50 UTC, Jacob Carlborg
wrote:
Is it just me that thinks that having a tool that fixes the
generated documentation is ridiculous. The compiler should be
modified to generate the documentation
On Sunday, 30 September 2012 at 11:01:50 UTC, Jacob Carlborg
wrote:
Is it just me that thinks that having a tool that fixes the
generated documentation is ridiculous. The compiler should be
modified to generate the documentation we want to have.
Eh, maybe. I just find doing fancier things insi
On Sunday, 30 September 2012 at 11:22:02 UTC, Jonathan M Davis
wrote:
The main problem IMHO is how the links are generated,
making it impossible to have links to symbols with the
same name in the same module
Yeah, I did a pull request to dmd to add a new macro to fix this,
but I also included
On Sunday, 30 September 2012 at 10:08:17 UTC, Dmitry Olshansky
wrote:
I'll give it a whirl.
cool. BTW search the code for the word "HACK". There's one that
rewrites css links to be absolute and one that adds some inline
style.
Those are there so I can test it from a different domain that
d
While we're speaking about docs improvement, I believe there is
one more thing that could use a fix - clickable identifiers. I
don't know how much of an effort it would require, so consider it
a wishlist, but for stuff like:
static @property @safe TickDuration currAppTick();
TickDuration shou
On Sunday, September 30, 2012 13:02:15 Jacob Carlborg wrote:
> On 2012-09-30 04:17, Adam D. Ruppe wrote:
> > On Saturday, 29 September 2012 at 17:20:48 UTC, Dmitry Olshansky wrote:
> >> Agreed. What's needed to make it a reality ?
> >
> > Need to integrate my helper program into the website build
On 2012-09-30 04:17, Adam D. Ruppe wrote:
On Saturday, 29 September 2012 at 17:20:48 UTC, Dmitry Olshansky wrote:
Agreed. What's needed to make it a reality ?
Need to integrate my helper program into the website build process.
Is it just me that thinks that having a tool that fixes the gener
On 30-Sep-12 06:17, Adam D. Ruppe wrote:
On Saturday, 29 September 2012 at 17:20:48 UTC, Dmitry Olshansky wrote:
Agreed. What's needed to make it a reality ?
Need to integrate my helper program into the website build process.
Program here:
http://arsdnet.net/d-web-site/improveddoc.d
libs nee
On Sunday, September 30, 2012 04:17:59 Adam D. Ruppe wrote:
> When I tried this earlier, I couldn't even get the basic website
> to build on my box from github. I think it needs github phobos
> too but meh, I moved on to something else and never got back to
> it.
Unless something's changed recentl
On Saturday, 29 September 2012 at 17:20:48 UTC, Dmitry Olshansky
wrote:
Agreed. What's needed to make it a reality ?
Need to integrate my helper program into the website build
process.
Program here:
http://arsdnet.net/d-web-site/improveddoc.d
libs needed
https://github.com/adamdruppe/misc-s
On 29-Sep-12 21:13, deadalnix wrote:
Le 29/09/2012 19:09, Adam D. Ruppe a écrit :
On Saturday, 29 September 2012 at 17:03:26 UTC, monarch_dodra wrote:
Well, they *are* better than nothing at all. Sure, in the best of
worlds, we'd have lovingly hand written indexes and documentation,
such as for
Le 29/09/2012 19:09, Adam D. Ruppe a écrit :
On Saturday, 29 September 2012 at 17:03:26 UTC, monarch_dodra wrote:
Well, they *are* better than nothing at all. Sure, in the best of
worlds, we'd have lovingly hand written indexes and documentation,
such as for std_algorithm. However, for those mod
On Saturday, 29 September 2012 at 17:03:26 UTC, monarch_dodra
wrote:
Well, they *are* better than nothing at all. Sure, in the best
of worlds, we'd have lovingly hand written indexes and
documentation, such as for std_algorithm. However, for those
modules that *don't* have that hand written doc
On Saturday, 29 September 2012 at 16:34:41 UTC, Andrei
Alexandrescu wrote:
On 9/29/12 11:30 AM, Mr. Anonymous wrote:
I think documentation is really important, and something has
to be done
about it. How can a newcomer get started with D when he
doesn't have a
readable documentation of Phobos?
On 9/29/12 11:30 AM, Mr. Anonymous wrote:
I think documentation is really important, and something has to be done
about it. How can a newcomer get started with D when he doesn't have a
readable documentation of Phobos?
Agree. It's high time we replace the silly litany of names at the top
with
And there's also the D Templates Tutorial at:
https://github.com/PhilippeSigaud/D-templates-tutorial/blob/master/dtemplates.pdf
(click "View Raw" on that page)
On Saturday, 29 September 2012 at 15:53:17 UTC, Mr. Anonymous
wrote:
Don't get me wrong, I'm not saying somebody owes me something.
I love D and appreciate the effort the community puts in it,
otherwise I probably wouldn't write this post.
I'm just saying that, in my opinion, it's a high prior
On Saturday, 29 September 2012 at 15:29:46 UTC, Mr. Anonymous
wrote:
Hi guys.
I was browsing the book "Programming in D" by Ali Çehreli. It
was pretty much clear, and then I stumbled upon this on page 89:
20.9 Exercises
1. Browse the documentations of the std.string, std.array,
std.algorithm,
On Saturday, 29 September 2012 at 15:46:36 UTC, MattCoder wrote:
On Saturday, 29 September 2012 at 15:29:46 UTC, Mr. Anonymous
wrote:
1. Browse the documentations of the std.string, std.array,
std.algorithm, and std.range modules.
OK, let's open the D website and browse the documentation of
s
On Saturday, 29 September 2012 at 15:29:46 UTC, Mr. Anonymous
wrote:
1. Browse the documentations of the std.string, std.array,
std.algorithm, and std.range modules.
OK, let's open the D website and browse the documentation of
std.string:
http://dlang.org/phobos/std_string.html
What do we se
On 09/29/2012 05:30 PM, Mr. Anonymous wrote:
Hi guys.
I was browsing the book "Programming in D" by Ali Çehreli. It was pretty
much clear, and then I stumbled upon this on page 89:
20.9 Exercises
1. Browse the documentations of the std.string, std.array,
std.algorithm, and std.range modules.
Hi guys.
I was browsing the book "Programming in D" by Ali Çehreli. It
was pretty much clear, and then I stumbled upon this on page 89:
20.9 Exercises
1. Browse the documentations of the std.string, std.array,
std.algorithm, and std.range modules.
OK, let's open the D website and browse the
43 matches
Mail list logo