Re: Documentation for any* dub package, any version

2018-03-07 Thread Adam D. Ruppe via Digitalmars-d-announce
On Wednesday, 7 March 2018 at 22:47:48 UTC, bauss wrote: How would you go about updating docs? Either go to the url for the specific version you want like http://diamond.dpldocs.info/v2.7.0/index.html and it will download (once dub scrapes it anyway) or ping me and I'll manually update the

Re: Documentation for any* dub package, any version

2018-03-07 Thread bauss via Digitalmars-d-announce
On Friday, 2 March 2018 at 00:04:10 UTC, Adam D. Ruppe wrote: On Thursday, 1 March 2018 at 11:00:15 UTC, Jonas Drewsen wrote: Would be cool if you could add support for creating docs from any dub project stored on github and not only the ones on code.dlang.org. That might be possible too.

Re: Documentation for any* dub package, any version

2018-03-04 Thread Colin via Digitalmars-d-announce
On Monday, 26 February 2018 at 14:59:07 UTC, Adam D. Ruppe wrote: Many of you will already know this from the other thread or from my twitter, but I just added a on-demand downloader to my dpldocs.info domain to fetch and build docs for any* dub package. Simply go to

Re: Documentation for any* dub package, any version

2018-03-03 Thread Adam D. Ruppe via Digitalmars-d-announce
On Saturday, 3 March 2018 at 13:17:15 UTC, Martin Nowak wrote: Why would you need to have that in RAM instead of leaving it to the db cache layer? The search "database" right now is an XML file. Keep in mind this is a static site generator meant to just work offline or when pushed to github

Re: Documentation for any* dub package, any version

2018-03-03 Thread Martin Nowak via Digitalmars-d-announce
On 03/03/2018 04:01 AM, Adam D. Ruppe wrote: > full-text search over a select group of packages (notably including > Phobos) with a pretty fast response... just it eats ~1.5 GB to keep two > copies of its database in memory in order to give those fast responses > concurrently. The instance I have

Re: Documentation for any* dub package, any version

2018-03-02 Thread Adam D. Ruppe via Digitalmars-d-announce
Gtk-d and DWT are both too big to automatically build on the server, but I did some manual work on them. DWT: http://dwt.dpldocs.info/org.eclipse.swt.widgets.html GTK-D: http://dpldocs.info/experimental-docs/gtk.Application.Application.html The gtk one has me translating some syntax from C

Re: Documentation for any* dub package, any version

2018-03-02 Thread Adam D. Ruppe via Digitalmars-d-announce
On Saturday, 3 March 2018 at 02:12:52 UTC, Martin Nowak wrote: A central doc provider could have some benefit, e.g. searching across different libraries. Yeah, I have code for that written for select libraries already (on the main dpldocs.info site), but haven't opened it up to the full dub

Re: Documentation for any* dub package, any version

2018-03-02 Thread Martin Nowak via Digitalmars-d-announce
On 02/26/2018 03:59 PM, Adam D. Ruppe wrote: > http://dplug.dpldocs.info/v6.0.22/dplug.html > > 6.0.22 of the dplug package. Cool stuff Adam, thx. Was thinking about this for a while myself. A central doc provider could have some benefit, e.g. searching across different libraries. Compared to

Re: Documentation for any* dub package, any version

2018-03-01 Thread Adam D. Ruppe via Digitalmars-d-announce
If you guys have bug reports or feature requests, you can put it on the github too if you like: https://github.com/adamdruppe/dpldocs/issues

Re: Documentation for any* dub package, any version

2018-03-01 Thread Adam D. Ruppe via Digitalmars-d-announce
On Thursday, 1 March 2018 at 11:00:15 UTC, Jonas Drewsen wrote: Would be cool if you could add support for creating docs from any dub project stored on github and not only the ones on code.dlang.org. That might be possible too. BTW I just put the server code up on github

Re: Documentation for any* dub package, any version

