ddox documentation generator
The documentation generator used for vibed.org (e.g. http://vibed.org/api/vibe.core.file/FileStream) is now available as a stand-alone project: https://github.com/rejectedsoftware/ddox also available as a VPM module: http://registry.vibed.org/view_package/ddox Features: - Supports DDOC sections and macros - Fully interlinked types - Automatically inherits members and documentation from base classes - Clean structure without endless spaghetti pages (customizable) - Diet template based and thus fully customizable output - Built-in HTTP server for local docs serving - Easily embeddable into existing vibe.d based sites - Can generate offline documentation as HTML files - Function for filtering the DMD .json file by module prefixes, protection level and doc comment
Remus
Hi, I'd like to present you Remus. First things first. What is Remus? Remus is a (Pre)Compiler for D. It adds D or rather the natural Syntax of D through various things, which are at the moment only offered by library solutions or not at all. This includes: - Not null references - Stack instances (also known as scope instances) - Namespaces - Safe Null invocation Planned further still: memoize for functions and methods as well as ref counted instances. Here's one code example of what already works: http://dpaste.dzfl.pl/bc50f081 Why did I do that? Many library solutions from D are for me (and probably for many others here) essentially built (built in) missing features that can't be missing. An example would be not null references: Not Null references doesn't exist and are not intended for D. They are at least a structure / library solution. Remus instead provides a simple, clear syntax. There is certainly more to say about the other features, but I'm not fond of many words: Try it out, or leave it. It's your choice, but I will use it in future for myself, my fellow students and my university stuff. Nevertheless I am thankful for suggestions and feedback. You can download Remus here: http://rswhite.de/?q=downloads. This is my own little website (however, in German) on where I give you some informations, details and features about Remus as well as how you install it: http://rswhite.de/?q=remus. I advise you to try reading some of the remus chapters to understand what's working and what doesn't and for what reason. On this page there will soon (about 2 - 4 weeks) be released the Beta-version of my 2D game framework called Dgame. This builds on the SDL and OpenGL and should become a worthy substitute to SFML from C++. It already has been tested enough in 2-3 simulations. Even an Pong Clone has been developed by it. But what's missing is an adequate documentation. So much of me. Greetings and in advance: sorry for my english ;)
Re: Remus
Namespace: - Not null references - Stack instances (also known as scope instances) - Namespaces - Safe Null invocation Planned further still: memoize for functions and methods as well as ref counted instances. Similar efforts are useful almost as the Haskell GHC compiler extensions: to allow the community to try to use features not yet present in the language, to judge them better, allowing to understand if they are worth putting in the language, and trying few alternative implementation ideas looking for the best one of them. But to do this well, people need to understand such extensions very well. So instead of just offering the source code and one uncommented example, I suggest to explain each feature, why they are present, what design choices you have taken and why, and how to use them in some common cases, with few specific examples. This will make your work useful for the development of the mainstream D too. Bye, bearophile
Re: Remus
I have, but until now only in german. If you understand german, you could read it on my website on the remus chapter. I'm going to translate and explain it more detailed this week. :)
Re: ddox documentation generator
On 2012-10-07 18:06, Sönke Ludwig wrote: The documentation generator used for vibed.org (e.g. http://vibed.org/api/vibe.core.file/FileStream) is now available as a stand-alone project: https://github.com/rejectedsoftware/ddox also available as a VPM module: http://registry.vibed.org/view_package/ddox Features: - Supports DDOC sections and macros - Fully interlinked types - Automatically inherits members and documentation from base classes - Clean structure without endless spaghetti pages (customizable) - Diet template based and thus fully customizable output - Built-in HTTP server for local docs serving - Easily embeddable into existing vibe.d based sites - Can generate offline documentation as HTML files - Function for filtering the DMD .json file by module prefixes, protection level and doc comment This looks awesome. -- /Jacob Carlborg
Re: Remus
On 2012-10-07 19:32, Namespace wrote: Hi, I'd like to present you Remus. First things first. What is Remus? Remus is a (Pre)Compiler for D. It adds D or rather the natural Syntax of D through various things, which are at the moment only offered by library solutions or not at all. This includes: - Not null references - Stack instances (also known as scope instances) - Namespaces - Safe Null invocation This looks cool, especially not null references and stack instances. But as bearophile said, it would be nice with some explanation of the features. -- /Jacob Carlborg
Re: Remus
On Sunday, 7 October 2012 at 19:41:30 UTC, Jacob Carlborg wrote: On 2012-10-07 19:32, Namespace wrote: amazing, good work...! what license is this under, is it allowed to be used commercially?
Re: ddox documentation generator
Server overloaded? Trying to connect to 'vibed.org' just hangs (without actually timing out, at least not yet).
Re: ddox documentation generator
On 10/07/2012 05:33 PM, Nick Sabalausky wrote: Server overloaded? Trying to connect to 'vibed.org' just hangs (without actually timing out, at least not yet). Same for me.
Re: GtkD 2.0 released, Gtk+ 3 with D.
On Saturday, 6 October 2012 at 13:48:02 UTC, Mike Wey wrote: Using those same instructions... https://github.com/gtkd-developers/GtkD/wiki/Installing-on-Windows ...I only manage to get this error (after ~10 seconds): D:\Documents\GitHub\GtkD\srcdgen.exe Fatal Error: Out of memory Even though Task Manager shows only negligible increase in memory. I seems that dmd runs out of memory when using the -lib switch with GtkD. I've updated the script posted on the wiki. Works great, thanks!