2018-03-01 Thread Jonas Drewsen via Digitalmars-d-announce
On Monday, 26 February 2018 at 14:59:07 UTC, Adam D. Ruppe wrote: Many of you will already know this from the other thread or from my twitter, but I just added a on-demand downloader to my dpldocs.info domain to fetch and build docs for any* dub Would be cool if you could add support for

Re: Documentation for any* dub package, any version

2018-02-27 Thread Nick Sabalausky via Digitalmars-d-announce
On Tuesday, 27 February 2018 at 15:49:37 UTC, Basile B. wrote: At first glance i can say that this will work perfectly for DUB packages. Once DCD gives a file, the IDE just have to look the parent folders to get the SemVer tag. If the file is in a git repository things might be more

Re: Documentation for any* dub package, any version

2018-02-27 Thread David Gileadi via Digitalmars-d-announce
On 2/27/18 2:59 PM, Adam D. Ruppe wrote: On Tuesday, 27 February 2018 at 16:39:08 UTC, David Gileadi wrote: Markdown actually supports two kinds of links: inline links (which you describe above and I'm very happy you support) and reference links [1]. Oh, I have something similar to that too.

Re: Documentation for any* dub package, any version

2018-02-27 Thread David Gileadi via Digitalmars-d-announce
On 2/27/18 3:18 PM, David Gileadi wrote: On 2/27/18 2:59 PM, Adam D. Ruppe wrote: On Tuesday, 27 February 2018 at 16:39:08 UTC, David Gileadi wrote: Markdown actually supports two kinds of links: inline links (which you describe above and I'm very happy you support) and reference links [1].

Re: Documentation for any* dub package, any version

2018-02-27 Thread Adam D. Ruppe via Digitalmars-d-announce
On Tuesday, 27 February 2018 at 16:39:08 UTC, David Gileadi wrote: Markdown actually supports two kinds of links: inline links (which you describe above and I'm very happy you support) and reference links [1]. Oh, I have something similar to that too.

Re: Documentation for any* dub package, any version

2018-02-27 Thread David Gileadi via Digitalmars-d-announce
On 2/27/18 9:21 AM, Adam D. Ruppe wrote: On Tuesday, 27 February 2018 at 16:00:26 UTC, David Gileadi wrote: Out of curiosity, what prompted [symbol|alt text] instead of going with the Markdown construct of [alt text][symbol]? Well, markdown is [alt text](url), and adrdox actually DOES support

Re: Documentation for any* dub package, any version

2018-02-27 Thread Adam D. Ruppe via Digitalmars-d-announce
On Tuesday, 27 February 2018 at 16:00:26 UTC, David Gileadi wrote: Out of curiosity, what prompted [symbol|alt text] instead of going with the Markdown construct of [alt text][symbol]? Well, markdown is [alt text](url), and adrdox actually DOES support that as well:

Re: Documentation for any* dub package, any version

2018-02-27 Thread David Gileadi via Digitalmars-d-announce
On 2/26/18 12:51 PM, Adam D. Ruppe wrote: ... I just have a built-in, simple, unified syntax: [symbol|alt text] where alt text is optional and symbol is looked up according to D scope rules. (you can also define custom symbols for things like author name links). I link to the source

Re: Documentation for any* dub package, any version

2018-02-27 Thread Basile B. via Digitalmars-d-announce
On Tuesday, 27 February 2018 at 14:42:11 UTC, Adam D. Ruppe wrote: On Tuesday, 27 February 2018 at 10:02:13 UTC, Basile B. wrote: Awesome work. IDEs could use this, i don't know how yet but i'll maybe try something one day. Yeah, webfreak was talking to me about that on irc and I've had

Re: Documentation for any* dub package, any version

2018-02-27 Thread Adam D. Ruppe via Digitalmars-d-announce
On Tuesday, 27 February 2018 at 10:02:13 UTC, Basile B. wrote: Awesome work. IDEs could use this, i don't know how yet but i'll maybe try something one day. Yeah, webfreak was talking to me about that on irc and I've had people ask me about the main dpldocs site being an api (to which I

Re: Documentation for any* dub package, any version

2018-02-27 Thread Adam D. Ruppe via Digitalmars-d-announce
On Tuesday, 27 February 2018 at 09:17:21 UTC, bauss wrote: Nvm, I see how stupid I was. Nah, bad UX. I give myself some slack cuz I slapped this together in just a few spare hours over the weekend, but the error message also could have pointed you back to the site index. That just took 3

Re: Documentation for any* dub package, any version

2018-02-27 Thread Basile B. via Digitalmars-d-announce
On Monday, 26 February 2018 at 14:59:07 UTC, Adam D. Ruppe wrote: Many of you will already know this from the other thread or from my twitter, but I just added a on-demand downloader to my dpldocs.info domain to fetch and build docs for any* dub package. Simply go to

Re: Documentation for any* dub package, any version

2018-02-27 Thread aberba via Digitalmars-d-announce
On Tuesday, 27 February 2018 at 09:17:21 UTC, bauss wrote: On Tuesday, 27 February 2018 at 09:16:12 UTC, bauss wrote: On Monday, 26 February 2018 at 14:59:07 UTC, Adam D. Ruppe wrote: [...] Tried with http://diamond.dpldocs.info/arsd.html and it gives a 404 Nvm, I see how stupid I was.

Re: Documentation for any* dub package, any version

2018-02-27 Thread bauss via Digitalmars-d-announce
On Tuesday, 27 February 2018 at 09:16:12 UTC, bauss wrote: On Monday, 26 February 2018 at 14:59:07 UTC, Adam D. Ruppe wrote: [...] Tried with http://diamond.dpldocs.info/arsd.html and it gives a 404 Nvm, I see how stupid I was.

Re: Documentation for any* dub package, any version

2018-02-27 Thread bauss via Digitalmars-d-announce
On Monday, 26 February 2018 at 14:59:07 UTC, Adam D. Ruppe wrote: Many of you will already know this from the other thread or from my twitter, but I just added a on-demand downloader to my dpldocs.info domain to fetch and build docs for any* dub package. Simply go to

Re: Documentation for any* dub package, any version

2018-02-26 Thread Martin Tschierschke via Digitalmars-d-announce
On Tuesday, 27 February 2018 at 02:07:34 UTC, Norm wrote: On Monday, 26 February 2018 at 14:59:07 UTC, Adam D. Ruppe wrote: Many of you will already know this from the other thread or from my twitter, but I just added a on-demand downloader to my dpldocs.info domain to fetch and build docs for

Re: Documentation for any* dub package, any version

2018-02-26 Thread H. S. Teoh via Digitalmars-d-announce
On Tue, Feb 27, 2018 at 03:07:10AM +, psychoticRabbit via Digitalmars-d-announce wrote: [...] > Uhh? I don't get...why coders need to write documentation? [...] To communicate with other coders who will need to read and maintain the code. And by "other coders", of course, I mean yourself, 2

Re: Documentation for any* dub package, any version

2018-02-26 Thread Adam D. Ruppe via Digitalmars-d-announce
On Monday, 26 February 2018 at 19:30:38 UTC, WebFreak001 wrote: amazing! I planned on adding a documentation tab in the current dub package overhaul, but I wasn't sure on where to get the data from, if I can add this to embed on the dub website (ala iframe) it would make a lot much easier!

Re: Documentation for any* dub package, any version

2018-02-26 Thread psychoticRabbit via Digitalmars-d-announce
On Tuesday, 27 February 2018 at 02:57:08 UTC, Adam D. Ruppe wrote: Saturday morning, a user complained that several leading dub packages had poor documentation, if they could find it at all. That's changing, right now. Before long, packages without docs are going to suffer. This will put

Re: Documentation for any* dub package, any version

2018-02-26 Thread Adam D. Ruppe via Digitalmars-d-announce
On Tuesday, 27 February 2018 at 01:53:23 UTC, H. S. Teoh wrote: It's a sorry state of affairs. I dream of the day when I can just write code and documentation as-is, and downstream users can just use whatever doc formatting system they like and it will all Just Work(tm). Join me, and

Re: Documentation for any* dub package, any version

2018-02-26 Thread Jonathan M Davis via Digitalmars-d-announce
On Tuesday, February 27, 2018 02:26:49 Adam D. Ruppe via Digitalmars-d- announce wrote: > But even you, who know how to use ddoc very well and have > obviously spent some time on it here, made trivial mistakes here > that just don't happen with adrdox. Any time you do something manually instead

Re: Documentation for any* dub package, any version

2018-02-26 Thread Adam D. Ruppe via Digitalmars-d-announce
On Tuesday, 27 February 2018 at 02:07:34 UTC, Norm wrote: This is really awesome. It would be really cool if this could feedback a coverage score to code.dlang.org that indicates the level of documentation in a library. Something like the % of functions/classes/modules that are documented and

Re: Documentation for any* dub package, any version

2018-02-26 Thread Adam D. Ruppe via Digitalmars-d-announce
On Tuesday, 27 February 2018 at 01:43:55 UTC, Jonathan M Davis wrote: Well, then basically, projects are going to need to decide to go with adrdox over ddoc if they want clean documentation. That's right, and I can't imagine anyone is going to put hours of work into ddoc when they can spend

Re: Documentation for any* dub package, any version

2018-02-26 Thread Jonathan M Davis via Digitalmars-d-announce
On Monday, February 26, 2018 17:53:23 H. S. Teoh via Digitalmars-d-announce wrote: > On Mon, Feb 26, 2018 at 06:43:55PM -0700, Jonathan M Davis via > Digitalmars-d-announce wrote: [...] > > > Well, then basically, projects are going to need to decide to go with > > adrdox over ddoc if they want

Re: Documentation for any* dub package, any version

2018-02-26 Thread Norm via Digitalmars-d-announce
On Monday, 26 February 2018 at 14:59:07 UTC, Adam D. Ruppe wrote: Many of you will already know this from the other thread or from my twitter, but I just added a on-demand downloader to my dpldocs.info domain to fetch and build docs for any* dub package. [...] This is really awesome. It

Re: Documentation for any* dub package, any version

2018-02-26 Thread H. S. Teoh via Digitalmars-d-announce
On Mon, Feb 26, 2018 at 06:43:55PM -0700, Jonathan M Davis via Digitalmars-d-announce wrote: [...] > Well, then basically, projects are going to need to decide to go with > adrdox over ddoc if they want clean documentation. They'll probably > get better documentation with adrdox than the default

Re: Documentation for any* dub package, any version

2018-02-26 Thread Jonathan M Davis via Digitalmars-d-announce
On Monday, February 26, 2018 19:51:27 Adam D. Ruppe via Digitalmars-d- announce wrote: > On Monday, 26 February 2018 at 15:49:19 UTC, Jonathan M Davis > > wrote: > > Yeah. Any project that uses .ddoc files to define additional > > macros isn't going to work properly > > It is actually more than

Re: Documentation for any* dub package, any version

2018-02-26 Thread Adam D. Ruppe via Digitalmars-d-announce
On Monday, 26 February 2018 at 21:16:07 UTC, Antonio Corbi wrote: Trying it onto gtk-d got an error saying to send you the failing link, so here you are : gtk-d is actually just too big for this, so it timed out. But I also already made gtkd docs on the main site:

Re: Documentation for any* dub package, any version

2018-02-26 Thread Antonio Corbi via Digitalmars-d-announce
On Monday, 26 February 2018 at 14:59:07 UTC, Adam D. Ruppe wrote: Many of you will already know this from the other thread or from my twitter, but I just added a on-demand downloader to my dpldocs.info domain to fetch and build docs for any* dub package. Hi Adam! Thanks for this superb

Re: Documentation for any* dub package, any version

2018-02-26 Thread Adam D. Ruppe via Digitalmars-d-announce
On Monday, 26 February 2018 at 20:15:13 UTC, aliak wrote: Awesome. good start at least, and just to throw an approach out there for your consideration, a .adrdox.yml file with a include/exclude/style/etc keys might be a good way to go. Yeah, that's basically what I was thinking (though not

Re: Documentation for any* dub package, any version

2018-02-26 Thread aliak via Digitalmars-d-announce
On Monday, 26 February 2018 at 18:17:51 UTC, Adam D. Ruppe wrote: Oh, fixed now. since there's no ddoc at all in that file, it should have been skipped, I just had a testing "return true;" in the method I forgot to remove. Nice :D Looks good. ketmar sent me a patch to parse a .adrdox_ignore

Re: Documentation for any* dub package, any version

2018-02-26 Thread Adam D. Ruppe via Digitalmars-d-announce
On Monday, 26 February 2018 at 15:49:19 UTC, Jonathan M Davis wrote: Yeah. Any project that uses .ddoc files to define additional macros isn't going to work properly It is actually more than that: I don't support user-defined ddoc macros at all. About 3/4 of the ones I've seen are just link

Re: Documentation for any* dub package, any version

2018-02-26 Thread Adam D. Ruppe via Digitalmars-d-announce
On Monday, 26 February 2018 at 19:47:29 UTC, Jesse Phillips wrote: It also would be good for you to like to the Dub page and Git Repo. Yeah, its on my list. The project homepage from the dub.json too. Couldn't you provide a robots.txt file which Google should honor so that 'nofollow' isn't

Re: Documentation for any* dub package, any version

2018-02-26 Thread Jesse Phillips via Digitalmars-d-announce
On Monday, 26 February 2018 at 14:59:07 UTC, Adam D. Ruppe wrote: I'd like to get the code.dlang.org folks to add the correct link to the main package site so people can easily discover this just put nofollow on it plz so google doesn't trigger generation of pages people don't actually

Re: Documentation for any* dub package, any version

2018-02-26 Thread WebFreak001 via Digitalmars-d-announce
On Monday, 26 February 2018 at 14:59:07 UTC, Adam D. Ruppe wrote: Many of you will already know this from the other thread or from my twitter, but I just added a on-demand downloader to my dpldocs.info domain to fetch and build docs for any* dub package. [...] amazing! I planned on adding

Re: Documentation for any* dub package, any version

2018-02-26 Thread Adam D. Ruppe via Digitalmars-d-announce
On Monday, 26 February 2018 at 15:21:55 UTC, aliak wrote: Questions: Tried it with optional and undocumented stuff is also shown. Oh, fixed now. since there's no ddoc at all in that file, it should have been skipped, I just had a testing "return true;" in the method I forgot to remove. And

Re: Documentation for any* dub package, any version

2018-02-26 Thread Jonathan M Davis via Digitalmars-d-announce
On Monday, February 26, 2018 14:59:07 Adam D. Ruppe via Digitalmars-d- announce wrote: > It isn't 100% compatible with ddoc. For example, this > user-defined macro was not expanded: > http://dxml.dpldocs.info/dxml.dom.html#source Yeah. Any project that uses .ddoc files to define additional macros

Re: Documentation for any* dub package, any version

2018-02-26 Thread aliak via Digitalmars-d-announce
On Monday, 26 February 2018 at 14:59:07 UTC, Adam D. Ruppe wrote: Many of you will already know this from the other thread or from my twitter, but I just added a on-demand downloader to my dpldocs.info domain to fetch and build docs for any* dub package. Simply go to

Re: Documentation for any* dub package, any version

2018-02-26 Thread Guillaume Piolat via Digitalmars-d-announce
On Monday, 26 February 2018 at 14:59:07 UTC, Adam D. Ruppe wrote: Many of you will already know this from the other thread or from my twitter, but I just added a on-demand downloader to my dpldocs.info domain to fetch and build docs for any* dub package. This is very much awesome, much

Documentation for any* dub package, any version

2018-02-26 Thread Adam D. Ruppe via Digitalmars-d-announce
Many of you will already know this from the other thread or from my twitter, but I just added a on-demand downloader to my dpldocs.info domain to fetch and build docs for any* dub package. Simply go to projectname.dpldocs.info/vX.Y.Z/ and it will generate docs for dub package projectname,